Skip to content

Latest commit

 

History

History
83 lines (60 loc) · 5.67 KB

cli-wallet-api.md

File metadata and controls

83 lines (60 loc) · 5.67 KB

Cli-wallet 命令列表

命令 参数 说明 备注
set_password <new_password> 对钱包设置一个新密码。首次启动钱包，需要设置密码
unlock <my_password> 解锁钱包
import_key <account_name_or_id> <true> <wif_private_key> 将帐户的私钥导入到钱包
dump_private_keys 打印钱包拥有的所有私钥对
get_account <account_name_or_id> 查询指定帐户信息，参数可以为帐户名或者帐户id
list_account_balances <account_name_or_id> 查询帐户余额
get_account_history <account_name_or_id> <limt_num> 查询帐户最近的交易记录
get_relative_account_history <account_name_or_id> <start> <limit> <stop> 查询帐户最近的交易记录, 支持翻页
get_account_history_by_operations <account_name_or_id> <[]> <start> <limit_num> 根据oeration_type查询帐户最近的交易记录，并且返回 operation对应的txID
transfer <from_account> <to_account> <amount> <GXS> <memo> <true> 转帐操作
transfer2 <from_account> <to_account> <amount> <GXS> <memo> <true> 转帐操作，参数同transfer, 返回结果中包含当前交易的id
get_block <block_num> 获取指定区块信息
info 获取区块链信息，可以用此命令查询最新区块高度
help 帮助命令，此命令会返回钱包支持的所有接口
gethelp <command> 帮助命令，�查看指定钱包命令的调用方法

调用示例

以get_account为例

CURL POST 命令行请求

进入命令行（cmd），输入

curl --data '{"jsonrpc": "2.0", "method": "get_account", "params": ["nathan"], "id": 1}' http://127.0.0.1:8091

即可看到返回结果

POST请求示例

请求URL如下

http://127.0.0.1:8091

请求主体

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

注：params的格式为[API类型，API指令，参数]

返回结果

{"id":1,"jsonrpc":"2.0","result":[{"id":"1.2.1",
"membership_expiration_date":"1969-12-31T23:59:59",
"merchant_expiration_date":"1970-01-01T00:00:00",
"datasource_expiration_date":"1970-01-01T00:00:00",
"data_transaction_member_expiration_date":"1970-01-01T00:00:00",
"registrar":"1.2.1",
"referrer":"1.2.1",
"lifetime_referrer":"1.2.1",
"merchant_auth_referrer":"1.2.0",
"datasource_auth_referrer":"1.2.0",
"network_fee_percentage":2000,"lifetime_referrer_fee_percentage":8000,
"referrer_rewards_percentage":0,"name":"witness-account",
"owner":{"weight_threshold":1,
"account_auths":[],
"key_auths":[],"address_auths":[]},
"active":{"weight_threshold":391175,"account_auths":[["1.2.18",37288],["1.2.19",37253],["1.2.20",37253],["1.2.21",37253],["1.2.22",37253],["1.2.29",37253],["1.2.30",37253],["1.2.31",37253],["1.2.32",37253],["1.2.33",37253],["1.2.34",37253],["1.2.35",37253],["1.2.36",37253],["1.2.37",37253],["1.2.38",37253],["1.2.39",37253],["1.2.3429",37253],["1.2.3431",37253],["1.2.3432",37253],["1.2.3433",37253],["1.2.3434",37253]],"key_auths":[],"address_auths":[]},"options":{"memo_key":"GXC1111111111111111111111111111111114T1Anm","voting_account":"1.2.5","num_witness":0,"num_committee":0,"votes":[],"extensions":[]},"statistics":"2.6.1","whitelisting_accounts":[],"blacklisting_accounts":[],"whitelisted_accounts":[],"blacklisted_accounts":[],"owner_special_authority":[0,{}],"active_special_authority":[0,{}],"top_n_control_flags":0},{"id":"1.2.2","membership_expiration_date":"1969-12-31T23:59:59","merchant_expiration_date":"1970-01-01T00:00:00","datasource_expiration_date":"1970-01-01T00:00:00","data_transaction_member_expiration_date":"1970-01-01T00:00:00","registrar":"1.2.2","referrer":"1.2.2","lifetime_referrer":"1.2.2","merchant_auth_referrer":"1.2.0","datasource_auth_referrer":"1.2.0","network_fee_percentage":2000,"lifetime_referrer_fee_percentage":8000,"referrer_rewards_percentage":0,"name":"relaxed-committee-account","owner":{"weight_threshold":1,"account_auths":[],"key_auths":[],"address_auths":[]},"active":{"weight_threshold":204892,"account_auths":[["1.2.18",37253],["1.2.19",37253],["1.2.20",37253],["1.2.21",37253],["1.2.22",37253],["1.2.23",37253],["1.2.24",37253],["1.2.25",37253],["1.2.26",37253],["1.2.27",37253],["1.2.28",37253]],"key_auths":[],"address_auths":[]},"options":{"memo_key":"GXC1111111111111111111111111111111114T1Anm","voting_account":"1.2.5","num_witness":0,"num_committee":0,"votes":[],"extensions":[]},"statistics":"2.6.2","whitelisting_accounts":[],"blacklisting_accounts":[],"whitelisted_accounts":[],"blacklisted_accounts":[],"owner_special_authority":[0,{}],"active_special_authority":[0,{}],"top_n_control_flags":0}]}

测试工具

推荐测试工具为POSTMAN

https://www.getpostman.com

![](/assets/test tool.png)