Files
smom-dbis-138/docs/operations/integrations/METAMASK_BRIDGE_SWAP.md
defiQUG 1fb7266469 Add Oracle Aggregator and CCIP Integration
- Introduced Aggregator.sol for Chainlink-compatible oracle functionality, including round-based updates and access control.
- Added OracleWithCCIP.sol to extend Aggregator with CCIP cross-chain messaging capabilities.
- Created .gitmodules to include OpenZeppelin contracts as a submodule.
- Developed a comprehensive deployment guide in NEXT_STEPS_COMPLETE_GUIDE.md for Phase 2 and smart contract deployment.
- Implemented Vite configuration for the orchestration portal, supporting both Vue and React frameworks.
- Added server-side logic for the Multi-Cloud Orchestration Portal, including API endpoints for environment management and monitoring.
- Created scripts for resource import and usage validation across non-US regions.
- Added tests for CCIP error handling and integration to ensure robust functionality.
- Included various new files and directories for the orchestration portal and deployment scripts.
2025-12-12 14:57:48 -08:00

196 lines
5.6 KiB
Markdown

# MetaMask Bridge & Swap Support for ChainID 138
Current status and workarounds for Bridge and Swap features on ChainID 138.
## Current Status
ChainID 138 is **not** currently supported in MetaMask's native Swaps and Bridge features. Users must use third-party bridges and DEXs until native support is added.
## Swaps (In-Wallet Aggregator)
### Current Limitation
MetaMask Swaps supports a fixed set of networks:
- Ethereum
- BNB Chain
- Polygon
- Avalanche
- Optimism
- Arbitrum
- zkSync Era
- Linea
- Base
- Sei
ChainID 138 is **not** on this list, so the in-wallet Swaps button will not aggregate quotes natively.
### Workaround: Use DEX UI
Users can swap tokens via DEX UIs that support ChainID 138:
1. **Connect to ChainID 138**: Add network to MetaMask
2. **Navigate to DEX**: Open DEX that supports ChainID 138
3. **Connect Wallet**: Connect MetaMask wallet
4. **Execute Swap**: Execute swap through DEX UI
### Recommended DEXs
List DEXs that support ChainID 138 (to be populated after DEX deployment):
- **DEX 1**: [URL] - Description
- **DEX 2**: [URL] - Description
## Bridge (Portfolio Bridge)
### Current Limitation
MetaMask Portfolio Bridge supports a curated network set:
- Ethereum
- BNB Chain
- Linea
- Polygon
- Arbitrum
- Optimism
- Avalanche
- Base
- zkSync Era
ChainID 138 is **not** currently supported.
### Workaround: Use Third-Party Bridges
Users must bridge via third-party bridges until native support is added.
### Recommended Bridges
List bridges that support ChainID 138 (to be populated after bridge deployment):
- **Bridge 1**: [URL] - Description
- **Bridge 2**: [URL] - Description
### Bridge Integration Requirements
For bridges to work with ChainID 138:
1. **Network Support**: Bridge must support ChainID 138
2. **Liquidity**: Sufficient liquidity on both sides
3. **Security**: Audited bridge contracts
4. **Monitoring**: Bridge monitoring and alerts
## Buy/Sell (Fiat On/Off-Ramp)
### Current Limitation
MetaMask's on-/off-ramp partners only support certain chains/tokens. ChainID 138 assets are not currently supported.
### Workaround: Bridge from Supported Chains
1. **Buy on Supported Chain**: Buy ETH/tokens on a supported chain (Ethereum, etc.)
2. **Bridge to ChainID 138**: Use third-party bridge to bridge to ChainID 138
3. **Use on ChainID 138**: Use bridged assets on ChainID 138
### Alternative: CEX Withdrawal
1. **Buy on CEX**: Buy ETH/tokens on centralized exchange
2. **Withdraw to ChainID 138**: Withdraw directly to ChainID 138 address (if supported)
3. **Use on ChainID 138**: Use withdrawn assets on ChainID 138
### Recommended On-Ramp Partners
List on-ramp partners that support ChainID 138 (to be populated):
- **Partner 1**: [URL] - Description
- **Partner 2**: [URL] - Description
## How to Fund ChainID 138
### Method 1: Bridge from Ethereum
1. **Bridge Provider**: Use a bridge that supports Ethereum → ChainID 138
2. **Connect Wallets**: Connect MetaMask wallets for both chains
3. **Initiate Bridge**: Initiate bridge transaction
4. **Wait for Confirmation**: Wait for bridge confirmation
5. **Receive on ChainID 138**: Receive bridged assets on ChainID 138
### Method 2: CEX Withdrawal
1. **Buy on CEX**: Buy ETH on centralized exchange
2. **Withdraw**: Withdraw to ChainID 138 address (if supported)
3. **Wait for Confirmation**: Wait for withdrawal confirmation
4. **Receive on ChainID 138**: Receive assets on ChainID 138
### Method 3: Peer-to-Peer
1. **Find Seller**: Find someone willing to sell ETH on ChainID 138
2. **Arrange Transfer**: Arrange transfer via trusted method
3. **Receive Assets**: Receive assets on ChainID 138
## Path to Native Support
### Swaps Integration
To enable native Swaps support:
1. **Business Development**: Engage with Consensys for partnership
2. **Liquidity Requirements**: Ensure sufficient liquidity for aggregator
3. **DEX Integration**: Integrate with DEXs on ChainID 138
4. **Testing**: Test swap functionality
5. **Regulatory Compliance**: Ensure regulatory compliance
### Bridge Integration
To enable native Bridge support:
1. **Business Development**: Engage with Consensys for partnership
2. **Bridge Providers**: Partner with bridge providers
3. **Security Audit**: Complete security audit
4. **Testing**: Test bridge functionality
5. **Monitoring**: Set up bridge monitoring
### On-Ramp Integration
To enable native on-ramp support:
1. **Partner Integration**: Partner with on-ramp providers
2. **Regulatory Compliance**: Ensure regulatory compliance
3. **Testing**: Test on-ramp functionality
4. **User Experience**: Optimize user experience
## Business Development
### Consensys Outreach
1. **Initial Contact**: Reach out to Consensys business development
2. **Proposal**: Submit integration proposal
3. **Requirements**: Discuss requirements and timeline
4. **Partnership**: Establish partnership agreement
5. **Implementation**: Implement integration
### Tracking
- Monitor MetaMask feature updates
- Track network support announcements
- Engage with Consensys regularly
- Submit feature requests
## Documentation
### User Guides
- **How to Bridge to ChainID 138**: Step-by-step bridge guide
- **How to Swap on ChainID 138**: Step-by-step swap guide
- **How to Fund ChainID 138**: Funding options guide
### Developer Guides
- **Bridge Integration**: How to integrate bridges
- **DEX Integration**: How to integrate DEXs
- **On-Ramp Integration**: How to integrate on-ramps
## References
- [MetaMask Swaps](https://support.metamask.io/manage-crypto/move-crypto/swap/user-guide-swaps/)
- [MetaMask Portfolio Bridge](https://portfolio.metamask.io/bridge)
- [Consensys Business Development](https://consensys.io)