Skip to content

Latest commit

 

History

History
266 lines (199 loc) · 7.17 KB

TRANSFER_API.md

File metadata and controls

266 lines (199 loc) · 7.17 KB
Raw

BAC链主网API

主要提供BAC主网发送转账交易和转账相关信息查询，通过网页浏览BAC链交易信息，请访问BAC区块浏览

说明

  • 主网供访问节点为：‘http://13.231.192.54:1317/
  • BAC基本信息：币种符号为 nbac ，小数位数为 9 位
  • BCV基本信息：币种符号为 ubcv ，小数位数为 6 位
  • 矿工费使用BAC，最小值为每笔交易0.1 BAC

API

账号

查询钱包信息

curl -XGET 'http://13.231.192.54:1317/auth/accounts/bac1ywmevyc2wqeh90kwdx6v3uxn0jkpqxxxjffx34'

返回示例：

{
    "type": "auth/Account",
    "value": {
        "address": "bac1ywmevyc2wqeh90kwdx6v3uxn0jkpqxxxjffx34",
        "coins": [{
            "denom": "nbac",
            "amount": "10000000000"
        }],
        "public_key": null,
        "account_number": "10383",
        "sequence": "0"
    }
}

返回参数说明

  • value.account_number 钱包编号（与钱包地址唯一对应）
  • value.sequence 交易编号
  • value.coins 资产列表
    • denom 资产币种
    • amount 资产余额

查询钱包余额

curl -XGET 'http://13.231.192.54:1317/bank/balances/bac1ywmevyc2wqeh90kwdx6v3uxn0jkpqxxxjffx34'

返回示例：

[{
    "denom": "nbac",
    "amount": "10000000000"
}]

返回参数说明

  • denom 资产币种
  • amount 资产余额

区块

查询最新区块信息

curl -XGET 'http://13.231.192.54:1317/blocks/latest'

返回示例

{
    "block_meta": {
        "block_id": {
            "hash": "9CFE81B4891C4FB9071407679D76CDCE16568BA33368038AC48E4ED9FF404BE9",
            "parts": {
                "total": "1",
                "hash": "E9013CE1865BA1EC5F7FA84ADB52757CEF51EF0D1F56E5659ED9B26D507D955B"
            }
        },
        "header": { ... }
    },
    "block": {
        "header": { ... },
        "data": {
            "txs": ["0AHwYl3uCkQUFoD4ChSV/83hzsfXIVepSDefMi/7zm1LVBIUzpaKM2jM/o2AxlqrdJQ2x1BVS6kaEgoEbmJhYxIKODAwMDAwMDAwMBIYChEKBG5iYWMSCTEwMDAwMDAwMBCAwtcvGmoKJuta6YchA+3GoGaRood8lXhLeovfXyon5KX8SJLQ5ZX/wCG54QSOEkCVSeuyDpBQXX5DzyoqTya7sNwHkyBYXJjF9wa791RwgmyUpkSCbD9TJQF/4xek+fA9q+TgVXZugZ88RpcyqI8y"]
        },
        "evidence": {
            "evidence": null
        },
        "last_commit": {
            "block_id": {
                "hash": "E2669A3FD194121A196EC5B787AEAF3B21584CEA71E9D6110FC6A00E97246E5C",
                "parts": {
                    "total": "1",
                    "hash": "5F3FDAB0A13A4D7B18D4157923B51BF46E1EC06DF4FA1C2DC52DA5C247C42540"
                }
            },
            "precommits": [ ... ]
        }
    }
}

返回参数说明：

  • block.header.height 当前区块高度
  • block.header.time 出块时间
  • block.data.txs 区块打包的交易哈希列表

解析交易hash

const crypto=require('crypto');
var tx = '0AHwYl3uCkQUFoD4ChSV/83hzsfXIVepSDefMi/7zm1LVBIUzpaKM2jM/o2AxlqrdJQ2x1BVS6kaEgoEbmJhYxIKODAwMDAwMDAwMBIYChEKBG5iYWMSCTEwMDAwMDAwMBCAwtcvGmoKJuta6YchA+3GoGaRood8lXhLeovfXyon5KX8SJLQ5ZX/wCG54QSOEkCVSeuyDpBQXX5DzyoqTya7sNwHkyBYXJjF9wa791RwgmyUpkSCbD9TJQF/4xek+fA9q+TgVXZugZ88RpcyqI8y';
var buffer = new Buffer.from(tx, 'base64')
var txHash = crypto.createHash('sha256').update(buffer).digest('hex')
console.log(txHash)

根据区块高度查询区块信息

curl -XGET 'http://13.231.192.54:1317/blocks/1'

返回参数同上

交易

查询交易信息

curl -XGET 'http://13.231.192.54:1317/txs/874335D30C35934E4F787035F82FB37B76BC41127C2ED4FD69DDB1B8B2D71808'

返回示例：

{
    "height": "559379",
    "txhash": "874335D30C35934E4F787035F82FB37B76BC41127C2ED4FD69DDB1B8B2D71808",
    "raw_log": "[{\"msg_index\":\"0\",\"success\":true,\"log\":\"\"}]",
    "logs": [{
        "msg_index": "0",
        "success": true,
        "log": ""
    }],
    "gas_wanted": "100000000",
    "gas_used": "19423",
    "tags": [{
        "key": "action",
        "value": "send"
    }, {
        "key": "sender",
        "value": "bac1jhlumcwwcltjz4affqme7v30l08x6j65zkafez"
    }, {
        "key": "recipient",
        "value": "bac1e6tg5vmgenlgmqxxt24hf9pkcag92jafdtn37c"
    }],
    "tx": {
        "type": "auth/StdTx",
        "value": {
            "msg": [{
                "type": "bacchain/MsgSend",
                "value": {
                    "from_address": "bac1jhlumcwwcltjz4affqme7v30l08x6j65zkafez",
                    "to_address": "bac1e6tg5vmgenlgmqxxt24hf9pkcag92jafdtn37c",
                    "amount": [{
                        "denom": "nbac",
                        "amount": "8000000000"
                    }]
                }
            }],
            "fee": {
                "amount": [{
                    "denom": "nbac",
                    "amount": "100000000"
                }],
                "gas": "100000000"
            },
            "signatures": [ ... ],
            "memo": ""
        }
    },
    "timestamp": "2020-05-05T08:11:35Z"
}

返回参数说明：

  • height 区块高度
  • timestamp 打包时间
  • logs.success 交易是否成功执行：true 成功，false 失败
  • tx.type 交易类型
  • tx.value.msg[0].type 消息类型
    • bacchain/MsgWithdrawDelegationReward 区块奖励提取
      • tx.value.msg[0].value.delegator_address 奖励转出地址
      • tags[5].value 奖励转入地址
      • tags[1].value 奖励数量和币种
    • bacchain/MsgSend 转账
      • tx.value.msg[0].value.from_address 转出地址
      • tx.value.msg[0].value.to_address 转入地址
      • tx.value.msg[0].value.amount[0].denom 转账币种
      • tx.value.msg[0].value.amount[0].amount 转账数量
  • tx.value.fee.amount[0].denom 消耗矿工费币种
  • tx.value.fee.amount[0].amount 消耗矿工费数量
  • tx.value.memo 交易备注信息

交易广播

curl -H "Content-Type: application/json" -X POST  --data '{"tx":{"msg":[{"type":"bacchain/MsgWithdrawValidatorCommission","value":{"validator_address":"bacvaloper10tyhju9pfpfkt7hrd2zqr0vjn4k5sfrrl5kav9"}}],"fee":{"amount":[{"amount":"2000000","denom":"nbac"}],"gas":"2000000"},"signatures":[{"signature":"y1eSl84zcqZvLz3q78RGpf+eDMgpwHUTp0JVCJs1yi1WcXJ4U4LxUZ9zgj8F24v+6IVSeHNM5LTC13o6HetihQ==","pub_key":{"type":"tendermint/PubKeySecp256k1","value":"A2dflU7iwfJgJNEq+m51g7L+uuaMtaBj9z0ZZPmGENw9"}}],"memo":""},"mode":"sync"}' 'http://13.231.192.54:1317/txs'

返回示例

{
    "height": "0",
    "txhash": "F6A8F4D8C7798BC1A7FDAEDDC89BD7F113B60A1EED94158AA5084524651B7269"
}

返回参数说明

  • txhash 交易哈希

正确示例 正确示例:{"height":"0","txhash":"504ECA11225E34618CDFF946EB88B430FBA16F7E76D39A90D05B1187CFE914CB"}

错误示例:交易已经存在 {"error":"broadcast_tx_sync: Response error: RPC error -32603 - Internal error: Tx already exists in cache"}

错误示例:签名错误 {"height":"0","txhash":"7711FA97DDBD916E233093D0A2D261FDBA3886EA6B508A82D92B8704847264C8","code":4,"raw_log":"{"codespace":"sdk","code":4,"message":"signature verification failed; verify correct account sequence and chain-id"}"}

判断标准存在hash且不存在code;如果存在code,后边的是错误日志；原则上是否发送成功,依照是否可以在链上查询。