2 JSON-RPC API
2.4 授信接口
授信是用户与发行商之间签约的行为。授信后，用户账号与发行商账号之间就发行商发行的二级资产建立信任线（account_line）。用户可以接收发行商发行的二级资产。发行商发行的二级资产可以在与其建立（account_line）的账号之间流通。
2.4.1 查询账号授信历史
请求:
{
"method": "account_lines",
"params": [
{
"account": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA"
}
]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| account | string | 账号 |
| ledger_hash | string | （可选）账本哈希 |
| ledger_index | string / unsigned int | （可选）账本高度 |
| peer | string | （可选）第二个账号的地址。如果提供，则仅显示连接两个账号的信任行 |
| limit | unsigned int | （可选）返回记录的分页大小 |
| marker | object | （可选）分页标志 |
响应结果:
{
"id" : 1,
"result" : {
"account" : "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"ledger_current_index" : 2424,
"lines" : [
{
"account" : "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"balance" : "100210",
"currency" : "BBB",
"limit" : "10000000",
},
{
"account" : "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"balance" : "4970",
"currency" : "AAA",
"limit" : "10000000",
}
],
"status" : "success",
"validated" : false
}
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| lines | Array | 信任行对象的数组 |
| ledger_current_index | Integer | 当前账本高度 |
每个信任行对象包含以下字段：
| 字段名称 | 类型 | 描述 |
|---|---|---|
| account | string | 发行商账号地址 |
| balance | string | 持有的二级通证的数量 |
| currency | string | 二级通证名称 |
| limit | string | 授信该二级通证的最大额度 |
2.4.2 授信
请求:
{
"method": "submit",
"params": [{
"secret": "ssqtQ2Jc*************ARqb9EYe",
"tx_json": {
"TransactionType": "TrustSet",
"Account" : "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"LimitAmount":
{
"currency":"AAA",
"value":"100000",
"issuer":"hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA"
}
}
}]
}
| 字段名称 | 类型 | 描述 |
|---|---|---|
| LimitAmount | Object | 授信额度，即签约的最大额度，账号持有的该资产不能超过这个额度。 |
| currency | string[] | 二级通证名称 |
| value | string | 授信额度 |
| issuer | 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": "1200142280000000240000000E63D5C38D7EA4C6800000000000000000000000000055534400000000002E244E6F20104E57C0C60BD823CB312BF10928C76840000000000027107321029A80E85C9EAFE4CF6376524AF360724D4ECE4F2B6197A2E1172E81CC071B7D0C74473045022100936B1E741C3D75CB9E189F8CFD764D56A0AB41065E93A8E727A967D2FFFB530402206FB684B1CEE49682B4F3F9261FDB05561F88A4DE3B1F893A90E0F8942322894F81148B240FCDC580525F0BFCABB590F434252AC36AF8",
"tx_json": {
"Account": "hDg53Haik2475DJx8bjMDSDPj4VX7rtaMd",
"Fee": "10000",
"Flags": 2147483648,
"LimitAmount": {
"currency": "AAA",
"issuer": "hnUy2SHThB9DubsPmkJZUXTf5FcNDGhYEA",
"value": "100000"
},
"Sequence": 14,
"SigningPubKey": "029A80E85C9EAFE4CF6376524AF360724D4ECE4F2B6197A2E1172E81CC071B7D0C",
"TransactionType": "TrustSet",
"TxnSignature": "3045022100936B1E741C3D75CB9E189F8CFD764D56A0AB41065E93A8E727A967D2FFFB530402206FB684B1CEE49682B4F3F9261FDB05561F88A4DE3B1F893A90E0F8942322894F",
"hash": "D6CC7C779DD8F4264FE0AFAE3B6BCBEC5796E1C40B070DACD9EEEAFEFB64354F"
}
}
}