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>
161 lines
3.1 KiB
Markdown
161 lines
3.1 KiB
Markdown
# Bridge Operations Runbook
|
|
|
|
**Last Updated:** 2026-01-31
|
|
**Document Version:** 1.0
|
|
**Status:** Active Documentation
|
|
|
|
---
|
|
|
|
**Purpose**: Step-by-step procedures for common bridge operations
|
|
|
|
---
|
|
|
|
## 🔄 Bridge Transfer Procedure
|
|
|
|
### Standard Transfer
|
|
|
|
1. **Check System Status**
|
|
```bash
|
|
bash scripts/health-check.sh
|
|
```
|
|
|
|
2. **Verify Balances**
|
|
```bash
|
|
bash scripts/check-bridge-status.sh
|
|
```
|
|
|
|
3. **Estimate Fees**
|
|
```bash
|
|
bash scripts/fee-management.sh estimate
|
|
```
|
|
|
|
4. **Execute Transfer**
|
|
```bash
|
|
bash scripts/bridge-with-dynamic-gas.sh weth9 1.0 bsc
|
|
```
|
|
|
|
5. **Monitor Transfer**
|
|
```bash
|
|
bash scripts/monitor-bridge-transfers.sh <transaction_hash>
|
|
```
|
|
|
|
---
|
|
|
|
## 🚨 Emergency Procedures
|
|
|
|
### Pause Bridge Operations
|
|
|
|
1. **Access Bridge Contract**
|
|
```bash
|
|
cast send <BRIDGE_ADDRESS> "pause()" --rpc-url $RPC_URL --private-key $PRIVATE_KEY
|
|
```
|
|
|
|
2. **Verify Pause**
|
|
```bash
|
|
cast call <BRIDGE_ADDRESS> "paused()" --rpc-url $RPC_URL
|
|
```
|
|
|
|
3. **Resume Operations**
|
|
```bash
|
|
cast send <BRIDGE_ADDRESS> "unpause()" --rpc-url $RPC_URL --private-key $PRIVATE_KEY
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 Troubleshooting
|
|
|
|
### Transaction Stuck
|
|
|
|
1. **Check Transaction Status**
|
|
```bash
|
|
cast tx <transaction_hash> --rpc-url $RPC_URL
|
|
```
|
|
|
|
2. **Retry with Higher Gas**
|
|
```bash
|
|
bash scripts/retry-failed-transactions.sh
|
|
```
|
|
|
|
3. **Check Nonce**
|
|
```bash
|
|
cast nonce <address> --rpc-url $RPC_URL
|
|
```
|
|
|
|
### Low Balance
|
|
|
|
1. **Check Balances**
|
|
```bash
|
|
bash scripts/check-bridge-status.sh
|
|
```
|
|
|
|
2. **Add Funds**
|
|
- Transfer ETH to deployer address
|
|
- Transfer LINK tokens if needed
|
|
|
|
### RPC Issues
|
|
|
|
1. **Test RPC Connectivity**
|
|
```bash
|
|
cast block-number --rpc-url $RPC_URL
|
|
```
|
|
|
|
2. **Check RPC Health**
|
|
```bash
|
|
bash scripts/health-check.sh
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Monitoring
|
|
|
|
### Daily Checks
|
|
|
|
```bash
|
|
# Run automated monitoring
|
|
bash scripts/automated-monitoring.sh
|
|
|
|
# Generate daily report
|
|
bash scripts/generate-bridge-report.sh daily
|
|
```
|
|
|
|
### Weekly Review
|
|
|
|
```bash
|
|
# Generate weekly report
|
|
bash scripts/generate-bridge-report.sh weekly
|
|
|
|
# Run test suite
|
|
bash scripts/test-suite.sh all
|
|
```
|
|
|
|
---
|
|
|
|
## 🌐 Chain138 / ALL Mainnet → Tezos USDtz
|
|
|
|
### Bridge Provider Status Matrix
|
|
|
|
| Provider | Chains | Status |
|
|
|----------|--------|--------|
|
|
| CCIP | 138 ↔ 1 | active |
|
|
| AlltraAdapter | 651940 ↔ 1 | active |
|
|
| Wrap Protocol | 1 → Tezos | active |
|
|
| Hop Protocol | ETH ↔ L2 | active (explorer aggregator) |
|
|
|
|
### Stuck Tx / Failure Recovery
|
|
|
|
1. **Check audit trail**: `GET /v1/audit/:executionId` for hop status.
|
|
2. **Identify failed hop**: Compare `chain_id` and `step_type` in audit vs route_plan.
|
|
3. **CCIP 138→1**: Check CCIP explorer for message status; resubmit if expired.
|
|
4. **ETH→Tezos**: Verify Wrap Protocol dashboard; check Tezos RPC health.
|
|
5. **Quote drift**: Re-run `POST /v1/routes/chain138-to-usdtz` with `async_quotes: true` for fresh quotes.
|
|
|
|
### Monitoring
|
|
|
|
- Quote-to-execution drift: compare `min_amount_out` in route vs final delivery.
|
|
- Bridge completion time: track `submitted` → `confirmed` per hop.
|
|
|
|
---
|
|
|
|
**Last Updated**: 2026-02-01
|
|
|