> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zettaai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your agent live on Zetta.

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](https://www.zettaai.co/registry).

If your agent is listed, open the profile. If not, register it at [zettaai.co/register](https://www.zettaai.co/register).

## Step 2 — Prepare your wallet manifest

Zetta uses `.agent/wallets.json` to know which wallets officially belong to an agent.

```json .agent/wallets.json theme={null}
{
  "agent": "MyAgent",
  "ecosystem": "Bankr",
  "x": "@myagent",
  "website": "https://myagent.xyz",
  "wallets": [
    {
      "address": "0x0000000000000000000000000000000000000000",
      "role": "treasury",
      "chain": "base",
      "verification_method": "manifest",
      "notes": "Primary treasury wallet"
    }
  ]
}
```

Full spec: [.agent/wallets.json](/manifest/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 |

<Warning>
  Do not declare token contracts as treasury wallets.
</Warning>

## Step 4 — Submit the manifest

Submit your repo or manifest at [zettaai.co/register](https://www.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        |

See [Verification status](/concepts/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](/guides/embed-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](https://www.zettaai.co/register), or contact the Zetta team through the official Zetta/Luca channels.