BitShares API 服务器架设指南（一） 个人篇

作者：@boombastic

        受 @abit 的交易所对接指南启发，也写一篇关于API服务器搭建的指南。希望可以帮助到有需要的人。以下示例均在 linux 或者 mac 操作系统上测试运行通过，但没有在 windows 下进行过测试，但是原理是相同的，至多是具体路径写法略有差别，请 windows 用户自行调整。

        我们这里谈到的 API 服务器，实际上有以下几种用法，不同的用法，硬件要求及配置上有很大不同：

       1.    个人使用
       主要是个人用户在使用轻钱包或者网页钱包时，使用运行在本地，独占使用的API服务器。现代的个人电脑配置基本就足够了。

       2.    公共 API 服务器

       提供一个公共的API服务器，向公众开放服务。一般需要是托管在IDC的服务器或者从云服务提供商那里租赁的VPS，对配置带宽都有一定要求。

       写着写着发现篇幅很长，所以分成 2 篇独立的文章，一篇讲个人设置，一篇讲公共API服务器的搭建。

配置供个人使用的API服务器

       在自己的本地服务器上运行一个witness_node节点，并侦听本地端口。该节点仅供用户个人使用，所以速度飞快。

一、硬件要求

8G 内存（越多越好）
50G 硬盘

二、安装相关依赖并下载BitShares源码编译

Mac OSX上的方法

    # Mac OSX 操作系统上

    # 来源: https://github.com/bitshares/bitshares-core/wiki/Building-on-OS-X

    # 安装 brew

    /usr/bin/ruby -e "$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

    brew doctor

    brew update

    # 安装编译需要的依赖

    brew install boost cmake gitopenssl autoconf automake

    brew link --force openssl

    # 下载 BitShares 源码并编译

    # 这里，我们假设将目的地目录设置在 /path/to/bts_source，可根据需要修改

    cd /path/to/bts_source

    # 获取源码

    git clonehttps://github.com/bitshares/bitshares-core

    cd bitshares-core

    # 获取依赖的子模块代码

    git submodule update --init--recursive

    cmake .

    # 编译witness_node程序，如果make后面不加参数，则编译所有预设程序，也包括了cli_wallet, delayed_node 等程序，这现在场景下不需要

    make witness_node

编译完成后witness_node程序在 programs/witness_node/ 目录下可以找到。这个程序可以复制到其他目录也可以独立运行。

• 关于Mac下的安装详细说明，https://github.com/bitshares/bitshares-core/wiki/Building-on-OS-X

• 关于Windows下的安装说明，https://github.com/bitshares/bitshares-core/wiki/BUILD_WIN32

• 关于Ubuntu下的安装说明，https://github.com/bitshares/bitshares-core/wiki/BUILD_UBUNTU

三、启动witness_node节点

时间校准

witness_node节点的运行要求当前的机器校准时间，如果是桌面操作系统，无论是 mac 或是 windows，请确认系统时间已自动同步，linux 系统安装ntp服务实现。

sudo apt-get install ntp

配置并启动

我们先来看一下witness_node启动时需要配置哪些参数

# 注意我们的下载和编译路径

cd /path/to/bts_source/programs/witness_node

# -h 参数返回witness_node程序启动时支持的运行参数

./witness_node -h

# 其中这几条是我们关心的

-d [ --data-dir ] arg (="witness_node_data_dir")

指定数据及配置文件存储的目录，默认witness_node_data_dir.

--replay-blockchain

重发所有已下载的区块并重建索引，非常耗时。当意外中断后重启会强制进行，所以尽量不要强制中断，按了Ctrl+C之后稍等一会儿等程序完成收尾工作后优雅退出。

--resync-blockchain

删除所有已下载数据，重新同步区块链。

--rpc-endpoint [=arg(=127.0.0.1:8090)]

RPC侦听地址及端口

Options for plugin account_history:

  --track-account arg

追踪指定