https://github.com/ethereumjs/ethereumjs-vm/blob/master/docs/stateManager.md
StateManager
要与本博客的ethereumjs/ethereumjs-account-1-简介和API结合学习,然后你就能够发现StateManager其实就是得到账户中的值。账户 = 账户地址address + 账户状态(有nonce,balance,stateRoot,codeHash)。下面的方法得到或处理的就是账户中对应的这些数据信息
Interface for getting and setting data from an underlying state trie
从下面的状态前缀树得到和设置数据的接口
getAccount
Gets the ethereumjs-account
associated with address
. Returns an empty account if the account does not exist.
得到ethereumjs-account
关联的地址。如果账户不存在则返回空账户
Parameters参数
address
Buffer Address of theaccount
to get 要得到的账户的地址cb
getAccount~callback 回调函数
getAccount~callback
Callback for getAccount
method
Type: Function
Parameters
error
Error an error that may have happened ornull 出现的错误或者null
account
Account Anethereumjs-account
instance corresponding to the providedaddress 与提供的地址关联的
ethereumjs-account
实例
putAccount
Saves an ethereumjs-account
into state under the provided address
将 ethereumjs-account
保存在提供的地址下的状态中
Parameters
address
Buffer Address under which to storeaccount 在该地址下存储账户
account
Account Theethereumjs-account
to store 存储的ethereumjs-account
账户cb
Function Callback function 回调函数
putContractCode
Adds value
to the state trie as code, and sets codeHash
on the account corresponding to address
to reference this.
把值作为代码存储到状态前缀树中,并设置关联地址的账户的codeHash
来引用它
Parameters
address
Buffer Address of theaccount
to add thecode
for 为了该账户地址添加代码value
Buffer The value of thecode 代码的值
cb
Function Callback function 回调函数
getContractCode
Gets the code corresponding to the provided address
得到与提供的地址相关联的代码
Parameters参数
address
Buffer Address to get thecode
for 为了该地址取得代码cb
getContractCode~callback 回调函数
getContractCode~callback
Callback for getContractCode
method
getContractCode
方法的回调函数
Type: Function
Parameters
error
Error an error that may have happened ornull
出现的错误或者null
code
Buffer The code corresponding to the provided address. Returns an emptyBuffer
if the account has no associated code. 与提供的代码相关联的代码。如果该账户没有相关联的代码就返回空Buffer
getContractStorage
Gets the storage value associated with the provided address
and key
得到与提供的地址和key相关联的存储值
Parameters
address
Buffer Address of the account to get the storage for 为了该账户地址取得存储值key
Buffer Key in the account's storage to get the value for 得到值需要的账户存储中的keycb
getContractCode~callback
getContractStorage~callback
Callback for getContractStorage
method
getContractStorage
方法的回调
Type: Function
Parameters
error
Error an error that may have happened ornull
出现的错误或者null
storageValue
Buffer The storage value for the account corresponding to the provided address at the provided key. If this does not exists an emptyBuffer
is returned 与提供的地址相关联的账户在提供的key处得到的存储值。如果不存在则返回空Buffer
putContractStorage
Adds value to the state trie for the account
corresponding to address
at the provided key
为了与地址相关联的账户在提供的key上给状态树添加值
Parameters
address
Buffer Address to set a storage value for 为了该地址设置值key
Buffer Key to set the value at 将值设置在该key上value
Buffer Value to set atkey
for account corresponding toaddress 为了与地址相关联的账户在key上设置的值
cb
Function Callback function 回调
clearContractStorage
Clears all storage entries for the account corresponding to address
为了与地址相关联的账户清理所有存储条目
Parameters
checkpoint检查点
Checkpoints the current state of the StateManager instance. State changes that follow can then be committed by calling commit
or reverted
by calling rollback.
检查点是StateManager实例的当前状态。随后的状态更改可以通过调用commit提交,也可以通过调用rollback返回
Parameters
cb
Function Callback function 回调函数
commit提交
Commits the current change-set to the instance since the last call to checkpoint.
提交目前的状态-设置为从上次调用检查点以来的实例
Parameters
cb
Function Callback function回调
revert
Reverts the current change-set to the instance since the last call to checkpoint.
恢复当前的变化-设置为从上次调用检查点以来的实例
Parameters
cb
Function Callback function
getStateRoot
Gets the state-root of the Merkle-Patricia trie representation of the state of this StateManager. Will error if there are uncommitted checkpoints on the instance.
得到StateManager状态的Merkle-Patricia前缀树表示的状态根。如果在实例中有未提交的检查点将出错
Parameters
getStateRoot~callback
Callback for getStateRoot
method
getStateRoot
方法的回调
Type: Function
Parameters
error
Error an error that may have happened ornull
. Will be an error if the un-committed checkpoints on the instance. 出现的错误或null。如果在示例中有没提交的检查点将会变成一个错误stateRoot
Buffer The state-root of theStateManager
StateManager的状态根
setStateRoot
Sets the state of the instance to that represented by the provided stateRoot
. Will error if there are uncommitted checkpoints on the instance or if the state root does not exist in the state trie.
设置通过提供的stateRoot
表示的实例的状态。如果在实例中有未提交的检查点或在状态前缀树中状态根不存在将出错
Parameters
stateRoot
Buffer The state-root to reset the instance to 重置的实例的状态根cb
Function Callback function 回调函数
generateCanonicalGenesis
Generates a canonical genesis state on the instance based on the configured chain parameters. Will error if there are uncommitted checkpoints on the instance.
基于在配置链参数在实例上生成规范生成状态。如果在实例上有未提交的检查点则出错
Parameters
cb
Function Callback function 回调函数
accountIsEmpty
Checks if the account
corresponding to address
is empty as defined in EIP-161 (https://github.com/ethereum/EIPs/blob/master/EIPS/eip-161.md)
查看与地址相关联的账户是否为空,就像 EIP-161中定义的一样。可看本博客(ethereum/EIPs-161 State trie clearing)
Parameters
address
Buffer Address to check 查看的地址cb
accountIsEmpty~callback
accountIsEmpty~callback
Callback for accountIsEmpty
method
accountIsEmpty
方法的回调
Type: Function
Parameters
error
Error an error that may have happened ornull
出现的错误或者null
empty
Boolean True if the account is empty false otherwise 如果账户为空则返回true,否则为false
cleanupTouchedAccounts
Removes accounts form the state trie that have been touched, as defined in EIP-161 (https://github.com/ethereum/EIPs/blob/master/EIPS/eip-161.md).
从状态前缀树中删除已修改的帐户,就像 EIP-161中定义的一样。可看本博客(ethereum/EIPs-161 State trie clearing)
Parameters
cb
Function Callback function
DefaultStateManager默认的StateManager
Default implementation of the StateManager
interface
StateManager
接口的默认实现
Parameters
opts
Object (optional, default{}
)opts.common
Common?Common
parameters of the chain 链的Common
参数opts.trie
Trie? amerkle-patricia-tree
instancemerkle-patricia-tree
实例
copy
Copies the current instance of the DefaultStateManager
at the last fully committed point, i.e. as if all current checkpoints were reverted
在最后的完全提交点复制当前的DefaultStateManager实例,比如好像所有当前检查点都恢复了
dumpStorage
Dumps the the storage values for an account
specified by address
为了被地址指定的账户倾倒存储值
Parameters
address
Buffer The address of theaccount
to return storage for 为了改账户地址返回存储值cb
dumpStorage~callback
dumpStorage~callback
Callback for dumpStorage
method
dumpStorage
方法的回调
Type: Function
Parameters
error
Error an error that may have happened ornull 出现的错误或null
accountState
Object The state of the account as anObject
map. Keys are are the storage keys, values are the storage values as strings. Both are represented as hex strings without the0x
prefix.作为对象映射的账户状态。Keys是存储键,values是字符串的存储值。都是没有0x前缀的十六进制表示的
hasGenesisState
Checks whether the current instance has the canonical genesis state for the configured chain parameters.
为了配置链参数查看是否当前的实例有规范生成状态
Parameters
hasGenesisState~callback
Callback for hasGenesisState
method
hasGenesisState
方法的回调
Type: Function
Parameters
error
Error an error that may have happened ornull
出现的错误或null
hasGenesisState
Boolean Whether the storage trie contains the canonical genesis state for the configured chain parameters. 存储前缀树是否为了配置链参数包含了规范生成状态
generateGenesis
Initializes the provided genesis state into the state trie
将提供的生成状态初始化到状态前缀树中
Parameters