AeternityGitHub

ÆRC Bridge

The æternity Bridge enables seamless asset transfer between æternity and EVM-compatible blockchains through contracts provided by Acurast. This documentation covers the setup, deployment, and usage of the Bridge interface.

Quick Links Production: https://ae-bridge.com/

Staging: https://bridge.stg.aepps.com/

Installation and Setup

Prerequisites • Node.js • npm • yarn

Local Development Setup

  1. Install dependencies:

yarn

  1. Start development server:

yarn start

Production Build

  1. Build the application:

yarn build

  1. Install serve package (if not already installed):

# Using yarn
yarn global add serve

# Using npm
npm -g install serve

  1. Serve the build:

serve -s build

Self-Hosting Guide

Cloud Deployment You can deploy your own instance of the Bridge interface using various cloud services:

  1. Fork the repository from GitHub

  2. Create an account on your preferred cloud platform: • Vercel • Netlify • AWS • Others

  3. Connect your GitHub account to the cloud platform

  4. Create a new application

  5. Configure using standard Node.js deployment settings

  6. Deploy your instance

Technical Specifications • Primary Language: TypeScript (95.1%) • Secondary Language: JavaScript (3.4%) • License: ISC

Understanding Bridge Mechanics

Token Bridging Process

graph LR
    A[Source Chain] -->|Lock Tokens| B[Bridge Contract]
    B -->|Notify| C[Bridge Service]
    C -->|Release| D[Target Chain]

The bridge operates through a lock-and-mint mechanism:

  1. Tokens are locked in the source chain's bridge contract

  2. Bridge service verifies the lock transaction

  3. Equivalent tokens are released on the target chain

Native Currency Bridging

When bridging native currencies:

  • ETH → æternity: Receives wETH (AEX-9 token)

  • AE → Ethereum: Receives wAE (ERC-20 token)

Security and Verification

The bridge maintains a 1:1 ratio between locked and released assets. You can verify this through:

  • Smart contract inspection on both chains

  • Public contract addresses

  • Real-time bridge statistics

PreviousHyperchains v0.9 Developement Guide

Last updated