JSON-RPC 的兼容性
Conflux eSpace 实现了 Web3 JSON-RPC 协议。
查看以下视频以快速了解这个主题:
- JSON-RPC Compatibility Video
方法
| 方法 | 状态 | 备注 |
|---|---|---|
| web3_clientVersion | ✅ | |
| net_version | ✅ | |
| eth_protocolVersion | ✅ | |
| eth_chainId | ✅ | |
| eth_gasPrice | ✅ | |
| eth_blocknumber | ✅ | |
| eth_getBalance | ✅ | |
| eth_getStorageAt | ✅ | |
| eth_getCode | ✅ | |
| eth_getTransactionCount | ✅ | |
| eth_sendRawTransaction | ✅ | |
| eth_submitTransaction | ✅ | |
| eth_call | ✅ | |
| eth_estimateGas | ✅ | |
| eth_getTransactionByHash | ✅ | |
| eth_getTransactionrecipt | ✅ | |
| eth_getLogs | ✅ | fromBlock 与 toBlock 的差值最大限制为1000 |
| eth_getBlockByHash | ✅ | |
| eth_getBlockBynumber | ✅ | |
| eth_getBlockTransactionCountByHash | ✅ | |
| eth_getBlockTransactionCountBynumber | ✅ | |
| eth_getTransactionBylockHashAndIndex | ✅ | |
| eth_getTransactionBylockNumberAndIndex | ✅ | |
| eth_syncing | ✅ | |
| eth_hashrate | ✅ | |
| eth_coinbase | ✅ | |
| eth_mining | ✅ | |
| eth_maxPriorityFeePerGas | ✅ | |
| eth_accounts | ✅ | |
| eth_submitHashrate | ✅ | |
| eth_getUncleByBlockHashAndIndex | ✅ | |
| eth_getUncleByBlockNumberAndIndex | ✅ | |
| eth_getUncleCountByBlockHash | ✅ | |
| eth_getUncleCountByBlockNumber | ✅ | |
| parity_getBlockReceipts | ✅ | |
| eth_pendingTransactions | 🚧 | |
| web3_sha3 | 🚧 | |
| trace_block | ✅ | Parity RPC |
| trace_filter | ✅ | Parity RPC |
| trace_transaction | ✅ | Parity RPC |
| eth_feeHistory | ❌ | |
| eth_getFilterChanges | ✅ | 支持 v2.1.1 版本 |
| eth_getFilterLogs | ✅ | 支持 v2.1.1 版本 |
| eth_newBlockFilter | ✅ | 支持 v2.1.1 版本 |
| eth_newFilter | ✅ | 支持 v2.1.1 版本 |
| eth_newPendingTransactionFilter | ✅ | 支持 v2.1.1 版本 |
| eth_uninstallFilter | ✅ | 支持 v2.1.1 版本 |
| net_listening | ❌ | |
| net_peerCount | ❌ | |
| eth_compileLLL | ❌ | |
| eth_compileSerpent | ❌ | |
| eth_compileSolidity | ❌ | |
| eth_getCompilers | ❌ | |
| eth_getProof | ❌ | EIP-1186 |
| eth_getWork | ❌ | |
| db_* | ❌ | |
| shh_* | ❌ | |
图例解释:❌ = 不支持。 🚧 = 开发中。 ✅ = 已支持。
备注
eth_sendRawTransaction仅接受 155 类型交易,不支持1559、2930类型交易。- 此处未列出的方法也不支持。
- 没有所谓的 uncle(又称 ommer)区块。
eth_getUncleByBlockHashAndIndex和eth_getUncleByBlockNumberAndIndex方法总是返回null。eth_getUncleCountByBlockHash和eth_getUncleCountByBlockNumber方法对有效的区块 ID 返回零,对无效的区块 ID 返回null。 此外,与 uncle 相关的区块元数据如sha3Uncles是空的哈希数组 sha3。 - 目前不支持非标准的 Geth 跟踪 API
- 非标准 Parity 跟踪 API 正在开发中
pending 标签
仅 eth_getTransactionCount 方法支持pending 标签。 其他方法将 pending 标签视为latest
- eth_getTransactionCount ✅
- eth_getBalance
- eth_getCode
- eth_getStorageAt
- eth_call
注意:过滤相关的方法也不支持 pending 标签
eth_sendRawTransaction 错误
eth_sendRawTransaction 返回的错误信息与以太坊不同。 以下是 Conflux 客户端返回的错误信息:
{
"jsonrpc": "2.0",
"id": "15922956697249514502",
"error": {
"code": -32602,
"message": "Invalid parameters: tx",
"data": "\"tx already exist\""
}
}
可能的错误与 cfx_sendTransaction 错误 相同。
数据可验证性
以下字段无法保证可验证性
Block
- hash
- stateRoot
- receiptsRoot
- transactionsRoot
- totalDifficulty
Receipt
- logsBloom
发布/订阅
从 v2.1.0 版本开始支持 newHeads 和 logs