快速上手

业务申请和安装络谱工具完成后,您可使用BROPTool将您的业务系统接入络谱平台。

为协助您快速接入测试,我们提供了样例:

  • 络谱凭证简易流程:场景化描述了络谱系统写入凭证信息的简易流程,目的是展示几组接口之间的使用关联,让读者能快速了解业务功能对接的流程。

凭证简易流程

凭证简易流程包含场景介绍、数据准备、预备知识以及实现凭证业务的四组接口调用介绍。

场景介绍

设计了五个任务,完成发行凭证、交易凭证和查询信息等功能闭环:

  • 创建用户并给用户分配角色
  • 发行凭证
  • 交易凭证
  • 冻结、解冻、核销凭证
  • 查询信息

数据准备

合作方在使用开发指南前,通过管理控制台、安全插件、BROPTool部署等获得的配置数据。

身份合约地址:b5b84fb7b1474fa9c9949cbe056b4bf6156e4c90

凭证启动合约地址:948aa806c16f67ff4f312d41e6dfb80079889e4d

专区编号:0000000000eb7a83000000005fd3080f00000000

凭证合约地址:15bfd2c52fcd02dbead053fc6ce325ddaac0ab37

凭证项目管理合约地址:83eb2ca6e5f584fbaa9f5db1a3a57344d68ed4e4

账户管理合约地址:3c90b1ed94f2b42dc5958be2d52a55a26900f86c

代理管理合约地址:cf169dce91c0b3f5f14ff40c02085029e1c0b89a

凭证符号:ceshi

创建用户并给用户分配角色

创建一个账户及其对应的身份

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000", //专区编号
    "hsmUserId":"generalVoucherUser", //sender 加密机用户ID
    "bizId":"1608278265299",//bizId 不可重复
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",//凭证启动合约地址
    "method":"createAccount", //合约方法       
    "params":[
        "b5b84fb7b1474fa9c9949cbe056b4bf6156e4c90", //发起者的Identity合约(身份合约地址)
        "ceshi",                                   //  凭证符号
        "pz0000001",                               //身份唯一标识
        "4E60EB3C96FFC364E1C1FCA853FDFE4197AAC928", //主公钥地址
        "测试",                                     //身份附加信息(建议传json字符串,统一规则)
        ["ISSUER"],                                 //关联的角色列表                                        
        "杭州xxxx公司",                             //账户主体名称
        "123456789123456789",                       //统一社会信用代码
        "测试"                                      //账户附加信息(建议传json字符串,统一规则)
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"97be842c7cf280ea5812521bfcf20d480d2705920e3217676c561e1fa940e8f0", //交易hash
        "blockLimit":15635538                       //超时块号
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=97be842c7cf280ea5812521bfcf20d480d2705920e3217676c561e1fa940e8f0

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x97be842c7cf280ea5812521bfcf20d480d2705920e3217676c561e1fa940e8f0",
        "blockNumber": 15635530,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0xcd28f1c5a3d9a184cd7ff1fdc1e43d0cd39a321fbb11d2fbc84a40512701e236",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "symbol": "pz0000001",//身份的标识
                    "identity": "63c6b41745db9a046c78f3719bc2d2421d861cc6"  //身份的Identity合约
                },
                "topics": [
                    "NewIdentity"
                ]
            },
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "tokenSymbol": "ceshi", //凭证项目标识
                    "identity": "63c6b41745db9a046c78f3719bc2d2421d861cc6"  //身份的Identity合约
                },
                "topics": [
                    "NewAccount"
                ]
            }
        ]
    }
}

发行凭证

  • 发行到默认分片

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi02",     //sender的私钥
    "bizId":"1608279214667",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"issueToken",
    "params":[
        "63c6b41745db9a046c78f3719bc2d2421d861cc6", //发起者的Identity合约(需要有发行凭证的权限)
        "ceshi",                                    //凭证项目标识
        "63c6b41745db9a046c78f3719bc2d2421d861cc6", //持有者的Identity合约(可以是自己,也可以是其他人的身份合约,需要持有凭证的权限)
        1000000,                                    //发行数量
        "",                                         //ABI编码的附加参数(暂时可以为空) 
        "测试"                                      //附加数据
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"9d5356bde9e3ebfbccb0405eec2781a823cc7aa1b740d55d5f78d6c78620d588",
        "blockLimit":15635854
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=9d5356bde9e3ebfbccb0405eec2781a823cc7aa1b740d55d5f78d6c78620d588

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x9d5356bde9e3ebfbccb0405eec2781a823cc7aa1b740d55d5f78d6c78620d588",
        "blockNumber": 15635846,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0xe084f85bba8bb744e32907491525171c3f07b910633ae55a6dcedb04b385db6b",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "amount": 1000000,
                    "data": "测试",
                    "tokenSymbol": "ceshi",
                    "partitionId": "",//默认分片(分片id为空字符串)
                    "extraParams": "",
                    "holder": "63c6b41745db9a046c78f3719bc2d2421d861cc6",
                    "issuer": "63c6b41745db9a046c78f3719bc2d2421d861cc6"
                },
                "topics": [
                    "IssueToken"
                ]
            }
        ]
    }
}
  • 发行指定分片的凭证

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi02",
    "bizId":"1608280287161",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"issueTokenByPartition",
    "params":[
        "63c6b41745db9a046c78f3719bc2d2421d861cc6", //发起者的Identity合约(需要有发行凭证的权限)
        "ceshi",                                    //凭证项目标识
        "fp00000001",                               //分片ID
        "63c6b41745db9a046c78f3719bc2d2421d861cc6", //持有者的Identity合约(可以是自己,也可以是其他人的身份合约,需要持有凭证的权限)
        10000,                                      //发行数量   
        "",                                         //ABI编码的附加参数(暂时可以为空)
        "测试"                                      //附加数据
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"2e983f9136793695f7106c156ee79ce3d0b8de75aca8aba1651b54ec44a2a704",
        "blockLimit":15636211
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=2e983f9136793695f7106c156ee79ce3d0b8de75aca8aba1651b54ec44a2a704

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x2e983f9136793695f7106c156ee79ce3d0b8de75aca8aba1651b54ec44a2a704",
        "blockNumber": 15636203,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0x3a8596082aa28fbe564535b07ec3a1e7e58058e3d07edc325a6a6a0458ece549",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "amount": 10000,
                    "data": "测试",
                    "tokenSymbol": "ceshi",
                    "partitionId": "fp00000001",  //分片id
                    "extraParams": "",
                    "holder": "63c6b41745db9a046c78f3719bc2d2421d861cc6",
                    "issuer": "63c6b41745db9a046c78f3719bc2d2421d861cc6"
                },
                "topics": [
                    "IssueToken"
                ]
            }
        ]
    }
}

交易凭证

  • 转移(默认分片的)凭证

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi02",
    "bizId":"1608281844543",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"transferToken",
    "params":[
        "63c6b41745db9a046c78f3719bc2d2421d861cc6", //发起者的Identity合约(凭证持有者身份合约地址(卖方))
        "ceshi",                                    //凭证项目标识
        "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da", //转入方的Identity合约(买方)
        10000,                                      //交易数量
        "",                                         //ABI编码的附加参数
        "测试交易"                                  // 附加数据
    ] 
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"688aa480a698d132552b80ae77066c276db08ece4e858ae10fd883bc05b46f21",
        "blockLimit":15636730
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=688aa480a698d132552b80ae77066c276db08ece4e858ae10fd883bc05b46f21

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x688aa480a698d132552b80ae77066c276db08ece4e858ae10fd883bc05b46f21",
        "blockNumber": 15636722,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0x13b91ce53ee5eb74253bce52bf992e8f6ac620f229ece75722d15931fa8d50e4",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "amount": 10000,     //交易凭证数量
                    "operatorData": "",
                    "data": "测试交易", 
                    "tokenSymbol": "ceshi",
                    "partitionId": "",     //默认分片
                    "extraParams": "",
                    "from": "63c6b41745db9a046c78f3719bc2d2421d861cc6",//发起者的Identity合约(凭证持有者身份合约地址(卖方))
                    "to": "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da",  //转入方的Identity合约(买方)
                    "operator": "0000000000000000000000000000000000000000"
                },
                "topics": [
                    "TransferToken"
                ]
            }
        ]
    }
}
  • 交易指定分片的凭证

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi02",
    "bizId":"1608282359571",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"transferTokenByPartition",
    "params":[
        "63c6b41745db9a046c78f3719bc2d2421d861cc6",//发起者的Identity合约(凭证持有者身份合约地址(卖方))
        "ceshi",                                   //凭证项目标识
        "fp00000001",                              //指定分片id
        "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da",//转入方的Identity合约(买方)
        1000,   //交易数量
        "",     //ABI编码的附加参数(暂时可以为空)
        "测试"  //附加数据
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"0d8634a1eb25d30031209b734659c42e72a4d3bd53bc009c1848ab9ff18f9c27",
        "blockLimit":15636902
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=0d8634a1eb25d30031209b734659c42e72a4d3bd53bc009c1848ab9ff18f9c27

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x0d8634a1eb25d30031209b734659c42e72a4d3bd53bc009c1848ab9ff18f9c27",
        "blockNumber": 15636894,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0x5b7adbd0f0110068d5092f7313d034fdc9788a14eb880a0f3d268e16660b04de",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "amount": 1000,
                    "operatorData": "",
                    "data": "测试",
                    "tokenSymbol": "TIANKANG",
                    "partitionId": "fp00000001",
                    "extraParams": "",
                    "from": "63c6b41745db9a046c78f3719bc2d2421d861cc6",
                    "to": "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da",
                    "operator": "0000000000000000000000000000000000000000"
                },
                "topics": [
                    "TransferToken"
                ]
            }
        ]
    }
}

冻结、解冻、核销凭证

  • 冻结凭证

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi02",
    "bizId":"1608283147157",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"freezeTokenByPartition",
    "params":[
        "63c6b41745db9a046c78f3719bc2d2421d861cc6", //发起者的Identity合约
        "ceshi",                                    //凭证项目标识
        "fp00000001",                               //分片ID(默认分片id传空字符串 "")
        "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da", //持有者的Identity合约
        "ceshi00001",                               //冻结记录ID
        1000,                                       //冻结数量 
        "",                                         //ABI编码的附加参数  
        "冻结测试"                                  //附加数据
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"7c038f1a8925db91c1ff73875ee528e4c0592ed265c43f673bddfcbed0d08876",
        "blockLimit":15637164
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=7c038f1a8925db91c1ff73875ee528e4c0592ed265c43f673bddfcbed0d08876

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x7c038f1a8925db91c1ff73875ee528e4c0592ed265c43f673bddfcbed0d08876",
        "blockNumber": 15637156,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0x5eb2b9a27018072c404a652bce21683d177a65c6e7cd61c0e8ef9c0292897854",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "recordId": "ceshi00001",  //冻结记录ID
                    "amount": 1000,            //冻结数量  
                    "data": "冻结测试",//冻结数量
                    "tokenSymbol": "ceshi", //凭证项目标识
                    "partitionId": "fp00000001", //分片ID
                    "extraParams": "",//ABI编码的附加参数
                    "holder": "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da"//持有者的Identity合约
                },
                "topics": [
                    "FreezeToken"
                ]
            }
        ]
    }
}
  • 解冻凭证

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi02",
    "bizId":"1608283715221",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"unfreezeTokenByPartition",
    "params":[
        "63c6b41745db9a046c78f3719bc2d2421d861cc6",//发起者的Identity合约
        "ceshi",//凭证项目标识
        "fp00000001",//分片ID
        "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da",//持有者的Identity合约
        "ceshi00001",//冻结记录ID
        100,//冻结记录ID
        "",//冻结记录ID
        "解冻测试"//附加数据
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"a4c98b9b8963059d49ac7393eadb9818bd7db8889576c7170a3632952b25d48e",
        "blockLimit":15637354
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=a4c98b9b8963059d49ac7393eadb9818bd7db8889576c7170a3632952b25d48e

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0xa4c98b9b8963059d49ac7393eadb9818bd7db8889576c7170a3632952b25d48e",
        "blockNumber": 15637346,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0xae27a9d70b97156e63299e4864ea9cbb4ed18ce960ea15f12044bf84f7132b62",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "recordId": "ceshi00001", //冻结记录ID
                    "amount": 100,//附加数据
                    "data": "解冻测试",//附加数据
                    "tokenSymbol": "ceshi",//凭证项目标识
                    "partitionId": "fp00000001",//分片ID
                    "extraParams": "",//ABI编码的附加参数
                    "holder": "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da" //持有者的Identity合约
                },
                "topics": [
                    "UnfreezeToken"
                ]
            }
        ]
    }
}
  • 核销指定分片凭证

请求地址(POST):http://API_HOST:PORT/tx/buildAndSend.json

请求Body:

{
    "regionId":"0000000000eb7a83000000005fd3080f00000000",
    "hsmUserId":"ceshi03",
    "bizId":"1608284330437",
    "contractAddress":"948aa806c16f67ff4f312d41e6dfb80079889e4d",
    "method":"writeOffTokenByPartition",
    "blockLimit":15637559,
    "params":[
        "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da",//发起者的Identity合约
        "ceshi",//发起者的Identity合约
        "fp00000001",//发起者的Identity合约
        100,//发起者的Identity合约
        "",//ABI编码的附加参数
        "核销测试"//附加数据
    ]
}

请求返回

{
    "code":"SUCCESS",
    "detail":{
        "txHash":"1eba12f579c40871f3cbfa7d7ce31ad163048a7a1583dac53134ad275b56f766",
        "blockLimit":15637559
    }
}

根据txHash查询上链交易返回结果:

请求地址(POST):http://API_HOST:PORT/search/txHash

http://API_HOST:PORT/search/txHash?regionId=0000000000eb7a83000000005fd3080f00000000&txHash=a4c98b9b8963059d49ac7393eadb9818bd7db8889576c7170a3632952b25d48e

返回结果

{
    "code": "SUCCESS",
    "detail": {
        "transactionHash": "0x1eba12f579c40871f3cbfa7d7ce31ad163048a7a1583dac53134ad275b56f766",
        "blockNumber": 15637551,
        "regionId": "0x0000000000eb7a83000000005fd3080f00000000",
        "hash": "0x3126a49fc89efcea8f07e83c29c384bc4b20f8e39a4790ba5fac13c837a7f680",
        "contractAddress": null,
        "errorMessage": null,
        "resultCode": 0,
        "resultMsg": "运行成功",
        "logs": [
            {
                "address": "0x948aa806c16f67ff4f312d41e6dfb80079889e4d",
                "data": {
                    "amount": 100,//核销数量
                    "operatorData": "",
                    "data": "核销测试",//附加数据
                    "tokenSymbol": "ceshi",//凭证项目标识
                    "partitionId": "fp00000001",//分片ID
                    "extraParams": "",//ABI编码的附加参数
                    "holder": "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da",//持有者的Identity合约
                    "operator": "0000000000000000000000000000000000000000"
                },
                "topics": [
                    "WriteOffToken"
                ]
            }
        ]
    }
}

查询

  • 获取分片信息

请求地址(POST):http://API_HOST:PORT/search/contract

请求Body:

{
  "regionId": "0000000000eb7a83000000005fd3080f00000000",         //专区编号
  "contractAddress": "15bfd2c52fcd02dbead053fc6ce325ddaac0ab37", //凭证合约地址
  "functionName": "getPartition",//方法名
  "params": [
      "fp00000001"//分片id(默认分片传空字符串 "")
  ]
}

请求返回

{
    "code": "SUCCESS",
    "detail": {
        "issuer": "63c6b41745db9a046c78f3719bc2d2421d861cc6",//分片的发行方
        "issueTime": 1608280288,//分片的发行时间
        "totalSupply": 10000,//该分片的凭证总量
        "writtenOffAmount": 100,//该分片已核销的凭证总量
        "additionalInfo": null,//该分片已核销的凭证总量
        "cutOffTime": 0   //分片的过期时间
    }
}
  • 获取分片列表

请求地址(POST):http://API_HOST:PORT/search/contract

请求Body:

{
  "regionId": "0000000000eb7a83000000005fd3080f00000000",
  "contractAddress": "15bfd2c52fcd02dbead053fc6ce325ddaac0ab37",//凭证合约地址
  "functionName": "getPartitionsOf",
  "params": [
      "63c6b41745db9a046c78f3719bc2d2421d861cc6"//账户的Identity合约
  ]
}

请求返回

{
    "code": "SUCCESS",
    "detail": {
        "partitionIds": [
            "",
            "fp00000001"
        ]  //分片ID列表
    }
}
  • 获取余额

请求地址(POST):http://API_HOST:PORT/search/contract

请求Body:

{
  "regionId": "0000000000eb7a83000000005fd3080f00000000",
  "contractAddress": "15bfd2c52fcd02dbead053fc6ce325ddaac0ab37",//凭证合约地址
  "functionName": "getBalance",
  "params": [
      "fp00000001",                             //分片ID
      "63c6b41745db9a046c78f3719bc2d2421d861cc6"//账户的Identity合约
  ]
}

请求返回

{
    "code": "SUCCESS",
    "detail": {
        "balance": 9000 //余额
    }
}
  • 获取冻结数量

请求地址(POST):http://API_HOST:PORT/search/contract

请求Body:

{
  "regionId": "0000000000eb7a83000000005fd3080f00000000",
  "contractAddress": "15bfd2c52fcd02dbead053fc6ce325ddaac0ab37",//凭证合约地址
  "functionName": "getFrozenAmount",
  "params": [
              "fp00000001",//分片ID
             "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da"//账户的Identity合约
            ]
}

请求返回

{
    "code": "SUCCESS",
    "detail": {
        "amount": 900 //已冻结总量
    }
}
  • 获取冻结记录

请求地址(POST):http://API_HOST:PORT/search/contract

请求Body:

{
  "regionId": "0000000000eb7a83000000005fd3080f00000000",
  "contractAddress": "15bfd2c52fcd02dbead053fc6ce325ddaac0ab37",//凭证合约地址
  "functionName": "getFreezeRecords",
  "params": [
              "fp00000001",//分片ID
             "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da"//账户的Identity合约
            ]
}

请求返回

{
    "code": "SUCCESS",
    "detail": {
        "freezeRecords": [ //冻结记录列表
            {
                "recordId": "ceshi00001", //冻结记录编号
                "amount": "900"//冻结数量
            }
        ]
    }
}
  • 获取账户信息

请求地址(POST):http://API_HOST:PORT/search/contract

请求Body:

{
  "regionId": "0000000000eb7a83000000005fd3080f00000000",
  "contractAddress": "3c90b1ed94f2b42dc5958be2d52a55a26900f86c",//账户管理合约地址
  "functionName": "getAccount",
  "params": [
      "b22b78e6cbdd3880e818d9c8eacdb3bf4fc163da"//账户的Identity合约
  ]
}

请求返回

{
    "code": "SUCCESS",
    "detail": {
        "status": "1",//状态
        "roles": [  //状态
            "ADMIN"
        ],
        "subjectName": "苏州xxxx公司",//状态
        "subjectCode": "123456789123456789",//账户主体代码
        "additionalInfo": "测试"//账户主体代码
    }
}

results matching ""

    No results matching ""