Skip to main content
Wallet attribution is the foundation of Zetta. Before Zetta can generate Agent Books, it needs to know which wallets officially belong to the agent.

Discovery is not attribution

Zetta may discover wallets from public sources:
  • public profiles
  • contracts
  • token deployments
  • registry data
  • ecosystem pages
  • third-party sources
  • onchain activity
But discovered wallets are not automatically official. A discovered wallet is only a candidate.
Discovered wallet ≠ attributed wallet.

Attribution requires evidence

A wallet becomes attributed when there is stronger evidence. The strongest evidence is the agent’s wallet manifest:
It tells Zetta:
  • which wallets belong to the agent
  • what role each wallet has
  • which chain each wallet is on
  • how the wallet should be interpreted
See .agent/wallets.json format.

Wallet roles

Common roles:
RoleDescription
treasuryHolds agent treasury
fee_recipientReceives fees or revenue
deployerDeploys contracts
operatorUsed for operations
paymentUsed for payments
inferenceRelated to inference spend
See Wallet roles.

Books eligibility

Not every attributed wallet is books-eligible. A wallet must pass eligibility checks before it can produce official books. Eligible wallet types may include:
  • externally owned accounts
  • treasury contracts
  • operational wallets
Ineligible wallet types include:
  • token contracts
  • proxy contracts
  • unrelated contracts
  • unknown addresses without enough evidence
Token contract ≠ treasury wallet.

Why attribution matters

If attribution is weak, financial data becomes misleading. A wrong wallet can:
  • inflate revenue
  • hide expenses
  • misrepresent treasury
  • produce false confidence
  • damage trust

Zetta’s rule

No attribution, no official books.
If Zetta is unsure, the profile says so.