跳到主要内容

JSON-RPC 的兼容性

Conflux eSpace 实现了 Web3 JSON-RPC 协议。

查看以下视频以快速了解这个主题：

方法​

方法状态备注
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_getTransactionReceipt✅
eth_getLogs✅fromBlock 与 toBlock 的差值最大限制为1000
eth_getBlockByHash✅
eth_getBlockByNumber✅
eth_getBlockTransactionCountByHash✅
eth_getBlockTransactionCountByNumber✅
eth_getTransactionByBlockHashAndIndex✅
eth_getTransactionByBlockNumberAndIndex✅
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✅Compatible with parity and erigon since v3.0.0
trace_filter✅Compatible with parity and erigon since v3.0.0
trace_transaction✅Compatible with parity and erigon since v3.0.0
trace_get✅Supported at v3.0.0
trace_call🚧
trace_rawTransaction🚧
trace_replayTransaction🚧
trace_replayBlockTransactions🚧
eth_feeHistory✅在v2.4.0版本中支持。
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版本中支持。
debug_traceTransaction✅在v2.4.0版本中支持。
debug_traceBlockByHash✅在v2.4.0版本中支持。
debug_traceBlockByNumber✅在v2.4.0版本中支持。
debug_traceCall✅在v2.4.1版本中支持。
txpool_status✅Supported at v3.0.0
txpool_inspect✅Supported at v3.0.0
txpool_content✅Supported at v3.0.0
txpool_contentFrom✅Supported at v3.0.0
net_listening❌
net_peerCount❌
eth_compileLLL❌
eth_compileSerpent❌
eth_compileSolidity❌
eth_getCompilers❌
eth_getProof❌EIP-1186
eth_getWork❌
db_*❌
shh_*❌

图例解释：❌ = 不支持。 🚧 = 开发中。 ✅ = 已支持。

Conflux Specific RPCs​

trace_blockSetAuth​

trace_blockSetAuth is a Conflux specific RPC used to retrieve the trace data for SetAuth operations in EIP-7702 transactions. The returned result is as follows:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        {
            "action": {
                "address": "0xf0109fc8df283027b6285cc889f5aa624eac1f55",
                "chainId": "0x401",
                "nonce": "0x1",
                "author": "0x3d69d968e3673e188b2d2d42b6a385686186258f"
            },
            "result": "invalid_nonce",
            "transactionPosition": 0,
            "transactionHash": "0x716f6f3294346099d98d5f9b0e12846647e1d17b9076d1a5ac0e42dac72f7229",
            "blockNumber": 7800,
            "blockHash": "0x015880a004ff96fed4161353994958d0f09eeae770f73ca888f105dc9f4ef1cc"
        }
    ]
}

Check trace_blockSetAuth for more details.

备注​

  • eth_sendRawTransaction支持传统交易（EIP-155）、类型1交易（EIP-2930）和类型2交易（EIP-1559）。 目前尚不支持类型-3的交易（EIP-4844）。
  • 此处未列出的方法也不支持。
  • 没有所谓的 uncle（又称 ommer）区块。 eth_getUncleByBlockHashAndIndex 和 eth_getUncleByBlockNumberAndIndex 方法总是返回 null。 eth_getUncleCountByBlockHash 和 eth_getUncleCountByBlockNumber 方法对有效的区块 ID 返回零，对无效的区块 ID 返回 null。 此外，与 uncle 相关的区块元数据如 sha3Uncles 是空的哈希数组 sha3。
  • 目前不支持非标准的 Geth 跟踪 API
  • 非标准 Parity 跟踪 API 正在开发中
  • A breaking change at v3.0.0: Trace RPC methods is compatible with parity and erigon, including trace_block, trace_transaction, trace_filter.

Extra Fields RPC Response​

Extra Fields of Transaction Receipts​

Transaction receipts returned by the eth_getTransactionReceipt RPC have the following extra fields:

  • burntGasFee: The amount of fees that is burned. In Conflux, the base fee of the transaction is partially burned rather than entirely burned. Check CIP-137 for more details.
  • gasFee: The amount of fees of a transaction. Added at v3.0.0.

Extra Fields of Block​

Block object returned by the eth_getBlockByNumber, eth_getBlockByHash RPC has the following extra fields:

  • espaceGasLimit: The actual gas limit for eSpace transactions, which is different from gasLimit in the block object. Check Spaces for more details. Added at v3.0.0.

pending 标签​

仅 eth_getTransactionCount 方法支持pending 标签。 其他方法将 pending 标签视为latest

  • eth_getTransactionCount ✅
  • eth_getBalance
  • eth_getCode
  • eth_getStorageAt
  • eth_call

注意：过滤相关的方法也不支持 pending 标签

数据可验证性​

以下字段无法保证可验证性

Block​

  • hash
  • stateRoot
  • receiptsRoot
  • transactionsRoot
  • totalDifficulty

Receipt​

  • logsBloom

发布/订阅​

从 v2.1.0 版本开始支持 newHeads 和 logs

ETH RPC 文档​