DBC-Blockchain 主网 RPC 说明

1. RPC 说明

1.1 适用版本

文档适用 dbc 主网，主网分支master，

• websocket 地址： wss://info.dbcwallet.io,

• http 地址: https://httpinfo.dbcwallet.io

1.2 搭建自己的 RPC 节点

除了使用 DBC 提供的websocket接口，还可以自己搭建同步节点使用自己的节点提供的websocket或HTTP接口获取数据。

# 配置Rust编译环境
curl https://getsubstrate.io -sSf | bash -s -- --fast
source ~/.cargo/env

# 编译dbc-chain
git clone https://github.com/DeepBrainChain/DeepBrainChain-MainChain.git && cd DeepBrainChain-MainChain
git checkout v2.3
cargo build --release

# 运行同步节点：
./target/release/dbc-chain --base-path ./db_data --pruning archive --rpc-cors all --no-mdns

# 端口参数：
--rpc-port 9933   # 指定你的节点监听RPC的端口。 9933 是默认值，因此该参数也可忽略
--ws-port 9945    # 指定你的节点用于监听 WebSocket 的端口。 默认端口为 9944
--port 30333      # 指定你用于监听 p2p 流量的节点端口。 30333 是默认端口，若无需更改，可以忽略该 flag

如上方法运行了同步节点之后，可以通过 ws://127.0.0.1:9945 调用 websocket 接口，通过http://127.0.0.1:9933 调用 http 接口。

如果想远程访问，需要为 websocket 或 http 配置域名，以支持 wss 或者 https

使用 HTTP 接口获取数据的例子，可以查看本文件夹下的dbc_chain_rpc.postman_collection.json，导入 Postman 进行查看。

1.3 RPC 请求格式

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": method_name,
  "params": [params_1, params_2, ...]
}

其中，method_name 为 RPC 方法名，params_1, params_2... 替换成需要的参数。

例如，利用 Postman 连接 websocket 查询区块信息：

Postman 创建 websocket API 的方法：https://blog.postman.com/postman-supports-websocket-apis/

image-20211020111401731

1.4 如何访问链上历史数据

在 1.3 中，获取到的数据为链上的当前状态。如果想获取过去某个时间的状态，需要传入某个时间对应区块的 Hash。

如想要查看两天前的数据，在发送 post 请求的"params" 字段的最后一个参数添加两天前的区块 Hash 即可。

1.5 未包含的 RPC 文档

本文档仅包含 DBC 主网 自定义RPC的说明 ，如果想查看 波卡链原生RPC的文档说明 ，可以参考: https://polkadot.js.org/docs/substrate/rpc/；

1.6 查看所有 支持的 RPC 的方法

可到 dbc 网页钱包：https://www.dbcwallet.io/ ，点击左侧切换网络，在自定义终端中，输入 websocket 地址。然后如下图导航到 RPC calls，查看区块链支持的所有 RPC。如图，选择 rpc模块的methods方法，点击右边的提交RPC调用，将列出所有的 RPC 方法名。

2. 关于块高，奖励发放时间，与Era的说明

块高就是链上的时间。

2.1 获取当前块高

• 方法： chain_getBlock

• 调用方法：

  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "chain_getBlock",
    "params": []
  }
  

• 返回结果：

  {
    "jsonrpc": "2.0",
    "result": {
      "block": {
        ...
        "header": {
          ...
          "number": "0x2d8",
          "parentHash": "0xc0e1b239fafc0edf3e08a908b5caecb27c2b351ed0daef3fc60c5600b28d6d7d",
          "stateRoot": "0x55ce4794b2cdd21275656a80febf5133d882d909a2de6d40d7b8887bd65628bc"
        }
      },
      "justification": null
    },
    "id": 1
  }
  

  其中，"number": "0x2d8" 即为块高，转为十进制为：728

2.2 Era 与奖励发放时间

• 1 Era 为 2880 个区块高度，在 DBC 区块链上，约是 1 天。发放奖励的时间，为区块链高度的 [2880*n, 2880*n+60] 的时间区间。

• 在第 n Era 上线的机器，在 n+1 Era 结束时发放。即如果在 Era2 上线的机器即 [5761, 8640]，奖励将会在 Era4 开始前 60 个块的区间内发放 Era3 的奖励，即在 2880*4=11520 时开始发放。可以在之后查到 Era3 的奖励，如通过 erasMachineReleasedReward 方法，查到 era3 机器获得的奖励。

• 当前主网上，[529920, 532800] 为 Era1， [532801, 535680] 为 Era2...