干货 | Eth1.x 术语表（下）

JSON-RPC

eth_protocolVersion

传到 DevP2P 网络的元信息（meta information）；

面向没有实现这个功能的客户端，很容易伪造这个信息

eth_syncing

关于该节点同步状态的元信息

面向没有实现这个功能的客户端，很容易伪造这个信息

eth_coinbase

表示该客户端使用的默认地址

面向没有实现这个功能的客户端，很容易伪造这个信息

仅对实现了账户管理功能的客户端有效

eth_mining

该节点挖矿状态的元信息

仅对正在挖矿的节点有效

面向没有实现这个功能的客户端，很容易伪造这个信息

eth_hashrate

挖矿的元信息

仅对正在挖矿的节点有效

面向没有实现这个功能的客户端，很容易伪造这个信息

eth_gasPrice

该节点 认为 此时 gasPrice 是多少的元信息

面向没有实现这个功能的客户端，很容易伪造这个信息

取出一个合适的 gas price 值是一个与需求高度相关的操作，没有哪种策略适合所有的应用场景。

eth_accounts

该节点所管理的账户的列表。

面向没有实现这个功能的客户端，很容易伪造这个信息

仅对实现了账户管理功能的客户端有效

eth_blockNumber

返回该节点认定为最新区块的区块号

需要 “全体区块头” 和 “追随区块链” 功能的结合

并不能完全确定，该节点是能提供该区块号处的 事务/收据/状态 数据，还是仅仅接受了该区块号是最新高度。

eth_getBalance

提供地址后，可返回该账户的 ETH 余额（以 wei 为单位）

需要响应节点能访问账户状态

eth_getStorageAt

提供账户及存储槽序号后，可返回该处存储的值

需要响应节点能访问合约存储项

eth_getTransactionCount

提供地址后，可返回该地址的 nonce

需要响应节点能访问账户状态

eth_getBlockTransactionCountByHash

提供一个区块的哈希值，返回该块中的事务数量

需要响应节点能访问区块体历史

eth_getBlockTransactionCountByNumber

提供一个区块的区块号，返回该块中的事务数量

需要响应节点能访问区块体历史

需要响应节点能访问主链区块索引

eth_getUncleCountByBlockHash

返回给定哈希值的区块中的叔块数量

需要响应节点能访问区块体历史

eth_getUncleCountByBlockNumber

返回给定区块号的区块中的叔块数量

需要响应节点能访问区块体历史

需要响应节点能访问主链区块索引

eth_getCode

返回给定账户处的字节码（bytecode）

需要响应节点能访问账户状态

需要响应节点能访问合约代码

eth_sign

返回给定地址的签名

仅对实现了账户管理功能的客户端有效

eth_signTransaction

为给定事务生成签名并返回已签名事务的 RLP 编码数据

仅对实现了账户管理功能的客户端有效

需要响应节点能访问账户状态以取得合适的 nonce

eth_sendTransaction

为给定事务生成签名并广播

仅对实现了账户管理功能的客户端有效

需要响应节点能访问账户状态以取得合适的 nonce

需要响应节点能参与事务广播

eth_sendRawTransaction

广播一条经过签名的事务

需要响应节点能参与事务广播

eth_call

在响应节点最新的状态上执行特定事务并返回执行结果

要求响应节点能执行 EVM

eth_estimateGas

在响应节点最近的状态上执行特定事务并返回执行该事务消耗的 gas 数量

要求响应节点能执行 EVM

最经常的用途是建构交易

eth_getBlockByHash

返回由哈希值指定的区块的数据

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

eth_getBlockByNumber

返回由区块号指定的区块的数据

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

要求响应节点能访问主链区块索引

对这个操作的调用可以直接映射成对 eth_getBlockByHash 的等价调用，只要能访问主链区块索引

eth_getTransactionByHash

提供哈希值，返回对应事务的数据

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

要求响应节点能访问主链事务索引

对这个操作的调用可以直接映射成对 eth_getTransactionByBlockHashAndIndex 的等价调用，只要能访问主链事务索引

eth_getTransactionByBlockHashAndIndex

返回由区块哈希值和事务索引号指定的事务的数据

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

eth_getTransactionByBlockNumberAndIndex

返回由区块号和事务索引号指定的事务的数据

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

要求响应节点能访问主链区块索引

对这个操作的调用可以直接映射成对 eth_getTransactionByBlockHashAndIndex 的等价调用，只要能访问主链区块索引

eth_getTransactionReceipt

返回由哈希值指定的事务的收据

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

要求响应节点能访问主链事务索引

eth_getUncleByBlockHashAndIndex

返回由区块哈希值和索引指定的叔块信息

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

eth_getUncleByBlockNumberAndIndex

返回由区块哈希号和索引指定的叔块信息

要求响应节点拥有全体区块头

要求响应节点能访问区块体历史

要求响应节点能访问主链区块索引

对这个操作的调用可以直接映射成对 eth_getUncleByBlockHashAndIndex 的等价调用，只要能访问主链区块索引