How fuellabs/fuel-bridge works
Main Components
a. Layer 1 (Ethereum) Components:
• FuelMessagePortal
• FuelChainState
• ERC20Gateway
• ERC721Gateway
• Solidity Contracts Infrastructure
b. Layer 2 (Fuel) Components:
• Bridge Fungible Token Contract
• Message Predicates
• Base Asset Handler
• Contract Message Receiver
c. Bridge Infrastructure:
• Message Passing System
• Block Committer
• Verification Layer
• Ethereum | <-> | Bridge Layer | <-> | Fuel |
• (L1) | | | | (L2) |
Key Relationships to Highlight
a. Message Flow:
• Verification paths through the bridge layer
• Token locking/unlocking mechanisms
b. Contract Interactions:
• Related contracts with appropriate relationship lines
• Inheritance and dependency relationships
• Access control flows
Detailed Component Breakdown
L1 (Ethereum) Side:
• FuelMessagePortal |
• Message Verification |
• State Management |
• Gateway Contracts |
• ERC20 |
• ERC721 |
Bridge Layer:
• Message Predicates |
• Block Committer |
• Verification Logic |
L2 (Fuel) Side:
• Bridge Contracts |
• Token Implementation |
• Message Handling |
Additional Elements
Include:
• Version information for different components
• Security boundaries and trust assumptions
• Rate limiting and pause mechanism indicators
• Deployment environment distinctions (mainnet/testnet)
Technical Details to Note
• Relationship between fungible and non-fungible token bridges
• Message verification paths
• State synchronization mechanisms
• Upgrade proxy patterns where applicable
Special Focus Areas
Emphasize:
• Security checkpoints
• Cross-chain message verification
• Asset locking and unlocking mechanisms
• State consistency maintenance
Documentation Integration
References to:
• Architecture documentation
• Deployment configurations
• Testing infrastructure
• Monitoring systems