state

package
v1.3.3 Latest Latest
Warning

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

 Go to latest Published: May 7, 2024 License: Apache-2.0 Imports: 23 Imported by: 2

Documentation

Index

Constants

View Source 
const (
	SpuriousDragonMaxCodeSize = 24576
	TxPoolMaxInitCodeSize     = 2 * SpuriousDragonMaxCodeSize

	TxGas                 uint64 = 21000 // Per transaction not creating a contract
	TxGasContractCreation uint64 = 53000 // Per transaction that creates a contract
)
View Source 
const LondonFixHandler forkmanager.HandlerDesc = "LondonFixHandler"

Variables

View Source 
var (
	ErrNonceIncorrect        = errors.New("incorrect nonce")
	ErrNotEnoughFundsForGas  = errors.New("not enough funds to cover gas costs")
	ErrBlockLimitReached     = errors.New("gas limit reached in the pool")
	ErrIntrinsicGasOverflow  = errors.New("overflow in intrinsic gas calculation")
	ErrNotEnoughIntrinsicGas = errors.New("not enough gas supplied for intrinsic gas costs")

	// ErrTipAboveFeeCap is a sanity error to ensure no one is able to specify a
	// transaction with a tip higher than the total fee cap.
	ErrTipAboveFeeCap = errors.New("max priority fee per gas higher than max fee per gas")

	// ErrTipVeryHigh is a sanity error to avoid extremely big numbers specified
	// in the tip field.
	ErrTipVeryHigh = errors.New("max priority fee per gas higher than 2^256-1")

	// ErrFeeCapVeryHigh is a sanity error to avoid extremely big numbers specified
	// in the fee cap field.
	ErrFeeCapVeryHigh = errors.New("max fee per gas higher than 2^256-1")

	// ErrFeeCapTooLow is returned if the transaction fee cap is less than the
	// the base fee of the block.
	ErrFeeCapTooLow = errors.New("max fee per gas less than block base fee")

	// ErrNonceUintOverflow is returned if uint64 overflow happens
	ErrNonceUintOverflow = errors.New("nonce uint64 overflow")
)

Functions

func RegisterLondonFixFork added in v1.1.1 

func RegisterLondonFixFork(londonFixFork string) error

func TestState 

func TestState(t *testing.T, buildPreState buildPreState)

TestState tests a set of tests on a state

func TransactionGasCost 

func TransactionGasCost(msg *types.Transaction, isHomestead, isIstanbul bool) (uint64, error)

Types

type Account 

type Account struct {
	Nonce    uint64
	Balance  *big.Int
	Root     types.Hash
	CodeHash []byte
}

Account is the account reference in the ethereum state

func (*Account) Copy 

func (a *Account) Copy() *Account

func (*Account) MarshalWith 

func (a *Account) MarshalWith(ar *fastrlp.Arena) *fastrlp.Value

func (*Account) String 

func (a *Account) String() string

func (*Account) UnmarshalRlp 

func (a *Account) UnmarshalRlp(b []byte) error

type BlockResult 

type BlockResult struct {
	Root     types.Hash
	Receipts []*types.Receipt
	TotalGas uint64
}

type Executor 

type Executor struct {
	GetHash GetHashByNumberHelper

	PostHook        func(txn *Transition)
	GenesisPostHook func(*Transition) error
	// contains filtered or unexported fields
}

Executor is the main entity

func NewExecutor 

func NewExecutor(config *chain.Params, s State, logger hclog.Logger) *Executor

NewExecutor creates a new executor

func (*Executor) BeginTxn 

func (e *Executor) BeginTxn(
	parentRoot types.Hash,
	header *types.Header,
	coinbaseReceiver types.Address,
) (*Transition, error)

func (*Executor) GetForksInTime 

func (e *Executor) GetForksInTime(blockNumber uint64) chain.ForksInTime

GetForksInTime returns the active forks at the given block height

func (*Executor) ProcessBlock 

func (e *Executor) ProcessBlock(
	parentRoot types.Hash,
	block *types.Block,
	blockCreator types.Address,
) (*Transition, error)

ProcessBlock already does all the handling of the whole process

func (*Executor) State 

func (e *Executor) State() State

StateAt returns snapshot at given root

func (*Executor) StateAt 

func (e *Executor) StateAt(root types.Hash) (Snapshot, error)

StateAt returns snapshot at given root

func (*Executor) WriteGenesis 

func (e *Executor) WriteGenesis(
	alloc map[types.Address]*chain.GenesisAccount,
	initialStateRoot types.Hash) (types.Hash, error)

type GasLimitReachedTransitionApplicationError 

type GasLimitReachedTransitionApplicationError struct {
	TransitionApplicationError
}

func NewGasLimitReachedTransitionApplicationError 

func NewGasLimitReachedTransitionApplicationError(err error) *GasLimitReachedTransitionApplicationError

type GetHashByNumber 

type GetHashByNumber = func(i uint64) types.Hash

GetHashByNumber returns the hash function of a block number

type GetHashByNumberHelper 

type GetHashByNumberHelper = func(*types.Header) GetHashByNumber

type LondonFixFork added in v1.1.1 

type LondonFixFork interface {
	// contains filtered or unexported methods
}

func GetLondonFixHandler added in v1.1.1 

func GetLondonFixHandler(blockNumber uint64) LondonFixFork

type LondonFixForkV1 added in v1.1.1 

type LondonFixForkV1 struct{}

type LondonFixForkV2 added in v1.1.1 

type LondonFixForkV2 struct{}

type Object 

type Object struct {
	Address  types.Address
	CodeHash types.Hash
	Balance  *big.Int
	Root     types.Hash
	Nonce    uint64
	Deleted  bool

	//nolint:godox
	// TODO: Move this to executor (to be fixed in EVM-527)
	DirtyCode bool
	Code      []byte

	Storage []*StorageObject
}

Object is the serialization of the radix object (can be merged to StateObject?).

type PreState 

type PreState struct {
	Nonce   uint64
	Balance uint64
	State   map[types.Hash]types.Hash
}

PreState is the account prestate

type PreStates 

type PreStates map[types.Address]*PreState

PreStates is a set of pre states

type Snapshot 

type Snapshot interface {
	Commit(objs []*Object) (Snapshot, []byte, error)
	// contains filtered or unexported methods
}

type State 

type State interface {
	NewSnapshotAt(types.Hash) (Snapshot, error)
	NewSnapshot() Snapshot
	GetCode(hash types.Hash) ([]byte, bool)
}

type StateObject 

type StateObject struct {
	Account   *Account
	Code      []byte
	Suicide   bool
	Deleted   bool
	DirtyCode bool
	Txn       *iradix.Txn
	// contains filtered or unexported fields
}

StateObject is the internal representation of the account

func (*StateObject) Copy 

func (s *StateObject) Copy() *StateObject

Copy makes a copy of the state object

func (*StateObject) Empty 

func (s *StateObject) Empty() bool

type StorageObject 

type StorageObject struct {
	Deleted bool
	Key     []byte
	Val     []byte
}

StorageObject is an entry in the storage

type Transition 

type Transition struct {
	PostHook func(t *Transition)
	// contains filtered or unexported fields
}

func NewTransition added in v0.6.1 

func NewTransition(config chain.ForksInTime, snap Snapshot, radix *Txn) *Transition

func (*Transition) AccountExists 

func (t *Transition) AccountExists(addr types.Address) bool

func (*Transition) Apply 

func (t *Transition) Apply(msg *types.Transaction) (*runtime.ExecutionResult, error)

Apply applies a new transaction

func (*Transition) Call2 

func (t *Transition) Call2(
	caller types.Address,
	to types.Address,
	input []byte,
	value *big.Int,
	gas uint64,
) *runtime.ExecutionResult

func (*Transition) Callx 

func (t *Transition) Callx(c *runtime.Contract, h runtime.Host) *runtime.ExecutionResult

func (*Transition) Commit 

func (t *Transition) Commit() (Snapshot, types.Hash, error)

Commit commits the final result

func (*Transition) ContextPtr 

func (t *Transition) ContextPtr() *runtime.TxContext

ContextPtr returns reference of context This method is called only by test

func (*Transition) Create2 

func (t *Transition) Create2(
	caller types.Address,
	code []byte,
	value *big.Int,
	gas uint64,
) *runtime.ExecutionResult

func (*Transition) EmitLog 

func (t *Transition) EmitLog(addr types.Address, topics []types.Hash, data []byte)

func (*Transition) Empty 

func (t *Transition) Empty(addr types.Address) bool

func (*Transition) GetBalance 

func (t *Transition) GetBalance(addr types.Address) *big.Int

func (*Transition) GetBlockHash 

func (t *Transition) GetBlockHash(number int64) (res types.Hash)

func (*Transition) GetCode 

func (t *Transition) GetCode(addr types.Address) []byte

func (*Transition) GetCodeHash 

func (t *Transition) GetCodeHash(addr types.Address) (res types.Hash)

func (*Transition) GetCodeSize 

func (t *Transition) GetCodeSize(addr types.Address) int

func (*Transition) GetNonce 

func (t *Transition) GetNonce(addr types.Address) uint64

func (*Transition) GetRefund added in v0.6.2 

func (t *Transition) GetRefund() uint64

func (*Transition) GetStorage 

func (t *Transition) GetStorage(addr types.Address, key types.Hash) types.Hash

func (*Transition) GetTracer added in v0.6.2 

func (t *Transition) GetTracer() runtime.VMTracer

GetTracer returns a tracer in context

func (*Transition) GetTxContext 

func (t *Transition) GetTxContext() runtime.TxContext

func (*Transition) Receipts 

func (t *Transition) Receipts() []*types.Receipt

func (*Transition) Selfdestruct 

func (t *Transition) Selfdestruct(addr types.Address, beneficiary types.Address)

func (*Transition) SetAccountDirectly added in v0.3.0 

func (t *Transition) SetAccountDirectly(addr types.Address, account *chain.GenesisAccount) error

SetAccountDirectly sets an account to the given address NOTE: SetAccountDirectly changes the world state without a transaction

func (*Transition) SetCodeDirectly added in v0.6.0 

func (t *Transition) SetCodeDirectly(addr types.Address, code []byte) error

SetCodeDirectly sets new code into the account with the specified address NOTE: SetCodeDirectly changes the world state without a transaction

func (*Transition) SetNonPayable added in v1.3.1 

func (t *Transition) SetNonPayable(nonPayable bool)

SetNonPayable deactivates the check of tx cost against tx executor balance.

func (*Transition) SetState added in v0.8.0 

func (t *Transition) SetState(addr types.Address, key types.Hash, value types.Hash)

func (*Transition) SetStorage 

func (t *Transition) SetStorage(
	addr types.Address,
	key types.Hash,
	value types.Hash,
	config *chain.ForksInTime,
) runtime.StorageStatus

func (*Transition) SetTracer added in v0.6.2 

func (t *Transition) SetTracer(tracer tracer.Tracer)

SetTracer sets tracer to the context in order to enable it

func (*Transition) TotalGas 

func (t *Transition) TotalGas() uint64

func (*Transition) Transfer added in v0.8.0 

func (t *Transition) Transfer(from, to types.Address, amount *big.Int) error

func (*Transition) Txn 

func (t *Transition) Txn() *Txn

func (*Transition) WithStateOverride added in v0.9.0 

func (t *Transition) WithStateOverride(override types.StateOverride) error

func (*Transition) Write 

func (t *Transition) Write(txn *types.Transaction) error

Write writes another transaction to the executor

type TransitionApplicationError 

type TransitionApplicationError struct {
	Err           error
	IsRecoverable bool // Should the transaction be discarded, or put back in the queue.
}

func NewTransitionApplicationError 

func NewTransitionApplicationError(err error, isRecoverable bool) *TransitionApplicationError

func (*TransitionApplicationError) Error 

func (e *TransitionApplicationError) Error() string

type Txn 

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

Txn is a reference of the state

func NewTxn 

func NewTxn(snapshot Snapshot) *Txn

func (*Txn) AddBalance 

func (txn *Txn) AddBalance(addr types.Address, balance *big.Int)

AddBalance adds balance

func (*Txn) AddRefund 

func (txn *Txn) AddRefund(gas uint64)

Refund

func (*Txn) AddSealingReward 

func (txn *Txn) AddSealingReward(addr types.Address, balance *big.Int)

func (*Txn) CleanDeleteObjects 

func (txn *Txn) CleanDeleteObjects(deleteEmptyObjects bool) error

func (*Txn) Commit 

func (txn *Txn) Commit(deleteEmptyObjects bool) ([]*Object, error)

func (*Txn) CreateAccount 

func (txn *Txn) CreateAccount(addr types.Address)

func (*Txn) EmitLog 

func (txn *Txn) EmitLog(addr types.Address, topics []types.Hash, data []byte)

EmitLog appends log to logs tree storage

func (*Txn) Empty 

func (txn *Txn) Empty(addr types.Address) bool

func (*Txn) Exist 

func (txn *Txn) Exist(addr types.Address) bool

func (*Txn) GetAccount 

func (txn *Txn) GetAccount(addr types.Address) (*Account, bool)

GetAccount returns an account

func (*Txn) GetBalance 

func (txn *Txn) GetBalance(addr types.Address) *big.Int

GetBalance returns the balance of an address

func (*Txn) GetCode 

func (txn *Txn) GetCode(addr types.Address) []byte

GetCode gets the code on a given address

func (*Txn) GetCodeHash 

func (txn *Txn) GetCodeHash(addr types.Address) types.Hash

func (*Txn) GetCodeSize 

func (txn *Txn) GetCodeSize(addr types.Address) int

func (*Txn) GetCommittedState 

func (txn *Txn) GetCommittedState(addr types.Address, key types.Hash) types.Hash

GetCommittedState returns the state of the address in the trie

func (*Txn) GetNonce 

func (txn *Txn) GetNonce(addr types.Address) uint64

GetNonce returns the nonce of an addr

func (*Txn) GetRadix added in v0.6.1 

func (txn *Txn) GetRadix() *iradix.Txn

func (*Txn) GetRefund 

func (txn *Txn) GetRefund() uint64

func (*Txn) GetState 

func (txn *Txn) GetState(addr types.Address, key types.Hash) types.Hash

GetState returns the state of the address at a given key

func (*Txn) HasSuicided 

func (txn *Txn) HasSuicided(addr types.Address) bool

HasSuicided returns true if the account suicided

func (*Txn) IncrNonce 

func (txn *Txn) IncrNonce(addr types.Address) error

IncrNonce increases the nonce of the address

func (*Txn) Logs 

func (txn *Txn) Logs() []*types.Log

func (*Txn) RevertToSnapshot 

func (txn *Txn) RevertToSnapshot(id int) error

RevertToSnapshot reverts to a given snapshot

func (*Txn) SetBalance 

func (txn *Txn) SetBalance(addr types.Address, balance *big.Int)

SetBalance sets the balance

func (*Txn) SetCode 

func (txn *Txn) SetCode(addr types.Address, code []byte)

SetCode sets the code for an address

func (*Txn) SetFullStorage added in v0.9.0 

func (txn *Txn) SetFullStorage(addr types.Address, state map[types.Hash]types.Hash)

SetFullStorage is used to replace the full state of the address. Only used for debugging on the override jsonrpc endpoint.

func (*Txn) SetNonce 

func (txn *Txn) SetNonce(addr types.Address, nonce uint64)

SetNonce reduces the balance

func (*Txn) SetState 

func (txn *Txn) SetState(
	addr types.Address,
	key,
	value types.Hash,
)

SetState change the state of an address

func (*Txn) SetStorage 

func (txn *Txn) SetStorage(
	addr types.Address,
	key types.Hash,
	value types.Hash,
	config *chain.ForksInTime,
) runtime.StorageStatus

SetStorage sets the storage of an address

func (*Txn) Snapshot 

func (txn *Txn) Snapshot() int

Snapshot takes a snapshot at this point in time

func (*Txn) SubBalance 

func (txn *Txn) SubBalance(addr types.Address, amount *big.Int) error

SubBalance reduces the balance at address addr by amount

func (*Txn) SubRefund 

func (txn *Txn) SubRefund(gas uint64)

func (*Txn) Suicide 

func (txn *Txn) Suicide(addr types.Address) bool

Suicide marks the given account as suicided

func (*Txn) TouchAccount 

func (txn *Txn) TouchAccount(addr types.Address)

Source Files

View all Source files

Directories

Path Synopsis
addresslist
evm
precompiled
tracer
tracer/calltracer
tracer/structtracer

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.