（署名：刘杰良）
适用于最新的 EOS Dawn 4.0/4.1
最近在研究 EOS 的 RPC API，但是由于官方API文档的不够详尽，新建账号（new account）这一个操作就折腾了一个多星期。皇天不负有心人，终于调通了新建账号，代币转账也轻松解决。特地写这篇文章（适用于 EOS dawn 4.0 和 4.1），帮助准备使用 EOS RPC 做 Dapp 开发的朋友，如有问题，欢迎批评指正。
1、POST http://127.0.0.1:8888/v1/chain/abi_json_to_bin （序列化新建账号的 json）
{ "code": "eosio", "action": "newaccount", "args": { "creator": "bitcoin", "name": "eason", "owner": { "threshold": 1, "keys": [ { "key": "EOS4ufZoTw95yHJS6Cyz3h4w5a2W4cyYpMYRnd7gbFZuCfPxUFS6r", //owner public key "weight": 1 } ], "accounts": [], "waits": [] }, "active": { "threshold": 1, "keys": [ { "key": "EOS4ufZoTw95yHJS6Cyz3h4w5a2W4cyYpMYRnd7gbFZuCfPxUFS6r", //active public key "weight": 1 } ], "accounts": [], "waits": [] } } }2、POST http://127.0.0.1:8888/v1/wallet/sign_transaction（签名新建账号的交易）
[ { "ref_block_num": 363759, "ref_block_prefix": 4033496171, "expiration": "2018-05-17T09:54:06.500", "actions": [ { "account": "eosio", "name": "newaccount", "authorization": [ { "actor": "bitcoin", "permission": "active" } ], "data": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" } ], "signatures": [] }, [ "EOS5wQ4HaFFDxyfc23dZNXUTGBHepM1vXGfr1vkfWHfRfvAMXP7VV" ], "" ]3、http://127.0.0.1:8888/v1/chain/push_transaction （把签名后的交易push 推送到 EOS 系统中，即新建账号完成）
{ "compression": "none", "transaction": { "expiration": "2018-05-17T09:54:06.500", "ref_block_num": 363759, "ref_block_prefix": 4033496171, "actions": [ { "account": "eosio", "name": "newaccount", "authorization": [ { "actor": "bitcoin", "permission": "active" } ], "data": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" } ] }, "signatures": ["SIG_K1_KY58QhP4jWLJWr7cVkahgL3JAjC8QMK5jnHurFUmn8xU71v6Mh4DmgjY75DxmWE6Je457N6MRM7GapxU43hywnAWKEmC1W"] }(代币转账 和 新建账号的 sign_transaction、push_transaction 类似，主要就是 智能合约的不同 和 调用的action 的不同 以及 action 中具体的参数不同。)
新建账号（newaccount）需要用 「已有的账号」 创建「 新账号」
内部是 已有账号 调用系统智能合约eosio中的 newaccount 的 action
新建账号的交易需要用 创建者 的 私钥签名交易（sign_transaction），然后 推送签名后的交易 (push_transaction)到区块链中。
a. sign_transaction ͼʾ
b. push_transaction ͼʾ
1、POST http://127.0.0.1:8888/v1/chain/abi_json_to_bin （序列化新建账号的 json）
请求参数：
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| code | string | 系统智能合约，默认填写“eosio” |
| action | string | 智能合约中的action，默认填写“newaccount” |
| creator | string | 创建者 |
| name | string | 新建账号名 |
| key | string | 新建账号的公钥 |
请求示例：
{ "code": "eosio", "action": "newaccount", "args": { "creator": "bitcoin", "name": "eason", "owner": { "threshold": 1, "keys": [ { "key": "EOS4ufZoTw95yHJS6Cyz3h4w5a2W4cyYpMYRnd7gbFZuCfPxUFS6r", //owner public key "weight": 1 } ], "accounts": [], "waits": [] }, "active": { "threshold": 1, "keys": [ { "key": "EOS4ufZoTw95yHJS6Cyz3h4w5a2W4cyYpMYRnd7gbFZuCfPxUFS6r", //active public key "weight": 1 } ], "accounts": [], "waits": [] } } }响应参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| binargs | string | 序列化的结果，在sign_transaction 和 push_transaction 中作为 data 请求参数 |
响应示例
{ "binargs": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" }2、GET http://127.0.0.1:8888/v1/chain/get_info （获取 EOS 区块链的最新区块号）
响应参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| head_block_num | number | 最新区块号 |
响应示例
{ "server_version": "13952d45", "head_block_num": 359934, "last_irreversible_block_num": 359934, "last_irreversible_block_id": "a69af2c4aa56b5c4bd1cdf9c2acb1a7796bbc3043954e36da182a144ddcf58fb", "head_block_id": "a69af2c4aa56b5c4bd1cdf9c2acb1a7796bbc3043954e36da182a144ddcf58fb", "head_block_time": "2018-05-17T09:02:12", "head_block_producer": "eosio", "virtual_block_cpu_limit": 100000000, "virtual_block_net_limit": 1048576000, "block_cpu_limit": 99900, "block_net_limit": 1048576 }3、POST http://127.0.0.1:8888/v1/chain/get_block （获取最新区块的具体信息）
请求参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| block_num_or_id | number | 最新区块号，上一个响应结果中的 head_block_num |
{ "block_num_or_id":359934 }响应参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| timestamp | string | 最新区块的生成时间 |
| block_num | number | 区块号，作为sign_transaction 和 push_transaction中的 ref_block_num请求参数 |
| ref_block_prefix | number | 作为sign_transaction 和 push_transaction中的 ref_block_prefix 请求参数 |
响应示例
{ "timestamp": "2018-05-17T09:02:12.500", "producer": "eosio", "confirmed": 0, "previous": "00057dfd5044aba0d750eff1fbb84ac92cbf29db1354968816fd2a9aefb0a0b4", "transaction_mroot": "0000000000000000000000000000000000000000000000000000000000000000", "action_mroot": "dee87e5d025383574ac12c310faf6b759fba52bd19977399b7ebf6ccdd81c7fa", "schedule_version": 0, "header_extensions": [], "producer_signature": "SIG_K1_KVX3RRTS4ch9m6bWDctsAhDWtFydTrg3mW7PaqCXnBZZWezBW23enggeW4ijuWBHBVsDoxzjMvspoFtPsU5nmau4ZYomZo", "transactions": [], "block_extensions": [], "id": "a69af2c4aa56b5c4bd1cdf9c2acb1a7796bbc3043954e36da182a144ddcf58fb", "block_num": 359934, "ref_block_prefix": 1943477914 }4、POST http://127.0.0.1:8888/v1/wallet/unlock （解锁钱包，签名交易前，需要解锁账号所在的钱包）
请求参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| string | 钱包名称 | |
| string | 钱包密码 |
请求示例
["liu","PW5KjWHnhL5kSRxpWyHQj321dFsZN62HAbZjVSqnDvzKMuEKBZ1T9"]响应示例
{} //成功解锁钱包，返回{}5、POST http://127.0.0.1:8888/v1/wallet/sign_transaction（签名新建账号的交易）
请求的参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| ref_block_num | number | 上面获得的最新区块号 |
| ref_block_prefix | number | 上面获得的最新区块号相关信息 |
| expiration | string | 过期时间 = timestamp 加上 一段时间 ，例如1分钟 |
| account | string | 调用系统智能合约账号名，默认为 eosio |
| name | string | 新建账号的action，默认为 newaccount |
| actor | string | 创建者 账户名 |
| data | string | abi_json_to_bin 序列化后的 值 binargs |
| string | 创建者的 公钥 |
请求示例
[ { "ref_block_num": 363759, "ref_block_prefix": 4033496171, "expiration": "2018-05-17T09:54:06.500", "actions": [ { "account": "eosio", //有 newaccount 的 action 的智能合约账号 "name": "newaccount", "authorization": [ { "actor": "bitcoin", "permission": "active" } ], "data": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" // //abi_json_to_bin 的响应参数 binargs } ], "signatures": [] }, [ "EOS5wQ4HaFFDxyfc23dZNXUTGBHepM1vXGfr1vkfWHfRfvAMXP7VV" //创建者的公钥（交易发起者的公钥），其实是用的公钥对应的私钥进行签名的，签名前需要先解锁包含此私钥的钱包 ], "" ]响应参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| signatures | string | 新建账号的交易 的签名结果，最后 push_transaction 中使用 |
响应示例
{ "expiration": "2018-05-17T09:54:06", "ref_block_num": 36079, "ref_block_prefix": 4033496171, "max_net_usage_words": 0, "max_cpu_usage_ms": 0, "delay_sec": 0, "context_free_actions": [], "actions": [ { "account": "eosio", "name": "newaccount", "authorization": [ { "actor": "bitcoin", "permission": "active" } ], "data": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" } ], "transaction_extensions": [], "signatures": [ "SIG_K1_KY58QhP4jWLJWr7cVkahgL3JAjC8QMK5jnHurFUmn8xU71v6Mh4DmgjY75DxmWE6Je457N6MRM7GapxU43hywnAWKEmC1W" // 签名 用在 push_transaction 中 ], "context_free_data": [] }6、http://127.0.0.1:8888/v1/chain/push_transaction （把签名后的交易push 推送到 EOS 系统中，即新建账号完成）
请求参数
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| compression | string | 默认 none |
| data | string | abi_json_to_bin 序列化后的 值 binargs |
| signatures | string | 交易签名后的结果 |
请求示例
{ "compression": "none", "transaction": { "expiration": "2018-05-17T09:54:06.500", "ref_block_num": 363759, "ref_block_prefix": 4033496171, "actions": [ { "account": "eosio", "name": "newaccount", "authorization": [ { "actor": "bitcoin", "permission": "active" } ], "data": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" //abi_json_to_bin 的响应参数 binargs } ] }, "signatures": ["SIG_K1_KY58QhP4jWLJWr7cVkahgL3JAjC8QMK5jnHurFUmn8xU71v6Mh4DmgjY75DxmWE6Je457N6MRM7GapxU43hywnAWKEmC1W"] }响应示例
{ "transaction_id": "2047702bfdc4678aabe123f335b4b5f604203edf7b4de8e42fa2c9211d4de075", "processed": { "id": "2047702bfdc4678aabe123f335b4b5f604203edf7b4de8e42fa2c9211d4de075", "receipt": { "status": "executed", "cpu_usage_us": 390, "net_usage_words": 25 }, "elapsed": 390, "net_usage": 200, "scheduled": false, "action_traces": [ { "receipt": { "receiver": "eosio", "act_digest": "ae18e275184e7defe81be175711cd24206990518963f857715e98755f713957c", "global_sequence": 365444, "recv_sequence": 365419, "auth_sequence": [ [ "bitcoin", 27 ] ] }, "act": { "account": "eosio", "name": "newaccount", "authorization": [ { "actor": "bitcoin", "permission": "active" } ], "data": { "creator": "bitcoin", "name": "zhangjie", "owner": { "threshold": 1, "keys": [ { "key": "EOS4ufZoTw95yHJS6Cyz3h4w5a2W4cyYpMYRnd7gbFZuCfPxUFS6r", "weight": 1 } ], "accounts": [], "waits": [] }, "active": { "threshold": 1, "keys": [ { "key": "EOS4ufZoTw95yHJS6Cyz3h4w5a2W4cyYpMYRnd7gbFZuCfPxUFS6r", "weight": 1 } ], "accounts": [], "waits": [] } }, "hex_data": "000000603a8ab23b000000ca3d364dfb0100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c3060010000000100000001000202aba1b7d9fc5de9dd93308dc5ebedcb066c8e5b36970bfd82ae715d9e8c306001000000" }, "elapsed": 163, "cpu_usage": 0, "console": "", "total_cpu_usage": 0, "trx_id": "2047702bfdc4678aabe123f335b4b5f604203edf7b4de8e42fa2c9211d4de075", "inline_traces": [] } ], "except": null } }End―――――――――――――――――――――――――――――――――-
圆方圆区块链汇集大批区块链名师，采取导师值班制，为学员实时解决技术疑难。请关注圆方圆区块链知识星球与导师。（培训咨询请联系船长13826054890微信手机同号）
圆方圆链圈
文章来源: 使用RPC接口新建EOS账户 - 实战