Files
proxmox/docs/06-besu/BRIDGE_TESTING_GUIDE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

107 lines
2.1 KiB
Markdown

# Bridge Testing Guide
**Last Updated:** 2026-01-31
**Document Version:** 1.0
**Status:** Active Documentation
---
**Date**: 2025-01-20
**Purpose**: Guide for testing bidirectional bridge functionality
---
## Prerequisites
1. **Bridges Deployed**:
- WETH9 Bridge on ChainID 138
- WETH10 Bridge on ChainID 138
- Corresponding bridges on Ethereum Mainnet
2. **Bridges Configured**:
- Destinations set for both chains
- LINK tokens funded for CCIP fees
3. **Test Tokens**:
- WETH9 tokens for testing
- WETH10 tokens for testing
---
## Testing Procedures
### Test 1: WETH9 Bridge (ChainID 138 → Mainnet)
1. **Lock tokens on ChainID 138**:
```bash
cast send $WETH9_BRIDGE_CHAIN138 \
"lockAndSend(uint64,address,uint256)" \
$MAINNET_SELECTOR \
$RECIPIENT_ADDRESS \
$AMOUNT \
--rpc-url $RPC_URL_138 \
--private-key $PRIVATE_KEY
```
2. **Monitor CCIP message**:
- Check CCIP explorer for message status
- Wait for message to be processed
3. **Verify tokens received on Mainnet**:
```bash
cast call $WETH9_MAINNET \
"balanceOf(address)" \
$RECIPIENT_ADDRESS \
--rpc-url $MAINNET_RPC
```
### Test 2: WETH9 Bridge (Mainnet → ChainID 138)
1. **Lock tokens on Mainnet**:
```bash
cast send $WETH9_BRIDGE_MAINNET \
"lockAndSend(uint64,address,uint256)" \
$CHAIN138_SELECTOR \
$RECIPIENT_ADDRESS \
$AMOUNT \
--rpc-url $MAINNET_RPC \
--private-key $MAINNET_PRIVATE_KEY
```
2. **Monitor CCIP message**
3. **Verify tokens received on ChainID 138**
### Test 3 & 4: WETH10 Bridge
Same procedures as WETH9, using WETH10 bridge addresses.
---
## Expected Results
- ✅ Tokens locked on source chain
- ✅ CCIP message created and sent
- ✅ Message processed by CCIP
- ✅ Tokens minted on destination chain
- ✅ Balances match expected amounts
---
## Troubleshooting
### Messages Stuck
- Check CCIP router status
- Verify destination configuration
- Check LINK token balance on bridge
### Tokens Not Received
- Verify destination address
- Check bridge logs
- Verify CCIP message status
---
**Status**: Ready for testing once bridges are deployed