Documentation ¶
Overview ¶
Package vm implements the Ethereum Virtual Machine.
The vm package implements one EVM, a byte code VM. The BC (Byte Code) VM loops over a set of bytes and executes them according to the set of rules defined in the Ethereum yellow paper.
Package vm is a generated GoMock package.
Index ¶
- Constants
- Variables
- func EnableEIP(eipNum int, jt *JumpTable) error
- func RunPrecompiledContract(p PrecompiledContract, input []byte, contract *Contract) (ret []byte, err error)
- func WriteLogs(writer io.Writer, logs []*types.Log)
- func WriteTrace(writer io.Writer, logs []StructLog)
- type AccountExtraDataStateGetter
- type AccountExtraDataStateSetter
- type AccountRef
- type AffectedMode
- type AffectedReason
- type AffectedType
- type CallContext
- type CanTransferFunc
- type Config
- type Context
- type Contract
- func (c *Contract) Address() common.Address
- func (c *Contract) AsDelegate() *Contract
- func (c *Contract) Caller() common.Address
- func (c *Contract) GetByte(n uint64) byte
- func (c *Contract) GetOp(n uint64) OpCode
- func (c *Contract) SetCallCode(addr *common.Address, hash common.Hash, code []byte)
- func (c *Contract) SetCodeOptionalHash(addr *common.Address, codeAndHash *codeAndHash)
- func (c *Contract) UseGas(gas uint64) (ok bool)
- func (c *Contract) Value() *big.Int
- type ContractRef
- type EVM
- func (evm *EVM) AffectedContracts() []common.Address
- func (evm *EVM) AffectedMode(a common.Address) (AffectedMode, error)
- func (evm *EVM) CalculateMerkleRoot() (common.Hash, error)
- func (evm *EVM) Call(caller ContractRef, addr common.Address, input []byte, gas uint64, ...) (ret []byte, leftOverGas uint64, err error)
- func (evm *EVM) CallCode(caller ContractRef, addr common.Address, input []byte, gas uint64, ...) (ret []byte, leftOverGas uint64, err error)
- func (evm *EVM) CalledContracts() []common.Address
- func (evm *EVM) Cancel()
- func (evm *EVM) Cancelled() bool
- func (evm *EVM) ChainConfig() *params.ChainConfig
- func (evm *EVM) Create(caller ContractRef, code []byte, gas uint64, value *big.Int) (ret []byte, contractAddr common.Address, leftOverGas uint64, err error)
- func (evm *EVM) Create2(caller ContractRef, code []byte, gas uint64, endowment *big.Int, salt *big.Int) (ret []byte, contractAddr common.Address, leftOverGas uint64, err error)
- func (evm *EVM) CreatedContracts() []common.Address
- func (evm *EVM) DelegateCall(caller ContractRef, addr common.Address, input []byte, gas uint64) (ret []byte, leftOverGas uint64, err error)
- func (evm *EVM) Depth() int
- func (evm *EVM) Interpreter() Interpreter
- func (evm *EVM) Pop()
- func (evm *EVM) PrivateState() PrivateState
- func (evm *EVM) PublicState() PublicState
- func (evm *EVM) Push(statedb StateDB)
- func (evm *EVM) RevertToSnapshot(snapshot int)
- func (evm *EVM) SetCurrentTX(tx *types.Transaction)
- func (evm *EVM) SetTxPrivacyMetadata(pm *types.PrivacyMetadata)
- func (evm *EVM) StaticCall(caller ContractRef, addr common.Address, input []byte, gas uint64) (ret []byte, leftOverGas uint64, err error)
- type EVMInterpreter
- type GetHashFunc
- type Interpreter
- type JSONLogger
- func (l *JSONLogger) CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) error
- func (l *JSONLogger) CaptureFault(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, ...) error
- func (l *JSONLogger) CaptureStart(from common.Address, to common.Address, create bool, input []byte, gas uint64, ...) error
- func (l *JSONLogger) CaptureState(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, ...) error
- type JumpTable
- type LogConfig
- type Memory
- func (m *Memory) Data() []byte
- func (m *Memory) GetCopy(offset, size int64) (cpy []byte)
- func (m *Memory) GetPtr(offset, size int64) []byte
- func (m *Memory) Len() int
- func (m *Memory) Print()
- func (m *Memory) Resize(size uint64)
- func (m *Memory) Set(offset, size uint64, value []byte)
- func (m *Memory) Set32(offset uint64, val *big.Int)
- type MinimalApiState
- type MockAccountExtraDataStateGetter
- func (m *MockAccountExtraDataStateGetter) EXPECT() *MockAccountExtraDataStateGetterMockRecorder
- func (m *MockAccountExtraDataStateGetter) GetManagedParties(addr common.Address) ([]string, error)
- func (m *MockAccountExtraDataStateGetter) GetPrivacyMetadata(addr common.Address) (*state.PrivacyMetadata, error)
- type MockAccountExtraDataStateGetterMockRecorder
- type MockAccountExtraDataStateSetter
- func (m *MockAccountExtraDataStateSetter) EXPECT() *MockAccountExtraDataStateSetterMockRecorder
- func (m *MockAccountExtraDataStateSetter) SetManagedParties(addr common.Address, managedParties []string)
- func (m *MockAccountExtraDataStateSetter) SetPrivacyMetadata(addr common.Address, pm *state.PrivacyMetadata)
- type MockAccountExtraDataStateSetterMockRecorder
- type MockCallContext
- func (m *MockCallContext) Call(env *EVM, me ContractRef, addr common.Address, data []byte, ...) ([]byte, error)
- func (m *MockCallContext) CallCode(env *EVM, me ContractRef, addr common.Address, data []byte, ...) ([]byte, error)
- func (m *MockCallContext) Create(env *EVM, me ContractRef, data []byte, gas, value *big.Int) ([]byte, common.Address, error)
- func (m *MockCallContext) DelegateCall(env *EVM, me ContractRef, addr common.Address, data []byte, gas *big.Int) ([]byte, error)
- func (m *MockCallContext) EXPECT() *MockCallContextMockRecorder
- type MockCallContextMockRecorder
- func (mr *MockCallContextMockRecorder) Call(env, me, addr, data, gas, value interface{}) *gomock.Call
- func (mr *MockCallContextMockRecorder) CallCode(env, me, addr, data, gas, value interface{}) *gomock.Call
- func (mr *MockCallContextMockRecorder) Create(env, me, data, gas, value interface{}) *gomock.Call
- func (mr *MockCallContextMockRecorder) DelegateCall(env, me, addr, data, gas interface{}) *gomock.Call
- type MockMinimalApiState
- func (m *MockMinimalApiState) EXPECT() *MockMinimalApiStateMockRecorder
- func (m *MockMinimalApiState) Error() error
- func (m *MockMinimalApiState) GetBalance(addr common.Address) *big.Int
- func (m *MockMinimalApiState) GetCode(addr common.Address) []byte
- func (m *MockMinimalApiState) GetCodeHash(arg0 common.Address) common.Hash
- func (m *MockMinimalApiState) GetManagedParties(addr common.Address) ([]string, error)
- func (m *MockMinimalApiState) GetNonce(addr common.Address) uint64
- func (m *MockMinimalApiState) GetPrivacyMetadata(addr common.Address) (*state.PrivacyMetadata, error)
- func (m *MockMinimalApiState) GetProof(arg0 common.Address) ([][]byte, error)
- func (m *MockMinimalApiState) GetRLPEncodedStateObject(addr common.Address) ([]byte, error)
- func (m *MockMinimalApiState) GetState(a common.Address, b common.Hash) common.Hash
- func (m *MockMinimalApiState) GetStorageProof(arg0 common.Address, arg1 common.Hash) ([][]byte, error)
- func (m *MockMinimalApiState) SetBalance(addr common.Address, balance *big.Int)
- func (m *MockMinimalApiState) SetCode(arg0 common.Address, arg1 []byte)
- func (m *MockMinimalApiState) SetNonce(addr common.Address, nonce uint64)
- func (m *MockMinimalApiState) SetState(arg0 common.Address, arg1, arg2 common.Hash)
- func (m *MockMinimalApiState) SetStorage(addr common.Address, storage map[common.Hash]common.Hash)
- func (m *MockMinimalApiState) StorageTrie(addr common.Address) state.Trie
- type MockMinimalApiStateMockRecorder
- func (mr *MockMinimalApiStateMockRecorder) Error() *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetBalance(addr interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetCode(addr interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetCodeHash(arg0 interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetManagedParties(addr interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetNonce(addr interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetPrivacyMetadata(addr interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetProof(arg0 interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetRLPEncodedStateObject(addr interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetState(a, b interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) GetStorageProof(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) SetBalance(addr, balance interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) SetCode(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) SetNonce(addr, nonce interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) SetState(arg0, arg1, arg2 interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) SetStorage(addr, storage interface{}) *gomock.Call
- func (mr *MockMinimalApiStateMockRecorder) StorageTrie(addr interface{}) *gomock.Call
- type MockStateDB
- func (m *MockStateDB) AddBalance(arg0 common.Address, arg1 *big.Int)
- func (m *MockStateDB) AddLog(arg0 *types.Log)
- func (m *MockStateDB) AddPreimage(arg0 common.Hash, arg1 []byte)
- func (m *MockStateDB) AddRefund(arg0 uint64)
- func (m *MockStateDB) CreateAccount(arg0 common.Address)
- func (m *MockStateDB) EXPECT() *MockStateDBMockRecorder
- func (m *MockStateDB) Empty(arg0 common.Address) bool
- func (m *MockStateDB) Error() error
- func (m *MockStateDB) Exist(arg0 common.Address) bool
- func (m *MockStateDB) ForEachStorage(arg0 common.Address, arg1 func(common.Hash, common.Hash) bool) error
- func (m *MockStateDB) GetBalance(addr common.Address) *big.Int
- func (m *MockStateDB) GetCode(addr common.Address) []byte
- func (m *MockStateDB) GetCodeHash(arg0 common.Address) common.Hash
- func (m *MockStateDB) GetCodeSize(arg0 common.Address) int
- func (m *MockStateDB) GetCommittedState(arg0 common.Address, arg1 common.Hash) common.Hash
- func (m *MockStateDB) GetManagedParties(addr common.Address) ([]string, error)
- func (m *MockStateDB) GetNonce(addr common.Address) uint64
- func (m *MockStateDB) GetPrivacyMetadata(addr common.Address) (*state.PrivacyMetadata, error)
- func (m *MockStateDB) GetProof(arg0 common.Address) ([][]byte, error)
- func (m *MockStateDB) GetRLPEncodedStateObject(addr common.Address) ([]byte, error)
- func (m *MockStateDB) GetRefund() uint64
- func (m *MockStateDB) GetState(a common.Address, b common.Hash) common.Hash
- func (m *MockStateDB) GetStorageProof(arg0 common.Address, arg1 common.Hash) ([][]byte, error)
- func (m *MockStateDB) HasSuicided(arg0 common.Address) bool
- func (m *MockStateDB) RevertToSnapshot(arg0 int)
- func (m *MockStateDB) SetBalance(addr common.Address, balance *big.Int)
- func (m *MockStateDB) SetCode(arg0 common.Address, arg1 []byte)
- func (m *MockStateDB) SetManagedParties(addr common.Address, managedParties []string)
- func (m *MockStateDB) SetNonce(addr common.Address, nonce uint64)
- func (m *MockStateDB) SetPrivacyMetadata(addr common.Address, pm *state.PrivacyMetadata)
- func (m *MockStateDB) SetState(arg0 common.Address, arg1, arg2 common.Hash)
- func (m *MockStateDB) SetStorage(addr common.Address, storage map[common.Hash]common.Hash)
- func (m *MockStateDB) Snapshot() int
- func (m *MockStateDB) StorageTrie(addr common.Address) state.Trie
- func (m *MockStateDB) SubBalance(arg0 common.Address, arg1 *big.Int)
- func (m *MockStateDB) SubRefund(arg0 uint64)
- func (m *MockStateDB) Suicide(arg0 common.Address) bool
- type MockStateDBMockRecorder
- func (mr *MockStateDBMockRecorder) AddBalance(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) AddLog(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) AddPreimage(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) AddRefund(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) CreateAccount(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) Empty(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) Error() *gomock.Call
- func (mr *MockStateDBMockRecorder) Exist(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) ForEachStorage(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetBalance(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetCode(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetCodeHash(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetCodeSize(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetCommittedState(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetManagedParties(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetNonce(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetPrivacyMetadata(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetProof(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetRLPEncodedStateObject(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetRefund() *gomock.Call
- func (mr *MockStateDBMockRecorder) GetState(a, b interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) GetStorageProof(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) HasSuicided(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) RevertToSnapshot(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetBalance(addr, balance interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetCode(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetManagedParties(addr, managedParties interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetNonce(addr, nonce interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetPrivacyMetadata(addr, pm interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetState(arg0, arg1, arg2 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SetStorage(addr, storage interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) Snapshot() *gomock.Call
- func (mr *MockStateDBMockRecorder) StorageTrie(addr interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SubBalance(arg0, arg1 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) SubRefund(arg0 interface{}) *gomock.Call
- func (mr *MockStateDBMockRecorder) Suicide(arg0 interface{}) *gomock.Call
- type OpCode
- type PrecompiledContract
- type PrivateState
- type PublicState
- type Stack
- type StateDB
- type Storage
- type StructLog
- type StructLogger
- func (l *StructLogger) CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) error
- func (l *StructLogger) CaptureFault(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, ...) error
- func (l *StructLogger) CaptureStart(from common.Address, to common.Address, create bool, input []byte, gas uint64, ...) error
- func (l *StructLogger) CaptureState(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, ...) error
- func (l *StructLogger) Error() error
- func (l *StructLogger) Output() []byte
- func (l *StructLogger) StructLogs() []StructLog
- type Tracer
- type TransferFunc
Constants ¶
const ( // ModeUnknown indicates an auxiliary mode used during initialization of an affected contract ModeUnknown AffectedMode = iota // ModeRead indicates that state has not been modified as the result of contract code execution ModeRead AffectedMode = iota // ModeWrite indicates that state has been modified as the result of contract code execution ModeWrite = ModeRead << 1 // ModeUpdated indicates that the affected mode has been setup for multitenancy check. // This is mainly used during simulation and eth_call ModeUpdated = ModeRead << 7 )
const ( GasQuickStep uint64 = 2 GasFastestStep uint64 = 3 GasFastStep uint64 = 5 GasMidStep uint64 = 8 GasSlowStep uint64 = 10 GasExtStep uint64 = 20 )
Gas costs
Variables ¶
var ( ErrOutOfGas = errors.New("out of gas") ErrCodeStoreOutOfGas = errors.New("contract creation code storage out of gas") ErrDepth = errors.New("max call depth exceeded") ErrTraceLimitReached = errors.New("the number of logs reached the specified limit") ErrInsufficientBalance = errors.New("insufficient balance for transfer") ErrContractAddressCollision = errors.New("contract address collision") ErrReadOnlyValueTransfer = errors.New("VM in read-only mode. Value transfer prohibited.") ErrNoCompatibleInterpreter = errors.New("no compatible interpreter") )
var PrecompiledContractsByzantium = map[common.Address]PrecompiledContract{ common.BytesToAddress([]byte{1}): &ecrecover{}, common.BytesToAddress([]byte{2}): &sha256hash{}, common.BytesToAddress([]byte{3}): &ripemd160hash{}, common.BytesToAddress([]byte{4}): &dataCopy{}, common.BytesToAddress([]byte{5}): &bigModExp{}, common.BytesToAddress([]byte{6}): &bn256AddByzantium{}, common.BytesToAddress([]byte{7}): &bn256ScalarMulByzantium{}, common.BytesToAddress([]byte{8}): &bn256PairingByzantium{}, }
PrecompiledContractsByzantium contains the default set of pre-compiled Ethereum contracts used in the Byzantium release.
var PrecompiledContractsHomestead = map[common.Address]PrecompiledContract{ common.BytesToAddress([]byte{1}): &ecrecover{}, common.BytesToAddress([]byte{2}): &sha256hash{}, common.BytesToAddress([]byte{3}): &ripemd160hash{}, common.BytesToAddress([]byte{4}): &dataCopy{}, }
PrecompiledContractsHomestead contains the default set of pre-compiled Ethereum contracts used in the Frontier and Homestead releases.
var PrecompiledContractsIstanbul = map[common.Address]PrecompiledContract{ common.BytesToAddress([]byte{1}): &ecrecover{}, common.BytesToAddress([]byte{2}): &sha256hash{}, common.BytesToAddress([]byte{3}): &ripemd160hash{}, common.BytesToAddress([]byte{4}): &dataCopy{}, common.BytesToAddress([]byte{5}): &bigModExp{}, common.BytesToAddress([]byte{6}): &bn256AddIstanbul{}, common.BytesToAddress([]byte{7}): &bn256ScalarMulIstanbul{}, common.BytesToAddress([]byte{8}): &bn256PairingIstanbul{}, common.BytesToAddress([]byte{9}): &blake2F{}, }
PrecompiledContractsIstanbul contains the default set of pre-compiled Ethereum contracts used in the Istanbul release.
Functions ¶
func EnableEIP ¶
EnableEIP enables the given EIP on the config. This operation writes in-place, and callers need to ensure that the globally defined jump tables are not polluted.
func RunPrecompiledContract ¶
func RunPrecompiledContract(p PrecompiledContract, input []byte, contract *Contract) (ret []byte, err error)
RunPrecompiledContract runs and evaluates the output of a precompiled contract.
func WriteTrace ¶
WriteTrace writes a formatted trace to the given writer
Types ¶
type AccountRef ¶
AccountRef implements ContractRef.
Account references are used during EVM initialisation and it's primary use is to fetch addresses. Removing this object proves difficult because of the cached jump destinations which are fetched from the parent contract (i.e. the caller), which is a ContractRef.
func (AccountRef) Address ¶
func (ar AccountRef) Address() common.Address
Address casts AccountRef to a Address
type AffectedMode ¶
type AffectedMode byte
AffectedMode defines a mode in which the state is operated as the result of contract code execution.
func ModeOf ¶
func ModeOf(isWrite bool) AffectedMode
func (AffectedMode) Has ¶
func (mode AffectedMode) Has(modes ...AffectedMode) bool
func (AffectedMode) IsNotAuthorized ¶
func (mode AffectedMode) IsNotAuthorized(actualMode AffectedMode) bool
func (AffectedMode) Update ¶
func (mode AffectedMode) Update(authorizedRead bool, authorizedWrite bool) AffectedMode
type AffectedReason ¶
type AffectedReason byte
AffectedReason defines a type of operation that was applied to a contract.
const ( Creation AffectedReason = iota MessageCall )
type AffectedType ¶
type AffectedType struct {
// contains filtered or unexported fields
}
AffectedType defines attributes indicating how a contract is affected as the result of the contract code execution in an EVM
func (AffectedType) String ¶
func (t AffectedType) String() string
type CallContext ¶
type CallContext interface { // Call another contract Call(env *EVM, me ContractRef, addr common.Address, data []byte, gas, value *big.Int) ([]byte, error) // Take another's contract code and execute within our own context CallCode(env *EVM, me ContractRef, addr common.Address, data []byte, gas, value *big.Int) ([]byte, error) // Same as CallCode except sender and value is propagated from parent to child scope DelegateCall(env *EVM, me ContractRef, addr common.Address, data []byte, gas *big.Int) ([]byte, error) // Create a new contract Create(env *EVM, me ContractRef, data []byte, gas, value *big.Int) ([]byte, common.Address, error) }
CallContext provides a basic interface for the EVM calling conventions. The EVM depends on this context being implemented for doing subcalls and initialising new EVM contracts.
type CanTransferFunc ¶
CanTransferFunc is the signature of a transfer guard function
type Config ¶
type Config struct { Debug bool // Enables debugging Tracer Tracer // Opcode logger NoRecursion bool // Disables call, callcode, delegate call and create EnablePreimageRecording bool // Enables recording of SHA3/keccak preimages JumpTable [256]operation // EVM instruction table, automatically populated if unset EWASMInterpreter string // External EWASM interpreter options EVMInterpreter string // External EVM interpreter options ExtraEips []int // Additional EIPS that are to be enabled }
Config are the configuration options for the Interpreter
type Context ¶
type Context struct { // CanTransfer returns whether the account contains // sufficient ether to transfer the value CanTransfer CanTransferFunc // Transfer transfers ether from one account to the other Transfer TransferFunc // GetHash returns the hash corresponding to n GetHash GetHashFunc // Message information Origin common.Address // Provides information for ORIGIN GasPrice *big.Int // Provides information for GASPRICE // Block information Coinbase common.Address // Provides information for COINBASE GasLimit uint64 // Provides information for GASLIMIT BlockNumber *big.Int // Provides information for NUMBER Time *big.Int // Provides information for TIME Difficulty *big.Int // Provides information for DIFFICULTY // Quorum // EVM should consider multitenancy SupportsMultitenancy bool // AuthorizeCreateFunc performs tenancy authorization check for contract creation. // It's only injected during simulation AuthorizeCreateFunc multitenancy.AuthorizeCreateFunc // AuthorizeMessageCallFunc performs tenancy authorization check for message call to a contract. // It's only injected during simulation/eth_call AuthorizeMessageCallFunc multitenancy.AuthorizeMessageCallFunc }
Context provides the EVM with auxiliary information. Once provided it shouldn't be modified.
type Contract ¶
type Contract struct { // CallerAddress is the result of the caller which initialised this // contract. However when the "call method" is delegated this value // needs to be initialised to that of the caller's caller. CallerAddress common.Address Code []byte CodeHash common.Hash CodeAddr *common.Address Input []byte Gas uint64 // contains filtered or unexported fields }
Contract represents an ethereum contract in the state database. It contains the contract code, calling arguments. Contract implements ContractRef
func NewContract ¶
func NewContract(caller ContractRef, object ContractRef, value *big.Int, gas uint64) *Contract
NewContract returns a new contract environment for the execution of EVM.
func (*Contract) AsDelegate ¶
AsDelegate sets the contract to be a delegate call and returns the current contract (for chaining calls)
func (*Contract) Caller ¶
Caller returns the caller of the contract.
Caller will recursively call caller when the contract is a delegate call, including that of caller's caller.
func (*Contract) SetCallCode ¶
SetCallCode sets the code of the contract and address of the backing data object
func (*Contract) SetCodeOptionalHash ¶
SetCodeOptionalHash can be used to provide code, but it's optional to provide hash. In case hash is not provided, the jumpdest analysis will not be saved to the parent context
type ContractRef ¶
ContractRef is a reference to the contract's backing object
type EVM ¶
type EVM struct { // Context provides auxiliary blockchain related information Context // StateDB gives access to the underlying state StateDB StateDB // contains filtered or unexported fields }
EVM is the Ethereum Virtual Machine base object and provides the necessary tools to run a contract on the given state with the provided context. It should be noted that any error generated through any of the calls should be considered a revert-state-and-consume-all-gas operation, no checks on specific errors should ever be performed. The interpreter makes sure that any errors generated are to be considered faulty code.
The EVM should never be reused and is not thread safe.
func NewEVM ¶
func NewEVM(ctx Context, statedb, privateState StateDB, chainConfig *params.ChainConfig, vmConfig Config) *EVM
NewEVM returns a new EVM. The returned EVM is not thread safe and should only ever be used *once*.
func (*EVM) AffectedContracts ¶
Quorum
AffectedContracts returns all affected contracts that are the results of MessageCall transaction
func (*EVM) AffectedMode ¶
func (evm *EVM) AffectedMode(a common.Address) (AffectedMode, error)
Quorum
AffecteMode returns the type of operation (read/write) which was applied on the given contract address. It returns ModeUnknown if the contract is not affected during the lifecycle of this EVM instance
func (*EVM) CalculateMerkleRoot ¶
Return MerkleRoot of all affected contracts (due to both creation and message call)
func (*EVM) Call ¶
func (evm *EVM) Call(caller ContractRef, addr common.Address, input []byte, gas uint64, value *big.Int) (ret []byte, leftOverGas uint64, err error)
Call executes the contract associated with the addr with the given input as parameters. It also handles any necessary value transfer required and takes the necessary steps to create accounts and reverses the state in case of an execution error or failed value transfer.
func (*EVM) CallCode ¶
func (evm *EVM) CallCode(caller ContractRef, addr common.Address, input []byte, gas uint64, value *big.Int) (ret []byte, leftOverGas uint64, err error)
CallCode executes the contract associated with the addr with the given input as parameters. It also handles any necessary value transfer required and takes the necessary steps to create accounts and reverses the state in case of an execution error or failed value transfer.
CallCode differs from Call in the sense that it executes the given address' code with the caller as context.
func (*EVM) Cancel ¶
func (evm *EVM) Cancel()
Cancel cancels any running EVM operation. This may be called concurrently and it's safe to be called multiple times.
func (*EVM) ChainConfig ¶
func (evm *EVM) ChainConfig() *params.ChainConfig
ChainConfig returns the environment's chain configuration
func (*EVM) Create ¶
func (evm *EVM) Create(caller ContractRef, code []byte, gas uint64, value *big.Int) (ret []byte, contractAddr common.Address, leftOverGas uint64, err error)
Create creates a new contract using code as deployment code.
func (*EVM) Create2 ¶
func (evm *EVM) Create2(caller ContractRef, code []byte, gas uint64, endowment *big.Int, salt *big.Int) (ret []byte, contractAddr common.Address, leftOverGas uint64, err error)
Create2 creates a new contract using code as deployment code.
The different between Create2 with Create is Create2 uses sha3(0xff ++ msg.sender ++ salt ++ sha3(init_code))[12:] instead of the usual sender-and-nonce-hash as the address where the contract is initialized at.
func (*EVM) DelegateCall ¶
func (evm *EVM) DelegateCall(caller ContractRef, addr common.Address, input []byte, gas uint64) (ret []byte, leftOverGas uint64, err error)
DelegateCall executes the contract associated with the addr with the given input as parameters. It reverses the state in case of an execution error.
DelegateCall differs from CallCode in the sense that it executes the given address' code with the caller as context and the caller is set to the caller of the caller.
func (*EVM) Interpreter ¶
func (evm *EVM) Interpreter() Interpreter
Interpreter returns the current interpreter
func (*EVM) PrivateState ¶
func (evm *EVM) PrivateState() PrivateState
func (*EVM) PublicState ¶
func (evm *EVM) PublicState() PublicState
func (*EVM) RevertToSnapshot ¶
We only need to revert the current state because when we call from private public state it's read only, there wouldn't be anything to reset. (A)->(B)->C->(B): A failure in (B) wouldn't need to reset C, as C was flagged read only.
func (*EVM) SetCurrentTX ¶
func (evm *EVM) SetCurrentTX(tx *types.Transaction)
func (*EVM) SetTxPrivacyMetadata ¶
func (evm *EVM) SetTxPrivacyMetadata(pm *types.PrivacyMetadata)
func (*EVM) StaticCall ¶
func (evm *EVM) StaticCall(caller ContractRef, addr common.Address, input []byte, gas uint64) (ret []byte, leftOverGas uint64, err error)
StaticCall executes the contract associated with the addr with the given input as parameters while disallowing any modifications to the state during the call. Opcodes that attempt to perform such modifications will result in exceptions instead of performing the modifications.
type EVMInterpreter ¶
type EVMInterpreter struct {
// contains filtered or unexported fields
}
EVMInterpreter represents an EVM interpreter
func NewEVMInterpreter ¶
func NewEVMInterpreter(evm *EVM, cfg Config) *EVMInterpreter
NewEVMInterpreter returns a new instance of the Interpreter.
func (*EVMInterpreter) CanRun ¶
func (in *EVMInterpreter) CanRun(code []byte) bool
CanRun tells if the contract, passed as an argument, can be run by the current interpreter.
func (*EVMInterpreter) Run ¶
func (in *EVMInterpreter) Run(contract *Contract, input []byte, readOnly bool) (ret []byte, err error)
Run loops and evaluates the contract's code with the given input data and returns the return byte-slice and an error if one occurred.
It's important to note that any errors returned by the interpreter should be considered a revert-and-consume-all-gas operation except for errExecutionReverted which means revert-and-keep-gas-left.
type GetHashFunc ¶
GetHashFunc returns the n'th block hash in the blockchain and is used by the BLOCKHASH EVM op code.
type Interpreter ¶
type Interpreter interface { // Run loops and evaluates the contract's code with the given input data and returns // the return byte-slice and an error if one occurred. Run(contract *Contract, input []byte, static bool) ([]byte, error) // CanRun tells if the contract, passed as an argument, can be // run by the current interpreter. This is meant so that the // caller can do something like: // // “`golang // for _, interpreter := range interpreters { // if interpreter.CanRun(contract.code) { // interpreter.Run(contract.code, input) // } // } // “` CanRun([]byte) bool }
Interpreter is used to run Ethereum based contracts and will utilise the passed environment to query external sources for state information. The Interpreter will run the byte code VM based on the passed configuration.
type JSONLogger ¶
type JSONLogger struct {
// contains filtered or unexported fields
}
func NewJSONLogger ¶
func NewJSONLogger(cfg *LogConfig, writer io.Writer) *JSONLogger
NewJSONLogger creates a new EVM tracer that prints execution steps as JSON objects into the provided stream.
func (*JSONLogger) CaptureEnd ¶
CaptureEnd is triggered at end of execution.
func (*JSONLogger) CaptureFault ¶
func (l *JSONLogger) CaptureFault(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, contract *Contract, depth int, err error) error
CaptureFault outputs state information on the logger.
func (*JSONLogger) CaptureStart ¶
type JumpTable ¶
type JumpTable [256]operation
JumpTable contains the EVM opcodes supported at a given fork.
type LogConfig ¶
type LogConfig struct { DisableMemory bool // disable memory capture DisableStack bool // disable stack capture DisableStorage bool // disable storage capture Debug bool // print output during capture end Limit int // maximum length of output, but zero means unlimited }
LogConfig are the configuration options for structured logger the EVM
type Memory ¶
type Memory struct {
// contains filtered or unexported fields
}
Memory implements a simple memory model for the ethereum virtual machine.
type MinimalApiState ¶
type MinimalApiState interface { AccountExtraDataStateGetter GetBalance(addr common.Address) *big.Int SetBalance(addr common.Address, balance *big.Int) GetCode(addr common.Address) []byte GetState(a common.Address, b common.Hash) common.Hash GetNonce(addr common.Address) uint64 SetNonce(addr common.Address, nonce uint64) SetCode(common.Address, []byte) // RLP-encoded of the state object in a given address // Throw error if no state object is found GetRLPEncodedStateObject(addr common.Address) ([]byte, error) GetProof(common.Address) ([][]byte, error) GetStorageProof(common.Address, common.Hash) ([][]byte, error) StorageTrie(addr common.Address) state.Trie Error() error GetCodeHash(common.Address) common.Hash SetState(common.Address, common.Hash, common.Hash) SetStorage(addr common.Address, storage map[common.Hash]common.Hash) }
Quorum uses a cut-down StateDB, MinimalApiState. We leave the methods in StateDB commented out so they'll produce a conflict when upstream changes.
type MockAccountExtraDataStateGetter ¶
type MockAccountExtraDataStateGetter struct {
// contains filtered or unexported fields
}
MockAccountExtraDataStateGetter is a mock of AccountExtraDataStateGetter interface.
func NewMockAccountExtraDataStateGetter ¶
func NewMockAccountExtraDataStateGetter(ctrl *gomock.Controller) *MockAccountExtraDataStateGetter
NewMockAccountExtraDataStateGetter creates a new mock instance.
func (*MockAccountExtraDataStateGetter) EXPECT ¶
func (m *MockAccountExtraDataStateGetter) EXPECT() *MockAccountExtraDataStateGetterMockRecorder
EXPECT returns an object that allows the caller to indicate expected use.
func (*MockAccountExtraDataStateGetter) GetManagedParties ¶
func (m *MockAccountExtraDataStateGetter) GetManagedParties(addr common.Address) ([]string, error)
GetManagedParties mocks base method.
func (*MockAccountExtraDataStateGetter) GetPrivacyMetadata ¶
func (m *MockAccountExtraDataStateGetter) GetPrivacyMetadata(addr common.Address) (*state.PrivacyMetadata, error)
GetPrivacyMetadata mocks base method.
type MockAccountExtraDataStateGetterMockRecorder ¶
type MockAccountExtraDataStateGetterMockRecorder struct {
// contains filtered or unexported fields
}
MockAccountExtraDataStateGetterMockRecorder is the mock recorder for MockAccountExtraDataStateGetter.
func (*MockAccountExtraDataStateGetterMockRecorder) GetManagedParties ¶
func (mr *MockAccountExtraDataStateGetterMockRecorder) GetManagedParties(addr interface{}) *gomock.Call
GetManagedParties indicates an expected call of GetManagedParties.
func (*MockAccountExtraDataStateGetterMockRecorder) GetPrivacyMetadata ¶
func (mr *MockAccountExtraDataStateGetterMockRecorder) GetPrivacyMetadata(addr interface{}) *gomock.Call
GetPrivacyMetadata indicates an expected call of GetPrivacyMetadata.
type MockAccountExtraDataStateSetter ¶
type MockAccountExtraDataStateSetter struct {
// contains filtered or unexported fields
}
MockAccountExtraDataStateSetter is a mock of AccountExtraDataStateSetter interface.
func NewMockAccountExtraDataStateSetter ¶
func NewMockAccountExtraDataStateSetter(ctrl *gomock.Controller) *MockAccountExtraDataStateSetter
NewMockAccountExtraDataStateSetter creates a new mock instance.
func (*MockAccountExtraDataStateSetter) EXPECT ¶
func (m *MockAccountExtraDataStateSetter) EXPECT() *MockAccountExtraDataStateSetterMockRecorder
EXPECT returns an object that allows the caller to indicate expected use.
func (*MockAccountExtraDataStateSetter) SetManagedParties ¶
func (m *MockAccountExtraDataStateSetter) SetManagedParties(addr common.Address, managedParties []string)
SetManagedParties mocks base method.
func (*MockAccountExtraDataStateSetter) SetPrivacyMetadata ¶
func (m *MockAccountExtraDataStateSetter) SetPrivacyMetadata(addr common.Address, pm *state.PrivacyMetadata)
SetPrivacyMetadata mocks base method.
type MockAccountExtraDataStateSetterMockRecorder ¶
type MockAccountExtraDataStateSetterMockRecorder struct {
// contains filtered or unexported fields
}
MockAccountExtraDataStateSetterMockRecorder is the mock recorder for MockAccountExtraDataStateSetter.
func (*MockAccountExtraDataStateSetterMockRecorder) SetManagedParties ¶
func (mr *MockAccountExtraDataStateSetterMockRecorder) SetManagedParties(addr, managedParties interface{}) *gomock.Call
SetManagedParties indicates an expected call of SetManagedParties.
func (*MockAccountExtraDataStateSetterMockRecorder) SetPrivacyMetadata ¶
func (mr *MockAccountExtraDataStateSetterMockRecorder) SetPrivacyMetadata(addr, pm interface{}) *gomock.Call
SetPrivacyMetadata indicates an expected call of SetPrivacyMetadata.
type MockCallContext ¶
type MockCallContext struct {
// contains filtered or unexported fields
}
MockCallContext is a mock of CallContext interface.
func NewMockCallContext ¶
func NewMockCallContext(ctrl *gomock.Controller) *MockCallContext
NewMockCallContext creates a new mock instance.
func (*MockCallContext) Call ¶
func (m *MockCallContext) Call(env *EVM, me ContractRef, addr common.Address, data []byte, gas, value *big.Int) ([]byte, error)
Call mocks base method.
func (*MockCallContext) CallCode ¶
func (m *MockCallContext) CallCode(env *EVM, me ContractRef, addr common.Address, data []byte, gas, value *big.Int) ([]byte, error)
CallCode mocks base method.
func (*MockCallContext) Create ¶
func (m *MockCallContext) Create(env *EVM, me ContractRef, data []byte, gas, value *big.Int) ([]byte, common.Address, error)
Create mocks base method.
func (*MockCallContext) DelegateCall ¶
func (m *MockCallContext) DelegateCall(env *EVM, me ContractRef, addr common.Address, data []byte, gas *big.Int) ([]byte, error)
DelegateCall mocks base method.
func (*MockCallContext) EXPECT ¶
func (m *MockCallContext) EXPECT() *MockCallContextMockRecorder
EXPECT returns an object that allows the caller to indicate expected use.
type MockCallContextMockRecorder ¶
type MockCallContextMockRecorder struct {
// contains filtered or unexported fields
}
MockCallContextMockRecorder is the mock recorder for MockCallContext.
func (*MockCallContextMockRecorder) Call ¶
func (mr *MockCallContextMockRecorder) Call(env, me, addr, data, gas, value interface{}) *gomock.Call
Call indicates an expected call of Call.
func (*MockCallContextMockRecorder) CallCode ¶
func (mr *MockCallContextMockRecorder) CallCode(env, me, addr, data, gas, value interface{}) *gomock.Call
CallCode indicates an expected call of CallCode.
func (*MockCallContextMockRecorder) Create ¶
func (mr *MockCallContextMockRecorder) Create(env, me, data, gas, value interface{}) *gomock.Call
Create indicates an expected call of Create.
func (*MockCallContextMockRecorder) DelegateCall ¶
func (mr *MockCallContextMockRecorder) DelegateCall(env, me, addr, data, gas interface{}) *gomock.Call
DelegateCall indicates an expected call of DelegateCall.
type MockMinimalApiState ¶
type MockMinimalApiState struct {
// contains filtered or unexported fields
}
MockMinimalApiState is a mock of MinimalApiState interface.
func NewMockMinimalApiState ¶
func NewMockMinimalApiState(ctrl *gomock.Controller) *MockMinimalApiState
NewMockMinimalApiState creates a new mock instance.
func (*MockMinimalApiState) EXPECT ¶
func (m *MockMinimalApiState) EXPECT() *MockMinimalApiStateMockRecorder
EXPECT returns an object that allows the caller to indicate expected use.
func (*MockMinimalApiState) Error ¶
func (m *MockMinimalApiState) Error() error
Error mocks base method.
func (*MockMinimalApiState) GetBalance ¶
func (m *MockMinimalApiState) GetBalance(addr common.Address) *big.Int
GetBalance mocks base method.
func (*MockMinimalApiState) GetCode ¶
func (m *MockMinimalApiState) GetCode(addr common.Address) []byte
GetCode mocks base method.
func (*MockMinimalApiState) GetCodeHash ¶
func (m *MockMinimalApiState) GetCodeHash(arg0 common.Address) common.Hash
GetCodeHash mocks base method.
func (*MockMinimalApiState) GetManagedParties ¶
func (m *MockMinimalApiState) GetManagedParties(addr common.Address) ([]string, error)
GetManagedParties mocks base method.
func (*MockMinimalApiState) GetNonce ¶
func (m *MockMinimalApiState) GetNonce(addr common.Address) uint64
GetNonce mocks base method.
func (*MockMinimalApiState) GetPrivacyMetadata ¶
func (m *MockMinimalApiState) GetPrivacyMetadata(addr common.Address) (*state.PrivacyMetadata, error)
GetPrivacyMetadata mocks base method.
func (*MockMinimalApiState) GetProof ¶
func (m *MockMinimalApiState) GetProof(arg0 common.Address) ([][]byte, error)
GetProof mocks base method.
func (*MockMinimalApiState) GetRLPEncodedStateObject ¶
func (m *MockMinimalApiState) GetRLPEncodedStateObject(addr common.Address) ([]byte, error)
GetRLPEncodedStateObject mocks base method.
func (*MockMinimalApiState) GetStorageProof ¶
func (m *MockMinimalApiState) GetStorageProof(arg0 common.Address, arg1 common.Hash) ([][]byte, error)
GetStorageProof mocks base method.
func (*MockMinimalApiState) SetBalance ¶
func (m *MockMinimalApiState) SetBalance(addr common.Address, balance *big.Int)
SetBalance mocks base method.
func (*MockMinimalApiState) SetCode ¶
func (m *MockMinimalApiState) SetCode(arg0 common.Address, arg1 []byte)
SetCode mocks base method.
func (*MockMinimalApiState) SetNonce ¶
func (m *MockMinimalApiState) SetNonce(addr common.Address, nonce uint64)
SetNonce mocks base method.
func (*MockMinimalApiState) SetState ¶
func (m *MockMinimalApiState) SetState(arg0 common.Address, arg1, arg2 common.Hash)
SetState mocks base method.
func (*MockMinimalApiState) SetStorage ¶
SetStorage mocks base method.
func (*MockMinimalApiState) StorageTrie ¶
func (m *MockMinimalApiState) StorageTrie(addr common.Address) state.Trie
StorageTrie mocks base method.
type MockMinimalApiStateMockRecorder ¶
type MockMinimalApiStateMockRecorder struct {
// contains filtered or unexported fields
}
MockMinimalApiStateMockRecorder is the mock recorder for MockMinimalApiState.
func (*MockMinimalApiStateMockRecorder) Error ¶
func (mr *MockMinimalApiStateMockRecorder) Error() *gomock.Call
Error indicates an expected call of Error.
func (*MockMinimalApiStateMockRecorder) GetBalance ¶
func (mr *MockMinimalApiStateMockRecorder) GetBalance(addr interface{}) *gomock.Call
GetBalance indicates an expected call of GetBalance.
func (*MockMinimalApiStateMockRecorder) GetCode ¶
func (mr *MockMinimalApiStateMockRecorder) GetCode(addr interface{}) *gomock.Call
GetCode indicates an expected call of GetCode.
func (*MockMinimalApiStateMockRecorder) GetCodeHash ¶
func (mr *MockMinimalApiStateMockRecorder) GetCodeHash(arg0 interface{}) *gomock.Call
GetCodeHash indicates an expected call of GetCodeHash.
func (*MockMinimalApiStateMockRecorder) GetManagedParties ¶
func (mr *MockMinimalApiStateMockRecorder) GetManagedParties(addr interface{}) *gomock.Call
GetManagedParties indicates an expected call of GetManagedParties.
func (*MockMinimalApiStateMockRecorder) GetNonce ¶
func (mr *MockMinimalApiStateMockRecorder) GetNonce(addr interface{}) *gomock.Call
GetNonce indicates an expected call of GetNonce.
func (*MockMinimalApiStateMockRecorder) GetPrivacyMetadata ¶
func (mr *MockMinimalApiStateMockRecorder) GetPrivacyMetadata(addr interface{}) *gomock.Call
GetPrivacyMetadata indicates an expected call of GetPrivacyMetadata.
func (*MockMinimalApiStateMockRecorder) GetProof ¶
func (mr *MockMinimalApiStateMockRecorder) GetProof(arg0 interface{}) *gomock.Call
GetProof indicates an expected call of GetProof.
func (*MockMinimalApiStateMockRecorder) GetRLPEncodedStateObject ¶
func (mr *MockMinimalApiStateMockRecorder) GetRLPEncodedStateObject(addr interface{}) *gomock.Call
GetRLPEncodedStateObject indicates an expected call of GetRLPEncodedStateObject.
func (*MockMinimalApiStateMockRecorder) GetState ¶
func (mr *MockMinimalApiStateMockRecorder) GetState(a, b interface{}) *gomock.Call
GetState indicates an expected call of GetState.
func (*MockMinimalApiStateMockRecorder) GetStorageProof ¶
func (mr *MockMinimalApiStateMockRecorder) GetStorageProof(arg0, arg1 interface{}) *gomock.Call
GetStorageProof indicates an expected call of GetStorageProof.
func (*MockMinimalApiStateMockRecorder) SetBalance ¶
func (mr *MockMinimalApiStateMockRecorder) SetBalance(addr, balance interface{}) *gomock.Call
SetBalance indicates an expected call of SetBalance.
func (*MockMinimalApiStateMockRecorder) SetCode ¶
func (mr *MockMinimalApiStateMockRecorder) SetCode(arg0, arg1 interface{}) *gomock.Call
SetCode indicates an expected call of SetCode.
func (*MockMinimalApiStateMockRecorder) SetNonce ¶
func (mr *MockMinimalApiStateMockRecorder) SetNonce(addr, nonce interface{}) *gomock.Call
SetNonce indicates an expected call of SetNonce.
func (*MockMinimalApiStateMockRecorder) SetState ¶
func (mr *MockMinimalApiStateMockRecorder) SetState(arg0, arg1, arg2 interface{}) *gomock.Call
SetState indicates an expected call of SetState.
func (*MockMinimalApiStateMockRecorder) SetStorage ¶
func (mr *MockMinimalApiStateMockRecorder) SetStorage(addr, storage interface{}) *gomock.Call
SetStorage indicates an expected call of SetStorage.
func (*MockMinimalApiStateMockRecorder) StorageTrie ¶
func (mr *MockMinimalApiStateMockRecorder) StorageTrie(addr interface{}) *gomock.Call
StorageTrie indicates an expected call of StorageTrie.
type MockStateDB ¶
type MockStateDB struct {
// contains filtered or unexported fields
}
MockStateDB is a mock of StateDB interface.
func NewMockStateDB ¶
func NewMockStateDB(ctrl *gomock.Controller) *MockStateDB
NewMockStateDB creates a new mock instance.
func (*MockStateDB) AddBalance ¶
func (m *MockStateDB) AddBalance(arg0 common.Address, arg1 *big.Int)
AddBalance mocks base method.
func (*MockStateDB) AddLog ¶
func (m *MockStateDB) AddLog(arg0 *types.Log)
AddLog mocks base method.
func (*MockStateDB) AddPreimage ¶
func (m *MockStateDB) AddPreimage(arg0 common.Hash, arg1 []byte)
AddPreimage mocks base method.
func (*MockStateDB) AddRefund ¶
func (m *MockStateDB) AddRefund(arg0 uint64)
AddRefund mocks base method.
func (*MockStateDB) CreateAccount ¶
func (m *MockStateDB) CreateAccount(arg0 common.Address)
CreateAccount mocks base method.
func (*MockStateDB) EXPECT ¶
func (m *MockStateDB) EXPECT() *MockStateDBMockRecorder
EXPECT returns an object that allows the caller to indicate expected use.
func (*MockStateDB) Empty ¶
func (m *MockStateDB) Empty(arg0 common.Address) bool
Empty mocks base method.
func (*MockStateDB) Exist ¶
func (m *MockStateDB) Exist(arg0 common.Address) bool
Exist mocks base method.
func (*MockStateDB) ForEachStorage ¶
func (m *MockStateDB) ForEachStorage(arg0 common.Address, arg1 func(common.Hash, common.Hash) bool) error
ForEachStorage mocks base method.
func (*MockStateDB) GetBalance ¶
func (m *MockStateDB) GetBalance(addr common.Address) *big.Int
GetBalance mocks base method.
func (*MockStateDB) GetCode ¶
func (m *MockStateDB) GetCode(addr common.Address) []byte
GetCode mocks base method.
func (*MockStateDB) GetCodeHash ¶
func (m *MockStateDB) GetCodeHash(arg0 common.Address) common.Hash
GetCodeHash mocks base method.
func (*MockStateDB) GetCodeSize ¶
func (m *MockStateDB) GetCodeSize(arg0 common.Address) int
GetCodeSize mocks base method.
func (*MockStateDB) GetCommittedState ¶
GetCommittedState mocks base method.
func (*MockStateDB) GetManagedParties ¶
func (m *MockStateDB) GetManagedParties(addr common.Address) ([]string, error)
GetManagedParties mocks base method.
func (*MockStateDB) GetNonce ¶
func (m *MockStateDB) GetNonce(addr common.Address) uint64
GetNonce mocks base method.
func (*MockStateDB) GetPrivacyMetadata ¶
func (m *MockStateDB) GetPrivacyMetadata(addr common.Address) (*state.PrivacyMetadata, error)
GetPrivacyMetadata mocks base method.
func (*MockStateDB) GetProof ¶
func (m *MockStateDB) GetProof(arg0 common.Address) ([][]byte, error)
GetProof mocks base method.
func (*MockStateDB) GetRLPEncodedStateObject ¶
func (m *MockStateDB) GetRLPEncodedStateObject(addr common.Address) ([]byte, error)
GetRLPEncodedStateObject mocks base method.
func (*MockStateDB) GetRefund ¶
func (m *MockStateDB) GetRefund() uint64
GetRefund mocks base method.
func (*MockStateDB) GetStorageProof ¶
GetStorageProof mocks base method.
func (*MockStateDB) HasSuicided ¶
func (m *MockStateDB) HasSuicided(arg0 common.Address) bool
HasSuicided mocks base method.
func (*MockStateDB) RevertToSnapshot ¶
func (m *MockStateDB) RevertToSnapshot(arg0 int)
RevertToSnapshot mocks base method.
func (*MockStateDB) SetBalance ¶
func (m *MockStateDB) SetBalance(addr common.Address, balance *big.Int)
SetBalance mocks base method.
func (*MockStateDB) SetCode ¶
func (m *MockStateDB) SetCode(arg0 common.Address, arg1 []byte)
SetCode mocks base method.
func (*MockStateDB) SetManagedParties ¶
func (m *MockStateDB) SetManagedParties(addr common.Address, managedParties []string)
SetManagedParties mocks base method.
func (*MockStateDB) SetNonce ¶
func (m *MockStateDB) SetNonce(addr common.Address, nonce uint64)
SetNonce mocks base method.
func (*MockStateDB) SetPrivacyMetadata ¶
func (m *MockStateDB) SetPrivacyMetadata(addr common.Address, pm *state.PrivacyMetadata)
SetPrivacyMetadata mocks base method.
func (*MockStateDB) SetState ¶
func (m *MockStateDB) SetState(arg0 common.Address, arg1, arg2 common.Hash)
SetState mocks base method.
func (*MockStateDB) SetStorage ¶
SetStorage mocks base method.
func (*MockStateDB) StorageTrie ¶
func (m *MockStateDB) StorageTrie(addr common.Address) state.Trie
StorageTrie mocks base method.
func (*MockStateDB) SubBalance ¶
func (m *MockStateDB) SubBalance(arg0 common.Address, arg1 *big.Int)
SubBalance mocks base method.
func (*MockStateDB) SubRefund ¶
func (m *MockStateDB) SubRefund(arg0 uint64)
SubRefund mocks base method.
type MockStateDBMockRecorder ¶
type MockStateDBMockRecorder struct {
// contains filtered or unexported fields
}
MockStateDBMockRecorder is the mock recorder for MockStateDB.
func (*MockStateDBMockRecorder) AddBalance ¶
func (mr *MockStateDBMockRecorder) AddBalance(arg0, arg1 interface{}) *gomock.Call
AddBalance indicates an expected call of AddBalance.
func (*MockStateDBMockRecorder) AddLog ¶
func (mr *MockStateDBMockRecorder) AddLog(arg0 interface{}) *gomock.Call
AddLog indicates an expected call of AddLog.
func (*MockStateDBMockRecorder) AddPreimage ¶
func (mr *MockStateDBMockRecorder) AddPreimage(arg0, arg1 interface{}) *gomock.Call
AddPreimage indicates an expected call of AddPreimage.
func (*MockStateDBMockRecorder) AddRefund ¶
func (mr *MockStateDBMockRecorder) AddRefund(arg0 interface{}) *gomock.Call
AddRefund indicates an expected call of AddRefund.
func (*MockStateDBMockRecorder) CreateAccount ¶
func (mr *MockStateDBMockRecorder) CreateAccount(arg0 interface{}) *gomock.Call
CreateAccount indicates an expected call of CreateAccount.
func (*MockStateDBMockRecorder) Empty ¶
func (mr *MockStateDBMockRecorder) Empty(arg0 interface{}) *gomock.Call
Empty indicates an expected call of Empty.
func (*MockStateDBMockRecorder) Error ¶
func (mr *MockStateDBMockRecorder) Error() *gomock.Call
Error indicates an expected call of Error.
func (*MockStateDBMockRecorder) Exist ¶
func (mr *MockStateDBMockRecorder) Exist(arg0 interface{}) *gomock.Call
Exist indicates an expected call of Exist.
func (*MockStateDBMockRecorder) ForEachStorage ¶
func (mr *MockStateDBMockRecorder) ForEachStorage(arg0, arg1 interface{}) *gomock.Call
ForEachStorage indicates an expected call of ForEachStorage.
func (*MockStateDBMockRecorder) GetBalance ¶
func (mr *MockStateDBMockRecorder) GetBalance(addr interface{}) *gomock.Call
GetBalance indicates an expected call of GetBalance.
func (*MockStateDBMockRecorder) GetCode ¶
func (mr *MockStateDBMockRecorder) GetCode(addr interface{}) *gomock.Call
GetCode indicates an expected call of GetCode.
func (*MockStateDBMockRecorder) GetCodeHash ¶
func (mr *MockStateDBMockRecorder) GetCodeHash(arg0 interface{}) *gomock.Call
GetCodeHash indicates an expected call of GetCodeHash.
func (*MockStateDBMockRecorder) GetCodeSize ¶
func (mr *MockStateDBMockRecorder) GetCodeSize(arg0 interface{}) *gomock.Call
GetCodeSize indicates an expected call of GetCodeSize.
func (*MockStateDBMockRecorder) GetCommittedState ¶
func (mr *MockStateDBMockRecorder) GetCommittedState(arg0, arg1 interface{}) *gomock.Call
GetCommittedState indicates an expected call of GetCommittedState.
func (*MockStateDBMockRecorder) GetManagedParties ¶
func (mr *MockStateDBMockRecorder) GetManagedParties(addr interface{}) *gomock.Call
GetManagedParties indicates an expected call of GetManagedParties.
func (*MockStateDBMockRecorder) GetNonce ¶
func (mr *MockStateDBMockRecorder) GetNonce(addr interface{}) *gomock.Call
GetNonce indicates an expected call of GetNonce.
func (*MockStateDBMockRecorder) GetPrivacyMetadata ¶
func (mr *MockStateDBMockRecorder) GetPrivacyMetadata(addr interface{}) *gomock.Call
GetPrivacyMetadata indicates an expected call of GetPrivacyMetadata.
func (*MockStateDBMockRecorder) GetProof ¶
func (mr *MockStateDBMockRecorder) GetProof(arg0 interface{}) *gomock.Call
GetProof indicates an expected call of GetProof.
func (*MockStateDBMockRecorder) GetRLPEncodedStateObject ¶
func (mr *MockStateDBMockRecorder) GetRLPEncodedStateObject(addr interface{}) *gomock.Call
GetRLPEncodedStateObject indicates an expected call of GetRLPEncodedStateObject.
func (*MockStateDBMockRecorder) GetRefund ¶
func (mr *MockStateDBMockRecorder) GetRefund() *gomock.Call
GetRefund indicates an expected call of GetRefund.
func (*MockStateDBMockRecorder) GetState ¶
func (mr *MockStateDBMockRecorder) GetState(a, b interface{}) *gomock.Call
GetState indicates an expected call of GetState.
func (*MockStateDBMockRecorder) GetStorageProof ¶
func (mr *MockStateDBMockRecorder) GetStorageProof(arg0, arg1 interface{}) *gomock.Call
GetStorageProof indicates an expected call of GetStorageProof.
func (*MockStateDBMockRecorder) HasSuicided ¶
func (mr *MockStateDBMockRecorder) HasSuicided(arg0 interface{}) *gomock.Call
HasSuicided indicates an expected call of HasSuicided.
func (*MockStateDBMockRecorder) RevertToSnapshot ¶
func (mr *MockStateDBMockRecorder) RevertToSnapshot(arg0 interface{}) *gomock.Call
RevertToSnapshot indicates an expected call of RevertToSnapshot.
func (*MockStateDBMockRecorder) SetBalance ¶
func (mr *MockStateDBMockRecorder) SetBalance(addr, balance interface{}) *gomock.Call
SetBalance indicates an expected call of SetBalance.
func (*MockStateDBMockRecorder) SetCode ¶
func (mr *MockStateDBMockRecorder) SetCode(arg0, arg1 interface{}) *gomock.Call
SetCode indicates an expected call of SetCode.
func (*MockStateDBMockRecorder) SetManagedParties ¶
func (mr *MockStateDBMockRecorder) SetManagedParties(addr, managedParties interface{}) *gomock.Call
SetManagedParties indicates an expected call of SetManagedParties.
func (*MockStateDBMockRecorder) SetNonce ¶
func (mr *MockStateDBMockRecorder) SetNonce(addr, nonce interface{}) *gomock.Call
SetNonce indicates an expected call of SetNonce.
func (*MockStateDBMockRecorder) SetPrivacyMetadata ¶
func (mr *MockStateDBMockRecorder) SetPrivacyMetadata(addr, pm interface{}) *gomock.Call
SetPrivacyMetadata indicates an expected call of SetPrivacyMetadata.
func (*MockStateDBMockRecorder) SetState ¶
func (mr *MockStateDBMockRecorder) SetState(arg0, arg1, arg2 interface{}) *gomock.Call
SetState indicates an expected call of SetState.
func (*MockStateDBMockRecorder) SetStorage ¶
func (mr *MockStateDBMockRecorder) SetStorage(addr, storage interface{}) *gomock.Call
SetStorage indicates an expected call of SetStorage.
func (*MockStateDBMockRecorder) Snapshot ¶
func (mr *MockStateDBMockRecorder) Snapshot() *gomock.Call
Snapshot indicates an expected call of Snapshot.
func (*MockStateDBMockRecorder) StorageTrie ¶
func (mr *MockStateDBMockRecorder) StorageTrie(addr interface{}) *gomock.Call
StorageTrie indicates an expected call of StorageTrie.
func (*MockStateDBMockRecorder) SubBalance ¶
func (mr *MockStateDBMockRecorder) SubBalance(arg0, arg1 interface{}) *gomock.Call
SubBalance indicates an expected call of SubBalance.
func (*MockStateDBMockRecorder) SubRefund ¶
func (mr *MockStateDBMockRecorder) SubRefund(arg0 interface{}) *gomock.Call
SubRefund indicates an expected call of SubRefund.
func (*MockStateDBMockRecorder) Suicide ¶
func (mr *MockStateDBMockRecorder) Suicide(arg0 interface{}) *gomock.Call
Suicide indicates an expected call of Suicide.
type OpCode ¶
type OpCode byte
OpCode is an EVM opcode
0x0 range - arithmetic ops.
0x10 range - comparison ops.
const ( ADDRESS OpCode = 0x30 + iota BALANCE ORIGIN CALLER CALLVALUE CALLDATALOAD CALLDATASIZE CALLDATACOPY CODESIZE CODECOPY GASPRICE EXTCODESIZE EXTCODECOPY RETURNDATASIZE RETURNDATACOPY EXTCODEHASH )
0x30 range - closure state.
const ( BLOCKHASH OpCode = 0x40 + iota COINBASE TIMESTAMP NUMBER DIFFICULTY GASLIMIT CHAINID = 0x46 SELFBALANCE = 0x47 )
0x40 range - block operations.
const ( POP OpCode = 0x50 + iota MLOAD MSTORE MSTORE8 SLOAD SSTORE JUMP JUMPI PC MSIZE GAS JUMPDEST )
0x50 range - 'storage' and execution.
const ( PUSH1 OpCode = 0x60 + iota PUSH2 PUSH3 PUSH4 PUSH5 PUSH6 PUSH7 PUSH8 PUSH9 PUSH10 PUSH11 PUSH12 PUSH13 PUSH14 PUSH15 PUSH16 PUSH17 PUSH18 PUSH19 PUSH20 PUSH21 PUSH22 PUSH23 PUSH24 PUSH25 PUSH26 PUSH27 PUSH28 PUSH29 PUSH30 PUSH31 PUSH32 DUP1 DUP2 DUP3 DUP4 DUP5 DUP6 DUP7 DUP8 DUP9 DUP10 DUP11 DUP12 DUP13 DUP14 DUP15 DUP16 SWAP1 SWAP2 SWAP3 SWAP4 SWAP5 SWAP6 SWAP7 SWAP8 SWAP9 SWAP10 SWAP11 SWAP12 SWAP13 SWAP14 SWAP15 SWAP16 )
0x60 range.
const ( CREATE OpCode = 0xf0 + iota CALL CALLCODE RETURN DELEGATECALL CREATE2 STATICCALL = 0xfa REVERT = 0xfd SELFDESTRUCT = 0xff )
0xf0 range - closures.
func StringToOp ¶
StringToOp finds the opcode whose name is stored in `str`.
func (OpCode) IsStaticJump ¶
IsStaticJump specifies if an opcode is JUMP.
type PrecompiledContract ¶
type PrecompiledContract interface { RequiredGas(input []byte) uint64 // RequiredPrice calculates the contract gas use Run(input []byte) ([]byte, error) // Run runs the precompiled contract }
PrecompiledContract is the basic interface for native Go contracts. The implementation requires a deterministic gas count based on the input size of the Run method of the contract.
type PrivateState ¶
type PrivateState StateDB
type PublicState ¶
type PublicState StateDB
type Stack ¶
type Stack struct {
// contains filtered or unexported fields
}
Stack is an object for basic stack operations. Items popped to the stack are expected to be changed and modified. stack does not take care of adding newly initialised objects.
type StateDB ¶
type StateDB interface { MinimalApiState AccountExtraDataStateSetter CreateAccount(common.Address) SubBalance(common.Address, *big.Int) AddBalance(common.Address, *big.Int) //GetCodeHash(common.Address) common.Hash //GetCode(common.Address) []byte //SetCode(common.Address, []byte) GetCodeSize(common.Address) int AddRefund(uint64) SubRefund(uint64) GetRefund() uint64 GetCommittedState(common.Address, common.Hash) common.Hash Suicide(common.Address) bool HasSuicided(common.Address) bool // Exist reports whether the given account exists in state. // Notably this should also return true for suicided accounts. Exist(common.Address) bool // Empty returns whether the given account is empty. Empty // is defined according to EIP161 (balance = nonce = code = 0). Empty(common.Address) bool RevertToSnapshot(int) Snapshot() int AddLog(*types.Log) AddPreimage(common.Hash, []byte) ForEachStorage(common.Address, func(common.Hash, common.Hash) bool) error }
StateDB is an EVM database for full state querying.
type StructLog ¶
type StructLog struct { Pc uint64 `json:"pc"` Op OpCode `json:"op"` Gas uint64 `json:"gas"` GasCost uint64 `json:"gasCost"` Memory []byte `json:"memory"` MemorySize int `json:"memSize"` Stack []*big.Int `json:"stack"` Storage map[common.Hash]common.Hash `json:"-"` Depth int `json:"depth"` RefundCounter uint64 `json:"refund"` Err error `json:"-"` }
StructLog is emitted to the EVM each cycle and lists information about the current internal state prior to the execution of the statement.
func (*StructLog) ErrorString ¶
ErrorString formats the log's error as a string.
func (StructLog) MarshalJSON ¶
MarshalJSON marshals as JSON.
func (*StructLog) UnmarshalJSON ¶
UnmarshalJSON unmarshals from JSON.
type StructLogger ¶
type StructLogger struct {
// contains filtered or unexported fields
}
StructLogger is an EVM state logger and implements Tracer.
StructLogger can capture state based on the given Log configuration and also keeps a track record of modified storage which is used in reporting snapshots of the contract their storage.
func NewStructLogger ¶
func NewStructLogger(cfg *LogConfig) *StructLogger
NewStructLogger returns a new logger
func (*StructLogger) CaptureEnd ¶
CaptureEnd is called after the call finishes to finalize the tracing.
func (*StructLogger) CaptureFault ¶
func (l *StructLogger) CaptureFault(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, contract *Contract, depth int, err error) error
CaptureFault implements the Tracer interface to trace an execution fault while running an opcode.
func (*StructLogger) CaptureStart ¶
func (l *StructLogger) CaptureStart(from common.Address, to common.Address, create bool, input []byte, gas uint64, value *big.Int) error
CaptureStart implements the Tracer interface to initialize the tracing operation.
func (*StructLogger) CaptureState ¶
func (l *StructLogger) CaptureState(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, contract *Contract, depth int, err error) error
CaptureState logs a new structured log message and pushes it out to the environment
CaptureState also tracks SSTORE ops to track dirty values.
func (*StructLogger) Error ¶
func (l *StructLogger) Error() error
Error returns the VM error captured by the trace.
func (*StructLogger) Output ¶
func (l *StructLogger) Output() []byte
Output returns the VM return value captured by the trace.
func (*StructLogger) StructLogs ¶
func (l *StructLogger) StructLogs() []StructLog
StructLogs returns the captured log entries.
type Tracer ¶
type Tracer interface { CaptureStart(from common.Address, to common.Address, call bool, input []byte, gas uint64, value *big.Int) error CaptureState(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, contract *Contract, depth int, err error) error CaptureFault(env *EVM, pc uint64, op OpCode, gas, cost uint64, memory *Memory, stack *Stack, contract *Contract, depth int, err error) error CaptureEnd(output []byte, gasUsed uint64, t time.Duration, err error) error }
Tracer is used to collect execution traces from an EVM transaction execution. CaptureState is called for each step of the VM with the current VM state. Note that reference types are actual VM data structures; make copies if you need to retain them beyond the current call.
Source Files ¶
- analysis.go
- common.go
- contract.go
- contracts.go
- doc.go
- eips.go
- errors.go
- evm.go
- gas.go
- gas_table.go
- gen_structlog.go
- instructions.go
- int_pool_verifier_empty.go
- interface.go
- interpreter.go
- intpool.go
- jump_table.go
- logger.go
- logger_json.go
- memory.go
- memory_table.go
- mock_interface.go
- opcodes.go
- stack.go
- stack_table.go