This documents describes how to install the trustlines relay server for local development.
If you're trying to setup a complete trustlines system, please visit Running the trustlines system
The relay server provides a REST API. Please visit the REST API Documentation page for more information.
An installation of the relay server requires at least the following components:
- PostgreSQL header files
- Python 3.6 or up
To install the relay server on Ubuntu 18.04, start by installing the pre-requisites with the following command
To install the relay, start by cloning the repository
Then create and activate a fresh virtualenv::
Finally, to install all needed dependencies to run the relay, use the following command
You can verify that the relay is correctly installed by running
to get an overview of available options.
In addition to having installed the relay, you will need a blockchain
node connected to a chain with deployed trustlines contracts
to interact with. You can go to the contracts repository
to see how to deploy new trustlines contracts, or you may use the provided
addresses.json files in
config/ containing addresses of deployed contracts on the Trustlines Blockchain by
copying them here
You may use the blockchain repository to get a Trustlines Blockchain node running.
The relay also uses a py-eth-index instance that index events that the relay will be able to process and serve to its users.