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": "系统内部错误"
}