fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- 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>
2.6 KiB
2.6 KiB
Comprehensive Troubleshooting Guide
Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation
Purpose: Common issues and solutions for bridge operations
❌ Common Errors
"Execution reverted"
Cause: Transaction reverted by contract logic
Solutions:
- Check contract state
- Verify parameters
- Check allowances
- Verify balances
Debug:
cast call <CONTRACT> "<function>" <args> --rpc-url $RPC_URL
"Insufficient funds"
Cause: Not enough ETH for gas or LINK for fees
Solutions:
-
Check ETH balance
cast balance <address> --rpc-url $RPC_URL -
Check LINK balance
cast call <LINK_TOKEN> "balanceOf(address)" <address> --rpc-url $RPC_URL -
Add funds if needed
"Nonce too low"
Cause: Transaction nonce is lower than current nonce
Solutions:
-
Check current nonce
cast nonce <address> --rpc-url $RPC_URL -
Wait for pending transactions
-
Use correct nonce
"Replacement transaction underpriced"
Cause: Pending transaction with lower gas price
Solutions:
- Wait for pending transaction
- Use higher gas price
- Cancel pending transaction (if possible)
"Destination not enabled"
Cause: Destination chain not configured on bridge
Solutions:
-
Verify destination configuration
cast call <BRIDGE> "destinations(uint64)" <SELECTOR> --rpc-url $RPC_URL -
Configure destination if missing
bash scripts/configure-bridge-destinations.sh
"Gas price below minimum"
Cause: Gas price too low for network
Solutions:
-
Get current gas price
cast gas-price --rpc-url $RPC_URL -
Use higher gas price (1.2x-1.5x current)
bash scripts/bridge-with-dynamic-gas.sh
🔍 Debugging Steps
1. Check System Status
bash scripts/health-check.sh
2. Check Transaction Status
cast tx <tx_hash> --rpc-url $RPC_URL
3. Check Logs
tail -100 logs/alerts-$(date +%Y%m%d).log
4. Run Test Suite
bash scripts/test-suite.sh all
5. Check Recent Events
bash scripts/monitor-bridge-transfers.sh
🛠️ Advanced Troubleshooting
Transaction Stuck
- Check transaction status
- Check nonce
- Retry with higher gas
- Consider canceling if possible
Contract Not Found
- Verify contract address
- Check network
- Verify contract deployment
RPC Issues
- Test RPC connectivity
- Check RPC logs
- Try backup RPC endpoint
Last Updated: $(date)