Eve library

Role Change Runbook

Runbook

Revision 1

On this page

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