Eclipse Canonical Bridge
The Eclipse Canonical Bridge is a secure cross-chain bridge between Ethereum (L1) and Eclipse (L2) that provides strong safety guarantees through a three-layer architecture:
The bridge operates through three main components:
Ethereum Contracts: CanonicalBridge handles bridge logic while Treasury provides secure asset custody
Eclipse Program: Manages the L2 side using Solana's native lamport system
Relayer Infrastructure: Monitors both chains for initiating deposits and withdrawals
This separation of concerns, combined with fraud windows and role-based security, ensures safe asset transfers between chains.
Ethereum Contracts
CanonicalBridgeV2 Contract (
0x867A8FcD5Bb6774d4d37fb342D669A35FF789a51)Asset custody and transfer
Upgradeable by contract replacement
V1 implementation: (
0x2B08D7cF7EafF0f5f6623d9fB09b080726D4be11)L1 ledger preservation and replay protection between upgrades
Fraud window mechanics
Role-Based Access Control for operation
WITHDRAW_AUTHORITY_ROLE (trusted relayer)
Trusted relayer EOA (
0x1a84163249b2909f746c725f23d5ae2a66d7c4fe)
WITHDRAW_CANCELLER_ROLE (fraud nullification / state settlement)
Nullifier EOA (
0x681086b630BC3B5f0bf544FDc2A0FC41Cf8977D3)
Role-Based Access Control admin controls
CLAIM_AUTHORITY_ROLE (admin forced claim settlement)
PAUSER_ROLE / STARTER_ROLE
FRAUD_WINDOW_SETTER_ROLE
currently set to 7 days
contract enforced 1 day minimum
Treasury Contract (Proxy:
0xD7E4b67E735733aC98a88F13d087D8aac670E644)Asset management (upgradeable implementation)
Role-Based Access Control for bridge configuration
DEPOSITOR_ROLE (CanonicalBridge contract)
WITHDRAW_AUTHORITY_ROLE (CanonicalBridge contract)
Role-Based Access Control admin controls
EMERGENCY_ROLE
Facilitates emergency withdraw to security council for recovery of funds
PAUSER_ROLE/STARTER_ROLE
UPGRADER_ROLE
Eclipse Program
Canonical Bridge Program (
br1xwubggTiEZ6b7iNZUwfA3psygFfaXGfZ1heaN9AW)L2 bridge operations
Deposit/withdrawal handling
Last updated
Was this helpful?