Documentation
¶
Overview ¶
Package vm implements the Ethereum Virtual Machine.
Index ¶
- Constants
- Variables
- func Disasm(code []byte) []string
- func Disassemble(script []byte) (asm []string)
- func IsStackErr(err error) bool
- func PrecompiledContracts() map[string]*PrecompiledAccount
- func StdErrFormat(logs []StructLog)
- func Transfer(from, to Account, amount *big.Int) error
- func UseGas(gas, amount *big.Int) bool
- type Account
- type Address
- type Context
- func (c *Context) Address() common.Address
- func (c *Context) GetByte(n uint64) byte
- func (c *Context) GetOp(n uint64) OpCode
- func (c *Context) Return(ret []byte) []byte
- func (c *Context) ReturnGas(gas, price *big.Int)
- func (self *Context) SetCallCode(addr *common.Address, code []byte)
- func (self *Context) SetCode(code []byte)
- func (c *Context) UseGas(gas *big.Int) (ok bool)
- type ContextRef
- type Environment
- type Memory
- type OpCode
- type PrecompiledAccount
- type StackError
- type StructLog
- type Type
- type VirtualMachine
- type Vm
Constants ¶
const ( StdVmTy Type = iota JitVmTy MaxVmTy LogTyPretty byte = 0x1 LogTyDiff byte = 0x2 )
Variables ¶
var ( Pow256 = common.BigPow(2, 256) U256 = common.U256 S256 = common.S256 Zero = common.Big0 One = common.Big1 )
var ( GasQuickStep = big.NewInt(2) GasFastestStep = big.NewInt(3) GasFastStep = big.NewInt(5) GasMidStep = big.NewInt(8) GasSlowStep = big.NewInt(10) GasExtStep = big.NewInt(20) GasReturn = big.NewInt(0) GasStop = big.NewInt(0) GasContractByte = big.NewInt(200) )
var Debug bool
Global Debug flag indicating Debug VM (full logging)
var DepthError = fmt.Errorf("Max call depth exceeded (%d)", params.CallCreateDepth)
var OutOfGasError = errors.New("Out of gas")
var Precompiled = PrecompiledContracts()
Functions ¶
func Disassemble ¶ added in v0.9.39
func IsStackErr ¶ added in v0.9.39
func PrecompiledContracts ¶ added in v0.9.39
func PrecompiledContracts() map[string]*PrecompiledAccount
XXX Could set directly. Testing requires resetting and setting of pre compiled contracts.
func StdErrFormat ¶ added in v0.9.39
func StdErrFormat(logs []StructLog)
Types ¶
type Context ¶
type Context struct { Code []byte CodeAddr *common.Address Gas, UsedGas, Price *big.Int Args []byte // contains filtered or unexported fields }
func NewContext ¶ added in v0.9.39
func NewContext(caller ContextRef, object ContextRef, value, gas, price *big.Int) *Context
Create a new context for the given data items.
func (*Context) SetCallCode ¶ added in v0.9.39
type ContextRef ¶ added in v0.9.39
type Environment ¶ added in v0.9.39
type Environment interface { State() *state.StateDB Origin() common.Address BlockNumber() *big.Int GetHash(n uint64) common.Hash Coinbase() common.Address Time() uint64 Difficulty() *big.Int GasLimit() *big.Int Transfer(from, to Account, amount *big.Int) error AddLog(*state.Log) AddStructLog(StructLog) StructLogs() []StructLog VmType() Type Depth() int SetDepth(i int) Call(me ContextRef, addr common.Address, data []byte, gas, price, value *big.Int) ([]byte, error) CallCode(me ContextRef, addr common.Address, data []byte, gas, price, value *big.Int) ([]byte, error) Create(me ContextRef, data []byte, gas, price, value *big.Int) ([]byte, error, ContextRef) }
Environment is is required by the virtual machine to get information from it's own isolated environment. For an example see `core.VMEnv`
type OpCode ¶
type OpCode byte
const ( // 0x0 range - arithmetic ops STOP OpCode = iota ADD MUL SUB DIV SDIV MOD SMOD ADDMOD MULMOD EXP SIGNEXTEND )
Op codes
const ( // 0x60 range 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 )
func StringToOp ¶
type PrecompiledAccount ¶ added in v0.9.39
type PrecompiledAccount struct { Gas func(l int) *big.Int // contains filtered or unexported fields }
func (PrecompiledAccount) Call ¶ added in v0.9.39
func (self PrecompiledAccount) Call(in []byte) []byte
type StackError ¶ added in v0.9.39
type StackError struct {
// contains filtered or unexported fields
}
func StackErr ¶ added in v0.9.39
func StackErr(req, has int) StackError
func (StackError) Error ¶ added in v0.9.39
func (self StackError) Error() string
type StructLog ¶
type StructLog struct { Pc uint64 Op OpCode Gas *big.Int GasCost *big.Int Memory []byte Stack []*big.Int Storage map[common.Hash][]byte Err error }
StructLog is emited to the Environment each cycle and lists information about the curent internal state prior to the execution of the statement.
type VirtualMachine ¶ added in v0.9.39
type VirtualMachine interface { Env() Environment Run(context *Context, data []byte) ([]byte, error) }
func NewJitVm ¶ added in v0.9.39
func NewJitVm(env Environment) VirtualMachine
func NewVm ¶ added in v0.9.39
func NewVm(env Environment) VirtualMachine
type Vm ¶ added in v0.9.39
type Vm struct { BreakPoints []int64 Stepping bool Fn string Recoverable bool // Will be called before the vm returns After func(*Context, error) // contains filtered or unexported fields }
Vm implements VirtualMachine
func (*Vm) Env ¶ added in v0.9.39
func (self *Vm) Env() Environment
Environment returns the current workable state of the VM
func (*Vm) Run ¶ added in v0.9.39
Run loops and evaluates the contract's code with the given input data
func (*Vm) RunPrecompiled ¶ added in v0.9.39
func (self *Vm) RunPrecompiled(p *PrecompiledAccount, input []byte, context *Context) (ret []byte, err error)
RunPrecompile runs and evaluate the output of a precompiled contract defined in contracts.go