# Getting started with the Raiden API¶

## Introduction¶

Raiden has a Restful API with URL endpoints corresponding to actions that users can perform with their channels. The endpoints accept and return JSON encoded objects. The API URL path always contains the API version in order to differentiate queries to different API versions. All queries start with: /api/<version>/ where <version> is an integer representing the current API version.

This section walks through the steps necessary to participate in a Raiden Token Network. Some different scenarios such as joining an already existing token network, registering a new token network, together with opening, closing and settling channels, are provided.

Before getting started with below guides, please see Overview and Guide, to make sure that a proper connection to Raiden is established.

Furthermore, to see all available endpoints, please see the REST API documentation.

## Scenarios¶

Below is a series of different scenarios showing different ways a user can interact with the Raiden API.

A good way to check that Raiden was started correctly before proceeding is to check that the Raiden address is the same address as the Ethereum address chosen, when starting the Raiden node:

http

GET /api/v1/address HTTP/1.1
Host: localhost:5001


curl

curl -i http://localhost:5001/api/v1/address


wget

wget -S -O- http://localhost:5001/api/v1/address


httpie

http http://localhost:5001/api/v1/address


python-requests

requests.get('http://localhost:5001/api/v1/address')


If this returns the same address, we know that the Raiden node is up and running correctly.

## Bootstrapping a token network¶

In this scenario it is assumed that a user holds some ERC20 token, with address 0x9aBa529db3FF2D8409A1da4C9eB148879b046700, which has not yet been registered with Raiden.

The user wants to register the token, which creates a Token Network for that token. For each registered token there is a corresponding token network. Token networks are responsible for opening new payment channels between two parties.

### Checking if a token is already registered¶

One way of checking if a token is already registered is to get the list of all registered tokens. Then, in the returned list, check if the address of the token wanted for interaction exists:

http

GET /api/v1/tokens HTTP/1.1
Host: localhost:5001


curl

curl -i http://localhost:5001/api/v1/tokens


wget

wget -S -O- http://localhost:5001/api/v1/tokens


httpie

http http://localhost:5001/api/v1/tokens


python-requests

requests.get('http://localhost:5001/api/v1/tokens')


If the address of the token exists in the list, see the Joining an already existing token network scenario. If it does not exist in the list, it is desired to register the token.

### Registering a token¶

Note

For the Raiden Red Eyes release, it will not be possible to register more than one token, due to security reasons in order to minimise possible loss of funds in the case of bugs. The one token that will be registered is W-ETH.

In order to register a token, only its address is needed. When a new token is registered a Token Network contract is deployed. This is quite expensive in terms of gas usage (costs about 3.5 million gas). Luckily, this only has to be done once per token.

To register a token simply use the endpoint listed below:

http

PUT /api/v1/tokens/0x9aBa529db3FF2D8409A1da4C9eB148879b046700 HTTP/1.1
Host: localhost:5001
Content-Type: application/json


curl

curl -i -X PUT http://localhost:5001/api/v1/tokens/0x9aBa529db3FF2D8409A1da4C9eB148879b046700 -H 'Content-Type: application/json'


wget

wget -S -O- --method=PUT http://localhost:5001/api/v1/tokens/0x9aBa529db3FF2D8409A1da4C9eB148879b046700 --header='Content-Type: application/json'


httpie

http PUT http://localhost:5001/api/v1/tokens/0x9aBa529db3FF2D8409A1da4C9eB148879b046700 Content-Type:application/json


python-requests

requests.put('http://localhost:5001/api/v1/tokens/0x9aBa529db3FF2D8409A1da4C9eB148879b046700', headers={
'Content-Type': 'application/json',
})


If successful this call returns the address of the freshly created Token Network like this:

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

{
}


The token is now registered. However, since the token was just registered, there are no other Raiden nodes connected to the token network. This means that there are no nodes to connect to. Due to this the token network for this specific token needs to be bootstrapped. If the address of some other Raiden node that holds some of the tokens is known or it’s simply desired to pay some tokens to another Raiden node in a one-way-channel, it can be done by opening a channel with this node. The way to open a channel with another Raiden node is the same whether the partner already holds some tokens or not.

### Opening a channel¶

To open a channel with another Raiden node four things are needed: the address of the token, the address of the partner node, the amount of tokens desired for deposit, and the settlement timeout period. With these things ready a channel can be opened:

http

PUT /api/v1/channels HTTP/1.1
Host: localhost:5001
Content-Type: application/json

{
"total_deposit": "1337",
"settle_timeout": "500"
}


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": "0x9aBa529db3FF2D8409A1da4C9eB148879b046700", "total_deposit": "1337"}'


wget

wget -S -O- --method=PUT http://localhost:5001/api/v1/channels --header='Content-Type: application/json' --body-data='{"partner_address": "0x61C808D82A3Ac53231750daDc13c777b59310bD9", "settle_timeout": "500", "token_address": "0x9aBa529db3FF2D8409A1da4C9eB148879b046700", "total_deposit": "1337"}'


httpie

echo '{
"settle_timeout": "500",
"total_deposit": "1337"
}' | http PUT http://localhost:5001/api/v1/channels Content-Type:application/json


python-requests

requests.put('http://localhost:5001/api/v1/channels', headers={
'Content-Type': 'application/json',
}, json={
'settle_timeout': '500',
'total_deposit': '1337',
})


Note

For the Raiden Red Eyes release the maximum deposit per node in a channel is limited to 0.075 worth of W-ETH. This means that the maximum amount of tokens in a channel is limited to 0.15 worth of W-ETH. This is done to mitigate risk since the Red Eyes release is an alpha testing version on the mainnet.

At this point the specific value of the total_deposit field isn’t too important, since it’s always possible to deposit more tokens to a channel if need be.

Successfully opening a channel returns the following information:

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

{
"balance": "1337",
"total_deposit": "1337",
"state": "opened",
"settle_timeout": "500",
"reveal_timeout": "50"
}


Here it’s interesting to notice that a channel_identifier has been generated. This means that the channel has been created inside the Token Network.

### Depositing to a channel¶

A payment channel is now open between the user’s node and a counterparty. However, since only one of the nodes has deposited to the channel, only that node can make payments at this point in time. Now would be a good time to notify the counterparty that a channel has been opened with it, so that it can also deposit to the channel. All the counterparty needs in order to do this is to use the endpoint consisting of a combination of the token_address and the participant_address:

http

PATCH /api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9 HTTP/1.1
Host: localhost:5001
Content-Type: application/json

{
"total_deposit": "7331"
}


curl

curl -i -X PATCH http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9 -H 'Content-Type: application/json' --data-raw '{"total_deposit": "7331"}'


wget

wget -S -O- --method=PATCH http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9 --header='Content-Type: application/json' --body-data='{"total_deposit": "7331"}'


httpie

echo '{
"total_deposit": "7331"
}' | http PATCH http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9 Content-Type:application/json


python-requests

requests.patch('http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9', headers={
'Content-Type': 'application/json',
}, json={
'total_deposit': '7331',
})


Note

For the Raiden Red Eyes release the maximum deposit per node in a channel is limited to 0.075 worth of W-ETH. This means that the maximum amount of tokens in a channel is limited to 0.15 worth of W-ETH. This is done to mitigate risk since the Red Eyes release is an alpha testing version on the mainnet.

To see if and when the counterparty deposited tokens, the channel can be queried for the corresponding events. The from_block parameter in the request represents the block number to query from. (in general the default value should be fine):

http

GET /api/v1/events/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337 HTTP/1.1
Host: localhost:5001


curl

curl -i 'http://localhost:5001/api/v1/events/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337'


wget

wget -S -O- 'http://localhost:5001/api/v1/events/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337'


httpie

http 'http://localhost:5001/api/v1/events/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337'


python-requests

requests.get('http://localhost:5001/api/v1/events/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337')


This returns a list of events that has happened in the specific payment channel. The relevant event in this case is:

{
"amount": "682",
"block_number": "3663408",
"event": "EventPaymentSentSuccess",
"identifier": "1531927405484",
"target": "0x25511699C252eeA2678266857C98F459Df97B77c"
},


From the above event it can be deducted that the counterparty deposited to the channel. It is possible for both parties to query the state of the specific payment channel by calling:

http

GET /api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9 HTTP/1.1
Host: localhost:5001


curl

curl -i http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9


wget

wget -S -O- http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9


httpie

http http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9


python-requests

requests.get('http://localhost:5001/api/v1/channels/0x9aBa529db3FF2D8409A1da4C9eB148879b046700/0x61C808D82A3Ac53231750daDc13c777b59310bD9')


This gives a result similar to those in Opening a Channel that represents the current state of the payment channel.

A new token resulting in a new token network has now been registered. A channel between two Raiden nodes has been opened, and both nodes have deposited to the channel. From here on the two nodes can start sending payments to each other.

The above is not how a user would normally join an already existing token network. It is only included here to show how it works under the hood.

In the next scenario it is explained how to join already bootstrapped token networks.

## Joining an already existing token network¶

In above scenario it was shown how to bootstrap a token network for an unregistered token. In this section the most common way of joining a token network is explained. In most cases users don’t want to create a new token network, but they want to join an already existing token network for an ERC20 token that they already hold.

The main focus of this section is the usage of the connect and the leave endpoints. The connect endpoint allows users to automatically connect to a token network and open channels with other nodes. Furthermore the leave endpoint allows users to leave a token network by automatically closing and settling all of their open channels.

It’s assumed that a user holds at least 2000 Raiden Testnet ERC20 token (RTT). The user knows that a token network already exists for this token.

### Connect¶

Connecting to an already existing token network is quite simple. All that is needed, is as mentioned above, the address of the token network to join and the amount of the corresponding token that the user is willing to deposit in channels:

http

PUT /api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED HTTP/1.1
Host: localhost:5001
Content-Type: application/json

{
"funds": "2000"
}


curl

curl -i -X PUT http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED -H 'Content-Type: application/json' --data-raw '{"funds": "2000"}'


wget

wget -S -O- --method=PUT http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED --header='Content-Type: application/json' --body-data='{"funds": "2000"}'


httpie

echo '{
"funds": "2000"
}' | http PUT http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED Content-Type:application/json


python-requests

requests.put('http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED', headers={
'Content-Type': 'application/json',
}, json={
'funds': '2000',
})


Note

For the Raiden Red Eyes release the maximum deposit per node in a channel is limited to 0.075 worth of W-ETH. This means that the maximum amount of tokens in a channel is limited to 0.15 worth of W-ETH. This is done to mitigate risk since the Red Eyes release is an alpha testing version on the mainnet.

This automatically opens channels with three random peers in the token network, with 20% of the funds deposited to each channel. Furthermore it leaves 40% of the funds initially unassigned. This allows new nodes joining the network to open payment channels with this node in the same way that it just opened channels with random nodes in the network.

The user node is now connected to the token network for the RTT token. It should also have a path to all other nodes that have joined this token network. This means that it can pay tokens to all nodes participating in this network. See the Token Payments section for instructions on how to pay tokens to other nodes.

### Leave¶

If at some point it is desired to leave the token network, the leave endpoint is available. This endpoint takes care of closing and settling all open channels for a specific token network:

http

DELETE /api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED HTTP/1.1
Host: localhost:5001
Content-Type: application/json


curl

curl -i -X DELETE http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED -H 'Content-Type: application/json'


wget

wget -S -O- --method=DELETE http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED --header='Content-Type: application/json'


httpie

http DELETE http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED Content-Type:application/json


python-requests

requests.delete('http://localhost:5001/api/v1/connections/0x0f114A1E9Db192502E7856309cc899952b3db1ED', headers={
'Content-Type': 'application/json',
})


This call takes some time to finalize, due to the nature of the way that settlement of payment channels work. For instance there is a settlement_timeout period after calling close that needs to expire before settle can be called.

## Token payments¶

For the token payment example it is assumed a node is connected to the RTT token network as mentioned above. In this case the node is connected to five peers, since the standard connect() parameters were used.

### Payments¶

Paying tokens to another node is quite easy. The address of the token desired for the payment is 0x0f114A1E9Db192502E7856309cc899952b3db1ED. All that then remains is the address of the target node. Assume the address of the target node is 0x61C808D82A3Ac53231750daDc13c777b59310bD9:

http

POST /api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 HTTP/1.1
Host: localhost:5001
Content-Type: application/json

{
"amount": "42"
}


curl

curl -i -X POST http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 -H 'Content-Type: application/json' --data-raw '{"amount": "42"}'


wget

wget -S -O- http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 --header='Content-Type: application/json' --post-data='{"amount": "42"}'


httpie

echo '{
"amount": "42"
}' | http POST http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 Content-Type:application/json


python-requests

requests.post('http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9', headers={
'Content-Type': 'application/json',
}, json={
'amount': '42',
})


An "identifier": <some_integer> can also be added to the payload, but it’s optional. The purpose of the identifier is solely for the benefit of the Dapps built on top of Raiden in order to provide a way to tag payments.

If there is a path in the network with enough capacity and the address sending the payment holds enough tokens to pay the amount in the payload, the payment goes through. The receiving node should then be able to see incoming payments by querying all its open channels. This is done by doing the following for all addresses of open channels:

http

GET /api/v1/events/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337 HTTP/1.1
Host: localhost:5001
Content-Type: application/json


curl

curl -i 'http://localhost:5001/api/v1/events/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337' -H 'Content-Type: application/json'


wget

wget -S -O- 'http://localhost:5001/api/v1/events/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337' --header='Content-Type: application/json'


httpie

http 'http://localhost:5001/api/v1/events/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337' Content-Type:application/json


python-requests

requests.get('http://localhost:5001/api/v1/events/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9?from_block=1337', headers={
'Content-Type': 'application/json',
})


Which returns a list of events. All that then needs to be done is to filter for incoming payments.

Please note that one of the most powerful features of Raiden is that users can send payments to anyone connected to the network as long as there is a path to them with enough capacity, and not just to the nodes that a user is directly connected to. This is called mediated transfers.

### Close¶

If at any point in time it is desired to close a specific channel it can be done with the close endpoint:

http

PATCH /api/v1/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 HTTP/1.1
Host: localhost:5001
Content-Type: application/json

{
"state":"closed"
}


curl

curl -i -X PATCH http://localhost:5001/api/v1/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 -H 'Content-Type: application/json' --data-raw '{"state": "closed"}'


wget

wget -S -O- --method=PATCH http://localhost:5001/api/v1/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 --header='Content-Type: application/json' --body-data='{"state": "closed"}'


httpie

echo '{
"state": "closed"
}' | http PATCH http://localhost:5001/api/v1/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9 Content-Type:application/json


python-requests

requests.patch('http://localhost:5001/api/v1/channels/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x61C808D82A3Ac53231750daDc13c777b59310bD9', headers={
'Content-Type': 'application/json',
}, json={
'state': 'closed',
})


When successful this gives a response with a channel object where the state is set to "closed":

HTTP/1.1 200 OK
Content-Type: application/json

{
"balance": "350",
"state": "closed",
"settle_timeout": "500",
"reveal_timeout": "50"
}


Notice how the state is now set to "closed" compared to the previous channel objects where it was "opened".

### Settle¶

Once close has been called, the settle timeout period starts. The channel is automatically settled as soon as it is over.

The balance of the channel is now 0 and the state "settled". This means that the net balances that the two parties participating in the channel owe each other have now been transferred on the blockchain. It also means that the life cycle of the payment channel has ended.

## Interacting with the Raiden Echo Node¶

Note

For the Raiden Red Eyes release on mainnet the Echo Node will not be available. Currently the Echo Node is available on the Ropsten testnet according to the text below.

For easy testing of Raiden, there is a specialized Raiden node running, the “Raiden Echo Node”. The Echo Node responds to received payments by sending a payment back to the initiator. The echo payment follows certain rules:

• consecutive payments with the same identifier and same amount from the same address are ignored (as in: the Echo Node just keeps your money)
• the echo_identifier of all echo payments is identifier + echo_amount
• payments with an amount divisible by 3 will be answered with an echo payment of echo_amount = amount - 1
• payments with an amount = 7 are special lottery payments. They will go to a lottery pool. After the Echo Node has received seven lottery payments, it will choose a winner that receives an echo payment with echo_amount = 49 and the pool is reset. To query the current number of tickets in the pool, a participant can send another payment with amount = 7 – if the participant already takes part in the current draw, the Echo Node will respond with a payment with echo_amount = number_of_tickets, otherwise it will enter the pool.
• for a payment with any other amount it returns echo_amount = amount

The address of the Echo Node is 0x02f4b6BC65561A792836212Ebc54434Db0Ab759a and it is connected to the Raiden Testnet Token (RTT) with the address 0x0f114a1e9db192502e7856309cc899952b3db1ed. The RTT token contract is verified and can be seen in etherscan. To interact with the Echo Node, first join the RTT network.

You can obtain RTT tokens by calling the mint() function of the token. In javascript you can load the RTT token contract and call mint as such:

var rtt_token_abi = [{"constant":true,"inputs":[],"name":"name","outputs":[{"name":"","type":"string"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_value","type":"uint256"}],"name":"approve","outputs":[{"name":"success","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[],"name":"mint","outputs":[],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"totalSupply","outputs":[{"name":"supply","type":"uint256"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_from","type":"address"},{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transferFrom","outputs":[{"name":"success","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"decimals","outputs":[{"name":"","type":"uint8"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"version","outputs":[{"name":"","type":"string"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"}],"name":"balanceOf","outputs":[{"name":"balance","type":"uint256"}],"payable":false,"type":"function"},{"constant":true,"inputs":[],"name":"symbol","outputs":[{"name":"","type":"string"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"amount","type":"uint256"}],"name":"mint","outputs":[],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_to","type":"address"},{"name":"_value","type":"uint256"}],"name":"transfer","outputs":[{"name":"success","type":"bool"}],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"amount","type":"uint256"},{"name":"target","type":"address"}],"name":"mintFor","outputs":[],"payable":false,"type":"function"},{"constant":false,"inputs":[{"name":"_spender","type":"address"},{"name":"_value","type":"uint256"},{"name":"_extraData","type":"bytes"}],"name":"approveAndCall","outputs":[{"name":"success","type":"bool"}],"payable":false,"type":"function"},{"constant":true,"inputs":[{"name":"_owner","type":"address"},{"name":"_spender","type":"address"}],"name":"allowance","outputs":[{"name":"remaining","type":"uint256"}],"payable":false,"type":"function"},{"inputs":[{"name":"_tokenName","type":"string"},{"name":"_tokenSymbol","type":"string"}],"payable":false,"type":"constructor"},{"payable":false,"type":"fallback"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_from","type":"address"},{"indexed":true,"name":"_to","type":"address"},{"indexed":false,"name":"_value","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"name":"_owner","type":"address"},{"indexed":true,"name":"_spender","type":"address"},{"indexed":false,"name":"_value","type":"uint256"}],"name":"Approval","type":"event"}];


Then you can send a payment to it via the payments endpoint:

http

POST /api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x02f4b6BC65561A792836212Ebc54434Db0Ab759a HTTP/1.1
Host: localhost:5001
Content-Type: application/json

{
"amount": "1",
"identifer": "42"
}


curl

curl -i -X POST http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x02f4b6BC65561A792836212Ebc54434Db0Ab759a -H 'Content-Type: application/json' --data-raw '{"amount": "1", "identifer": "42"}'


wget

wget -S -O- http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x02f4b6BC65561A792836212Ebc54434Db0Ab759a --header='Content-Type: application/json' --post-data='{"amount": "1", "identifer": "42"}'


httpie

echo '{
"amount": "1",
"identifer": "42"
}' | http POST http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x02f4b6BC65561A792836212Ebc54434Db0Ab759a Content-Type:application/json


python-requests

requests.post('http://localhost:5001/api/v1/payments/0x0f114A1E9Db192502E7856309cc899952b3db1ED/0x02f4b6BC65561A792836212Ebc54434Db0Ab759a', headers={
'Content-Type': 'application/json',
}, json={
'amount': '1',
'identifer': '42',
})


Afterwards you can check your events and you should find an EventPaymentReceivedSuccess event with:

{

According to the rules from above, you should try the same with different amounts, 3, 6, 7, … – have fun!