Get your own RIF Lumino node up and running on MacOS


  1. Access to a synched RSK node. You can do this in a variety of ways:
  2. An RSK account with an R-BTC balance NOT lower than 0.001 R-BTC
  3. XCode

Install required libraries/software

Install command line tools

xcode-select --install

Install Homebrew

From a Terminal window run:

/usr/bin/ruby -e "$(curl -fsSL"

Install OpenSSL

brew install openssl
export LC_ALL="en_US.UTF-8"\nexport LC_CTYPE="en_US.UTF-8"
export LIBRARY_PATH=$LIBRARY_PATH:/usr/local/opt/openssl/lib/

Install Python 3.7

brew install python3

Install PIP

sudo easy_install pip

Install virtualenv

pip3 install virtualenv

Install libpq

brew install libpq

Install postgresql

brew install postgresql

Install psycopg2

env LDFLAGS="-I/usr/local/opt/openssl/include -L/usr/local/opt/openssl/lib" pip install psycopg2

Build RIF Lumino from code

  1. Get the code from
  2. Uncompress the downloaded file
  3. Go to the path you uncompressed the code in the previous step (lets call this path $RIF_LUMINO_PATH)
  4. Create python virtual env for RIF Lumino (this needs to be performed only once) and execute the following command:
virtualenv -p <PATH_TO_PYTHON3.7> clientEnv

Note: Replace <PATH_TO_PYTHON3.7> with the path where Python3.7 is installed in your system. In the case of MacOS, this is usually /usr/local/bin/python3.7

  1. Activate python virtual env, by executing the following command:
source clientEnv/bin/activate
  1. Check if the Python version is correct inside the virtual environment by running:
python --version

This command should output version 3.7.x

  1. Install RIF Lumino requirements. Inside the virtual environment run the following command (this could take a few minutes):
pip install -c constraints.txt --upgrade -r requirements-dev.txt
  1. Run Lumino setup with the following command:
python develop

Start your RIF Lumino Node

  2. If you haven’t execute it before, run: source clientEnv/bin/activate
  3. Run the following command:
	 --keystore-path $KEYSTORE_PATH
	 --network-id 30
	 --eth-rpc-endpoint $RSK_NODE_URL
	 --environment-type development

The following list describes each field:

keystore-path The path to your keystore
network-id The network id (Mainnet is 30)
eth-rpc-endpoint URL of your RSK node (http://URL:PORT)
tokennetwork-registry-contract-address Address for the token registry contract deployed (view contracts table for the contract address of testnet and mainnet)
secret-registry-contract-address Address for the secret registry contract deployed (view contracts table for the contract address of testnet and mainnet)
endpoint-registry-contract-address Address for the endpoint registry contract deployed (view contracts table for the contract address of testnet and mainnet)

After you run the “lumino” command you will be presented with the following confirmation message:

Welcome to RIF Lumino Payments Protocol, Version 0.1

This is an Alpha version of experimental open source software released under the MIT license.
By using the RIF Lumino Payments Protocol (the “Software”), you acknowledge that this is a
test version of the Software and assume the risk that the Software may contain errors and/or
bugs. RIF Labs Limited (“RIF Labs”) makes no guarantees or representations whatsoever,
including as to the suitability or use of the Software for any purpose or regarding its
compliance with any applicable laws or regulations. By using the Software, you acknowledge
that you have read this disclosure agreement, understand its contents, and assume all risks
related to the use of of the software; further, by answering yes below and accepting the terms
of this Agreement, you release and discharge RIF Labs, its officers, employees, or affiliates
from, waive any claims you might have against RIF Labs, its officers, employees, or affiliates
in connection with, and agree not to sue RIF Labs or any of its officers, employees, or
affiliates for any direct or indirect liability arising from the use of this Software.
Privacy Warning:
By using the RIF Lumino Payments Protocol, you acknowledge that your RSK address, channels,
channel deposits settlements, and the RSK address of your channel counterparty will be stored
on the RSK blockchain—that is, on servers of RSK node operators—and therefore will be publicly
available. The parties running nodes on the RIF Lumino network may also download and store
this same or related information or data, and information or data stored on Lumino nodes and
network channels will be publicly visible, including on a RIF Lumino block explorer. By using
the Software and by answering yes below, you acknowledge that information or data stored on
the Lumino network is extremely difficult to alter, remove, or delete; you further acknowledge
that information or data related to individual tokens transfers will be made available via the
Lumino Payments Protocol to the recipient intermediating nodes of a specific transfer as well
as to the Lumino server operators.
Have you read and understood and do you accept the RIF Lumino Disclosure Agreement and Privacy
Warning? [y/N]

press Y followed by Enter.

After you accepted you will be asked to select the account you want to use. Select the account and enter your passphrase to continue.

Contract addresses on each environment

Go to for the updated addresses of the contracts.