Smart Contracts
This section introduces the main smart contracts used by Ethera for cross-rollup execution, asset transfer, settlement, and optional smart-account infrastructure.
Not every contract plays the same role. UniversalBridgeMailbox is part of Ethera's coordination model and is foundational to cross-rollup execution. The bridge and settlement contracts documented here are Ethera's provided bridge stack and should be read as the reference implementation, not as the only possible bridge design for an Ethera deployment. This distinction is also reflected in Universal Bridge.
The addresses below reflect the current Ethera Sepolia testnet deployment.
info
For RPC endpoints, explorers, and testing configuration, see the Testnet page.
Universal Bridge Contracts
| Contract | Address | Description |
|---|---|---|
| ComposeL1Bridge | Route to Rollup A: 0xF3504fc6AAB6Da84cc466bB707a109a8824a0c24Route to Rollup B: 0x30Fdb3B0035828372a9Df4D2F6B66CA27529C9B0 | Layer 1-side bridge used for ETH and canonical ERC20 deposits into Ethera rollups |
| L2ComposeBridge | Rollup A: 0xa48CC954531A24c737f496C60daa44ABAd8475abRollup B: 0xcF29d49571A5Cd7350AE27951993e57a89743599 | Rollup-side bridge used for deposits from Layer 1 and withdrawals back to Layer 1 |
| ComposeL2ToL2Bridge | 0x57d93F3E2fD17E3e42A24F113D5728441Bf79cb3 | Rollup-to-rollup bridge entry point for ETH, ERC20, and CET routes |
| ComposePortal | Settlement for Rollup A: 0xbc2e5a158b9d3ea5ff145ea261736ab0ca6517f9Settlement for Rollup B: 0xd32ed6c0a353ae79e087890d0f86d53d78036055 | Layer 1 settlement contract used during the withdrawal prove/finalize lifecycle |
| ComposeERC20Lockbox | 0x1CbEdf99D309489E586f46e7a22e31d1D5d604bf | Layer 1 escrow contract for canonical ERC20 custody |
| ComposeETHLockbox | 0xf6d7e92eddccdf58b4e31acfb967593c46425fd6 | Layer 1 ETH liquidity and custody layer |
| UniversalBridgeMailbox | 0x3455060f6e051161241BcFb19d9dc4048B328A63 | Bridge message transport layer used for cross-rollup message passing |
| ComposeETHLiquidity | 0xe409635040aC4154B8730A8c5e8e7e29a5ABCa07 | ETH liquidity component used by rollup-to-rollup ETH transfers |
Token Contracts
| Contract | Address | Description |
|---|---|---|
| CETFactory | 0x3E42f25a249b51F1822E6aB913BeF666769D87cd | Deterministic deployer for CET token contracts |
| WETH9 | 0xA4cDD1d399555f85c4D55a7E242FA5c330b9aAC2 | Wrapped ETH contract used by the current setup |
Smart Account Infrastructure
| Contract | Address | Description |
|---|---|---|
| EntryPoint | 0x0000000071727De22E5E9d8BAf0edAc6f37da032 | ERC-4337 EntryPoint used by the current SDK setup |
| Kernel | 0xBAC849bB641841b44E965fB01A4Bf5F074f84b4D | Smart-account implementation used by the SDK |
| KernelFactory | 0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419 | Factory used to deploy Kernel accounts |
| MultiChainValidator | 0x37CE732412539644b3d0E959925a4f89edd463c9 | Validator used for the current multi-chain smart-account flow |
Contract Documentation
- Bridge Overview - Bridge contract overview and references
- Mailbox Contract - Mailbox contract reference
- Composable Token Contract - CET token contract reference