How multiversx/mx-bridge-eth-sc-rs works
Main Components
a) Core Bridge Components:
• MultiversX Blockchain Side
• Bridged Tokens Wrapper Contract
• ESDT Safe Contract
• Multi-Transfer ESDT Contract
• Bridge Proxy Contract
• Multisig Contract (for governance)
• Price Aggregator Contract
• Ethereum Blockchain Side (reference only, not in this repo)
• ERC20 Contract
• Bridge Contract
b) Supporting Components:
• Relayer Network
• Fee Estimation System
• Transaction Batch Processing System
Key Relationships to Highlight
a) Token Flow:
• Cross-chain token movement paths
• Token locking/unlocking mechanisms
b) Control Flow:
• Multisig validation process
• Relayer interaction paths
• Fee calculation and distribution
Technical Details
• Smart Contract Interactions:
• EsdtSafe ↔ MultiTransferEsdt
• BridgedTokensWrapper ↔ Bridge Proxy
• Price Aggregator integration points
• Common Modules (from /common directory):
• Fee Estimator
• Transaction Processing
• Token Management
• Batch Processing
Implementation Notes
• Use standardized UML notation where applicable
• Notes for critical processes
• Version/upgrade paths
• Integration points with external systems
Specific Flows to Highlight
a) MultiversX to Ethereum:
Final execution
b) Ethereum to MultiversX: