Skip to main content

Overview

The Atlas Bridge is a secure cross-chain messaging system that enables asset transfers between the Ethereum network and Atlas L2. The bridge implements a two-sided architecture with smart contracts on both chains:

  • Ethereum network: Solidity smart contracts using the UUPS (Universal Upgradeable Proxy Standard) pattern
  • Atlas L2: An SVM program that handles SPL token operations
warning

There is currently no publicly available tooling to interact with the Atlas Bridge. For the time being, please use the testnet faucet CLI or the UI testnet faucet to get Sepolia ETH on Atlas.

Bridge UI and CLI tool will be available to use in the near future.

Key Components​

Ethereum L1​

Bridge Contract​

The entrypoint contract that handles asset transfers between L1 and L2:

  • Handles deposit initiation for ETH and ERC20 tokens
  • Built-in security features including reentrancy protection, pausability, and upgradeability
  • Interacts with Atlas Oracle to verify withdrawal proofs
  • Implements withdrawal finalization and asset transfer

Mailbox Contract​

Facilitates cross-chain communication from L1 to L2:

  • Handles generic message passing to Atlas
  • Emits deposit messages to initiate deposits

Atlas Oracle Contract​

Manages the state commitments from L2 to L1:

  • Posts L2 state root and withdrawal root to L1
  • Enforces finalization periods for security
  • Handles state challenges and updates

Atlas L2​

Bridge SPL Program​

A native SVM program that manages the L2 side of the bridge:

  • Handles deposit processing and finalization
  • Manages token accounts and mint authorities
  • Tracks EVM state for cross-chain synchronization
  • Implements secure withdrawal initiation

Deployments​

Sepolia Testnet​

Atlas Testnet​

Security Features​

  • Multi-stage withdrawal process with verification
  • Finalization periods to allow for challenge/response
  • Merkle proof verification for withdrawal validation
  • Upgradeable architecture for future improvements
  • Pausable operations for emergency scenarios
  • Strict access controls and ownership management

For detailed information about deposits and withdrawals, please refer to their respective documentation pages.