How to setup a bridge node

This guide will explain how to set up an Accumulate bridge node for Ethereum.

This guide will explain how to set up an Accumulate bridge node for Ethereum. The Accumulate bridge is software that allows for the secure exchange of ERC20 tokens between the Ethereum Mainnet and Accumulate blockchain. The bridge is powered by the Accumulate Protocol, a set of smart contracts that facilitate the transfer of tokens and ownership.


  • You need to install Docker.

  • You need a basic understanding of Accumulate CLI.

  • The bridge works only on a Linux OS.

  • We recommend Infura (

  • You need an Ethereum address.

The first step is to set up an Ethereum node. We recommend using Infura, which is the most popular Ethereum node provider. Once you have set up your node, you can begin setting up the Accumulate bridge.

Next, you will need to create a new account on the Ethereum network that will be used to hold the ERC20 tokens. This account will be known as the bridge account.

Copy the config file into your server

The first step is to create a folder in your server

mkdir ~/.accumulatebridge

Change the folder to the new folder.

cd ~/.accumulatebridge

Then run the command below to generate the config file.

 curl -o ~/.accumulatebridge/config.yaml

Modify the configuration file

Open up the config file in your favorite editor (nano, vscode, or others).

Example config file

# Node API port
    apiport: 8081  
# Log Level (Debug 1, Info 2, Warn 3, Error 4)
    loglevel: 2 
# Accumulate API endpoint, e.g. ""
     node: "" 
# Bridge ADI, usually "bridge.acme"
bridgeadi: "bridge.acme"   
# Bridge keybook, usually "validators"
keybook: "validators"   
# Accumulate ed25519 private key
privatekey: "<your ACME private key>" 
# EVM API endpoint (Infura/Quicknode, private node, etc.)
       node: "<your infura node>"  
# EVM chainid (Ethereum mainnet 1, Goerli testnet 5, etc.)
      chainid: 1  
# Gnosis safe smart contract address
      safeaddress: "0x76b1E2d258CC4297e7708345E5d99e8ECa967BB1"  
# Accumulate bridge smart contract address
bridgeaddress: "0xbA050938970C8eAeDA3e970B571a6fe463Db7d0e" privatekey: "<your ETH private key>"  
# (optional) Maximum gas fee (EIP-1559)
maxgasfee: 30  
# (optional) Maximum priority fee (EIP-1559)
maxpriorityfee: 2

There are a few constant fields:

  • bridgeadi: "bridge.acme"

  • keybook: "validators"

  • safeaddress "0x76b1E2d258CC4297e7708345E5d99e8ECa967BB1"

  • bridgeaddress: "0xbA050938970C8eAeDA3e970B571a6fe463Db7d0e"

Next, run this command to start your Accumulate bridge:

docker run -d --name accumulatebridge -v ~/.accumulatebridge:/home/app/values

You can use `docker ps -a' or `docker container ls -a' to see if the docker image is running.

Congratulations, your bridge is running.

Last updated