proxmox/docs/archive/root-status-reports/BRIDGE_NEXT_STEPS.md

Bridge Next Steps and Requirements

Complete Checklist to Begin Bridging

Date: 2025-01-27
Status: ✅ READY TO USE

---

✅ Infrastructure Status (Complete)

• All bridges deployed and verified
• All destinations configured and enabled
• All tests passing (8/8 - 100%)
• All contracts functional
• RPC endpoints accessible

---

Prerequisites Checklist

1. Environment Variables ✅

Already Set:

• ✅ PRIVATE_KEY - Set in .env
• ✅ RPC_URL_138 - http://192.168.11.211:8545
• ✅ RPC_URL_MAINNET - https://eth.llamarpc.com

2. Wallet Balances

Current Status:

• ✅ ChainID 138 ETH: 999,610,163+ ETH (sufficient)
• ✅ ChainID 138 LINK: 999,979 LINK (sufficient)
• ✅ Mainnet ETH: 0.002 ETH (sufficient for testing)

For Production Bridging:

• Ensure sufficient ETH for gas fees
• Ensure sufficient LINK for CCIP fees (1-2 LINK per transfer)
• Wrap ETH to WETH9 if needed (or have WETH9 balance)

3. Token Approvals

Can be done automatically by scripts, but verify:

• WETH9 approval for bridge (max uint256 recommended)
• LINK approval for bridge (max uint256 recommended)

Check approvals:

# WETH9 approval
cast call 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  "allowance(address,address)" \
  0x4A666F96fC8764181194447A7dFdb7d471b301C8 \
  0x89dd12025bfCD38A168455A44B400e913ED33BE2 \
  --rpc-url http://192.168.11.211:8545

# LINK approval
cast call 0x362E9a45Ef6e554760f9671938235Cbc9b6E80Ed \
  "allowance(address,address)" \
  0x4A666F96fC8764181194447A7dFdb7d471b301C8 \
  0x89dd12025bfCD38A168455A44B400e913ED33BE2 \
  --rpc-url http://192.168.11.211:8545

---

Quick Start: Begin Bridging

Step 1: Verify Prerequisites

cd /home/intlc/projects/proxmox/smom-dbis-138

# Test RPC connectivity
cast block-number --rpc-url http://192.168.11.211:8545
cast block-number --rpc-url https://eth.llamarpc.com

# Check balances (optional)
./scripts/testing/test-all-bridges.sh

Step 2: Run Test Transfer (Recommended First)

# Bridge small amount to test
./scripts/wrap-and-bridge-weth9-to-mainnet.sh \
  0.001 \
  0x4A666F96fC8764181194447A7dFdb7d471b301C8

What happens:

1. Checks ETH and WETH9 balances
2. Wraps ETH to WETH9 if needed
3. Approves bridge if needed
4. Approves LINK if needed
5. Calculates CCIP fee
6. Sends bridge transaction
7. Returns transaction hash

Step 3: Monitor Transfer

1. Transaction Hash: Check on ChainID 138 explorer

   • URL: https://explorer.d-bis.org/tx/<tx_hash>

2. Wait for CCIP: Typically 1-5 minutes

3. Verify Receipt: Check WETH9 balance on Mainnet

   cast call 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
     "balanceOf(address)" \
     0x4A666F96fC8764181194447A7dFdb7d471b301C8 \
     --rpc-url https://eth.llamarpc.com
   

Step 4: Scale Up

Once test succeeds, proceed with larger amounts.

---

Complete Requirements Summary

Minimum Requirements

Item	Status	Notes
Private Key	✅ Set	In .env file
RPC Access	✅ Working	Both chains accessible
ETH Balance	✅ Sufficient	999M+ ETH on ChainID 138
LINK Balance	✅ Sufficient	999K+ LINK on ChainID 138
Bridge Deployed	✅ Complete	All bridges verified
Destinations	✅ Configured	All enabled
Approvals	⚠️ Check	Can be done automatically

For Each Transfer

1. Amount to Bridge: Decide how much WETH9 to bridge
2. Recipient Address: Mainnet address to receive WETH9
3. Gas Fees: ~0.01 ETH for all transactions
4. CCIP Fees: 0.1-2 LINK (calculated automatically)

---

Bridge Options

Option 1: WETH9 Bridge (Recommended)

ChainID 138 → Mainnet:

• Bridge: 0x89dd12025bfCD38A168455A44B400e913ED33BE2
• Script: ./scripts/wrap-and-bridge-weth9-to-mainnet.sh

Mainnet → ChainID 138:

• Bridge: 0x2A0840e5117683b11682ac46f5CF5621E67269E3
• Manual: Use cast send with sendCrossChain()

Option 2: WETH10 Bridge

ChainID 138 → Mainnet:

• Bridge: 0xe0E93247376aa097dB308B92e6Ba36bA015535D0
• Manual: Use cast send with sendCrossChain()

Mainnet → ChainID 138:

• Bridge: 0x8078A09637e47Fa5Ed34F626046Ea2094a5CDE5e
• Manual: Use cast send with sendCrossChain()

---

Step-by-Step Process

Automated (Easiest)

# 1. Navigate to project
cd /home/intlc/projects/proxmox/smom-dbis-138

# 2. Set recipient (optional, defaults to sender)
RECIPIENT="0xYourMainnetAddress"

# 3. Run bridge script
./scripts/wrap-and-bridge-weth9-to-mainnet.sh 0.1 "$RECIPIENT"

# 4. Monitor transaction
# Check explorer: https://explorer.d-bis.org/tx/<tx_hash>

# 5. Verify receipt (after 1-5 minutes)
cast call 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 \
  "balanceOf(address)" \
  "$RECIPIENT" \
  --rpc-url https://eth.llamarpc.com

Manual Process

See docs/operations/BRIDGE_START_GUIDE.md for detailed manual steps.

---

Contract Addresses Quick Reference

ChainID 138

• WETH9 Bridge: 0x89dd12025bfCD38A168455A44B400e913ED33BE2
• WETH10 Bridge: 0xe0E93247376aa097dB308B92e6Ba36bA015535D0
• WETH9 Token: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
• LINK Token: 0x362E9a45Ef6e554760f9671938235Cbc9b6E80Ed

Mainnet

• WETH9 Bridge: 0x2A0840e5117683b11682ac46f5CF5621E67269E3
• WETH10 Bridge: 0x8078A09637e47Fa5Ed34F626046Ea2094a5CDE5e
• WETH9 Token: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
• LINK Token: 0x514910771AF9Ca656af840dff83E8264EcF986CA

Chain Selectors

• Mainnet: 5009297550715157269

---

First Transfer Checklist

• Verify RPC endpoints accessible
• Check wallet balances (ETH, WETH9, LINK)
• Test with small amount (0.001-0.01 ETH)
• Run bridge script or manual commands
• Monitor transaction on source chain
• Wait for CCIP confirmation (1-5 minutes)
• Verify receipt on destination chain
• Scale up to larger amounts

---

Troubleshooting

Common Issues

1. "Insufficient balance"

   • Check ETH, WETH9, and LINK balances
   • Ensure sufficient for amount + fees

2. "Approval needed"

   • Scripts handle this automatically
   • Or approve manually (see guide)

3. "Destination not enabled"

   • ✅ Already fixed - all destinations enabled

4. "CCIP fee too high"

   • Check LINK balance
   • Verify fee calculation

---

Documentation

• Complete Guide: docs/operations/BRIDGE_START_GUIDE.md
• Master Reference: docs/BRIDGE_MASTER_REFERENCE.md
• Address Reference: config/BRIDGE_ADDRESSES_MASTER.md
• Test Results: docs/testing/BRIDGE_TEST_REPORT.md

---

Summary

✅ Ready Now

• All infrastructure complete
• All bridges functional
• All tests passing
• All prerequisites met (except optional approvals)

🚀 To Begin

1. Test Transfer: Run with small amount (0.001 ETH)
2. Monitor: Watch transaction and CCIP confirmation
3. Verify: Check receipt on destination chain
4. Scale: Proceed with larger amounts

You're ready to start bridging! 🎉

---

Last Updated: 2025-01-27