Skip to Content
ContractsContract ReferenceAdmin

Admin

Draft. The contract that defines roles and protocol-level configuration.

Purpose

The Admin contract establishes Akkadia’s role structure. It defines who can perform administrative actions, operate the protocol, and receive fees. All other contracts reference the Admin contract for permission checks.

Key Concepts

Role Hierarchy

Akkadia uses a four-role model:

  • Admin - The protocol owner with full control. Can transfer ownership, assign other roles, and modify any protocol setting.
  • Operator - Handles operational tasks: minting ACR tokens, setting chunk verifiers, and deleting personal worlds when needed. Multiple operators can be registered simultaneously.
  • Fee Collector - Receives a portion of protocol fees from world creation and expansion (default 5%).
  • Protocol - Receives the remaining portion of protocol fees (default 95%). This address accumulates funds for protocol development and maintenance.

Separation of Concerns

The role separation ensures:

  • Admin changes are rare and deliberate (ownership transfers, role reassignments)
  • Operators can run day-to-day operations without full admin access
  • Fee distribution can be directed to different addresses as needed

What’s On-Chain

  • Current addresses for Admin, Operator, Fee Collector, and Protocol roles
  • Explorer URL for generating on-chain links
  • Transfer and configuration events for audit trails

Capabilities

For Admin

  • Transfer admin role to a new address
  • Set and unset Operators, Fee Collector, and Protocol addresses
  • Configure the explorer URL

For Operator

  • Mint ACR tokens to players
  • Set chunk verifiers for data integrity
  • Delete personal worlds (emergency cleanup)

For Other Contracts

  • Query current role addresses (GetAdmin, GetOperators, GetFeeCollector, GetProtocol)
  • Check role membership (IsAdmin, IsOperator, IsFeeCollector, IsProtocol)
Last updated on
OverviewPersonal World
Docsv1.0.10