# Smart Contracts

All protocol contracts are deployed on **Base** (chain ID 8453).

## Protocol Contracts (v3)

| Contract                  | Address                                                                                                                 | Purpose                                                                                          |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| BonzaiMintPool            | [`0x3a31aE7F6E03E095D5D68a4D6c7165Ba2b2E6D4c`](https://basescan.org/address/0x3a31aE7F6E03E095D5D68a4D6c7165Ba2b2E6D4c) | Epoch-based revenue pools (2-week epochs, threshold snapshots, unlocked users bypass thresholds) |
| BonzaiCollectibles        | [`0x44f1675eBeB7f7A4Ac3E99E4A4652b34515F1F36`](https://basescan.org/address/0x44f1675eBeB7f7A4Ac3E99E4A4652b34515F1F36) | ERC-721 content NFT implementation (ERC-1167 clone per user)                                     |
| BonzaiCollectiblesFactory | [`0xCF5d739674A9daf91Da83CF84eDE1456B7f17BC2`](https://basescan.org/address/0xCF5d739674A9daf91Da83CF84eDE1456B7f17BC2) | Factory deploying per-user collection clones                                                     |
| BonzaiRoyaltySplitter     | [`0x798Bcae41E3A08B216D0Df6f03Be1e4eBEED9f24`](https://basescan.org/address/0x798Bcae41E3A08B216D0Df6f03Be1e4eBEED9f24) | Secondary royalty distribution (2/3 treasury, 1/3 pools weighted by activity)                    |
| BonzaiCompanions          | [`0x0889B53F810aF1bFc83EFFD459E945a1a4D79c38`](https://basescan.org/address/0x0889B53F810aF1bFc83EFFD459E945a1a4D79c38) | ERC-721 + ERC-8004 companion NFT, 10K max supply                                                 |
| BonzaiUniswapHook         | [`0x0d4B1d95ec00A6BC794B4bE18D1dF4136D524090`](https://basescan.org/address/0x0d4B1d95ec00A6BC794B4bE18D1dF4136D524090) | V4 afterSwap hook (1% fee capture)                                                               |
| CompanionTokenFactory     | [`0x0cD90Ef3a38Ab8E845D3538Dc55EB9bd9C9e0477`](https://basescan.org/address/0x0cD90Ef3a38Ab8E845D3538Dc55EB9bd9C9e0477) | Atomic companion ERC-20 + V4 LP (96/4 split, LP locked)                                          |
| FineTuneTokenFactory      | [`0x9bd9621b8F77e501063b0ec8CD15e6f53bDc6B34`](https://basescan.org/address/0x9bd9621b8F77e501063b0ec8CD15e6f53bDc6B34) | Atomic model ERC-20 + V4 LP                                                                      |
| BonzaiUnlock              | [`0x7A33a9843C1740Ea73594fA2468Fb210a7fd7968`](https://basescan.org/address/0x7A33a9843C1740Ea73594fA2468Fb210a7fd7968) | 1 ETH all-level unlock (50/50 foundation/liquidity split)                                        |

## Skill Economy Contracts

| Contract             | Address                                                                                                                 | Purpose                                                                  |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| BonzaiSkillRegistry  | [`0xeeB6B8A73B13141013416D74A327180905AFdF3F`](https://basescan.org/address/0xeeB6B8A73B13141013416D74A327180905AFdF3F) | Skill marketplace (80% co-owners, 20% platform, free for unlocked users) |
| BonzaiSkillOwnership | [`0xa1f80ABCe763De90eB873990C5841F7B1770383C`](https://basescan.org/address/0xa1f80ABCe763De90eB873990C5841F7B1770383C) | Companion co-ownership with weighted revenue distribution                |

## P2P Inference Contracts

| Contract               | Address                                                                                                                 | Purpose                                                    |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| BonzaiProviderRegistry | [`0x683d0B11a2553E9D4B338935e2D935873439e8bB`](https://basescan.org/address/0x683d0B11a2553E9D4B338935e2D935873439e8bB) | Provider registration, staking, shard capabilities         |
| BonzaiPayment          | [`0x438A73FC0e0DA882BFdD007aF41415769Af33F1d`](https://basescan.org/address/0x438A73FC0e0DA882BFdD007aF41415769Af33F1d) | Single-provider ETH/USDC payments with EIP-712 (x402)      |
| BonzaiPipelinePayment  | [`0xB45D1D635192Aa223Ce28d9F3cC047A13D8850Bd`](https://basescan.org/address/0xB45D1D635192Aa223Ce28d9F3cC047A13D8850Bd) | Multi-payee atomic pipeline payments for private inference |

## Cross-Contract Wiring

```
Content  --> MintPool (20% of mint fees), RoyaltySplitter
MintPool --> CollectiblesFactory, RoyaltySplitter, FeeHook, CompanionNFT
Hook     --> CompanionFactory (authorized), FineTuneFactory (authorized)
CompanionFactory --> Companions (NFT ownership check)
FineTuneFactory  --> Collectibles (NFT ownership check)
SkillRegistry <--> SkillOwnership (bidirectional)
SkillOwnership --> USDC token
Payment <--> ProviderRegistry (bidirectional)
PipelinePayment --> ProviderRegistry
```

## Key Parameters

| Parameter                    | Value                                          |
| ---------------------------- | ---------------------------------------------- |
| Companion mint price         | 0.25 ETH (free for unlocked users)             |
| Companion max supply         | 10,000                                         |
| Companions per wallet        | 4 max                                          |
| Companion token supply split | 96% liquidity pool, 4% companion wallet        |
| Content mint fees            | 0.0005-0.005 ETH per type (free for unlocked)  |
| Content fee split            | 80% treasury, 20% MintPool                     |
| Content royalties (ERC-2981) | 7.5%                                           |
| Royalty split                | 2/3 treasury, 1/3 pools (weighted by activity) |
| Unlock price                 | 1 ETH (unlocks all levels permanently)         |
| MintPool epoch duration      | 2 weeks (1,209,600 seconds)                    |
| Flash loan protection        | 256 blocks (\~8.5 minutes on Base)             |
| Hook swap fee                | 1%                                             |
| Companion hook fee split     | 34% wallet, 33% owner, 33% LVL6 pool           |
| FineTune hook fee split      | 80% creator, 10% treasury, 10% LVL6 pool       |
| Skill purchase split         | 80% co-owners (weighted), 20% author           |
| P2P platform fee             | 2.5%                                           |
| Pipeline max providers       | 16 per session                                 |

## Solidity Version

All contracts compile with Solidity `0.8.34`, optimizer enabled (200 runs, viaIR), EVM target `cancun`.

## Uniswap V4 Addresses (Base)

| Component       | Address                                      |
| --------------- | -------------------------------------------- |
| PoolManager     | `0x498581ff718922c3f8e6a244956af099b2652b2b` |
| PositionManager | `0x7c5f5a4bbd8fd63184577525326123b519429bdc` |
| Permit2         | `0x000000000022D473030F116dDEE9F6B43aC78BA3` |

## Treasury Wallets

| Wallet                | Address                                      |
| --------------------- | -------------------------------------------- |
| Foundation / Treasury | `0x8Ff3b2e823b33BeE30e699bB1b6BBc8F622fEa89` |
| Liquidity             | `0x4135d59f0BfF96560b7aD5cfCe81154AB1810B93` |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bonzai.sh/web3-and-tokenomics/smart-contracts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.