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