请问如何从bitshare的钱包获取去年10月份空投的new bitshare? 没找到相应的教程。谢谢！

　　NBS 交易所对接指南（双节点版）

　　此文目的是协助第三方交易所上线 NBS 交易。

　　此文所述方案为双节点方案。另有单节点方案，可以节省内存、硬盘和同步时间。

1. 基本概念

　　1.1 共识

　　NBS 使用 DPOS 共识机制，由持有 NBS 的人投票产生区块锻造人，标准区块间隔时间是 3 秒。

　　1.2 账户

　　1) NBS里，资金是存在账户里的，不像比特币是存在地址里。对交易所来说，需要公开一个账号供用户充值。

　　可以使用网页钱包或者轻钱包注册新账号。

　　注意：对于交易所来说，注册账号请使用钱包模式，而不是账户模式，因为交易所要用到一些高级功能，在账户模式下会存在问题。

　　（如果是官方网页钱包或轻钱包 20201023 或以上版本，第一次注册时默认是账户模式，可点击“高级”进入钱包模式）。

　　不是所有账号都可以免费注册，一般带横杠的或者数字的账号可以免费注册，比如 nbs-exchange ，或者 huobi-2021 。

　　在轻钱包账户页面里，账号下面会显示一个数字，这个数字是该账号在 NBS 系统里的内置ID，下面会用到。

　　可以到区块链浏览器 输入账号名获取账户 ID ，

　　也可以自建节点同步完成后在钱包里通过命令获取 ID ，获取命令参考“提现目的账号名检查”章节。

　　为了资金安全，交易所可以用一个账号负责充值，另用一个账号负责提现。

　　2) 用户充值，就是从其他账号转账到交易所的公开的账号。

　　账号名就是收款地址。

　　每笔转账可以带一个备注，交易所通过这个备注来区分是哪个用户的充值。

　　具体备注与交易所用户关联关系，请交易所自行设定。

　　备注是加密的，只有拥有发送者或者接收者的备注密钥才可以解密。

　　3) 用户提现，就是从交易所账号转账到用户账号，目的账号名由用户提供。

　　由于有用户需要把资金直接从一个交易所转到另一个交易所，而另一个交易所是根据备注入账，所以提现功能最好可以带备注。

　　4) 使用网页钱包注册的账号是基本账号。可付费升级为终身会员账号，升级后，后续交易手续费节省 80% 。

　　终身会员可以创建新账号。

　　当前手续费费率标准可以在钱包内查看，从界面依次点击 浏览-费率表 进入。

　　5) 每个账号默认有3对密钥，可以在账户-高级设定-权限页面里查看，分别为：活跃权限、账户权限、备注密钥。

　　其中，活跃权限密钥用于转账等日常操作；账户权限密钥用于修改密钥；备注密钥用来加密和解密转账备注。

　　默认情况下，活跃权限密钥与备注密钥相同，但可以修改为不同。

　　1.3 资产

　　1) NBS 系统里有多种资产，其中，核心资产是 NBS 。交易所上线 NBS 系统内其他资产的方法，与上线核心资产（NBS）的方式类似。

　　2) 每个账户可以同时拥有多种资产。

　　1.4 块链结构

　　每个块有个 ID，即 block_id，该 ID 是块内容的 hash 值；

　　每个块包含前一块的 ID，存放在 "previous" 字段，因此形成一个链；

　　每个块里包含多个交易，存放在 "transactions" 字段，按顺序存放；

　　使用 API 获取块信息时，会同时返回 "transaction_ids" 字段，即交易 ID 清单，是交易（不包含签名）序列化后的 hash 值

　　每个交易可包含多个操作，存放在 "operations" 字段，按顺序存放；

　　每个操作也有一个 ID ，是一个全局数字编号，是程序运行中内部产生的，不是 hash 值

1. 基础软硬件需求

　　独立服务器或者VPS

　　4G 内存（更多更好）

　　50G 硬盘

　　安装 64 位 Ubuntu 18.04 LTS （推荐） ，或者 Ubuntu 16.04 LTS 。

1. 程序准备

　　要对接 NBS 系统，需要运行这几个程序：普通节点 witness_node 、延迟节点 delayed_node 、命令行钱包 cli_wallet 。

　　单节点方案不需要运行 delayed_node 。

　　3.1 架构说明

　　witness_node 通过 P2P 方式连接到 NBS 网络，从网络接收最新区块，向网络广播本地签署的交易包；

　　witness_node 通过 websocket + http rpc 的方式提供 API 供其他程序调用（以下称为节点 API）。

　　delayed_node 通过 websocket 方式连接到 witness_node ，只包含不可回退的区块；

　　delayed_node 通常情况下最新区块比 witness_node 落后一分钟，异常时可能会落后很多，但可保证不可回退。

　　delayed_node 通过 websocket + http rpc 的方式提供 API 供其他程序调用，API清单与 witness_node 相同，但无法使用交易广播功能。

　　cli_wallet 通过 websocket 方式连接到 witness_node 和 delayed_node 其中之一。

　　可以同时运行两个 cli_wallet 进程，分别连到 witness_node 和 delayed_node 。

　　cli_wallet 管理钱包文件，钱包文件里包含经过加密的用户私钥，一个钱包文件可以包含多个私钥。

　　cli_wallet 提供交易签名功能，签名后通过 witness_node 向外广播。

　　cli_wallet 通过 http rpc 的方式提供 API 供其他程序调用（以下称为钱包 API）。

　　推荐交易所使用一个连接到 delayed_node 的 cli_wallet 来监测用户充值，使用另一个连接到 witness_node 的 cli_wallet 来处理用户提现请求。

　　如果不使用 delayed_node ，则需要自行判断交易是否可以回退（以下会说明推荐的判断方法）。

　　3.2 Linux

　　如果使用 Linux 系统，需要自行编译几个上述程序。推荐使用 Ubuntu 18.04 LTS ，编译步骤如下：

　　sudo apt-get update

　　sudo apt-get install autoconf cmake make automake libtool git libboost-all-dev libssl-dev g++ libcurl4-openssl-dev doxygen

　　git clone https://github.com/nbs-dex/nbs-core.git

　　cd nbs-core

　　git checkout master

　　git submodule update --init --recursive

　　mkdir build

　　cd build

　　cmake -DCMAKE_BUILD_TYPE=Release ..

　　make witness_node delayed_node cli_wallet

　　编译完成后，3个程序分别是：

• build/programs/witness_node/witness_node

• build/programs/delayed_node/delayed_node

• build/programs/cli_wallet/cli_wallet

　　上述程序可以拷贝到其他目录或者其他服务器执行。以下默认认为程序在当前目录。

　　如果使用 Ubuntu 14.04 LTS ，则需要先编译安装 Boost 库，然后再执行上述步骤。

　　请注意，目前只支持 1.57.0 到 1.60.0 的 Boost 库。

　　编译安装 Boost 库的步骤为：

　　sudo apt-get install cmake make libbz2-dev libdb++-dev libdb-dev libssl-dev openssl libreadline-dev autoconf libtool git autotools-dev build-essential g++ libbz2-dev libicu-dev python-dev doxygen

　　wget -c 'http://sourceforge.net/projects/boost/files/boost/1.57.0/boost_1_57_0.tar.bz2/download' -O boost_1_57_0.tar.bz2

　　tar xjf boost_1_57_0.tar.bz2

　　cd boost_1_57_0

　　./bootstrap.sh

　　sudo ./b2 install

　　使用其他 Linux 发行版也可以编译，不在本文说明范围。

1. 环境准备

　　要保证系统正常运行，需要保证服务器系统时间正确。时间不正确会导致块链无法同步、资金发送失败等各种问题。

　　Ubuntu 系统推荐安装 NTP 服务端，方法是

　　sudo apt-get install ntp

　　Windows 系统请设置好系统时间同步。

1. 同步数据

　　由于需要同时运行多个程序， Ubuntu 下推荐在 Screen 或者 tmux 里启动程序。

　　以下描述主要针对 Ubuntu ，所以命令前都带 ./ 。对于 Windows ，在命令行界面 cd 到程序目录之后，执行时不需要 ./ 。

　　5.1 witness_node

　　可使用 ./witness_node --help 来查看命令参数。

　　5.1.1 初次执行：

　　./witness_node -d witness_node_data_dir

　　然后按 Ctrl+C 结束它。

　　这样会在当前目录生成一个数据目录 witness_node_data_dir ，里面包含 blockchain 目录是数据存储，以及一个 config.ini 配置文件。

　　对于交易所，推荐对 config.ini 配置文件作一些修改。

　　1) 可关闭 p2p 日志，以减小硬盘存储压力，方法是找到 filename=logs/p2p/p2p.log 行，在行首添加 # 号

　　或者将 [logger.p2p] 下面的 level=info 修改为 level=error

　　2) 可考虑将控制台日志同时保存到文件，方法是将下述章节

　　[logger.default]

　　level=info

　　appenders=stderr

　　修改为

　　[log.file_appender.default]

　　filename=logs/default/default.log

　　[logger.default]

　　level=info

　　appenders=stderr,default

　　这样之后， witness_node_data_dir/logs/default/ 目录下会同步保留最近24小时的控制台日志。

　　3) 以下参数会减少运行需要的内存，原理是不保存内置交易引擎的历史成交记录索引。

　　history-per-size = 0

　　还需要设置这个参数：

　　plugins = witness account_history

　　注：

• config.ini 里默认 plugins 前有个“#”符号，需要删除；

• 默认的 plugins 配置是 “witness account_history market_history”，这里实际是去掉“market_history”；

• 如果 config.ini 里没找到该配置项，比如从老版本升级上来时不会更新已有配置文件，

• 可以在 config.ini 最前面添加一行（不要加在文件最后面），

• 也可以另外找个空目录生成一个 config.ini 文件再拷过来修改。

　　4) 以下两个参数会大量减少运行需要的内存，原理是不保存与交易所账户无关的历史数据索引。

　　track-account = "1.2.12345"

　　partial-operations = true

　　请将 12345 替换成你的账户数字 ID 。数字前的 "1.2." 表示类型是账户。

　　注： config.ini 里默认 track-account 前面有个“#”符号，需要删除。

　　如果需要监控多个账户，则使用多个 track-account 配置，如：

　　track-account = "1.2.12345"

　　track-account = "1.2.12346"

　　partial-operations = true

　　注：

　　目前存在一个 BUG ，配置多个 track-account 会导致下面的日志修改不生效。

　　绕过这个问题的方法，是不动 config.ini ，而是启动 witness_node 的时候，在命令行后面添加 --track-account 参数，比如：

　　./witness_node --track-account "\"1.2.12345\"" --track-account "\"1.2.12346\""

　　注：

• 参数首尾双引号需要保留，所以使用 \ 进行转义。 Linux 下可以使用双引号外加一层单引号的方式，则不需要转义。

• 如果需要增加、修改、删除追踪账号，修改后，需要重建索引才能生效。

　　方法是按 Ctrl + C 结束程序，然后加 --replay-blockchain 参数重新启动，如：

　　./witness_node -d witness_node_data_dir --track-account "\"1.2.12345\"" --track-account "\"1.2.12346\"" --replay-blockchain

　　5.1.2 重新执行

　　再次启动 witness_node ，开始同步数据。根据网络条件、服务器硬件条件不同，初次同步可能需要花几个小时到几天时间。

　　./witness_node -d witness_node_data_dir --rpc-endpoint 127.0.0.1:8090 --track-account "\"1.2.12345\"" --track-account "\"1.2.12346\"" --partial-operations true

　　上述命令中，使用 --rpc-endpoint 开启节点 API 服务，这样就可以使用 cli_wallet 和其他程序连接使用

　　5.2 连接到 witness_node 的 cli_wallet

　　./cli_wallet -w witness_wallet.json -s ws://127.0.0.1:8090 -H 127.0.0.1:8091

　　上述命令使用 -w 参数指定钱包文件， -s 参数连接到 witness_node ， -H 参数开启钱包 API 服务

　　执行成功会显示：

　　new >>>

　　首先需要为钱包设置一个密码

　　new >>> set_password my_password_1234

　　执行成功会显示：

　　locked >>>

　　然后解锁钱包

　　locked >>> unlock my_password_1234

　　解锁成功会显示：

　　unlocked >>>

　　使用 info 命令可以查看当前同步情况

　　unlocked >>> info

　　info

　　{

　　"head_block_num": 17249870,

　　"head_block_id": "0107364e2bf1c4ed1331ece4ad7824271e563fbb",

　　"head_block_age": "23 seconds old",

　　"next_maintenance_time": "31 minutes in the future",

　　"chain_id": "cd931cb96d657ff0ef0226f7ae9d25175b3cc96a84490a674ed36170830324e7",

　　"participation": "96.87500000000000000",

　　...

　　}

　　5.3 delayed_node

　　初次执行：

　　./delayed_node -d delayed_node_data_dir --trusted-node 127.0.0.1:8090

　　然后按 Ctrl+C 结束它。

　　参考 witness_node 章节修改 delayed_node_data_dir 目录下的 config.ini 文件，然后重新启动

　　./delayed_node -d delayed_node_data_dir --trusted-node 127.0.0.1:8090 --rpc-endpoint 127.0.0.1:8092 --track-account "\"1.2.12345\"" --track-account "\"1.2.12346\"" --partial-operations true -s "0.0.0.0:0" --p2p-endpoint "0.0.0.0:0" --seed-nodes "[]"

　　上述命令中， 最后的3个参数 -s --p2p-endpoint --seed-nodes 的目的是防止节点直接与 p2p 网络建立连接，导致数据不可信。

　　注：

　　delayed_node 初次同步时，控制台输出会很多，可以采取重定向到文件然后查看文件的方式来检查同步情况

　　5.4 连接到 delayed_node 的 cli_wallet

　　./cli_wallet -w delayed_wallet.json -s ws://127.0.0.1:8092 -H 127.0.0.1:8093

　　请参考前面的章节设置密码及解锁。

1. 账户设置

　　考虑到安全性，可以使用两个账号分别处理充值和提现，这里假设 deposit-account 用于充值，withdrawal-account 用于提现。

　　6.1 修改充值账户的备注密钥

　　在上述任何一个 cli_wallet 中执行 suggest_brain_key ，会得到一对密钥，示例如下：

　　unlocked >>> suggest_brain_key

　　suggest_brain_key

　　{

　　"brain_priv_key": ".....",

　　"wif_priv_key": "5JxyJx2KyDmAx5kpkMthWEpqGjzpwtGtEJigSMz5XE1AtrQaZXu",

　　"pub_key": "NBS69uKRvM8dAPn8En4SCi2nMTHKXt1rWrohFbwaPwv2rAbT3XFzf"

　　}

　　在轻钱包里，账户权限页面，将备注密钥修改为上述结果中的 pub_key

　　注：

1. 修改过后请注意备份轻钱包，否则轻钱包里可能无法解密修改前的备注。

2. 修改过后，如果仍需要使用轻钱包进行带备注的转账、或者读取新的转入/转出转账备注，

　　则需要将上述 wif_priv_key 导入到轻钱包，导入步骤参考如下教程中的第二步： http://NBSabc.org/article-761-1.html 。

　　导入后可以做个新的备份。

　　6.2 将充值账户的备注密钥导入到连接到 delayed_node 的 cli_wallet

　　如果钱包已锁定，需要先用 unlock 命令解锁。

　　这里需用到上述 suggest_brain_key 结果中的 wif_priv_key ：

　　unlocked >>> import_key deposit-account 5JxyJx2KyDmAx5kpkMthWEpqGjzpwtGtEJigSMz5XE1AtrQaZXu

　　导入时 cli_wallet 会自动生成一个备份文件，可删除。

　　这时可按 Ctrl + D 退出钱包，对钱包文件 delayed_wallet.json 进行备份。

　　退出时会报个错，不用管它。

　　如果编译时没有引入 readline 库，则需要用 Ctrl + C 退出

　　6.3 从轻钱包中取得提现账户的活跃权限密钥

　　参考 http://nbs.wiki/article-761-1.html

　　6.4 将提现账户的活跃权限密钥导入到连接到 witness_node 的 cli_wallet

　　unlocked >>> import_key withdrawal-account 5xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

　　同样可以对钱包文件作个备份。

　　注：检查一下提现账户的活跃权限密钥和备注密钥是否一样，如果不一样，则需要将备注密钥也导入，否则无法处理带备注的提现。导入命令仍然是：

　　unlocked >>> import_key withdrawal-account 5xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. 钱包命令

　　cli_wallet 里，

• 使用 help 命令可以列出命令清单及参数

• 如果编译时有 doxygen ，使用 gethelp 命令可以获取具体命令的参数说明及示例，如

　　unlocked >>> gethelp get_account

1. 钱包 API

　　钱包开启了 http rpc 方式的 API 服务时，可以通过 http rpc 方式调用所有钱包命令，效果与在钱包里输入命令相同。

　　示例：

　　curl -d '{"jsonrpc": "2.0", "method": "get_block", "params": [1], "id": 1}' http://127.0.0.1:8093/rpc

　　即：method 传入命令名，params 数组传入参数清单。

　　返回：

　　{"id":1,"result":{"previous":"0000000000000000000000000000000000000000","timestamp":"2015-10-13T14:12:24","witness":"1.6.8","transaction_merkle_root":"0000000000000000000000000000000000000000","extensions":[],"witness_signature":"1f53542bb60f1f7a653bac70d6b1613e73b9adc952031e30e591e601dd60d493ba5c9a832e155ff0c40ea1dd53512e9f93bf65a8191497ea67d701bc2502f93af7","transactions":[],"block_id":"00000001b656820f72f6b28cda811778632d4998","signing_key":"NBS6ZQEFsPmG6jWspNDdZHkehNmPpG7gkSHkphmRZQWaJ2LrcaVSi","transaction_ids":[]}}

　　如果执行成功，结果会有 result ，否则会有 error 。

　　注意：

　　在钱包里输入命令，返回结果是经过美化的；使用 http rpc 请求时，返回的是 json 格式的原始数据。关于原始数据，需要注意的有：

• 金额是 {"amount":467116432,"asset_id":"1.3.0"} 格式，其中

• asset_id 可以通过 get_asset 命令查到具体名称， NBS 的 asset_id 是 1.3.0 ，其他资产有其他 id

• amount 是数量去掉小数点之后的值，比如 NBS 是 5 位小数，上面例子中实际是 4671.16432 NBS

• 账户是 1.2.xxxxx 的格式，可以通过 get_account 获取账户信息

• 操作类型（op）是数值格式，比如 0 表示转账操作

• 处理充值

　　使用 get_relative_account_history 命令来查询充值账户历史，检测是否有新的充值。如：

　　unlocked >>> get_relative_account_history deposit-account 1 100 100

　　unlocked >>> get_relative_account_history deposit-account 101 100 200

　　curl -d '{"jsonrpc": "2.0", "method": "get_relative_account_history", "params": ["deposit-account",1,100,100], "id": 1}' http://127.0.0.1:8093/rpc

　　四个参数分别为：账户名，最小编号，最大返回数量，最大编号。编号从 1 开始。

　　注：

　　目前输入最大数量超过 100 时有个bug，导致结果不准，使用时请避免 limit 超过 100 。

　　返回结果是一个数组。

• 如果没有新充值，则数组长度为 0 。

• 如果有新的记录，其中第N条数据为 result[N]，格式可能为：

　　{

　　"memo":"",

　　"description":"Transfer 1 NBS from a to b -- Unlock wallet to see memo. (Fee: 0.22941 NBS)",

　　"op":{

　　"id":"1.11.1234567",

　　"op":[

　　0,

　　{

　　"fee":{

　　"amount":22941,

　　"asset_id":"1.3.0"

　　},

　　"from":"1.2.12345",

　　"to":"1.2.45678",

　　"amount":{

　　"amount":100000,

　　"asset_id":"1.3.0"

　　},

　　"memo":{

　　"from":"NBS7NLcZJzqq3mvKfcqoN52ainajDckyMp5SYRgzicfbHD6u587ib",

　　"to":"NBS7SakKqZ8HamkTr7FdPn9qYxYmtSh2QzFNn49CiFAkdFAvQVMg6",

　　"nonce":"5333758904325274680",

　　"message":"0b809fa8169453422343434366514a153981ea"

　　},

　　"extensions":[

　　]

　　}

　　],

　　"result":[

　　0,

　　{

　　}

　　],

　　"block_num":1234567,

　　"trx_in_block":7,

　　"op_in_trx":0,

　　"virtual_op":1234

　　}

　　}

　　其中 result[N]["op"]["op"] 是数组格式，取数组里第一个元素 result[N]["op"]["op"][0] ，如果是 0 ，则表示转账；

　　则可以取第二个元素中 "to" 字段，即 result[N]["op"]["op"][1]["to"] ，判断它是否与 deposit-account 的 ID 相同，来判断是否转入；

　　如果是，则取第二个字段中 "amount" 字段里 "asset_id" 字段 result[N]["op"]["op"][1]["amount"]["asset_id"] 判断是否正确资产类型，

　　然后取 "amount" 里面的 "amount" ，即 result[N]["op"]["op"][1]["amount"]["amount"] ，加上小数点位数，得出充值金额；

　　取最外层的 "memo" 字段，即 result[N]["memo"] ，得出用户在交易所的 ID ，进行入账。

　　result[N]["op"]["id"] 是这笔转账的唯一 ID ，可以记录备查。

　　同时，推荐将结果中 block_num, trx_in_block, op_in_trx 几个数据也记录下来，含义分别是 块号、块中第几个交易、交易中第几个操作。

　　另外，由于他方转账时，可能只记录交易ID （哈希值），或者交易签名，而不记录操作ID或者块号，

　　为了方便检查问题，建议在充值检测时，记录操作对应的交易 ID 和交易签名，方法如下：

　　根据上述 block_num ，调用 get_block 命令获取块内容，如

　　unlocked >>> get_block 16000000

　　curl -d '{"jsonrpc": "2.0", "method": "get_block", "params": [160000], "id": 1}' http://127.0.0.1:8093/rpc

　　设结果中块内容为 result ，根据上述 trx_in_block ，

　　取 result["transaction_ids"][trx_in_block] ，即为对应的交易 ID；

　　取 result["transactions"][trx_in_block]["signatures"] ，即为交易签名，是个数组，因为多重签名账户转账可能包含多个签名

　　注：

　　1) 钱包必须先解锁才能解密备注。

　　2) 如果检测到有充值的备注不正确，或者资产类型不正确，注意不要简单退回，因为可能是从其他交易所转来的，退回后对方处理起来也会很麻烦。

　　3) 如果不使用 delayed_node ，而只使用一个 witness_node ，需要自行判断交易是否会被回退。

　　可参考下面“提现”章节的网络状态检查，再加上一个较大的确认数来判断，比如需要 50 个确认。

　　4) 一个块里很可能有多笔充值，结果的 block_num 相同，甚至可能 trx_in_block 和 op_in_trx 也相同，但 virtual_op 不同，需注意处理。

　　可以肯定 blocknum + trx_in_block + op_in_trx + vitrual_op 的组合是唯一的。

　　这里还要注意个问题， virtual_op 的数据目前有个 BUG，如果不是每次重启参数都一样并且都 replay ，重新查历史数据，会发现这个值会不一致

　　5) 由于存在“提议”功能，可以延期执行，用 get_block 然后用 trx_in_block 定位时可能取不到对应交易，或者取到的交易与充值操作不对应。

　　延期执行功能目前很少有人用，但理论上存在，请注意错误处理。

1. 处理提现

　　10.1 网络状态检查

　　为了安全起见，只有当 witness_node 网络正常时，才处理提现。

　　在连接到 witness_node 的 cli_wallet 中使用 info 命令检查网络状态。

　　unlocked >>> info

　　info

　　{

　　"head_block_num": 17249870,

　　"head_block_id": "0107364e2bf1c4ed1331ece4ad7824271e563fbb",

　　"head_block_age": "23 seconds old",

　　"next_maintenance_time": "31 minutes in the future",

　　"chain_id": "cd931cb96d657ff0ef0226f7ae9d25175b3cc96a84490a674ed36170830324e7",

　　"participation": "96.87500000000000000",

　　...

　　}

　　需检查的字段有：

• head_block_age 最好是在 1 分钟以内

• participation 最好在 80 以上，表示 witness_node 所连网络有 80% 的出块节点正常工作

　　另外，网络正常时，在连接到 delayed_node 的 cli_wallet 中查看 info 时，

　　看到的 head_block_num 与连接到 witness_node 的 cli_wallet 中看到的不会相差太大（一般 30 以内）；

　　同时 head_block_age 也不会太久远（一般 1 分钟左右）。

　　这个可以作为参考。

　　10.2 提现账户余额检查

　　使用 list_account_balances 命令检查提现账户余额是否足够（注意资产类型、并且算上手续费）

　　unlocked >>> list_account_balances withdrawal-account

　　注：

　　1) 注意资产类型

　　2) 注意加上手续费。因为备注是按长度收费，所以带备注时手续费会比不带备注时高一些。

　　10.3 提现目的账号名检查

　　使用 get_account_id 命令可以检查客户输入的提现目的账号是否有效

　　locked >>> get_account_id test-123

　　get_account_id test-123

　　"1.2.96698"

　　locked >>> get_account_id test-124

　　get_account_id test-124

　　10 assert_exception: Assert Exception

　　rec && rec->name == account_name_or_id:

　　{}

　　th_a wallet.cpp:597 get_account

　　10.4 发送提现

　　使用 transfer2 命令发送提现交易。如：

　　unlocked >>> transfer2 withdrawal-account to-account 100 NBS "some memo"

　　参数分别是：源账户名，目的账户名，金额，币种，备注

　　该命令会广播交易，然后返回一个数组，第一个元素是交易 id ，第二个元素是详细交易内容

　　注：

　　1) 如果币种是 NBS ，金额小数位数最多 5 位。如果是其他资产，通过 get_asset 命令可以查看资产的小数位数，"precision"字段。

　　2) 也可以使用 transfer 命令，但是这样不会直接返回交易 ID ，而是需要调用其他 API 来计算出来，所以不推荐。

　　3) 备注通常用 UTF-8 编码

　　10.5 提现结果检查

　　在连接到 delayed_node 的 cli_wallet 中进行结果检查。

　　用 get_relative_account_history 命令获取 withdrawal-account 的提现历史，如果发现有新的记录，表示交易已经进块并且不可回退；

　　根据该条记录的 block_num 字段，使用 get_block 命令查询详情

　　unlocked >>> get_block 12345

　　返回结果中， transaction_ids 字段数据里应该包含前面的交易 id ，。

　　建议记录上述 get_relative_account_history 结果中的 id (1.11.x), block_num, trx_in_block 备查。

　　10.6 关于失败重发

　　在有些情况下可能交易发送后，没有及时被打包进入区块。

　　与比特币不同， NBS 的交易里面有个超时时间字段（expiration），

　　使用 cli_wallet 签名广播交易时，该字段值默认是本机系统时间加 2 分钟。

　　本机交易特别多的时候，超时时间会加长。

　　如果在网络时间到达该超时时间之后，交易仍然没有被打包进块，则该交易会被所有网络节点丢弃，不再有可能被打包。

　　因此，如果出现交易广播了但没有被打包，先检查本机系统时间是否滞后。

　　此外，如果发现 delayed_node 里一直没有该笔提现，

• 如果 delayed_node 最新块时间已经过了交易的超时时间，那么重发是安全的。

• 如果还没超时，先检查 witness_node 里该笔交易是否已经被打包。

• 如果 witness_node 里也没有，则继续耐心等超时。

• 如果 witness_node 里有，那么请耐心等待该笔出现在 delayed_node ，或者从 witness_node 里消失。

• 如果等待一段时间（比如几分钟）后交易仍然没有出现在 delayed_node ，也没从 witness_node 里消失，则很可能 witness_node 进入了一个较短分叉链，或者网络出现问题，导致交易无法完全确认。

• 其他

• cli_wallet 有个参数 --daemon ，使用此参数启动后，会在后台运行

• 需要关闭 witness_node 时，按一次 Ctrl C，然后等待程序自己退出。

• 正常退出后，重新启动时，不需重建索引，启动会比较快

• 正常退出后，可以对数据目录 witness_node_data_dir 打包备份，需要时可直接恢复使用

• 如果异常退出，则重新启动时，很可能需要重建索引，启动比较慢

• 如果 witness_node 出现异常，一般先尝试重启，如果不行则尝试带 --replay-blockchain 参数重启，即手工触发重建索引

• 如果没有解决，则使用备份恢复

• 如果没有备份，则重新同步，可能耗时较长

• delayed_node 同上。

• 多重签名： NBS 原生支持账户级多重签名，并且有提案-批准的机制，可以在线发起多签请求，然后确认完成多签交易，具体参考相关教程

• 硬件钱包： 暂无支持

• 冷存储： 可以实现，步骤有些复杂，示例：

• 在离线机器，启动 witness_node 及 cli_wallet ，使用 suggest_brain_key 命令离线生成密钥对；

• 然后用轻钱包将账户密钥修改为上述密钥，则账户进入冷存状态

• 需要动用冷存账户时，

• 可以用暂时变热的方式，即将私钥导入轻钱包使用，用完后再换成新密钥

• 纯冷模式也可实现，但当前 cli_wallet 支持不好，有需要的请单独联系

NBS简介

NBS是一个公共开放的公益性区块链实验平台，基于高效的DPOS共识算法，这个公平公正开放的社区由来自世界各地的区块链爱好者组成，历经八年的区块链实验已经形成了非常成熟的软件平台以及社区理念。

• [下载APP]

• NBS++ 苹果OS(点击下载)

• NBS傻瓜钱包(点击下载)

• 网页版钱包

• 区块链浏览器

• [抵押挖矿数据公示]

  数据公示

1、问：怎么把交易所的nbs转到钱包？

答：到交易所资产板块：找到NBS，点击提币，填写钱包账号即可（标签/memo不需要填）。

2、问：怎么把钱包的NBS转到交易所？

答：到钱包里：点击转账，填写交易所提供的充币地址和memo（备注位置填写对应的memo）。

之前在介绍比特股开源代码时，漏掉了基于Python的uptick和其依赖库 python-bitshares，因为我确实没发现。最近试用了一下uptick， 我认为非常好用，用了之后，我不想用图形界面的钱包了。本文介绍一下uptick和其依赖的库。

作者：Fabian Schuh

这两个项目的作者是 Fabian Schuh，网名 xeroc, github地址： ,目前比特股理事会成员之一。个人感觉，他写的代码质量比较高。

项目简介

uptick

uptick是基于Python的命令行工具，用于获取比特股区块链上的各种信息，也可以发起交易和转账。

代码地址: https://github.com/xeroc/uptick

python-bitshares

python-bitshares是基于Python的、与比特股API节点交互的库。uptick的底层。

代码地址： https://github.com/xeroc/python-bitshares

文档地址: http://docs.pybitshares.com/en/latest/

安装步骤

• 确保系统安装了Python3 (3.3 3.4 3.5 3.6应该都没问题)
• 确保系统安装了基于Python3的最新版本pip(9.0.1)
• 命令行: pip3 install uptick
• 命令行: pip3 install pycrypto (这一步理论上不需要，应该是某一个库依赖没写好的bug)

安装完成之后，首先需要设置API节点，否则默认是一个欧洲的节点，国内用的话很慢。国内尝试这两种

uptick set node wss://bit.btsabc.org/ws #比特帝国节点uptick set node wss://bts.transwiser.com/ws #transwiser节点

当然，自己编译了并运行了全节点的话，就更快了：

uptick set node ws://127.0.0.1:8090/

这个节点设定同时影响uptick和python-bitshares库，或者说uptick直接修改和使用了库里面的配置。

uptick常用命令用法表

python-bitshares代码示例

python-bitshares的文档也写得很好，有python基础的人能很快上手，这里给出两个示例代码。

获取最近一小时的最多50条BTS:CNY交易，计算这些交易的平均价格

!/usr/bin/env python3

from bitshares.market import Marketmarket \= Market('BTS:CNY'from datetime import datetime,timedeltanow \= datetime.utcnow()d \= timedelta(hours\=-1)onehourago \= now + d

trades \= market.trades(limit\=50,start\=onehourago,stop\=now)

def getSum(filledOrders): cny \= 0 bts \= 0 for order in filledOrders: print(order['time']) cny += order['base']['amount'] bts += order['quote']['amount']

return {'cny': cny, 'bts': bts,        'price':  cny/bts if bts \>0 else 0,        'size': len(filledOrders) }

print('成交:', getSum(trades))

获取当前市场上BTS:CNY的最多100条限价单，并分别计算买单和卖单的平均价格

!/usr/bin/env python3

from bitshares.market import Marketmarket \= Market('BTS:CNY'

orderbook \= market.orderbook(limit\=50)

区块链最多返回50个买单和卖单,默认limit=25

bids\=orderbook['bids']asks\=orderbook['asks']

def getSum(orders): cny \= 0 bts \= 0 for order in orders: cny += order['base']['amount'] bts += order['quote']['amount']

return {'cny': cny, 'bts': bts,        'price': cny/bts,        'size': len(orders) }

print('买单:', getSum(bids))print('卖单:', getSum(asks))

给读者的思考

感谢阅读到这里的朋友，这么枯燥的技术细节您都读完了，能否思考以下问题呢？

• uptick/python-bitshares可以发起交易，账号存储在本地计算机，安全性如何？
• 如何利用uptick/python-bitshares发起交易?
• 如何利用uptick/python-bitshares发起转账？

虽然我的博客、公众号有一些读者，但很少有留言的，我希望读到这里的朋友留言，给出您的任何想法(不限上面的3个问题)，谢谢！

[GUIDE][UPDATE] How to set up SOUNDAC CLI wallet and witness on docker (Use SOUNDAC official docker image )

in #soundac • 2 years ago (edited)

Step1 Install docker

If you haven't installed docker, following insturctions on https://docs.docker.com/install/#supported-platforms**, please choose your operating system(windows,linux,macOS) to install. **

Step2 Open terminal and use below docker command to download official soundac-source docker image:

docker pull soundac/soundac-source:release-0.6.0

Step3 Use the following command to run container, it can also automate run soundac daemon

 docker run -p 33333:33333 -p8090:8090 --name soundac-source -itd  soundac/soundac-source:release-0.6.0

Step4 Enter container:

docker exec -it soundac-source /bin/bash

Step5 Use the following command to change the folder

cd /usr/local/bin/

Step6 Use the following command to start cli_wallet program

./cli_wallet

Step7 Set wallet password(create wallet)

set_password "pass…."

Step8 Unlock wallet

unlock "pass..."

Step9 Import WIF private key and active private key. If you don’t have WIF private key and active private key, Please go to https://portal.soundac.io/register apply.

import_key <WIF private key>

import_key <active private key>

Step10 Use list_my_accounts, see your account

 list_my_accounts

Done, SOUNDAC cli_wallet is working now. You also can type **about** check soundac-source version and type **info** check blockchain sync.

**If you want to set up witness, you have to edit config.ini, following below steps:

Step1 Press ctrl+c to exit cli_wallet program and close it**

Step2 Use the following command to change the folder

cd /data

#

Step3 Use editor to set config.ini file(witness name and WIF private key)

vim config.ini

locate these lines:

# name of witness controlled by this node (e.g. initwitness )

# witness =

# WIF PRIVATE KEY to be used by one or more witnesses or miners

# private-key =

edit and look like this:

# name of witness controlled by this node (e.g. initwitness )

witness = "initwitness"

# WIF PRIVATE KEY to be used by one or more witnesses or miners

private-key = 5………

Save and exit vim.

Step4 Use the following command to exit soundac-source container

 exit

Step5 Use the following command to stop soundac-source container

docker stop soundac-source

Step6 Use the following command to run soundac-source container, it can also automate run soundac daemon

docker start  soundac-source

Step7 Enter soundac-source container:

docker exec -it soundac-source /bin/bash

Step8 Use the following command to change the folder

cd /usr/local/bin/

Step9 Use the following command to start cli_wallet program:

./cli_wallet

Step10 Unlock wallet:

unlock "pass..."

Step11 Announce yourself as a witness, please make sure SONDAC blockchain sync is completed and use update_witness command, the format look like this:

update_witness "yourwitnessname" "witness_url" "yor_witness_pub_key" {} true

Done, your witness is working now.

**Final step: Vote for me!!

If this post help you, please vote for my SOUNDAC witness "wallet",
you can vote on SOUNDAC website: https://portal.soundac.io/register
or you can vote in cli_wallet:**

vote_for_witness YOURACCOUNT wallet true true

Thank you.

./cli_wallet -swss://node.soundac.io

NBS钱包使用灵魂拷问

一、怎么使用钱包？（概览）
答：
初级篇：涉及账户模式、交易操作、挖矿操作、承兑操作、转账操作、区块浏览器查询等；中级篇：涉及dpos理念、DAO理念、见证人和喂价、抵押和清算、网关、合约等；
高级篇：涉及资产发布、隐私交易、理事会、投票和多签、提案和预算管理等。

初级篇问答
1、怎么下载钱包？
答：官网钱包板块：nbs.plus

2、钱包有几个？
答：nbs++钱包和nb钱包，同时提供网页版。（附推荐挖矿功能目前只有nb钱包账号有）

3、怎么注册钱包账号？（账户模式）
答：按照页面显示注册，同时钱包密码由系统生成，请严格保存不可丢失。
解锁密码是每次登录时锁定账号操作安全的，请记牢。

4、怎么转账？
答：钱包账号即地址。
钱包账号转账到交易所，必须在备注里填写交易所提供的memo/标签。
交易所提币到钱包，不需要填memo/标签。

5、怎么挖矿及收益率？
答：币本位挖矿：nbs兑换成miner，持有miner即可，年化16%-20%。
金本位挖矿：cny兑换成scny，持有scny即可，年化67%-120%。
推荐挖矿：邀请好友持有挖矿资产即可，年化10%。

6、挖矿细节点？
答：随进随出，无时间限制；系统设定最高千5的退出价差，实际价差根据市场买卖单核算；推荐挖矿5万枚nbs起步。

交易所> > 内盘（钱包）：标签，又称为memo，可以不填。
内盘（钱包）> > 交易所 ：备注处必须填写交易所提供的memo。
因为交易所需要通过不同的memo来区分不同的用户，而内盘账号在NBS链上具有账号唯一性。

有人知道NBS节点怎么架设？
要什么服务器，大概什么价格，每年收益能有多少？
想搞个来赚NBS

新人挖矿步骤：
第一步：注册钱包账号：
第二步：下载钱包app：注册后有下载链接，或官网nbs.plus
第三步：把你持有的nbs，提到钱包账号。
第四步：挖矿：nbs兑换miner，为币本位挖矿。cny兑换scny，为金本位挖矿。
同时nbs理财钱包提供一键挖矿功能。
第五步：等着即可，每天23点挖矿产出ncn分发到账。

nb钱包：注册请点击
三种挖矿：
1、锁仓挖矿，直接在miner/nbs交易对买入miner，这是币本位挖矿，收益得义于：币价上涨+挖矿收益。
2、抵押挖矿，在scny/cny交易对买入scny ，这是金本位挖矿，收益得义于：挖矿收益。
同时cny怎么获取？可以卖掉nbs，也可以抵押nbs，这里就产生了卖掉和抵押的不同。附：承兑上线后，可直接充值cny。
3、推荐挖矿，即邀请新用户持有挖矿资产，你获得挖矿收益。目前推荐挖矿的ios版本需要等待。
挖矿介绍 https://news.nbs.plus/?cat=8

从交易群转币到nb钱包，然后现在的钱包支持三种挖矿：
♥1.我先介绍锁仓挖矿，直接在miner/nbs交易对，买入miner，这是币本位挖矿，收益得义于：币价上涨+挖矿收益。
♥2：scny挖矿，这是金本位挖矿，即nbcny买入scny。这种收益得义于：挖矿收益。同时nbcny怎么获取？可以卖掉nbs，也可以抵押nbs，这里就产生了卖掉和抵押的不同。
♥3：推荐挖矿，即邀请新用户持有挖矿资产，你获得挖矿收益。目前推荐挖矿的ios版本需要等待。
挖矿介绍
【小技巧:官网nbs.plus里面下载理财版app，最方便！不要问我为什么！你试过就知道】

nb钱包：注册请点击
三种挖矿：我先介绍锁仓挖矿，直接在miner/nbs交易对，买入miner，这是币本位挖矿，收益得义于：币价上涨+挖矿收益。
第二种：scny挖矿，这是金本位挖矿，即你说的nbcny买入scny。这种收益得义于：挖矿收益。同时nbcny怎么获取？可以卖掉nbs，也可以抵押nbs，这里就产生了卖掉和抵押的不同。
第三种：推荐挖矿，即邀请新用户持有挖矿资产，你获得挖矿收益。目前ios版本需要等待。挖矿介绍 https://news.nbs.plus/?cat=8