9 星火令
星火令转移、星火令查询、星火令申请等,暂缓开通。
9.1 获取转移星火令blob
接口说明:
星火·链网中的星火令资产进行转移。
请求参数:
字段名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
from | String(64) | 是 | 源地址 |
to | String(64) | 是 | 目的地址 |
amount | String(30) | 是 | 数量(底层最小单位 需要乘以10的8次方;比如 转1个星火令 此时这块需要传 100000000) |
返回数据:
字段名 | 类型 | 描述 |
---|---|---|
blob | String | Blob串 |
txHash | String | 链上交易hash |
示例:
(1)请求示例:
http请求方式:POST
https://{url}/v1/xht/transfer/blob
{
"accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhcGlLZXkiOiJDcHB0NHRuMFlFZkIyMHJXIiwiaXNzIjoiQklGLUNIQUlOIiwiZXhwIjoxNjE5MzQyNDIyLCJiaWQiOiJkaWQ6YmlkOmVmMjhwTTlNRzNUR1hHeVdBVzRKcFdDRnNKRGQ1TUJuYyJ9.3gcQQBqvqtZH1q-TfUiGne68R1TnBcvLAA6nIJ8qDGU",
"params": {
"from": "did:bid:ef29SVUnVVUfToJEKmeAVd9TY6fsDYBHi",
"to": "did:bid:ef24NBA7au48UTZrUNRHj2p3bnRzF3YCH",
"amount":123
}
}
(2)返回结果示例:
a. 接口调用成功,则返回JSON数据示例为:
{
"data":{
"blob":"A296469643A6269643A6652665770673644675A6B3232346F7A5570644343654C5A6231394635705238511001225A080712296469643A6269643A666D6E7A42315A724156375966727933665759795071646B6A57776F7458635258622B0A296469643A6269643A6841706E5959474C4550614678467A35543946383374485A6242474338483776513080DAC40938E807"
},
"errorCode": 0,
"message": "操作成功"
}
b. 接口调用失败,则返回JSON数据示例为:
{
"errorCode": 940000,
"message": "系统内部错误"
}
9.2 转移星火令提交
接口说明:
交易签名后,通过该接口提交转移星火令的交易。
请求参数:
字段名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
blob | String | 是 | 交易blob串 |
txHash | String(64) | 是 | 交易hash |
signerList | List | 是 | 签名列表 |
signerList.signBlob | String(128) | 是 | 签名串 |
signerList.publicKey | String(128) | 是 | 签名者公钥 |
返回数据:
字段名 | 类型 | 描述 |
---|---|---|
txHash | String | 链上交易hash |
示例:
(1)请求示例:
http请求方式:POST
https://{url}/v1/xht/transfer/submit
{
"accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhcGlLZXkiOiJhdkNmcDdscU16SDVtTk5kIiwiaXNzIjoiQklGLUNIQUlOIiwiZXhwIjoxNjExNzQ0NjIwLCJiaWQiOiJkaWQ6YmlkOmVmejNvVFFHN0xZZktKRWlDeU1nNThOOVREZjl2cFd5In0.sCm7gaWX_nmIasUyo64tn5FeAqDaxxDn2Kb9Jixk2YI",
"params": {
"blob": "0A2D6469643A6269643A627930313A6566544268396A53374B68366D69754736537A5A434E5A554534314B6A62353410032280020807122D6469643A6269643A627930313A6566554E4370633174417238483463434C66617577736148654532425776453252CC010A2E6469643A6269643A627930313A6566323369775A5434576A317A41594469355237434E70323534744666444370721A99017B226D6574686F64223A227365744163636F756E74537461747573222C22706172616D73223A7B227375626D697454696D65223A313630373037303633393835372C226465737441646472657373223A226469643A6269643A627930313A656662504A34697732315755365A43687576374E6A587531374466484D765176222C2272656D61726B73223A22222C22737461747573223A307D7D3080EAADE907",
"txHash": "6592488eba4c85566cf853285fa98d840e83734d74d0e4fa336af45a75581496",
"signerList": [{
"signBlob": "B91AB8D815D3230AC678AE560351A10CC536470F80C6B0B89498BB0DA2811A1A5500AAE1AAE25EF05FBC6FB0F9CBE919779C28F424629E7B324E9EA81924550D",
"publicKey": "b065667cc1e4584bc9ddb6806c455bdea9f8390724a77a6ed2f6369c830043418c0745"
}]
}
}
(2)返回结果示例:
a. 接口调用成功,则返回JSON数据示例为:
{
"errorCode": 0,
"message": "操作成功",
"data": {
"txHash": "6592488eba4c85566cf853285fa98d840e83734d74d0e4fa336af45a75581496"
}
}
b. 接口调用失败,则返回JSON数据示例为:
{
"errorCode": 940000,
"message": "系统内部错误"
}