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.
This commit is contained in:
defiQUG
195
docs/operations/integrations/METAMASK_BRIDGE_SWAP.md
Normal file
195
docs/operations/integrations/METAMASK_BRIDGE_SWAP.md
Normal file
@@ -0,0 +1,195 @@
|
||||
# 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)
|
||||
|
||||
Reference in New Issue
Block a user