For the complete documentation index, see llms.txt. This page is also available as Markdown.

Companions Explained

BonzAI companions are AI characters that can exist as local roleplay personas and, optionally, as onchain ERC-721 + ERC-8004 agent identities.

What A Companion Has

  • Name, biography, personality, appearance, and voice style.

  • Big Five/OCEAN personality traits.

  • Spending profile across 12 categories.

  • Scenario and memory context.

  • Optional autonomous mode.

  • Optional minted NFT identity.

  • Optional agent wallet.

  • Optional LUKSO Universal Profile.

  • Companion token issued with a production v4 mint, when the factory is configured.

  • Optional skill co-ownership and revenue participation.

Local vs Minted

State
What it means

Local companion

Usable in roleplay and generation without wallet or minting

Minted companion

ERC-721 + ERC-8004 identity with agent wallet and onchain metadata

Bare companion

Minted placeholder identity that can be personalized/finalized later

Universal Profile

Optional LUKSO identity extension controlled by the companion agent wallet

Default Companions

BonzAI ships with default companions for local roleplay. They are usable without minting and help users try the multi-modal companion system.

Minted Companion Economy

Minted companions can participate in:

  • Agent wallet identity.

  • ERC-8004 metadata.

  • Skill co-ownership.

  • Atomic companion token and permanent-liquidity launch.

  • Uniswap V4 hook fee routes.

  • Social/orchestration flows.

  • Optional Universal Profile identity on LUKSO.

Revenue Paths

Companions can earn or route revenue through:

  • Companion token hook fees.

  • Skill co-ownership distributions.

  • Companion wallet token allocations.

  • Autonomous purchase/skill flows.

The detailed splits are documented in Reward Structure.

Last updated