# Provider Guide

Share your GPU with the BonzAI network and earn ETH or USDC for processing inference requests.

## Registration

### Via the App

1. Open **Network Settings** in BonzAI
2. Switch to **Provider** mode
3. Select the pipelines you want to offer (LLM, Image, Audio, etc.)
4. Set your price per 1,000 tokens
5. Choose your payment currency (ETH or USDC)
6. Click **Register** — this sends a transaction to the BonzaiProviderRegistry on Base

### On-Chain Details

Registration calls `BonzaiProviderRegistry.register()` with:

| Parameter       | Description                              |
| --------------- | ---------------------------------------- |
| `peerId`        | Your libp2p peer ID (auto-generated)     |
| `multiaddrs`    | Your libp2p multiaddresses for dialing   |
| `pipelines`     | Array of pipeline IDs you support (0-10) |
| `pricePerToken` | Price per 1,000 tokens in wei            |
| `isRelay`       | Whether you also act as a relay node     |

Registration requires a minimum ETH stake (sent as `msg.value`).

## Provider Lifecycle

| Action         | Function           | Description                                |
| -------------- | ------------------ | ------------------------------------------ |
| Register       | `register()`       | Join the network, set capabilities         |
| Heartbeat      | `heartbeat()`      | Update `lastSeenAt` timestamp              |
| Update         | `updateProvider()` | Change pipelines, pricing, or peerId       |
| Deactivate     | `deactivate()`     | Stop accepting jobs                        |
| Activate       | `activate()`       | Resume accepting jobs                      |
| Withdraw Stake | `withdrawStake()`  | Recover staked ETH (must deactivate first) |

## Earning Revenue

When you process an inference request:

1. Consumer pays via BonzaiPayment (ETH or USDC)
2. **2.5% platform fee** is sent to treasury
3. **97.5%** is credited to your pending withdrawals
4. Your `totalEarnings` and `completedJobs` are updated in the registry

### Withdrawing Earnings

* **ETH earnings**: Call `withdrawETHEarnings()` on BonzaiPayment
* **USDC earnings**: Call `withdrawEarnings()` on BonzaiPayment

Both can be done via the Network Settings UI or directly on the contract.

## Pipeline Categories

When registering, specify which pipelines you support using their numeric IDs:

```
0: LLM (all 21 models)
1: IMAGE_TURBO        6: AUDIO_TURBO
2: IMAGE_QUALITY      7: AUDIO_QUALITY
3: IMAGE_STANDARD     8: MUSIC
4: IMAGE_ADVANCED     9: VIDEO_FAST
                     10: VISION
```

## Hardware Recommendations

| Pipeline           | Minimum VRAM | Recommended |
| ------------------ | ------------ | ----------- |
| LLM (small models) | 4 GB         | 8 GB        |
| LLM (large models) | 16 GB        | 24 GB       |
| Image              | 6 GB         | 12 GB       |
| Audio              | 2 GB         | 4 GB        |
| Video              | 10 GB        | 16 GB       |
| Vision             | 6 GB         | 8 GB        |


---

# 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/p2p-network/provider-guide.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.