Skip to main content

JSON-RPC Compatibility

Conflux eSpace implements the Web3 JSON-RPC protocol.

Check out the following video to get a quick overview of this topic:

Methods

MethodStatusNote
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_getLogsThe max gap between fromBlock and toBlock is limited to 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_feeHistorySupported at v2.4.0
eth_getFilterChangesSupported at v2.1.1
eth_getFilterLogsSupported at v2.1.1
eth_newBlockFilterSupported at v2.1.1
eth_newFilterSupported at v2.1.1
eth_newPendingTransactionFilterSupported at v2.1.1
eth_uninstallFilterSupported at v2.1.1
debug_traceTransactionSupported at v2.4.0
debug_traceBlockByHashSupported at v2.4.0
debug_traceBlockByNumberSupported at v2.4.0
debug_traceCallSupported at 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_*

Legend: ❌ = not supported. 🚧 = work in progress. ✅ = supported.

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.

Notes

  • eth_sendRawTransaction supports legacy(EIP-155), type-1(EIP-2930) and type-2(EIP-1559) transactions. Type-3 transactions (EIP-4844) transactions are not supported yet.
  • Methods not listed here are also not supported.
  • There is no concept of uncle (aka ommer) blocks. The eth_getUncleByBlockHashAndIndex and eth_getUncleByBlockNumberAndIndex methods always return null. The eth_getUncleCountByBlockHash and eth_getUncleCountByBlockNumber methods return zero for valid block IDs and null for invalid block IDs. Additionally, uncle-related block metadata such as sha3Uncles is sha3 of empty hash array.
  • The nonstandard Geth tracing APIs are not supported at present
  • The nonstandard Parity tracing APIs are in progress
  • 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 tag

Only eth_getTransactionCount method has supported pending tag. Other method will treat pending tag as latest

  • eth_getTransactionCount ✅
  • eth_getBalance
  • eth_getCode
  • eth_getStorageAt
  • eth_call

Note: filter related methods also not support pending tag

Data verifiability

Below fields can not guarantee the verifiability

Block

  • hash
  • stateRoot
  • receiptsRoot
  • transactionsRoot
  • totalDifficulty

Receipt

  • logsBloom

pub/sub

Starting from v2.1.0 newHeads and logs is supported

ETH RPC docs