Getting started


  • Docker: Official website

    Docker is a container management system. It supports Windows, Mac and most Linux distributions. Select the one that applies to your case and follow the instructions.

  • Docker-compose: Official website

    Docker compose allows advanced container management. It is required to build the automaton properly.

  • A Liquidity registered wallet: Official website

    This wallet will be managed by your automaton. Click on Add New Wallet, select the wallet you want to register and click on Save. Then, open your newly created wallet, click on register and perform Metamask related actions.


In order to get the automaton up and running on your machine, you must follow the instructions listed below.

1. Clone Liquidity SDK repository 🐑

git clone

Alternatively, you can download it from here

2. Configure your wallet instance 🌱

A template of the configuration is provided within config.template.json. You have to copy it into config.json and edit the configuration.

cp config.template.json config.json

Your configuration file should look like the following.


  "HUB_CONTRACT_ADDRESS": "0xac8c3D5242b425DE1b86b17E407D8E949D994010",

3. Start your wallet 👩‍🔧

docker-compose up -d

For those of you who are using a graphic docker version, launch docker-compose.yml file located at the root of the liquidity SDK directory.

This command will start your wallet automaton. It can take some time for it to synchronise with the hub, especially when first launched.

4. Celebrate 🎉

You have finished the installation! The SDK is self-hosted on your machine and is accessible under localhost:3600.

You can test this by accessing https://localhost:3600/wallet/information here you should be able to see the current state of your wallet.


The following documentation is structured into categories. Each category contains a list of endpoints made accessible by the wallet automaton. These endpoints are documented with what they provide, how to call them, their expected result and an example.

If you spot any issues, please post an issue on our github repository