ethereumjs/ethereumjs-vm-2-API文档

时间:2023-11-28 13:32:38

https://github.com/ethereumjs/ethereumjs-vm/blob/master/docs/index.md

vm.runBlockchain

Processes blocks and adds them to the blockchain

处理区块并将其添加到区块链中

Parameters输入参数

  • blockchain Blockchain A blockchain that to process 一个处理的区块链
  • cb Function the callback function 回调函数

VM

VM Class, new VM(opts) creates a new VM object

VM类,VM(opts)将创建一个VM对象,运行起来实现的感觉与ganache相似

Parameters输入参数

  • opts Object
    • opts.stateManager StateManager a StateManager instance to use as the state store (Beta API) 用于状态存储的StateManager实例(还在实验阶段)其实这个就是区块上的state merkle-patricia树,用于存储区块上的所有账户的信息
    • opts.state Trie a merkle-patricia-tree instance for the state tree (ignored if stateManager is passed) 用于状态树的一个merkle-patricia树(如果上面的stateManager已经传递,这个就可以忽略)
    • opts.blockchain Blockchain a blockchain object for storing/retrieving blocks (ignored if stateManager is passed) 为了存储/检索区块的区块链对象(如果上面的stateManager已经传递,这个就可以忽略)
    • opts.chain (String | Number) the chain the VM operates on [default: 'mainnet']  VM操作在那个链上(默认是mainnet链)
    • opts.hardfork String hardfork rules to be used [default: 'byzantium', supported: 'byzantium',  'constantinople' (will throw on unsupported)]    使用的硬分支规则(默认是byzantium',还支持'byzantium',  'constantinople',如果输入的是不支持的将抛出错误)  
    • opts.activatePrecompiles Boolean create entries in the state tree for the precompiled contracts 为了预编译合约在状态树上创建条目,其实就是在state merkle-patricia树上手动添加一些账户的信息,就跟ganache一样,一开始就有可用的账户
    • opts.allowUnlimitedContractSize Boolean allows unlimited contract sizes while debugging. By setting this to true, the check for contract size limit of 24KB (see EIP-170) is bypassed. (default: false; ONLY set to true during debugging) 当调试时,允许不限制的合约大小。通过将其设置为true,来忽视合约大小设置为24KB的检查(细节看本博客ethereum/EIPs-170 Contract code size limit)。(默认为false,只在调试时设置为true)
    • opts.emitFreeLogs Boolean Changes the behavior of the LOG opcode, the gas cost of the opcode becomes zero and calling it using STATICCALL won't throw. (default: false; ONLY set to true during debugging) 改变日志操作吗的行为,gas开销的操作码变为0,使用STATICCALL操作码调用它将抛出错误(默认为false,只有在调试时设置为true)

vm.runBlock

Processes the block running all of the transactions it contains and updating the miner's account

处理区块,运行其中的所有交易并更新矿工账户

Parameters输入参数

  • opts
    • opts.block Block the Block to process 处理的区块
    • opts.generate Boolean [gen=false] whether to generate the stateRoot, if false runBlock will check the stateRoot of the block against the Trie 是否生成stateRoot,如果设置为false,runBlock将会靠着前缀树来查看区块的stateRoot
  • cb runBlock~callback callback 回调函数

runBlock~callback

Callback for runBlock method

runBlock的回调

Type: Function

Parameters输入参数

  • error Error an error that may have happened or null  发生的错误或null
  • results Object
    • results.receipts Array the receipts from the transactions in the block 区块中来自交易的receipt
    • results.results Array 返回结果

vm.runTx

Process a transaction. Run the vm. Transfers eth. Checks balances.

处理交易。运行虚拟机。交易eth。查看余额。

Parameters输入参数

  • opts
    • opts.tx Transaction a Transaction to run 运行的交易
    • opts.skipNonce Boolean skips the nonce check  跳过nonce检查
    • opts.skipBalance Boolean skips the balance check  跳过余额检查
    • opts.block Block the block to which the tx belongs, if no block is given a default one is created  交易属于的区块,如果没有,则创建一个默认块
  • cb runTx~callback the callback 回调函数

runTx~callback

Callback for runTx method

runTx方法的回调

Type: Function

Parameters输入参数

  • error Error an error that may have happened or null  发生的错误或null
  • results Object
    • results.amountSpent BN the amount of ether used by this transaction as a bignum  被这个交易使用的ether的数量,BN格式
    • results.gasUsed BN the amount of gas as a bignum used by the transaction  被这个交易使用的gas,BN格式
    • results.gasRefund BN the amount of gas as a bignum that was refunded during the transaction (i.e. gasUsed = totalGasConsumed - gasRefund)  在交易中被退还的gas,BN格式(使用的gas = 总使用的gas - 退还的gas)
  • vm VM contains the results from running the code, if any, as described in vm.runCode(params, cb)  虚拟机,如果存在,包含通过运行代码得到的结果,就像vm.runCode(params, cb)所说

vm.runCode

Runs EVM code

运行以太坊虚拟机代码

Parameters输入参数

  • opts Object
    • opts.account Account the Account that the executing code belongs to. If omitted an empty account will be used 执行的代码属于的账户。如果省略则使用空账户
    • opts.address Buffer the address of the account that is executing this code. The address should be a Buffer of bytes. Defaults to 0 执行这个代码的账户的地址。地址应该是字节的buffer格式。默认为0
    • opts.block Block the Block the tx belongs to. If omitted a blank block will be used 这个交易属于的区块。如果省略则使用一个黑块
    • opts.caller Buffer the address that ran this code. The address should be a Buffer of 20bits. Defaults to 0 运行这个代码的地址。这个地址应该为20bits的buffer格式,默认为0
    • opts.code Buffer the EVM code to run given as a Buffer 以buffer格式给出的用来运行的以太坊虚拟机的代码
    • opts.data Buffer the input data 输入的数据
    • opts.gasLimit Buffer the gas limit for the code 这个代码使用的gas的限制
    • opts.origin Buffer the address where the call originated from. The address should be a Buffer of 20bits. Defaults to 0 这个调用起源的地址。这个地址应该为20bits的buffer格式,默认为0
    • opts.value Buffer the value in ether that is being sent to opt.address. Defaults to 0 被送给opt.address的ether。默认为0
  • cb runCode~callback callback 回调函数

runCode~callback

Callback for runCode method

runCode方法的回调

Type: Function

Parameters输入参数

  • error Error an error that may have happened or null  发生的错误或null
  • results Object
    • results.gas BN the amount of gas left 剩下的gas数量
    • results.gasUsed BN the amount of gas as a bignum the code used to run  以bignum格式给出的这个代码用来运行的gas数量
    • results.gasRefund BN a bignum containing the amount of gas to refund from deleting storage values从删除的存储值中得到包含退还的gas的数量的大数
    • results.selfdestruct Object an Object with keys for accounts that have selfdestructed and values for balance transfer recipient accounts 包含自我毁灭的账户密钥和转移接收账户余额的值的对象
    • results.logs Array an Array of logs that the contract emitted 合约发出的日志数组
    • results.exception Number 0 if the contract encountered an exception, 1 otherwise 如果合约遇到了异常则为0,否则为1
    • results.exceptionError String a String describing the exception if there was one 如果有异常则用来描述异常的字符串
    • results.return Buffer a Buffer containing the value that was returned by the contract 包含被合约返回的值的buffer

Event: beforeBlock

The beforeBlock event  beforeBlock事件

Type: Object

Properties属性

  • block Block emits the block that is about to be processed 发出关于将要被处理的区块

Event: afterBlock

The afterBlock event afterBlock事件

Type: Object

Properties属性

  • result Object emits the results of processing a block 发出处理的区块的结果

Event: beforeTx

The beforeTx event

Type: Object

Properties

  • tx Transaction emits the Transaction that is about to be processed 发出将要被处理的交易

Event: afterTx

The afterTx event

Type: Object

Properties

  • result Object result of the transaction 交易的结果

Event: step

The step event for trace output追踪输出的step事件

Type: Object

Properties

  • pc Number representing the program counter  代表项目的计数
  • opcode String the next opcode to be ran  下一个运行的操作码
  • gasLeft BN amount of gasLeft  剩下的gas数量
  • stack Array an Array of Buffers containing the stack  包含堆栈的Buffers数组
  • account Account the Account which owns the code running  拥有运行代码的账户
  • address Buffer the address of the account  账户的地址
  • depth Number the current number of calls deep the contract is   合约所在的目前的调用深度数
  • memory Buffer the memory of the VM as a buffer 虚拟机的内存
  • stateManager StateManager a StateManager instance (Beta API)  一个StateManager实例