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.
Full spec: .agent/wallets.json.
Step 3 — Declare wallet roles
Every wallet needs a clear role.
| Role | Meaning |
|---|
treasury | Wallet holding agent funds |
fee_recipient | Wallet receiving fees or revenue |
deployer | Wallet that deployed contracts |
operator | Wallet used for operations |
payment | Wallet used for payments |
inference | Wallet connected to inference spend |
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:
| Status | Meaning |
|---|
| Candidate | Indexed but not attributed |
| Needs Verification | Incomplete or uncertain evidence |
| Wallets Declared | Manifest wallets submitted |
| Claimed | Wallet ownership proof submitted |
| Verified | Zetta reviewed and approved the profile |
| Luca Managed | Luca actively monitors the agent |
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. 