Skip to content

Commit 3f74507

Browse files
authored
Merge pull request #1095 from David-282/docs/903-production-runbook-rollback-hotfix
docs(ops): add production runbook for deployment rollback and hotfixe…
2 parents 5ecb104 + 45c2f40 commit 3f74507

1 file changed

Lines changed: 25 additions & 0 deletions

File tree

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Production Runbook: Deployment Rollback & Hotfixes
2+
3+
## 1. Trigger Criteria & Incident Severity
4+
5+
### Severe Incidents (Triggers Rollback or Immediate Hotfix)
6+
- **Financial/State Risk:** Vault balance accounting mismatch, unauthorized yield distribution, or smart contract logic flaw.
7+
- **Service Outage:** Frontend or indexing API down/unresponsive post-deployment.
8+
- **Security Vulnerability:** Exploitable entrypoint or leaked credentials/keys.
9+
10+
### Incident Roles
11+
- **Incident Commander (IC):** Leads response, authorizes pauses or rollbacks.
12+
- **Lead Developer:** Drafts hotfix or executes rollback commands.
13+
- **Verifier:** Runs post-deployment health checks before resolving incident.
14+
15+
---
16+
17+
## 2. Deployment Rollback Procedure
18+
19+
### Phase A: Immediate Emergency Pause (Circuit Breaker)
20+
If the issue affects money movement or contract state, pause the contracts immediately.
21+
22+
1. **Pause YieldVault Contracts:**
23+
```bash
24+
# Run pause script or call pause method via CLI
25+
cargo run -p scripts -- bin/pause_vault --network mainnet

0 commit comments

Comments
 (0)