• ethereumjs/ethereumjs-vm-2-API文档


    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实例
  • 相关阅读:
    保持页面上滚动条原来位置
    ASP.NET页面刷新的实现方法
    绝对定位下的控件动态添加操作
    实现页面打开后滚动到最底端的效果
    获得页面下所有的控件
    获得sql列名
    PropertyUtils.getProperty和PropertyUtils.setProperty的用法详解
    Javascript 第三章
    Javascript 第五章
    Javascript 第六章
  • 原文地址:https://www.cnblogs.com/wanghui-garcia/p/10082906.html
Copyright © 2020-2023  润新知