The DAO Starter Kit

For Developers

Integrate token trading widgets. Fork the open-source code. Ship faster.

Widget Library

Embed token functionality into any website:

• Buy Widget: One-click token purchase via embed script
• Staking Mini App: Mobile staking via Telegram Web App link

<!-- Embed Widget -->
<script src="https://bonzivista.org/widget/embed.js"></script>
<div data-bonzi-widget token="0x..."></div>

Self-Host Setup

1. Clone: git clone https://github.com/Siah-kin/community-bot
2. Set env: TELEGRAM_BOT_TOKEN=your_token
3. Deploy: Docker, Render, or your own server

API Reference

Full REST API for custom integrations. See API.md in the repo.

For AI Agents

Agents as peers. Query trust scores, verify cooperation, detect gaming - the same data Bonzi uses internally.

Why Bonzi's Data is Unique

Bonzi is community management, codified. Signal weights, tier progressions, and anti-gaming heuristics were calibrated from real community operations. The patterns come from actual edge cases - not theoretical models.

Wallet Vetter (Live)

Check any Ethereum wallet's trust score using Bonzi's multi-source trust system. 13 signals aggregated into one anti-gameable tier.

Response Format

{
  "tier": "B",           // S, A, B, C, or F
  "score": 52.3,         // 0-100 composite score
  "confidence": "medium", // low, medium, high
  "signals": {
    "cooperation": 0.65,  // Help given/received
    "eigentrust": 0.48,   // Graph-based trust
    "sybil": 0.82,        // Not-a-bot confidence
    "dao": 0.31           // DAO participation
  }
}

Tier Breakdown

S-TIER	80-100	Exceptional trust - verified contributor
A-TIER	60-79	High trust - established reputation
B-TIER	40-59	Moderate trust - standard user
C-TIER	20-39	Low trust - limited history
F-TIER	0-19	Untrusted - exercise caution

External Verification Links

Every vetter result includes links to verify independently: Bubblemaps, DeBank, Etherscan, Arkham.

API Endpoints

Live endpoints for trust queries. x402-gated for paid access.

Trust Score (Live)

GET /api/trust/{wallet} returns numeric score, tier grade (S/A/B/C/F), confidence level, and signal breakdown across 13 signals.

Cooperation Profile (Live)

GET /api/trust/{wallet}/composite returns cooperation signals: help given, gratitude received, educational contributions, unique people helped.

Tamper-Proof Verification (Live)

On-chain verification of reputation. Weekly proof checkpoints published to Base L2. Verify independently without trusting Bonzi's API directly.

ERC-8004 AI Identity

ERC-8004 establishes three on-chain registries for AI agents: Identity, Reputation, and Validation. Co-authored by MetaMask, Ethereum Foundation, Google, and Coinbase.

Standard Status

• ERC-8004: Live on Ethereum mainnet
• Chain: Ethereum (Base coming soon)

Bonzi Integration Status

• Client code: Scaffolded (read + dry-run)
• Agent registration: Not yet registered
• Trust signal bridge: Planned (internal signals → on-chain feedback)
• Live trust engine queries: Planned

Once fully integrated, Bonzi's internal trust signals (tips, QA scores, cooperation metrics) will be bridged to ERC-8004's Reputation Registry. Other agents will be able to query Bonzi's reputation data independently on-chain.

What is a Tokenised Brand?

A token is a loyalty-reward system for the web3 era. Instead of points that expire, your community earns tokens through active participation.

How It Works

Every brand token launched through Bonzi uses the VISTA-20 standard on Ethervista. This gives you flat-fee economics from day one:

• Flat fees per transaction. $5-15 per swap, not a percentage. A $100 trade and a $10,000 trade pay the same fee.
• Revenue = transaction count. Fee income scales with trade count, not trade size.
• Fees split automatically. Between creators, LPs, and the tip pool. No manual distribution.

Web2 Points vs Web3 Tokens

Web2 Points	Web3 Tokens
Expire after 12 months	Never expire
Only redeemable at one store	Tradeable on open markets
Company controls supply	Supply fixed at launch
Zero resale value	Market-priced, transferable
Loyalty is one-way	Community earns rewards

Value Accrual

Community activity → more transactions → more fees → active participants earn from the fees their activity generates. Built into the protocol, not bolted on.

DAO Starter Kit

Deploy a token, configure your bot, activate your community, and start earning. Everything included.

What You Get

• Token. VISTA-20 token with flat-fee economics, deployed on Ethervista
• Bot. Telegram bot with AI moderation, tipping, promotions, and reputation tracking
• Governance. Human vetting, graduated sanctions, and cooperative reputation
• Analytics. Real-time dashboards for large-holder movements, social sentiment, and blockchain metrics

Setup Flow

1. Deploy token. Launch on Ethervista via etherfun.app
2. Configure bot. Add Bonzi to your Telegram group and set brand preferences
3. Activate community. Enable Promote & Earn, tipping, and leaderboards
4. Earn. Flat fees flow as your community transacts

Included vs Customisable

Included (works out of the box)	You Customise
Token deployment	Fee levels (creator/LP split)
Telegram bot	Brand name, logo, welcome message
Reputation system	Which features to enable
Promotion tracking	Reward amounts
Token locking infrastructure	LP hardlock percentage

Brand Advocate Earnings

Your track record grows with every contribution. Better contributors get faster reviews and access to more tasks.

How You Progress

The system tracks genuine cooperation. Each positive signal raises your standing. Higher standing means faster reviews and more access.

How Earnings Work

• Cooperation signals. Help others, answer questions, submit quality promotions, report bugs
• Reviewer income. At score 101+, review newcomer promotions for $10 flat per review (90% to you)
• Anti-gaming. Self-dealing, spam, and fake signals are detected and penalised automatically

Trust Engine for Community Moderators

The AI trust engine auto-detects cooperation signals, gaming attempts, and churn risk. Moderators focus on community, not policing.

What the Trust Engine Detects

• Cooperation signals. Help given, gratitude received, educational contributions
• Gaming attempts. Self-tipping, fake-account clusters, coordinated farming
• Churn risk. Active members going quiet, engagement drops
• Anomalies. Sudden score spikes, suspicious voting patterns

Daily Digest (Planned)

Moderators will receive an automated daily summary:

• Tier changes (who moved up or down)
• Anomaly alerts (flagged accounts needing review)
• Fake-account clusters (groups of accounts acting in concert)
• Engagement trends (community health at a glance)

Graduated Response

No instant bans. The system uses a 4-tier progressive response:

Level	Action	CPI Impact
1. Warning	Private notification	-5 points
2. Cooldown	7-day feature restriction	-15 points
3. Suspension	30-day ban from earning	-30 points
4. Permanent	Full removal	-50 points

Token Launch via Email (Planned)

Launch a token without crypto knowledge. Sign up with email, configure your brand, deploy to Ethereum. Currently, token launches use etherfun.app via the bot.

Planned Flow

1. Email signup. Create an account with your business email
2. Wallet creation. A secure wallet is generated for you automatically
3. Token configuration. Set your brand name, supply, fees, and LP hardlock
4. Deploy. One-click deployment to Ethereum via Ethervista
5. Website widget. Embed a buy button on your existing website

Fiat Integration (Planned)

End users buy tokens with credit card. The conversion happens behind the scenes. This feature is in development.

Human Vetting (Ostrom Governance)

Experienced community members verify newcomers. Distributed quality control based on Ostrom's commons principles.

What is Human Vetting?

When a new member submits a promotion, it goes to a queue. Experienced members (CPI ≥ 101) review it for quality. This keeps standards high without centralised moderation.

Reviewer Eligibility

• CPI threshold: Must have CPI score of 101 or higher (Trusted Helper tier)
• Fee: $10 flat per review, 90% goes to the reviewer
• Selection: Reviewers are assigned randomly from the eligible pool

Quality Assurance

10% of reviews are randomly selected for meta-review. A second reviewer checks whether the first reviewer was fair. This keeps reviewers honest.

Graduated Sanctions

Reviewers who consistently make poor decisions face the same 4-tier progressive system as regular members. No special treatment. Everyone is accountable to the same rules.

Privacy

Prove your tier without revealing personal data. Privacy proofs let you demonstrate your reputation level without exposing your identity or exact score.

Troubleshooting

Bot not responding

Check that Bonzi has admin permissions in your group. Without admin access, it can't read messages.

Claim not working

Verify: (1) You meet the minimum points threshold (configurable per community), (2) Wallet is linked, (3) Pool has funds.

Wrong answers

Use feedback buttons to report. For persistent issues, use /bug.