50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
|
# Tezos CCIP DON and Cross-Chain Runbooks Index
|
||
|
|
|
||
|
|
**Purpose**: Single index for all runbooks related to Tezos L1, Etherlink, Jumper/LiFi fallback, and incident response. Use this for ops and go-live.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 1. Tezos L1
|
||
|
|
|
||
|
|
- **Tezos L1 relay**: `smom-dbis-138/docs/bridge/TEZOS_L1_RELAY_RUNBOOK.md` — Operating the off-chain relay (event schema, confirmTransaction, oracle key, Tezos-side mint/transfer).
|
||
|
|
- **Tezos E2E**: `smom-dbis-138/docs/bridge/TEZOS_E2E_RUNBOOK.md` — End-to-end testing on Ghostnet and mainnet.
|
||
|
|
- **Tezos deployment**: `docs/03-deployment/TEZOS_BRIDGE_DEPLOYMENT.md` — Deploying TezosAdapter and Tezos bridging.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. Etherlink
|
||
|
|
|
||
|
|
- **Etherlink relay (custom)**: `smom-dbis-138/docs/bridge/ETHERLINK_RELAY_RUNBOOK.md` — When CCIP does not support Etherlink: custom relay path, receiver interface, env.
|
||
|
|
- **Etherlink DON (if CCIP)**: `docs/07-ccip/TEZOS_ETHERLINK_DON_CONFIG.md` — When Etherlink is on CCIP: chain selector, DON config.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 3. Routing and fallback
|
||
|
|
|
||
|
|
- **Jumper vs LiFi route selection**: `alltra-lifi-settlement/docs/ROUTE_SELECTION_JUMPER_LIFI.md` — Route selection logic (Jumper, LiFi, direct adapter/CCIP).
|
||
|
|
- **Jumper support matrix**: `docs/07-ccip/TEZOS_JUMPER_SUPPORT_MATRIX.md` — Which chains Jumper supports; fallback to LiFi or direct.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 4. Incident response and operations
|
||
|
|
|
||
|
|
- **Incident response**: `docs/runbooks/INCIDENT_RESPONSE_RUNBOOK.md` — Bridge incidents: classification, detection, assessment, mitigation.
|
||
|
|
- **Upgrade and pause**: `smom-dbis-138/docs/bridge/UPGRADE_AND_PAUSE_RUNBOOKS.md` — Contract upgrades, pause procedures for bridges and adapters.
|
||
|
|
- **Multi-chain execution incident**: `docs/runbooks/MULTI_CHAIN_EXECUTION_INCIDENT_RESPONSE.md` — Cross-chain message and execution incidents.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 5. Monitoring and production
|
||
|
|
|
||
|
|
- **Tezos/Etherlink monitoring**: `docs/08-monitoring/TEZOS_ETHERLINK_BRIDGE_MONITORING.md` — Dashboards, alerts, failures, duplicates, large transfers.
|
||
|
|
- **Production config**: `docs/07-ccip/TEZOS_ETHERLINK_PRODUCTION_CONFIG.md` — Feature flags, rate limits, caps, go-live checklist.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Quick reference
|
||
|
|
|
||
|
|
- **Tezos relay down or failing**: TEZOS_L1_RELAY_RUNBOOK then INCIDENT_RESPONSE_RUNBOOK.
|
||
|
|
- **Etherlink relay down or failing**: ETHERLINK_RELAY_RUNBOOK then INCIDENT_RESPONSE_RUNBOOK.
|
||
|
|
- **Route selection / Jumper vs LiFi**: ROUTE_SELECTION_JUMPER_LIFI and TEZOS_JUMPER_SUPPORT_MATRIX.
|
||
|
|
- **Security or upgrade**: UPGRADE_AND_PAUSE_RUNBOOKS and TEZOS_ETHERLINK_PRODUCTION_CONFIG.
|