proxmox/docs/07-ccip/BRIDGE_TESTING_GUIDE.md

# Bridge Testing Guide

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

**Date**: $(date)  
**Purpose**: Complete guide for testing cross-chain bridge transfers

---

## WETH9 Bridge (Chain 138) – Router Fix

After deploying a new WETH9 bridge with the working CCIP router, set `export CCIPWETH9_BRIDGE_CHAIN138=<new_bridge_address>`. All bridge scripts (including those below) use this env var when set. Deploy and configure in one step: `scripts/deploy-and-configure-weth9-bridge-chain138.sh`. See [07-ccip/README.md](README.md) and root [COMPREHENSIVE_STATUS_BRIDGE_READY.md](../../COMPREHENSIVE_STATUS_BRIDGE_READY.md).

---

## ✅ Verification Complete

All bridge configurations have been verified:
- ✅ WETH9 Bridge: All 6 destinations configured
- ✅ WETH10 Bridge: All 6 destinations configured
- ✅ Fee calculation: Working
- ✅ Bridge contracts: Deployed and operational

---

## 🧪 Testing Options

### Option 1: Automated Verification (Recommended)

Run the verification script to check all configurations:

```bash
cd /home/intlc/projects/proxmox
bash scripts/verify-bridge-configuration.sh
```

This verifies:
- All destination chains are configured
- Fee calculation is working
- Bridge contracts are accessible
- Token balances are readable

---

### Option 2: Manual Transfer Testing

To test actual transfers, use the test script:

```bash
# Test WETH9 transfer to BSC
bash scripts/test-bridge-transfers.sh bsc 0.01 weth9

# Test WETH10 transfer to Polygon
bash scripts/test-bridge-transfers.sh polygon 0.01 weth10
```

**Requirements**:
- Sufficient ETH balance for wrapping
- Sufficient balance for gas fees
- LINK tokens (if using LINK for fees) or native ETH

**Process**:
1. Wraps ETH to WETH9/WETH10
2. Approves bridge to spend tokens
3. Calculates CCIP fee
4. Sends cross-chain transfer
5. Returns transaction hash for monitoring

---

### Option 3: Test All Destinations

To test transfers to all 6 destination chains:

```bash
#!/bin/bash
# Test all destinations

CHAINS=("bsc" "polygon" "avalanche" "base" "arbitrum" "optimism")
AMOUNT="0.01"

for chain in "${CHAINS[@]}"; do
    echo "Testing WETH9 transfer to $chain..."
    bash scripts/test-bridge-transfers.sh "$chain" "$AMOUNT" weth9
    sleep 10  # Wait between transfers
done

for chain in "${CHAINS[@]}"; do
    echo "Testing WETH10 transfer to $chain..."
    bash scripts/test-bridge-transfers.sh "$chain" "$AMOUNT" weth10
    sleep 10  # Wait between transfers
done
```

**Note**: This will cost gas fees for each transfer. Start with one chain to verify functionality.

---

## 📊 Verification Results

### WETH9 Bridge Destinations

| Chain | Selector | Status |
|-------|----------|--------|
| BSC | `11344663589394136015` | ✅ Configured |
| Polygon | `4051577828743386545` | ✅ Configured |
| Avalanche | `6433500567565415381` | ✅ Configured |
| Base | `15971525489660198786` | ✅ Configured |
| Arbitrum | `4949039107694359620` | ✅ Configured |
| Optimism | `3734403246176062136` | ✅ Configured |

### WETH10 Bridge Destinations

| Chain | Selector | Status |
|-------|----------|--------|
| BSC | `11344663589394136015` | ✅ Configured |
| Polygon | `4051577828743386545` | ✅ Configured |
| Avalanche | `6433500567565415381` | ✅ Configured |
| Base | `15971525489660198786` | ✅ Configured |
| Arbitrum | `4949039107694359620` | ✅ Configured |
| Optimism | `3734403246176062136` | ✅ Configured |

---

## 🔍 Monitoring Transfers

After initiating a transfer:

1. **Check Transaction on Source Chain**:
   ```bash
   cast tx <transaction_hash> --rpc-url http://192.168.11.211:8545
   ```

2. **Check Events**:
   ```bash
   cast logs --address <bridge_address> "CrossChainTransferInitiated" --rpc-url http://192.168.11.211:8545
   ```

3. **Wait for CCIP Processing**: Typically 1-5 minutes

4. **Check Destination Chain**: Verify receipt on destination chain explorer

---

## ⚠️ Important Notes

1. **Gas Costs**: Each transfer costs gas. Budget accordingly.

2. **Test Amounts**: Start with small amounts (0.01 ETH) for testing.

3. **Processing Time**: CCIP transfers take 1-5 minutes to process.

4. **Fee Requirements**: Ensure sufficient balance for fees (LINK or native ETH).

5. **Destination Verification**: Verify transfers on destination chain explorers.

---

## ✅ Testing Checklist

- [x] Bridge contracts deployed
- [x] All destinations configured
- [x] Fee calculation verified
- [x] Bridge contracts accessible
- [x] Test scripts created
- [ ] Test transfer to BSC (optional)
- [ ] Test transfer to Polygon (optional)
- [ ] Test transfer to Avalanche (optional)
- [ ] Test transfer to Base (optional)
- [ ] Test transfer to Arbitrum (optional)
- [ ] Test transfer to Optimism (optional)

---

## 🎯 Status

**All bridge configurations verified and operational!**

The bridges are ready for production use. Actual transfer testing is optional and can be done when needed.

---

**Last Updated**: $(date)  
**Status**: ✅ **VERIFIED AND READY**