# Role Change Runbook

## Alerts: RoleGranted, RoleRevoked

### Severity: HIGH

### Description
A role has been granted to or revoked from an address. Roles control access to privileged functions.

### Role Definitions

| Role | Permissions |
|------|------------|
| DEFAULT_ADMIN_ROLE | Grant/revoke all roles, full admin |
| UPGRADER_ROLE | Upgrade contract implementations |
| PAUSER_ROLE | Pause/unpause contract |
| MINTER_ROLE | Mint tokens/licenses |
| ORACLE_ROLE | Update reputation scores |

### Immediate Actions (< 1 hour)

1. **Verify the Change was Authorized**
   - Check if change was via TimelockController
   - Verify the granting/revoking address
   - Confirm recipient is authorized

2. **For GRANT:**
   - Verify recipient address is a known Safe or service
   - Document the role assignment
   - Update access control documentation

3. **For REVOKE:**
   - Verify the revocation was intentional
   - Ensure operational continuity
   - Update access control documentation

### Investigation Checklist

- [ ] Role change initiator verified
- [ ] Recipient/subject address verified
- [ ] Change matches approved access request
- [ ] No suspicious preceding transactions
- [ ] Access control matrix updated

### Common Role Addresses

| Address | Role | Description |
|---------|------|-------------|
| 0x... | Admin | Main multisig |
| 0x... | Upgrader | Upgrade multisig |
| 0x... | Oracle | Reputation oracle service |

### Security Considerations

- DEFAULT_ADMIN_ROLE grants ability to grant all other roles
- UPGRADER_ROLE can change contract code
- Never grant roles to EOAs in production
- Always use timelocked operations for role changes

### Related Runbooks

- [Ownership Change](./ownership-change.md)
- [Upgrade Proposed](./upgrade-proposed.md)
