托管账户数据上链

开发者可通过自动生成的托管账户进行数据上链,托管账户需要开发者自行充值。

1、上链数据保存在区块链交易的OP_RETURN

2、目前仅支持 BSV

第一步:查询或者创建托管账户地址

如果你的开发账户还没有托管账户,这个接口会建立一个然后返回你的账号地址。如果已经有,也会返回你的账号地址。

参数 类型 是否必须 说明
appid string 商家应用账号
appsecret string 商家应用密钥
  • Body 参数(JSON):
参数 类型 是否必须 说明
coin_type string 托管账户的币种,目前仅支持 BSV,例:“BSV”
  • 成功

错误码 code 为 0 时表示成功

{
  "code": 0,
  "msg": "ok",
  "data": {
    "coin_type": "BSV",
    "address": "1Mfy9GfxTLePsgRJiBGa6jdTCbMXaPnXXL"
  }
}
  • 返回参数说明
参数 类型 说明
coin_type string 币种
address string 币种对应的地址

第二步:查询托管账户余额

数据上链需要托管账户的余额足够高。开始用’数据上链‘之前,请查询你的余额,如果不够请转一些 BSV 到你的地址去。

参数 类型 是否必须 说明
appid string 商家应用账号
appsecret string 商家应用密钥
  • Body 参数(JSON):
参数 类型 是否必须 说明
coin_type string 托管账户的币种,目前仅支持 BSV
  • 成功

错误码 code 为 0 时表示成功

{
  "code": 0,
  "data": {
    "confirm": 2434,
    "unconfirm": 0
  },
  "msg": "ok"
}
  • 返回参数说明
参数 类型 说明
confirm int 区块链确认的金额
unconfirm int 区块链未确认的金额

第三步:通过托管账户进行数据上链

参数 类型 是否必须 说明
appid string 商家应用账号
appsecret string 商家应用密钥
  • Body 参数(JSON):
参数 类型 是否必须 说明
coin_type string 托管账户的币种,目前仅支持 BSV,例:"BSV"
data string 需要上链的数据
data_type int {data}的数据类型,0 为任意字符串,1 为比特币专用的脚本 rawhex

例:{ "coin_type":"BSV", "data":"this is push chain data test." ,"data_type":0 }

  • 成功

错误码 code 为 0 时表示成功

{
  "code": 0,
  "data": {
    "tx_id": "4a0225f00d07cef1c48b9be9f1d55e598f37bcac57ab650606eed39829fea3a1",
    "fee": 134
  },
  "msg": "ok"
}
  • 返回参数说明
参数 类型 说明
tx_id string 上链的 txID
fee int 上链的手续费