因为Conflux实现结构与Ethereum不同,所以概念上及实现上也有很大的区别,本文主要介绍针对Conflux RPC使用与以太坊RPC使用的区别

概念介绍

Epoch

以太坊区块链中只有主链上的交易是有效的,所以可认为以太坊区块账本是一条单链,从前往后每个区块都有一个编号,叫做区块号( block number),conflux 开发了一种全新的账本结构: 树图,实现了高吞吐,低延迟。

在树图区块结构中,如果只看父边他是一个 Tree,如果父边引用边都看则是一个 Graph。正是这种结构使得 Conflux 网络可以并发出块,即多个区块可以都在某个区块之后生成。因此在 Conflux 是没有 block number 的概念。 但为了实现全序,Conflux 通过 GHAST 规则从创世区块开始,在其所有子区块中选择最重子树 block 为 pivot block,所有的 pivot block 链到一块也形成一条链 定义为 pivot chain,如果只看 pivot chain 其跟普通的区块链结构一致,在这条链上基于每个 pivot block 定义一个Epoch,因此你可以把 conflux 中的 Epoch 理解为跟 block number 对应的概念,只不过 conflux 中的每个 epoch 中可能会有多个 block。

Storage Limit

在现实世界中,发起交易需要支付人力、物力、时间、手续费等成本,而在区块链网络中发送交易需要给矿工付手续费,在Conflux、以太坊中同样如此。具体来讲,Conflux、ETH网络的交易最终是由矿工 运行的 VM 执行的,gas 是用来衡量一笔交易执行的工作量(可以理解为工作的工时),交易发送者,发送交易时可以指定愿意给每个工作量付的价格即 gasPrice。 因此最终一笔交易的手续费为 gas * gasPrice。 在发送一笔交易时指定的 gas 则是一个限制值,即发送方最大愿意为一笔交易支付 gas 这么多的工时,如果交易需要的工作量超过 gas,则不会再付钱,交易不会被执行。

在 Dapp 系统中,交易执行除了需要Node进行计算付出计算资源外,还需要Node存储合约的状态,因此需要付出存储资源。在 Conflux 系统中发送交易时,还需要为状态存储 抵押一部分费用,因此在 conflux 中发送交易时会比以太坊多一个 storageLimit 参数,用于设置愿意为某笔交易存储所抵押的费用上限。在合约释放掉使用的存储空间之后,抵押的费用 也会得到返还。

RPC 相关参数介绍

Epoch Number 可选项

当发送RPC请求时,有些RPC需要携带Epoch Number参数, Epoch Number 表示要请求在哪个Epoch的状态。 以下是参数 Epoch Number 的可选项:

格式意义
16进制字符串epoch number 整形数值(如"0x1000" 表示 Epoch number 4096)
字符串 "earliest"创世块所在的 Epoch高度
字符串 "latest_checkpoint"当前checkpoint的第一个Epoch高度
字符串 "latest_state"最近执行的区块所在的Epoch高度
字符串 "latest_mined"最新挖出的区块所在的Epoch高度

注意,出于性能优化的考虑,最新的Epoch是不可执行的,所以在这些Epoch里没有可用的状态。对于大多数与状态查询有关的 RPCs,建议使用"latest_state"。

数据的16进制编码规则

发送RPC请求时,无格式的字节数组和数值,两种关键数据类型是通过JSON格式数据进行传输。两者都以十六进制编码传输,但格式稍有不同:

1. 对数值编码

当编码数值(整数,数字)时:编码为前缀为"0x"的十六进制,使用最紧凑的表现形式(例外:零表示为"0x0")。 示例如下:

正确示例:

  • 0x41 (十进制数字 65)
  • 0x400 (十进制数字 1024)

错误示例:

  • 错误: 0x(需至少有一位数字 - 零为 "0x0")
  • 错误: 0x0400(不允许以零开头)
  • 错误: ff(必须以 0x 为前缀)
2. 对无格式数据编码

当编码无格式数据(字节数组,帐户地址,哈希值,字节码数组)时也是使用前缀为"0x"的十六进制编码,与数值编码的区别是:每个字节必须包含使用两位十六进制数字。 示例如下:

正确示例:

  • 0x41 (长度为 1,表示字符串"A")
  • 0x004200 (长度为 3,表示字符串"\0B\0")
  • 0x (长度为0,表示字符串"")

错误示例

  • 错误: 0xf0f0f (必须为偶数位数)
  • 错误: 004200 (必须以0x开头)

设置 GasLimit & StorageLimit & EpochHeight

发送交易时,建议先使用 RPC cfx_estimateGasAndCollateral 返回预估的gas使用数量和存储抵押数量;然而由于实际执行消耗与预估结果有差异,为了防止交易执行失败,建议在实际发送交易时,设置gaslimit与storage_limit的值为预估值 * 4/3

参数EpochHeight表示这笔交易将会在 Epoch为 [EpochHeight-100000 , EpochHeight+100000] 的区间内执行,当超出这个区间这笔交易将被丢弃,建议设置当前Epoch值即可。

Conflux VS Ethereum JSONRPC

以下是对 Conflux 与 Ethereum 的JSON RPC的使用比较,Conflux RPC 详细介绍请参见JSON RPC开发者文档

Public RPC

Conflux Public RPC对应 Ethereum RPCRPC 参数需要 epoch number 参数?
cfx_gasPriceeth_gasPrice N
cfx_epochNumbereth_blockNumberepoch_numberY
cfx_getBalanceeth_getBalanceaddress,epoch_numberY
cfx_getAdmin-address,epoch_numberY
cfx_getSponsorInfo-address,epoch_numberY
cfx_getStakingBalance-address,epoch_numberY
cfx_getCollateralForStorage-address,epoch_numberY
cfx_getCodeeth_getCodeaddress,epoch_numberY
cfx_getStorageAteth_getStorageAtaddress,pos,epoch_numberY
cfx_getStorageRoot-address,epoch_numberY
cfx_getBlockByHasheth_getBlockByHashblock_hash,include_txsN
cfx_getBlockByHashWithPivotAssumption-block_hash, pivot_hash, epoch_number,Y
cfx_getBlockByEpochNumbereth_getBlockByNumberepoch_number, include_txsY
cfx_getBestBlockHash- N
cfx_getNextNonce-address, epoch_numberY
cfx_sendRawTransactioneth_sendRawTransactionraw_txN
cfx_calleth_calltx, epoch_numberY
cfx_getLogseth_getLogsfilterN
cfx_getTransactionByHasheth_getTransactionByHashtx_hashN
cfx_estimateGasAndCollateraleth_estimateGasrequest, epoch_numberY
cfx_checkBalanceAgainstTransaction-account_addr, contract_addr, gas_limit,gas_price, storage_limit, epochY
cfx_getBlocksByEpoch-epoch_numberY
cfx_getSkippedBlocksByEpoch-epoch_numberY
cfx_getTransactionReceipteth_getTransactionReceipttx_hashN
cfx_getAccount-address, epoch_numberY
cfx_getInterestRate-epoch_numberY
cfx_getAccumulateInterestRate-epoch_numberY
cfx_getConfirmationRiskByHash-block_hash N
cfx_getStatus- N
cfx_getBlockRewardInfo-epoch_numberY
cfx_clientVersionweb3_clientVersion N

Local RPC

Conflux 除了公共rpc外,还有一部分rpc出于安全及性能方面的考虑限制只能在本地访问

Conflux local rpc对应 Ethereum rpc
txpool_status-
tx_inspect-
txpool_inspect-
txpool_contenteth_newPendingTransactionFilter
getTransactionsFromPool-
clear_tx_pool-
net_throttling-
net_node-
net_disconnect_node-
net_sessions-
current_sync_phase-
consensus_graph_state-
sync_graph_state-
cfx_sendTransactioneth_sendTransaction
accountseth_accounts
new_account-
unlock_account-
lock_account-
signeth_sign

暂无对应关系的以太坊RPC

以下是以太坊中有的,Conflux暂时还没有对应关系的RPC

  • web3_sha3
  • net_version
  • net_peerCount
  • net_listening
  • eth_protocolVersion
  • eth_coinbase
  • eth_mining
  • eth_hashrate
  • eth_getTransactionCount
  • eth_getBlockTransactionCountByHash
  • eth_getBlockTransactionCountByNumber
  • eth_getUncleCountByBlockHash
  • eth_getUncleCountByBlockNumber
  • eth_signTransaction
  • eth_getTransactionByBlockHashAndIndex
  • eth_getTransactionByBlockNumberAndIndex
  • eth_getUncleByBlockHashAndIndex
  • eth_getUncleByBlockNumberAndIndex
  • eth_getCompilers
  • eth_compileLLL
  • eth_compileSolidity
  • eth_compileSerpent
  • eth_newFilter
  • eth_newBlockFilter
  • eth_uninstallFilter
  • eth_getFilterChanges
  • eth_getWork
  • eth_submitWork
  • eth_submitHashrate
  • db_putString
  • db_getString
  • db_putHex
  • db_getHex
  • shh_post
  • shh_version
  • shh_newIdentity
  • shh_hasIdentity
  • shh_newGroup
  • shh_addToGroup
  • shh_newFilter
  • shh_uninstallFilter
  • shh_getFilterChanges
  • shh_getMessages
  • eth_syncing

Conflux中文社区
66 声望19 粉丝

Conflux网址:[链接]