# 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`](https://etherscan.io/address/0x867a8fcd5bb6774d4d37fb342d669a35ff789a51))
  * Asset custody and transfer
  * Upgradeable by contract replacement
    * V1 implementation: ([`0x2B08D7cF7EafF0f5f6623d9fB09b080726D4be11`](https://etherscan.io/address/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`](https://etherscan.io/address/0x1a84163249b2909f746c725f23d5ae2a66d7c4fe))
    * WITHDRAW\_CANCELLER\_ROLE (fraud nullification / state settlement)
      * Nullifier EOA ([`0x681086b630BC3B5f0bf544FDc2A0FC41Cf8977D3`](https://etherscan.io/address/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`](https://etherscan.io/address/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`](https://eclipsescan.xyz/account/br1xwubggTiEZ6b7iNZUwfA3psygFfaXGfZ1heaN9AW))
  * L2 bridge operations
  * Deposit/withdrawal handling

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eclipse.xyz/architecture/eclipse-architecture/architectural-overview/core-infrastructure/eclipse-canonical-bridge.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.