BubiChain API 概述

概述

​ 为了方便用户使用 BubiChain 区块链，因此，BubiChain 提供了 API 接口，包括 HTTP 接口 和 Websocket 接口。

HTTP 接口概述

​ HTTP 接口中的请求数据和响应数据都是 JSON 格式。

​ HTTP 接口的配置项是在 config 目录下的 bubi.json 文件的 webserver 下配置的，配置内容如下：

"webserver": {
  "listen_addresses": "0.0.0.0:36002" // 监听 IP 和端口
}

Websocket 接口概述

​ Websocket 接口中的请求数据和响应数据都是 protocol buffer 3 格式，protocol buffer 3是google推出的数据序列化协议，您如果不了解protocol buffer 3，请点击proto3了解更多。

​ Websocket 接口的配置项是在 config 目录下的 bubi.json 文件的 wsserver下配置的，配置内容如下：

"wsserver": {
    "listen_address": "0.0.0.0:36003" // 监听 IP 和端口
}

体验链

​ 为了方便用户熟悉 BubiChain 区块链，因此，提供了体验环境。

URL：seed1-node.bubi.cn

交易流程

1. 组装交易对象。

   根据意愿组装交易对象Transaction, 不同的交易有不同的数据结构；HTTP 接口组装 JSON 格式交易，Websocket 接口组装 Protobuf 格式交易）。

2. 序列化交易。

   将交易对象序列化为字节流 transaction_blob，HTTP 接口调用序列化交易接口得到，Websocket 接口是通过 Protobuf 对象Transaction的有序列化方法得到。

3. 签名交易。

   用私钥skey对transaction_blob签名得到sign_data，skey的公钥为pkey，详见 Keypair 手册。

4. 提交交易。

   详见 HTTP 提交交易和 Websocket 提交交易

5. 查询交易是否执行成功。

   HTTP 接口调用查询交易接口查询，Websocket 接口是通过提交交易的响应消息查询。