Eve library

Ownership Change Runbook

Runbook

Revision 1

On this page

Alert: OwnershipTransferred#

Severity: CRITICAL#

Description#

Contract ownership has been transferred to a new address. This is a critical security event as the owner has administrative privileges over the contract.

Immediate Actions (< 5 minutes)#

  1. Verify the Transfer was Authorized

    • Check if the transfer was scheduled through the TimelockController
    • Verify the new owner address is a known Safe or authorized address
    • Contact the on-call security lead
  2. If UNAUTHORIZED:

    • Immediately pause ALL affected contracts
    • Alert entire security team via emergency channel
    • Begin incident response procedure (see Incident Response Plan)
  3. If AUTHORIZED:

    • Confirm the transfer completed successfully
    • Update the contract registry with new owner
    • Close the alert

Investigation Checklist#

  • Check transaction hash and sender
  • Verify new owner address against authorized list
  • Check if preceded by TimelockController schedule event
  • Review recent role changes on the contract
  • Check for any suspicious transactions before/after

Recovery Actions (if compromised)#

  1. Pause all contracts immediately
  2. Revoke all roles from compromised addresses
  3. Transfer remaining funds to emergency multisig
  4. Notify users via official channels
  5. Begin forensic investigation

Contacts#

  • Security Lead: @security-lead
  • Smart Contract Team: #smart-contracts
  • Emergency Hotline: [REDACTED]