Interface IAccountState

An interface to fetch account states.

It is like a readonly map which is virtually initialized such that every possible Address exists and is mapped to null. That means that:

  • it does not have length,
  • its index getter never throws KeyNotFoundException, but returns null instead, and
Namespace: Libplanet.Action.State
Assembly: Libplanet.Action.dll
Syntax
public interface IAccountState

Properties

| Improve this Doc View Source

Trie

The ITrie of the IAccountState.

Declaration
[Pure]
ITrie Trie { get; }
Property Value
Type Description
ITrie

Methods

| Improve this Doc View Source

GetState(Address)

Gets the account state of the given address.

Declaration
[Pure]
IValue GetState(Address address)
Parameters
Type Name Description
Address address

The Address referring the account to get its state.
Returns
Type Description
Bencodex.Types.IValue

The account state of the given address. If it has never been set to any state it returns null instead.
| Improve this Doc View Source

GetStates(IReadOnlyList<Address>)

Gets multiple account states associated with the specified addresses at once.

Declaration
[Pure]
IReadOnlyList<IValue> GetStates(IReadOnlyList<Address> addresses)
Parameters
Type Name Description
IReadOnlyList<Address> addresses

The Addresses associated with states to get.
Returns
Type Description
IReadOnlyList<Bencodex.Types.IValue>

The states associated to the specified addresses. Associated values are ordered in the same way to the corresponding addresses. Absent states are represented as null.