注册代币 - PUT /api/(version)/tokens/(token_address)
注册一个代币。如果代币还未注册,我们需要为这个代币部署一个代币网络合约 从而实现代币的注册。
API请求
PUT /api/(version)/tokens/(token_address)
URL参数:
- version:API版本号,目前可用:v1
- token_address:代币地址
API响应
返回一个JSON对象,包含如下字段:
- token_network_address:代币网络地址
注册代币API的http响应代码可能为以下值:
- 201 Created – 指定代币的代币网络已成功创建
- 402 Payment Required – 发起账户的ETH余额不足,无法支付注册链上交易所需的gas费用
- 404 Not Found – 指定的代币地址无效
- 409 Conflict –
- 指定的代币已经注册,或者
- 注册交易失败
- 501 Not Implemented – 注册代币暂时仅在testnet可用,在主网返回此错误。
示例代码
curl请求示例:
curl -i -X PUT http://localhost:5001/api/v1/tokens/0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8
响应结果如下:
HTTP/1.1 201 CREATED
Content-Type: application/json
{
"token_network_address": "0xC4F8393fb7971E8B299bC1b302F85BfFB3a1275a"
}