cfx 命名空间

JSON-RPC规范说明

在GitHub上有一个cfx命名空间的JSON-RPC API规范。你可以在 open-rpc 测试平台中查看它。查看 Conflux-Rust RPC 的更新日志以了解更多。

惯例

十六进制值编码

有两种关键的数据类型通过 JSON 传递：未格式化的字节数组和数量。二者都使用十六进制编码传递，但对格式化有不同的要求。

数值

当编码数值（整数，数字）时：使用最紧凑的表示方式编码为十六进制，并加上“0x”前缀。零应表示为"0x0"。例如：

0x41（十进制的 65）
0x400（十进制的 1024）
错误样例：0x（应该至少有一位数字 - 零是“0x0”）
错误样例：0x0400（不允许有前导零）
错误样例：：ff（缺少0x前缀）

未格式化的数据

当编码未格式化的数据（字节数组、哈希值、字节码数组）时：使用两个十六进制数字表示每个字节，并在前面加上“0x”作为前缀。例如：

0x41 (size 1, "A")
0x004200 (size 3, "\0B\0")
0x (size 0, "")
错误： 0xf0f0f（必须是偶数位数）。
错误： 004200（缺少0x前缀）。

请注意，区块和交易的哈希值是用32个字节来表示的。

Base32 地址

BASE32：Base32 地址应该编码为一个ASCII字符串，包含42个字符加上网络前缀、分隔符和可选字段。请注意以下关于base32地址作为RPC参数的限制条件：

网络前缀应该与节点的网络匹配，例如：cfx:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp可以发送给主网节点，cfxtest:acc7uawf5ubtnmezvhu9dhc6sghea0403ywjz6wtpg可以发送给测试网节点。值得注意的是，这两个示例地址对应于不同网络上的同一个账户。
无论包含还是省去地址类型都是可以接受的，例如：cfx:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg和cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg是等价的。但是，类型不正确的地址，例如：cfx:type.contract:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg，会被拒绝。
全大写或者全小写地址都是可以接受的，例如：cfx:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg和CFX:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG都是有效的。但混合大小写地址会被拒绝。

为获取更多关于 Base32 地址的信息，请参阅地址。

默认的 epochNumber （纪元数）参数

有几个RPC方法有一个epoch number参数。 Epoch的概念在Conflux中有点类似于其他账本中的区块号（高度），但是一个epoch可能包含多个区块。

Epoch number指定了在一个时间点时，系统的相应状态，这些状态受到共识的约束。 Epoch number参数有以下几种可能的选项：

HEX String - 整数纪元数。例如，0x3e8是epoch 1000。
String “earliest”表示创世区块的epoch。
String “latest_checkpoint”表示存储在内存中的最早的epoch。
String “latest_finalized” - 表示最新的已经确定（通过PoS）的epoch。（添加自conflux-rust v2.0.0）
String “latest_confirmed” - 表示最新的已经确认的epoch（使用确认计量器的估计值）。
string "latest_state" - 表示已经执行的最新纪元。
String “latest_mined” - 表示最新的已知epoch。

请注意，由于性能优化，最新的已知epoch没有被执行，所以这些epoch没有可用的状态。对于大多数与状态查询有关的RPC，推荐使用"latest_state"。（有关Conflux中交易生命周期的更多信息，请参考交易生命周期）

遵循 EIP-1898 的Conflux epochNumber 参数

Conflux core space 支持纪元数参数在 EIP-1898 样式中为某些RPC 服务。开发者可以通过提供纪元编号或区块哈希来查询纪元的状态。此外，该参数使开发者能够查询特定纪元的状态，从而确定哪个区块是枢纽区块，这在处理链重组时非常有用。

EIP-1898 样式的纪元参数是一个包含3个可选字段的对象：

epochNumber. 对应于EIP-1898定义的blockNumber。
blockHash. 指定区块的哈希
requirePivot. 对应于EIP-1898中的 requireCanonical, 但用法不同。
- 如果为true，当由blockHash指定的区块不是枢纽块时，RPC将返回错误消息"pivot chain assumption failed"（枢纽块假设失败）。
- 如果为 false，无论该区块是否为枢纽区块，RPC 都将根据 blockHash指定的区块的纪元返回结果。
- 默认值为true.

备注

如果提供了blockHash且requirePivot设置为真，无论RPC的行为如何（例如epoch是否已执行），RPC 会首先检查该区块是否为枢纽区块。

例如：

{
  "epochNumber": "0x3e8"
}

or
{
  "blockHash": "0x692373025c7315fa18b2d02139d08e987cd7016025920f59ada4969c24e44e06",
  "requirePivot": false
}

or 

{
  "blockHash": "0x692373025c7315fa18b2d02139d08e987cd7016025920f59ada4969c24e44e06",
  "requirePivot": true
}

EIP-1898中的纪元号参数现在可用于以下RPC：

cfx_getBalance
cfx_getStorageAt
cfx_call
cfx_getNextNonce
cfx_getCode
cfx_getEpochReceipts

CURL 请求示例

下面提供了通过向Conflux节点发出 curl 请求来使用 JSON_RPC 应用程序接口的示例。每个示例都包括对特定端点、其参数、返回类型的描述，以及应该如何使用它的工作示例。

Curl 请求可能会返回与内容类型相关的错误消息。这是因为 --data 选项将内容类型设置为 application/x-www-form-urlencoded。如果你的节点确实抱怨此问题，请通过在调用开始时放置 -H "Content-Type: application/json" 来手动设置标头。这些示例也未包括网址/互联网协议与端口组合，该组合必须是 curl 的最后一个参数（例如 127.0.0.1:12537）。包含这些附加数据的完整 curl 请求采用以下形式：

$ curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"cfx_clientVersion","params":[],"id":67}' 127.0.0.1:12537

本文档剩余部分的示例将使用 HTTP endpoint。

状态和交易可用性

Conflux的归档节点和全节点会删除历史状态树，以减少存储空间的占用。全节点也会丢弃历史区块的交易和收据。因此，一些RPC接口可能无法用于历史查询。

下面是Conflux RPC API的列表，以及它们在归档节点和全节点上的可用性。 *“recent”表示该RPC只支持最近的项目，“OK”*表示它应该对任何有效的输入都能正常工作。

RPC	归档节点	全节点
`cfx_call`	recent	recent
`cfx_checkBalanceAgainstTransaction`	recent	recent
`cfx_clientVersion`	OK	OK
`cfx_epochNumber`	OK	OK
`cfx_estimateGasAndCollateral`	recent	recent
`cfx_gasPrice`	OK	OK
`cfx_getAccount`	recent	recent
`cfx_getAccumulateInterestRate`	OK	OK
`cfx_getAdmin`	recent	recent
`cfx_getBalance`	recent	recent
`cfx_getBestBlockHash`	OK	OK
`cfx_getBlockByEpochNumber`	OK	recent
`cfx_getBlockByHash`	OK	recent
`cfx_getBlockByHashWithPivotAssumption`	OK	recent
`cfx_getBlockRewardInfo`	OK	recent
`cfx_getBlocksByEpoch`	OK	OK
`cfx_getCode`	recent	recent
`cfx_getCollateralForStorage`	recent	recent
`cfx_getConfirmationRiskByHash`	OK	recent
`cfx_getDepositList`	recent	recent
`cfx_getInterestRate`	recent	recent
`cfx_getLogs`	OK	recent
`cfx_getNextNonce`	recent	recent
`cfx_getSkippedBlocksByEpoch`	OK	OK
`cfx_getSponsorInfo`	recent	recent
`cfx_getStakingBalance`	recent	recent
`cfx_getStatus`	OK	OK
`cfx_getStorageAt`	recent	recent
`cfx_getStorageRoot`	recent	recent
`cfx_getTransactionByHash`	OK	recent
`cfx_getTransactionReceipt`	OK	recent
`cfx_getVoteList`	recent	recent
`cfx_sendRawTransaction`	OK	OK

如果您查询的状态条目在节点上不可用，您将收到错误响应：

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBalance","params":["cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg", "earliest"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "error": {
    "code": -32016,
    "message": "Error processing request: State for epoch (number=0 hash=0x24dcc768132dc7f651d7cb35c52e7bba632eda073d8743f81cfe905ff7e4157a) does not exist: out-of-bound StateAvailabilityBoundary { synced_state_height: 0, lower_bound: 9510001, upper_bound: 9569393, optimistic_executed_height: Some(9569392) }"
  },
  "id": 1
}

在这个例子中，我们被告知最早可用的状态是在纪元9510001（0x911c71）处。

从以太坊 JSON-RPC 迁移

以太坊和 Conflux 的一些 JSON-RPC 有对应关系。即使 JSON-RPC 的细节可能有所不同，但以下映射表在从以太坊迁移到 Conflux 时可能会有所帮助：

以太坊	Conflux
`eth_blockNumber`	`cfx_epochNumber`
`eth_call`	`cfx_call`
`eth_estimateGas`	`cfx_estimateGasAndCollateral`
`eth_gasPrice`	`cfx_gasPrice`
`eth_getBalance`	`cfx_getBalance`
`eth_getBlockByHash`	`cfx_getBlockByHash`
`eth_getBlockByNumber`	`cfx_getBlockByEpochNumber`
`eth_getCode`	`cfx_getCode`
`eth_getLogs`	`cfx_getLogs`
`eth_getStorageAt`	`cfx_getStorageAt`
`eth_getTransactionByHash`	`cfx_getTransactionByHash`
`eth_getTransactionCount`	`cfx_getNextNonce`
`eth_getTransactionrecipt`	`cfx_getTransactionReceipt`
`eth_sendRawTransaction`	`cfx_sendRawTransaction`

GOSSIP, STATE, HISTORY

一些核心的 JSON-RPC 方法需要从 Conflux 网络获取数据，它们可以分为三个主要类别：Gossip, State 和 History。你可以使用这些部分中的链接跳转到每个方法，或者使用目录来浏览所有方法的列表。

Gossip 方法

这些方法跟踪链的头部。这是交易在网络中传播、进入区块的方式，以及客户端发现新区块的方式。

cfx_getStatus
cfx_epochNumber
cfx_sendRawTransaction

State 方法

这些方法报告存储的所有数据的当前状态。 “状态”就像一块大的共享内存，包括账户余额、合约数据和 gas 估算。

cfx_getBalance
cfx_getStorageAt
cfx_getNonce
cfx_getCode
cfx_call
cfx_estimateGasAndCollateral

History 方法

获取从创世区块开始的每个区块的历史记录。这就像一个大型的只追加文件，包括所有区块头、区块体和交易收据。

cfx_getBlockByHash
cfx_getBlockByEpochNumber
cfx_getTransactionByHash
cfx_getTransactionReceipt

JSON-RPC 方法

cfx_getTransactionByHash

返回关于一个交易的信息，通过它的哈希来识别。

参数

DATA，32 字节 - 交易的哈希。

params: [
    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
]

返回值

Object - 交易对象，如果没有找到交易，则为 null：

type: QUANTITY，交易的类型。 0x0 表示传统交易，0x1 表示 CIP-2930 交易，0x2 表示 CIP-1559 交易。
blockHash: DATA，32 字节，包含并执行了这个交易的区块的哈希。 null 当交易是 pending 时为 null
chainId: QUANTITY - 发送者指定的链 ID
contractCreated: BASE32，创建的合约的地址。 null 当它不是一个合约部署交易时为 null
data: DATA，随交易发送的数据。
epochHeight: QUANTITY - 发送者指定的 epoch。注意这不是包含这个交易的区块的 epoch。
from: BASE32 - 发送者的地址。
gas: QUANTITY - 发送者提供的 gas。
gasPrice: QUANTITY - 发送者以 Drip 为单位提供的 gas 价格。
hash: DATA, 32 Bytes - 交易的哈希。
nonce: QUANTITY - 发送者在这之前发送的交易数量。
r: DATA, 32 字节 - ECDSA 签名 r
s: DATA, 32 字节 - ECDSA 签名 s
status: QUANTITY - 0表示成功，1表示发生错误，2表示跳过， null表示交易被跳过或未被打包。
storageLimit: QUANTITY - 发送者指定的存储限制。
to: BASE32 - 接收者的地址。 null 当它是一个合约部署交易时为 null
transactionIndex：QUANTITY - 表示区块中的交易索引位置。 null 当交易是 pending 时为 null
v：QUANTITY - ECDSA 恢复 ID
value：QUANTITY - 转移的价值，以 Drip 为单位。
maxGasFeePerGas: QUANTITY ，发送者愿意支付的每单位燃气的最大总费用（包括网络/基础费用和矿工/优先费用），以Drip为单位。
maxPriorityFeePerGas: QUANTITY ，发送者愿意支付给矿工的每单位燃气的最大费用，以Drip为单位。
accessList: ARRAY ，EIP-2930访问列表。
yParity: QUANTITY ，secp256k1签名中y值的奇偶性（0表示偶数，1表示奇数）。

注意，字段 blockHash, contractCreated, status 和 transactionIndex 是由节点提供的，因为它们依赖于交易在账本中的位置。其余的字段是包含在原始交易中或从原始交易中派生出来的。

请注意，字段 type，maxGasFeePerGas，maxPriorityFeePerGas，yParity和 accessList 包含在 Conflux-rust v2.4.0 的响应中。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getTransactionByHash","params":["0x497755f45baef13a35347933c48c0b8940f2cc3347477b5ed9f165581b082699"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "type": "0x2",
    "blockHash": "0x564750c06c7afb10de8beebcf24411cc73439295d5abb1264d2c9b90eee5606f",
    "chainId": "0x2",
    "contractCreated": null,
    "data": "0x0",
    "epochHeight": "0x909c9f",
    "from": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
    "gas": "0xf4240",
    "gasPrice": "0x174876e800",
    "hash": "0x497755f45baef13a35347933c48c0b8940f2cc3347477b5ed9f165581b082699",
    "nonce": "0x3b518",
    "r": "0x14da6cff1a3cd864b04d1b16f480fa023f449322e318b04bb1109b5754b516ce",
    "s": "0x304070abe6488c3532ecb66f4be32b88ee35ce48a4607b8d0c86461987a79fc7",
    "status": "0x0",
    "storageLimit": "0x100",
    "to": "CFX:TYPE.CONTRACT:ACC7UAWF5UBTNMEZVHU9DHC6SGHEA0403Y2DGPYFJP",
    "transactionIndex": "0x0",
    "v": "0x1",
    "value": "0x3635c9adc5dea00000",
    "accessList": [],
    "maxFeePerGas": "0x4a817c800",
    "maxPriorityFeePerGas": "0x4a817c800",
    "yParity": "0x0"
  },
  "id": 1
}

cfx_getBlockByHash

返回关于一个区块的信息，通过它的哈希来识别。

参数

DATA：32 字节，区块的哈希值。
Boolean - 如果 true，返回完整的交易对象。如果 false, 只返回交易的哈希值

params: [
    "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331",
    true
]

返回值

Object - 区块对象，或 null（当没有找到区块时）：

adaptive: Boolean - true 则该区块在 GHAST 规则下的权重是自适应的。
blame: QUANTITY - 如果为 0，则该区块不责怪其父路径上的任何区块。如果 n > 0, 则该区块责怪其父路径上的 n n 个前任，例如，当 n = 1, 则该区块责怪其父区块，但不责怪其父区块的父区块。
deferredLogsBloomHash: DATA, 32 Bytes - 在该区块所在 epoch 的延迟执行后的事件地址和事件topic的布隆滤波器的哈希（假设它是主区块）。
deferredReceiptsRoot: DATA, 32 Bytes - 在该区块所在 epoch 的延迟执行后的收据的 Merkle 根（假设它是枢轴区块）。
deferredStateRoot: DATA, 32 Bytes - 在该区块所在 epoch 的延迟执行后的状态 trie 根三元组的哈希（假设它是枢轴区块）。
difficulty: QUANTITY - 该区块的 PoW 难度。
epochNumber: QUANTITY - 包含该区块的 epoch 的编号，在节点对账本的视图中。 null 当 epoch 编号未确定时为 null（例如，该区块不在最佳区块的过去集合中）。
gasLimit：QUANTITY，决定区块的燃气限制。从 Conflux-rust v2.4.0开始，乘以系数0.9以计算出Core Space区块的燃气限制。例如，如果 gasLimit 字段值为 60,000,000，则交易Gas限制总和的实际最大值为 54,000,000。
gasUsed: QUANTITY - 该区块使用的总 gas。 null 当区块是 pending 时为 null。
hash：DATA，32 字节 - 区块的哈希。
height: QUANTITY - 区块的高度。
miner: BASE32 - 获得挖矿奖励的受益人地址。
nonce：DATA，8 字节 - 已生成的工作量证明的哈希。
parentHash：DATA，32 字节 - 父区块的哈希。
powQuality: DATA - PoW 质量。 null 当区块是 pending 时为 null。
refereeHashes: Array - 裁判区块哈希数组。
size: QUANTITY - 该区块的字节大小，不包括区块头。
timestamp: QUANTITY - 该区块创建的 unix 时间戳。
transactions: Array - 交易对象数组，或者 32 字节的交易哈希，取决于第二个参数。
transactionsRoot: DATA, 32 字节 - 该区块中交易的 Merkle 根。
custom: Array- 自定义信息。注意从 v2.0 开始，custom 的类型已经从数字数组的数组变成了十六进制字符串的数组。
blockNumber: QUANTITY - 该区块在树图中的总顺序编号。 null 当顺序未确定时为 null。添加自Conflux-rust v1.1.5
posReference: DATA, 32 字节 - PoS 最新提交区块的哈希。添加自Conflux-rust v2.0.0
baseFeePerGas：QUANTITY，区块中的每单位燃气的基础费用。添加自 Conflux-rust v2.4.0 。

注意，字段 epochNumber 和 gasUsed 是由节点提供的，因为它们依赖于账本。其余的字段是直接包含在区块头中或从区块头中派生出来的。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBlockByHash","params":["0x692373025c7315fa18b2d02139d08e987cd7016025920f59ada4969c24e44e06", false],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "adaptive": false,
    "blame": 0,
    "deferredLogsBloomHash": "0xd397b3b043d87fcd6fad1291ff0bfd16401c274896d8c63a923727f077b8e0b5",
    "deferredReceiptsRoot": "0x522717233b96e0a03d85f02f8127aa0e23ef2e0865c95bb7ac577ee3754875e4",
    "deferredStateRoot": "0xd449df4ba49f5ab02abf261e976197beecf93c5198a6f0b6bd2713d84115c4ec",
    "difficulty": "0xeee440",
    "epochNumber": "0x1394cb",
    "gasLimit": "0xb2d05e00",
    "gasUsed": "0xad5ae8",
    "hash": "0x692373025c7315fa18b2d02139d08e987cd7016025920f59ada4969c24e44e06",
    "height": "0x1394c9",
    "miner": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
    "nonce": "0x329243b1063c6773",
    "parentHash": "0xd1c2ff79834f86eb4bc98e0e526de475144a13719afba6385cf62a4023c02ae3",
    "powQuality": "0x2ab0c3513",
    "refereeHashes": [
      "0xcc103077ede14825a5667bddad79482d7bbf1f1a658fed6894fa0e9287fc6be1"
    ],
    "size": "0x180",
    "timestamp": "0x5e8d32a1",
    "transactions": [
      "0xedfa5b9c38ba51e791cc72b8f75ff758533c8c38f426eddee3fd95d984dd59ff"
    ],
    "custom": ["0x12"],
    "transactionsRoot": "0xfb245dae4539ea49812e822adbffa9dd2ee9b3de8f3d9a7d186d351dcc9a6ed4",
    "posReference": "0xd1c2ff79834f86eb4bc98e0e526de475144a13719afba6385cf62a4023c02ae3",
    "baseFeePerGas": "0x4a817c800"
  },
  "id": 1
}

cfx_getBlockByEpochNumber

返回一个区块的信息，该区块由它的纪元号（epoch number）标识。

参数

QUANTITY|TAG - 纪元号，或字符串"latest_mined"、"latest_state"、"latest_confirmed"、"latest_checkpoint"或"earliest"，请参见纪元号参数。
Boolean - 如果为 true，它会返回完整的交易对象。如果为 false，只会返回交易的哈希值。

params: [
    "latest_mined",
    true
]

返回值

查看 cfx_getBlockByhash。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBlockByEpochNumber","params":["latest_mined", false],"id":1}' -H "Content-Type: application/json" localhost:12539

结果参见 cfx_getBlockByHash.

cfx_getBestBlockHash

返回最佳区块的哈希值。

参数

无。

返回值

DATA, 32 Bytes - 最佳区块的哈希值。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBestBlockHash","id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc" : "2.0",
    "result" : "0x7d54c03f4fe971d5c45d95dddc770a0ec8d5bd27d57c049ce8adc469269e35a4",
    "id" : 1
}

cfx_epochNumber

返回给定标签对应的纪元号。

参数

TAG - (可选，默认为 "latest_mined") 字符串 "latest_mined", "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", 详见纪元号参数。

返回值

QUANTITY - 与给定标签对应的整数纪元号。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_epochNumber","params":["latest_mined"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc" : "2.0",
    "result" : "0x49",
    "id" : 1
}

cfx_gasPrice

返回当前每单位gas的价格，单位为Drip。

参数

无。

返回值

QUANTITY - 当前 Gas 价格的整数表示，单位为 Drip。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_gasPrice","id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc" : "2.0",
    "result" : "0x09184e72a000",
    "id" : 1
}

cfx_maxPriorityFeePerGas

返回当前每单位燃气的优先费用，以Drip为单位。

参数

无。

返回值

QUANTITY ，当前每单位燃气的优先费用的整数值，以Drip为单位。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_maxPriorityFeePerGas","id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc" : "2.0",
    "result" : "0x09184e72a000",
    "id" : 1
}

cfx_feeHistory

返回交易的每单位燃气基础费用和有效优先费用，用于请求/支持的纪元范围。

添加自 Conflux-rust v2.4.0 。

参数

QUANTITY：要查询的纪元数量。
QUANTITY|TAG：纪元编号或字符如"latest_state"，"latest_confirmed"，"latest_checkpoint" 或者"earliest"，见纪元编号参数。
Array：单调递增的浮点百分位值列表。对于请求范围内的每个区块，按每单位燃气的有效小费升序排序交易，并确定相应百分位的有效小费，同时考虑消耗的燃气。

返回值

baseFeePerGas：Array-每单位燃气的区块基础费用数组。此数组将包含一个额外的元素。
gasUsedRatio：Array- 一个包含区块燃气使用比率的数组。内容为交易GasLimit总和与区块GasLimit的比率。
oldestEpoch：QUANTITY-返回范围内最小的纪元编号。
reward：Array -请求区块百分位的每单位燃气有效优先费用的二维数组。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_feeHistory", "params": ["0x5", "latest_state", [20, 30]],"id":1}' -H "Content-Type: application/json" localhost:12537

// Result
{
    "jsonrpc": "2.0",
    "result": {
        "baseFeePerGas": [
            "0x3b9aca00",
            "0x3b9aca00",
            "0x3b9aca00",
            "0x3b9aca00",
            "0x3b9aca00",
            "0x3b9aca00"
        ],
        "gasUsedRatio": [
            0.0,
            0.0,
            0.0,
            0.0,
            0.0
        ],
        "oldestEpoch": "0x2a8d0",
        "reward": [
            [
                "0x0",
                "0x0"
            ],
            [
                "0x0",
                "0x0"
            ],
            [
                "0x0",
                "0x0"
            ],
            [
                "0x0",
                "0x0"
            ],
            [
                "0x0",
                "0x0"
            ]
        ]
    },
    "id": "15922956697249514502"
}

cfx_getBlocksByEpoch

返回指定纪元中的区块哈希值。

参数

QUANTITY|TAG - 纪元号，或字符串"latest_mined"、"latest_state"、"latest_confirmed"、"latest_checkpoint"或"earliest"，请参见纪元号参数。

返回值

数组 - 区块哈希的数组，按照它们的执行（拓扑）顺序排序。请注意，最后一个哈希值是主轴哈希。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBlocksByEpoch","params":["0x11"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc": "2.0",
    "result": [
        "0x618e813ed93f1020bab13a1ab77e1550da6c89d9c69de837033512e91ac46bd0",
        "0x0f6ac81dcbc612e72e0019681bcec32254a34bd29a6bbab91e5e8dc37ecb64d5",
        "0xad3238c00456adfbf847d251b004c1e306fe637227bb1b9917d77bd5b207af68",
        "0x0f92c2e796be7b016d8b74c6c270fb1851e47fabaca3e464d407544286d6cd34",
        "0x5bcc2b8d2493797fcadf7b80228ef5b713eb9ff65f7cdd86562db629d0caf721",
        "0x7fcdc6fff506b19a2bd72cd3430310915f19a59b046759bb790ba4eeb95e9956",
        "0xf4f33ed08e1c625f4dde608eeb92991d77fff26122bab28a6b3a2037511dcc83",
        "0xa3762adc7f066d5cb62c683c2655be3bc3405ff1397f77d2e1dbeff2d8522e00",
        "0xba7588476a5ec7e0ade00f060180cadb7430fd1be48940414baac48c0d39556d",
        "0xe4dc4541d07118b598b2ec67bbdaa219eb1d649471fe7b5667a0001d83b1e9b6",
        "0x93a15564544c57d6cb68dbdf60133b318a94439e1f0a9ccb331b0f5a0aaf8049"
    ],
    "id": 1
}

cfx_getBalance

返回给定账户的余额，该账户由它的地址标识。

参数

BASE32 - 用于检查余额的地址，采用 base32 编码。
QUANTITY|TAG|BLOCKHASH_PARAMETER - (optional, default: "latest_state") integer epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter, or the EIP-1898 blockHash parameter.

params: [
   "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
   "latest_state"
]

返回值

QUANTITY - 当前余额的整数表示，单位为 Drip。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBalance","params":["cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc": "2.0",
    "result": "0x0234c8a3397aab58", // 158972490234375000
    "id": 1
}

cfx_getStakingBalance

返回给定账户的质押余额，该账户由它的地址标识。

参数

BASE32 - 用于检查质押余额的地址，采用 base32 编码。
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
   "latest_state"
]

返回值

QUANTITY - 当前抵押金余额的整数表示，以Drip为单位。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getStakingBalance","params":["cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc": "2.0",
    "result": "0x0234c8a3397aab58", // 158972490234375000
    "id": 1
}

cfx_getCollateralForStorage

返回给定地址的抵押存储的大小，单位为字节。

参数

BASE32 - 要检查抵押存储的地址。
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
   "latest_state"
]

返回值

QUANTITY - 以字节为单位的抵押存储的整数。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getCollateralForStorage","params":["cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc": "2.0",
    "result": "0x0234c8a8",
    "id": 1
}

cfx_getAdmin

返回指定合约的管理员。

参数

BASE32 - 合约地址
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
    "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
    "latest_state"
]

返回值

BASE32 - 管理员地址，合约不存在时为 null。

:::注意

虽然没有意义，但也可以使用用户地址作为 cfx_getAdmin 方法的输入参数。在这种情况下，如果输入用户地址存在于世界状态，返回值将为零地址。否则将返回 null。

:::

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getAdmin","params":["cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
  "id": 1
}

cfx_getCode

返回指定合约的代码。如果合约不存在，将返回0x0。

参数

BASE32 - 合约地址
QUANTITY|TAG|BLOCKHASH_PARAMETER - (optional, default: "latest_state") integer epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter, or the EIP-1898 blockHash parameter.

params: [
    "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
    "latest_state"
]

返回值

DAT - 合约的字节码，如果账户没有代码则为 0x。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getCode","params":["cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp","latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "0x6080604052600436106100705760003560e01c80638da5cb5b1161004e5780638da5cb5b14610146578063a035b1fe14610",
  "id": 1
}

cfx_getStorageAt

返回给定合约的存储条目。

参数

BASE32 - 合约地址
QUANTITY - 存储位置 (查看这里获取更多信息)。
QUANTITY|TAG|BLOCKHASH_PARAMETER - (optional, default: "latest_state") integer epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter, or the EIP-1898 blockHash parameter.

params: [
    "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
    "0x100",
    "latest_state"
]

返回值

DATA - 32字节 - 存储位置的内容，如果合约不存在则为null。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getStorageAt","params":["cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp","0x100","latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "0x0000000000000000000000001dbda5dd2e952914bc74a802510d0fa59f9d7636",
  "id": 1
}

cfx_getStorageRoot

返回给定合约的存储根。

参数

BASE32 - 合约地址
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
    "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
    "latest_state"
]

返回值

Object - 存储根对象，如果合约不存在则为null：

delta: DATA，32字节 - 增量字典树中的存储根对象，或字符串 "TOMBSTONE"，或 null。
intermediate: DATA，32字节 - 中间字典树中的存储根对象，或字符串"TOMBSTONE"，或 null。
snapshot: DATA，32字节 - 快照中的存储根对象，或字符串 "TOMBSTONE"，或 null。

如果两次调用此 RPC 的三个字段完全匹配，则保证合同的存储是相同的。如果它们不匹配，则存储很可能已更改（或系统转移到了新的纪元）。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getStorageRoot","params":["cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp","latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "delta": "0x0240a5a3486ac1cee71db22b8e12f1bb6ac9f207ecd81b06031c407663c20a94",
    "intermediate": "0x314a41f277b678a1dc811a1fc0393b6d30c35e900cb27762ec9e9042bfdbdd49",
    "snapshot": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470"
  },
  "id" :1
}

cfx_getSponsorInfo

返回给定合约的赞助者信息。

参数

BASE32 - 合约地址
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
    "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
    "latest_state"
]

返回值

Object - 代付方信息对象。如果合同没有代付方，则返回对象中的所有字段将是 0：

sponsorBalanceForCollateral: QUANTITY - 用于存储的代付余额。
sponsorBalanceForGas: QUANTITY - 燃气的代付余额。
sponsorGasBound: QUANTITY - 可以为一次交易代付的最大燃气。
sponsorForCollateral: BASE32 - 存储代付方的地址。
sponsorForGas: BASE32 - 燃气代付方的地址。
usedStoragePoints: QUANTITY - 已被使用的存储点。
availableStoragePoints: QUANTITY - 可供代付的存储点

Hard fork v2.3 提供了存储点的介绍。详见 CIP-107

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getSponsorInfo","params":["cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "sponsorBalanceForCollateral": "0x0",
    "sponsorBalanceForGas": "0x0",
    "sponsorForCollateral": "CFX:TYPE.NULL:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA0SFBNJM2",
    "sponsorForGas": "CFX:TYPE.NULL:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA0SFBNJM2",
    "sponsorGasBound": "0x0"
  },
  "id": 1
}

cfx_getNextNonce

返回给定账户在发送交易时应该使用的下一个nonce值。

参数

BASE32 - 账户地址。
QUANTITY|TAG|BLOCKHASH_PARAMETER - (optional, default: "latest_state") integer epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter, or the EIP-1898 blockHash parameter.

params: [
    "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
    "latest_state"
]

返回值

QUANTITY - 下一个应被指定地址使用的nonce。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getNextNonce","params":["cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc" : "2.0",
    "result" : "0xe3269d",
    "id" : 1
}

cfx_sendRawTransaction

发送一个已签名的交易到网络中进行处理。

参数

DATA，签名的交易数据。

params: [
    "0xf86eea8201a28207d0830f4240943838197c0c88d0d5b13b67e1bfdbdc132d4842e389056bc75e2d631000008080a017b8b26f473820475edc49bd153660e56b973b5985bbdb2828fceacb4c91f389a03452f9a69da34ef35acc9c554d7b1d63e9041141674b42c3abb1b57b9f83a2d3"
]

返回值

DAT, 32 字节 - 交易哈希。

常见错误

检查发送原始交易错误了解详情。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_sendRawTransaction","params":[{see above}],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc": "2.0",
    "result": "0xf5338a6cb85d10acc9108869f94fe322b2dfa2715d16d264676c91f6a0404b61",
    "id": 1
}

cfx_call

虚拟地调用一个合约，返回输出数据。该交易不会被添加到区块链中。 cfx_call 的错误信息类似于 cfx_estimateGasAndCollatory 错误解决方案可以在 cfx_estimateGasAndCollatory behaviour#error 中找到。

参数

object - 呼叫请求对象：
- from：BASE32 - 发送者地址 (可选，默认：随机地址)。
- to: BASE32 - (可选，默认： null 用于合约创建) 接收者地址。
- gasPrice: QUANTITY - 发送者以 Drip 为单位提供的 gas 价格(可选, 默认: 0)。
- gas: QUANTITY - 发送者以 Drip 为单位提供的 gas 价格(可选，默认: 500000000)。
- value: QUANTITY - 发送者以 Drip 为单位提供的 gas 价格(可选，默认: 0)。
- data: DATA - (可选, 默认: 0x) 与交易一起发送的数据。
- nonce: QUANTITY - (可选, 默认: 0)发送者在此次交易之前所进行的交易数量。
- type：QUANTITY -（可选，默认值：0x0）交易的类型，0x0 表示传统交易，0x1 表示 EIP-2930，0x2 表示 EIP-1559。添加自 Conflux-rust v2.4.0 。
- accessList：ARRAY -（可选，默认值：[]）EIP-2930 访问列表。添加自 Conflux-rust v2.4.0 。
- maxFeePerGas：QUANTITY -（可选，默认值：0)）每单位燃气的最大费用，以 Drip 为单位。添加自 Conflux-rust v2.4.0 。
- maxPriorityFeePerGas：QUANTITY -可选，默认值：0）每单位燃气的最大优先费用，以 Drip 为单位。添加自 Conflux-rust v2.4.0 。
QUANTITY|TAG|BLOCKHASH_PARAMETER - (optional, default: "latest_state") integer epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter, or the EIP-1898 blockHash parameter.

params: [
    {
        "from": "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
        "to": "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
        "data": "0xa6f2ae3a",
        "gasPrice": "0x2540be400",
        "nonce": "0x0"
    },
    "latest_state"
]

返回值

DATA, 字节- 输出数据或执行错误。

示例

// Request
curl -X POST --data '{"method":"cfx_call","id":1,"jsonrpc":"2.0","params":[{"from":"cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg","to":"cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp","data":"0xa6f2ae3a","gasPrice":"0x2540be400","nonce":"0x0"}]}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "0x",
  "id": 1
}

cfx_estimateGasAndCollateral

虚拟地执行一个交易，返回存储抵押和交易使用的gas的大小估计。该交易不会被添加到区块链中。

cfx_estimateGasAndCollatory 接口的响应取决于输入中是否存在特定字段。详情请参阅 cfx_estimateGasAndCollatory。错误原因和解决方案也可以在 cfx_estimateGasAndCollatory behaviour#errors 中找到。

参数

详见 cfx_call。

params: [
    {
        "from": "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
        "to": "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
        "data": "0x",
        "gasPrice": "0x2540be400",
        "nonce": "0x0"
    },
    "latest_state"
]

返回值

object - 估算结果对象：

gasLimit: QUANTITY - 推荐的gas限制。
gasUsed: QUANTITY - 用于执行交易的 gas 。
storageCollateralized: QUANTITY，该交易所需的存储抵押金额。

示例

// Request
curl -X POST --data '{"method":"cfx_estimateGasAndCollateral","id":1,"jsonrpc":"2.0","params":[{"from":"cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg","to":"cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp","data":"0x","gasPrice":"0x2540be400","nonce":"0x0"}]}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "gasLimit": "0x6d60",
    "gasUsed": "0x5208",
    "storageCollateralized": "0x80"
  },
  "id": 1
}

cfx_getLogs

返回与提供的过滤器匹配的日志。

参数

object - 日志过滤对象：
- fromEpoch: QUANTITY|TAG - (可选，默认为: "latest_checkpoint") 纪元号，或字符串 "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", 详见纪元号参数。搜索将从这个纪元号开始应用。
- toEpoch: QUANTITY|TAG - (可选，默认为: "latest_state") 纪元号，或字符串 "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", 详见纪元号参数。搜索将持续到(包括)这个纪元数。
- fromBlock: QUANTITY - (可选，默认为: null)。搜索将从这个的区块号开始应用。
- toBlock: QUANTITY - (可选，默认为: null)。搜索将被应用持续到(包括) 此指定区块。
- blockHashes: Array DATA - (可选，默认为: null)搜索会被应用到最多128个区块哈希的数组。如果不是null，则会覆盖 from/to 纪元字段。
- address: Array of BASE32 - (可选, 默认为: null) 搜索合约地址。如果为 null, 匹配所有。如果指定了，日志必须由这些合约中的一个生成。
- topics: Array - (可选, 默认值: null) 每个主题32个字节。日志可以有 4 个主题：事件签名和最多 3 个索引事件参数。 topics 的元素与相应的日志主题匹配。示例： ["0xA", null, ["0xB", "0xC", 空] 将日志与 "0xA" 匹配为第一个主题和 ("0xB" 或 "0xC")为第三个主题。如果 null, 匹配所有。

params: [
    {
        "fromEpoch": "0x873e12",
        "toEpoch": "0x87431b",
        "address": "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
        "topics": [["0x233e08777131763a85257b15eafc9f96ef08f259653d9944301ff924b3917cf5", "0xd7fb65c06987247ab480a21659e16bdf0b5862a19869ec264075d50ab3525435"], null, "0x0000000000000000000000001d618f9b63eca8faf90faa9cb799bf4bfe616c26"],
    }
]

返回值

Array - 匹配日志对象的数组：

address: BASE32 - 发送日志的合约地址。
topics Array of DATA - 32字节事件主题数组。
data: DATA - 日志数据。
blockHash: DATA - 32 Bytes - 包含日志的区块哈希。
epochNumber: QUANTITY - 包含日志的区块的纪元号
transactionHash: DATA，32 字节 - 创建此日志的交易的哈希。
transactionIndex：QUANTITY - 区块中的交易索引位置。
logIndex: QUANTITY - 区块内的日志索引。
transactionLogIndex: QUANTITY - 交易中的日志索引。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getLogs","params":[{ "fromEpoch": "0x873e12", "toEpoch": "0x87431b", "address": "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp", "topics": [["0x233e08777131763a85257b15eafc9f96ef08f259653d9944301ff924b3917cf5", "0xd7fb65c06987247ab480a21659e16bdf0b5862a19869ec264075d50ab3525435"], null, "0x0000000000000000000000001d618f9b63eca8faf90faa9cb799bf4bfe616c26"], "limit": "0x2" }],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": [{
    "address": "CFX:TYPE.CONTRACT:ACC7UAWF5UBTNMEZVHU9DHC6SGHEA0403Y2DGPYFJP",
    "blockHash": "0x44531df7bad30d39dfaf844e7c7eb44628467e9bd8474d313397c664a1b9fd14",
    "data": "0x0000000000000000000000001d618f9b63eca8faf90faa9cb799bf4bfe616c26",
    "epochNumber": "0x873e12",
    "logIndex": "0x0",
    "topics": [
        "0x233e08777131763a85257b15eafc9f96ef08f259653d9944301ff924b3917cf5",
        "0x000000000000000000000000873c4bd4d847bcf7dc066bf4a7cd31dcf182258c",
        "0x0000000000000000000000001d618f9b63eca8faf90faa9cb799bf4bfe616c26",
    ],
    "transactionHash": "0x7c2536d287c9ac5445f30ccfa067d1f4a2d68d6843f4ba25a5e6d20349367eb3",
    "transactionIndex": "0x0",
    "transactionLogIndex": "0x0"
  }, {
    "address": "CFX:TYPE.CONTRACT:ACC7UAWF5UBTNMEZVHU9DHC6SGHEA0403Y2DGPYFJP",
    "blockHash": "0x82da9c6ef8a93036ac75b176230dd88c8fe1727104ab01878b54180f0fa25638",
    "data": "0x00000000000000000000000019a3224214fe29107d84af9baa02118b614e46d5",
    "epochNumber": "0x87431b",
    "logIndex": "0x0",
    "topics": [
        "0xd7fb65c06987247ab480a21659e16bdf0b5862a19869ec264075d50ab3525435",
        "0x000000000000000000000000873c4bd4d847bcf7dc066bf4a7cd31dcf182258c",
        "0x0000000000000000000000001d618f9b63eca8faf90faa9cb799bf4bfe616c26",
    ],
    "transactionHash": "0xef11f262e31bc7ead1d0880b7c90855eb8f0ef7c26a198e805f2b9f1e9bc938b",
    "transactionIndex": "0x0",
    "transactionLogIndex": "0x0"
  }],
  "id": 1
}

cfx_getTransactionReceipt

返回一个交易收据，由相应的交易哈希值标识。

参数

DATA，32 字节 - 交易的哈希。

params: [
    "0x53fe995edeec7d241791ff32635244e94ecfd722c9fe90f34ddf59082d814514",
]

返回值

Object - 交易收据对象，当没有发现交易或交易尚未执行时为 null ：

type：QUANTITY ，交易的类型，0x0 表示传统交易，0x1 表示 EIP-2930，0x2表示 EIP-1559。添加自 Conflux-rust v2.4.0 。
transactionHash: DATA，32 字节 - 给定交易的哈希值。
index：QUANTITY - 交易在块中的索引。
blockHash: DATA，32 字节，包含并执行了这个交易的区块的哈希。
epochNumber：QUANTITY - 包含该交易的块所在的epoch编号，该交易在该epoch中被执行。
from: BASE32 - 发送者的地址。
to: BASE32 - 接收者的地址。 null 当它是一个合约部署交易时为 null
gasUsed: QUANTITY - 用于执行交易的 gas 用量。
gasFee: QUANTITY - 消息发送者账户被收取的 gas 费用。如果提供的 gas（gas limit）大于使用的 gas，则最多可以退还其中的 1/4。
gasCoveredBySponsor: Boolean，如果该交易的gas费被代付，则为true。
storageCollateralized: QUANTITY，该交易所需的存储抵押金额。
storageCoveredBySponsor: Boolean，如果此交易的存储抵押已被代付，则为真。
storageReleased: Array，包含多个存储释放的对象，每个对象包含一个地址和相应的存储抵押品数量，例如：[{ 'address': 'CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG', 'collaterals': '0x280' }]。
contractCreated: BASE32，创建的合约的地址。 null 当它不是一个合约部署交易时为 null
stateRoot: DATA，32字节 - 在对应区块执行之后的状态根的哈希值。如果状态根不可用，即为0 。
outcomeStatus: QUANTITY - 结果状态代码 0x0 表示成功。 0x1 表示失败。 0x2 表示已被跳过
logsBloom：DATA，256 字符 - 轻节点用于快速检索相关日志的布隆过滤器。
logs: Array - 交易生成的日志对象数组，见 cfx_getLogs。
txExecErrorMsg: String, 交易执行故障消息，如果交易执行成功将为空。
effectiveGasPrice：QUANTITY，交易的有效燃气价格。添加自 Conflux-rust v2.4.0 。
burntGasFee：QUANTITY，交易的烧毁燃气费用。添加自 Conflux-rust v2.4.0 。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getTransactionReceipt","params":["0x53fe995edeec7d241791ff32635244e94ecfd722c9fe90f34ddf59082d814514"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "blockHash": "0xbb1eea3c8a574dc19f7d8311a2096e23a39f12e649a20766544f2df67aac0bed",
    "contractCreated": null,
    "epochNumber": "0x87431b",
    "from": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
    "gasCoveredBySponsor": true,
    "gasFee": "0x108ca",
    "gasUsed": "0x8465",
    "index": "0x0",
    "logs": [{
      "address": "CFX:TYPE.CONTRACT:ACC7UAWF5UBTNMEZVHU9DHC6SGHEA0403Y2DGPYFJP",
      "data": "0x00000000000000000000000019a3224214fe29107d84af9baa02118b614e46d5",
      "topics": ["0x233e08777131763a85257b15eafc9f96ef08f259653d9944301ff924b3917cf5"]
    }],
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000080000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000",
    "outcomeStatus": "0x0",
    "stateRoot": "0x1bc37c63c03d7e7066f9427f69e515988d19ebb26998087d75b50d2235e55ee7",
    "storageCollateralized": "0x40",
    "storageCoveredBySponsor": true,
    "storageReleased": [{
      "address": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
      "collaterals": "0x40"
    }],
    "to": "CFX:TYPE.CONTRACT:ACC7UAWF5UBTNMEZVHU9DHC6SGHEA0403Y2DGPYFJP",
    "transactionHash": "0x53fe995edeec7d241791ff32635244e94ecfd722c9fe90f34ddf59082d814514",
    "txExecErrorMsg": null
  },
  "id": 1
}

cfx_getAccount

返回一个账户，由它的地址标识。

参数

BASE32 - 账户地址。
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
   "latest_state"
]

返回值

Object - 给定账户的状态：

from: BASE32 - 账户地址。
balance: QUANTITY - 账户余额。
nonce: QUANTITY - 帐户下一次交易的随机数。
codeHash: DATA - 账户的字节码哈希。
stakingBalance: QUANTITY - 账户质押余额。
collateralForStorage: QUANTITY - 账户的抵押存储。
accumulatedInterestReturn: QUANTITY - 账户累计的利息回报。
admin: BASE32 - 账户的管理员。

示例

// Request
curl --data '{"jsonrpc":"2.0","method":"cfx_getAccount","params":["cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "accumulatedInterestReturn": "0x0",
    "admin": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
    "balance": "0x0",
    "codeHash": "0x45fed62dd2b7c5ed76a63628ddc811e69bb5770cf31dd55647ca219aaee5434f",
    "collateralForStorage": "0x0",
    "nonce": "0x1",
    "stakingBalance": "0x0"
  },
  "id": 1
}

cfx_getInterestRate

返回给定纪元的利率。

参数

QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "latest_state"
]

返回值

QUANTITY - 在给定纪元的利率。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getInterestRate","params":["latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "0x24b675dc000",
  "id": 1
}

cfx_getAccumulateInterestRate

返回给定纪元的累积利率。

参数

QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "latest_state"
]

返回值

QUANTITY - 在给定纪元的累计利率。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getAccumulateInterestRate","params":["latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "0x3c35a9e557dc9ef76719db0226f",
  "id": 1
}

cfx_checkBalanceAgainstTransaction

检查用户的余额是否足够发送一个带有指定gas和存储限制的交易到指定合约。如果用户可以支付执行和存储的预付款，或者这些费用由合约赞助，那么余额就足够了。

参数

BASE32, 帐户地址
BASE32, 合约地址
QUANTITY, 交易的燃气上限
QUANTITY, 燃气价格
QUANTITY, 存储限制
QUANTITY|TAG - (可选，默认为"latest_state") 为整数纪元号，或字符串如 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
  "cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg",
  "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
  "0x5208",
  "0x2540be400",
  "0x0",
  "0xbf63"
]

返回值

isBalanceEnough: Boolean - 表示余额足以支付燃气费和抵押存储。
willPayCollateral: Boolean - 如果交易符合存储抵押代付的条件，则为false；否则为true。
willPayTxFee: Boolean - 如果交易符合燃气代付的条件，则为false；否则为true。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_checkBalanceAgainstTransaction","params":["cfx:type.user:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg", "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp", "0x5208", "0x2540be400", "0x0", "0xbf63"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "isBalanceEnough": true,
    "willPayCollateral": true,
    "willPayTxFee": true
  },
  "id": 1
}

cfx_getSkippedBlocksByEpoch

返回一个纪元中未执行的区块列表。默认情况下，Conflux每个纪元只执行最后200个区块（请注意，在正常情况下，纪元应该要小得多）。

参数

QUANTITY|TAG - 整数纪元号，或字符串如"latest_mined"、"latest_state"、"latest_confirmed"、"latest_checkpoint"或 "earliest"，请参见纪元号参数。

params: [
  "0xba28"
]

返回值

Array - 区块哈希

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getSkippedBlocksByEpoch","params":["0xba28"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": [],
  "id": 1
}

cfx_getConfirmationRiskByHash

返回给定区块的确认风险，该区块通过其哈希值标识。

参数

DATA, 32 字节 - 区块哈希。

params: [
  "0x3912275cf09f8982a69735a876c14584dae95078762090c5d32fdf0dbec0647c"
]

返回值

QUANTITY, 以整形返回的给定区块确认风险, 若区块不存在即返回 null 。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getConfirmationRiskByHash","params":["0x3912275cf09f8982a69735a876c14584dae95078762090c5d32fdf0dbec0647c"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": "0x2af31dc4611873bf3f70834acdae9f0f4f534f5d60585a5f1c1a3ced1b",
  "id": 1
}

cfx_getStatus

返回节点状态。

参数

无。

返回值

bestHash: DATA - 最新纪元主区块的哈希
blockNumber: QUANTITY - 区块总数
chainId: QUANTITY - 链ID
networkId: QUANTITY - 网络ID
ethereumSpaceChainId: QUANTITY - eSpace的链ID（从v2.0添加）
epochNumber: QUANTITY - 最新纪元编号
latestCheckpoint: QUANTITY - 最新检查点纪元编号
latestConfirmed: QUANTITY - 最新确认纪元编号
latestFinalized: QUANTITY - 最新终结纪元编号（从v2.0添加）
latestState: QUANTITY - 最新状态纪元编号
pendingTxNumber: QUANTITY - 当前待处理纪元数

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getStatus","id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "bestHash": "0xe4bf02ad95ad5452c7676d3dfc2e57fde2a70806c2e68231c58c77cdda5b7c6c",
    "chainId": "0x1",
    "networkId": "0x1",
    "blockNumber": "0x1a80325",
    "epochNumber": "0xaf28ab",
    "latestCheckpoint": "0xada520",
    "latestConfirmed": "0xaf2885",
    "latestState": "0xaf28a7",
    "latestFinalized": "0x2a420c",
    "ethereumSpaceChainId": "0x22b9",
    "pendingTxNumber": "0x0"
  },
  "id": 1
}

cfx_clientVersion

返回conflux-rust版本。

参数

无。

返回值

STRING - 客户端版本

示例

//Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_clientVersion","id":1}' -H "Content-Type: application/json" localhost:12539

//Result
{
  "jsonrpc": "2.0",
  "result": "conflux-rust-0.6.3",
  "id": 1
}

cfx_getBlockRewardInfo

返回指定纪元中所有已执行区块的奖励信息。

参数

QUANTITY|TAG - 整数纪元编号，或字符串 "latest_checkpoint", 参见纪元编号参数

params: [
  "0x5ee248"
]

请注意，奖励计算可能会有延迟，因此最近几个纪元（包括"latest_state"）的奖励信息可能不可用。

返回值

Array - 奖励信息对象的数组

blockHash: DATA - 区块哈希
author: BASE32 - 挖得区块的矿工地址
totalReward: QUANTITY - 区块的总奖励，包括基础奖励、交易费、质押奖励
baseReward: QUANTITY - 基础奖励
txFee: QUANTITY - 交易费

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBlockRewardInfo","params":["0x5ee248"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": [
    {
      "author": "CFX:TYPE.USER:AARC9ABYCUE0HHZGYRR53M6CXEDGCCRMMYYBJGH4XG",
      "baseReward": "0x9ccda666a9516000",
      "blockHash": "0xa4a409ea5f1d31e787cd5e20a3eec1fd43851d29608d2de98fb127f518e1a211",
      "totalReward": "0x9ccdca639a29ece1",
      "txFee": "0x0"
    }
  ],
  "id": 1
}

cfx_getBlockByHashWithPivotAssumption

如果提供的主区块哈希正确，则返回请求的区块；否则返回错误。

参数

DATA, 区块哈希
DATA, 提供的主区块哈希
QUANTITY, 整数纪元号

params: [
   "0x3912275cf09f8982a69735a876c14584dae95078762090c5d32fdf0dbec0647c",
   "0x3912275cf09f8982a69735a876c14584dae95078762090c5d32fdf0dbec0647c",
   "0xba28"
]

返回值

查看 cfx_getBlockByhash。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBlockByHashWithPivotAssumption","params":["0x3912275cf09f8982a69735a876c14584dae95078762090c5d32fdf0dbec0647c", "0x3912275cf09f8982a69735a876c14584dae95078762090c5d32fdf0dbec0647c", "0xba28"],"id":1}' -H "Content-Type: application/json" localhost:12539

结果参见 cfx_getBlockByHash.

cfx_getDepositList

返回通过地址识别的指定账户的质押列表。

参数

BASE32 - 账户地址。
QUANTITY|TAG - (可选，默认为"latest_state")整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u",
   "latest_state"
]

返回值

Array - 存款信息对象的数组：

accumulatedInterestRate: QUANTITY - 存款时的累积利率。
amount: QUANTITY - 质押的代币数量
depositTime: QUANTITY - 质押时间

示例

// Request
curl --data '{"jsonrpc":"2.0","method":"cfx_getDepositList","params":["cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": [{
    "accumulatedInterestRate": "0x3c4517ac75006c913c52c2402e8",
    "amount": "0x8ac7230489e80000",
    "depositTime": 3135949
  }, {
    "accumulatedInterestRate": "0x3c451870afdac66f40804d95742",
    "amount": "0x8ac7230489e80000",
    "depositTime": 3136255
  }],
  "id": 1
}

cfx_getVoteList

返回给定地址账户的投票列表。

参数

BASE32 - 账户地址。
QUANTITY|TAG - （可选，默认为"latest_state"）整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。

params: [
   "cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u",
   "latest_state"
]

返回值

Array - 投票信息对象的数组：

amount: QUANTITY - 锁定的代币数量。
unlockBlockNumber: QUANTITY - 锁定的代币释放的区块编号。

要获取当前区块编号，请参考conflux-rust#1973。

示例

// Request
curl --data '{"jsonrpc":"2.0","method":"cfx_getVoteList","params":["cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u", "latest_state"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": [{
    "amount": "0x8ac7230489e80000",
    "unlockBlockNumber": 1000000000000
  }],
  "id": 1
}

cfx_getSupplyInfo

返回整个链的供应总览信息。

参数

无。

返回值

Object - 包含供应总览信息的对象。

totalIssued: QUANTITY - Drip单位下发行的总CFX数量。
totalCollateral: QUANTITY - Drip单位下存储抵押的总CFX数量。
totalStaking: QUANTITY - Drip单位下的总抵押CFX数量。
totalCirculating: QUANTITY - 总流通量： TotalIssued - FourYearUnlock - TwoYearUnlock
totalEspaceTokens: QUANTITY - Drip单位下的eSpace CFX总量（添加于Conflux-Rust v2.0.1版本）。

示例

// Request
curl --data '{"jsonrpc":"2.0","method":"cfx_getSupplyInfo","params":[],"id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
  "jsonrpc": "2.0",
  "result": {
    "totalCirculating": "0x1ed09beade67915041ca95cb0ea3b",
    "totalCollateral": "0x2b95bdcc39b610000",
    "totalIssued": "0x1ed09ced5cda57e32eec33328ea3b",
    "totalStaking": "0x56bc75e2d63100000"
  },
  "id": "15922956697249514502"
}

cfx_getAccountPendingInfo

返回一个账户的交易池中待处理信息。

参数

BASE32 - 账户地址。

params: [
    "cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u"
]

返回值

Object - 包含账户的待处理信息的对象。

localNonce: QUANTITY - 用户的交易池nonce，可用于下一笔交易。
pendingNonce: QUANTITY - 用户当前的待处理交易nonce。
pendingCount: QUANTITY - 待处理交易的数量。
nextPendingTx: DATA - 下一个待处理交易的哈希值。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getAccountPendingInfo","params":["cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Response
{
    "jsonrpc": "2.0",
    "result": {
        "localNonce": "0x1ed",
        "nextPendingTx": "0x0000000000000000000000000000000000000000000000000000000000000000",
        "pendingCount": "0x0",
        "pendingNonce": "0x0"
    },
    "id": "15922956697249514502"
}

cfx_getAccountPendingTransactions

返回一个账户在交易池中的待处理交易。

参数

BASE32 - 账户地址。
[QUANTITY] - 可选参数，起始nonce，用于返回相应的交易。
[QUANTITY] - 可选参数，待处理交易的返回限制数量（limit）。

params: [
    "cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u"
]

返回值

Object - 包含账户的待处理交易信息的对象。

firstTxStatus: OBJECT - 一个只有一个字段pending的对象，它的值是第一个挂起交易的状态。只有三种情况：futureNonce、notEnoughCash。或者只是一个字符串 ready。
pendingCount: QUANTITY - 挂起交易的数量
pendingTransactions: ARRAY - 挂起交易的交易数组

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getAccountPendingTransactions","params":["cfx:aan02vpwvz8crpa1n10j17ufceefptdc2yzkagxk5u"],"id":1}' -H "Content-Type: application/json" localhost:12539

// Response
{
    "jsonrpc": "2.0",
    "result": {
        "firstTxStatus": {
            "pending": "futureNonce"
        },
        "pendingCount": "0x1",
        // Reference transaction example
        "pendingTransactions": [
            {
                "...": "..."
            }
        ]
    },
    "id": "15922956697249514502"
}

cfx_getBlockByBlockNumber

返回由其块编号（块的树图顺序号）标识的区块的信息。

添加于

Conflux-rust v1.1.5

参数

QUANTITY - 区块编号。
Boolean - 如果 true，返回完整的交易对象。如果为 false，只会返回交易的哈希值。

params: [
    "0x1000",
    true
]

返回值

查看 cfx_getBlockByhash。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getBlockByBlockNumber","params":["0x1000", false],"id":1}' -H "Content-Type: application/json" localhost:12539

结果参见 cfx_getBlockByHash.

cfx_getPoSEconomics

返回 PoS 经济总结信息。

添加于

Conflux-rust v2.0.0

参数

[QUANTITY] - (可选的，默认值："latest_state") 整数纪元编号，或字符串"latest_state"、"latest_confirmed"、"latest_checkpoint"或"earliest"，请参见epoch number parameter。

返回值

distributablePosInterest: QUANTITY 可分配的 PoS 利息总额（单位为 Drip）
lastDistributeBlock: QUANTITY 可分配的 PoS 利息的最后一个块
totalPosStakingTokens: QUANTITY 在 PoS 中质押的总代币数（单位为 Drip）

示例

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw ' {
    "jsonrpc": "2.0",
    "id": "15922956697249514502",
    "method": "cfx_getPoSEconomics",
    "params": []
  }'

{
    "jsonrpc": "2.0",
    "result": {
        "distributablePosInterest": "0x6fd7fd91140603a45caff2",
        "lastDistributeBlock": "0x100",
        "totalPosStakingTokens": "0x29cbb85e5a6e849c00000"
    },
    "id": "15922956697249514502"
}

cfx_getPoSRewardByEpoch

通过对应的 PoW epoch编号，获取 PoS epoch的奖励信息。只有在 PoS epoch结束时发生的 PoW epoch才会有奖励信息。其他将返回空值（null）。

添加于

Conflux-rust v2.0.0

参数

QUANTITY: PoW epoch编号

params: [
  "0x4a"
]

返回值

accountRewards: Array，其中包含 AccountReward 的信息
powEpochHash: HASH - 在奖励产生时的 PoW 区块的哈希值

账户奖励

posAddress: ADDRESS - PoS 账户地址
powAddress: BASE32 - PoW 账户地址
reward: QUANTITY - 奖励数量，以 Drip 为单位

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_getPoSRewardByEpoch",
    "params": ["0x4a"]
}'

响应

{
    "jsonrpc": "2.0",
    "result": {
        "accountRewards": [
            {
                "posAddress": "0x459b19e745eb410c3696ff1ed15f9de9bb46aa5fefc27b0b6e8b8d7aaadfe8c0",
                "powAddress": "NET8888:TYPE.USER:AAKSNR7XKKFFAM17MNESKAGU076T8FAG3YJ6PTHN16",
                "reward": "0x14931d20aa21eae3e6f"
            },
            {
                "posAddress": "0x046ca462890f25ed9394ca9f92c979ff48e1738a81822ecab96d83813c1a433c",
                "powAddress": "NET8888:TYPE.USER:AAPXUPNXG96GZ4077DAV0151K7P8498N9A6DMAWK1N",
                "reward": "0x2d49549e023888cd390"
            }
        ],
        "powEpochHash": "0x361cb0f19fd13c30da467d20a84ef01aabcd55e9812c5e2fd0721ea11a52e9f1"
    },
    "id": 1
}

cfx_getParamsFromVote

返回DAO投票参数信息。

添加于

Conflux-rust v2.1.0

参数

QUANTITY: (可选的，默认值："latest_state") 整数纪元编号，或字符串"latest_state"、"latest_confirmed"、"latest_checkpoint"或"earliest"，请参见epoch number parameter。

params: [
  "0x4a"
]

返回值

powBaseReward: QUANTITY - PoW 基本奖励金额
interestRate: QUANTITY - PoS 利率
storagePointProp: QUANTITY - 整数参数，确定将转换为存储点的赞助存储的比例。该比例的计算公式为： storagePointProp / (storagePointProp + 10**18).
baseFeeShareProp: QUANTITY - 整数参数，确定将奖励给矿工的交易基础费用的比例。从 Conflux-rust v2.4.0 开始添加。该比例的计算公式为： baseFeeShareProp / (baseFeeShareProp + 10**18).

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_getParamsFromVote",
    "params": []
}'

响应

{
    "jsonrpc": "2.0",
    "result": {
        "powBaseReward": "0xdeeb372cab9eb32",
        "interestRate": "0x9f69",
        "storagePointProp": "0xde0b6b3a7640000",
        "baseFeeShareProp": "0xde0b6b3a7640000"
    },
    "id": 1
}

cfx_newFilter

该函数创建一个用于跟踪使用情况的日志过滤器。它返回一个日志过滤器ID，可以通过cfx_getFilterChanges 命令使用，以检索从最近执行的交易中新生成的日志。在这种情况下，该 RPC（远程过程调用）将忽略上下文中的 from 字段。此函数还可以通过cfx_getFilterLogs 使用，以检索与过滤器条件匹配的所有日志。在这种情况下， from* 字段会被考虑。

需要注意的是，该过滤器对象将在最后一次请求后的一段时间内处于不活动状态后过期，通常为60秒。这个过期持续时间由节点配置。为了避免丢失日志跟踪，建议根据需要刷新或重新创建过滤器。

参数

object - 日志过滤对象：
- fromEpoch: QUANTITY|TAG - (可选，默认为"latest_checkpoint")整数纪元号，或字符串 "latest_state"、"latest_confirmed"、"latest_checkpoint" 或 "earliest"，详见纪元号参数。需要搜索的起始纪元需要注意的是，[cfx_getFilterChanges] 将忽略此参数。
- toEpoch: QUANTITY|TAG - (可选，默认为: "latest_state") 纪元号，或字符串 "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", 详见纪元号参数。搜索将持续到(包括)这个纪元数。
- fromBlock: QUANTITY - (可选，默认为: null)。 The start block to search. 需要注意的是，[cfx_getFilterChanges] 将忽略此参数。
- toBlock: QUANTITY - (可选，默认为: null)。搜索将被应用持续到(包括) 此指定区块。
- blockHashes: Array DATA - (可选，默认为: null)搜索会被应用到最多128个区块哈希的数组。如果不是null，则会覆盖 from/to 纪元字段。
- address: Array of BASE32 - (可选, 默认为: null) 搜索合约地址。如果为 null, 匹配所有。如果指定了，日志必须由这些合约中的一个生成。
- topics: Array - (可选, 默认值: null) 每个主题32个字节。日志可以有 4 个主题：事件签名和最多 3 个索引事件参数。 topics 的元素与相应的日志主题匹配。示例： ["0xA", null, ["0xB", "0xC", 空] 将日志与 "0xA" 匹配为第一个主题和 ("0xB" 或 "0xC")为第三个主题。如果为 null, 匹配所有。

params: [
    {
        "fromEpoch": "0x873e12",
        "toEpoch": "0x87431b",
        "address": "cfx:type.contract:acc7uawf5ubtnmezvhu9dhc6sghea0403y2dgpyfjp",
        "topics": [["0x233e08777131763a85257b15eafc9f96ef08f259653d9944301ff924b3917cf5", "0xd7fb65c06987247ab480a21659e16bdf0b5862a19869ec264075d50ab3525435"], null, "0x0000000000000000000000001d618f9b63eca8faf90faa9cb799bf4bfe616c26"],
    }
]

返回值

QUANTITY - 日志过滤器对象的 id。

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_newFilter",
    "params": ["fromEpoch": "0x873e12"]
}'

响应

{
    "jsonrpc": "2.0",
    "result": "0x09294f7b3b63b52d3771fcafb7b7ed61",
    "id": 1
}

cfx_newBlockFilter

Create a block filter for following up usage. 返回区块过滤器ID，可通过 cfx_getFilterChanges 使用以检索最近执行的区块。

参数

无。

返回值

QUANTITY - 区块过滤器对象的ID。

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_newBlockFilter",
    "params": []
}'

响应

{
    "jsonrpc": "2.0",
    "result": "0x09294f7b3b63b52d3771fcafb7b7ed61",
    "id": 1
}

cfx_newPendingTransactionFilter

创建一个用于跟踪待处理交易的过滤器。返回交易过滤器ID，可以通过 cfx_getFilterChanges 使用以检索 准备好但尚未执行 的交易。

:::注意

所创建的过滤器仅会过滤出准备好的交易，这意味着具有未来随机数的待处理交易将永远不会通过相应的 cfx_getFilterChanges 列出。

:::

此外，需要注意的是，该过滤器对象将在最后一次请求后的一段时间内处于不活动状态后过期，通常为60秒。这个过期持续时间由节点配置。为了避免丢失日志跟踪，建议根据需要刷新或重新创建过滤器。

参数

无。

返回值

QUANTITY - 待处理交易过滤器对象的ID。

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_newPendingTransactionFilter",
    "params": []
}'

响应

{
    "jsonrpc": "2.0",
    "result": "0x09294f7b3b63b52d3771fcafb7b7ed61",
    "id": 1
}

cfx_getFilterChanges

获取自上次检索以来的过滤器变化。返回值取决于提供的过滤器ID的类型。过滤器ID可以从当前RPC中返回：

cfx_newFilter: new logs generated from newly executed transactions matching the filter. 需要注意的是，此RPC将忽略 from* 字段。
cfx_newBlockFilter：新执行的区块。
cfx_newPendingTransactionFilter: new pending transactions which are ready to execute.

:::注意

所创建的过滤器仅会过滤出准备好的交易，这意味着具有未来随机数的待处理交易将永远不会通过相应的 cfx_getFilterChanges 列出。

:::

参数

QUANTITY - 过滤器ID。

params: [
  "0x09294f7b3b63b52d3771fcafb7b7ed61"
]

返回值

Array - array of log receipts (same format as cfx_getLogs return value), block hashes, or transaction hashes depending on the input.

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_getFilterChanges",
    "params": [0x09294f7b3b63b52d3771fcafb7b7ed61]
}'

响应

{
    "jsonrpc": "2.0",
    "result": ["0xcc103077ede14825a5667bddad79482d7bbf1f1a658fed6894fa0e9287fc6be1"],
    "id": 1
}

cfx_getFilterLogs

返回匹配日志过滤器的所有日志（与 cfx_getFilterChanges 不同，from* 字段仍然有效）。

参数

QUANTITY - 过滤器ID。

params: [
  "0x09294f7b3b63b52d3771fcafb7b7ed61"
]

返回值

Array - array of log receipts (same as cfx_getLogs).

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_getFilterLogs",
    "params": [0x09294f7b3b63b52d3771fcafb7b7ed61]
}'

响应

请参阅 cfx_getLogs

cfx_uninstallFilter

卸载指定的过滤器。返回一个布尔值，指示卸载是否成功。

参数

QUANTITY - 过滤器ID。

params: [
  "0x09294f7b3b63b52d3771fcafb7b7ed61"
]

返回值

Boolean - 卸载是否成功。

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_uninstallFilter",
    "params": [0x09294f7b3b63b52d3771fcafb7b7ed61]
}'

响应

{
    "jsonrpc" : "2.0",
    "result" : true,
    "id" : 1
}

cfx_getEpochReceipts

返回特定纪元内的所有交易收据。

备注

公共RPC端点运行在Confura之上，如果提供了api密钥，则支持此方法。对于普通节点，此方法也受支持，但只能在本地环境中访问。

参数

QUANTITY|TAG|BLOCKHASH_PARAMETER - the epoch number, or the string "latest_state", "latest_confirmed", "latest_checkpoint" or "earliest", see the epoch number parameter, or the EIP-1898 blockHash parameter.
Boolean - whether eSpace transaction receipts will be included in the return value, defaults to false.

params: [
    "0x1000",
    true
]

返回值

null if the epoch is not executed, otherwise Array - a two-dimensional array of transaction receipts. Each sub-array represents transactions within a block. Noting an extra field of space will be added to each transaction receipt if the second parameter is set to true. The value of space will be either native meaning this is a core space transaction receipt or evm meaning the transaction is from eSpace.

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_getEpochReceipts",
    "params": ["0x1000", true]
}'

响应

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    [],
    [
      {
        "transactionHash": "0x386442f263e3d4b382f97efe577e3bb5956872a322936b8581133be4ec392153",
        "index": "0x0",
        "blockHash": "0x6ebb905fbfcc80506080e639b80d7bc696dab2f6168e01daedf3c15597987da2",
        "epochNumber": "0x7e6f164",
        "from": "cfxtest:aakvz2e5nt82c9nvbbg84hzbrjy53nsdf20ng5wuj1",
        "to": "cfxtest:acbpnfz9mu42a6ubhdcyadj04m2w8wt6sex7atgyg6",
        "gasUsed": "0x15a1b",
        "accumulatedGasUsed": "0x15a1b",
        "gasFee": "0x50957e574e00",
        "contractCreated": null,
        "logs": [],
        "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
        "stateRoot": "0x6ef7bcc4d8cb7c777a587a22002930c5d44e62e1047043c44dd44f89d16e462d",
        "outcomeStatus": "0x0",
        "txExecErrorMsg": null,
        "gasCoveredBySponsor": false,
        "storageCoveredBySponsor": false,
        "storageCollateralized": "0x0",
        "storageReleased": [],
        "space": "native"
      }
    ]
  ]
}

cfx_getCollateralInfo

返回当前链的质押物状态信息。

参数

QUANTITY|TAG - (可选, 默认值为: "latest_state") 为整数纪元号, 或字符串如 ``"latest_state","latest_confirmed","latest_checkpoint"or"earliest"`, 详见纪元号参数。

params: [
    "latest_state",
]

返回值

Object - 链的存储抵押信息对象。

totalStorageTokens
convertedStoragePoints - 全链的转换存储节点数
usedStoragePoints - 已用于代付的存储节点数

示例

请求

curl --location --request POST 'http://localhost:12537' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "cfx_getCollateralInfo",
    "params": ["latest_executed"]
}'

响应

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "totalStorageTokens": "0x12c6e8ec75a2740998000",
    "convertedStoragePoints": "0x485ec66",
    "usedStoragePoints": "0x290bc0"
  }
}

cfx_getFeeBurnt

返回1559交易机制下烧毁的总交易燃气费用。从 Conflux-rust v2.4.0 开始添加。

参数

无。

返回值

QUANTITY：1559机制下烧毁的总交易燃气费用，以Drip为单位。

示例

// Request
curl -X POST --data '{"jsonrpc":"2.0","method":"cfx_getFeeBurnt","id":1}' -H "Content-Type: application/json" localhost:12539

// Result
{
    "jsonrpc" : "2.0",
    "result" : "0x09184e72a000",
    "id" : 1
}

JSON-RPC规范说明​

惯例​

十六进制值编码​

数值​

未格式化的数据​

Base32 地址​

默认的 epochNumber （纪元数） 参数​

遵循 EIP-1898 的Conflux epochNumber 参数​

CURL 请求示例​

状态和交易可用性​

从以太坊 JSON-RPC 迁移​

GOSSIP, STATE, HISTORY​

Gossip 方法​

State 方法​

History 方法​

JSON-RPC 方法​

cfx_getTransactionByHash​

参数​

返回值​

示例​

cfx_getBlockByHash​

参数​

返回值​

示例​

cfx_getBlockByEpochNumber​

参数​

返回值​

示例​

cfx_getBestBlockHash​

参数​

返回值​

示例​

cfx_epochNumber​

参数​

返回值​

示例​

cfx_gasPrice​

参数​

返回值​

示例​

cfx_maxPriorityFeePerGas​

参数​

返回值​

示例​

cfx_feeHistory​

参数​

返回值​

示例​

cfx_getBlocksByEpoch​

参数​

返回值​

示例​

cfx_getBalance​

参数​

返回值​

示例​

cfx_getStakingBalance​

参数​

返回值​

示例​

cfx_getCollateralForStorage​

参数​

返回值​

示例​

cfx_getAdmin​

参数​

返回值​

示例​

cfx_getCode​

参数​

返回值​

示例​

cfx_getStorageAt​

参数​

返回值​

示例​

cfx_getStorageRoot​

参数​

返回值​

示例​

JSON-RPC规范说明

惯例

十六进制值编码

数值

未格式化的数据

Base32 地址

默认的 epochNumber （纪元数）参数

遵循 EIP-1898 的Conflux epochNumber 参数

CURL 请求示例

状态和交易可用性

从以太坊 JSON-RPC 迁移

GOSSIP, STATE, HISTORY

Gossip 方法

State 方法

History 方法

JSON-RPC 方法

cfx_getTransactionByHash

参数

返回值

示例

cfx_getBlockByHash

参数

返回值

示例

cfx_getBlockByEpochNumber

参数

返回值

示例

cfx_getBestBlockHash

参数

返回值

示例

cfx_epochNumber

参数

返回值

示例

cfx_gasPrice

参数

返回值

示例

cfx_maxPriorityFeePerGas

参数

返回值

示例

cfx_feeHistory

参数

返回值

示例

cfx_getBlocksByEpoch

参数

返回值

示例

cfx_getBalance

参数

返回值

示例

cfx_getStakingBalance

参数

返回值

示例

cfx_getCollateralForStorage

参数

返回值

示例

cfx_getAdmin

参数

返回值

示例

cfx_getCode

参数

返回值

示例

cfx_getStorageAt

参数

返回值

示例

cfx_getStorageRoot

参数

返回值

示例