Violas wallet RESTful API Web service

API调用路径

前缀： https://xxx.xxx.xxx.xxx:xxxx

完整调用路径为： 前缀 + 具体接口路径

接口调用说明

如果参数格式是 JSON ：提交request请求时必须添加header头： Content-Type:application/json
请求头参数 location 国际化参数说明：在请求头中加入 location 字段用于判断返回错误信息语言
- 英文： EN
- 中文： CN
- 繁体中文: CNT

接口说明

支付钱包

获取libra余额信息

用于获取libra钱包资产信息

Request

Method: GET
URL: /1.0/libra/balance?addr=address
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":{
        "address":"addr1",
        "balance":1
    }
}

获取libra钱包sequence number

用于获取libra钱包sequence_number

Request

Method: GET
URL: /1.0/libra/seqnum?addr=address
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":3
}

发起libra转账

发起转账交易

Request

Method: POST
URL: /1.0/libra/transaction
Headers: Content-Type:application/json
Body:
```
{
    "signedtxn":"xxxxx"
}
    
```

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取libra交易记录

Request

Method: GET
URL: /1.0/libra/transaction?addr=addr&limit=5&offset=0
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "version":1
            "address":"address",
            "value":100,
            "sequence_number":1,
            "expiration_time":1572771944,
        },
        {
            "version":2
            "address":"address",
            "value":100,
            "sequence_number":2,
            "expiration_time":1572771224,
        }
        ...
    ]
}

获取violas余额信息

用于获取violas钱包资产信息

Request

Method: GET
URL: /1.0/violas/balance?addr=address[&modu=modu1,modu2,modu3...]
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":{
        "address":"address",
        "balance":1,
        "modules":[
            {
                "address":"address",
                "balance":1
            },
            {
                "address":"address",
                "balance":1
            },
            ...
        ]
    }
}

获取violas钱包sequence number

用于获取violas钱包sequence_number

Request

Method: GET
URL: /1.0/violas/seqnum?addr=address
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":3
}

发起violas转账

发起转账交易

Request

Method: POST
URL: /1.0/violas/transaction
Headers: Content-Type:application/json
Body:
```
{
    "signedtxn":"xxxxx"
}
    
```

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取violas交易记录

根据钱包地址与module地址查询交易记录，交易类型见附录。

Request

Method: GET
URL: /1.0/violas/transaction?addr=addr&limit=5&offset=0[&modu=module_address]
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "amount": 0,
            "expiration_time": 1573718237,
            "receiver": "9db71b006cb300c1682e3a1ab375552344fa808b2acd4f53340470a5267bf082",
            "receiver_module": "",
            "sender": "9db71b006cb300c1682e3a1ab375552344fa808b2acd4f53340470a5267bf082",
            "sender_module": "05599ef248e215849cc599f563b4883fc8aff31f1e43dff1e3ebe4de1370e054",
            "sequence_number": 0,
            "type": 1,
            "version": 240,
            "gas":1000,
            "module_name":"xxxxx"
        },
        {
            "amount": 1500000,
            "expiration_time": 1573725157,
            "receiver": "9db71b006cb300c1682e3a1ab375552344fa808b2acd4f53340470a5267bf082",
            "receiver_module": "05599ef248e215849cc599f563b4883fc8aff31f1e43dff1e3ebe4de1370e054",
            "sender": "9db71b006cb300c1682e3a1ab375552344fa808b2acd4f53340470a5267bf082",
            "sender_module": "05599ef248e215849cc599f563b4883fc8aff31f1e43dff1e3ebe4de1370e054",
            "sequence_number": 2,
            "type": 2,
            "version": 272,
            "gas":1000,
            "module_name":"xxxxx"
        },
        ...
    ]
}

获取币种信息

用于获取Violas钱包币种信息

Request

Method: GET
URL: /1.0/violas/currency
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "name":"Xcoin",
            "description":"desc of Xcoin",
            "address":"xxxxxxxx"
        },
        {
            "name":"Ycoin",
            "description":"desc of Ycoin",
            "address":"xxxxxxxx"
        },
        {
            "name":"Zcoin",
            "description":"desc of Zcoin",
            "address":"xxxxxxxx"
        },
        ...
    ]
}

检测稳定币状态

查看账户下是否拥有某稳定币

Request

Method: GET
URL: /1.0/violas/module?addr=xxxxxxx
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data": [
        "xxxxxxxxxxxxxxxxxxxx",
        "cccccccccccccccccccc",
        ...
    ]
}

提交照片文件

用户提交照片文件，访问图片路径拼接： http://xxx.xxx.xxx.xxx:xxxxx/1.0/violas/photo/ + filename

Request

Method: POST
URL: /1.0/violas/photo
Headers: Content-Type:multipart/form-data;name=”photo”
Body: 图片文件路径

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取验证码

用户发送手机验证码或邮箱验证码

Request

Method: POST
URL: /1.0/violas/verify_code
Headers: Content-Type:application/json

Body:

{
    "address":"xxxxxxxxxxxxxxxxx",
    "receiver":"xxxxxxxxxx",
    "phone_local_number":"+86"
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

VBTC交易信息查询

用于查询violas链中VBTC转账交易信息

Request

Method: GET
URL: /1.0/violas/vbtc/transaction?receiver_address=xxxxxxxxxx&module_address=xxxxxxxxxxxx&start_version=1
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "version":4999,
            "sender_address":"xxxxxxxxxxxxxxxxxxxxx",
            "sequence_number":1,
            "amount":100000000,
            "btc_address":"xxxxxxxxxxxxxxxxxxxxx"
        },
        ...
    ]
}

VBTC交易信息验证

用于验证violas链中VBTC转账交易信息

Request

Method: POST
URL: /1.0/violas/vbtc/transaction
Headers: Content-Type:application/json

Body:

{
    "version":2222,
    "sender_address":"xxxxxxxxxxxxxx",
    "sequence_number":1,
    "amount":100000000,
    "btc_address":"v2b:btc_address:xxxxxxxxxxxxxxxxxxxxx",
    "moudle":"xxxxxxxxxxxxxxxxxxx",
    "receiver":"xxxxxxxxxxxxxxxxxxxxxxx"
}

Response

Body:

{
    "code":2000,                // 2009
    "message":"ok"              // "The transaction information is incorrect."
}

SSO钱包

SSO钱包注册

用户使用身份证信息注册SSO钱包

Request

Method: POST
URL: /1.0/violas/sso/user
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"wallet_address",
    "name":"name",
    "country":"country",
    "id_number":"id_number",
    "id_photo_positive_url":"id_photo_positive_url",
    "id_photo_back_url":"id_photo_back_url"
}

Response

Body:

{
    "code":2000,
    "message":"ok",
}

获取SSO钱包用户信息

获取该SSO钱包地址的注册信息

Request

Method: GET
URL: /1.0/violas/sso/user?address=xxxxxxxxxxxx
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "message": "ok",
    "data": {
        "country": "xxxxxx",
        "email_address": "xxxxxx",
        "id_number": "xxxxxxxxxxxxxxx",
        "id_photo_back_url": "xxxxxxxxxxxxxx",
        "id_photo_positive_url": "xxxxxxxxxxxxx",
        "name": "xxxxxxxxxxxxx",
        "phone_number": "xxxxxxxxxxxxxxx",
        "wallet_address": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "phone_local_number":"+86"
    }
}

申请发行稳定币

用户提交申请发行稳定币

Request

Method: POST
URL: /1.0/violas/sso/token
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"wallet_address",
    "token_type":"token_type",
    "amount":100000,
    "token_value":1,
    "token_name":"token_name",
    "reserve_photo_url":"reserve_photo_url",
    "account_info_photo_positive_url":"account_info_photo_positive_url",
    "account_info_photo_back_url":"account_info_photo_back_url",
    "phone_verify_code":111111,
    "email_verify_code":111111,
    "governor_address":"governor_address"
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

查询审批状态

查询用户申请发行稳定币的审批状态

Request

Method: GET
URL: /1.0/violas/sso/token?address=xxxxxxxxxxxxx
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":{
        "amount":10000000,
        "token_name":"token_name",
        "approval_status": 0,    // 0: 未审批; 1: 审批通过; 2: 审批失败; 3: 已Publish; 4: 铸币成功
        "module_address":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
}

更改Publish状态

审批成功后用户申请铸币时更改Publish状态

Request

Method: PUT
URL: /1.0/violas/sso/token
Headers: Content-Type:application/json
Body:
```
{
    "address":"address"
}
    
```

Response

Body:

{
    "code":2000,
    "message":"ok"
}

绑定信息

绑定用户手机号或邮箱

Request

Method: POST
URL: /1.0/violas/sso/bind
Headers: Content-Type:application/json

Body:

{
    "address":"xxxxxxxxxx",
    "receiver":"xxxxxxxxxx",
    "code":222222,
    "phone_local_number":"+86"
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取未审批SSO信息

州长钱包获取待审批的SSO信息

Request

Method: GET
URL: /1.0/violas/sso/token/approval?address=xxxxxxxxxxxxxxxx&offset=0&limit=10
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "wallet_address":"xxxxxxxxxxxxxx",
            "name":"xxxxx",
            "country":"xxx",
            "id_number":"xxxxxxxxxxx",
            "phone_local_number":"+xx",
            "phone_number":"xxxxxxxxxxxxxx",
            "email_address":"xxxxxxxxxxxx",
            "id_photo_positive_url":"xxxxxxxxxxxxxxx",
            "id_photo_back_url":"xxxxxxxxxxxxxxx",
            "token_type":"xxxxx",
            "amount":100000000,
            "token_value":10,
            "token_name":"xxxxxx",
            "application_date":12323324234,
            "validity_period":5,
            "expiration_date":12312415412,
            "reserve_photo_url":"xxxxxxxxxxxxxxxx",
            "account_info_photo_positive_url":"xxxxxxxxxxxxxxxx",
            "account_info_photo_back_url":"xxxxxxxxxxxxxxxxx",
            "approval_status":0 // 0: 未审批; 1: 审批通过; 2: 审批失败; 3: 已Publish; 4: 铸币成功
        },
        ...
    ]
}

获取未审批SSO信息2.0

州长钱包获取待审批的SSO信息列表

Request

Method: GET
URL: /1.1/violas/sso/token/approval?address=xxxxxxxxxxxxxxxx&offset=0&limit=10
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "id":1,
            "name":"xxxxx",
            "application_date":12323324234,
            "approval_status":0, // 0: 未审批; 1: 审批通过; 2: 审批失败; 3: 已Publish; 4: 铸币成功
            "expiration_date":12323324234
        },
        ...
    ]
}

获取未审批SSO详细信息

州长钱包获取待审批的SSO详细信息

Request

Method: GET
URL: /1.0/violas/sso/token/approval/<id>
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "id":1,
            "wallet_address":"xxxxxxxxxxxxxx",
            "name":"xxxxx",
            "country":"xxx",
            "id_number":"xxxxxxxxxxx",
            "phone_local_number":"+xx",
            "phone_number":"xxxxxxxxxxxxxx",
            "email_address":"xxxxxxxxxxxx",
            "token_type":"xxxxx",
            "amount":100000000,
            "token_value":10,
            "token_name":"xxxxxx",
            "application_date":12323324234,
            "validity_period":5,
            "expiration_date":12312415412,
            "reserve_photo_url":"xxxxxxxxxxxxxxxx",
            "account_info_photo_positive_url":"xxxxxxxxxxxxxxxx",
            "account_info_photo_back_url":"xxxxxxxxxxxxxxxxx",
            "approval_status":0, // 0: 未审批; 1: 审批通过; 2: 审批失败; 3: 已Publish; 4: 铸币成功
            "subaccount_number":1,
            "module_address":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        },
        ...
    ]
}

提交SSO审批结果

州长钱包提交Token审核结果与module地址

Request

Method: PUT
URL: /1.0/violas/sso/token/approval
Headers: Content-Type:application/json

Body:

{
    "approval_status":1,        // 审核结果，1：通过；2：未通过
    "module_address":"xxxxxxxxxxxxxxxxxxxx",
    "wallet_address":"xxxxxxxxxxxxxxxxxxxx"
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

提交SSO审批结果2.0

州长钱包提交Token审核结果与module地址2.0版本

Request

Method: PUT
URL: /1.1/violas/sso/token/approval
Headers: Content-Type:application/json

Body:

{
    "approval_status":1,        // 审核结果，1：通过；2：未通过
    "module_address":"xxxxxxxxxxxxxxxxxxxx",
    "wallet_address":"xxxxxxxxxxxxxxxxxxxx",
    "subaccount_number":1
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

设置token铸币状态

州长钱包向sso token地址转账后设置状态为已铸币

Request

Method: PUT
URL: /1.0/violas/sso/token/minted
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"xxxxxxxxxxxxxxxxxx"
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取州长列表

获取可以委托发行的州长列表

Request

Method: GET
URL: /1.0/violas/sso/governors
Headers: None
Bode: None

Response

Body:

{
    "code": 2000,
    "data": [
        {
            "name": "governor_new",
            "wallet_address": "6468ec05fe60656961b6dba24031ea6c553ba60e04b9fd2b9bbb514b6bbd9e25"
        },
        ...
    ],
    "message": "ok"
}

州长钱包

州长注册

提交州长信息进行注册

Request

Method: POST
URL: /1.0/violas/governor
Headers: Content-Type:application/json

Body:

{
    "toxid":"xxx",            // 进行tox通信所使用的toxid
    "name":"xxx",             // 州长或懂事长自己起的名字
    "public_key":"xxx",           // BTC的公钥
    "wallet_address":"xxx",       // 平台币地址
    "is_chairman":0,       // 是否是董事长: 0 不是, 1 是
    "multisig_address":"xxx",     // 多签地址
    "vstake_address":"xxx",       // vstake地址
    "subaccount_count":0          // 子账户个数
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

SSO钱包端州长注册

SSO钱包端州长注册接口

Request

Method: POST
URL: /1.0/violas/governor/sso
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"address",
    "name":"name",
    "txid":"txid"
}

Response

Body:

{
    "code": 2000,
    "message": "ok"
}

州长注册2.0

州长注册接口2.0

Request

Method: POST
URL: /1.1/violas/governor
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"address", // 必填
    "name":"name",              // 必填
    "txid":"txid",              // 必填
    "toxid":"toxid"             // 选填
}

Response

Body:

{
    "code": 2000,
    "message": "ok"
}

修改州长信息

Request

Method: PUT
URL: /1.0/violas/governor
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"xxx",       // 必填，平台币地址
    "toxid":"xxx",            // 选填，进行tox通信所使用的toxid
    "name":"xxx",             // 选填，州长或懂事长自己起的名字
    "public_key":"xxx",           // 选填，BTC的公钥
    "multisig_address":"xxx",     // 选填，多签地址
    "vstake_address":"xxx",       // 选填，vstake地址
    "subaccount_count":0          // 选填，子账户个数
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取州长信息列表

获取所有州长信息

Request

Method: GET
URL: /1.0/violas/governor?offset=0&limit=10
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "toxid":"xxx",            // 进行tox通信所使用的toxid
            "name":"xxx",             // 州长或懂事长自己起的名字
            "public_key":"xxx",           // BTC的公钥
            "wallet_address":"xxx",       // 平台币地址
            "multisig_address":"xxx",     // 多签地址
            "vstake_address":"xxx",       // vstake地址
            "is_chairman":0,               // 是否是董事长，0：否；1：是
            "subaccount_count":0          // 子账户个数
        },
        ...
    ]
}

获取州长信息

使用钱包地址获取某州长信息

Request

Method: GET
URL: /1.0/violas/governor/<wallet_address>
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":{
        "toxid":"xxx",            // 进行tox通信所使用的toxid
        "name":"xxx",             // 州长或懂事长自己起的名字
        "public_key":"xxx",           // BTC的公钥
        "wallet_address":"xxx",       // 平台币地址
        "multisig_address":"xxx",     // 多签地址
        "vstake_address":"xxx",       // vstake地址
        "is_chairman":0,               // 是否是董事长，0：否；1：是
        "subaccount_count":0,          // 子账户个数
        "status":0                     // 0: not approved; 1: pass; 2: not pass; 3: published; 4: minted
    }
}

增加投资信息

提交州长向董事长转账100BTC的转账信息

Request

Method: POST
URL: /1.0/violas/governor/investment
Headers: Content-Type:application/json
Body:

{
    "wallet_address":"xxx",       // 平台币地址
    "btc_txid":"xxxxxxxxxxxxxx"   // BTC转账交易id
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取投资信息

董事长获取未处理的州长BTC转账信息

Request

Method: GET
URL: /1.0/violas/governor/investment
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "wallet_address":"xxxxxxxxxxxx",
            "name":"xxxxxxx",
            "toxid":"xxxxxxxx",
            "vstake_address":"xxxxxxxxxxxxx",
            "btc_txid":"xxxxxxxxxxxxxxxxxxxx",
            "public_key":"xxxxxxxxxxxxxxxx",
            "multisig_address":"xxxxxxxxxxxxxxxxxx",
            "is_handle":0,
            "application_date":123445678
        }
    ]
}

修改处理状态

董事长修改投资信息处理状态

Request

Method: PUT
URL: /1.0/violas/governor/investment
Headers: Content-Type:application/json

Body:

{
    "wallet_address":"xxxxxxxxxxxxxxx",
    "is_handle":0               // 0: 未审批; 1: 审批通过; 2: 审批失败; 3: 已Publish; 4: 铸币成功
}

Response

Body:

{
    "code":2000,
    "message":"ok"
}

获取交易记录

获取州长相关的交易记录

Request

Method: GET
URL: /1.0/violas/governor/transactions?address=xxxxxxxxxxxxxxxxxxxxxxxxx&limit=10&start_version=0
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "amount": 10000000,
            "data": null,
            "event_root_hash": "6d80965022ce1b4129e404a0f5134811e8d0a56685fa092936684d3a43873824",
            "expiration_time": 1576131136,
            "gas_unit_price": 0,
            "gas_used": 0,
            "max_gas_amount": 140000,
            "module_address": "0000000000000000000000000000000000000000000000000000000000000000",
            "public_key": "938d431a4bf9ccefedb3808bd6544867634c7ee65a6b46e26a094058672312fe",
            "receiver": "88c755d110d0b50fb6a48c81d8cddb573623c9b3d9279ef6c22eb7115d547678",
            "sender": "000000000000000000000000000000000000000000000000000000000a550c18",
            "sequence_number": 1068,
            "signature": "d227ef45f2db800f8ce23569b174cc7b3c1085af13ee832d57ac558fed1e98645026cd7f41048c3e986fee5d96528f82209d77f086b334a38de8bf67a52ba80d",
            "state_root_hash": "6a54c9fc8142a66ef08c99a7c0ae89d8c6ae0a6db8843bd8086c0579e4beddb3",
            "status": 4001,
            "transaction_hash": "cf780b53964f5dfa22a5861035dc20666daede13587b35a0177c6304c8286c11",
            "transaction_type": "mint",
            "version": 67092
        },
        ...
    ]
}

获取Vstake module address

获取Vstake module address用来接收vstake

Request

Method: GET
URL: /1.0/violas/governor/vstake/address
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "address": "module address"
    },
    "message": "ok"
}

检查州长发币权限

检查州长是否有发币的权限

Request

Method: GET
URL: /1.0/violas/governor/authority?address=address&module=module
Headers: None
Body: None

response

Body:

{
    "code": 2000,
    "data": {
        "authority":0           // 0: False, 1: True
    },
    "message": "ok"
}

Libra浏览器

获取最新交易

用于获取libra钱包资产信息

Request

Method: GET
URL: /explorer/libra/recent?limit=10&offset=0
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "amount": 100,
            "expiration_time": 1576752010,
            "gas": 0,
            "receiver": "4ce68dd6e81b400a4edf4146307b10e5030a372414fd49b1accecc0767753070",
            "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
            "status": 4001,
            "type": "xxxxx",
            "version": 6620
        },
        {
            "amount": 100,
            "expiration_time": 1576752010,
            "gas": 0,
            "receiver": "4ce68dd6e81b400a4edf4146307b10e5030a372414fd49b1accecc0767753070",
            "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
            "status": 4001,
            "type": "xxxxxx",
            "version": 6621
        },
        ...
    ]
}

获取交易信息

获取某特定Version交易的信息

Request

Method: GET
URL: /explorer/libra/version/<version>
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":{
        "amount": 400,
        "expiration_time": 1576137933,
        "gas_unit_price": 0,
        "max_gas_amount": 140000,
        "public_key": "43ae94bcf18b60848105373e47794ccd018c8ecdd363d4aa1c1ade20463d8719",
        "receiver": "2629bbd938e5680cf04b57b2624ca90993d5616f454432f897d1abac43ec26f6",
        "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
        "sequence_number": 635,
        "signature": "48670acc2eabb0131ca0b082f8364baf10bbd4ba1d61e062ca696e46b6b8a247c12caedbc9cdb56edb68a059ec44de9d226801f51b286b94d2ca96ba62c8e304",
        "status": 4001,
        "version": 67594,
        "type":"xxxxxxxxx"
    }
}

获取地址信息

获取某特定address的信息

Request

Method: GET
URL: /explorer/libra/address/<address>?offset=0&limit=10
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "status": {
            "balance": 1002100000000,
            "first_seen": 4058,
            "received_amount": 203019500123,
            "received_failed_tx_count": 25,
            "received_minted_tx_count": 1,
            "received_tx_count": 562,
            "sent_amount": 26000000,
            "sent_failed_tx_count": 26,
            "sent_minted_tx_count": 0,
            "sent_tx_count": 431,
            "type": 1
        },
        "transactions": [
            {
                "amount": 1000000,
                "expiration_time": 1578476995,
                "gas": 0,
                "module_address": "b9e3266ca9f28103ca7c9bb9e5eb6d0d8c1a9d774a11b384798a3c4784d5411e",
                "receiver": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
                "sender": "9db71b006cb300c1682e3a1ab375552344fa808b2acd4f53340470a5267bf082",
                "status": 4001,
                "type": "violas_peer_to_peer_transfer_with_data",
                "version": 708979
            },
            ...
        ]
    },
    "message": "ok"
}

Violas浏览器

获取最新交易

用于获取Violas最新的交易信息

Request

Method: GET
URL: /explorer/violas/recent?limit=10&offset=0
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "amount": 100,
            "expiration_time": 1576752010,
            "gas": 0,
            "module_address": "0000000000000000000000000000000000000000000000000000000000000000",
            "receiver": "4ce68dd6e81b400a4edf4146307b10e5030a372414fd49b1accecc0767753070",
            "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
            "status": 4001,
            "type": "xxxxx",
            "version": 6620
        },
        {
            "amount": 100,
            "expiration_time": 1576752010,
            "gas": 0,
            "module_address": "b9e3266ca9f28103ca7c9bb9e5eb6d0d8c1a9d774a11b384798a3c4784d5411e",
            "receiver": "4ce68dd6e81b400a4edf4146307b10e5030a372414fd49b1accecc0767753070",
            "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
            "status": 4001,
            "type": "xxxxxx",
            "version": 6621
        },
        ...
    ]
}

获取某稳定币的最新交易

用于获取Violas中某个稳定币最新的交易信息

Request

Method: GET
URL: /explorer/violas/recent/<module_address>?limit=10&offset=0
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":[
        {
            "amount": 100,
            "expiration_time": 1576752010,
            "gas": 0,
            "module_address": "b9e3266ca9f28103ca7c9bb9e5eb6d0d8c1a9d774a11b384798a3c4784d5411e",
            "receiver": "4ce68dd6e81b400a4edf4146307b10e5030a372414fd49b1accecc0767753070",
            "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
            "status": 4001,
            "type": "xxxxxx",
            "version": 6621
        },
        ...
    ]
}

获取交易信息

获取某特定Version交易的信息

Request

Method: GET
URL: /explorer/violas/version/<version>
Headers: None
Body: None

Response

Body:

{
    "code":2000,
    "message":"ok",
    "data":{
        "amount": 400,
        "data": "{\"type\": \"fb_ex\", \"ver\": 28860, \"fee\": 0, \"state\": 1}",
        "expiration_time": 1576137933,
        "gas_unit_price": 0,
        "max_gas_amount": 140000,
        "module_address": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
        "public_key": "43ae94bcf18b60848105373e47794ccd018c8ecdd363d4aa1c1ade20463d8719",
        "receiver": "2629bbd938e5680cf04b57b2624ca90993d5616f454432f897d1abac43ec26f6",
        "sender": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
        "sequence_number": 635,
        "signature": "48670acc2eabb0131ca0b082f8364baf10bbd4ba1d61e062ca696e46b6b8a247c12caedbc9cdb56edb68a059ec44de9d226801f51b286b94d2ca96ba62c8e304",
        "status": 4001,
        "version": 67594,
        "type":"xxxxxxxxx"
    }
}

获取地址信息

获取某特定address的信息

Request

Method: GET
URL: /explorer/violas/address/<address>?module=xxxxxxx&offset=0&limit=10
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "status": {
            "balance": 1002100000000,
            "first_seen": 4058,
            "module_balande": [
                {
                    "balance": 1000000,
                    "module": "15d3e4bea615b78c3782553df712a4f86d85280f11939e0b35756422575fc622"
                },
                ...
            ],
            "received_amount": 203019500123,
            "received_failed_tx_count": 25,
            "received_minted_tx_count": 1,
            "received_tx_count": 562,
            "sent_amount": 26000000,
            "sent_failed_tx_count": 26,
            "sent_minted_tx_count": 0,
            "sent_tx_count": 431,
            "type": 1
        },
        "transactions": [
            {
                "amount": 1000000,
                "expiration_time": 1578476995,
                "gas": 0,
                "module_address": "b9e3266ca9f28103ca7c9bb9e5eb6d0d8c1a9d774a11b384798a3c4784d5411e",
                "receiver": "07e92f79c67fdd6b80ed9103636a49511363de8c873bc709966fffb2e3fcd095",
                "sender": "9db71b006cb300c1682e3a1ab375552344fa808b2acd4f53340470a5267bf082",
                "status": 4001,
                "type": "violas_peer_to_peer_transfer_with_data",
                "version": 708979
            },
            ...
        ]
    },
    "message": "ok"
}

跨链映射相关接口

获取转账地址

获取跨链交易转账地址，type类型为：btc，vbtc，libra，vlibra

Request

Method: GET
URL: /1.0/crosschain/address?type=btc
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": "fd0426fa9a3ba4fae760d0f614591c61bb53232a3b1138d5078efa11ef07c49c",
    "message": "ok"
}

获取转账module地址

获取跨链交易转账Module地址，type类型为：vbtc，vlibra

Request

Method: GET
URL: /1.0/crosschain/module?type=vbtc
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": "61b578c0ebaad3852ea5e023fb0f59af61de1a5faf02b1211af0424ee5bbc410",
    "message": "ok"
}

获取跨链兑换汇率

获取跨链交易兑换汇率，type类型为：btc，vbtc，libra，vlibra

Request

Method: GET
URL: /1.0/crosschain/rate?type=btc
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "exchange_name": "btc",
        "exchange_rate": 1
    },
    "message": "ok"
}

获取跨链兑换交易数量

获取当前账户的跨链交易次数

Request

Method: GET
URL: /1.0/crosschain/transactions/count?address=address&type=btc
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": 10,
    "message": "ok"
}

查询跨链module publish状态

查询当前账户是否已对某module进行publish

Request

Method: GET
URL: /1.0/crosschain/module/status?address=address&module=module
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": 1,                  // 0:未publish，1:已publish
    "message": "ok"
}

查询跨链交易币种信息

查询跨链交易币种信息，type类型为：btc，vbtc，libra，vlibra

Request

Method: GET
URL: /1.0/crosschain/info?type=vbtc
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "address": "29223f25fe4b74d75ca87527aed560b2826f5da9382e2fb83f9ab740ac40b8f7",
        "module": "61b578c0ebaad3852ea5e023fb0f59af61de1a5faf02b1211af0424ee5bbc410",
        "name": "vlibra",
        "rate": 1
    },
    "message": "ok"
}

获取兑换交易记录

获取映射币兑换交易记录，钱包类型type参数为：0（violas)，1（libra），2（btc）

Request

Method: GET
URL: /1.0/crosschain/transactions?address=address&type=0&offset=0&limit=10
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "offset":10,            // 下次调用是需要将当前值传回去
        "infos":[
            {
                "date": 1285820202,
                "amount": 1000,
                "address": xxxxxxxxxxxxxxxxxxxxx,
                "coin": "vlibra"
                "status": 0             // 0：兑换中，1：成功，2：失败
            },
            {
                "address": "2MxBZG7295wfsXaUj69quf8vucFzwG35UWh",
                "amount": 1001,
                "coin": "btc",
                "date": 0,
                "status": 0
            }
        ]
    },
    "message": "ok"
}

转发BTC上链交易

转发BTC上链交易到比特大陆接口

Request

Method: POST
URL: /1.0/crosschain/transactions/btc
Headers: Content-Type:application/json
Body:
```
{
    "rawhex":"xxxxxx"
}
    
```

Response

Body:

{
    "code": 2000,
    "message": "ok"
}

获取已映射稳定币信息

获取当前钱包已映射稳定币的信息

Request

Method: GET
URL: /1.0/crosschain/modules?address=address
Headers: None
Body: None

Response

Body:

{
    "code": 2000,
    "data": {
        "name": "btc",
        "address": "xxxxxxxxxxxxxxxxxxxxx",
        "module": "xxxxxxxxxxxxxxxxxxxx",
        "map_name":"vbtc",
        "rate": 1
    },
    "message": "ok"
}

附录：

交易类型

类型	交易名称
0	write_set
1	mint
2	peer_to_peer_transfer
3	create_account
4	rotate_authentication_key
5	violas_withdrawal
6	violas_order
7	violas_mint
8	violas_owner_init
9	violas_init
10	violas_pick
11	violas_module
12	violas_peer_to_peer_transfer
13	violas_peer_to_peer_transfer_with_data
14	add_validator
15	block_prologue
16	peer_to_peer_transfer_with_metadata
17	placeholder_script
18	register_validator
19	remove_validator
20	rotate_consensus_pubkey
21	make_owner_order
22	cancel_owner_order
23	take_owner_order
24	owner_bulletin
25	owner_update_first_bulletin
26	record
27	mint_with_data
28	block_metadata
29	unknown

Name		Name	Last commit message	Last commit date
Latest commit History 676 Commits
test		test
.gitignore		.gitignore
BankAPI.py		BankAPI.py
BtcAPI.py		BtcAPI.py
ChairmanWalletAPI.py		ChairmanWalletAPI.py
CreateTable.py		CreateTable.py
CrossChainAPI.py		CrossChainAPI.py
CrossChainHandler.py		CrossChainHandler.py
CrossChainWalletApi.py		CrossChainWalletApi.py
Deploy.sh		Deploy.sh
Dockerfile		Dockerfile
ErrorCode.py		ErrorCode.py
GovernorWalletAPI.py		GovernorWalletAPI.py
IncentiveMining.py		IncentiveMining.py
LICENSE		LICENSE
LibraExplorerAPI.py		LibraExplorerAPI.py
LibraModules.py		LibraModules.py
LibraPGHandler.py		LibraPGHandler.py
LibraWalletAPI.py		LibraWalletAPI.py
MarketAPI.py		MarketAPI.py
PushServerHandler.py		PushServerHandler.py
README.org		README.org
SSOWalletAPI.py		SSOWalletAPI.py
SocketHandler.py		SocketHandler.py
TransferType.py		TransferType.py
Update.sh		Update.sh
VBtcAPI.py		VBtcAPI.py
ViolasExplorerAPI.py		ViolasExplorerAPI.py
ViolasModules.py		ViolasModules.py
ViolasPGHandler.py		ViolasPGHandler.py
ViolasWalletAPI.py		ViolasWalletAPI.py
ViolasWebservice.py		ViolasWebservice.py
backend.mne		backend.mne
common.py		common.py
config.ini		config.ini
debug.sh		debug.sh
index.py		index.py
redis-init-script.txt		redis-init-script.txt
requirements.txt		requirements.txt
util.py		util.py
violas_wallet.conf		violas_wallet.conf

License

palliums-developers/violas-webservice

Folders and files

Latest commit

History

Repository files navigation

Violas wallet RESTful API Web service

API调用路径

接口调用说明

接口说明

支付钱包

获取libra余额信息

Request

Response

获取libra钱包sequence number

Request

Response

发起libra转账

Request

Response

获取libra交易记录

Request

Response

获取violas余额信息

Request

Response

获取violas钱包sequence number

Request

Response

发起violas转账

Request

Response

获取violas交易记录

Request

Response

获取币种信息

Request

Response

检测稳定币状态

Request

Response

提交照片文件

Request

Response

获取验证码

Request

Response

VBTC交易信息查询

Request

Response

VBTC交易信息验证

Request

Response

SSO钱包

SSO钱包注册

Request

Response

获取SSO钱包用户信息

Request

Response

申请发行稳定币

Request

Response