1 Bottos简介

1.1. 项目介绍

Bottos 是聚焦于人工智能领域的基础设施，既有依据数据特性而专门设计的底层公链，又有服务于整个人工智能及其衍生产业的数据流转平台。通过数据挖矿和智能合约实现数据、模型、算力、存储多层级共享服务的基于共识的、可扩展的、易于开发的和可协同的一站式应用平台。

Bottos 可以被应用于大数据、人工智能，智能硬件、机器人、物联网，VR/AR 等领域。简单来说，Bottos 不仅是人工智能公链，而且兼有数据和模型流转服务，实现基于数据喂养形成的人工智能及其衍生产业的价值流转，最终形成分布式 AI 新生态。

Bottos 基础公有链以服务人工智能产业而设计，其性能优势集中体现在数据流转，以及算力、存储共享等方面，具有极强的产业属性。其原创技术特性包括智能货币设计、抽签式 dPOS 算法和引入 AI 算法的分布式存储等，在数据隐私保护、超大数据存储等方面具有领先的竞争优势。

Bottos 基础服务链旨在打造去中心化的数据流转平台，解决人工智能训练数据获取难的痛点，吸引人工智能及其衍生产业积极入驻平台。通过数据和模型确权，鼓励用户分享，加快交易流转。通过智能合约生命周期管理帮助 AI 及其衍生产业消除信任成本、提高效率。

Bottos 应用开发层主要以 DApps 为主，其中分为三类:人工智能类、人工智能衍生类、区块链技术服务类。区块链技术类诸如闪电网络、Oralce、侧链、跨链等，以完善 Bottos 生态为主，随着区块链技术的迭代而不断新增;人工智能类 DApps 以单纯软件为代表，以数据喂养后模型迭代升级为特点; 人工智能衍生类 DApps 包括以软硬结合为代表的智能硬件、物联网、机器人等，通过硬件对新的数据进行收集，是 AI 数据的来源渠道。这些 DApps 彼此之间构成数据的需求闭环，最终可形成全球规模的数据集合池，同时 DApps 的智能模块之间也存在需求，通过区块链技术形成需求映射，最终也会形成庞大的模块集合池。](./resource_cn/项目介绍.md)

1.2. 系统架构

Bottos 是聚焦于人工智能领域的基础设施，既有依据数据特性而专门设计的底层公链，又有服务于整个人工智能及其衍生产业的数据流转平台。Bottos 的数据流转是基于区块链技术的全球最大数据集合池，解决人工智能(AI)行业优质数据获取难的痛点，独创智能数据入股合约，用数据挖矿方式实现个人数据财富共享，在个人数据和 AI 模型之间建立价值联系。

因此，在Bottos系统设计时采用了分层架构的方式，便于系统的动态扩展和灵活部署。总体分为三层，如下：

核心层： Chainbase层，提供区块链基础的链服务，构建信任公链基础结构，实现区块链基本功能；

服务层：基于Chainbase 提供基于铂链开发的基础服务，例如提供分布式身份服务、分布式存储、合约以及Token管理服务等，实现快速的Dapp开发；

应用层：基于Bottos开发的各种应用集合。

本文目前主要介绍如何使用Core Layer即区块链基础服务，提供相应开发接口和使用案例，提供钱包基本接口和方式。

Bottos系统的总体技术框架如下图所示：

1.3. 网络结构

1.3.1 网络整体

Bottos网络中的典型角色有三种：

终端用户
终端用户接入服务的提供者
超级节点（区块生产者）

这三类角色将Bottos网络分成了三层，如下图所示。分别是

终端用户所在的接入层，这些终端用户有可能形成的终端网络
接入服务的提供者节点之间形成的服务层
超级节点之间组成的生产者网络

1.3.2 超级节点网络

超级节点承担全网所有Transaction的执行和记录，是全网络稳定的基础，因此铂链在超级节点网络设计采用了全连接方式组网。如下图所示（以10个超级节点的全连接为例。实际的超级节点个数为49个，其中每轮选中29个出块，另外20个节点备选）

1.3.3 其它节点与超级节点的连接图

除超级节点外的其它类型节点，是组织松散的网络，类似下图中的mesh结构的连接方式

1.3.4 节点简介

Bottos节点分为基础服务节点、应用型节点、轻型节点、超轻型节点，各节点间彼此制衡和互补，形成动态平衡的节点自洽系统。

基础服务节点

基础服务节点提供整个Bottos区块链系统的基础服务，除了支持区块链核心的交易共识、合约部署、区块生产等核心功能外，同时支持Bottos服务层提供的主体功能，如统一身份系统、存储管理服务、信用服务、Token管理以及合约管理等主要功能，为整体Bottos网络提供最主要的生产服务。

应用型节点

应用型节点主要为生态系统中不同的DApps部署进行服务，应用型节点可以是自己部署，也可以部署在基础节点。（未来部署基础节点的逻辑App应用可以收取一定的部署门槛费用）。

轻型节点

轻型节点主要作为Bottos的数据验证节点，不提供服务层相应的功能，仅进行区块数据同步等功能，可以支持Bottos核心层基本服务。

超轻型节点

超轻型节点主要处理区块相关头验证，同步关键HASH数据等。

2 Bottos单节点部署

2.1 docker

详见 3.1 一键docker容器部署，在使用makeDockerComposeYml.sh 构建 docker-compose.yml时，将delegateNum参数设为1，即为单节点部署。

2.2 VM

2.2.1 下载运行程序

准备Bottos Chain可执行程序

2.2.1.1 下载已发布版本（推荐）

Bottos Chain发布的Release版本的路径为 https://github.com/bottos-project/bottos/releases

2.2.1.2 下载源码并编译版本

准备编译环境

Golang语言环境安装

Golang语言环境安装

MinGW程序安装(Windows ONLY)

相应程序可以在 MinGW官网地址下载，要求不低于MinGW 8.1.0版本。

下载源码

Bottos Chain源码的路径为 https://github.com/bottos-project/bottos

编译源码

Linux环境编译(Ubuntu/MacOS)

编译bottos链可执行文件。

    user:bottos user$ make bottos
    build/vmlib.sh
    build/bottos.sh
    go build
    Done building.
    Run "./bottos --help" for help.

编译bcli人机命令可执行文件。

    user:bottos user$ make bcli
    build/bcli.sh go install
    Done building.
    Run "build/bin/bcli" to launch command line tool.

编译wallet钱包可执行文件。

    user:bottos user$ make wallet
    build/wallet.sh go install
    Done building.
    Run "build/bin/wallet" to launch wallet.

一次编译所有可执行文件，可以执行make all或者使用makeall.sh脚本。

    user:bottos user$ make all
    build/vmlib.sh
    build/bottos.sh
    go build
    Done building.
    Run "./bottos --help" for help.
    build/bcli.sh go install
    Done building.
    Run "build/bin/bcli" to launch command line tool.
    build/wallet.sh go install
    Done building.
    Run "build/bin/wallet" to launch wallet.

Windows环境编译

执行源码根目录下的 makeall.sh 脚本，将会在当前目录生成 bottos 可执行文件，以及在build/bin目录下生成人机命令bcli和钱包wallet可执行程序，如下图：

2.2.2 准备节点启动配置文件

单节点开发环境

单节点作为独立节点运行和部署，主要用于开发者验证和简单测试自己的业务功能。下文将为用户介绍如何部署一个单节点环境。

修改配置文件 config.toml

进入版本包文件夹后:

1 产生一对公私钥

./bcli wallet generatekey
public_key: 046607760d95319d4dbe26751c15f75d9154dd564aaff8a5346207cda90fc1b7f6f62f0f7382e964b18a1f3f3b7c6b7b212c63959d1e0ab2b51a4f122b0089e9e4
private_key: 1b936c16e85cb2a7db8f6c15609ab1466f3e6ccdde0577bf0448b0fa387db460

此命令执行后，得到的public_key和private_key值将被使用于下一步填写配置参数。

2 打开config.toml文件，修改红色部分

[Node]

DataDir = "./datadir"

[Rest]

RESTPort = 8689

RESTHost = "localhost"

[P2P]

P2PPort = 9868

P2PServAddr = "192.168.1.1"

PeerList = []

P2PAuthRequried = false

P2PAuthKeyList = []

MaxPeer = 60

[Delegate]

Solo = true

[Delegate.Signature]

Type = "key"

PrivateKey = "XXX" -> 把第1步生成的private_key值对应填写到此处（引号也需要）

PublicKey = "YYY" -> 把第1步生成的public_key值对应填写到此处（引号也需要）

URL = "" ->去掉引号内的内容

[Plugin]

[Plugin.MongoDB]

URL = "mongodb://bottos:bottos@127.0.0.1:27017/bottos"

[Plugin.Wallet]

WalletDir = ""

WalletRESTPort = 6869

WalletRESTHost = "localhost"

[Plugin.Log]

LogRESTPort = 6870

LogRESTHost = "localhost"

启动节点

单节点启动，直接按以下命令行启动。

./bottos --delegate bottos --enable-wallet &

节点启动后，过一会会发现程序打印bottos开始生产出块，则说明节点启动成功。同步块打印如下提供参考。

InsertBlock, number:1552, time:2018-12-18 10:06:18, delegate:bottos, trxn:0, hash:7664063509a4a813f2fa06a929f11a36ba66184e036dfe7c49937a28d5328050, prevHash:98f4567dbcd6dfd8c0bc7ce4f24ee96f2d3476691088e08475ae56bb62d6afd3, version:3.4.0 InsertBlock, number:1553, time:2018-12-18 10:06:21, delegate:bottos, trxn:0, hash:cbef8f392a17cfdf58587b263f22cb844e7dd534336fb2f3b99ca5d9276466d6, prevHash:7664063509a4a813f2fa06a929f11a36ba66184e036dfe7c49937a28d5328050, version:3.4.0 InsertBlock, number:1554, time:2018-12-18 10:06:27, delegate:bottos, trxn:0, hash:ea88602bf0ad960172357403a6626df0a4b19443b5fd665561ce82dcb4e95792, prevHash:cbef8f392a17cfdf58587b263f22cb844e7dd534336fb2f3b99ca5d9276466d6, version:3.4.0 InsertBlock, number:1555, time:2018-12-18 10:06:30, delegate:bottos, trxn:0, hash:97f630674cbc165b168196421b3817710047c886f64dc208f0f8fc380361425a, prevHash:ea88602bf0ad960172357403a6626df0a4b19443b5fd665561ce82dcb4e95792, version:3.4.0 InsertBlock, number:1556, time:2018-12-18 10:06:33, delegate:bottos, trxn:0, hash:ddf178d67791dc599495e3b4671b20054b725c3b707b81d32e57f4d0967196d9, prevHash:97f630674cbc165b168196421b3817710047c886f64dc208f0f8fc380361425a, version:3.4.0 InsertBlock, number:1557, time:2018-12-18 10:06:39, delegate:bottos, trxn:0, hash:ff6b472b91d578239b17f62c2332ce150b30e9a7a3a3056dac142774a412fa49

也可使用 ./bcli getblkheader查看最新块信息，只要块号(head_block_num)增长，说明节点启动和块同步已经开始顺利进行。

root@JD-linglong3:~/code/bottos/bcli# ./bcli getblkheader

==Chain Info==

{
    "head_block_version": 197632,
    "head_block_num": 21177,
    "head_block_hash": "e4efa47a284183e1bc7278dc92f32f6d41d1c4edf7331010422d4a76920b1b57",
    "head_block_time": 1545191697,
    "head_block_delegate": "bottos",
    "cursor_label": 2450201431,
    "last_consensus_block_num": 21177,
    "chain_id": "4b97b92d2c78bcffe95ebd3067565c73a2931b39d5eb7234b11816dcec54761a"
}
root@JD-linglong3:~/code/bottos/bcli# ./bcli getblkheader

==Chain Info==

{
    "head_block_version": 197632,
    "head_block_num": 21180,
    "head_block_hash": "06030bc418d1f18afcc989418f15db2221145e1b0b435ef61e6c4917f2de9202",
    "head_block_time": 1545191706,
    "head_block_delegate": "bottos",
    "cursor_label": 4074672642,
    "last_consensus_block_num": 21180,
    "chain_id": "4b97b92d2c78bcffe95ebd3067565c73a2931b39d5eb7234b11816dcec54761a"
}
root@JD-linglong3:~/code/bottos/bcli#

关闭节点

关闭节点，采用kill方式关闭即可。

root@JD-linglong3:~/code/bottos/bcli# ps -ef|grep bottos
root      8091  9773  0 12:00 pts/22   00:00:00 grep --color=auto bottos
root     24652 18486  0 Dec18 pts/26   00:08:33 ./bottos --delegate=bottos --enable-wallet
root@JD-linglong3:~/code/bottos/bcli# 
root@JD-linglong3:~/code/bottos/bcli# 
root@JD-linglong3:~/code/bottos/bcli# kill -9 24652
root@JD-linglong3:~/code/bottos/bcli# ps -ef|grep bottos
root      8093  9773  0 12:00 pts/22   00:00:00 grep --color=auto bottos
root@JD-linglong3:~/code/bottos/bcli#

LOG信息的查看

对于过程遇到问题的，可以查看版本包目录下产生的datadir/log/bottos.log，查看是否有新的ERR LOG信息产生。

3 快速多节点部署

3.1 一键docker容器部署

3.1.1 从 Docker Hub 拉取部署镜像

在使用以下命令进行部署之前，请确保您在Linux系统上已正确安装docker。

docker pull yaoya12345/bottos:v1.2

成功进行拉取应该到如下打印

v1.0: Pulling from yaoya12345/bottos
6abc03819f3e: Pull complete 
05731e63f211: Pull complete 
0bd67c50d6be: Pull complete 
60f006920332: Pull complete 
3c4715f274c4: Pull complete 
67fd3e8b357b: Pull complete 
febf2caf84b0: Pull complete 
Digest: sha256:d68cdaa4f78bfa1c24dc3d642577252f0ab34851ebc0b5badc18cc6d644c1020
Status: Downloaded newer image for yaoya12345/bottos:v1.0

拉取完成后，查看是否存在本镜像，使用命令

docker images

如果出现如下打印，表示已成功拉取

REPOSITORY              TAG                 IMAGE ID            CREATED             SIZE
yaoya12345/bottos       v1.0                14daca277442        22 hours ago        396MB

3.1.2 从Github下载脚本文件

从Github下载脚本文件 makeDockerComposeYml.sh，并将下载的文件放到部署目录下。

在部署目录下使用 makeDockerComposeYml.sh 构建 docker-compose.yml

./makeDockerComposeYml.sh --delegateNum=$DELEGATE_NODE_NUM --mongodb=true|false --image=$IMAGE_NAME

上述命令参数解释：

delegateNum 表示出块节点个数，一般为29

mongodb 值一般为 true 或 false，表示是否开启mongodb

image 参数指定使用的镜像名，本例里为 yaoya12345/bottos

构建成功将显示如下打印

current in ${yourdeploypath}
build done!

3.1.3 创建并启动容器

启动过程需要足够的内存和硬盘空间，如果您是在虚拟机环境下运行，请确保您的虚拟机有至少4G内存空间，以及docker配置的存储路径拥有30G硬盘空间。

在部署目录下，使用如下命令创建并启动容器

docker-compose up -d

随后出现如下打印，表示正在创建并启动

Creating network "dockerbottos_bottos_private" with the default driver
Creating genesis     ... done
Creating delegatep14 ... done
Creating delegatep20 ... done
Creating delegatep13 ... done
Creating delegatep9  ... done
Creating delegatep11 ... done
Creating delegatep29 ... done
Creating delegatep28 ... done
Creating delegatep8  ... done
Creating delegatep27 ... done
Creating delegatep15 ... done
Creating delegatep25 ... done
Creating delegatep19 ... done
Creating delegatep5  ... done
Creating delegatep3  ... done
Creating delegatep16 ... done
Creating delegatep2  ... done
Creating delegatep4  ... done
Creating delegatep26 ... done
Creating delegatep24 ... done
Creating delegatep22 ... done
Creating delegatep1  ... done
Creating delegatep23 ... done
Creating delegatep18 ... done
Creating delegatep12 ... done
Creating delegatep21 ... done
Creating delegatep7  ... done
Creating delegatep10 ... done
Creating delegatep17 ... done
Creating delegatep6  ... done

需要等待30个节点（包含genesis节点）全都打印出 done

查看所有节点是否正常启动

docker-compose ps

delegatep1    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16879->6869/tcp, 0.0.0.0:16880->6870/tcp, 0.0.0.0:18699->8689/tcp, 0.0.0.0:19878->9868/tcp
delegatep10   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16969->6869/tcp, 0.0.0.0:16970->6870/tcp, 0.0.0.0:18789->8689/tcp, 0.0.0.0:19968->9868/tcp
delegatep11   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16979->6869/tcp, 0.0.0.0:16980->6870/tcp, 0.0.0.0:18799->8689/tcp, 0.0.0.0:19978->9868/tcp
delegatep12   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16989->6869/tcp, 0.0.0.0:16990->6870/tcp, 0.0.0.0:18809->8689/tcp, 0.0.0.0:19988->9868/tcp
delegatep13   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16999->6869/tcp, 0.0.0.0:17000->6870/tcp, 0.0.0.0:18819->8689/tcp, 0.0.0.0:19998->9868/tcp
delegatep14   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17009->6869/tcp, 0.0.0.0:17010->6870/tcp, 0.0.0.0:18829->8689/tcp, 0.0.0.0:20008->9868/tcp
delegatep15   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17019->6869/tcp, 0.0.0.0:17020->6870/tcp, 0.0.0.0:18839->8689/tcp, 0.0.0.0:20018->9868/tcp
delegatep16   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17029->6869/tcp, 0.0.0.0:17030->6870/tcp, 0.0.0.0:18849->8689/tcp, 0.0.0.0:20028->9868/tcp
delegatep17   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17039->6869/tcp, 0.0.0.0:17040->6870/tcp, 0.0.0.0:18859->8689/tcp, 0.0.0.0:20038->9868/tcp
delegatep18   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17049->6869/tcp, 0.0.0.0:17050->6870/tcp, 0.0.0.0:18869->8689/tcp, 0.0.0.0:20048->9868/tcp
delegatep19   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17059->6869/tcp, 0.0.0.0:17060->6870/tcp, 0.0.0.0:18879->8689/tcp, 0.0.0.0:20058->9868/tcp
delegatep2    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16889->6869/tcp, 0.0.0.0:16890->6870/tcp, 0.0.0.0:18709->8689/tcp, 0.0.0.0:19888->9868/tcp
delegatep20   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17069->6869/tcp, 0.0.0.0:17070->6870/tcp, 0.0.0.0:18889->8689/tcp, 0.0.0.0:20068->9868/tcp
delegatep21   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17079->6869/tcp, 0.0.0.0:17080->6870/tcp, 0.0.0.0:18899->8689/tcp, 0.0.0.0:20078->9868/tcp
delegatep22   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17089->6869/tcp, 0.0.0.0:17090->6870/tcp, 0.0.0.0:18909->8689/tcp, 0.0.0.0:20088->9868/tcp
delegatep23   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17099->6869/tcp, 0.0.0.0:17100->6870/tcp, 0.0.0.0:18919->8689/tcp, 0.0.0.0:20098->9868/tcp
delegatep24   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17109->6869/tcp, 0.0.0.0:17110->6870/tcp, 0.0.0.0:18929->8689/tcp, 0.0.0.0:20108->9868/tcp
delegatep25   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17119->6869/tcp, 0.0.0.0:17120->6870/tcp, 0.0.0.0:18939->8689/tcp, 0.0.0.0:20118->9868/tcp
delegatep26   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17129->6869/tcp, 0.0.0.0:17130->6870/tcp, 0.0.0.0:18949->8689/tcp, 0.0.0.0:20128->9868/tcp
delegatep27   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17139->6869/tcp, 0.0.0.0:17140->6870/tcp, 0.0.0.0:18959->8689/tcp, 0.0.0.0:20138->9868/tcp
delegatep28   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17149->6869/tcp, 0.0.0.0:17150->6870/tcp, 0.0.0.0:18969->8689/tcp, 0.0.0.0:20148->9868/tcp
delegatep29   /Bottos/scripts/entrypoint ...   Up      0.0.0.0:17159->6869/tcp, 0.0.0.0:17160->6870/tcp, 0.0.0.0:18979->8689/tcp, 0.0.0.0:20158->9868/tcp
delegatep3    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16899->6869/tcp, 0.0.0.0:16900->6870/tcp, 0.0.0.0:18719->8689/tcp, 0.0.0.0:19898->9868/tcp
delegatep4    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16909->6869/tcp, 0.0.0.0:16910->6870/tcp, 0.0.0.0:18729->8689/tcp, 0.0.0.0:19908->9868/tcp
delegatep5    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16919->6869/tcp, 0.0.0.0:16920->6870/tcp, 0.0.0.0:18739->8689/tcp, 0.0.0.0:19918->9868/tcp
delegatep6    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16929->6869/tcp, 0.0.0.0:16930->6870/tcp, 0.0.0.0:18749->8689/tcp, 0.0.0.0:19928->9868/tcp
delegatep7    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16939->6869/tcp, 0.0.0.0:16940->6870/tcp, 0.0.0.0:18759->8689/tcp, 0.0.0.0:19938->9868/tcp
delegatep8    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16949->6869/tcp, 0.0.0.0:16950->6870/tcp, 0.0.0.0:18769->8689/tcp, 0.0.0.0:19948->9868/tcp
delegatep9    /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16959->6869/tcp, 0.0.0.0:16960->6870/tcp, 0.0.0.0:18779->8689/tcp, 0.0.0.0:19958->9868/tcp
genesis       /Bottos/scripts/entrypoint ...   Up      0.0.0.0:16869->6869/tcp, 0.0.0.0:16870->6870/tcp, 0.0.0.0:18689->8689/tcp, 0.0.0.0:19868->9868/tcp

全都显示为up，表示已正常启动。需要等待genesis节点初始化其他所有生产节点（大约3-5分钟），初始化完成之后，genesis会移交出块权力，之后生产节点开始轮流出块，启动完成。

可使用如下命令查看节点日志，例如查看创世节点日志

docker-compose logs genesis

Attaching to genesis
genesis        | 2019-07-05T08:22:56 starting new wallet
genesis        | 2019-07-05T08:22:56 wait for wallet launched, retry:0
genesis        | 2019-07-05T08:22:57 wallet launched successfully!
genesis        | 2019-07-05T08:22:57 start create wallet for account:bottos type:genesis
genesis        | 2019-07-05T08:22:58 {"errcode":0,"msg":"success","result":{"wallet_name":"bottos.keystore"}}
genesis        | 2019-07-05T08:22:58 create wallet for bottos successfully
genesis        | 2019-07-05T08:22:58 kill wallet: 53
genesis        | /Bottos/scripts/createNewKey.sh: line 5:    53 Terminated              nohup ./wallet --wallet-servaddr $host --port $port > $LOGDIR"nohup_wallet.log" 2>&1
genesis        | 2019-07-05T08:22:58 /root/bot/bottos.keystore generated successfully!
genesis        | 2019-07-05T08:22:58 starting new wallet
genesis        | 2019-07-05T08:22:58 wallet launched successfully!
genesis        | 2019-07-05T08:22:58 NOT found existing config and genesis file, generate new
genesis        | 2019-07-05T08:22:58 share genesis to /Bottos/sharedData/
genesis        | 2019-07-05T08:22:58 start unlock wallet for bottos
genesis        | 2019-07-05T08:22:59 {"errcode":0,"msg":"success","result":{"unlock":true}}
genesis        | 2019-07-05T08:22:59 unlock bottos successfully
genesis        | 2019-07-05T08:22:59 start node
genesis        | 2019-07-05T08:22:59 0:waiting for genesis node completely launch, headBlockNum:
genesis        | 2019-07-05T08:23:00 1:waiting for genesis node completely launch, headBlockNum:1
genesis        | 2019-07-05T08:23:01 2:waiting for genesis node completely launch, headBlockNum:1
genesis        | 2019-07-05T08:23:02 3:waiting for genesis node completely launch, headBlockNum:1
genesis        | 2019-07-05T08:23:03 4:waiting for genesis node completely launch, headBlockNum:2
genesis        | 2019-07-05T08:23:03 node launched successfully!

启动后，在部署目录下会生成Bottos_data文件夹，保存每个节点的配置文件，日志等文件。

随意选择一个节点，查看其日志文件判断是否正常出块，本例选择出块节点22

cd Bottos_data/delegatep22/log
cat nohup_bottos.log

出现如下打印，可发现出块节点已正常出块，部署启动成功

PreCommitBlock, number:312, time:2019-07-05 08:38:51, delegate:delegatep22, trxn:0, hash:ab8cf6370b82f01a5770f4beee04baebebec16bd1d991f4a452d015083663b28, prevHash:de91948b1b4afc3441b0a7f85af4211171252081e72bbb887caa33dbda4637ce
CommitBlock, number:312, time:2019-07-05 08:38:51, delegate:delegatep22, trxn:0, hash:ab8cf6370b82f01a5770f4beee04baebebec16bd1d991f4a452d015083663b28, prevHash:de91948b1b4afc3441b0a7f85af4211171252081e72bbb887caa33dbda4637ce, version:1.0.0
PreCommitBlock, number:313, time:2019-07-05 08:38:54, delegate:delegatep8, trxn:0, hash:d1cb1cedd504a2031b64deb8fb1b93c08f80c2c64dbfbb1903f95f05bf48e50e, prevHash:ab8cf6370b82f01a5770f4beee04baebebec16bd1d991f4a452d015083663b28
CommitBlock, number:313, time:2019-07-05 08:38:54, delegate:delegatep8, trxn:0, hash:d1cb1cedd504a2031b64deb8fb1b93c08f80c2c64dbfbb1903f95f05bf48e50e, prevHash:ab8cf6370b82f01a5770f4beee04baebebec16bd1d991f4a452d015083663b28, version:1.0.0
PreCommitBlock, number:314, time:2019-07-05 08:38:57, delegate:delegatep11, trxn:0, hash:53a6a79c4bdc924690d5b66c3dcbc7a59b84d4622975608d470294eee7cff652, prevHash:d1cb1cedd504a2031b64deb8fb1b93c08f80c2c64dbfbb1903f95f05bf48e50e
CommitBlock, number:314, time:2019-07-05 08:38:57, delegate:delegatep11, trxn:0, hash:53a6a79c4bdc924690d5b66c3dcbc7a59b84d4622975608d470294eee7cff652, prevHash:d1cb1cedd504a2031b64deb8fb1b93c08f80c2c64dbfbb1903f95f05bf48e50e, version:1.0.0
PreCommitBlock, number:315, time:2019-07-05 08:39:00, delegate:delegatep13, trxn:0, hash:a96de6b48104e60531c3f60d62fa8262ec967435add0af7811b75df630277847, prevHash:53a6a79c4bdc924690d5b66c3dcbc7a59b84d4622975608d470294eee7cff652
CommitBlock, number:315, time:2019-07-05 08:39:00, delegate:delegatep13, trxn:0, hash:a96de6b48104e60531c3f60d62fa8262ec967435add0af7811b75df630277847, prevHash:53a6a79c4bdc924690d5b66c3dcbc7a59b84d4622975608d470294eee7cff652, version:1.0.0
PreCommitBlock, number:316, time:2019-07-05 08:39:06, delegate:delegatep14, trxn:0, hash:b2ccdc424d3254e3215e3f50d9f3d4f083c28ff7324dc360de28258330fdcf4a, prevHash:a96de6b48104e60531c3f60d62fa8262ec967435add0af7811b75df630277847
CommitBlock, number:316, time:2019-07-05 08:39:06, delegate:delegatep14, trxn:0, hash:b2ccdc424d3254e3215e3f50d9f3d4f083c28ff7324dc360de28258330fdcf4a, prevHash:a96de6b48104e60531c3f60d62fa8262ec967435add0af7811b75df630277847, version:1.0.0
PreCommitBlock, number:317, time:2019-07-05 08:39:09, delegate:delegatep10, trxn:0, hash:9367270c4394d6c1d393528fe0534edce480ce3f5a070156afa3ba568a7de32c, prevHash:b2ccdc424d3254e3215e3f50d9f3d4f083c28ff7324dc360de28258330fdcf4a
CommitBlock, number:317, time:2019-07-05 08:39:09, delegate:delegatep10, trxn:0, hash:9367270c4394d6c1d393528fe0534edce480ce3f5a070156afa3ba568a7de32c, prevHash:b2ccdc424d3254e3215e3f50d9f3d4f083c28ff7324dc360de28258330fdcf4a, version:1.0.0
PreCommitBlock, number:318, time:2019-07-05 08:39:12, delegate:delegatep5, trxn:0, hash:521631edff1a26aeb21effdc9cb61882f027da5cfaedf7c6339a3340c4b142de, prevHash:9367270c4394d6c1d393528fe0534edce480ce3f5a070156afa3ba568a7de32c
CommitBlock, number:318, time:2019-07-05 08:39:12, delegate:delegatep5, trxn:0, hash:521631edff1a26aeb21effdc9cb61882f027da5cfaedf7c6339a3340c4b142de, prevHash:9367270c4394d6c1d393528fe0534edce480ce3f5a070156afa3ba568a7de32c, version:1.0.0
PreCommitBlock, number:319, time:2019-07-05 08:39:15, delegate:delegatep4, trxn:0, hash:da5774f1bded5fdc1f9c2ce90a346b001dca4b226a61c3b14b83dfba1b556ed0, prevHash:521631edff1a26aeb21effdc9cb61882f027da5cfaedf7c6339a3340c4b142de
CommitBlock, number:319, time:2019-07-05 08:39:15, delegate:delegatep4, trxn:0, hash:da5774f1bded5fdc1f9c2ce90a346b001dca4b226a61c3b14b83dfba1b556ed0, prevHash:521631edff1a26aeb21effdc9cb61882f027da5cfaedf7c6339a3340c4b142de, version:1.0.0
PreCommitBlock, number:320, time:2019-07-05 08:39:18, delegate:delegatep13, trxn:0, hash:c2d8be688cef912f05ef439a8539032791467cadab57f916aa18f568f14ceb3b, prevHash:da5774f1bded5fdc1f9c2ce90a346b001dca4b226a61c3b14b83dfba1b556ed0
CommitBlock, number:320, time:2019-07-05 08:39:18, delegate:delegatep13, trxn:0, hash:c2d8be688cef912f05ef439a8539032791467cadab57f916aa18f568f14ceb3b, prevHash:da5774f1bded5fdc1f9c2ce90a346b001dca4b226a61c3b14b83dfba1b556ed0, version:1.0.0
PreCommitBlock, number:321, time:2019-07-05 08:39:21, delegate:delegatep26, trxn:0, hash:43bec52d4e1479be85b6bd58bed92470b2aecd158abd94a87ac3adcddb936701, prevHash:c2d8be688cef912f05ef439a8539032791467cadab57f916aa18f568f14ceb3b
CommitBlock, number:321, time:2019-07-05 08:39:21, delegate:delegatep26, trxn:0, hash:43bec52d4e1479be85b6bd58bed92470b2aecd158abd94a87ac3adcddb936701, prevHash:c2d8be688cef912f05ef439a8539032791467cadab57f916aa18f568f14ceb3b, version:1.0.0
PreCommitBlock, number:322, time:2019-07-05 08:39:24, delegate:delegatep16, trxn:0, hash:b3c8b9b3cd4bd7806af2c45ba77a9a3f60ccf208d7be93b7b8b2182e5b813f0a, prevHash:43bec52d4e1479be85b6bd58bed92470b2aecd158abd94a87ac3adcddb936701
CommitBlock, number:322, time:2019-07-05 08:39:24, delegate:delegatep16, trxn:0, hash:b3c8b9b3cd4bd7806af2c45ba77a9a3f60ccf208d7be93b7b8b2182e5b813f0a, prevHash:43bec52d4e1479be85b6bd58bed92470b2aecd158abd94a87ac3adcddb936701, version:1.0.0
PreCommitBlock, number:323, time:2019-07-05 08:39:27, delegate:delegatep8, trxn:0, hash:820dae1481e193078a86bfe110f3750dceee0f400d74424ac93bc598bb550e38, prevHash:b3c8b9b3cd4bd7806af2c45ba77a9a3f60ccf208d7be93b7b8b2182e5b813f0a
CommitBlock, number:323, time:2019-07-05 08:39:27, delegate:delegatep8, trxn:0, hash:820dae1481e193078a86bfe110f3750dceee0f400d74424ac93bc598bb550e38, prevHash:b3c8b9b3cd4bd7806af2c45ba77a9a3f60ccf208d7be93b7b8b2182e5b813f0a, version:1.0.0
PreCommitBlock, number:324, time:2019-07-05 08:39:30, delegate:delegatep17, trxn:0, hash:1eca2eb82af0b54c8c0d4f9ec3d687e7c90bbc3b9a843a84928906d70c09d298, prevHash:820dae1481e193078a86bfe110f3750dceee0f400d74424ac93bc598bb550e38

管理容器基本指令

# 初始化
$ docker-compose up -d

# 停止
$ docker-compose stop

# 继续执行
$ docker-compose start

# 终止
$ docker-compose down

3.2 一键多VM部署

暂无

3.3 一键Kubernate部署

测试环境
- 宿主机：
  - 操作系统：win10
  - 处理器：Intel Core i5-7200U CPU @ 2.50GHz 2.71GHz
  - 系统类型：64位操作系统，基于X64的处理器
  - 内存：16G
- 虚拟机：
  - 虚拟工具：VMWare Workstation 15 Pro
  - 操作系统：Ubuntu 18.04.1
  - server01：
    - 处理器：2
    - 内存：4GB
    - 硬盘：25G
  - server02：
    - 处理器：2
    - 内存：5.8G
    - 硬盘：20G
  - server03：
    - 处理器：1
    - 内存：3.0G
    - 硬盘：20G
kubernetes集群的搭建
- 详见教程：https://blog.csdn.net/yaoya_2015/article/details/95461747
- nfs服务器搭建好之后，需要更改./kubernetes/nfs-pv.yaml中的相关ip
```
$ vim ./kubernetes/nfs-pv.yaml

  ...
  ...
  nfs:
    path: ...
    server: $YOUR_NFS_HOST_IP
```

启动

# 1. 进入 ./kubernetes
$ cd ./kubernetes

# 2. 创建pv
$ kubectl create -f ./nfs-pv.yaml

# 3. 创建pvc
$ kubectl create -f ./nfs-pvc.yaml

# 4. 生成genesis-delegateX.yaml文件
$ ./makeK8sYaml.sh --delegateNum=29 --mongodb=true --image=yaoya12345/bottos:v1.2

# 5. 启动节点
$ kubectl create -f ./genesis-delegateX.yaml

管理集群基本指令

# 获取集群系统pod信息
$ kubectl -n kube-system get pods

# 查看集群信息
$ kubectl cluster-info

# 获取节点信息
$ kubectl get nodes

# 获取pod信息
$ kubectl get pods

# 获取service信息
$ kubectl get svc

# 查看pod运行log
$ kubectl logs $POD_NAME

现在的策略：
- k8s自动调度pod到相应的服务器上
- 所有数据会持久化在nfs服务器上的 /home/bottos/k8s/save_data/ 下

4 DAPP开发手册

4.1 下载并引入`sdk`库文件

下载并引入bottos-sdk-js.min.js库文件

bottos-sdk-js.min.js下载地址:https://github.com/bottos-project/bottos-sdk-js

4.2 创建基本的项目结构

/项目目录
    - index.html
    - index.js
    - bottos-sdk-js.min.js

index.html

index.html中引入index.js和bottos-sdk-js.min.js，代码如下

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=375px, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Bottos Demo</title>
    <script src="./bottos-sdk-js.min.js"></script>
    <script src="./index.js"></script>
</head>
<body>
    <div style="margin-top:50px">
        <button style="width:100px;height:30px;background-color:coral" onClick="createAccount()">创建账户</button>
        <button style="width:100px;height:30px;background-color:coral" onClick="pushTransaction()">发布联系人</button>
        <button style="width:100px;height:30px;background-color:bisque" onClick="getTransaction()" >获取联系人</button>
    </div>


    <div style="margin-top:100px">
        <p>创建账户执行结果</p>
        <div id="createAccount" style="min-height:150px;background-color:#ccc">

        </div>
    
        <p>发布联系人执行结果</p>
        <div id="pushTransaction" style="min-height:150px;background-color:#ccc">
    
        </div>
    
        <p>获取联系人执行结果</p>
        <div id="getTransaction" style="min-height:150px;background-color:#ccc">
    
        </div>
    </div>
    
</body>
</html>

index.js

index.js中实现智能合约在链上的写入与读取操作,代码如下

var BottosWalletSDK = window.BottosWalletSDK
const config = {
    baseUrl:'http://192.168.52.130:8689/v1',
    version:1
}
var SDK = new BottosWalletSDK(config)
var Tool = SDK.Tool
var Wallet = SDK.Wallet
var Contract = SDK.Contract
var Api = SDK.Api

let account = 'testaccount'
let password = 'testpassword'
let keystore = null

// 创建账户
function createAccount(){
    console.log("createAccount")
    let params = {account:account,password:password}
    Wallet.createAccount(params)
        .then(response=>{
            keystore = response
            document.getElementById('createAccount').innerHTML = JSON.stringify(response)
        }).catch(error=>{
            console.log({error})
            document.getElementById('createAccount').innerHTML = JSON.stringify(error)
            
        })
}

// 调用合约
function callContract(requestParam){
    let params = {
        method:'reguser',
        contract:'john',
        sender:account,
        param:{
            userName:'john',
            userInfo:JSON.stringify({phone:'110120',age:18})
        }
    }

    if(keystore == null){
        alert('请先创建账户')
        return
    }
    let privateKey = Wallet.recover(password,keystore)
    let privateKeyStr = Tool.buf2hex(privateKey)

    Contract.callContract(params,privateKeyStr)
        .then(response=>{
            console.log({response})
            document.getElementById('pushTransaction').innerHTML = JSON.stringify(response)
        }).catch(error=>{
            console.log({error})
            document.getElementById('pushTransaction').innerHTML = JSON.stringify(error)
        })
}

// 发布联系人
function pushTransaction(){
    console.log("pushTransaction")
    callContract()
}

// 读取联系人
function getTransaction(){
    console.log("getTransaction")
    // callContract()
    let url =  config.baseUrl + '/common/query'
    let params = {
        contract:'john',
        object:'userreginfo',
        key:'john'

    }

    fetch(url,{
        method:'POST',
        body:JSON.stringify(params)
    }).then(function(response){return response.json()})   
    .then(function(response){
        document.getElementById('getTransaction').innerHTML = JSON.stringify(response)
    }).catch(function(error){
        document.getElementById('getTransaction').innerHTML = JSON.stringify(error)
    })
}

4.3 验证合约执行结果

首先创建一个账户

点击创建账户,如果返回如下结构，说明账户创建成功，该返回值为用户的keystore文件，需要安全保存

{"account":"testaccount","crypto":{"cipher":"aes-128-ctr","ciphertext":"4cd010eba51ff45d9a752f38d64a4def7697a142570253cc381afa2b04288e68","cipherparams":{"iv":"46b469bb1c87751852857114b928e6ad"},"mac":"04051cce0379362c28d8027a19c8b79f03621602c2eff68d8b793f94ae6f58fb","kdf":"scrypt","kdfparams":{"dklen":32,"n":1024,"r":1,"p":8,"salt":"cf9dbed2413764c640018b9fccb6629ed38dad72b333c7d12e89994523ec7857"}},"id":"48a923c2-1c40-46aa-b0c1-8f24d8e1bc81","version":3}

执行写入合约

点击发布联系人按钮，如果返回如下结果，说明写入合约执行成功

{"errcode":0,"msg":"trx receive succ","result":{"trx":{"version":1,"cursor_num":286,"cursor_label":423110953,"lifetime":1537498176,"sender":"testaccount","contract":"john","method":"reguser","param":"dc0002da00046a6f686eda001b7b2270686f6e65223a22313130313230222c22616765223a31387d","sig_alg":1,"signature":"4149cb35eab48415082081aee0ab3766b7a6730b1a2213c96638540227a8616f17cdf773ba90e3c515183c3fc5631fa53b65dcf93eed320d53ec78a672738675"},"trx_hash":"eb79dc2d8a8461451ea55257fcbaa5897a9b9732e7cc3b0c8a8322ab4909789b"}}

执行读取合约

点击读取联系人按钮，如果返回如下结果，说明读取合约执行成功

{"errcode":0,"msg":"success","result":{"contract":"john","object":"userreginfo","key":"john","value":"dc0001da001b7b2270686f6e65223a22313130313230222c22616765223a31387d"}}

至此，我们一个简单而又完整的DApp就已经开发完成，如果想要开发一个更加强大的DApp可以查看详细的接口文档

5 开发工具链

5.1 插件钱包

5.2 移动端钱包接口

5.3 RPC API接口

5.3.1 区块相关

获取区块高度信息

接口功能

接口说明：获取区块高度信息

接口地址

URL: /v1/block/height

返回格式

JSON

请求方式

GET

请求参数：

参数必选类型默认值说明

无

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
head_block_num	uint64	块号
head_block_hash	string	前一块哈希值
head_block_time	uint64	块生成时间
head_block_delegate	string	块生产者
cursor_label	uint32	块标识
last_consensus_block_num	uint64	不可逆块号
chain_id	string	链ID，同一链的所有节点的Chain_id必须相同
head_block_version	uint64	链版本号

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/block/height

请求：

无

响应：

  HTTP/1.1 200 OK
  {
    "errcode": 0,
    "msg": "success",
    "result": {
        "head_block_num": 1487,
        "head_block_hash": "5a808e8562636d424f2daac463aa901ff758af95d223b6ccd113ac2368d6ffb1",
        "head_block_time": 1548324339,
        "head_block_delegate": "bottos",
        "cursor_label": 1758920625,
        "last_consensus_block_num": 1487,
        "chain_id": "4b97b92d2c78bcffe95ebd3067565c73a2931b39d5eb7234b11816dcec54761a",
        "head_block_version": 65536
    }
}

获取区块信息

接口功能

接口说明：获取区块信息

接口地址

URL: /v1/block/detail

返回格式

JSON

请求方式

POST

请求参数：

参数必选类型默认值说明

block_num FALSE uint64 空块号

block_hash FALSE string 空块哈希值

备注：block_num、block_hash 必须二选一，若都缺省，默认查询到的是 0 号块的信息。

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
block_num	uint64	块号
prev_block_hash	string	前一块哈希值
block_hash	string	当前块哈希值
cursor_block_label	uint32	当前块标识
block_time	uint64	块生成时间
trx_merkle_root	string	默克尔根值，该块打包的所有交易的根哈希值
delegate	string	生产者名称
delegate_sign	string	生产者签名
ResourceReceipt	jsonObject	交易消耗资源情况
account_name	string	账户名称
space_token_cost	uint64	交易所消耗的空间资源
time_token_cost	uint64	交易所消耗的时间资源
trxs	jsonArray	当前区块所打包的交易列表，具体见“查询交易信息”章节的响应字段，另加TrxHash
TrxHash	string	交易HASH 值

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/block/detail

请求：

{
	"block_num": 32,
	"block_hash": "eeca4c8ee8410cf256d27e5e676f6ce395ebdffade431b52775bb20aa60b8929"
}

响应：

  HTTP/1.1 200 OK
  
  {
        "errcode": 0,
        "msg": "success",
        "result": {
            "block_version": 65536,
            "prev_block_hash": "9bd0e41e6f4b3464f0240d3655e25bdc2bbefbda4e346d3971ab3ca7fd072c40",
            "block_num": 32,
            "block_hash": "eeca4c8ee8410cf256d27e5e676f6ce395ebdffade431b52775bb20aa60b8929",
            "cursor_block_label": 2785773865,
            "block_time": 1548319974,
            "trx_merkle_root": "0000000000000000000000000000000000000000000000000000000000000000",
            "delegate": "bottos",
            "delegate_sign": "9bf5f2f4cdce4bd9edc22a1856975d47877afb02b8cfaa335b11f9f3706e6fb7266679e20837154a54395ede7df34ff1f3aa805b613a8175e30efce32c21afb7",
            "trxs": null
        }
   }

5.3.2 交易相关

获取签名哈希-param已序列化

接口功能

接口说明：获取签名哈希

接口地址

URL: /v1/transaction/getHashForSign

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
sender	TRUE	string	无	发送交易的账号名称
contract	TRUE	string	无	合约名
method	TRUE	string	无	合约方法名
param	TRUE	string	无	业务结构数据，经bpl序列化后，转为十六进制字符串

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
version	uint32	链版本号
cursor_num	uint64	最新区块号，调用获取区块头获得
cursor_lab	uint32	最新区块标签，调用获取区块头获得
lifetime	uint64	交易过期时间，调用获取区块头，加一定的延时
sender	string	发送者
contract	string	合约名称
method	string	合约方法
param	jsonObject	业务参数
sig_alg	uint32	签名算法
signature	string	签名值，为保持结构完整，保留改字段，可调用《钱包REST接口》中的对HASH签名接口获得该值

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/transaction/getHashForSign

请求：

{
	"sender": "bottos",
	"contract": "bottos",
	"method": "newaccount",
	"param": "dc0002da000a626f74746f7374657374da008230343931363362623834633739393438316131633630616331323265393431663566306233653639346435326439626530613862316561343730666361636266323564623439306330336334376564356465393862653735623435376333383730386465376539653935653461306263653634356539633033353861386435393638"
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "trx": {
            "version": 65536,
            "cursor_num": 942,
            "cursor_label": 431961988,
            "lifetime": 1558424134,
            "sender": "bottos",
            "contract": "bottos",
            "method": "newaccount",
            "param": "dc0002da000a626f74746f7374657374da008230343931363362623834633739393438316131633630616331323265393431663566306233653639346435326439626530613862316561343730666361636266323564623439306330336334376564356465393862653735623435376333383730386465376539653935653461306263653634356539633033353861386435393638",
            "sig_alg": 1,
            "signature": ""
        },
        "hash_for_sign": "ce3052ae25425b75d59670507481811f0310ee1348dea32723c6315d075539fd"
    }
}

获取签名哈希

接口功能

接口说明：获取签名哈希

接口地址

URL: /v1/transaction/getHashForSign2

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
sender	TRUE	string	无	发送交易的账号名称
contract	TRUE	string	无	合约名
method	TRUE	string	无	合约方法名
param	TRUE	jsonObject	无	业务结构数据，字段名称需与ABI文件中的fields结构字段相同

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
version	uint32	链版本号
cursor_num	uint64	最新区块号，调用获取区块头获得
cursor_label	uint32	最新区块标签，调用获取区块头获得
lifetime	uint64	交易过期时间，调用获取区块头，加一定的延时
sender	string	发送者
contract	string	合约名称
method	string	合约方法
param	jsonObject	业务参数
sig_alg	uint32	签名算法
signature	string	签名值，为保持结构完整，保留改字段，可调用《钱包REST接口》中的对HASH签名接口获得该值

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/transaction/getHashForSign2

请求：

{
	"sender": "bottos",
	"contract": "bottos",
	"method": "newaccount",
	"param": {
		"name": "bottostest13",
		"pubkey": "0492876e897e53de5d6767c41ba11217163baadc063ecbca38d4a3717d6c7f139c6e2d747dc6542d38c3d12dab495e3fad778852395ad247c76e63121864597f62"
	}
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "trx": {
            "version": 65536,
            "cursor_num": 267,
            "cursor_label": 3781540239,
            "lifetime": 1558603054,
            "sender": "bottos",
            "contract": "bottos",
            "method": "newaccount",
            "param": "dc0002da000c626f74746f73746573743133da008230343932383736653839376535336465356436373637633431626131313231373136336261616463303633656362636133386434613337313764366337663133396336653264373437646336353432643338633364313264616234393565336661643737383835323339356164323437633736653633313231383634353937663632",
            "sig_alg": 1,
            "signature": ""
        },
        "hash_for_sign": "38153ccf7559dca16ec4b513716004c78be468e39a4bcd0ca46d49f6f0868174"
    }
}

发送交易信息

接口功能

接口说明：发送交易信息

接口地址

URL: /v1/transaction/send

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
version	TRUE	uint32	无	最新区块号，调用获取区块头的version字段
cursor_num	TRUE	uint64	无	最新区块号，调用获取区块头获得
cursor_label	TRUE	uint32	无	最新区块标识，调用获取区块头获得
lifetime	TRUE	uint64	无	交易过期时间，调用获取区块头，加一定的延时，推荐延时100秒
sender	TRUE	string	无	发送者
contract	TRUE	string	无	合约名称
method	TRUE	string	无	合约方法
param	TRUE	string	无	业务参数，十六进制字符串
sig_alg	TRUE	uint32	1	签名算法
signature	TRUE	string	无	签名值

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
trx_hash	string	交易哈希值
trx	jsonObject	交易详情
version	uint32	链版本号
cursor_num	uint64	最新区块号，调用获取区块头获得
cursor_label	uint32	最新区块标签，调用获取区块头获得
lifetime	uint64	交易过期时间，调用获取区块头，加一定的延时
sender	string	发送者
contract	string	合约名称
method	string	合约方法
param	string	业务参数，十六进制字符串
sig_alg	uint32	签名算法
signature	string	签名值

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/transaction/send

请求：

{
	"version": 1,
	"cursor_num": 719,
	"cursor_label": 2997806499,
	"lifetime": 1534143531,
	"sender": "bottos",
	"contract": "bottos",
	"method": "newaccount",
	"param": "dc0002da0009757365727465737431da008230346430373538383030353634383861393864613365643234623766613265633061623864383464343764623534366333663138316137363462613366613165383237396637363434303963343164653031623030383065623161616565623935303966373932333535323061373565333432343432393134346234336331303462",
	"sig_alg": 1,
	"signature": "f0069bc363a55dc22207c75d15cc75524bf4950159130c6bf385f6f1ca877177362ad5ab51108e7f396043e3aee7058f1ca6a40fd6c79a8483e439d2e2bccf2c"
}

响应：

HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "trx receive succ",
    "result": {
        "trx": {
            "version": 1,
            "cursor_num": 719,
            "cursor_label": 2997806499,
            "lifetime": 1534143531,
            "sender": "delta",
            "contract": "bottos",
            "method": "newaccount",
            "param": "dc0002da0009757365727465737431da008230346430373538383030353634383861393864613365643234623766613265633061623864383464343764623534366333663138316137363462613366613165383237396637363434303963343164653031623030383065623161616565623935303966373932333535323061373565333432343432393134346234336331303462",
            "sig_alg": 1,
            "signature": "f0069bc363a55dc22207c75d15cc75524bf4950159130c6bf385f6f1ca877177362ad5ab51108e7f396043e3aee7058f1ca6a40fd6c79a8483e439d2e2bccf2c"
        },
        "trx_hash": "1815f4d4dfb52b88fb445efc255a5be6275fc3ad694f802c01c40644f09b651f"
    }
}

查询交易信息

接口功能

接口说明：查询交易信息

接口地址

URL: /v1/transaction/get

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
trx_hash	TRUE	string	无	交易哈希值

响应字段：**

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
trx_hash	string	交易哈希值
trx	jsonObject	交易详情
version	uint32	链版本号
cursor_num	uint64	最新区块号，调用获取区块头获得
cursor_label	uint32	最新区块标签，调用获取区块头获得
lifetime	uint64	交易过期时间，调用获取区块头，加一定的延时
sender	string	发送者
contract	string	合约名称
method	string	合约方法
param	jsonObject	业务参数
sig_alg	uint32	签名算法
signature	string	签名值

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/transaction/get

请求：

{
	"trx_hash": "85f9d2fbe1d3c0a217e10932899b6f73b24fafe59a006406ed65d7e4a39a7416"
}

响应：

HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "version": 1,
        "cursor_num": 31,
        "cursor_label": 2749714050,
        "lifetime": 1537259224,
        "sender": "bottos",
        "contract": "bottos",
        "method": "newaccount",
        "param": {
            "name": "testtest",
            "pubkey": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f"
        },
        "sig_alg": 1,
        "signature": "c85fd25af493cbb6a79870ce0fc602acc892664ca17e2c646aff0332ca6db7787beeb7e5d8553de8e4b83bdf7b227762fedf9e3674888893f18bf31f0b05d622"
    }
}

查询交易状态

接口功能

接口说明：查询交易状态

接口地址

URL: /v1/transaction/status

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
trx_hash	TRUE	string	无	交易哈希值

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
status	string	查询交易状态结果， ”sending“：交易已提交，在缓存池中处理； ”pending“：交易已提交，但未处理； ”packed“：交易已打包； ”not found“：交易执行失败； ”irreversible committed“：交易已成功生效，并不可逆转； “committed but reversible”：交易已生效，但可逆转

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/transaction/status

请求：

  {
  	"trx_hash": "8a403642ea7b51595d1a1454b43b83ba62420629581c3d2f0d2143342aa89c9f"
  }

响应：

   HTTP/1.1 200 OK
  {
      "errcode": 0,
      "msg": "success",
      "result": {
          "status": "irreversible committed"
      }
  }

5.3.3 账户相关

查询账户基本信息

接口功能

接口说明：查询账户基本信息

接口地址

URL: /v1/account/brief

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账户名称

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
account_name	string	账号名称
pubkey	string	公钥
balance	string	账号可支配的BTO数量

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/account/brief

请求：
```
{
	"account_name":"bottos"
}
```
响应：

   HTTP/1.1 200 OK
   {
        "errcode": 0,
        "msg": "success",
        "result": {
            "account_name": "bottos",
            "pubkey": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f",
            "balance": "93329890000000000"
        }
    }

查询账户详情

接口功能

接口说明：查询账户详情

接口地址

URL: /v1/account/info

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账户名称

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
account_name	string	账号名称
pubkey	string	公钥
balance	string	账号可支配的BTO数量
staked_balance	string	质押投票的BTO数量
staked_space_balance	string	质押SPACE的BTO数量（交易需消耗SPACE）
staked_time_balance	string	质押TIME的BTO数量（交易需消耗TIME）
unStaking_balance	string	正解质押的BTO数量
unStaking_timestamp	uint64	解质押的时间（ Unix时间戳）
authority	jsonObject	授权列表，若该账号非多签账号，不为空
author_account	string	授权账号
weight	uint32	权重
resource	jsonObject	账号资源情况
free_available_space	uint64	免费额度内，可使用的SPACE数量
free_used_space	uint64	免费额度内，已使用的SPACE数量
stake_available_space	uint64	质押范围内，可使用的SPACE数量
stake_used_space	uint64	质押范围内，已使用的SPACE数量
free_available_time	uint64	免费额度内，可使用的TIME数量
free_used_time	uint64	免费额度内，已使用的TIME数量
stake_available_time	uint64	质押范围内，可使用的TIME数量
stake_used_time	uint64	质押范围内，已使用的TIME数量
unClaimed_block_reward	string	出块奖励数
unClaimed_vote_reward	string	投票奖励数
deploy_contract_list	string	该账号部署的合约列表
vote	jsonObject	投票信息
delegate	string	被投票生产者
votes	string	投票数量

备注：balance、staked_balance、staked_space_balance、staked_time_balance、unStaking_balance 三者之和为改账户总的Token值。

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/account/info

请求：
```
{
	"account_name":"bottostest"
}
```
响应：

   HTTP/1.1 200 OK
   {
	"errcode": 0,
	"msg": "success",
	"result": {
		"account_name": "bottostest",
		"pubkey": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f",
		"balance": "90000000000",
		"staked_balance": "0",
		"staked_space_balance": "0",
		"staked_time_balance": "0",
		"unStaking_balance": "0",
		"unStaking_timestamp": 0,
		authority: [{
			"author_account": "bobabcdefg",
			"weight": 1
		},
		{
			"author_account": "bobabcdefg1",
			"weight": 1
		}],
		"resource": {
			"free_available_space": 800,
			"free_used_space": 0,
			"stake_available_space": 279521403,
			"stake_used_space": 0,
			"free_available_time": 400,
			"free_used_time": 0,
			"stake_available_time": 141206920,
			"stake_used_time": 0
		},
		"unClaimed_block_reward": "0",
		"unClaimed_vote_reward": "0",
		"deploy_contract_list": "",
		"vote": {
			"delegate": "bottostest12",
			"votes": "6000000000"
		}
	}
}

5.3.4 合约相关

查询合约ABI

接口功能

接口说明：查询合约ABI

接口地址

URL: /v1/contract/abi

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
contract	TRUE	string	无	合约名称

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
types	jsonObject	预留字段
structs	jsonArray	合约所包含的方法结构列表
name	string	结构体名，一般为自定义的合约方法名别名
base	string	父方法，通常为空
fields	jsonObject	方法入参结构体
name	string	参数-1，以注册账号为例：账号名称
pubkey	string	参数-2，以注册账号为例：公钥
actions	jsonArray	合约所包含的方法
action_name	string	合约方法名称，对应“发送交易信息”请求参数的method值
type	string	同name，结构体名，一般为自定义的合约方法名别名
tables	jsonArray	该合约数据的存储方式，定义表名，类型，Key值，类型，Value 类型。内置合约该字段为空。
table_name	string	合约存储的表名
index_type	string	索引类型，默认为string。
key_names	jsonArray	合约数据存储的Key值
key_types	jsonArray	key值的类型，默认为string
type	string	合约数据key对应的value值，通常为结构体

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/contract/abi >

请求：
```
{
	"contract":"test1@tinaailian"
}
```
响应：

   HTTP/1.1 200 OK
  {
    "errcode": 0,
    "msg": "{\n\t\"types\": [],\n\t\"structs\": [\n              {\n              \t\"name\": \"UserInfo\",\n              \t\"base\": \"\",\n              \t\"fields\": {\n              \t\t\"userName\": \"string\",\n              \t\t\"userInfo\": \"string\"\n                    }\n              \t},\n              {\n              \t\"name\": \"UserBaseInfo\",\n              \t\"base\": \"\",\n              \t\"fields\": {\n              \t\t\"userInfo\": \"string\"\n                    }\n              \t}\n       ],\n\t\"actions\": [\n              {\n              \t\"action_name\": \"reguser\",\n              \t\"type\": \"UserInfo\"\n              }\n       ],\n\t\"tables\": [\n              {\n              \t\"table_name\": \"userinfo\",\n              \t\"index_type\": \"string\",\n              \t\"key_names\":  [\n              \t\t\"userName\"\n              \t ],\n              \t\"key_types\":  [\n              \t\t\"string\"\n              \t ],\n              \t\"type\": \"UserBaseInfo\"\n              }\n       ]\n}\n",
    "result": {
        "types": [],
        "structs": [
            {
                "name": "UserInfo",
                "base": "",
                "fields": {
                    "userName": "string",
                    "userInfo": "string"
                }
            },
            {
                "name": "UserBaseInfo",
                "base": "",
                "fields": {
                    "userInfo": "string"
                }
            },
            {
                "name": "UserInfo",
                "base": "",
                "fields": {
                    "userInfo": "string"
                }
            },
            {
                "name": "UserBaseInfo",
                "base": "",
                "fields": {
                    "userInfo": "string"
                }
            }
        ],
        "actions": [
            {
                "action_name": "reguser",
                "type": "UserInfo"
            }
        ],
        "tables": [
            {
                "table_name": "userinfo",
                "index_type": "string",
                "key_names": [
                    "userName"
                ],
                "key_types": [
                    "string"
                ],
                "type": "UserBaseInfo"
            }
        ]
     }
  }

查询合约代码

接口功能

接口说明：查询合约代码

接口地址

URL: /v1/contract/code

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
contract	TRUE	string	无	合约名称

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/contract/code >

请求：
```
{
	"contract":"usermng"
}
```

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "",
    "result": "7b0a2020227479706573223a205b5d2c0a20202273747275637473223a205b7b0a202020202020226e616d65223a202255736572496e666f222c0a2020202020202262617365223a2022222c0a202020202020226669656c6473223a207b0a20202020202020202020226469646964223a2022737472696e67222c0a2020202020202020202022696e666f223a2022737472696e67220a20202020202020207d0a202020207d2c7b0a202020202020226e616d65223a2022557365724c6f67696e222c0a2020202020202262617365223a2022222c0a202020202020226669656c6473223a207b0a2020202020202020202022757365724e616d65223a2022737472696e67222c0a202020202020202020202272616e646f6d4e756d223a202275696e743332220a20202020202020207d0a202020207d2c7b0a202020202020226e616d65223a20225573657242617365496e666f222c0a2020202020202262617365223a2022222c0a202020202020226669656c6473223a207b0a2020202020202020202022696e666f223a2022737472696e67220a20202020202020207d0a202020207d0a20205d2c0a202022616374696f6e73223a205b7b0a20202020202022616374696f6e5f6e616d65223a202272656775736572222c0a2020202020202274797065223a202255736572496e666f220a202020207d2c7b0a20202020202022616374696f6e5f6e616d65223a2022757365726c6f67696e222c0a2020202020202274797065223a2022557365724c6f67696e220a202020207d0a20205d2c0a2020227461626c6573223a205b7b0a202020202020227461626c655f6e616d65223a202275736572726567696e666f222c0a20202020202022696e6465785f74797065223a2022737472696e67222c0a202020202020226b65795f6e616d6573223a205b0a2020202020202020226469646964220a2020202020205d2c0a202020202020226b65795f7479706573223a205b0a202020202020202022737472696e67220a2020202020205d2c0a2020202020202274797065223a20225573657242617365496e666f220a202020207d0a20205d0a7d0a"
}

5.3.5 生产者相关

查询所有生产者

接口功能

接口说明：查询所有生产者

接口地址

URL: /v1/delegate/getall

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
limit	TRUE	uint32	无	查询条数
start	TRUE	uint32	0	查询起始下标

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonArray	响应结果
account_name	string	账号名称
public_key	string	公钥
location	string	节点地理位置信息，如"shanghai,china"
desc	string	节点描述信息

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/delegate/getall >

请求：
```
{
    "limit": 10,
    "start": 0
}
```

响应：

 HTTP/1.1 200 OK
{
      {
      "errcode": 0,
      "msg": "success",
      "result": [
          {
              "account_name": "bottos",
              "public_key": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f",
              "location": "",
              "description": "",
              "votes": "",
              "active": true,
              "transit_votes": ""
          },
          {
              "account_name": "delegatecreate1",
              "public_key": "04290d3406ba34e4f048a512b2fa7c6687622106c7bf6b7a62dac4c31d5b8f3cbf829eb30790648dcab111fde5edbce038801d5ba43f20388c15249ddd22b081e1",
              "location": "",
              "description": "",
              "votes": "50000000000",
              "active": true,
              "transit_votes": "50000000000"
          },
          {
              "account_name": "delegatecreate2",
              "public_key": "04cc788ad88378837658b150f33440bf531aea0acc13a6921814b1e01927fd812ddb5ade669c784f34af3350b9188c8b63bb114b5afde4f64bbbab0ccd1f925458",
              "location": "",
              "description": "",
              "votes": "50000000000",
              "active": true,
              "transit_votes": "50000000000"
          }
      ]
  }
}

5.3.6 多签相关

获取转账提案详情

接口功能

接口说明：获取转账提案详情

接口地址

URL: /v1/proposal/review

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
proposal_name	TRUE	string	无	提案名称
proposer	FALSE	string	无	提案发起人账号

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
proposal_name	string	提案名称
proposer	string	提案发起人
msign_account_name	string	多签账号名称
author_list	jsonArray	多签账号授权账号列表
author_account	string	授权账号
is_approved	string	提案是否同意
packed_transaction	string	序列化之前的十六进制数据
transaction	jsonObject	交易数据
from	string	转账账号
to	string	接收账号
amount	string	转账金额
memo	string	转账备注
available	bool	提案是否结束
time	uint64	提案提交时间

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/proposal/review >

请求：

{
    "proposal_name": "testtransfer",
  	"proposer": "bobabcdefg"
}

响应：

 HTTP/1.1 200 OK
{
	"errcode": 0,
	"msg": "success",
	"result": {
		"proposal_name": "testtransfer",
		"proposer": "bobabcdefg",
		"msign_account_name": "tester",
		"author_list": [{
			"author_account": "bob",
			"is_approved": "true",
			
		}],
		"packed_transaction": "c9b17f5b000000000000000000000100a6823403ea3055000000572d3ccdcd01000000005c95b1ca00000000003ccdcd34000000005c95b1ca00000000007015d60500000000000000045359530000000013706179207573657220736f6d65206d6f6e657900",
		"transaction": {
			"from": "bottos",
			"memo": "testtransfer",
			"to": "bottosreferrer1",
			"value": 100000000000
		},
		"available": true,
		"time": 1554692543
	}
}

5.3.7 交易数据相关

根据关键字查询数据

接口功能

接口说明：根据关键字查询数据

接口地址

URL: /v1/common/queryDB

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
contract	TRUE	string	无	合约名称
table_name	TRUE	string	无	合约表名
key	TRUE	string	无	查询关键字

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
contract	string	合约名称
table_name	string	合约表名
key	string	查询关键字
value	jsonObject	查询到的数据

字段变化

无

接口示例

地址：http://127.0.0.1:8689/v1/common/queryDB

请求：

{
	"contract":"bottos",
	"table_name":"account",
	"key":"bottos"
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "contract": "bottos",
        "table_name": "account",
        "key": "bottos",
        "Value": {
            "account_name": "bottos",
            "contract_name": null,
            "create_date": 1533124800,
            "gs_permission": true,
            "public_key": "BFTxwiI9VTqm7lPqHM6ot794uMqZ8/9iKjuz5i3txxIIkDPWCR13KWVHvAcQIsooOMnobewpZnz3QOXJ5lS2En8="
        }
    }
}

5.3.8 序列化业务数据

接口功能

接口说明：序列化业务数据，json 转为十六进制字符串，作为“发送交易信息”请求中的param 字段值。

接口地址

URL: /v1/common/jsontobin

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
sender	TRUE	string	无	发送交易的账号名称
contract	TRUE	string	无	合约名
method	TRUE	string	无	合约方法名
param	TRUE	JsonObject	无	业务结构数据，字段名称需与ABI文件中的fields结构字段相同

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	string	序列化后的业务数据

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/common/jsontobin

请求：

{
	"sender": "bottos",
	"contract": "bottos",
	"method": "newaccount",
	"param": {
		"name": "bottostest11",
		"pubkey": "0492876e897e53de5d6767c41ba11217163baadc063ecbca38d4a3717d6c7f139c6e2d747dc6542d38c3d12dab495e3fad778852395ad247c76e63121864597f62"
	}
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": "dc0002da000c626f74746f73746573743131da008230343932383736653839376535336465356436373637633431626131313231373136336261616463303633656362636133386434613337313764366337663133396336653264373437646336353432643338633364313264616234393565336661643737383835323339356164323437633736653633313231383634353937663632"
}

5.3.9 反序列化业务数据

接口说明：反序列化业务数据，十六进制字符串转为 json，查看“发送交易信息”请求中的param 字段值。

接口地址

URL: /v1/common/bintojson

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
sender	TRUE	string	无	发送交易的账号名称
contract	TRUE	string	无	合约名
method	TRUE	string	无	合约方法名
data	TRUE	string	无	序列化后的业务数据

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	JsonObject	业务结构数据，字段名称应与ABI文件中的fields结构字段相同

字段变化

无

接口示例

地址：<http://127.0.0.1:8689/v1/common/bintojson

请求：

{
	"sender": "bottos",
	"contract": "bottos",
	"method": "newaccount",
	"data": "dc0002da000c626f74746f73746573743131da008230343932383736653839376535336465356436373637633431626131313231373136336261616463303633656362636133386434613337313764366337663133396336653264373437646336353432643338633364313264616234393565336661643737383835323339356164323437633736653633313231383634353937663632"
	}
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "name": "bottostest11",
        "pubkey": "0492876e897e53de5d6767c41ba11217163baadc063ecbca38d4a3717d6c7f139c6e2d747dc6542d38c3d12dab495e3fad778852395ad247c76e63121864597f62"
    }
}

5.3.10 查询类

查询交易记录列表

接口功能

接口说明：查询交易记录列表

接口地址

URL: /transferl/queryPersonalTransferlListAuto

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
accountName	TRUE	string	无	账号名称
start	TRUE	int	无	起始页
length	TRUE	int	无	每页条目数量

响应字段：

参数	类型	说明
data	jsonObject	包含交易记录信息
blockNum	uint64	区块号
sender	string	发送交易的账号名称
receiver	string	接收者账号名称
tradeAmount	string	交易额度
currency	string	交易币种
transactionId	string	交易HASH
tradeDate	uint64	交易日期
iTotalDisplayRecords	uint32	显示的交易总条数
message	string	查询返回消息
success	bool	查询状态

字段变化

无

接口示例

地址：http://125.94.34.23:8080/transferl/queryPersonalTransferlListAuto

请求：

{
	"accountName": "bottos.funds",
	"start": 0,
	"length": 20
}

响应：

 HTTP/1.1 200 OK
{
	"data": {
		"data": [{
			"blockNum": 2845146,
			"sender": "bottos.funds",
			"receiver": "bto1415926",
			"tradeAmount": 1814032318641,
			"currency": "BTO",
			"transactionId": "ef1384fe1ae5b52da7afe0996b3a5c3c64b825518c5e3c16938ac291a223a7e3",
			"tradeDate": 1554738564
		},		
		{
			"blockNum": 4195448,
			"sender": "bottos.funds",
			"receiver": "tioksbottos",
			"tradeAmount": 52000000000,
			"currency": "BTO",
			"transactionId": "36222017b2747bddb26cdb77e33bda19a206ac211e3242c7c4fe381239dfd9c1",
			"tradeDate": 1559038524
		}],
		"iTotalDisplayRecords": 2
	},
	"message": "find personal transfer success",
	"success": true
}

查询交易详情

接口功能

接口说明：查询交易详情

接口地址

URL: /trade/queryTradeDetailAuto

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
transactionId	TRUE	string	无	交易HASH

响应字段：

参数	类型	说明
data	jsonObject	包含交易记录信息
blockNum	uint64	区块号
transactionId	string	交易HASH
sender	string	发送交易的账号名称
contract	string	合约名称
method	string	合约方法
param	jsonObject	合约参数
tradeDate	uint64	交易日期
tradeStatus	string	交易状态
resultType	string	合约返回结果类型
spaceTokenCost	uint32	空间资源消耗
timeTokenCost	uint32	时间资源消耗
message	string	查询返回消息
success	bool	查询状态

字段变化

无

接口示例

地址：http://125.94.34.23:8080/trade/queryTradeDetailAuto

请求：

{
	"transactionId": "9dd7f5e7e7dd8a9e49fd23ac09e12b098a4fe4385af514f32626f6eecb119e21"
}

响应：

 HTTP/1.1 200 OK
{
	"data": {
		"data": {
			"blockNum": 4289315,
			"transactionId": "9dd7f5e7e7dd8a9e49fd23ac09e12b098a4fe4385af514f32626f6eecb119e21",
			"sender": "scottyu0711",
			"contract": "bottos",
			"method": "transfer",
			"param": {
				"from": "scottyu0711",
				"memo": "000837d0c03",
				"to": "gateiobottos",
				"value": 10000000000000
			},
			"tradeDate": 1559374704,
			"tradeStatus": "已确认",
			"resultType": "trade",
			"spaceTokenCost": 302,
			"timeTokenCost": 100
		}
	},
	"message": "transaction detail find success",
	"success": true
}

5.4 钱包API接口

一键创建钱包

接口功能

接口说明：一键创建钱包，钱包文件包默认保存在 Linux： /home/bottos/bot/ 目录下

接口地址

URL: /v1/wallet/createwallet

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称
passwd	TRUE	string	无	密码

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
wallet_name	string	生成的钱包文件名称，默认为账号名称+".keystore"后缀

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/createwallet >

请求：

{
	"account_name": "testtest1",
	"passwd": "Abc123"	
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "wallet_name": "testtest1.keystore"
    }
}

生成公私钥对

接口功能

接口说明：生成公私钥对

接口地址

URL: /v1/wallet/generatekeypair

返回格式

JSON

请求方式

GET

请求参数：

参数	必选	类型	默认值	说明
无

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
public_key	string	公钥
private_key	string	私钥

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/generatekeypair >

请求：
```
无
```

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "public_key": "043680ae1b81f87274d7051e6101afc8f8da3cd978bb75b22f24becb98afb456f110151644330ff6c742e44f8e9652f1ab5ea1cd3997bebe5a23a4389ff0cb6493",
        "private_key": "8a068d821ad8d58fe8caaa87f32ea69f889f6b8ce8c6bc3bc67ce2c68c43da3b"
    }
}

创建账号

接口功能

接口说明：创建账号，调用该接口时，需启动bottos节点程序；单独启动wallet服务，该功能不可用

接口地址

URL: /v1/wallet/createaccount

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称
public_key	TRUE	string	无	公钥
referrer	TRUE	string	无	引荐人账号

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果，具体数据详情

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/createaccount >

请求：

{
	"account_name": "testaccount1",
	"public_key": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f",
	"referrer": "bottos"	
}

响应：

 HTTP/1.1 200 OK
{
  "errcode": 0,
  "msg": "success",
  "result": {
      "trx": {
          "version": 65536,
          "cursor_num": 1933,
          "cursor_label": 503463811,
          "lifetime": 1548325777,
          "sender": "bottos",
          "contract": "bottos",
          "method": "newaccount",
          "param": "dc0002da000c746573746163636f756e7431da008230343534663163323232336435353361613665653533656131636365613862376266373862386361393966336666363232613362623365363264656463373132303839303333643630393164373732393635343762633037313032326361323833386339653836646563323936363763663734306535633965363534623631323766",
          "sig_alg": 1,
          "signature": "b3b5dedc31a63947b5cd058cae8723daf9e0489439f9a9328b2c3e089bcf1df97d245ad36a553619f99ac166cbb7d4a81be6aaf4960c0dd5d8a22ad58f9f7a95"
      },
      "trx_hash": "e5281d1bbc7b70f955136fa9c32cfecadebf6f07956a55ad85ff7a5f9e32428a"
  }
}

手动创建钱包

接口功能

接口说明：手动创建钱包，钱包文件包默认保存在 Linux： /home/bottos/bot/ 目录下，生成的钱包文件名称，默认为账号名称+".keystore"后缀

接口地址

URL: /v1/wallet/createwalletmanual

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称
private_key	TRUE	string	无	私钥
passwd	TRUE	string	无	密码

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/createwalletmanual >

请求：

{
	"account_name": "testtest1",
	"private_key": "b799ef616830cd7b8599ae7958fbee56d4c8168ffd5421a16025a398b8a4be45",
	"passwd": "Abc123"
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "wallet_name": "testtest1.keystore"
    }
}

打开/Unlock钱包

接口功能

接口说明：打开/Unlock钱包

接口地址

URL: /v1/wallet/unlockaccount

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称
passwd	TRUE	string	无	密码

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
unlock	bool	操作结果

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/unlockaccount >

请求：

{
	"account_name": "testtest1",
	"passwd": "123456"
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "unlock": true
    }
}

关闭/Lock钱包

接口功能

接口说明：关闭/Lock钱包

接口地址

URL: /v1/wallet/lockaccount

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
lock	bool	操作结果

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/lockaccount >

请求：
```
{
	"account_name": "testtest1"
}
```

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "lock": true
    }
}

查询钱包列表

接口功能

接口说明：查询钱包列表

接口地址

URL: /v1/wallet/list

返回格式

JSON

请求方式

GET

请求参数：

参数	必选	类型	默认值	说明
无

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
wallet_path	string	钱包路径+文件名称
account_name	string	账号名称

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/list >

请求：
```
无
```

响应：

 HTTP/1.1 200 OK
{
	"errcode": 0,
	"msg": "success",
	"result": [{
		"wallet_path": "C:\\Users\\jim\\AppData\\Roaming\\bot\\delegatecreate1.keystore",
		"account_name": "delegatecreate1"
	},
	{
		"wallet_path": "C:\\Users\\jim\\AppData\\Roaming\\bot\\delegatecreate2.keystore",
		"account_name": "delegatecreate2"
	}]
}

查询公钥

接口功能

接口说明：查询公钥，调用该接口的前提：账号已处于打开或Unlock状态(不需要连接Bottos 链)

接口地址

URL: /v1/wallet/getpublickey

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
account_name	string	账号名称
public_key	string	公钥值

字段变化

无

接口示例

地址：http://127.0.0.1:6869/v1/wallet/getpublickey

请求：
```
{
	"account_name":"testtest"
}
```

响应：

{
	"errcode": 0,
	"msg": "success",
	"result": {
		"account_name": "testtest",
		"public_key": "043680ae1b81f87274d7051e6101afc8f8da3cd978bb75b22f24becb98afb456f110151644330ff6c742e44f8e9652f1ab5ea1cd3997bebe5a23a4389ff0cb6493"
	}
}

对交易签名

接口功能

接口说明：对交易签名

接口地址

URL: /v1/wallet/signtransaction

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
sender	TRUE	string	无	发送交易的账号名称
contract	TRUE	string	无	合约名
method	TRUE	string	无	合约方法名
param	TRUE	string	无	业务结构数据，经bpl序列化后，转为十六进制字符串
sig_alg	FALSE	int	1	签名算法类型，当前只支持一种，后续可能会扩展
type	FALSE	string	"normal"	签名钱包用途类型，normal：用于转账、投票等操作；delegate：用于生产者出块签名（一般生产者适用）
push_url	FALSE	string	"127.0.0.1:8689"	接收交易的服务器地址信息，格式：IP地址或域名+端口号（默认8689），可选主网服务节点：mainnetservice1.bottos.org:8689；mainnetservice2.bottos.org:8689 可选测试网服务节点：testnetservice1.bottos.org:8689；testnetservice2.bottos.org:8689

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果，具体见 “发送交易信息” 请求字段

字段变化

无

接口示例

地址：http://127.0.0.1:6869/v1/wallet/signtransaction

请求：

{
	"sender": "bottosreferrer1",
	"contract": "bottos",
	"method": "newaccount",
	"param": "dc0002da000a626f74746f7374657374da008230343931363362623834633739393438316131633630616331323265393431663566306233653639346435326439626530613862316561343730666361636266323564623439306330336334376564356465393862653735623435376333383730386465376539653935653461306263653634356539633033353861386435393638",
	"sig_alg": 1,
	"type": "normal",
	"push_url": "testnetservice2.bottos.org:8689"
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "version": 65792,
        "cursor_num": 709915,
        "cursor_label": 2189965103,
        "lifetime": 1551089224,
        "sender": "bottosreferrer1",
        "contract": "bottos",
        "method": "newaccount",
        "param": "dc0002da000a626f74746f7374657374da008230343931363362623834633739393438316131633630616331323265393431663566306233653639346435326439626530613862316561343730666361636266323564623439306330336334376564356465393862653735623435376333383730386465376539653935653461306263653634356539633033353861386435393638",
        "sig_alg": 1,
        "signature": "2157bebc67481effcedcfacdf59da4ffc06976c443dedb7c511d7663a3126fe44191ae9c8f4605ea64566a4893d87a7cee3cc9f19c966fc214c6b6ee3c562f85"
    }
}

对HASH签名

接口功能

接口说明：对HASH签名

接口地址

URL: /v1/wallet/signhash

返回格式

JSON

请求方式

POST

请求参数：

参数	必选	类型	默认值	说明
account_name	TRUE	string	无	账号名称
hash	TRUE	string	无	数据的sha256 HASH值（消息摘要）

响应字段：

参数	类型	说明
errcode	uint32	错误码，0-相应成功，其他见错误码章节
msg	string	响应描述
result	jsonObject	响应结果
hash_value	string	签名值

字段变化

无

接口示例

地址：<http://127.0.0.1:6869/v1/wallet/signhash

请求：

{
	"account_name": "bottos",
	"hash": "87d80210bc83f8bb233d26d5551a516ad27a4e3ce2a2faaac6eacc4c87fadc3d"
}

响应：

 HTTP/1.1 200 OK
{
    "errcode": 0,
    "msg": "success",
    "result": {
        "sign_value": "ed6b57fa91ee369af925e4c0545c06f5829ce3d2825949931a2b8816039f53f47160701c779b528abe84f5d6acdb2d9c46de6958e42606d2e4d7b9b072991729"
    }
}

5.5 JavaScript API接口

5.5.1 Wallet JS API安装与使用

SDK支持以下功能:

创建账号keystore
创建账号mnemonic
从keystore恢复账号
从mnemonic恢复账号
转账、质押

文档

安装

Node.js

如果使用NPM

npm install bottos-sdk-js --save

或 yarn

yarn add bottos-sdk-js

使用

node方式中引入SDK:

var SDK = require('bottos-sdk-js');

browers方式中引入SDK:

<script src="path/to/bottos-sdk-js.min.js"></script>
<!-- or a CDN  -->
<script src="unpkg.com/bottos-sdk-js"></script>文件

您可以在release page上找到bottos-sdk-js.min.js文件

然后:

const Wallet = new SDK({
    baseUrl: "http://localhost:8689/v1"
}).Wallet;

现在你可以像下面这样使用它:

创建 keystore:

const account = 'myaccount'
const password = '12345678'
const privateKey = 'b4e0391643ff9be326a6ddfa543df0e0c2e37b7e11ed2f45590c62a5d5f09d9f'
const keystore = Wallet.createKeystore({account, password, privateKey})

转账:

const params = {
  from: 'senderAccount',
  memo: 'memo',
  to: 'receiveAccount',
  value: 100,
}
let privateKey = 'b4e0391643ff9be326a6ddfa543df0e0c2e37b7e11ed2f45590c62a5d5f09d9f'

Wallet.sendTransaction(params, privateKey)
  .then(res => {
    console.log('sendTransaction res:', res)
  })

您可以在example directory中找到更多示例。

5.5.2 Wallet JS API介绍

如何初始化 wallet
如何创建账号 keystore
如何从keystore恢复账号
如何创建mnemonic
如何从mnemonic恢复账号
如何质押
如何转账

Wallet 初始化:

参数:

name	Type	Required	Description
url	string	True	服务url

示例:

import SDK from 'bottos-sdk-js'

const Wallet = new SDK({
    baseUrl: "http://serverUrl/..."
}).Wallet;

Wallet.createKeystore:

参数:

name	Type	Required	Description
accounte	string	True	账号名称
passwd	string	True	密码
privateKey	string	False	私钥

示例:

let account = 'myaccount'
let password = '12345678'
let privateKey = 'b4e0391643ff9be326a6ddfa543df0e0c2e37b7e11ed2f45590c62a5d5f09d9f'

// Create keystore
let keystore = Wallet.createKeystore({account, password, privateKey})

// Print the keystore you created
console.log(JSON.stringify(keystoreObj))

Wallet.recoverKeystore:

参数:

Name	Type	Required	Description
password	string	True	密码
keystoreObj	json	True	keystore

示例:

let password = '12345678'

let keystoreObj = JSON.parse({
	"account": "myaccount",
	"crypto": {
		"cipher": "aes-128-ctr",
		"ciphertext": "ac6...",
		"cipherparams": {
			"iv": "f07..."
		},
		"mac": "403...",
		"kdf": "scrypt",
		"kdfparams": {
			"dklen": 32,
			"n": 262144,
			"r": 1,
			"p": 8,
			"salt": "3fc..."
		}
	},
	"id": "377...",
	"version": 3
})

// Recovery of Account from Keystore
let keys = Wallet.recoverKeystore(password, keystoreStrObj);

// Print account private key
console.log(keys.privateKey)

// Print account public key
console.log(keys.privateKey)

Wallet.createMnemonic:

参数:

无

示例:

Wallet.createMnemonic().then(data => {
  // 输出助记词
  console.log(data.mnemonic)

  // 输出私钥
  console.log(data.privateKey)

  // 输出公钥
  console.log(data.publicKey)
}).catch(error=>{

  // 异常处理
  console.log(error)
})

Wallet.recoverMnemonic:

参数:

name	Type	Required	Description
mnemonic	string	True	助记词

示例:

let mnemonic = 'output define output remember special physical entry unlock vendor track mountain young federal diary need struggle dawn staff buzz filter sound gun unaware'

Wallet.recoverMnemonic(mnemonic).then(keys => {
  // 打印私钥
  console.log(keys.privateKey)

  // 打印公钥
  console.log(keys.publicKey)
}).catch(error=>{

  // 异常处理
  console.log(error)
})

Wallet.stake:

示例:

name	Type	Required	Description
params	Object	True
params.amount	number	True	金额
[params.target]	string	False	您要为其设置质押的目标，可选的值为：space
senderInfo	Object	True
senderInfo.account	string	True	账号
senderInfo.privateKey	string	True	私钥

示例:

let sender = {
    account: 'myaccount',
    privateKey: 'b4e0391643ff9be326a6ddfa543df0e0c2e37b7e11ed2f45590c62a5d5f09d9f'
}

// stake time
Wallet.stake({
  amount: 1,
  target: "time"
}, sender).then(response=>{
  if(response && response.errcode == 0){
    console.log(stake success!)
  } else {
    throw response.errcode;
  }
}).catch(error=>{
  console.log(error)
})

// stake space
Wallet.stake({
  amount: 1,
  target: "space"
}, sender).then(response=>{
  if(response && response.errcode == 0){
    console.log(stake success!)
  } else {
    throw response.errcode;
  }
}).catch(error=>{
  console.log(error)
})

Wallet.sendTransaction:

参数:

name	Type	Required	Description
params	Object	True
params.from	string	True	转账方账号
params.to	string	True	收款方账号
params.value	number	True
[params.memo]	string	True	不能超出32个字符
privateKey	string	True	私钥

示例:

let params = {
  from: 'myaccount',
  memo: 'accounttest',
  to: 'senderaccount',
  value: '1'
}

let privateKey = '6ec664b993664abc4c197982b9ae48f7a37f1b4664f5981955453f1e13ec5b83'

// Transaction
Wallet.sendTransaction(params, privateKey).then(response=>{
  if(response && response.errcode == 0){
    console.log(stake success!)
  } else {
    throw response.errcode;
  }
}).catch(error=>{
    console.log(error)
})

5.6 基础合约API接口（包含在公共RPC里）

5.7 BCLI工具

5.7.1 BCLI工具简述

Bottos BCLI 实现了一组人机交互命令行，主要基于RESTFUL API和链进行交互及实现创建用户，查链，转账，钱包等基于主链的人机交互行功能。

5.7.2 BCLI工具安装和使用

在BOTTOS代码的BCLI目录下执行go build，编译成功后将会产生bcli可执行文件。

5.7.3 BCLI命令行说明

全局选项说明

全局选项名	参数说明
--servaddr	配置全局restful地址
--walletport	配置钱包restful地址

全局帮助信息

./bcli --help

NAME:
	Bottos bcli tool - a tool that makes user communicate with bottos blockchain
    
USAGE:
	bcli [global options] command [command options] [arguments...]

VERSION:
0.0.1

COMMANDS:
    getblkheader  get header block's information
    getblock      get block information
    gettable      get table information
    account       create or get account
    transfer      for user transferring bto
    transaction   get or push transactions
    contract      get or deploy contract
    p2p           for p2p connection
    delegate      for delegate operations
    wallet        For wallet operations
    genesis       for genesis node operations
    log           for log operations
    help, h       Shows a list of commands or help for one command

GLOBAL OPTIONS:
--servaddr value    (default: "127.0.0.1:8689")
--walletport value  
--help, -h          show help
--version, -v       print the version

命令功能说明

主命令行	参数列表	参数说明
./bcli	getinfo	获取块头信息
./bcli	getblock	获取指定BLOCK信息
./bcli	gettable	获取合约表信息
./bcli	account	创建/获取用户信息，质押/解质押/回收质押等
./bcli	transfer	BTO转账功能
./bcli	transaction	查询/发起 transaction
./bcli	contract	查询/部署合约和ABI
./bcli	p2p	P2P命令行暂不支持
./bcli	delegate	注册/解注册生产者，生产者投票/取消投票等
./bcli	wallet	钱包创建/锁定/解锁/查询等
./bcli	genesis	创世节点操作相关，设置初始生产者，移交出块权利，取消节点操作权限等
./bcli	log	log 开关，开启Debug log等日志级别

5.7.3.1 BCLI用户账户功能命令行

用户账户功能命令行主要负责创建新用户，获取指定用户信息，质押和解质押BTO，以及回收质押等。

总体命令行帮助信息

./bcli account --help

NAME:
    Bottos bcli tool account - create or get account

USAGE:
    Bottos bcli tool account command [command options] [arguments...]

COMMANDS:
    create   create account
    get      get account info
    stake    stake of account
    unstake  unstake of account
    claim    claim of stake

OPTIONS:
--help, -h  show help

命令功能说明

主命令行	参数列表	参数说明
./bcli account	create	创建新用户
./bcli account	get	获取用户信息
./bcli account	stake	质押BTO
./bcli account	unstake	解质押BTO
./bcli account	claim	回收部分质押BTO

创建用户命令说明

帮助信息

./bcli account create --help

NAME:
    Bottos bcli tool account create - create account

USAGE:
    Bottos bcli tool account create [command options] [arguments...]

OPTIONS:
--account value   acocunt name
--pubkey value    account public key
--referrer value  account referrer

参数说明

主命令行	参数列表	参数说明	必选参数
bcli account create	--account	创建的用户名	是
	--pubkey	新建用户的公钥，不填则使用内置缺省pubkey	是
	--referrer	引荐人，不填则使用缺省内置账户进行签名，否则使用引荐人做签名	是

返回信息

该命令成功后将返回BCLI成功发送的Transaction信息，主要内容包含用户名，公钥，发起者及签名（--referrer信息，缺省为内置bottos用户）等。

示例

./bcli account create --account user12345678 --pubkey 0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f --referrer bottos

输出结果

TrxHash: 7bdc7aca33233d1ed2407f2d217aa9580f30d2aaf68f60270dd24c934a0a1d29

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

Please create wallet for your new account.

获取用户信息命令示例

帮助信息

./bcli account get --help
NAME:
    Bottos bcli tool account get - get account information

USAGE:
    Bottos bcli tool account get [command options] [arguments...]

OPTIONS:
    --account value  acocunt name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli account get	--account	用户名	是

返回信息

该命令成功后将返回用户所持有的BTO及质押和解质押信息。

示例

./bcli account get --account bottos

输出结果

Account: bottos Balance: 935499000.00000000 BTO Pubkey: 0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f

StakedBalance: 0.00000000 BTO
UnStakingBalance: 0.00000000 BTO
StakedSpaceBalance: 0.00000000 BTO
StakedTimeBalance: 0.00000000 BTO
UnStakingTimestamp: 0

Resource: {
    "free_available_space": 0,
    "free_used_space": 0,
    "stake_available_space": 0,
    "stake_used_space": 0,
    "free_available_time": 0,
    "free_used_time": 0,
    "stake_available_time": 0,
    "stake_used_time": 0
 }

UnClaimedBlockReward: 0.00000000 BTO
UnClaimedVoteReward: 0.00000000 BTO
UnClaimedTotalReward: 0.00000000 BTO

Vote: N/A

Contracts: N/A

用户质押BTO命令示例

帮助信息

./bcli account stake --h
NAME:
    Bottos bcli tool account stake - stake of account

USAGE:
    Bottos bcli tool account stake [command options] [arguments...]

OPTIONS:
    --account value  acocunt name
    --amount value   amount of bto
    --target value   target of stake:vote,space,time (default: "vote"

参数说明

主命令行	参数列表	参数说明	必选参数
bcli account stake	--account	用户名	是
	--amount	质押BTO个数	是
	--target	资源配置类型：vote,space,time (缺省: "vote"), stake 参数选择	否

返回信息

该命令成功后将返回BCLI成功发送的Transaction信息。

示例

./bcli account stake --account user12345678 --amount 2

输出结果

TrxHash: 2921e27bad80060580d508d2726a830b8a3970b70b56f28e93ae866846cd7296

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

用户解质押BTO命令示例

帮助信息

./bcli account unstake --help

NAME:
    Bottos bcli tool account unstake - unstake of account

USAGE:
    Bottos bcli tool account unstake [command options] [arguments...]

OPTIONS:
    --account value  acocunt name
    --amount value   amount of bto
    --source value   source of unstake：vote, space, time (default: "vote")

参数说明

主命令行	参数列表	参数说明	必选参数
bcli account unstake	--account	用户名	是
	--amount	解质押BTO个数	是
	--source	解质押目标	否

返回信息

该命令成功后将返回BCLI成功发送的Transaction信息。

示例

./bcli account unstake --account user12345678 --amount 2 --source space

输出结果

TrxHash: c1e99e03957c8222479513bef9916368754a4549312ef4481bdc687729d7698c

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

用户回收质押BTO命令示例

帮助信息

./bcli account claim --help

NAME:
    Bottos bcli tool account claim - claim of stake

USAGE:
    Bottos bcli tool account claim [command options] [arguments...]

OPTIONS:
    --account value  acocunt name
    --amount value   amount of bto

参数说明

主命令行	参数列表	参数说明	必选参数
bcli account claim	--account	用户名	是
	--amount	回收质押BTO个数	是

返回信息

该命令成功后将返回BCLI成功发送的Transaction信息。

示例

./bcli account claim --account user12345678 --amount 2

输出结果

TrxHash: b39e46a180c4d9d465efd77a42e08f9590726d761c70b7ae34c64e3359ab6ce4

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

5.7.3.2 BCLI 合约功能命令行

BCLI合约功能命令行主要实现用户主动部署一个合约及ABI文件到主链，以及从主链获取合约code（或文件）文件和ABI（或文件）功能。

总体帮助信息如下

./bcli contract --help

NAME:
    Bottos bcli tool contract - get or deploy contract

USAGE:
    Bottos bcli tool contract command [command options] [arguments...]

COMMANDS:
    deploy      contract deploy
    get         get contract

OPTIONS:
    --help, -h  show help

命令功能说明

主命令行	参数列表	参数说明
./bcli contract	deploy	部署ABI文件以及WASM合约
./bcli contract	get	获取指定合约和ABI信息并存文件

BCLI 合约部署命令行

帮助信息

./bcli contract deploy --help
NAME:
   Bottos bcli tool contract deploy - contract deploy

USAGE:
   Bottos bcli tool contract deploy [command options] [arguments...]

OPTIONS:
   --contract value  the contract's name
   --code value      the contract's wasm file path ( includes wasm file name )
   --filetype value  the contract's file type: wasm or js (default: "wasm")
   --abi value       the contract's abi file path ( includes abi file name )
   --account value   the account name whom deploy the code

参数说明

主命令行	参数列表	参数说明	必选参数
bcli contract deploy	--contract	合约名	是
	--code	合约文件（.WASM）所在路径	是
	--filetype	合约文件类型：wasm/js	否
	--abi	合约文件（.abi）	是
	--account	部署合约的账户	是

返回信息

该命令成功后将返回BCLI成功发送的Transaction信息。

示例

./bcli contract deploy --contract testvm1 --code testvm1/testVM1.wasm --abi testvm1/testVM1.abi  --account tina123456789

输出结果

TrxHash: 596441807df736fc15ae32a59a38bc9324620ca2945a0633c033e7d0370e3638

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

注： BOTTOS ABI 文件是对合约一些方法所需的接口和结构以及参数的信息描述，例如本例中try.abi文件内容如下。

"structs" 代表本合约所有方法需要使用到的所有结构体定义；
"actions" 代表本合约所有合约支持的所有合约方法名以及所需的对应结构名
"tables" 代表查询合约被调用后（生效后）合约信息会写入链上，tables代表查询链上的某条信息所需要的入参，包含关键字和所对应的结构信息。

具体示例如下。

{
    "types": [],
    "structs": [
            {
                "name": "NodeClusterReg",
                "base": "",
                "fields": {
                    "nodeIP": "string",
                    "clusterIP": "string",
                    "uuid": "string",
                    "capacity": "string"
                    }
                },
            {
                "name": "NodeClusterInfo",
                "base": "",
                "fields": {
                    "clusterIP": "string",
                    "uuid": "string",
                    "capacity": "string"
                    }
                }
    ],
    "actions": [
            {
                "action_name": "reg",
                "type": "NodeClusterReg"
            }
    ],
    "tables": [
            {
                "table_name": "nodeclusterinfo",
                "index_type": "string",
                "key_names":  [
                    "nodeIP"
                ],
                "key_types":  [
                    "string"
                ],
                "type": "NodeClusterInfo"
            }
    ]
}

BCLI获取合约CODE文件和ABI文件

帮助信息

./bcli contract get --help
NAME:
    Bottos bcli tool contract get - get contract

USAGE:
    Bottos bcli tool contract get [command options] [arguments...]

OPTIONS:
    --account value  we use the account name as the default contract name
    --code value     the contract's wasm file path ( includes wasm file name )
    --abi value      the contract's abi file path ( includes abi file name )

参数说明

主命令行	参数列表	参数说明	必选参数
bcli contract get	--account	合约账户名	是
	--code	要保存的合约路径名	是
	--abi	要保存的abi描述文件（.abi）路径	是

返回信息

该命令成功后将返回合约文件码流和ABI文件信息，以及保存对应内容到目的合约文件路径及ABI文件路径。

示例

./bcli contract get --account user12345678 --code ~/test.wasm --abi ~/test.abi

输出结果

============CONTRACTCODE===============

"0061736d01000000013d0960027f7f0060067f7f7f7f7f7f017f60027f7f017f60087f7f7f7f7f7f7f7f017f60037f7f7f017f6000006000017f60017f017f60047f7f7f7f017f025f0603656e760b67657442696e56616c7565000303656e760a6765744374784e616d65000203656e7608676574506172616d000203656e76066d656d736574000403656e76067072696e7473000003656e760b73657442696e56616c75650001030a090502060704020607080404017000000503010001074505066d656d6f727902000869734d6574686f640007077265677573657200080873617968656c6c6f000c185f474c4f42414c5f5f7375625f495f74636173652e63707000060afb2409f202004100420037028c4041004200370294404100420037029c40410042003702a440410042003702ac40410041003602b440410041003602b840410041003602bc40410041003602c040410041003602c440410041003602c840410041003602cc40410041003602d040410041003602d440410041003602d840410041003602dc40410041003602e040410041003602e440410041003602e840410041003602ec40410041003602f040410041003602f440410041003602f840410041003602fc404100410036028041410041003602844141004100360288414100410036028c414100410036029041410041003602944141004100360298414100410036029c41410041003602a041410041003602a441410041003602a841410041003602ac41410041003602b041410041003602b441410041003602b841410041003602bc41410041003602c041410041003602c441410041003602c841410041003602cc41410041003602d041410041003602d4410b5b01027f0240024020012d0000220320002d0000470d00200141016a2101200041016a21000340200341ff0171450d0220002d0000210220012d00002103200141016a2101200041016a210020032002460d000b0b41000f0b41010be00101047f4100410028020441f0006b220336020441002102200341c0006a4100413010031a200341386a4200370300200341206a41106a4200370300200341286a420037030020034200370320200341106a4100280290453602002003410029038845370308200341002903804537030002400240200341c0006a1009450d00200341d4006a21000340200341206a20026a200020026a2d000022013a0000200241016a210220010d000b2003200329036837033841004103200341206a2003200341c0006a100a1b21020c010b410221020b4100200341f0006a36020420020bf90401057f4100410028020441a0106b220536020441002104200541106a410041801010031a200541106a41801010022102200541003a0000200520023602082005410036020c2005200541106a3602040240200520054190106a100b450d0002400240024020052d0090104106470d00410021042005280298104103470d03200520054190106a100b450d0320052d0090104105470d01200528029810220141016a4116490d02200541013a00000c030b200541063a00000c020b200541063a00000c010b0240024020052802042203450d002005410c6a280200220220016a200541086a2802004d0d010b200541043a00000c010b02402001450d00200320026a210420002102200121030340200220042d00003a0000200241016a2102200441016a21042003417f6a22030d000b2005410c6a28020021020b41002104200020016a41003a00002005410c6a200220016a360200200520054190106a100b450d000240024020052d0090104105470d00200528029810220141016a4116490d01200541013a0000410021040c020b200541063a00000c010b0240024020052802042203450d002005410c6a280200220220016a200541086a2802004d0d010b200541043a0000410021040c010b02402001450d00200041146a2104200320026a2102200121030340200420022d00003a0000200441016a2104200241016a21022003417f6a22030d000b2005410c6a28020021020b2005410c6a200220016a36020041002104200020016a41146a41003a0000200520054190106a100b450d00024020052d0090104104470d00200041286a200529039810370300410121040c010b200541063a00000b4100200541a0106a36020420040baf0603037f017e047f410041002802044190106b220a36020441002104200a41106a410041801010031a200a41023a0012200a41dc013b0110024020002d00002203450d00200041016a2105410021090340200520096a2107200941016a2204210920072d00000d000b0b200a41da013a0013200a20043a0015200a2004410874418080fc07714110763a0014024002400240024002400240200441ffff03712205450d00200541066a22084180104b0d02200a20033a0016024020054101460d00410120056b2104200041016a2109200a41106a41077221070340200720092d00003a0000200741016a2107200941016a2109200441016a22040d000b0b200541076a4180104d0d010c020b410621080b200a41106a20086a220941cf013a0000200841096a2208418110490d010b41002109200a41086a41002800a845360200200a41002900a045370200200a41017221040340200420096a2107200941016a2205210920072d00000d000b200a200510040c010b200941026a20002903182206423886200642288642808080808080c0ff0083842006421886428080808080e03f8320064208864280808080f01f838484200642088842808080f80f832006421888428080fc07838420064228884280fe0383200642388884848422064208883c0000200941016a20063c0000200941036a20064210883c0000200941046a20064218883c0000200941056a20064220883c0000200941066a20064228883c0000200941076a20064230883c0000200941086a20064238883c00004100210441002105024020012d0000450d00200141016a2100410021090340200020096a2107200941016a2205210920072d00000d000b0b024020022d0000450d00200241016a2100410021090340200020096a2107200941016a2204210920072d00000d000b0b410121092001200520022004200a41106a200810050d0141002109200a410e6a41002d00be453a0000200a410c6a41002f00bc453b0100200a41086a41002800b845360200200a41002900b045370200200a41017221040340200420096a2107200941016a2205210920072d00000d000b200a200510040b410021090b4100200a4190106a36020420090bf20902047f017e0240024020002802042202450d00200028020c220341016a220420002802084d0d010b200041023a000041000f0b200220036a2d000021022000410c6a200436020002400240024002400240024002400240024002400240024002400240200241bb7e6a220241174b0d00024020020e18000101010101010203040501010101010101010101060107000b200141003a00000240200041046a2802002202450d002000410c6a2203280200220441026a2205200041086a2802004d0d080b200041073a000041000f0b200041063a000041000f0b200141013a00000240200041046a2802002202450d002000410c6a2203280200220441016a200041086a2802004d0d070b200041043a000041000f0b200141023a00000240200041046a2802002202450d002000410c6a2203280200220441026a200041086a2802004d0d070b200041043a000041000f0b200141033a00000240200041046a2802002202450d002000410c6a2203280200220441046a200041086a2802004d0d070b200041043a000041000f0b200141043a00000240200041046a2802002202450d002000410c6a2203280200220441086a200041086a2802004d0d070b200041043a000041000f0b200141053a00000240200041046a2802002202450d002000410c6a2203280200220441026a2205200041086a2802004d0d070b200041043a000041000f0b200141063a00000240200041046a2802002202450d002000410c6a2203280200220441026a2205200041086a2802004d0d070b200041043a000041000f0b200220046a22002d0000210220002d0001210020032005360200200141086a200220004108747222004118742000410874418080fc07717241107636020041010f0b200141086a200220046a2d00003a00002003200328020041016a36020041010f0b200141086a2200200220046a22022d00003a0000200141096a20022d00013a00002003200328020041026a360200200020002f010022014118742001410874418080fc0771724110763b010041010f0b200141086a2205200220046a22002d00003a0000200141096a20002d00013a00002001410a6a200041026a2d00003a00002001410b6a200041036a2d00003a00002003200328020041046a3602002005200528020022004118742000410874418080fc07717220004108764180fe03712000411876727236020041010f0b200141086a2205200220046a22002d00003a0000200141096a20002d00013a00002001410a6a200041026a2d00003a00002001410b6a200041036a2d00003a00002001410c6a200041046a2d00003a00002001410d6a200041056a2d00003a00002001410e6a200041066a2d00003a00002001410f6a200041076a2d00003a00002003200328020041086a360200200520052903002206423886200642288642808080808080c0ff0083842006421886428080808080e03f8320064208864280808080f01f838484200642088842808080f80f832006421888428080fc07838420064228884280fe0383200642388884848437030041010f0b200220046a22002d0000210220002d0001210020032005360200200141086a200220004108747222004118742000410874418080fc07717241107636020041010f0b200220046a22002d0000210220002d0001210020032005360200200141086a200220004108747222004118742000410874418080fc07717241107636020041010bdc0201057f4100410028020441f0006b220436020441002103200441e0006a41003602002004420037035820044200370350200441d0006a411410011a024002400240024020042d0050450d00200441d0006a41017221000340200020036a2102200341016a2201210320022d00000d000b2001450d00200441386a41106a4100360200200441386a41086a420037030020044200370338200441306a4200370300200441186a41106a4200370300200441186a41086a420037030020044200370318200441106a41002802904536020020044100290388453703082004410029038045370300200441386a100d450d01200441d0006a2004200441386a200441186a100e450d022004200429033042017c37033041004103200441186a2004200441386a100a1b21030c030b41c0c50041231004410521030c020b410221030c010b41f0c500410f1004410621030b4100200441f0006a36020420030be40201057f4100410028020441a0106b220536020441002104200541106a410041801010031a200541106a41801010022102200541003a0000200520023602082005410036020c2005200541106a3602040240200520054190106a100b450d0002400240024020052d0090104106470d00410021042005280298104101470d03200520054190106a100b450d0320052d0090104105470d01200528029810220141016a4116490d02200541013a00000c030b200541063a00000c020b200541063a00000c010b0240024020052802042203450d002005410c6a280200220220016a200541086a2802004d0d010b200541043a00000c010b02402001450d00200320026a210420002102200121030340200220042d00003a0000200241016a2102200441016a21042003417f6a22030d000b2005410c6a28020021020b200020016a41003a00002005410c6a200220016a360200410121040b4100200541a0106a36020420040be20401077f4100410028020441a0106b220736020441002109200741004180101003210441002108024020002d0000450d00200041016a210a410021070340200a20076a2106200741016a2208210720062d00000d000b0b024020012d0000450d00200141016a210a410021070340200a20076a2106200741016a2209210720062d00000d000b0b4100210a024020022d0000450d00200241016a2105410021070340200520076a2106200741016a220a210720062d00000d000b0b20002008200120092002200a200441801010002106200441003a0080102004418010360288102004410036028c1020042004360284100240024020044180106a20044190106a100b450d0002400240024020042d0090104106470d002004280298104102470d0320044180106a20044190106a100b450d0320042d0090104105470d01200428029810220a41016a4116490d02200441013a0080100c030b200441063a0080100c020b200441063a0080100c010b024002402004280284102207450d002004418c106a2802002209200a6a20044188106a2802004d0d010b200441043a0080100c010b0240200a450d00200720096a210720032109200a21080340200920072d00003a0000200941016a2109200741016a21072008417f6a22080d000b2004418c106a28020021090b410021072003200a6a41003a00002004418c106a2009200a6a36020020044180106a20044190106a100b450d01024020042d0090104104470d00200341186a2004290398103703004101210720060d024180c600411310040c010b200441063a0080100c010b410021070b4100200441a0106a36020420070b0bab01070041040b0420630000004180c5000b147573657264657461696c000000000000000000000041a0c5000b0c7061636b206661696c6564000041b0c5000b0f73617665206462206661696c6564000041c0c5000b244552524f523a20476574206d7920636f6e7472616374206e616d65206661696c65642e000041f0c5000b1067657444617461206661696c65642100004180c6000b1467657442696e56616c7565206661696c65642100"

============ABI===============

{ "types": [], "structs": [ { "name": "UserInfo", "base": "", "fields": { "userName": "string", "userRole": "string", "rcvHelloNum": "uint64" } }, { "name": "SayHello", "base": "", "fields": { "userName": "string" } }, { "name": "UserDetail", "base": "", "fields": { "userRole": "string", "rcvHelloNum": "uint64" } } ], "actions": [ { "action_name": "reguser", "type": "UserInfo" }, { "action_name": "sayhello", "type": "SayHello" } ], "tables": [ { "table_name": "userinfo", "index_type": "string", "key_names": [ "userName" ], "key_types": [ "string" ], "type": "UserDetail" } ] }

BCLI获取合约TABLE信息

帮助信息

./bcli gettable --help
NAME:
bcli gettable - get table info

USAGE:
    bcli gettable [command options] [arguments...]

OPTIONS:
    --contract value  contract name (default: "usermng")
    --table value     table name
    --key value       Key value

参数说明

主命令行	参数列表	参数说明	必选参数
bcli gettable	--contract	合约账户名	是
	--table	要向链上查询的TABLE名（参考ABI文件TABLE描述）	是
	--key	要向链上查询的key关键字值（参考ABI文件TABLE描述）	是

返回信息

该命令成功后将返回BCLI发送的Transaction信息。

示例

./bcli gettable --table userdetail --account lyp12345678 --key lyp

输出结果

{
	"contract": "lyp12345678",
    "object": "userdetail",
    "key": "lyp",
    "value": "dc0003da00036c7970cf0000000000000016c5001000000000000000000000000000000021"
}

Table data is : map[lyp:33 userrole:lyp rcvhellonum:22]

5.7.3.3 BCLI 候选节点选举功能命令行

BCLI候选节点功能选举命令行主线实现候选节点之：注册节点为生产节点，解注册生产节点，列举所有（部分）生产节点信息，投票（投某节点成为生产节点），取消投票，领取出块奖励等。

总体帮助信息如下

./bcli delegate --help
NAME:
    Bottos bcli tool delegate - for delegate operations

USAGE:
    Bottos bcli tool delegate command [command options] [arguments...]

COMMANDS:
    register     register delegate
    cancel       cancel delegate
    list         list delegates
    vote         Vote for delegate
    cancelvote   cancel vote for producers
    claimreward  claim reward for producers

OPTIONS:
    --help, -h  show help

命令功能说明

主命令行	参数列表	参数说明
./bcli delegate	register	注册为生产者
./bcli delegate	cancel	解注册生产者
./bcli delegate	list	查看生产者列表
./bcli delegate	vote	选举生产者
./bcli delegate	cancelvote	取消选举
./bcli delegate	claimreward	生产者领取出块奖励

BCLI注册生产节点命令行

帮助信息

./bcli delegate register --help
NAME:
    Bottos bcli tool delegate register - register delegate

USAGE:
    Bottos bcli tool delegate register [command options] [arguments...]

OPTIONS:
--account value      account name
--signkey value      public sign key
--location value     location
--description value  description

参数说明

主命令行	参数列表	参数说明	必选参数
bcli delegate reg	--account	用户名	是
	--signkey	用户自定义公钥（缺省为内置缺省值）	是
	--location	投票地理城市名	否
	--description	用户自定义描述	否

返回信息

该命令成功后将返回BCLI发送的Transaction信息。

示例

./bcli delegate register --account user12345678 --location "SHANGHAI" --description "Reg user12345678 as a producer" --signkey 0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f

输出结果

TrxHash: 53e25c2b281251e44bf24e2f552b101daf60399b7a44adcc9810fd10908ff23e

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

注：此命令执行前提：创世节点必须成功移交出块权利。参考命令./bcli genesis blkprodtrans --sender bottos --actblknum 2000

BCLI解注册生产节点命令行

帮助信息

./bcli  delegate cancel  --help

NAME:
    Bottos bcli tool delegate cancel - cancel delegate

USAGE:
    Bottos bcli tool delegate cancel [command options] [arguments...]

OPTIONS:
    --account value  account

参数说明

主命令行	参数列表	参数说明	必选参数
bcli delegate cancel	--account	用户名	是

返回信息

该命令成功后将返回BCLI发送的Transaction信息。

示例

./bcli delegate cancel --account user12345678

输出结果

TrxHash: 3ff592e51ff483d7a6409aab2f54b52d7bd721ce009b73ac59544443074d8802

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI列举当前生产节点列表

帮助信息

./bcli delegate list --help
NAME:
Bottos bcli tool delegate list - list delegates

USAGE:
    Bottos bcli tool delegate list [command options] [arguments...]

OPTIONS:
    --limit value  (default: 100)
    --start value  (default: 0)

参数说明

主命令行	参数列表	参数说明	必选参数
bcli delegate list	--limit	输出前N条记录	否
	--start	从第几条开始输出和统计条数	否

返回信息

该命令成功后将返回BCLI发送的delegate list信息。

示例

./bcli delegate list

输出结果

[
    {
        "account_name": "delegatecreate2",
        "active": true,
        "description": "",
        "location": "",
        "public_key": "04cc788ad88378837658b150f33440bf531aea0acc13a6921814b1e01927fd812ddb5ade669c784f34af3350b9188c8b63bb114b5afde4f64bbbab0ccd1f925458",
        "transit_votes": "50000000000",
        "votes": "50000000000"
    },
    {
        "account_name": "delegatecreate3",
        "active": true,
        "description": "",
        "location": "",
        "public_key": "0458e35c99eb4cb431653b0682bd51ebfcff1869a41f8eadb915b67e82d72f71f7dd5154108954dc818140f8991e186b55d774fd7b156914b4baa1d352d2d7765b",
        "transit_votes": "50000000000",
        "votes": "50000000000"
    },
    {
        "account_name": "delegatecreate4",
        "active": true,
        "description": "",
        "location": "",
        "public_key": "043e3f77eb8154dbeaf28379abdf88dba44b2528268ab63f5b726a3ffd4619c7f7003dc761a47e09ef6edb9a615684caa3f859fbe39e6f15fb5305e24419d941b7",
        "transit_votes": "50000000000",
        "votes": "50000000000"
    },
    .....
    ....
    .... (略)
]

BCLI生产者投票命令行

帮助信息

./bcli delegate vote --help
NAME:
Bottos bcli tool delegate vote - Vote for producers

USAGE:
    Bottos bcli tool delegate vote [command options] [arguments...]

OPTIONS:
    --voter value     voter account
    --delegate value  delegate account

参数说明

主命令行	参数列表	参数说明	必选参数
bcli delegate vote	--voter	投票者	是
	--delegate	要投给哪个生产节点（必须投给已注册为生产节点的节点）	是

返回信息

该命令成功后将返回BCLI发送的Transaction信息。

示例

./bcli delegate vote --voter bottos --delegate user12345678

输出结果

TrxHash: bb6dde5aba1db736495e864a4fa085640cbeb7d88aef11958f764a1423ba3f90

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI生产者取消投票命令行

帮助信息

./bcli delegate cancelvote --help
NAME:
Bottos bcli tool delegate cancelvote - cancel vote for producers

USAGE:
    Bottos bcli tool delegate cancelvote [command options] [arguments...]

OPTIONS:
    --voter value     voter account
    --delegate value  delegate account

参数说明

主命令行	参数列表	参数说明	必选参数
bcli delegate cancelvote	--voter	投票者	是
	--delegate	要取消投给哪个生产节点（必须填写注册为生产节点的节点）	是

返回信息

该命令成功后将返回BCLI发送的Transaction信息。

示例

./bcli delegate cancelvote --voter bottos --delegate user12345678

输出结果

TrxHash: 86a503abd101f3473d5e121fa3e7665ff0f274fc5739ea649bf070177ffb2091

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI生产者领取出块奖励

帮助信息

./bcli delegate claimreward -h
NAME:
    Bottos bcli tool delegate claimreward - claim reward for producers

USAGE:
    Bottos bcli tool delegate claimreward [command options] [arguments...]

OPTIONS:
    --account value  account name

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli delegate claimreward	--account	生产者账号名	是

返回信息

该命令成功后将返回BCLI发送的Transaction信息。

示例

./bcli delegate claimreward --account delegatecreate2

输出结果

TrxHash: de8dcdbcd92c88250801a96a4db9260455c16c595abb7328b5e0a638695a0bdb

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

5.7.3.4 BCLI 块信息获取命令行

BCLI块信息获取主要包括：获取当前块信息，块头信息。

BCLI块头信息获取命令行

帮助信息

./bcli getblkheader --help
NAME:
    bcli getblkheader - get header block's information

USAGE:
    bcli getblkheader [arguments...]

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli getblkheader	(无)	(无)	(无)
	(无)	(无)	(无)

返回信息

该命令成功后将返回实时最新块头信息。

示例

./bcli getblkheader

输出结果

==Chain Info==

{
    "head_block_num": 1077,
    "head_block_hash": "f6173c548f2d2bc25d86232cb2d451c7b8d6ba3763477a212a33af4237eae6e7",
    "head_block_time": 1548323109,
    "head_block_delegate": "bottos",
    "cursor_label": 938141415,
    "last_consensus_block_num": 1077,
    "chain_id": "4b97b92d2c78bcffe95ebd3067565c73a2931b39d5eb7234b11816dcec54761a",
    "head_block_version": 65536
}

BCLI最新块信息获取命令行

帮助信息

./bcli getblock --help
NAME:
    bcli getblock - get block information

USAGE:
    bcli getblock [command options] [arguments...]

OPTIONS:
    --num value    get latest block by number: if this section is not set, then get the latest block, otherwise get the specific block of the number (default: 0)
    --hash value   get specific block by hash
    --start value  get specific block from start num(do not use with --num or --hash) (default: 0)
    --end value    get specific block to end num (do not use with --num or --hash) (default: 0)

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli getblock	--num	查看指定块号对应的块	否
	--hash	查看指定查询的BLOCK HASH对应的块	否
	--start	查看指定范围的若干个块信息, start 为查看的起始块号，最多只能查看10个块	否
	--end	查看指定范围的若干个块信息, end 为查看的终止块号, 最多只能查看10个块	否

返回信息

该命令成功后将返回实时最新块信息。不指定上述可选项时总是返回当前最新块。

示例

./bcli getblock

输出结果

==Block Info==

{
    "block_version": 65536,
    "prev_block_hash": "dcf00f755695521d5342c4f9d5889490d2da754076a941a824ef4a1c2019bd94",
    "block_num": 1136,
    "block_hash": "e2d1dd86e473eb46ecf20522049f2ade4c3f89875b888c19d617d284ddf3f1a5",
    "cursor_block_label": 3723751845,
    "block_time": 1548323286,
    "trx_merkle_root": "0000000000000000000000000000000000000000000000000000000000000000",
    "delegate": "bottos",
    "delegate_sign": "fa6f1c0666db6bbb82c75f5bb45f7e6e892804a270304c2d9d653a17da4ef5477f5bc50896ae7f7d5dcf743f1a0726d177209288acdb61d2b3a519a8b13c6464",
    "trxs": null
}

5.7.3.5 BCLI 创世节点功能命令行

BCLI创世节点功能命令行主要包括：添加初始生产者，移交出块权利，撤销创世节点特权操作权限。

总体帮助信息如下

./bcli genesis --help

NAME:
    Bottos bcli tool genesis - for genesis node operations

USAGE:
    Bottos bcli tool genesis command [command options] [arguments...]

COMMANDS:
    setdelegate      set delegate
    unsetdelegate    unset delegate
    blkprodtrans     for genesis node transfering the permission of producing blocks
    cancelprevilige  cancel genesis node permission
    settransitvote   set transit vote
    newstkaccount    transfer erc20

OPTIONS:
    --help, -h  show help

命令功能说明

主命令行	参数列表	参数说明
./bcli genesis	setdelegate	创世节点上指定初始生产者
./bcli genesis	blkprodtrans	创世节点移交出块权利
./bcli genesis	cancelprevilige	创世节点取消操作权限
./bcli genesis	unsetdelegate	创世节点上取消指定初始生产者
./bcli genesis	settransitvote	过渡期为生产者节点投票
./bcli genesis	newstkaccount	过渡期创建生产者账号，并质押一定量BTO

BCLI创世节点添加初始生产者功能命令行

帮助信息

./bcli genesis setdelegate --help
NAME:
    Bottos bcli tool genesis setdelegate - set delegate

USAGE:
    Bottos bcli tool genesis setdelegate [command options] [arguments...]

OPTIONS:
    --sender value       sender account
    --account value      account name
    --signkey value      public sign key
    --location value     location
    --description value  description

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli genesis setdelegate	--sender	发起签名者（必须为已注册用户名，缺省为内置bottos用户）	否
	--account	要被添加的初始生产者用户名	是
	--signkey	用户的公钥	是
	--location	用户指定的城市名	否
	--description	用户指定的描述	否

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

./bcli genesis setdelegate --sender bottos --account user12345678 --signkey 0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f

输出结果

TrxHash: e453df77a6f1a2049e79dd9853e8f16945968ffe8e3c168e5fe29788fb8dc898

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI创世节点移交出块权利功能命令行

帮助信息

./bcli genesis blkprodtrans --help
NAME:
Bottos bcli tool genesis blkprodtrans - for genesis node transfering the permission of producing blocks

USAGE:
    Bottos bcli tool genesis blkprodtrans [command options] [arguments...]

OPTIONS:
    --sender value     sender account
    --actblknum value  the threshold number of active block for which genesis node transfering the permission of producing blocks after exceeding it (default: 0)

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli genesis blkprodtrans	--sender	发起签名者（必须为已注册用户名，缺省为内置bottos用户）	否

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

 ./bcli genesis blkprodtrans --sender bottos --actblknum 2000

输出结果
TrxHash: 29267535acadefb100113915652a4ba9d9b00dafbefbe61bc9f1f5fdd24249c0

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI撤销创世节点特权操作权限功能命令行

帮助信息

./bcli genesis cancelprevilige --help
NAME:
Bottos bcli tool genesis cancelprevilige - cancel genesis node permission

USAGE:
    Bottos bcli tool genesis cancelprevilige [command options] [arguments...]

OPTIONS:
    --sender value  sender account

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli genesis cancelprevilige	--sender	发起签名者（必须为已注册用户名，缺省为内置bottos用户）	否

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

./bcli genesis cancelprevilige --sender bottos

输出结果

TrxHash: 42e93f4a6f3a631d469449e418a624ede196b2e4d096b29bd1ccaaca1e83ee10

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI创世节点上取消指定初始生产者

帮助信息

./bcli genesis unsetdelegate --h
NAME:
    Bottos bcli tool genesis unsetdelegate - unset delegate

USAGE:
    Bottos bcli tool genesis unsetdelegate [command options] [arguments...]

OPTIONS:
    --sender value   sender account
    --account value  account name

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli genesis unsetdelegate	--sender	sender需要指定bottos	是
./bcli genesis unsetdelegate	--account	之前被投过票的某个生产者	是

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

./bcli genesis unsetdelegate --sender bottos --account lyp12345678

输出结果

TrxHash: 602ceed3970de1948a3a0d76ee8e5b82dc29a7ec741d576327938d883d06cc18

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI创世节点上过渡期为生产者投票

帮助信息

./bcli genesis settransitvote --h
NAME:
    Bottos bcli tool genesis settransitvote - set transit vote

USAGE:
    Bottos bcli tool genesis settransitvote [command options] [arguments...]

OPTIONS:
    --sender value   sender account
    --account value  account name
    --vote value     election votes (default: 0)

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli genesis settransitvote	--sender	sender需要指定bottos	是
./bcli genesis settransitvote	--account	投票给某个生产者名	是
./bcli genesis settransitvote	--vote	投票数量	是

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

./bcli genesis settransitvote --sender bottos --account lyp12345678 --vote 100

输出结果

TrxHash: 545d8ce9032756dd9305fd2ce14cce5c18aaa39f94eff1791fbc1fe41bf9e4a0

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI创世节点创建生产者账号，并迁移和质押一定量的BTO

帮助信息

./bcli genesis newstkaccount -h
NAME:
   Bottos bcli tool genesis newstkaccount - transfer erc20

USAGE:
   Bottos bcli tool genesis newstkaccount [command options] [arguments...]

OPTIONS:
   --sender value       sender account
   --account value      account name
   --pubkey value       account public key
   --transfer value     the amount of bto
   --stake-space value  the amount of bto
   --stake-time value   the amount of bto
   --stake-vote value   the amount of bto

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli genesis newstkaccount	--sender	sender需要指定bottos	是
./bcli genesis newstkaccount	--account	创建账户的名字	是
./bcli genesis newstkaccount	--pubkey	账户的公钥	是
./bcli genesis newstkaccount	--transfer	迁移代币的总数量	是
./bcli genesis newstkaccount	--stake-space	迁移代币中，用于质押space的数量	是
./bcli genesis newstkaccount	--stake-time	迁移代币中，用于质押time的数量	是
./bcli genesis newstkaccount	--stake-vote	迁移代币中，用于质押vote的数量	是

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

./bcli genesis newstkaccount --account delegatecreate5  --transfer 490000 --stake-space 100000 --stake-time 100000 --stake-vote 100000 --sender bottos --pubkey 04ecec203a98be1d27d38d189a8f16f65a24e6ba813e139fdd82bf84c44bef36ffe5813f5cd9a8ab34b4a0c8f490beda68d81b22897f436a24a1ca1cec7c064e06

输出结果

TrxHash: f1017b6303171b1b919a986f98dc191d3a3af54fbbcae6f30340436e234ea0b0

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

查看创建的账户信息：

./bcli account get --account delegatecreate5

Account: delegatecreate5
    Balance: 1900000.00000000 BTO
    Pubkey: 04ecec203a98be1d27d38d189a8f16f65a24e6ba813e139fdd82bf84c44bef36ffe5813f5cd9a8ab34b4a0c8f490beda68d81b22897f436a24a1ca1cec7c064e06

    StakedBalance: 100000.00000000 BTO
    UnStakingBalance: 0.00000000 BTO
    StakedSpaceBalance: 100000.00000000 BTO
    StakedTimeBalance: 100000.00000000 BTO
    UnStakingTimestamp: 0

    Resource: {
        "free_available_space": 569,
        "free_used_space": 231,
        "stake_available_space": 151142399536,
        "stake_used_space": 464,
        "free_available_time": 200,
        "free_used_time": 200,
        "stake_available_time": 28799999900,
        "stake_used_time": 100
     }

    UnClaimedBlockReward: 0.00000000 BTO
    UnClaimedVoteReward: 0.00000000 BTO
    UnClaimedTotalReward: 0.00000000 BTO

    Vote: N/A

    Contracts: N/A

5.7.3.6 BCLI 转账功能命令行

BCLI转账功能负责由FROM用户向TO用户进行BTO转账。

BCLI转账命令行

帮助信息

./bcli transfer --help

NAME:
bcli transfer - for user transfering bto

USAGE:
    bcli transfer [command options] [arguments...]

OPTIONS:
    --from value    the from user account (default: "bottos")
    --to value      the [to] user account (default: "bottos")
    --amount value  the amount of bto (default: "0")
    --memo value	the memory note of transfer(within 32 bytes)

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli transfer	--from	转账者	否
	--to	转账目的人	否
	--amount	转账BTO个数	否
	--memo	转账备忘录	否

返回信息

该命令成功后将返回BCLI提交的Transaction信息。

示例

./bcli transfer --from bottos --to user12345678 --amount 2

输出结果

TrxHash: 33004bf950b3af9c2b515654e570755baa8db9e40a57a826812a0f71129a49d2

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

5.7.3.7 BCLI Transaction 提交和查询命令行

BCLI Transaction 提交和查询命令行负责提交一个用户自定义的Transaction到链上，或根据TrxHash值查询一个已存在的合约信息。

总体帮助信息如下

./bcli transaction --help

NAME:
Bottos bcli tool transaction - get or push transactions

USAGE:
Bottos bcli tool transaction command [command options] [arguments...]

COMMANDS:
    get   get tx details
    push  push transaction

OPTIONS:
--help, -h  show help

命令功能说明

主命令行	参数列表	参数说明
./bcli transaction	get	获取指定TRXHASH对应的transaction信息
./bcli transaction	push	提交一个Transaction

BCLI Transaction查询命令行

帮助信息

./bcli transaction get --help

NAME:
    Bottos bcli tool transaction get - get tx details

USAGE:
    Bottos bcli tool transaction get [command options] [arguments...]

OPTIONS:
    --trxhash value

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli transaction get	--trxhash	Transaction hash索引值	是

返回信息

该命令成功后将返回指定Trxhash对应的Transaction信息。

示例

./bcli transaction get --trxhash 8a403642ea7b51595d1a1454b43b83ba62420629581c3d2f0d2143342aa89c9f

输出结果

{
    "ResourceReceipt": null,
    "Transaction": {
        "contract": "bottos",
        "cursor_label": 384655640,
        "cursor_num": 1390,
        "lifetime": 1548324148,
        "method": "transfer",
        "param": {
            "from": "bottos",
            "memo": "",
            "to": "accountcreate5",
            "value": 10000000000
        },
        "sender": "bottos",
        "sig_alg": 1,
        "signature": "97a3a4d4e103ed60e94cb79ba83fa0bae7eb623feceee6222dfd06156cd705b35ee5d85a07ab8b2e1ca95267408d4bf0b9d78fc7aa063e7d4a5ba67a1953b1c3",
        "version": 65536
    },
    "TrxHash": "8a403642ea7b51595d1a1454b43b83ba62420629581c3d2f0d2143342aa89c9f"
}

<<<Transaction Status>>> : commited

BCLI Transaction提交命令行

帮助信息

./bcli transaction push --help
NAME:
    Bottos bcli tool transaction push - push transaction

USAGE:
    Bottos bcli tool transaction push [command options] [arguments...]

OPTIONS:
    --sender value    acocunt name
    --contract value  contract name
    --method value    method name
    --param value     param value

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli transaction push	--sender	签名发起者（缺省为内置bottos用户）	否
./bcli transaction push	--contract	合约名	是
./bcli transaction push	--method	合约方法名	是
./bcli transaction push	--param	参数键值对	是

返回信息

该命令成功后将返回指定Trxhash对应的Transaction信息。

示例

./bcli transaction push --sender lyp12345678 --contract lyp12345678 --method reguser --param

输出结果

"userName:lyp, userRole:lyp, rcvHelloNum:22, lyp:33"
0 : {userName string} , KEY:  userName , VAL:  lyp
1 : {userRole string} , KEY:  userRole , VAL:  lyp
2 : {rcvHelloNum uint64} , KEY:  rcvHelloNum , VAL:  22
3 : {lyp uint128} , KEY:  lyp , VAL:  33

TrxHash: cb9a695f9f8dfa02e81caf58fc9def571d892b95fd168a9c2f7eb701ee802ed3

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

5.7.3.8 BCLI钱包命令行

钱包功能主要为用户提交Transaction提供钱包创建，绑定用户，解锁钱包，锁定钱包，查询钱包等功能。

帮助信息

./bcli wallet --help

NAME:
Bottos bcli tool wallet - For wallet operations

USAGE:
Bottos bcli tool wallet command [command options] [arguments...]

COMMANDS:
    generatekey  generate key pairs
    create       create wallet
    lock         lock wallet
    unlock       unlock wallet: only one account can be unlocked at same time(if one account is unlocked, the another previous unlocked account will be locked itself.)
    list         list wallet
    listkey      listkey of wallet
    
OPTIONS:
    --help, -h  show help

命令功能说明

主命令行	参数列表	参数说明
./bcli wallet	generatekey	创建一对新公私钥对
./bcli wallet	create	创建钱包
./bcli wallet	lock	锁定钱包
./bcli wallet	unlock	解锁钱包
./bcli wallet	list	列出所有钱包
./bcli wallet	listkey	列出所有指定用户的钱包和公钥（钱包必须先解除锁定才可查得）

BCLI 创建钱包公私钥命令行

帮助信息

./bcli wallet generatekey --help

NAME:
    Bottos bcli tool wallet generatekey - generate key pairs

USAGE:
    Bottos bcli tool wallet generatekey [arguments...]

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli wallet generatekey	(无)	（无）	（无）

返回信息

该命令成功后将返回一对新生成的公私钥对。

示例

 ./bcli wallet generatekey

输出结果 { "private_key": "b8b890ebc315a8e1c3a6f7b78977d68ca1e9274c986314ccbe967b964cf68b66", "public_key": "0485fccecf8c8e6260d8558e1a61adca3a888127e34ba0d052dfeb1c31d419bf0494482e7e8a447d63394cff713fc00aa8e64c24b73a8173661a91884b71407bce" }

BCLI 创建钱包命令行

帮助信息

./bcli wallet create --help

NAME:
Bottos bcli tool wallet create - create wallet

USAGE:
Bottos bcli tool wallet create [command options] [arguments...]

OPTIONS:
--account value  account name
--type value 	 type of restful for wallet [normal | delegate] (default: "normal")

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli wallet create	--account	钱包绑定的用户名	是
	--type	钱包用途类型，normal：用于转账、投票等操作；delegate：用于生产者出块签名	否

返回信息

该命令成功后将返回用户的钱包文件keystore信息，路径位于/home/bottos/bot下，文件格式为用户.keystore 文件。

示例

./bcli wallet create --account user12345678

输出结果

Please input your password for your wallet:

Please input your private key for your wallet:

{ "wallet_name": "user12345678.keystore" }

注：本例中需要用户手工输入钱包密码和使用的私钥。

BCLI 锁定钱包命令行

帮助信息

./bcli wallet lock --help

NAME:
Bottos bcli tool wallet lock - lock wallet

USAGE:
Bottos bcli tool wallet lock [command options] [arguments...]

OPTIONS:
--account value  account name
--type value     type of restful for wallet [ normal | delegate ] (default: "normal")

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli wallet lock	--account	钱包绑定的用户名	是
	--type	normal 或 delegate方式创建钱包	否

返回信息

该命令成功后将返回钱包锁定状态标志。

示例

./bcli wallet lock --account user12345678

输出结果

{
    "lock": true
}

BCLI 解锁钱包命令行

帮助信息

./bcli wallet unlock --help

NAME:
   Bottos bcli tool wallet unlock - unlock wallet: only one account can be unlocked at same time(if one account is unlocked, the another previous unlocked account will be locked itself.)

USAGE:
   Bottos bcli tool wallet unlock [command options] [arguments...]

OPTIONS:
   --account value  account name
   --type value     type of restful for wallet [ normal | delegate ] (default: "normal")
   --timeout value  timeout of wallet unlock state in seconds. If timeout is set to 0, it means always keeping wallet unlocked (no time out). (default: 300)

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli wallet unlock	--account	钱包绑定的用户名	是
	--type	normal 或 delegate方式创建钱包	否
	--timeout	钱包解锁时长	否

返回信息

该命令成功后将返回钱包锁定状态标志。

示例

./bcli wallet unlock --account user12345678

输出结果

Please input your password for your wallet: 

{
    "unlock": true
}

注：本例要求用户输入当时创建钱包时的密码。

BCLI 查看所有钱包命令行

帮助信息

./bcli wallet list --help

NAME:
	Bottos bcli tool wallet list - list wallet

USAGE:
	Bottos bcli tool wallet list [arguments...]

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli wallet list	(无)	(无)	否

返回信息

该命令成功后将返回钱包锁定状态标志。

示例

./bcli wallet list

输出结果

[
    {
        "account_name": "user12345678",
        "public_key": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f",
        "wallet_path": "/home/bottos/bot/user12345678.keystore"
    }
]

BCLI 查看用户钱包公钥命令行

帮助信息

./bcli wallet listkey --help

NAME:
    Bottos bcli tool wallet listkey - listkey of wallet

USAGE:
    Bottos bcli tool wallet listkey [command options] [arguments...]

OPTIONS:
    --account value  account name
    --type value 	 normal | delegate (default: "normal")

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli wallet listkey	--account	钱包绑定的用户名	是
	--type	选择 normal 或 delegate钱包	否

返回信息

该命令成功后将返回钱包锁定状态标志。

示例

 ./bcli wallet listkey --account bottos

输出结果

{
    "account_name": "bottos",
    "public_key": "0454f1c2223d553aa6ee53ea1ccea8b7bf78b8ca99f3ff622a3bb3e62dedc712089033d6091d77296547bc071022ca2838c9e86dec29667cf740e5c9e654b6127f"
}

注：此命令要求账户钱包处于解锁状态，否则listkey将会显示为空｛｝

BCLI 日志功能命令行

帮助信息

./bcli log setconfigitem --h

NAME:
   Bottos bcli tool log setconfigitem - set log config item. If you need change the log confiration in your configuration, please also input the --serveraddr <LogRESTHost>:<LogRESTPort> firstly in this command

USAGE:
   Bottos bcli tool log command [command options] [arguments...]

COMMANDS:
     setconfigitem  set log config item. If you need change the log confiration in your configuration, please also input the --serveraddr <LogRESTHost>:<LogRESTPort> firstly in this command

OPTIONS:
	--key value    log config item key [minlevel | maxrolls]
    --value value  log config item value, minlevel usage:the minimum log level [debug | info | warn | error | critical], default value:error; maxrolls usage:the maximum number of log files, default value:300

参数说明

主命令行	参数列表	参数说明	必选参数
./bcli log setconfigitem	--key	日志参数，选其一设置：minlevel	maxlevel
./bcli log setconfigitem	--value	按日志参数，填写对应项值	是

返回信息

该命令成功后将返回执行结果。

示例

./bcli log  setconfigitem --key minlevel --value debug

输出结果

{
    "errcode": 0
}
setconfigitem successfully.

5.7.3.9 BCLI P2P命令行

P2P功能主要为用户提供连接网络、断开网络、查询状态、查询邻居信息等功能。

帮助信息

 ./bcli p2p --help
NAME:
   Bottos bcli tool p2p - for p2p connection

USAGE:
   Bottos bcli tool p2p command [command options] [arguments...]

COMMANDS:
     connect     connect address or port
     disconnect
     status      p2p status
     peers       peers information

OPTIONS:
   --help, -h  show help

BCLI列举本节点连接的邻居信息列表

帮助信息

./bcli p2p peers --help
NAME:
   Bottos bcli tool p2p peers - peers information

USAGE:
   Bottos bcli tool p2p peers [command options] [arguments...]

OPTIONS:
   --limit value  (default: 100)
   --start value  (default: 0)

参数说明

主命令行	参数列表	参数说明	必选参数
bcli p2p peers	--limit	输出前N条记录	否
	--start	从第几条开始输出和统计条数	否

返回信息

该命令成功后将返回BCLI发送的peer信息。

示例

./bcli p2p peers

输出结果

{
    "data": [
        {
            "addr": "127.0.0.1",
            "chain_id": "4b97b92d2c78bcffe95ebd3067565c73a2931b39d5eb7234b11816d    cec54761a",
            "head_block_num": 1215,
            "last_consensus_block_num": 1215,
            "port": "9871",
            "version": 197632
        },
        {
            "addr": "127.0.0.1",
            "chain_id": "4b97b92d2c78bcffe95ebd3067565c73a2931b39d5eb7234b11816d     cec54761a",
            "head_block_num": 1215,
            "last_consensus_block_num": 1215,
            "port": "9872",
            "version": 197632
        },
        
    ],
    "peerCount": 2
}

5.7.3.10 BCLI 多重签名命令行

多重签名功能为用户提供多重签名提案的创建，提交，审查，处理，执行以及撤销等功能。

帮助信息

./bcli multisign --help

NAME:
   Bottos bcli tool multisign - for multisign operations

USAGE:
   Bottos bcli tool multisign command [command options] [arguments...]

COMMANDS:
     create     create multisign account
     push       push multisign proposal
     review     review multisign proposal
     approve    approve multisign proposal
     unapprove  unapprove multisign proposal
     exec       exec multisign proposal
     cancel     cancel multisign proposal

OPTIONS:
   --help, -h  show help

BCLI 多重签名账号创建

帮助信息

./bcli multisign create --help

NAME:
   Bottos bcli tool multisign create - create multisign account

USAGE:
   Bottos bcli tool multisign create [command options] [arguments...]

OPTIONS:
   --account value    multisign account name
   --authority value  multisign account authority
   --threshold value  multisign account threshold
   --referrer value   multisign account referrer

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign create	--account	多签账户名称	是
	--authority	多签账户授权	是
	--threshold	多签阈值	否
	--referrer	多签引用	否

返回信息

该命令成功后返回命令产生的账号创建交易的hash。

示例

./bcli multisign create --account multisigntest --authority '[{"author_account": "multisign0","weight": 1}]' --threshold 1 --referrer bottos

输出结果

./bcli multisign create --account multisigntest --authority '[{"author_account": "multisign0","weight": 1}]' --threshold 1 --referrer bottos

TrxHash: 2342200067b7dacf0a69da437f07a7d96401d08400fa4c095a76d20d74da8dee

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI 提交转账提案合约功能

帮助信息

./bcli multisign push -help

NAME:
   Bottos bcli tool multisign push - push multisign proposal

USAGE:
   Bottos bcli tool multisign push [command options] [arguments...]

OPTIONS:
   --proposal value  proposal name
   --account value   multisign account name
   --transfer value  transfer data
   --proposer value  proposer account name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign push	--proposal	提案名称	是
	--account	多签账户名	是
	--transfer	转账数据	是
	--proposer	提案人账户名	是

返回信息

该命令成功后返回命令产生的提案提交交易的hash。

示例

./bcli multisign push --proposal proposaltest --account multisigntest --transfer '{"from":"bottos","to":"multisign0","amount":"1","memo":"test"}' --proposer bottos

输出结果

./bcli multisign push --proposal proposaltest --account multisigntest --transfer '{"from":"bottos","to":"multisign0","amount":"1","memo":"test"}' --proposer bottos

TrxHash: b9d1425b10083020fc8abf11565ed1ce345bd70ca40b7db017efa9f4512b14b0

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI 审查转账提案合约功能

帮助信息

./bcli multisign review -h

NAME:
   Bottos bcli tool multisign review - review multisign proposal

USAGE:
   Bottos bcli tool multisign review [command options] [arguments...]

OPTIONS:
   --proposer value  proposer name
   --proposal value  proposal name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign review	--proposer	提案人账户名	是
	--proposal	提案名称	是

返回信息

该命令成功后返回指定提案的内容信息。

示例

./bcli multisign review --proposer bottos --proposal proposaltest

输出结果

./bcli multisign review --proposer bottos --proposal proposaltest

ProposalName: proposaltest

    MsignAccountName: multisigntest

    AuthorList: [author_account:"multisign0" ]

    Available: true

    PackedTransaction: 7b2266726f6d223a22626f74746f73222c22746f223a226d756c74697369676e30222c22616d6f756e74223a22313030303030303030222c226d656d6f223a2274657374227d

    Transaction: [from:"bottos" to:"multisign0" amount:"100000000" memo:"test" ]

    Time: 1562740920

BCLI 签署提案功能

帮助信息

./bcli multisign approve -help

NAME:
   Bottos bcli tool multisign approve - approve multisign proposal

USAGE:
   Bottos bcli tool multisign approve [command options] [arguments...]

OPTIONS:
   --proposal value  proposal name
   --account value   multisign account name
   --proposer value  proposer name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign approve	--proposer	提案人账户名	是
	--proposal	提案名称	是
	--account	多签账户名称	是

返回信息

该命令成功后返回命令产生的提案签署交易的hash。

示例

./bcli multisign approve --proposal proposaltest --account bottos --proposer bottos

输出结果

./bcli multisign approve --proposal proposaltest --account bottos --proposer bottos

TrxHash: 2d5669254ccbeed0edb7a62f8a468c1ebc637c0418fd76497b5dc94a625d45d8

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI 撤销签署提案功能

帮助信息

./bcli multisign unapprove -help

NAME:
   Bottos bcli tool multisign unapprove - unapprove multisign proposal

USAGE:
   Bottos bcli tool multisign unapprove [command options] [arguments...]

OPTIONS:
   --proposal value  proposal name
   --account value   multisign account name
   --proposer value  proposer name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign unapprove	--proposer	提案人账户名	是
	--proposal	提案名称	是
	--account	多签账户名称	是

返回信息

该命令成功后返回命令产生的提案签署撤销交易的hash。

示例

./bcli multisign unapprove --proposal proposaltest --account bottos --proposer bottos

输出结果

./bcli multisign unapprove --proposal proposaltest --account bottos --proposer bottos

TrxHash: 5c137d56c084777dfa05f7bde9b810ae4190f02f36409f1ed6809f0ad9c49b27

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI 执行提案功能

帮助信息

./bcli multisign exec -h

NAME:
   Bottos bcli tool multisign exec - exec multisign proposal

USAGE:
   Bottos bcli tool multisign exec [command options] [arguments...]

OPTIONS:
   --proposal value  proposal name
   --proposer value  proposer name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign exec	--proposer	提案人账户名	是
	--proposal	提案名称	是

返回信息

该命令成功后返回命令产生的提案执行交易的hash。

示例

./bcli multisign exec --proposal proposaltest --proposer bottos

输出结果

./bcli multisign exec --proposal proposaltest --proposer bottos

TrxHash: 50a7c03951ed8d2d26b5e46446e68e5fc9f09ec1c1cabffc8465136fd200a38d

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

BCLI 撤销提案功能

帮助信息

./bcli multisign cancel -h

NAME:
   Bottos bcli tool multisign cancel - cancel multisign proposal

USAGE:
   Bottos bcli tool multisign cancel [command options] [arguments...]

OPTIONS:
   --proposal value  proposal name
   --proposer value  proposer name

参数说明

主命令行	参数列表	参数说明	必选参数
bcli multisign cancel	--proposer	提案人账户名	是
	--proposal	提案名称	是

返回信息

该命令成功后返回命令产生的提案撤销交易的hash。

示例

./bcli multisign cancel --proposal proposaltest --proposer bottos

输出结果

./bcli multisign cancel --proposal proposaltest --proposer bottos

TrxHash: 19b8b9f8ef9078627cf582adde8b361cf7f7ace054b2dec5d04d72a44cf81d46

This transaction is sent. Please check its result by command : bcli transaction get --trxhash  <hash>

6 技术社区

telegram海外社区链接

7 Bottos白皮书

Bottos白皮书

Files

Bottos开发者文档.md

Latest commit

History

Bottos开发者文档.md

File metadata and controls

1 Bottos简介

1.1. 项目介绍

1.2. 系统架构

1.3. 网络结构

1.3.1 网络整体

1.3.2 超级节点网络

1.3.3 其它节点与超级节点的连接图

1.3.4 节点简介

2 Bottos单节点部署

2.1 docker

2.2 VM

2.2.1 下载运行程序

2.2.1.1 下载已发布版本（推荐）

2.2.1.2 下载源码并编译版本

2.2.2 准备节点启动配置文件

3 快速多节点部署

3.1 一键docker容器部署

3.1.1 从 Docker Hub 拉取部署镜像

3.1.2 从Github下载脚本文件

3.1.3 创建并启动容器

3.2 一键多VM部署

3.3 一键Kubernate部署

4 DAPP开发手册

4.1 下载并引入sdk库文件

4.2 创建基本的项目结构

4.3 验证合约执行结果

5 开发工具链

5.1 插件钱包

5.2 移动端钱包接口

5.3 RPC API接口

5.3.1 区块相关

5.3.2 交易相关

5.3.3 账户相关

5.3.4 合约相关

5.3.5 生产者相关

5.3.6 多签相关

5.3.7 交易数据相关

5.3.8 序列化业务数据

5.3.9 反序列化业务数据

5.3.10 查询类

5.4 钱包API接口

5.5 JavaScript API接口

5.5.1 Wallet JS API安装与使用

5.5.2 Wallet JS API介绍

5.6 基础合约API接口 （包含在公共RPC里）

5.7 BCLI工具

5.7.1 BCLI工具简述

5.7.2 BCLI工具安装和使用

5.7.3 BCLI命令行说明

5.7.3.1 BCLI用户账户功能命令行

5.7.3.2 BCLI 合约功能命令行

5.7.3.3 BCLI 候选节点选举功能命令行

5.7.3.4 BCLI 块信息获取命令行

5.7.3.5 BCLI 创世节点功能命令行

5.7.3.6 BCLI 转账功能命令行

5.7.3.7 BCLI Transaction 提交和查询命令行

5.7.3.8 BCLI钱包命令行

5.7.3.9 BCLI P2P命令行

5.7.3.10 BCLI 多重签名命令行

6 技术社区

7 Bottos白皮书

4.1 下载并引入`sdk`库文件

5.6 基础合约API接口（包含在公共RPC里）