Skip to content

manual-deploy.md

Latest commit

 

History

History
68 lines (47 loc) · 2.72 KB

manual-deploy.md

File metadata and controls

68 lines (47 loc) · 2.72 KB
Raw

This is manual to deploy temporary relay instance for AMB-ETH bridge.

Installation

Creating a Droplet

Typical DigitalOcean node (2 GB / 2 CPUs, 60 GB SSD disk, 3 TB transfer) should be good for running a relay

There is detailed step by step information how to setup droplet on digitalocean https://www.digitalocean.com/docs/droplets/how-to/create/

Our brief instructions:

Create an account and log in. Press 'Droplets' and then 'Create Droplet'. Use the OS Ubuntu and then choose what machine preferences and which data center suits you. Then either create a SSH key which you will use to access the instance or if you do not choose one you will get a password to your email. Write a hostname that suits you and launch the instance.

Obtaining private key

You can export the private key from your metamask wallet using this guide: https://metamask.zendesk.com/hc/en-us/articles/360015289632-How-to-export-an-account-s-private-key

Run

If any pop-ups occur, select "ok" or type "y".

During installation you will be prompted to enter your ambrosus and ethereum private keys and token issued by bridge developers.

Also you can pass STAGE env variable to run the relay on dev, test or prod environment. prod is set by default. Also you can pass NO_DOCKER_INSTALL env variable with any value to bypass docker installing. Also you can pass KEYGEN_ONLY env variable with any value to do only keygen.

Untrustless

Command to run eth-relay:

curl -s https://raw.githubusercontent.com/ambrosus/ambrosus-bridge/main/relay.sh > relay.sh && sudo chmod +x relay.sh && sudo ./relay.sh
Untrustless MPC

Command to run relay:

curl -s https://raw.githubusercontent.com/ambrosus/ambrosus-bridge/main/relay-mpc.sh > relay-mpc.sh && sudo chmod +x relay-mpc.sh

AMB_HTTP_URL=amb_http_url \
AMB_WS_URL=amb_ws_url \
SIDE_HTTP_URL=side_http_url \
SIDE_WS_URL=side_ws_url \
sudo ./relay-mpc.sh sideNet meID accessToken partyIDs threshold url

where:

  1. amb_http_url - ambrosus http rpc endpoint
  2. amb_ws_url - ambrosus ws rpc endpoint
  3. side_http_url - side net http rpc endpoint
  4. side_ws_url - side net ws rpc endpoint
  5. sideNet - name of the side network (doesn't matter it's in uppercase or lowercase)
  6. meID - your ID in the party
  7. accessToken - access token to connect to the server
  8. partyIDs - IDs of the party separated by space (for keygen)
  9. threshold - threshold (for keygen)
  10. url - url of the server (for keygen)

For example:

sudo ./relay-mpc.sh ETH Bob "some token" "Alice Bob" 2 wss://relay-eth.ambrosus.io/mpcSide/ws

You may not enter partyIDs, threshold and url if you already have the share to just run the relay.