Channels

The channels endpoints allow you to open channels with other Raiden nodes as well as closing channels, querying them for information and making deposits or withdrawals.

Channels Resource Overview

HTTP Method	Resource	Description
GET	/api/<version>/channels	All unsettled channels
GET	/api/<version>/channels/<token_address>	All unsettled channels for a specific token
GET	/api/<version>/channels/<token_address>/<partner_address>	Info about one of your channels
PUT	/api/<version>/channels	Create a channel
PATCH	/api/<version>/channels/<token_address>/<partner_address>	Close a channel, increase deposit, withdraw tokens or update reveal timeout

Alderaan Deposit Limits

The maximum deposits per token and node for Alderaan are:

• DAI

  The deposit limit is 1000 worth of DAI per channel participant making the maximum amount of DAI 2000 per channel.

• WETH

  Details on the deposit limit for WETH will be added soon.

Channels Resource Details

All Unsettled Channels

GET http://localhost:5001/api/v1/channels

Path Parameters

Name	Type	Description
version	string	Version of the API

200 Successful query

[
    {
        "token_network_address": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
        "channel_identifier": "20",
        "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
        "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
        "balance": "25000000",
        "total_deposit": "35000000",
        "total_withdraw": "5000000",
        "state": "opened",
        "settle_timeout": "100",
        "reveal_timeout": "30"
    }
]

500

All Unsettled Channels for a Specific Token

GET http://localhost:5001/api/v1/channels/0xEA67...8ec8

Path Parameters

Name	Type	Description
version	string	Version of the API
token_address	string	Address of a token

200 Successfull query

[
    {
        "token_network_address": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
        "channel_identifier": "20",
        "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
        "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
        "balance": "25000000",
        "total_deposit": "35000000",
        "total_withdraw": "5000000",
        "state": "opened",
        "settle_timeout": "100",
        "reveal_timeout": "30"
    }
]

404

500

Info About One of Your Channels

GET http://localhost:5001/api/v1/channels/0xEA67...8ec8/0x61C8...0bD9

The channel is specified by the address of a token and the address of the partner node which the channel is opened with.

Path Parameters

Name	Type	Description
version	string	Version of the API
token_address	string	Address of a token
partner_address	string	Address of the partner node

200 Successful query

{
    "token_network_address": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
    "channel_identifier": "20",
    "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
    "balance": "25000000",
    "total_deposit": "35000000",
    "total_withdraw": "5000000",
    "state": "opened",
    "settle_timeout": "100",
    "reveal_timeout": "30"
}

404

500

Create a Channel

PUT http://localhost:5001/api/v1/channels

The request will open a channel and return a channel object.

Path Parameters

Name	Type	Description
version	string	Version of the API

Request Body

Name	Type	Description
reveal_timeout	string	Value for the reveal timeout
partner_address	string	Address of the partner node with whom we're opening the channel
token_address	string	Address of the token to be used in the channel
total_deposit	string	Amount of tokens to be deposited into the channel
settle_timeout	string	The number of blocks after which a channel can be settled

201 Channel successfully created

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

400

402

409

500

Example request body:

{
    "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
    "total_deposit": "35000000",
    "settle_timeout": "500",
    "reveal_timeout": "50"
}

Close a Channel

PATCH http://localhost:5001/api/v1/channels/0xEA67...8ec8/0x61C8...0bD9

Path Parameters

Name	Type	Description
version	string	Version of the API
token_address	string	Address of a token
partner_address	string	Address of the partner node

Request Body

Name	Type	Description
state	string	Can only be set to "closed"

200 Successfully closed channel

{
    "token_network_address": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
    "channel_identifier": "20",
    "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
    "balance": "25000000",
    "total_deposit": "35000000",
    "total_withdraw": "5000000",
    "state": "closed",
    "settle_timeout": "500",
    "reveal_timeout": "30"
}

400

402

404

409

500

Example request body:

{
    "state": "closed"
}

Increase Deposit

PATCH http://localhost:5001/api/v1/channels/0xEA67...8ec8/0x61C8...0bD9

Path Parameters

Name	Type	Description
version	string	Version of the API
token_address	string	Address of a token
partner_address	string	Address of the partner node

Request Body

Name	Type	Description
total_deposit	string	Amount of tokens for increasing the total deposit

200 Successfully increased the deposit

{
    "token_network_address": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
    "channel_identifier": "20",
    "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
    "balance": "25000000",
    "total_deposit": "35000000",
    "total_withdraw": "5000000",
    "state": "closed",
    "settle_timeout": "500",
    "reveal_timeout": "30"
}

400

402

404

408

409

500

Example request body:

{
    "total_deposit": "100"
}

Withdraw Tokens

PATCH http://localhost:5001/api/v1/channels/0xEA67...8ec8/0x61C8...0bD9

Path Parameters

Name	Type	Description
version	string	Version of the API
token_address	string	Address of a token
partner_address	string	Address of the partner node

Request Body

Name	Type	Description
total_withdraw	string	Amount of tokens to withdraw

200 Successfully withdrawn tokens

{
    "token_network_address": "0xE5637F0103794C7e05469A9964E4563089a5E6f2",
    "channel_identifier": "20",
    "partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9",
    "token_address": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",
    "balance": "25000000",
    "total_deposit": "35000000",
    "total_withdraw": "5000000",
    "state": "closed",
    "settle_timeout": "500",
    "reveal_timeout": "30"
}

400

402

404

409

500

Example request body:

{
    "total_withdraw": "50"
}

Update Reveal Timeout

PATCH http://localhost:5001/api/v1/channels/0xEA67...8ec8/0x61C8...0bD9

This request will update the number of blocks that are allowed between setting a hashlock and the revealing of the related secret.

Path Parameters

Name	Type	Description
version	string	Version of the API
token_address	string	Address of a token
partner_address	string	Address of the partner node

Request Body

Name	Type	Description
reveal_timeout	string	Value for the new reveal timeout

200

Successfully updated the reveal timeout

Example request body:

{
    "reveal_timeout": "50"
}