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

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

干货 | 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

• 返回由区块号和事务索引号指定的事务的数据
• 要求响应节点拥有全体区块头
• 要求响应节点能访问区块体历史