# Contract Paused Runbook

## Alert: ContractPaused

### Severity: HIGH

### Description
A contract has been paused, stopping all user operations. This could be a security response or routine maintenance.

### Immediate Actions (< 1 hour)

1. **Identify the Cause**
   - Was this a planned pause? Check maintenance schedule
   - Was this an emergency pause? Check for preceding security alerts
   - Who initiated the pause? Verify authorized pauser

2. **If PLANNED Maintenance:**
   - Confirm maintenance window was communicated
   - Verify expected duration
   - Monitor for successful completion

3. **If EMERGENCY Pause:**
   - Escalate to security team immediately
   - Begin incident response procedure
   - Prepare user communication

### Investigation Checklist

- [ ] Pause initiator identified
- [ ] Reason for pause documented
- [ ] Duration estimated
- [ ] User communication prepared (if needed)
- [ ] Monitoring for related issues

### Communication Template

```
[MAINTENANCE NOTICE]

The [Contract Name] is temporarily paused for [reason].

Expected Duration: [X hours]
Status Updates: [link to status page]

Your funds are safe. All operations will resume once maintenance is complete.

For urgent issues: [support link]
```

### Unpause Checklist

Before unpausing, verify:
- [ ] Root cause addressed (if security-related)
- [ ] Testing completed on testnet
- [ ] Team consensus reached
- [ ] Communication ready for users

### Related Runbooks

- [Contract Unpaused](./contract-unpaused.md)
- [Ownership Change](./ownership-change.md)
- [Incident Response Plan](./incident-response.md)
