System Requirements and Installation Guide¶
Raiden is a payment channel implementation which provides scalable, low latency, and cheap token transfers for Ethereum.
If you are just switching from an old installation of raiden which was using python 2, then you should make sure to remove your raiden directory. By default that would mean:
rm -rf ~/.raiden
The preferred way to install Raiden is downloading a self contained application bundle from the GitHub release page.
Download the latest
raiden-<version>-linux.tar.gz, and extract it:
tar -xvzf raiden-<version>-linux.tar.gz
The Raiden binary should work on most 64bit GNU/Linux distributions without any specific system dependencies, other
than an Ethereum client installed in your system (see below). The Raiden binary takes the same command line
arguments as the
Download the latest
raiden-<version>-macOS.zip, and extract it:
The resulting binary will work on any version of macOS from 10.12 onwards without any other dependencies.
Or you can use Homebrew to install the most up to date binary:
brew tap raiden-network/raiden brew install raiden
An Ethereum client is required in both cases.
If you plan to develop on the Raiden source code, or the binary distributions do not work for your system, you can follow these steps to install a development version.
Additional dependencies for development installations¶
- You need to make sure that your system has
solc, the ethereum solidity compiler installed.
Installation from source¶
Clone the repository:
git clone https://github.com/raiden-network/raiden.git
Navigate to the directory:
It’s advised to create a virtualenv for Raiden and install all python dependencies there.
After you have done that you can proceed to install the dependencies:
pip install --upgrade -r requirements-dev.txt python setup.py develop
You will also need to connect your Ethereum client to the Ropsten testnet. See below for guidelines on how to connect with both Parity and Geth.
Firing it up¶
In order to use Raiden it is required to have a specific ethereum account dedicated to Raiden. Create an account for Raiden and fill it up with ETH and some tokens you want to have in payment channels and let the Raiden client manage it. Creating any manual transaction with the account that Raiden uses, while the Raiden client is running, can result to undefined behaviour.
Run the Ethereum client and let it sync with the Ropsten testnet:
geth --testnet --fast --rpc --rpcapi eth,net,web3 --bootnodes "enode://email@example.com:30303,enode://firstname.lastname@example.org:30303"
Unless you already have an account you can also create one in the console by invoking
If problems arise for above method, please see the Ropsten README for further instructions.
Then launch Raiden with the default testnet keystore path:
raiden --keystore-path ~/.ethereum/testnet/keystore
Run the client and let it sync with the Ropsten testnet:
parity --chain ropsten --bootnodes "enode://email@example.com:30303,enode://firstname.lastname@example.org:30303"
After syncing the chain, create an account on the Ropsten testnet by navigating to the url that parity shows. It is usually:
After account creation, launch Raiden with the path of your keystore supplied:
raiden --keystore-path ~/.local/share/io.parity.ethereum/keys/test
Select the Ethereum account when prompted, and type in the account’s password.
See the API walkthrough for further instructions on how to interact with Raiden.