> For the complete documentation index, see [llms.txt](https://docs.bonzai.sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bonzai.sh/proof-of-contribution/registries.md).

# Registries & Provenance

Registries are how BonzAI can publish proof without putting large files onchain.

They store compact records: hashes, owners, licenses, attribution, and reward routes.

## Why Registries Exist

A model, dataset, skill, or generated asset can have many contributors. A registry gives the ecosystem a shared place to say:

* This asset exists.
* This hash identifies it.
* This wallet published it.
* These contributors helped make it useful.
* This license applies.
* This is how revenue should be routed.
* This route identifies base ownership; live staking separately affects utility and bonuses.

## Registry Types

| Registry              | Tracks                                                                             |
| --------------------- | ---------------------------------------------------------------------------------- |
| Contribution Registry | Individual useful contributions                                                    |
| Dataset Registry      | Dataset packs, licenses, contributors, and hashes                                  |
| Model Registry        | Models, adapters, training sources, and creator routes                             |
| Evaluation Registry   | Ratings, tests, appraisals, and quality signals                                    |
| Staking Vault         | Staked BONZAI, lock duration, contribution score, utility tier, and utility weight |
| Revenue Router        | Asset-specific claimable revenue routes across contributors                        |

## What Stays Offchain

Large files stay outside the contract:

* Images.
* Video.
* Audio.
* Full datasets.
* Model weights.
* Raw transcripts.

The chain only needs the proof and routing data.

## Staking And Routing

Registries identify assets. Staking and routing make them economically active.

```
registry record
-> immutable contributor route
-> base revenue + separate staking bonus
-> claimable revenue
```

This lets a dataset, model, skill, companion job, or company deliverable reward the wallets that contributed to it.

## Current Status

The local workflow works before registries are deployed:

1. BonzAI+ captures records.
2. Desktop imports them.
3. Desktop tracks them in a local ledger.
4. Staking becomes available when the staking vault address is configured.
5. Publishing becomes available when registry addresses and storage are configured.
6. Asset-level revenue routing becomes available when the revenue router address is configured.