2 JSON-RPC API
2.2 账号接口
2.2.1 创建账号
指定待创建账号的非对称加密算法类型，返回生成账号的地址及私钥等信息。
请求:
{
"method": "wallet_propose",
"params": [
{
"key_type": "secp256k1"
}
]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| key_type | string | 生成账号的加密算法，有secp256k1、ed25519、sm2三种可选算法，默认secp256k1。 |
响应结果:
{
"result": {
"account_id": "hDycJcUZwWnm9VGoQVHs9EpVz2Bwha9Ej9",
"key_type": "secp256k1",
"master_key": "DULL BARN PIT ORE CHOW BUCK OHIO FIT MYRA FEAR FEEL BLOC",
"master_seed": "snB11sw4*************TCT1ro1y",
"master_seed_hex": "B2EC37BF048722C7BE64F617D0602A78",
"public_key": "aBP1qZ89tF7NLoFESEoRQcZyZ9gUiF9u4ox7UwMdEHyGedDmCo1G",
"status": "success"
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| account_id | string | 账号地址 |
| key_type | string | 生成账号的加密算法，有secp256k1、ed25519、sm2三种可选算法，默认secp256k1。 |
| master_key | string | 助记词 |
| master_seed | string | 私钥 |
| master_seed_hex | string | Hex编码私钥 |
| publick_key | string | 公钥 |
| status | string | 响应状态 |
2.2.2 查询账号信息
获取账号的详细信息。
请求:
{
"method": "account_info",
"params": [
{
"account": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"ledger_index": "current",
}
]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| account | string | 账号 |
| ledger_index | string / unsigned int | 账本高度，string类型的值包括：current表示最新当前账本，closed表示最新已关闭的账本，validated表示最新已验证账本。unsigned int类型的取值范围为1~2^3-1,表示账本的高度。 |
响应结果:
{
"result": {
"account_data": {
"Account": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"Balance": "13369870000",
"Flags": 0,
"LedgerEntryType": "AccountRoot",
"OwnerCount": 0,
"PreviousTxnID": "7EA2000C608D140EA81F564EB28EA41AE5EA12018608AD7EC13BFEF02EA225B7",
"PreviousTxnLgrSeq": 201637,
"Sequence": 14,
"index": "AA22EEB13821659B8316218C1D78606FD9C57C3192C2104EB7B0920AA30FF6C6"
},
"ledger_current_index": 467816,
"queue_data": {
"txn_count": 0
},
"status": "success",
"validated": false
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| Account | string | 账号地址 |
| Balance | string | 账号HWT余额，单位为滴。1 HWT=1000000 Drops，即一百万滴 |
| Flags | unsigned int | 标志 |
| PreviousTxnID | string | 上一次交易的HashID |
| PreviousTxnLgrSeq | unsigned int | 上一次交易的账本高度 |
| Sequence | unsigned int | 交易流水号 |
| index | string | 账号对象的HashID |
| status | string | 响应状态 |
| validated | bool | 当前账本是否已验证 |
2.2.3 账号设置
设置账号的标志位和附加信息。 其中标志位的操作包括设置和清除。 SetFlag：设置标志位， ClearFlag：清除标志位
请求:
{
"method": "submit",
"params": [{
"secret": "ss3ZBtHP********ryGE4Kuf",
"tx_json": {
"TransactionType": "AccountSet",
"Account" : "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"SetFlag": 7
}
}]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| method | string | RPC接口名称 |
| secret | string | 私钥 |
| TransactionType | string | 交易类型 ，AccountSet：账户设置 |
| Account | string | 源账号地址 |
| SetFlag | number | （可选）为此账号启用的整数标志，取值范围如下。 |
| 标志位名称 | 值 | 作用 |
|---|---|---|
| asfDisallowHWT | 3 | 设置后，将不允许向该账号转账HWT |
| asfDisableMaster | 4 | 设置后，将不允许用该账号密钥签名 |
| asfNoFreeze | 6 | 设置后，表示承诺永不冻结该账号发行的二级资产，该标志位无法清除。 |
| asfGlobalFreeze | 7 | 设置后，将冻结该账号发行的所有二级资产。 |
响应结果:
{
"result": {
"engine_result": "tesSUCCESS",
"engine_result_code": 0,
"engine_result_message": "The transaction was applied. Only final in a validated ledger.",
"status": "success",
"tx_blob": "1200032280000000240000000E202100000008684000000000002710732103EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C87446304402207A3A51F0E0F1F83CD02BD6FAF6425A9D32492FC449C03E3D713468E02F05D0D20220182EE00EC72478351C733D964B6F439D12B3F7EA99EDE3A994B63EAD5091273A81142E244E6F20104E57C0C60BD823CB312BF10928C7",
"tx_json": {
"Account": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"Fee": "10000",
"Flags": 2147483648,
"Sequence": 14,
"SetFlag": 8,
"SigningPubKey": "03EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C8",
"TransactionType": "AccountSet",
"TxnSignature": "304402207A3A51F0E0F1F83CD02BD6FAF6425A9D32492FC449C03E3D713468E02F05D0D20220182EE00EC72478351C733D964B6F439D12B3F7EA99EDE3A994B63EAD5091273A",
"hash": "E2D3A468F6CD4A52B3580D8041AD325146B79E38C50D89093020C3A1BFB24E9C"
}
}
}
2.2.4 激活账号
激活一个账号，首次转账至少要超过30个HWT。可以通过自己持有的其它有钱的账号向该站好转账，或者把账号发给其他朋友，让他们向该账号转账。
请求:
{
"method": "submit",
"params": [{
"offline": false,
"secret": "ss3ZBtHP********ryGE4Kuf",
"tx_json": {
"Account": "hHb9CJAWyB4hj91VRWn96DkukG4bwdtyTr",
"Amount": 30000000,
"Destination": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"TransactionType": "Payment",
}
}]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| method | string | RPC接口名称 |
| offline | bool | 是否离线提交。默认false（在线提交） |
| Amount | unsigned int | 金额，单位滴，1百万滴等于1HWT |
| Account | string | 源账号 |
| Destination | string | 目标账号，即需要被激活的账号 |
响应结果:
{
"result": {
"engine_result": "tesSUCCESS",
"engine_result_code": 0,
"engine_result_message": "The transaction was applied. Only final in a validated ledger.",
"status": "success",
"tx_blob": "1200002280000000240000000F614000000000000064684000000000002710732103EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C87446304402206BEE8A50F000D3EBA91F4C50D0A2D08927514C414ABCA729303AE09B1A2E9A90022030E05AC825DC510AF5244552091A08FD84364A32B7F57B1C5CEC2FF19561051781142E244E6F20104E57C0C60BD823CB312BF10928C78314B5F762798A53D543A014CAF8B297CFF8F2F937E8F9EA7C06737472696E677D0474657374E1F1",
"tx_json": {
"Account": "hHb9CJAWyB4hj91VRWn96DkukG4bwdtyTr",
"Amount": "30000000",
"Destination": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"Fee": "10000",
"Flags": 2147483648,
"Sequence": 15,
"SigningPubKey": "03EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C8",
"TransactionType": "Payment",
"TxnSignature": "304402206BEE8A50F000D3EBA91F4C50D0A2D08927514C414ABCA729303AE09B1A2E9A90022030E05AC825DC510AF5244552091A08FD84364A32B7F57B1C5CEC2FF195610517",
"hash": "4E284CD73E6BDE90DD8A740B4E49340B3C5A8D4DBA497BFDD75264351EB16617"
}
}
}
2.2.5 查询账号交易历史
账号的交易历史，是账号主动发起的交易的原始数据集合。如果交易记录过多，将录采用分页的方式返回。 请求:
{
"method": "account_tx",
"params": [
{
"account": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"binary": false,
"forward": false,
"ledger_index_max": -1,
"ledger_index_min": -1,
"limit": 2
}
]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| method | string | RPC接口名称 |
| binnary | bool | 返回的交易记录格式是否以二进制格式，（默认）false，即用json格式，true表示用二进制格式 |
| forward | bool | 交易记录排序方向。默认false，表示最新的交易排在最前面。true，表示最旧的交易排在最前面。 |
| ledger_index_min | int | 账本起始高度，-1表示从最小开始 |
| ledger_index_max | int | 账本结束高度，-1表示到当前结束 |
| limit | unsigned int | 返回记录的分页大小，默认200。 |
响应结果:
{
"result": {
"account": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"ledger_index_max": 467936,
"ledger_index_min": 1,
"limit": 2,
"marker": {
"ledger": 467892,
"seq": 3
},
"status": "success",
"transactions": [
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "hHb9CJAWyB4hj91VRWn96DkukG4bwdtyTr",
"AssetNumber": "0000000000000006",
"Balance": "99989762898358460",
"Flags": 8388608,
"OwnerCount": 0,
"Sequence": 194
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "2B6AC232AA4C4BE41BF49D2459FA4A0347E1B543A4C92FCEE0821C0201E2E9A8",
"PreviousFields": {
"Balance": "99989762898348460"
},
"PreviousTxnID": "2288D9E2BCA0227C45BC44AB4C6726B7BDC085C31E16CD1A84D5E5020CEF2D13",
"PreviousTxnLgrSeq": 467910
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"AssetNumber": "0000000000000000",
"Balance": "2029860000",
"Flags": 0,
"Issues": [
"DAE8DF06894FC876EE25A875D2BADF08797F63FC917DC1EEA7D86573E355956F",
"AEA876150CC5D8824F5800188B9191D197DA64A5E677692AB92547888A108180"
],
"OwnerCount": 2,
"Sequence": 15
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "3E85929FA644A46D1A96D685D00B5A4BDEB90FD1D7D7FCD1C556DDC79CDF8101",
"PreviousFields": {
"Balance": "2029870000",
"Issues": [
"DAE8DF06894FC876EE25A875D2BADF08797F63FC917DC1EEA7D86573E355956F"
],
"OwnerCount": 1,
"Sequence": 14
},
"PreviousTxnID": "47FA4645F1F4CBB3EC74CFE93D891558B207BFC62BF9B6A9755942F7126E972A",
"PreviousTxnLgrSeq": 467892
}
},
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"RootIndex": "4239D02F30951004B5E01A1A4026A0B1B5AAA7B0B50B17709B18225CB4C160F0"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "4239D02F30951004B5E01A1A4026A0B1B5AAA7B0B50B17709B18225CB4C160F0"
}
},
{
"ModifiedNode": {
"FinalFields": {
"Flags": 0,
"Owner": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"RootIndex": "9789E55305E9E895E8A54BB98C95D650CEFB7DE3492C7AEAE705BFA083818721"
},
"LedgerEntryType": "DirectoryNode",
"LedgerIndex": "9789E55305E9E895E8A54BB98C95D650CEFB7DE3492C7AEAE705BFA083818721"
}
},
{
"ModifiedNode": {
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "AA22EEB13821659B8316218C1D78606FD9C57C3192C2104EB7B0920AA30FF6C6",
"PreviousTxnID": "2288D9E2BCA0227C45BC44AB4C6726B7BDC085C31E16CD1A84D5E5020CEF2D13",
"PreviousTxnLgrSeq": 467910
}
},
{
"CreatedNode": {
"LedgerEntryType": "HWCHAINState",
"LedgerIndex": "AEA876150CC5D8824F5800188B9191D197DA64A5E677692AB92547888A108180",
"NewFields": {
"Balance": {
"currency": "AAA",
"issuer": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"value": "0"
},
"HighLimit": {
"currency": "AAA",
"issuer": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"value": "0"
},
"LowLimit": {
"currency": "AAA",
"issuer": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"value": "0"
}
}
}
},
{
"CreatedNode": {
"LedgerEntryType": "HWCHAINState",
"LedgerIndex": "BC116352359C6D47756C5FDB30D1EDE95433FF696B519E217D9915D7B46FA57D",
"NewFields": {
"Balance": {
"currency": "AAA",
"issuer": "hhhhhhhhhhhhhhhhhhhhBZbvji",
"value": "0"
},
"Flags": 131072,
"HighLimit": {
"currency": "AAA",
"issuer": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"value": "100000"
},
"LowLimit": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "0"
}
}
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS"
},
"tx": {
"Account": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"Fee": "10000",
"Flags": 2147483648,
"LimitAmount": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "100000"
},
"Sequence": 14,
"SigningPubKey": "029A80E85C9EAFE4CF6376524AF360724D4ECE4F2B6197A2E1172E81CC071B7D0C",
"TransactionType": "TrustSet",
"TxnSignature": "3045022100936B1E741C3D75CB9E189F8CFD764D56A0AB41065E93A8E727A967D2FFFB530402206FB684B1CEE49682B4F3F9261FDB05561F88A4DE3B1F893A90E0F8942322894F",
"date": 619177560,
"hash": "D6CC7C779DD8F4264FE0AFAE3B6BCBEC5796E1C40B070DACD9EEEAFEFB64354F",
"inLedger": 467925,
"ledger_index": 467925
},
"validated": true
},
{
"meta": {
"AffectedNodes": [
{
"ModifiedNode": {
"FinalFields": {
"Account": "hHb9CJAWyB4hj91VRWn96DkukG4bwdtyTr",
"AssetNumber": "0000000000000006",
"Balance": "99989762898338360",
"Flags": 8388608,
"OwnerCount": 0,
"Sequence": 194
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "2B6AC232AA4C4BE41BF49D2459FA4A0347E1B543A4C92FCEE0821C0201E2E9A8",
"PreviousFields": {
"Balance": "99989762898328360"
},
"PreviousTxnID": "754F345990B21C1049A5365D78BCD9F283727A1F8C01793D376EB1D2231B03E4",
"PreviousTxnLgrSeq": 467893
}
},
{
"ModifiedNode": {
"FinalFields": {
"Balance": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "300100"
},
"Flags": 0,
"HighLimit": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "0"
},
"LowLimit": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "0"
}
},
"LedgerEntryType": "HWCHAINState",
"LedgerIndex": "34E624328ED954843F47E0AF208724F6F79859B14FED869C1C9A29D3D57E7BB9",
"PreviousFields": {
"Balance": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "300000"
}
},
"PreviousTxnID": "754F345990B21C1049A5365D78BCD9F283727A1F8C01793D376EB1D2231B03E4",
"PreviousTxnLgrSeq": 467893
}
},
{
"ModifiedNode": {
"FinalFields": {
"Account": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"AssetNumber": "0000000000000003",
"Balance": "15369799900",
"Flags": 8388608,
"Issues": [
"34E624328ED954843F47E0AF208724F6F79859B14FED869C1C9A29D3D57E7BB9"
],
"OwnerCount": 0,
"Sequence": 21
},
"LedgerEntryType": "AccountRoot",
"LedgerIndex": "AA22EEB13821659B8316218C1D78606FD9C57C3192C2104EB7B0920AA30FF6C6",
"PreviousFields": {
"Balance": "15369809900",
"Sequence": 20
},
"PreviousTxnID": "754F345990B21C1049A5365D78BCD9F283727A1F8C01793D376EB1D2231B03E4",
"PreviousTxnLgrSeq": 467893
}
},
{
"ModifiedNode": {
"FinalFields": {
"Balance": {
"currency": "AAA",
"issuer": "hhhhhhhhhhhhhhhhhhhhBZbvji",
"value": "-100100"
},
"Flags": 131072,
"HighLimit": {
"currency": "AAA",
"issuer": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"value": "10000000"
},
"HighNode": "0000000000000000",
"LowLimit": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "0"
},
"LowNode": "0000000000000000"
},
"LedgerEntryType": "HWCHAINState",
"LedgerIndex": "D9478A109CD2C17E75A04E4F18B4A1D4FD8AFCCFC92742A8F72AD0BB6C640E77",
"PreviousFields": {
"Balance": {
"currency": "AAA",
"issuer": "hhhhhhhhhhhhhhhhhhhhBZbvji",
"value": "-100000"
}
},
"PreviousTxnID": "14233027A814E677CFEE13C47309CBE42D6D15CB99EA090FA920A5A3B9989A4D",
"PreviousTxnLgrSeq": 467892
}
}
],
"TransactionIndex": 0,
"TransactionResult": "tesSUCCESS",
"delivered_amount": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "100"
}
},
"tx": {
"Account": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"Amount": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "100"
},
"Destination": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"Fee": "10000",
"Flags": 2147483648,
"Sequence": 20,
"SigningPubKey": "03EAC169AF572EB52038D1C51F7E5B9C94CE34A7FBB714860BE001BDE25A4B03C8",
"TransactionType": "Payment",
"TxnSignature": "304402203E834B34015FECA576495B26BE5F9417DC66E08DF19B6DD03426EB9A464AD94102201C32708767013A1FDB103F4AF98690D056E330B5C2355E5A127EBEA603636FC4",
"date": 619177290,
"hash": "EC6846907FF581B64CC0670765C7DE5D6CFF7D0F7C4994DFEAA67DA6A6082094",
"inLedger": 467899,
"ledger_index": 467899
},
"validated": true
}
]
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| marker | object | 分页标志 |
| meta | object | 交易记录原始信息 |
| AffectedNodes | object | 影响的单元，包括 CreatedNode，ModifiedNodes，DeletedNode |
| CreatedNode | object | 创建的单元，包含 NewFields，新建的字段。 |
| ModifiedNode | object | 修改的单元，包含 PreviousFields，修改前的字段；FinalFields，修改后的字段。 |
| DeletedNode | object | 删除的单元，包含 FinalFields，被删除的字段。 |
| TransactionIndex | unsigned int | 交易序号，该交易在所在区块中的序号 |
| TransactionResult | string | 交易结果 |
| delivered_amount | string | 交易金额 |