C45tr0 / debridge-launcher

This repo allows to setup the oracles for few chains quickly with the same credentials.

Install packages on the chainlink server

1. docker - https://docs.docker.com/engine/install/ubuntu/
2. docker-compose - https://docs.docker.com/compose/install/
3. nodejs - https://github.com/nodesource/distributions/blob/master/README.md
4. psql sudo apt-get install postgresql-client

Fast Testnet start

1. Install full testnet nodes

• Kovan
• BSC
• HECO

2. Set ETH_URL (node Websocket Endpoint) in files chainlink-eth.env, chainlink-bsc.env, chainlink-heco.env
3. Set providers (node RPC Endpoint) ETH_PROVIDER, BSC_PROVIDER, ETH_PROVIDER in file .env
4. Change default (postgreschainlink) postgress password in .env
5. Create file apicredentials with chainlink email and password. example docs. After that need to change CHAINLINK_EMAIL, CHAINLINK_PASSWORD in initiator/.env
6. Put keystore file to secrets/keystore.json.
7. Store the password that decrypts the key from keystore in password.txt
8. Make your oracle-operator address to be whitelisted by deBridge governance
9. Run the command docker-compose up --build -d.
10. Run the script to create the initiators and prepare the jobs and store main configurations in the database:

bash chainlink-init-scripts/setup-initiators-and-jobs.sh

11. Run the command docker-compose restart initiator.
12. If you want to start multiple instances on one server or one postgresql you can do this:

• checkout or copy repo to new directory
• change DOCKER_ID variable in .env
• start as previously described

Use separate apicredentials

1. create several apicredentials like apicredentials-bsc and apicredentials-heco
2. create several secrets in docker-compose.conf
3. change start arguments(entrypoint) and secrets of docker-compose chainlink config
4. create initiator/config/credentials.json with custom credentials(please see example initiator/config/credentials_example.json)

Add new chain support

1. Create and configure chainlink-[{CHAIN_TICKER}].env. At least the followed params should be added:

ROOT
ETH_CHAIN_ID
LINK_CONTRACT_ADDRESS
CHAINLINK_TLS_PORT
SECURE_COOKIES
GAS_UPDATER_ENABLED
ALLOW_ORIGINS
ETH_URL
CHAINLINK_BASEURL
FEATURE_EXTERNAL_INITIATORS
CHAINLINK_DEV
CHAINLINK_PORT
CLIENT_NODE_URL

For more details, see the docs

2. Add the container to the docker-compose.yml

  chainlink-[{CHAIN_TICKER}]:
    container_name: chainlink-[{CHAIN_TICKER}]${DOCKER_ID}
    image: smartcontract/chainlink:0.10.2
    entrypoint: /bin/sh -c "chainlink node import /run/secrets/keystore && chainlink node start -d -p /run/secrets/node_password -a /run/secrets/apicredentials"
    restart: always
    env_file:
      - chainlink-[{CHAIN_TICKER}].env
    environment:
      - DATABASE_URL=postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${POSTGRES_HOST}:${POSTGRES_PORT}/${HECO_DATABASE}?sslmode=disable
    secrets:
      - node_password
      - apicredentials
      - keystore
    depends_on:
      - postgres
    networks:
      - chainlink

3. Add the new database name specified in DATABASE_URL to .env at the end of POSTGRES_MULTIPLE_DATABASES using coma separator.

Note: if the database already exist the scrypt that creates the database won't be run. So the database either should be created manually or the volume with previous database can be removed:

docker volume rm pgdata

See Initialization scripts section in docs.

4. Run the command docker-compose up.

5. Extend setup-initiators-and-jobs.sh. Add to the end of the file:

echo "Add initiator for $NETWORK"
network=[[NETWORK_NAME]]
chain_id=[[NETWORK_CHAIN_ID]]
container_name=$(docker-compose ps | grep [[NETWORK_NAME]] | awk '{print $1}')
cl_url="http://$container_name:6688"
add_initiator $network

echo "Add jobs for $NETWORK"
add_jobs $network

echo "Prepare table for $NETWORK ie"
create_ei_table $chain_id $cl_url $network

echo "Add record for $NETWORK ie"
add_record $network

Miscellenious

Connect to the database(if you use docker-compose):

docker exec -it $(docker-compose ps | grep postgres | awk '{print $1}') psql -v ON_ERROR_STOP=1 --username postgres -d $DATABASE_NAME

Mandatory for monitoring

1. Basic monitoring of the server/virtual machine(cpu, memory, disk space).
2. Availability check(may be connectivity):

• all of full nodes(heco, bsc, etc). It is also good to check the synchronization status
• database
• initiator and chainlinks

3. Strongly recommend to check docker-compose logs for ERROR.