[关闭]
@sqfasd 2017-05-06T03:09:41.000000Z 字数 2564 阅读 383

Pylink主链服务接口

本文档仅供前端参考使用,后端功能正在实现中

1 查询接口

1.1 查询正在申请中的资产

get /api/uia/assets/applying

  1. {
  2. "success": true,
  3. "assets": [
  4. {
  5. "name": "普洱茶", // 资产名称
  6. "currency": "PEB", // 资产符号
  7. "desc": "普洱茶简介", // 资产简介
  8. "category": "010101", // 资产分类编号
  9. "precision": 6, // 精度,表示小数点后有几位数字
  10. "estimatePrice": 10, // 初始发行价
  11. "estimateUnit": "USD", // 初始发行价单位
  12. "issuerId": "14762548536863074694", // 发行商账户地址
  13. "unlockCondition": 1, // 解锁条件
  14. "extra": "......", // 其他资产信息,json打包
  15. "approved": 0
  16. }
  17. ],
  18. "count": 9
  19. }

1.2 查询已上线的资产

get /api/uia/assets/approved

  1. {
  2. "success": true,
  3. "assets": [
  4. {
  5. "name": "普洱茶", // 资产名称
  6. "currency": "PEB", // 资产符号
  7. "desc": "普洱茶简介", // 资产简介
  8. "category": "010101", // 资产分类编号
  9. "precision": 6, // 精度,表示小数点后有几位数字
  10. "estimatePrice": 10, // 初始发行价
  11. "estimateUnit": "USD", // 初始发行价单位
  12. "issuerId": "14762548536863074694", // 发行商账户地址
  13. "unlockCondition": 1, // 解锁条件
  14. "extra": "......", // 其他资产信息,json打包
  15. "approved": 1
  16. }
  17. ],
  18. "count": 9
  19. }

1.3 查询某个资产的投票明细

get /api/uia/assets/:currency/voters

  1. {
  2. "success": true,
  3. "votes": [
  4. {
  5. "voter": "delegate1", // 投票者
  6. "weight": "500", // 投票权重
  7. }
  8. ],
  9. "count": 9
  10. }

1.4 查询一级分类

get /api/uia/categories/0

  1. {
  2. "success": true,
  3. "categories": [
  4. {
  5. "id": "01",
  6. "attrs": ["食品生鲜"],
  7. "hasChildren": true
  8. },
  9. {
  10. "id": "02",
  11. "attrs": ["服装"],
  12. "hasChildren": true
  13. }
  14. ],
  15. "count": 9
  16. }

1.5 查询指定编号分类的子分类

get /api/uia/categories/:id

  1. {
  2. "success": true,
  3. "categories": [
  4. {
  5. "id": "1001",
  6. "attrs": ["比特币"],
  7. "hasChildren": false
  8. },
  9. {
  10. "id": "1002",
  11. "attrs": ["莱特币"],
  12. "hasChildren": false
  13. 1}
  14. ],
  15. "count": 9
  16. }

attrs表示商品分类名称,可能有多种语言的翻译,第一个是中文, 第二个是英文

1.6 查询待审核的发行

get /api/uia/issues/applying

  1. {
  2. success: true,
  3. issues: [
  4. {
  5. transactionId: "431dd812d00e2c7a9242b1b0f1bbf33b80b27e4a8bf333755673ab3ac0ff9d08",
  6. currency: "PuerBank.PEB",
  7. amount: "10000000",
  8. exchangeRate: "0.2",
  9. senderId: "A7KaYaLnWhSwCzrFVeE1TcXCQUY8WHB9hR"
  10. }
  11. ],
  12. count: 1
  13. }

1.7 查询某次发行的投票

get /api/uia/issues/:id/voters

其中id为从上个接口获取的transactionId

  1. {
  2. "success": true,
  3. "votes": [
  4. {
  5. "voter": "delegate1", // 投票者
  6. "weight": "500", // 投票权重
  7. }
  8. ],
  9. "count": 9
  10. }

2 操作接口

2.1 创建账户

  1. var username = '13100933931'
  2. var password = 'fdsfds7fds9fdsaofhdjs'
  3. var account = AschJS.createAccount(username, password)

2.2 资产申请

  1. var extra = JSON.stringify({
  2. key1: value1,
  3. key2: value2
  4. })
  5. var payload = {
  6. name: '普洱茶',
  7. currency: 'issuer.PEB',
  8. desc: '资产描述',
  9. category: '010203',
  10. precision: 1,
  11. maximum: '10000000',
  12. estimateUnit: 'USD',
  13. estimatePrice: '1.5',
  14. exerciseUnit: '10',
  15. unlockCondition: 0,
  16. extra: extra
  17. }
  18. var trs = AschJS.uia.createAsset(payload, secret, secondSecret)

estimateUnit表示估值单位,需要从指定列表中选择,列表为['USD', 'RMB', 'JPY', 'EUR', 'GBP']

extra表示扩展字段,是一个json对象序列化后的字符串

unlockCondition表示资产解锁条件,需要从指定列表中选择,列表为
[
{
label: '委员会投票解锁',
value: 1
},
{
label: 'ICO合约解锁',
value: 2
}
]
其中label为下列菜单展示内容,value为传给后端的参数

2.3 资产申请投票

  1. var trs = AschJS.uia.createApproval(topic, value, secret, secondSecret)

2.4 资产发行投票

  1. var trs = AschJS.uia.createApproval(topic, value, secret, secondSecret)

对资产注册进行投票时,value为资产的currency
对某次资产发行投票时,value为资产发行transactionId

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注