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