Namespace Libplanet.Store

Classes

BaseStore

Common code for several IStore implementations.

ChainIdNotFoundException

The exception that is thrown when a chain ID does not exist in an IStore object.

DataModel

A class representing an abstract data model that can be easily encoded and decoded to and from a .

Inheriting this class and simply declaring properties allows an instance of the child class to encode its data into a where the encoded has the concrete class'es each property name as its key and the each corresponding property value as its value.

However, there are certain restrictions that apply when using this class:

The complete list of allowed property types are as follows:
- Primitive types: bool, int, long, BigInteger, ImmutableArray<byte>, Guid, Address, and string.
- Special types: Any type inherited from DataModel.
- Collective types:
  - where T is a primitive type.
  - where
    - TKey is one of ImmutableArray<byte>, Address, Guid, and string.
    - TValue is a primitive type.
Value types are not allowed to be declared as nullable, not even as a generic type parameter. That is, types such as bool?, Address?, and ImmutableList<int?>are not allowed.
Reference types are not allowed to be assigned null. This will result in an when Encode() is called.
Trying to assign null to any property or to a part of a collection will result in an when DataModel(Bencodex.Types.Dictionary) is called.

DefaultStore

The default built-in IStore implementation. This stores data in the file system or in memory. It also uses LiteDB for some complex indices.

DefaultStore and DefaultKeyValueStore-backed TrieStateStore can be instantiated from a URI with default+file: scheme using LoadStore(Uri), e.g.:

default+file:///var/data/planet/
default+file:///c:/Users/john/AppData/Local/planet/
default+file:///var/data/planet/?secure=true (trie keys are hashed)

The following query string parameters are supported:

`journal`	`true` (default) or `false`. Corresponds to DefaultStore(String, Boolean, Int32, Int32, Int32, Boolean, Boolean)'s `journal` parameter.
`index-cache`	Corresponds to DefaultStore(String, Boolean, Int32, Int32, Int32, Boolean, Boolean)'s `indexCacheSize` parameter. 50000 by default.
`block-cache`	Corresponds to DefaultStore(String, Boolean, Int32, Int32, Int32, Boolean, Boolean)'s `blockCacheSize` parameter. 512 by default.
`tx-cache`	Corresponds to DefaultStore(String, Boolean, Int32, Int32, Int32, Boolean, Boolean)'s `txCacheSize` parameter. 1024 by default.
`flush`	`true` (default) or `false`. Corresponds to DefaultStore(String, Boolean, Int32, Int32, Int32, Boolean, Boolean)'s `flush` parameter.
`readonly`	`true` or `false` (default). Corresponds to DefaultStore(String, Boolean, Int32, Int32, Int32, Boolean, Boolean)'s `readOnly` parameter.
`states-dir`	Corresponds to 's `path` parameter. It is relative to the URI path, and defaults to `states`.
`secure`	`true` or `false` (default). Corresponds to TrieStateStore(IKeyValueStore, Boolean)'s `secure` parameter.