state

package
v1.30.45 Latest Latest
Warning

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

 Go to latest Published: Jun 23, 2026 License: BSD-3-Clause Imports: 17 Imported by: 0

Documentation

Overview

Package state is a generated GoMock package.

Index

Constants

This section is empty.

Variables

View Source 
var (
	ErrMissingParentState = errors.New("missing parent state")
)

Functions

This section is empty.

Types

type Chain 

type Chain interface {
	ReadOnlyChain
	lux.UTXOAdder
	lux.UTXODeleter

	AddTx(tx *txs.Tx)
	AddBlock(block block.Block)
	SetLastAccepted(blkID ids.ID)
	SetTimestamp(t time.Time)
}

type Diff 

type Diff interface {
	Chain

	Apply(Chain)
}

func NewDiff 

func NewDiff(
	parentID ids.ID,
	stateVersions Versions,
) (Diff, error)

func NewDiffOn 

func NewDiffOn(parentState Chain) (Diff, error)

type MockChain added in v1.1.11 

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

MockChain is a mock of Chain interface.

func NewMockChain added in v1.1.11 

func NewMockChain(ctrl *gomock.Controller) *MockChain

NewMockChain creates a new mock instance.

func (*MockChain) AddBlock added in v1.1.11 

func (m *MockChain) AddBlock(arg0 block.Block)

AddBlock mocks base method.

func (*MockChain) AddTx added in v1.1.11 

func (m *MockChain) AddTx(tx *txs.Tx)

AddTx mocks base method.

func (*MockChain) AddUTXO added in v1.1.11 

func (m *MockChain) AddUTXO(arg0 *utxo.UTXO)

AddUTXO mocks base method.

func (*MockChain) DeleteUTXO added in v1.1.11 

func (m *MockChain) DeleteUTXO(utxoID ids.ID)

DeleteUTXO mocks base method.

func (*MockChain) EXPECT added in v1.1.11 

func (m *MockChain) EXPECT() *MockChainMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockChain) GetBlock added in v1.1.11 

func (m *MockChain) GetBlock(blkID ids.ID) (block.Block, error)

GetBlock mocks base method.

func (*MockChain) GetBlockIDAtHeight added in v1.1.11 

func (m *MockChain) GetBlockIDAtHeight(height uint64) (ids.ID, error)

GetBlockIDAtHeight mocks base method.

func (*MockChain) GetLastAccepted added in v1.1.11 

func (m *MockChain) GetLastAccepted() ids.ID

GetLastAccepted mocks base method.

func (*MockChain) GetTimestamp added in v1.1.11 

func (m *MockChain) GetTimestamp() time.Time

GetTimestamp mocks base method.

func (*MockChain) GetTx added in v1.1.11 

func (m *MockChain) GetTx(txID ids.ID) (*txs.Tx, error)

GetTx mocks base method.

func (*MockChain) GetUTXO added in v1.1.11 

func (m *MockChain) GetUTXO(utxoID ids.ID) (*utxo.UTXO, error)

GetUTXO mocks base method.

func (*MockChain) SetLastAccepted added in v1.1.11 

func (m *MockChain) SetLastAccepted(blkID ids.ID)

SetLastAccepted mocks base method.

func (*MockChain) SetTimestamp added in v1.1.11 

func (m *MockChain) SetTimestamp(t time.Time)

SetTimestamp mocks base method.

func (*MockChain) UTXOs added in v1.30.27 

func (m *MockChain) UTXOs(start ids.ID, limit int) ([]*utxo.UTXO, error)

UTXOs mocks base method.

type MockChainMockRecorder added in v1.1.11 

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

MockChainMockRecorder is the mock recorder for MockChain.

func (*MockChainMockRecorder) AddBlock added in v1.1.11 

func (mr *MockChainMockRecorder) AddBlock(arg0 any) *gomock.Call

AddBlock indicates an expected call of AddBlock.

func (*MockChainMockRecorder) AddTx added in v1.1.11 

func (mr *MockChainMockRecorder) AddTx(tx any) *gomock.Call

AddTx indicates an expected call of AddTx.

func (*MockChainMockRecorder) AddUTXO added in v1.1.11 

func (mr *MockChainMockRecorder) AddUTXO(arg0 any) *gomock.Call

AddUTXO indicates an expected call of AddUTXO.

func (*MockChainMockRecorder) DeleteUTXO added in v1.1.11 

func (mr *MockChainMockRecorder) DeleteUTXO(utxoID any) *gomock.Call

DeleteUTXO indicates an expected call of DeleteUTXO.

func (*MockChainMockRecorder) GetBlock added in v1.1.11 

func (mr *MockChainMockRecorder) GetBlock(blkID any) *gomock.Call

GetBlock indicates an expected call of GetBlock.

func (*MockChainMockRecorder) GetBlockIDAtHeight added in v1.1.11 

func (mr *MockChainMockRecorder) GetBlockIDAtHeight(height any) *gomock.Call

GetBlockIDAtHeight indicates an expected call of GetBlockIDAtHeight.

func (*MockChainMockRecorder) GetLastAccepted added in v1.1.11 

func (mr *MockChainMockRecorder) GetLastAccepted() *gomock.Call

GetLastAccepted indicates an expected call of GetLastAccepted.

func (*MockChainMockRecorder) GetTimestamp added in v1.1.11 

func (mr *MockChainMockRecorder) GetTimestamp() *gomock.Call

GetTimestamp indicates an expected call of GetTimestamp.

func (*MockChainMockRecorder) GetTx added in v1.1.11 

func (mr *MockChainMockRecorder) GetTx(txID any) *gomock.Call

GetTx indicates an expected call of GetTx.

func (*MockChainMockRecorder) GetUTXO added in v1.1.11 

func (mr *MockChainMockRecorder) GetUTXO(utxoID any) *gomock.Call

GetUTXO indicates an expected call of GetUTXO.

func (*MockChainMockRecorder) SetLastAccepted added in v1.1.11 

func (mr *MockChainMockRecorder) SetLastAccepted(blkID any) *gomock.Call

SetLastAccepted indicates an expected call of SetLastAccepted.

func (*MockChainMockRecorder) SetTimestamp added in v1.1.11 

func (mr *MockChainMockRecorder) SetTimestamp(t any) *gomock.Call

SetTimestamp indicates an expected call of SetTimestamp.

func (*MockChainMockRecorder) UTXOs added in v1.30.27 

func (mr *MockChainMockRecorder) UTXOs(start, limit any) *gomock.Call

UTXOs indicates an expected call of UTXOs.

type MockDiff added in v1.1.11 

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

MockDiff is a mock of Diff interface.

func NewMockDiff added in v1.1.11 

func NewMockDiff(ctrl *gomock.Controller) *MockDiff

NewMockDiff creates a new mock instance.

func (*MockDiff) AddBlock added in v1.1.11 

func (m *MockDiff) AddBlock(arg0 block.Block)

AddBlock mocks base method.

func (*MockDiff) AddTx added in v1.1.11 

func (m *MockDiff) AddTx(tx *txs.Tx)

AddTx mocks base method.

func (*MockDiff) AddUTXO added in v1.1.11 

func (m *MockDiff) AddUTXO(arg0 *utxo.UTXO)

AddUTXO mocks base method.

func (*MockDiff) Apply added in v1.1.11 

func (m *MockDiff) Apply(arg0 Chain)

Apply mocks base method.

func (*MockDiff) DeleteUTXO added in v1.1.11 

func (m *MockDiff) DeleteUTXO(utxoID ids.ID)

DeleteUTXO mocks base method.

func (*MockDiff) EXPECT added in v1.1.11 

func (m *MockDiff) EXPECT() *MockDiffMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockDiff) GetBlock added in v1.1.11 

func (m *MockDiff) GetBlock(blkID ids.ID) (block.Block, error)

GetBlock mocks base method.

func (*MockDiff) GetBlockIDAtHeight added in v1.1.11 

func (m *MockDiff) GetBlockIDAtHeight(height uint64) (ids.ID, error)

GetBlockIDAtHeight mocks base method.

func (*MockDiff) GetLastAccepted added in v1.1.11 

func (m *MockDiff) GetLastAccepted() ids.ID

GetLastAccepted mocks base method.

func (*MockDiff) GetTimestamp added in v1.1.11 

func (m *MockDiff) GetTimestamp() time.Time

GetTimestamp mocks base method.

func (*MockDiff) GetTx added in v1.1.11 

func (m *MockDiff) GetTx(txID ids.ID) (*txs.Tx, error)

GetTx mocks base method.

func (*MockDiff) GetUTXO added in v1.1.11 

func (m *MockDiff) GetUTXO(utxoID ids.ID) (*utxo.UTXO, error)

GetUTXO mocks base method.

func (*MockDiff) SetLastAccepted added in v1.1.11 

func (m *MockDiff) SetLastAccepted(blkID ids.ID)

SetLastAccepted mocks base method.

func (*MockDiff) SetTimestamp added in v1.1.11 

func (m *MockDiff) SetTimestamp(t time.Time)

SetTimestamp mocks base method.

func (*MockDiff) UTXOs added in v1.30.27 

func (m *MockDiff) UTXOs(start ids.ID, limit int) ([]*utxo.UTXO, error)

UTXOs mocks base method.

type MockDiffMockRecorder added in v1.1.11 

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

MockDiffMockRecorder is the mock recorder for MockDiff.

func (*MockDiffMockRecorder) AddBlock added in v1.1.11 

func (mr *MockDiffMockRecorder) AddBlock(arg0 any) *gomock.Call

AddBlock indicates an expected call of AddBlock.

func (*MockDiffMockRecorder) AddTx added in v1.1.11 

func (mr *MockDiffMockRecorder) AddTx(tx any) *gomock.Call

AddTx indicates an expected call of AddTx.

func (*MockDiffMockRecorder) AddUTXO added in v1.1.11 

func (mr *MockDiffMockRecorder) AddUTXO(arg0 any) *gomock.Call

AddUTXO indicates an expected call of AddUTXO.

func (*MockDiffMockRecorder) Apply added in v1.1.11 

func (mr *MockDiffMockRecorder) Apply(arg0 any) *gomock.Call

Apply indicates an expected call of Apply.

func (*MockDiffMockRecorder) DeleteUTXO added in v1.1.11 

func (mr *MockDiffMockRecorder) DeleteUTXO(utxoID any) *gomock.Call

DeleteUTXO indicates an expected call of DeleteUTXO.

func (*MockDiffMockRecorder) GetBlock added in v1.1.11 

func (mr *MockDiffMockRecorder) GetBlock(blkID any) *gomock.Call

GetBlock indicates an expected call of GetBlock.

func (*MockDiffMockRecorder) GetBlockIDAtHeight added in v1.1.11 

func (mr *MockDiffMockRecorder) GetBlockIDAtHeight(height any) *gomock.Call

GetBlockIDAtHeight indicates an expected call of GetBlockIDAtHeight.

func (*MockDiffMockRecorder) GetLastAccepted added in v1.1.11 

func (mr *MockDiffMockRecorder) GetLastAccepted() *gomock.Call

GetLastAccepted indicates an expected call of GetLastAccepted.

func (*MockDiffMockRecorder) GetTimestamp added in v1.1.11 

func (mr *MockDiffMockRecorder) GetTimestamp() *gomock.Call

GetTimestamp indicates an expected call of GetTimestamp.

func (*MockDiffMockRecorder) GetTx added in v1.1.11 

func (mr *MockDiffMockRecorder) GetTx(txID any) *gomock.Call

GetTx indicates an expected call of GetTx.

func (*MockDiffMockRecorder) GetUTXO added in v1.1.11 

func (mr *MockDiffMockRecorder) GetUTXO(utxoID any) *gomock.Call

GetUTXO indicates an expected call of GetUTXO.

func (*MockDiffMockRecorder) SetLastAccepted added in v1.1.11 

func (mr *MockDiffMockRecorder) SetLastAccepted(blkID any) *gomock.Call

SetLastAccepted indicates an expected call of SetLastAccepted.

func (*MockDiffMockRecorder) SetTimestamp added in v1.1.11 

func (mr *MockDiffMockRecorder) SetTimestamp(t any) *gomock.Call

SetTimestamp indicates an expected call of SetTimestamp.

func (*MockDiffMockRecorder) UTXOs added in v1.30.27 

func (mr *MockDiffMockRecorder) UTXOs(start, limit any) *gomock.Call

UTXOs indicates an expected call of UTXOs.

type MockState added in v1.1.11 

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

MockState is a mock of State interface.

func NewMockState added in v1.1.11 

func NewMockState(ctrl *gomock.Controller) *MockState

NewMockState creates a new mock instance.

func (*MockState) Abort added in v1.1.11 

func (m *MockState) Abort()

Abort mocks base method.

func (*MockState) AddBlock added in v1.1.11 

func (m *MockState) AddBlock(arg0 block.Block)

AddBlock mocks base method.

func (*MockState) AddTx added in v1.1.11 

func (m *MockState) AddTx(tx *txs.Tx)

AddTx mocks base method.

func (*MockState) AddUTXO added in v1.1.11 

func (m *MockState) AddUTXO(arg0 *utxo.UTXO)

AddUTXO mocks base method.

func (*MockState) Checksum added in v1.30.27 

func (m *MockState) Checksum() ids.ID

Checksum mocks base method.

func (*MockState) Close added in v1.1.11 

func (m *MockState) Close() error

Close mocks base method.

func (*MockState) Commit added in v1.1.11 

func (m *MockState) Commit() error

Commit mocks base method.

func (*MockState) CommitBatch added in v1.1.11 

func (m *MockState) CommitBatch() (database.Batch, error)

CommitBatch mocks base method.

func (*MockState) DeleteUTXO added in v1.1.11 

func (m *MockState) DeleteUTXO(utxoID ids.ID)

DeleteUTXO mocks base method.

func (*MockState) EXPECT added in v1.1.11 

func (m *MockState) EXPECT() *MockStateMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockState) GetBlock added in v1.1.11 

func (m *MockState) GetBlock(blkID ids.ID) (block.Block, error)

GetBlock mocks base method.

func (*MockState) GetBlockIDAtHeight added in v1.1.11 

func (m *MockState) GetBlockIDAtHeight(height uint64) (ids.ID, error)

GetBlockIDAtHeight mocks base method.

func (*MockState) GetLastAccepted added in v1.1.11 

func (m *MockState) GetLastAccepted() ids.ID

GetLastAccepted mocks base method.

func (*MockState) GetTimestamp added in v1.1.11 

func (m *MockState) GetTimestamp() time.Time

GetTimestamp mocks base method.

func (*MockState) GetTx added in v1.1.11 

func (m *MockState) GetTx(txID ids.ID) (*txs.Tx, error)

GetTx mocks base method.

func (*MockState) GetUTXO added in v1.1.11 

func (m *MockState) GetUTXO(utxoID ids.ID) (*utxo.UTXO, error)

GetUTXO mocks base method.

func (*MockState) InitializeChainState added in v1.1.11 

func (m *MockState) InitializeChainState(stopVertexID ids.ID, genesisTimestamp time.Time) error

InitializeChainState mocks base method.

func (*MockState) IsInitialized added in v1.1.11 

func (m *MockState) IsInitialized() (bool, error)

IsInitialized mocks base method.

func (*MockState) SetInitialized added in v1.1.11 

func (m *MockState) SetInitialized() error

SetInitialized mocks base method.

func (*MockState) SetLastAccepted added in v1.1.11 

func (m *MockState) SetLastAccepted(blkID ids.ID)

SetLastAccepted mocks base method.

func (*MockState) SetTimestamp added in v1.1.11 

func (m *MockState) SetTimestamp(t time.Time)

SetTimestamp mocks base method.

func (*MockState) UTXOIDs added in v1.1.11 

func (m *MockState) UTXOIDs(addr []byte, previous ids.ID, limit int) ([]ids.ID, error)

UTXOIDs mocks base method.

func (*MockState) UTXOs added in v1.30.27 

func (m *MockState) UTXOs(start ids.ID, limit int) ([]*utxo.UTXO, error)

UTXOs mocks base method.

type MockStateMockRecorder added in v1.1.11 

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

MockStateMockRecorder is the mock recorder for MockState.

func (*MockStateMockRecorder) Abort added in v1.1.11 

func (mr *MockStateMockRecorder) Abort() *gomock.Call

Abort indicates an expected call of Abort.

func (*MockStateMockRecorder) AddBlock added in v1.1.11 

func (mr *MockStateMockRecorder) AddBlock(arg0 any) *gomock.Call

AddBlock indicates an expected call of AddBlock.

func (*MockStateMockRecorder) AddTx added in v1.1.11 

func (mr *MockStateMockRecorder) AddTx(tx any) *gomock.Call

AddTx indicates an expected call of AddTx.

func (*MockStateMockRecorder) AddUTXO added in v1.1.11 

func (mr *MockStateMockRecorder) AddUTXO(arg0 any) *gomock.Call

AddUTXO indicates an expected call of AddUTXO.

func (*MockStateMockRecorder) Checksum added in v1.30.27 

func (mr *MockStateMockRecorder) Checksum() *gomock.Call

Checksum indicates an expected call of Checksum.

func (*MockStateMockRecorder) Close added in v1.1.11 

func (mr *MockStateMockRecorder) Close() *gomock.Call

Close indicates an expected call of Close.

func (*MockStateMockRecorder) Commit added in v1.1.11 

func (mr *MockStateMockRecorder) Commit() *gomock.Call

Commit indicates an expected call of Commit.

func (*MockStateMockRecorder) CommitBatch added in v1.1.11 

func (mr *MockStateMockRecorder) CommitBatch() *gomock.Call

CommitBatch indicates an expected call of CommitBatch.

func (*MockStateMockRecorder) DeleteUTXO added in v1.1.11 

func (mr *MockStateMockRecorder) DeleteUTXO(utxoID any) *gomock.Call

DeleteUTXO indicates an expected call of DeleteUTXO.

func (*MockStateMockRecorder) GetBlock added in v1.1.11 

func (mr *MockStateMockRecorder) GetBlock(blkID any) *gomock.Call

GetBlock indicates an expected call of GetBlock.

func (*MockStateMockRecorder) GetBlockIDAtHeight added in v1.1.11 

func (mr *MockStateMockRecorder) GetBlockIDAtHeight(height any) *gomock.Call

GetBlockIDAtHeight indicates an expected call of GetBlockIDAtHeight.

func (*MockStateMockRecorder) GetLastAccepted added in v1.1.11 

func (mr *MockStateMockRecorder) GetLastAccepted() *gomock.Call

GetLastAccepted indicates an expected call of GetLastAccepted.

func (*MockStateMockRecorder) GetTimestamp added in v1.1.11 

func (mr *MockStateMockRecorder) GetTimestamp() *gomock.Call

GetTimestamp indicates an expected call of GetTimestamp.

func (*MockStateMockRecorder) GetTx added in v1.1.11 

func (mr *MockStateMockRecorder) GetTx(txID any) *gomock.Call

GetTx indicates an expected call of GetTx.

func (*MockStateMockRecorder) GetUTXO added in v1.1.11 

func (mr *MockStateMockRecorder) GetUTXO(utxoID any) *gomock.Call

GetUTXO indicates an expected call of GetUTXO.

func (*MockStateMockRecorder) InitializeChainState added in v1.1.11 

func (mr *MockStateMockRecorder) InitializeChainState(stopVertexID, genesisTimestamp any) *gomock.Call

InitializeChainState indicates an expected call of InitializeChainState.

func (*MockStateMockRecorder) IsInitialized added in v1.1.11 

func (mr *MockStateMockRecorder) IsInitialized() *gomock.Call

IsInitialized indicates an expected call of IsInitialized.

func (*MockStateMockRecorder) SetInitialized added in v1.1.11 

func (mr *MockStateMockRecorder) SetInitialized() *gomock.Call

SetInitialized indicates an expected call of SetInitialized.

func (*MockStateMockRecorder) SetLastAccepted added in v1.1.11 

func (mr *MockStateMockRecorder) SetLastAccepted(blkID any) *gomock.Call

SetLastAccepted indicates an expected call of SetLastAccepted.

func (*MockStateMockRecorder) SetTimestamp added in v1.1.11 

func (mr *MockStateMockRecorder) SetTimestamp(t any) *gomock.Call

SetTimestamp indicates an expected call of SetTimestamp.

func (*MockStateMockRecorder) UTXOIDs added in v1.1.11 

func (mr *MockStateMockRecorder) UTXOIDs(addr, previous, limit any) *gomock.Call

UTXOIDs indicates an expected call of UTXOIDs.

func (*MockStateMockRecorder) UTXOs added in v1.30.27 

func (mr *MockStateMockRecorder) UTXOs(start, limit any) *gomock.Call

UTXOs indicates an expected call of UTXOs.

type ReadOnlyChain 

type ReadOnlyChain interface {
	lux.UTXOGetter

	// UTXOs returns the occupied UTXOs of this chain in canonical ascending
	// UTXOID order — the deterministic full-set ordering the xvm execution_root
	// projection folds (see vms/xvm/state/xvmroot and the execution_root leaf
	// spec). Enumeration begins immediately after [start] (ids.Empty starts at
	// the first UTXOID) and returns at most [limit] UTXOs; pass a non-positive
	// [limit] for "no bound" (all remaining). The returned slice is in strictly
	// increasing UTXOID order with no duplicates, so a caller can page by
	// passing the last returned UTXOID as the next [start]. A spent/removed UTXO
	// is never returned (it is not part of the occupied set).
	UTXOs(start ids.ID, limit int) ([]*lux.UTXO, error)

	GetTx(txID ids.ID) (*txs.Tx, error)
	GetBlockIDAtHeight(height uint64) (ids.ID, error)
	GetBlock(blkID ids.ID) (block.Block, error)
	GetLastAccepted() ids.ID
	GetTimestamp() time.Time
}

type State 

type State interface {
	Chain
	lux.UTXOReader

	IsInitialized() (bool, error)
	SetInitialized() error

	// InitializeChainState is called after the VM has been linearized. Calling
	// [GetLastAccepted] or [GetTimestamp] before calling this function will
	// return uninitialized data.
	//
	// Invariant: After the chain is linearized, this function is expected to be
	// called during startup.
	InitializeChainState(stopVertexID ids.ID, genesisTimestamp time.Time) error

	// Discard uncommitted changes to the database.
	Abort()

	// Commit changes to the base database.
	Commit() error

	// Returns a batch of unwritten changes that, when written, will commit all
	// pending changes to the base database.
	CommitBatch() (database.Batch, error)

	// Checksum returns the current state checksum.
	Checksum() ids.ID

	Close() error
}

State persistently maintains a set of UTXOs, transaction, statuses, and singletons.

func New 

func New(
	db *versiondb.Database,
	parser block.Parser,
	metrics metric.Registerer,
	trackChecksums bool,
) (State, error)

type Versions 

type Versions interface {
	// GetState returns the state of the chain after [blkID] has been accepted.
	// If the state is not known, `false` will be returned.
	GetState(blkID ids.ID) (Chain, bool)
}

Source Files

View all Source files

Directories

Path Synopsis
Package statemock is a generated GoMock package.
 Package statemock is a generated GoMock package.
Package xvmroot computes the xvm execution_root in native Go, byte-identical to the lux-private GPU xvm_root_update kernel (ops/xvm/cuda/xvm_roots.cu) and every backend's CPU oracle.
 Package xvmroot computes the xvm execution_root in native Go, byte-identical to the lux-private GPU xvm_root_update kernel (ops/xvm/cuda/xvm_roots.cu) and every backend's CPU oracle.

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.