Contracts And Modules¶

Last updated: 2026-06-28

The Eliza contracts coordinate identity, runtime configuration, node pools, sessions, task queues, payments, privacy, stats, validation, and cognitive-level workflows.

Module Groups¶

Group	Modules
Access and identity	`ACL`, `IAM`
Runtime and network config	`RuntimeV1`, `NetworkData`
Node state	`NodePool`, `NodePoolData`, `NodePoolUtils`, `NodeStats`, `NodeReputation`, `NodeSpec`, `NodeVersion`
Sessions	`SessionV2`, `SessionData`, `SessionAuth`
Queue and validation	`SessionQueueV2`, `SessionQueueData`, `SessionQueueValidation`
Payment	`SessionPayment`, `SessionPaymentData`, `SessionPaymentTable`, `SessionPaymentStaking`, `SessionPaymentStakingRateLimit`
Privacy	`PrivacySettingData`
Stats and quality	`ValidatorStats`, `QuantitiveStats`, `QualitativeStats`, `QualityStatsData`
Cognitive	`CognitiveV1`, `CognitiveLevel`

Quality stats

The contract/API name and source filename are QualityStatsData. Regenerate Hardhat artifacts after pulling this rename so artifact sourceName values match the source tree.

Contract Flow¶

flowchart LR
  IAM["IAM / ACL"]
  Runtime["RuntimeV1 / NetworkData"]
  NodePool["NodePool / NodeSpec"]
  Session["SessionV2 / SessionData"]
  Queue["SessionQueueV2"]
  Payment["SessionPayment"]
  Privacy["PrivacySettingData"]
  Validation["SessionQueueValidation / ValidatorStats"]

  IAM --> Runtime
  Runtime --> NodePool
  NodePool --> Session
  Session --> Queue
  Queue --> Payment
  Queue --> Privacy
  Queue --> Validation

Deployment Reference¶

Item	Why it matters
Canonical deployment table	Web3 examples need current addresses.
ABI links	Developers need reproducible contract examples.
Module ownership	Separates protocol-critical modules from dashboard/admin helpers.
Status	Shows whether a module is active, replaced, or environment-specific.

Deployment Reference Shape¶

When a network has verified deployments, add a deployment reference with these fields:

Field	Purpose
Network	Names the target environment, such as Testnet-0, Testnet-1, Mainnet-Lite, or Mainnet-Full.
Module	Names the contract module exactly as deployed.
Address	Gives the canonical deployed address for that network.
Explorer	Links to the verified contract page.
ABI	Links to the ABI artifact or package version used by SDK examples.
Last verified	Shows when the deployment record was checked.

Deployment rows require address, explorer, ABI, and verification date.