- Run the command
generate_certsin the Hummingbot client
- Enter a passphrase to be used later during installation
- Take note of the absolute path where your Hummingbot files are stored. You can run the command
pwdfrom the terminal while inside the folder.
- Copy and paste the following commands to your terminal:
curl https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create-gateway.sh -o create-gateway.sh curl https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update-gateway.sh -o update-gateway.sh chmod a+x *.sh ./create-gateway.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create-gateway.sh wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update-gateway.sh chmod a+x *.sh ./create-gateway.sh
It downloads the scripts from GitHub, sets their correct permission and runs the
- Answer each prompt, review the summary and enter Y to proceed with the installation.
By default, Gateway will install on port
5000 which Hummingbot will connect to. If the default port is not available, Gateway will find the next port number.
- The file
gateway.envis created where your Gateway settings are saved.
In case the port number used by Gateway is not set to the default value of
5000, make sure to set the
gateway_api_port in the Hummingbot client to match the same port number.
- Run command
config gateway_api_portin the Hummingbot client
- Enter the port number indicated when Gateway was created
To update the docker container, run the
update-gateway.sh script and and follow the prompt instructions. The update script allows you to stop and delete the running instance, and update the docker image if it is not the latest. Upon completion, it will automatically execute the create-gateway.sh script to create a new Gateway container instance.
Installation applies to Windows, Linux or macOS
- NodeJS - visit this page to download and install.
- Tested versions
v10.22.0, v10.22.1 and v10.23.1.
# to check your current version node -v
- Yarn - its required for node package installations.
# to install yarn npm install yarn
- Tested versions
v1.22.5 and v1.22.10
Steps for setting up gateway-api
# clone the repo git clone https://github.com/CoinAlpha/gateway-api
# open directory cd gateway-api
# install npm packages yarn install
# copy sample environment cp .env.example .env
.envfile with your favorite text editor then save changes.
- There are 3 ways to start the gateway
# run dev mode with hot reload on code changes yarn run dev
# run debug mode with additional route debug logging yarn run debug
# run prod mode yarn run start
This guide will help you setup gateway-api instance for Kovan testnet. This will help you run some test to AMM_Arbitrage strategy without risking your funds.
You must have set your ETH wallet to Kovan test network, for metamask you can click the
Ethereum Mainnet and select
Kovan Test Network. To get test assets, you can go to https://gitter.im/kovan-testnet/faucet and login your github account. Provide your ETH wallet address.
When connecting your Hummingbot to ethereum, you need to change to
kovan instead of mainnet for your ethreum chain, websocket and node. See example below,
Add the following to your
erc20_tokens_override.json found on your Hummingbot directory under
"BAT": "0x1f1f156E0317167c11Aa412E3d1435ea29Dc3cCE", "WETH": "0xd0A1E359811322d97991E03f863a0C30C2cF029C", "DAI": "0x1528F3FCc26d13F7079325Fb78D9442607781c8C", "MKR": "0xef13C0c8abcaf5767160018d268f9697aE4f5375", "USDC": "0x2F375e94FC336Cdec2Dc0cCB5277FE59CBf1cAe5", "REP": "0x8c9e6c40d3402480ACE624730524fACC5482798c", "WBTC": "0xe0C9275E44Ea80eF17579d33c55136b7DA269aEb", "SNX": "0x86436BcE20258a6DcfE48C9512d4d49A30C4d8c4", "ANT": "0x37f03a12241E9FD3658ad6777d289c3fb8512Bc9", "ZRX": "0xccb0F4Cf5D3F97f4a55bb5f5cA321C3ED033f244"
Relaunch your Hummingbot client and setup an AMM_Arbitrage strategy.