state

package
v0.15.20 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 20, 2026 License: Apache-2.0 Imports: 18 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	ClassTrieHeight           = 251
	ContractTrieHeight        = 251
	ContractStorageTrieHeight = 251
)
View Source 
const DefaultMaxLayers = 128

DefaultMaxLayers is the default maximum number of layers to keep in the cache

Variables

View Source 
var (
	ErrContractNotDeployed        = errors.New("contract not deployed")
	ErrContractAlreadyDeployed    = errors.New("contract already deployed")
	ErrNoHistoryValue             = errors.New("no history value found")
	ErrHistoricalTrieNotSupported = errors.New("cannot support historical trie")
)

Functions

func DeleteClass 

func DeleteClass(w db.KeyValueWriter, classHash *felt.Felt) error

func DeleteClassHashHistory 

func DeleteClassHashHistory(w db.KeyValueWriter, addr *felt.Felt, blockNum uint64) error

func DeleteContract 

func DeleteContract(w db.KeyValueWriter, addr *felt.Felt) error

func DeleteNonceHistory 

func DeleteNonceHistory(w db.KeyValueWriter, addr *felt.Felt, blockNum uint64) error

func DeleteStorageHistory 

func DeleteStorageHistory(w db.KeyValueWriter, addr, key *felt.Felt, blockNum uint64) error

func GetClass 

func GetClass(r db.KeyValueReader, classHash *felt.Felt) (*core.DeclaredClassDefinition, error)

func GetContract 

func GetContract(r db.KeyValueReader, addr *felt.Felt) (stateContract, error)

Gets a contract instance from the database. If it doesn't exist returns a contract not deployed error

func GetStateObject 

func GetStateObject(r db.KeyValueReader, state *State, addr *felt.Felt) (*stateObject, error)

func HasClass 

func HasClass(r db.KeyValueReader, classHash *felt.Felt) (bool, error)

func HasContract 

func HasContract(r db.KeyValueReader, addr *felt.Felt) (bool, error)

func NewStateHistory 

func NewStateHistory(blockNum uint64, stateRoot *felt.Felt, db *StateDB) (stateHistory, error)

func WriteClass 

func WriteClass(
	w db.KeyValueWriter,
	classHash *felt.Felt,
	class core.ClassDefinition,
	declaredAt uint64,
) error

func WriteClassHashHistory 

func WriteClassHashHistory(w db.KeyValueWriter, addr *felt.Felt, blockNum uint64, classHash *felt.Felt) error

func WriteContract 

func WriteContract(w db.KeyValueWriter, addr *felt.Felt, contract *stateContract) error

func WriteNonceHistory 

func WriteNonceHistory(w db.KeyValueWriter, addr *felt.Felt, blockNum uint64, nonce *felt.Felt) error

func WriteStorageHistory 

func WriteStorageHistory(w db.KeyValueWriter, addr, key *felt.Felt, blockNum uint64, value *felt.Felt) error

Types

type State 

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

func New 

func New(stateRoot *felt.Felt, db *StateDB) (*State, error)

func (*State) Class 

func (s *State) Class(classHash *felt.Felt) (*core.DeclaredClassDefinition, error)

func (*State) ClassTrie 

func (s *State) ClassTrie() (core.Trie, error)

func (*State) Commitment 

func (s *State) Commitment(protocolVersion string) (felt.Felt, error)

Returns the state commitment

func (*State) CompiledClassHash added in v0.15.20 

func (s *State) CompiledClassHash(
	classHash *felt.SierraClassHash,
) (felt.CasmClassHash, error)

func (*State) CompiledClassHashAt added in v0.15.20 

func (s *State) CompiledClassHashAt(
	classHash *felt.SierraClassHash,
	blockNumber uint64,
) (felt.CasmClassHash, error)

func (*State) CompiledClassHashV2 added in v0.15.20 

func (s *State) CompiledClassHashV2(
	classHash *felt.SierraClassHash,
) (felt.CasmClassHash, error)

func (*State) ContractClassHash 

func (s *State) ContractClassHash(addr *felt.Felt) (felt.Felt, error)

func (*State) ContractClassHashAt 

func (s *State) ContractClassHashAt(addr *felt.Felt, blockNum uint64) (felt.Felt, error)

Returns the class hash of a contract at a given block number.

func (*State) ContractDeployedAt 

func (s *State) ContractDeployedAt(addr *felt.Felt, blockNum uint64) (bool, error)

func (*State) ContractNonce 

func (s *State) ContractNonce(addr *felt.Felt) (felt.Felt, error)

func (*State) ContractNonceAt 

func (s *State) ContractNonceAt(addr *felt.Felt, blockNum uint64) (felt.Felt, error)

Returns the nonce of a contract at a given block number.

func (*State) ContractStorage 

func (s *State) ContractStorage(addr, key *felt.Felt) (felt.Felt, error)

func (*State) ContractStorageAt 

func (s *State) ContractStorageAt(addr, key *felt.Felt, blockNum uint64) (felt.Felt, error)

Returns the storage value of a contract at a given storage key at a given block number.

func (*State) ContractStorageLastUpdatedAt added in v0.15.20 

func (s *State) ContractStorageLastUpdatedAt(
	addr *felt.Address,
	key *felt.Felt,
	blockNum uint64,
) (uint64, error)

Returns the block number at which a given storage slot key of a given contract was last updated, up to and including the given block number.

func (*State) ContractStorageLastUpdatedBlock added in v0.15.20 

func (s *State) ContractStorageLastUpdatedBlock(
	addr *felt.Address,
	key *felt.Felt,
) (uint64, error)

ContractStorageLastUpdatedBlock returns the most recent block number at which a given storage slot key of a given contract was last updated.

func (*State) ContractStorageTrie 

func (s *State) ContractStorageTrie(addr *felt.Felt) (core.Trie, error)

func (*State) ContractTrie 

func (s *State) ContractTrie() (core.Trie, error)

func (*State) GetReverseStateDiff 

func (s *State) GetReverseStateDiff(blockNum uint64, diff *core.StateDiff) (core.StateDiff, error)

func (*State) Revert 

func (s *State) Revert(header *core.Header, update *core.StateUpdate) error

Revert a given state update. The block number is the block number of the state update.

func (*State) Update 

func (s *State) Update(
	header *core.Header,
	update *core.StateUpdate,
	declaredClasses map[felt.Felt]core.ClassDefinition,
	skipVerifyNewRoot bool,
) error

Applies a state update to a given state. If any error is encountered, state is not updated. After a state update is applied, the root of the state must match the given new root in the state update. TODO(weiihann): deal with flush atomicity

type StateDB 

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

func NewStateDB 

func NewStateDB(disk db.KeyValueStore, triedb database.TrieDB) *StateDB

func (*StateDB) ClassTrie 

func (s *StateDB) ClassTrie(stateComm *felt.Felt) (*trie2.Trie, error)

Opens a class trie for the given state root

func (*StateDB) ContractStorageTrie 

func (s *StateDB) ContractStorageTrie(stateComm, owner *felt.Felt) (*trie2.Trie, error)

Opens a contract storage trie for the given state root and contract address

func (*StateDB) ContractTrie 

func (s *StateDB) ContractTrie(stateComm *felt.Felt) (*trie2.Trie, error)

Opens a contract trie for the given state root

type Storage 

type Storage map[felt.Felt]*felt.Felt

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.