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

2.1 KiB

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:

    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:

    cast call $WETH9_MAINNET \
      "balanceOf(address)" \
      $RECIPIENT_ADDRESS \
      --rpc-url $MAINNET_RPC
    

Test 2: WETH9 Bridge (Mainnet → ChainID 138)

  1. Lock tokens on Mainnet:

    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