开启通道 - PUT /api/(version)/channels

开启/创建新通道。

API请求

PUT /api/(version)/channels

URL参数：

• version：API版本号，目前可用：v1

BODY参数对象，包含如下字段

• partner_address：对手方地址
• token_address：代币地址
• total_deposit：存入总额
• settle_timeout：结算超时参数

API响应

返回通道对象，包含如下字段：

• token_network_identifier：代币网络标识符
• channel_identifier：通道标识符
• partner_address：对手方地址
• token_address：代币地址
• balance：余额
• total_deposit：存入总额
• state：状态
• settle_timeout：结算超时块数
• reveal_timeout：揭示超时块数

http响应的状态码可能为以下值：

• 201 Created – 通道创建成功
• 400 Bad Request – 请求JSON数据格式不正确
• 402 Payment Required – 发起地址ETH余额不足
• 408 Request Timeout – 以太坊节点未及时获取存入事件，超时
• 409 Conflict – 无效的输入，例如，结算超时参数太低
• 500 Internal Server Error – Raiden节点内部错误

示例代码

curl请求示例：

curl -i -X PUT http://localhost:5001/api/v1/channels -H 'Content-Type: application/json' --data-raw '{
  "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9", 
  "settle_timeout": 500, 
  "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8", 
  "total_deposit": 35000000
}'

响应结果如下：

HTTP/1.1 201 CREATED
Content-Type: application/json

{
    "token_network_identifier": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
    "channel_identifier": 20,
    "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
    "balance": 25000000,
    "total_deposit": 35000000,
    "state": "opened",
    "settle_timeout": 500,
    "reveal_timeout": 30
}