menu

可信积分相关动作

更新时间: 2019-12-24 18:10:38 · 编辑者:宇链科技

创建可信积分

可信积分是一种创新的链上同质化通证,所有发行和流转都在链上,但安全可控且并非数字货币,广泛适用于积分卡、优惠券、储值卡、异业联盟、征信、扶贫等。

上链类型

批量上链接口中使用下列名字代表本上链类型。

fungible-token-symbol-register

上链参数

对应的 args 对象所含属性如下:

{
    "id": "xintoken3",                                             // 通证 ID,请牢记,在一个 appId 内不能重复
    "name": "GOLD",                                                // 通证名称,只能由大小写字母、数字或点(.)和 (-) 组成,建议 3 - 12 个字符(不超过 21 个字符)
    "fullName": "GOLD.COIN",                                       // 通证完整名称,只能由大小写字母、数字或点(.)和 (-) 组成,建议 6 - 21 个字符(不超过 21 个字符)
    "totalSupply": "100000000",                                    // 通证最大发行量,由于不可篡改,请预留未来一百年的需求 (*^_^*)
    "precision": 4,                                                // 精度,就是小数点后最多有几位,必须在 0 - 8 位之间
    "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAJUAAAC........II="  // 图标,png 格式,为了性能图片最好保持在 10 KB 以下,必须符合 DATAURL 规范(RFC2397),网上有很多介绍和工具
}

其中,有关 RFC2397 的说明可以参考 RFC2397

注意:当你创建完可信积分后,可以通过 fetchOnChainIds 接口获得链上的符号(symbol id),然后可以在区块链浏览器上查询。

发行可信积分

当你创建了可信积分后,可以发行一部分或全部通证到指定的用户账号。每个用户账号用一个 userId 表示,在整个宇链云接口中是通用的,每个 appId 相互隔离。

上链类型

批量上链接口中使用下列名字代表本上链类型。

fungible-token-issue

上链参数

对应的 args 对象所含属性如下:

{
    "id": "issue002",             // 代表本次操作的唯一 id,不能在同一 appId 范围内重复
    "tokenAppId": "AzE5",         // 创建该可信积分的 AppId 
    "tokenId": "xintoken3",       // 该可信积分的 Id (即上方“创建可信积分”接口中的 id 字段)
    "userId": "user0",            // 要发放积分/通证的用户 id,同一 appId 内不能重复
    "amount": "1",                // 数量,要注意小数点不能超过精度
    "memo": "test"                // 可选,发行备注,不超过 255 个字符
}

转账可信积分

当你发行了可信积分后,可以进行转账。每个用户账号用一个 userId 表示,在整个宇链云接口中是通用的,每个 appId 相互隔离。

系统支持跨 AppID 进行转账。

上链类型

批量上链接口中使用下列名字代表本上链类型。

fungible-token-transfer

上链参数

对应的 args 对象所含属性如下:

{ 
    "id": "transfer",              // 代表本次操作的唯一 id,不能在同一 appId 范围内重复
    "tokenAppId": "AzE5",          // 创建该可信积分的 AppId 
    "tokenId": "xintoken3",        // 该可信积分的 Id (即上方“创建可信积分”接口中的 id 字段),在 `tokenAppId` 中唯一
    "fromUserId": "user0",         // 从哪个用户转账
    "toUserAppId": "AzE5",         // 转到哪个 appId
    "toUserId": "user1",           // 转到 `toUserAppId` 这个 app 下的哪个用户
    "amount": "0.01",              // 数量,要注意小数点不能超过精度
    "memo": "test"                 // 可选,转账备注
}