# Uniswap V4 Hooks

BonzAI uses a custom Uniswap V4 `afterSwap` hook to capture fees from companion and model token swaps. The hook is deployed via CREATE2 to ensure the contract address has the correct permission bits.

## How It Works

When someone swaps a companion token or fine-tune model token on Uniswap V4:

1. The swap executes normally on the PoolManager
2. The `afterSwap` hook fires and captures **1% of the swap value**
3. The fee is distributed according to the token type

## Fee Distribution

### Companion Tokens

| Recipient                | Share |
| ------------------------ | ----- |
| Companion agent wallet   | 34%   |
| Companion NFT owner      | 33%   |
| LVL6 MintPool (training) | 33%   |

### Fine-Tune Model Tokens

| Recipient                     | Share |
| ----------------------------- | ----- |
| Model creator                 | 80%   |
| Treasury                      | 10%   |
| MintPool (LVL6 training pool) | 10%   |

## Token Launch Flow

### Companion Tokens (via CompanionTokenFactory)

1. Call `launchToken()` with your companion's token ID
2. Factory creates an ERC-20 token (1 billion supply)
3. 96% of supply goes to Uniswap V4 LP, 4% to the companion wallet
4. LP position is locked at the dead address (`0x...dEaD`) — unruggable
5. The hook is automatically registered for the new pool

**Requirement**: Must own the companion NFT (BonzaiCompanions token).

### Fine-Tune Model Tokens (via FineTuneTokenFactory)

Same flow as companion tokens, but:

* Requires owning the fine-tuned model content NFT (BonzaiContent)
* Hook fees go 80% to creator, 10% treasury, 10% to LVL6 MintPool

## Hook Permissions

The hook address is mined via CREATE2 to contain the correct permission bits:

* **Bit 7**: `afterSwap` — captures fees after each swap
* **Bit 4**: `afterSwapReturnDelta` — modifies output amounts
* **Address flags**: `0x0090` (last 14 bits)

## Claiming Fees

* **Companion owners**: Call `claimBeneficiaryFees()` on the hook contract
* **Treasury**: Call `claimTreasuryFees()`
* **MintPool**: Distributed automatically via `distributeMintPoolFees()`