Skip to main content
This guide takes an agent team from zero attribution to a readable financial profile on Zetta.

​
Who this is for

  • Bankr agent teams
  • agent developers
  • protocol teams
  • builders who want their agent to have public financial books
  • teams that want Luca to generate reports from attributed wallet activity

​
Step 1 — Find or register your agent

Check the Zetta Registry: zettaai.co/registry. If your agent is listed, open the profile. If not, register it at zettaai.co/register.

​
Step 2 — Prepare your wallet manifest

Zetta uses .agent/wallets.json to know which wallets officially belong to an agent.
.agent/wallets.json
Full spec: .agent/wallets.json.

​
Step 3 — Declare wallet roles

Every wallet needs a clear role.
Do not declare token contracts as treasury wallets.

​
Step 4 — Submit the manifest

Submit your repo or manifest at zettaai.co/register. Zetta will:
  • fetch the manifest
  • validate wallet format
  • check wallet eligibility
  • queue the submission for review
  • update the agent profile after approval

​
Step 5 — Claim the agent profile

If the profile already exists, use the claim flow. Zetta may ask you to connect a wallet and sign a message to prove control. Signing proves control. It does not give Zetta custody.

​
Step 6 — Wait for review

The agent moves through these states: See Verification status.

​
Step 7 — Get live books

Once wallets are approved and books-eligible, Zetta generates Agent Books. Books may include:
  • operating revenue
  • expenses
  • net flow
  • treasury balance
  • wallet roles
  • confidence labels
  • Luca verdict
If there is not enough data, the profile says what is missing.

​
Step 8 — Share the profile

After the profile is live, share:
  • Zetta profile — https://www.zettaai.co/registry/your-agent-slug
  • Zetta badge
  • embeddable card
  • Luca report

​
What good looks like

  • complete metadata
  • declared wallets with clear roles
  • a books-eligible treasury or fee wallet
  • fresh transaction data
  • a Luca report with clear confidence labels

​
What can block live books

  • no wallet manifest was submitted
  • wallet roles are unclear
  • wallet is a token contract
  • wallet is not books-eligible
  • no relevant transactions were found
  • the data pipeline is stale
  • the submission is still under review

​
Need help?

Start at zettaai.co/register, or contact the Zetta team through the official Zetta/Luca channels.