# Fee Change Runbook

## Alert: PlatformFeeUpdated

### Severity: HIGH

### Description
The platform fee percentage has been changed. This affects the fee collected on all future transactions.

### Immediate Actions (< 1 hour)

1. **Verify the Change was Authorized**
   - Check if change was via TimelockController (48h delay required)
   - Verify the initiating address
   - Confirm new fee matches approved governance proposal

2. **If UNAUTHORIZED:**
   - Immediately pause affected contracts
   - Alert security team
   - Begin incident response

3. **If AUTHORIZED:**
   - Document the fee change
   - Update user-facing documentation
   - Notify affected users if significant change

### Investigation Checklist

- [ ] Change initiator verified
- [ ] Fee change matches governance proposal
- [ ] Timelock delay was observed
- [ ] User notification prepared (if needed)
- [ ] Documentation updated

### Fee Parameters

| Parameter | Typical Range | Max Allowed |
|-----------|---------------|-------------|
| Platform Fee | 2-5% | 10% |
| Creator Royalty | 5-10% | 25% |

### User Communication Template

```
[FEE UPDATE NOTICE]

The platform fee has been updated from [OLD]% to [NEW]%.

Effective: [Date]
Reason: [Brief explanation]

This change was approved through governance proposal #[X].

For questions: [support link]
```

### Related Runbooks

- [Treasury Change](./treasury-change.md)
- [Ownership Change](./ownership-change.md)
