跳到主要内容

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_getLogsfromBlock 与 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_blockCompatible with parity and erigon since v3.0.0
trace_filterCompatible with parity and erigon since v3.0.0
trace_transactionCompatible with parity and erigon since v3.0.0
trace_getSupported 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_statusSupported at v3.0.0
txpool_inspectSupported at v3.0.0
txpool_contentSupported at v3.0.0
txpool_contentFromSupported at v3.0.0
net_listening
net_peerCount
eth_compileLLL
eth_compileSerpent
eth_compileSolidity
eth_getCompilers
eth_getProofEIP-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_getUncleByBlockHashAndIndexeth_getUncleByBlockNumberAndIndex 方法总是返回 nulleth_getUncleCountByBlockHasheth_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 版本开始支持 newHeadslogs

ETH RPC 文档