This is the repo for the Raiden Network at the ETHCapeTown hackathon. Below you'll find a list of links and information needed to get going with Raiden for the hackathon.
- Access to an Ethereum Goerli RPC endpoint
- We recommend running Goerli like this:
geth --goerli --rpc --rpcapi eth,net,web3,txpool --rpccorsdomain http://127.0.0.1:5001 - A Goerli account and Goerli ETH. We've created a small tool that generates an account and sends Goerli ETH and tokens to it with just one simple command. Please see the onboarding section below for instructions.
- The Raiden client itself. Please see the getting Raiden section below.
- If you're on Windows we recommend that you install Raiden for Windows Subsystem for Linux (WSL)
- We have created a gitter room that you can use for asking questions or find out where you can find us if you need help or want to discuss something face-to-face.
We've created a simple script that generates a keystore / address and sends Goerli ETH and ETHCapeTownTokens to the generated address. You can see the source code of the script here Follow these simple steps:
- Download the onboarder macOS binary:
curl -O https://raiden-nightlies.ams3.digitaloceanspaces.com/onboarder-macOS.zip- Unzip the file:
unzip onboarder-macOS.zip- And run it:
./onboarder- Download the onboarder linux binary:
curl -O https://raiden-nightlies.ams3.digitaloceanspaces.com/onboarder-linux.tar.gz- Extract the file:
tar -xvzf onboarder-linux.tar.gz- And run it:
./onboarderThe fastest way to get up and running is to use the latest nightly binary releases. Just follow the instructions below.
- Download the latest nightly macOS binary:
- Unzip the file:
unzip raiden-v0.100.3-rc4-macOS-x86_64.zip
- Download the latest nightly linux binary:
- Extract the file:
tar xvzf raiden-v0.100.3-rc4-linux-x86_64.tar.gz
Once Raiden is installed it's time to fire it up. This is done with the following command (Please make sure the replace raiden-binary with the actual binary you just created above):
Goerli:
./raiden-binary \
--keystore-path keystore \
--network-id 5 \
--environment-type development \
--eth-rpc-endpoint http://localhost:8545NB: Since Goerli takes less than 10 minutes to sync, it's highly recommended to just use that locally
The node will ask you to accept the disclaimer and then ask you to choose which address you want to use. The list should only contain the one address the onboarder tool generated for you.
It will take a bit of time for the node to finish launching. You'll see that it's ready once you see the message stating that the Rest-API has been started.
You can now access the WebUI at http://127.0.0.1:5001/.
You should now have running Raiden node. From here you can join the ETHCapeTownToken network. We recommend posting your address in the gitter channel if you want to try it out with someone else hacking on Raiden. You can also check out how the network is growing by checking out the Goerli Raiden Explorer for the ETHCapeTownToken.
The first thing to do when Raiden is up and running is to open a channel with someone. You can do so by opening a channel with the node below, or to find another hacker building on Raiden and open a channel with him. For this you just have to replace the partner_address below with his/her address.
curl -i -X PUT http://localhost:5001/api/1/channels \
-H 'Content-Type: application/json' --data-raw \
'{"partner_address": "0x0bae0289AAA26845224F528F9B9DefE69e01606E", \
"token_address": "0x396764f15ed1467883A9a5B7D42AcFb788CD1826", \
"total_deposit": 10000000000000000000}'If you ever need to top up a channel, you can use the following command:
curl -i -X PATCH http://localhost:5001/api/1/channels/ \
0x396764f15ed1467883A9a5B7D42AcFb788CD1826/ADDRESS_OF_PARTNER \
-H 'Content-Type: application/json' \
--data-raw '{"total_deposit": 15000000000000000000}'To make payments, choose the address of the partner you've opened a channel with and do the following:
curl -i -X POST http://localhost:5001/api/1/payments/ \
0x396764f15ed1467883A9a5B7D42AcFb788CD1826/ADDRESS_OF_RECEIVER \
-H 'Content-Type: application/json' --data-raw '{"amount": 100000}'Feel free to change the amounts of the payments.