Allbridge Core Website • Documentation • SDK TS doc

Allbridge Core REST API

Provides an easy integration with the Allbridge Core ChainBridgeService for DApps vie REST API.

Table of Contents

• Allbridge Core REST API
  • Table of Contents
  • Configuration
    • Networks
    • Environment variables
  • How to get
    • Run docker image
    • Build and run the docker image
    • Host on Heroku
      • Step-by-Step Guide
        • Deploy and release REST-API container
        • One-Time Setup (Optional for Updates)
        • Final Steps
  • How to use
    • Swagger
    • Raw transactions
    • Tokens
    • Pools
    • Transfers

Configuration

Networks

The Allbridge Core REST API supports the following networks:

• Ethereum (ETH)
• Binance Smart Chain (BSC)
• Tron (TRX)
• Arbitrum (ARB)
• Polygon (POL)
• Avalanche (AVA)
• Optimism (OPT)
• Base (BAS)
• Celo (CEL)
• Solana (SOL)
• Stellar (STLR) & Soroban (SRB)

Environment variables

The Allbridge Core REST API requires the following environment variables:

• ETH_NODE_URL - The JSON RPC URL of the Ethereum node. For example:
  • https://ethereum-rpc.publicnode.com
  • https://mainnet.infura.io/v3/YOUR-PROJECT-ID
  • ...
• BSC_NODE_URL - The JSON RPC URL of the Binance Smart Chain node. For example:
  • https://bsc-rpc.publicnode.com
  • https://bsc-dataseed1.binance.org
  • ...
• TRX_NODE_URL - The JSON RPC URL of the Tron node. For example:
  • https://tron-rpc.publicnode.com
  • https://api.trongrid.io
  • ...
• ARB_NODE_URL - The JSON RPC URL of the Arbitrum node. For example:
  • https://arbitrum-one-rpc.publicnode.com
  • https://arb1.arbitrum.io/rpc
  • https://arbitrum-mainnet.infura.io/v3/YOUR-PROJECT-ID
  • ...
• POL_NODE_URL - The JSON RPC URL of the Polygon node. For example:
  • https://polygon-bor-rpc.publicnode.com
  • https://polygon-rpc.com
  • ...
• AVA_NODE_URL - The JSON RPC URL of the Avalanche node. For example:
  • https://avalanche-c-chain-rpc.publicnode.com
  • https://api.avax.network/ext/bc/C/rpc
  • https://avalanche-mainnet.infura.io/v3/YOUR-PROJECT-ID
  • ...
• OPT_NODE_URL - The JSON RPC URL of the Optimism node. For example:
  • https://optimism-rpc.publicnode.com
  • https://mainnet.optimism.io
  • https://optimism-mainnet.infura.io/v3/YOUR-PROJECT-ID
  • ...
• BAS_NODE_URL - The JSON RPC URL of the Base node. For example:
  • https://base-rpc.publicnode.com
  • https://mainnet.base.org
  • https://base-mainnet.infura.io/v3/YOUR-PROJECT-ID
  • ...
• CEL_NODE_URL - The JSON RPC URL of the Celo node. For example:
  • https://rpc.ankr.com/celo
  • https://forno.celo.org
  • https://celo-mainnet.infura.io/v3/YOUR-PROJECT-ID
  • ...
• SOL_NODE_URL - The JSON RPC URL of the Solana node. For example:
  • https://api.mainnet-beta.solana.com
  • https://solana-api.projectserum.com
  • https://rpc.ankr.com/solana
  • ...
• SRB_NODE_URL - The JSON RPC URL of the Soroban node. STLR_NODE_URL also required. For example:
  • https://www.quicknode.com/stellar (Soroban JSON RPC by QuickNode)
  • https://www.blockdaemon.com/soroban (Blockdaemon)
  • ...
• STLR_NODE_URL - The JSON RPC URL of the Stellar node. SRB_NODE_URL also required. For example:
  • https://horizon.stellar.org
  • https://stellar-mainnet.rpcpool.com
  • ...
• HEADERS - Headers for the API requests. For example:
  • {"Authorization": "Bearer YOUR-TOKEN"}
• TRON_JSON_RPC - The JSON RPC URL of the Tron node. For example:
  • https://api.trongrid.io/jsonrpc
• JUPITER_URL - The URL of the Jupiter API. For example:
  • https://quote-api.jup.ag/v6

How to get

Run docker image

The easiest way to use the Allbridge Core REST API is to use the existing docker image. You can pull the image from the Docker Hub and run it with the following command:

docker run -p 3000:3000 \
    -e ETH_NODE_URL="https://ethereum-rpc.publicnode.com" \
    -e BSC_NODE_URL="https://bsc-rpc.publicnode.com" \
    -e TRX_NODE_URL="https://tron-rpc.publicnode.com" \
    -e ARB_NODE_URL="https://arbitrum-one-rpc.publicnode.com" \
    -e POL_NODE_URL="https://polygon-bor-rpc.publicnode.com" \
    -e AVA_NODE_URL="https://avalanche-c-chain-rpc.publicnode.com" \
    -e OPT_NODE_URL="https://optimism-rpc.publicnode.com" \
    -e BAS_NODE_URL="https://base-rpc.publicnode.com" \
    -e CEL_NODE_URL="https://rpc.ankr.com/celo" \
    -e SOL_NODE_URL="https://api.mainnet-beta.solana.com" \
    -e SRB_NODE_URL="...soroban rpc node..." \
    -e STLR_NODE_URL="https://horizon.stellar.org" \
    -d allbridge/io.allbridge.rest-api:latest    

or use environment variables from the .env file:

docker run -p 3000:3000 --env-file .env -d allbridge/io.allbridge.rest-api:latest

Build and run the docker image

docker build -t allbridge-core-rest-api .
docker run -p 3000:3000 \
    -e ETH_NODE_URL="https://ethereum-rpc.publicnode.com" \
    -e BSC_NODE_URL="https://bsc-rpc.publicnode.com" \
    -e TRX_NODE_URL="https://tron-rpc.publicnode.com" \
    -e ARB_NODE_URL="https://arbitrum-one-rpc.publicnode.com" \
    -e POL_NODE_URL="https://polygon-bor-rpc.publicnode.com" \
    -e AVA_NODE_URL="https://avalanche-c-chain-rpc.publicnode.com" \
    -e OPT_NODE_URL="https://optimism-rpc.publicnode.com" \
    -e BAS_NODE_URL="https://base-rpc.publicnode.com" \
    -e CEL_NODE_URL="https://rpc.ankr.com/celo" \
    -e SOL_NODE_URL="https://api.mainnet-beta.solana.com" \
    -e SRB_NODE_URL="...soroban rpc node..." \
    -e STLR_NODE_URL="https://horizon.stellar.org" \
    -d allbridge-core-rest-api 

Host on Heroku

If you cannot host Docker, you can use a separate hosting service like Heroku to deploy the REST API.

For detailed instructions on using Heroku's container registry and runtime, see the official guide.

Below is a step-by-step guide on how to do this.

Step-by-Step Guide

1. Sign up for Heroku
   • Heroku Sing Up
2. Install Heroku CLI
   • Follow the instructions here
3. Login to Heroku CLI
   • Run the command: heroku login
   • If you encounter an 'IP address mismatch' error, disabling iCloud Private Relay may help. More details here
4. Ensure Docker is Installed
   • Verify Docker is working by running docker ps
   • Ensure you are logged in to Heroku with heroku login
5. Create a New Heroku App
   • Create a new app on the Heroku dashboard
6. Set Heroku Stack to Container
   • Run the command: heroku stack:set container --app <app-name>

Deploy and release REST-API container

Repeat steps 7-11 to upgrade to a newer REST-API version

7. Login to Heroku Container Registry
   • Run heroku container:login or log in via Docker following these instructions
8. Pull the REST-API Locally
   • Run the command: docker pull --platform linux/amd64 allbridge/io.allbridge.rest-api:<version>
9. Tag the Docker Image
   • Run the command: docker tag allbridge/io.allbridge.rest-api:<version> registry.heroku.com/<app-name>/web
10. Push the Tagged Image to Heroku
    • Run the command: docker push registry.heroku.com/<app-name>/web
11. Release the Container on Heroku
    • Run the command: heroku container:release web --app <app-name>

One-Time Setup (Optional for Updates)

12. Set Configuration Variables
    • Run the commands, like: heroku config:set ETH_NODE_URL=https://ethereum-rpc.publicnode.com --app <app-name>
    • Alternatively, you can set it via the Heroku Dashboard under the app's settings

Final Steps

13. Retrieve the Base URL
    • Find the base URL in the domains section of your app's settings (https://dashboard.heroku.com/apps/<app-name>/settings) on the Heroku Dashboard
    • Or click the button Open App
14. Check API Availability
    • Append /api to the base URL to check the availability of the Swagger

You are now ready to use your rest-api app.

How to use

Swagger

After running the docker image, you can access the swagger documentation at http://localhost:3000/api. The swagger documentation provides a detailed description of the available endpoints and their parameters.

Raw transactions

GET Endpoint	Description
/raw/approve	Creates a Raw Transaction for approving tokens usage by the bridge
/raw/swap	Creates a Raw Transaction for initiating the swap of tokens on one chain
/raw/bridge	Creates a Raw Transaction for initiating the transfer of tokens from one chain to another.
/raw/deposit	Creates a Raw Transaction for depositing tokens to Liquidity pool
/raw/withdraw	Creates a Raw Transaction for withdrawing tokens from Liquidity pool
/raw/claim	Creates a Raw Transaction for claiming rewards from Liquidity pool

Tokens

GET Endpoint	Description
/tokens	Returns a list of supported tokens
/chains	Returns ChainDetailsMap containing a list of supported tokens groped by chain
/token/balance	Get token balance
/token/native/balance	Get native (gas) token balance
/token/details	Get token details
/gas/fee	Fetches possible ways to pay the transfer gas fee
/gas/balance	Get gas balance
/gas/extra/limits	Get possible limit of extra gas amount

Pools

GET Endpoint	Description
/check/allowance	Check if the amount of approved tokens is enough
/pool/info/server	Gets information about the pool-info by token from server
/pool/info/blockchain	Gets information about the pool-info by token from blockchain
/pool/allowance	Get amount of tokens approved for poolInfo
/liquidity/details	Get user balance info on liquidity pool
/liquidity/deposit/calculate	Calculates the amount of LP tokens that will be deposited
/liquidity/withdrawn/calculate	Calculates the amount of tokens will be withdrawn

Transfers

GET Endpoint	Description
/transfer/time	Gets the average time in ms to complete a transfer for given tokens and messenger
/transfer/status	Fetches information about tokens transfer by chosen chainSymbol and transaction Id from the Allbridge Core API
/pending/info	Returns information about pending transactions for the same destination chain and the amount of tokens can be received as a result of transfer considering pending transactions
/swap/details	Show swap amount changes (fee and amount adjustment) during send through pools
/bridge/details	Show bridge amount changes (fee and amount adjustment) during send through pools on source and destination chains
/bridge/receive/calculate	Calculates the amount of tokens to be received as a result of transfer
/bridge/send/calculate	Calculates the amount of tokens to send based on requested tokens amount be received as a result of transfer