state

Documentation

Overview

Package state manages the main accounts trie. It follows the flow as bellow:

         o
         |
[ revertable state ]
         |
  [ stacked map ] -> [ journal ] -> [ playback(staging) ] -> [ updated trie ]
         |
   [ trie cache ]
         |
  [ read-only trie ]

It's much simpler than Ethereum's statedb. An important difference with statedb is the logic of account suicide. TODO: explain more

Index

• Constants
• func StorageTrieName(addressHash thor.Bytes32) string
• type Account
  • func (a *Account) CalcEnergy(blockTime uint64) *big.Int
  • func (a *Account) IsEmpty() bool
• type Error
  • func (e *Error) Error() string
• type Stage
  • func (s *Stage) Commit() (thor.Bytes32, error)
  • func (s *Stage) Hash() thor.Bytes32
• type State
  • func New(db *muxdb.MuxDB, root thor.Bytes32) *State
  • func (s *State) BuildStorageTrie(addr thor.Address) (*muxdb.Trie, error)
  • func (s *State) DecodeStorage(addr thor.Address, key thor.Bytes32, dec func([]byte) error) error
  • func (s *State) Delete(addr thor.Address)
  • func (s *State) EncodeStorage(addr thor.Address, key thor.Bytes32, enc func() ([]byte, error)) error
  • func (s *State) Exists(addr thor.Address) (bool, error)
  • func (s *State) GetBalance(addr thor.Address) (*big.Int, error)
  • func (s *State) GetCode(addr thor.Address) ([]byte, error)
  • func (s *State) GetCodeHash(addr thor.Address) (thor.Bytes32, error)
  • func (s *State) GetEnergy(addr thor.Address, blockTime uint64) (*big.Int, error)
  • func (s *State) GetMaster(addr thor.Address) (thor.Address, error)
  • func (s *State) GetRawStorage(addr thor.Address, key thor.Bytes32) (rlp.RawValue, error)
  • func (s *State) GetStorage(addr thor.Address, key thor.Bytes32) (thor.Bytes32, error)
  • func (s *State) NewCheckpoint() int
  • func (s *State) NewStater() *Stater
  • func (s *State) RevertTo(revision int)
  • func (s *State) SetBalance(addr thor.Address, balance *big.Int) error
  • func (s *State) SetCode(addr thor.Address, code []byte) error
  • func (s *State) SetEnergy(addr thor.Address, energy *big.Int, blockTime uint64) error
  • func (s *State) SetMaster(addr thor.Address, master thor.Address) error
  • func (s *State) SetRawStorage(addr thor.Address, key thor.Bytes32, raw rlp.RawValue)
  • func (s *State) SetStorage(addr thor.Address, key, value thor.Bytes32)
  • func (s *State) Stage() (*Stage, error)
• type Stater
  • func NewStater(db *muxdb.MuxDB) *Stater
  • func (s *Stater) NewState(root thor.Bytes32) *State

Constants

const (
	// AccountTrieName is the name of account trie.
	AccountTrieName = "a"
)

Functions

func StorageTrieName

func StorageTrieName(addressHash thor.Bytes32) string

StorageTrieName returns the name of storage trie.

Each storage trie has a unique name, which can improve IO performance.

Types

type Account

type Account struct {
	Balance     *big.Int
	Energy      *big.Int
	BlockTime   uint64
	Master      []byte // master address
	CodeHash    []byte // hash of code
	StorageRoot []byte // merkle root of the storage trie
}

Account is the Thor consensus representation of an account. RLP encoded objects are stored in main account trie.

func (*Account) CalcEnergy

func (a *Account) CalcEnergy(blockTime uint64) *big.Int

CalcEnergy calculates energy based on current block time.

func (*Account) IsEmpty

func (a *Account) IsEmpty() bool

IsEmpty returns if an account is empty. An empty account has zero balance and zero length code hash.

type Error

type Error struct {
	// contains filtered or unexported fields
}

Error is the error caused by state access failure.

func (*Error) Error

func (e *Error) Error() string

type Stage

type Stage struct {
	// contains filtered or unexported fields
}

Stage abstracts changes on the main accounts trie.

func (*Stage) Commit

func (s *Stage) Commit() (thor.Bytes32, error)

Commit commits all changes into main accounts trie and storage tries.

func (*Stage) Hash

func (s *Stage) Hash() thor.Bytes32

Hash computes hash of the main accounts trie.

type State

type State struct {
	// contains filtered or unexported fields
}

State manages the world state.

func New

func New(db *muxdb.MuxDB, root thor.Bytes32) *State

New create state object.

func (*State) BuildStorageTrie

func (s *State) BuildStorageTrie(addr thor.Address) (*muxdb.Trie, error)

BuildStorageTrie build up storage trie for given address with cumulative changes.

func (*State) DecodeStorage

func (s *State) DecodeStorage(addr thor.Address, key thor.Bytes32, dec func([]byte) error) error

DecodeStorage get and decode storage value. Error returned by dec will be absorbed by State instance.

func (*State) Delete

func (s *State) Delete(addr thor.Address)

Delete delete an account at the given address. That's set balance, energy and code to zero value.

func (*State) EncodeStorage

func (s *State) EncodeStorage(addr thor.Address, key thor.Bytes32, enc func() ([]byte, error)) error

EncodeStorage set storage value encoded by given enc method. Error returned by end will be absorbed by State instance.

func (*State) Exists

func (s *State) Exists(addr thor.Address) (bool, error)

Exists returns whether an account exists at the given address. See Account.IsEmpty()

func (*State) GetBalance

func (s *State) GetBalance(addr thor.Address) (*big.Int, error)

GetBalance returns balance for the given address.

func (*State) GetCode

func (s *State) GetCode(addr thor.Address) ([]byte, error)

GetCode returns code for the given address.

func (*State) GetCodeHash

func (s *State) GetCodeHash(addr thor.Address) (thor.Bytes32, error)

GetCodeHash returns code hash for the given address.

func (*State) GetEnergy

func (s *State) GetEnergy(addr thor.Address, blockTime uint64) (*big.Int, error)

GetEnergy get energy for the given address at block number specified.

func (*State) GetMaster

func (s *State) GetMaster(addr thor.Address) (thor.Address, error)

GetMaster get master for the given address. Master can move energy, manage users...

func (*State) GetRawStorage

func (s *State) GetRawStorage(addr thor.Address, key thor.Bytes32) (rlp.RawValue, error)

GetRawStorage returns storage value in rlp raw for given address and key.

func (*State) GetStorage

func (s *State) GetStorage(addr thor.Address, key thor.Bytes32) (thor.Bytes32, error)

GetStorage returns storage value for the given address and key.

func (*State) NewCheckpoint

func (s *State) NewCheckpoint() int

NewCheckpoint makes a checkpoint of current state. It returns revision of the checkpoint.

func (*State) NewStater

func (s *State) NewStater() *Stater

NewStater create stater object.

func (*State) RevertTo

func (s *State) RevertTo(revision int)

RevertTo revert to checkpoint specified by revision.

func (*State) SetBalance

func (s *State) SetBalance(addr thor.Address, balance *big.Int) error

SetBalance set balance for the given address.

func (*State) SetCode

func (s *State) SetCode(addr thor.Address, code []byte) error

SetCode set code for the given address.

func (*State) SetEnergy

func (s *State) SetEnergy(addr thor.Address, energy *big.Int, blockTime uint64) error

SetEnergy set energy at block number for the given address.

func (*State) SetMaster

func (s *State) SetMaster(addr thor.Address, master thor.Address) error

SetMaster set master for the given address.

func (*State) SetRawStorage

func (s *State) SetRawStorage(addr thor.Address, key thor.Bytes32, raw rlp.RawValue)

SetRawStorage set storage value in rlp raw.

func (*State) SetStorage

func (s *State) SetStorage(addr thor.Address, key, value thor.Bytes32)

SetStorage set storage value for the given address and key.

func (*State) Stage

func (s *State) Stage() (*Stage, error)

Stage makes a stage object to compute hash of trie or commit all changes.

type Stater

type Stater struct {
	// contains filtered or unexported fields
}

Stater is the state creator.

func NewStater

func NewStater(db *muxdb.MuxDB) *Stater

NewStater create a new stater.

func (*Stater) NewState

func (s *Stater) NewState(root thor.Bytes32) *State

NewState create a new state object.