# 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.