Technical Documentation

BondIt Documentation

Pump for distribution. BondIt for discipline. Complete technical reference for the BondIt protocol — trust tiers, community signal metrics, enforcement scope, and the per-token Agency model that makes launch promises enforceable.

Overview

BondIt is a hybrid launch protocol on Solana. Tokens launch where the volume is (Pump), then get wrapped with enforceable discipline (BondIt). Every token shows its trust tier above the fold — what BondIt controls, what's enforceable, and what's not. No guessing.

Market cap tells you where a token is. Attention tells you where it's going. Community tells you whether it survives. BondIt surfaces Bond Pulse, holder momentum, whale delta, and distribution quality as primary metrics — demoting market cap to secondary status.

Protocol at a Glance
NetworkSolana
Trust TiersNative / Secured / Tracked
Primary MetricBond Pulse (community signal)
Per Token1 Dedicated Agency (Native)
Human DiscretionZero
Graduation Target85 SOL

Trust Tiers

Every token on BondIt is classified into one of three enforcement tiers. The badge is shown above the fold on every token page — never hidden, never ambiguous. If BondIt doesn't control something, we say so explicitly.

Native

Full BondIt enforcement. Immutable charter, deterministic treasury, lifecycle engine, LP management. BondIt controls everything.

Secured on Pump

Creator fees and treasury flow through BondIt-controlled vaults. Launch mechanics on Pump. BondIt enforces financial flows.

Tracked

Analytics and monitoring only. BondIt provides community signal data but does not enforce any on-chain rules.

Enforcement Scope by Tier
Fee VaultNative ✓ / Secured ✓ / Tracked ✗
Treasury VaultNative ✓ / Secured ✓ / Tracked ✗
Policy EngineNative ✓ / Secured ✗ / Tracked ✗
Launch MechanicsNative ✓ / Secured ✗ / Tracked ✗
LP ManagementNative ✓ / Secured ✗ / Tracked ✗
Community SignalNative ✓ / Secured ✓ / Tracked ✓

Community Signal

BondIt prioritizes community-driven metrics over pure market cap. The Bond Pulse is a 0-100 composite score measuring attention velocity, holder momentum, and social energy. It's the primary metric on every token card and detail page.

Primary Metrics (Community-First)
Bond Pulse0-100 composite attention score
Tweet VelocityTweets per hour
Unique PostersDistinct accounts mentioning
Net New Holders24h holder growth
Significant BuysNotable buy events
Whale DeltaNet whale inflow/outflow
Distribution Quality0-100 supply spread score
Holder Retention% of holders who stay
Attention→BuyerConversion from buzz to wallets
Secondary Metrics (Demoted)
Market CapShown smaller, not primary
VolumeSupporting context only
Price ChangeVisible but not dominant

Status Tags

Every token gets a real-time status tag based on community signal momentum: Heating (attention rising), Exploding (viral breakout), Stable (steady community), or Cooling (fading momentum).

The Per-Token Agency

The Agency is BondIt's core innovation. When you launch a token on BondIt, the protocol deploys a dedicated Agency instance bound exclusively to that token. This is not a shared service, not a multisig, and not a team making discretionary decisions. It is an autonomous on-chain program with one job: steward your token from genesis to independence.

What the Agency Does

LP ManagementManages a Meteora LP position for the token
Fee CompoundingCompounds 70% of trading fees back into liquidity
Treasury ReleasesReleases tokens at 0.20%/day exponential decay
Flight MonitoringChecks holder count, concentration, treasury levels
DissolutionHands LP control to community and self-destructs

Why Per-Token Matters

A shared stewardship model creates conflicts of interest — one token's needs compete with another's. BondIt eliminates this entirely. Each Agency instance is isolated, deterministic, and accountable only to the charter of the token it manages. There is no cross-token resource sharing, no priority queue, and no human judgment calls about which token gets attention.

The Agency's lifecycle is finite by design. Its entire purpose is to make itself unnecessary. Once the community reaches critical mass (15K holders, decentralized distribution, treasury under 5%), the Agency transfers control and dissolves. Every token either graduates to full independence or receives a clean sunset at 180 days.

Token Lifecycle

Every BondIt token follows the same deterministic lifecycle. No exceptions, no special treatment, no backroom deals.

1. Genesis

Charter locked, token minted with 70/15/10/5 allocation. Agency deployed.

2. Bonding Curve

Token trades on the bonding curve. Agency accumulates fees. Target: 85 SOL.

3. Graduation

Curve completes. Agency activates LP management on Meteora and begins stewardship.

4. Stewardship

Agency compounds fees, releases treasury, monitors flight conditions. Up to 180 days.

5. Flight Mode

Conditions met. Agency transfers LP to community, dissolves. Token is independent.

Lifecycle Execution
launch-factorycreate_launch → mints allocations
bonding-curveHandles curve trading until graduation
record_graduationLinks policy engine + venue adapter
keeper jobsmonitor → execute → compound (cron)
record_flight_modePermanent agency sunset transition

On-Chain Charter

The charter is the Agency's operating system. It is written to the blockchain at genesis and can never be modified — not by the creator, not by the team, not by a governance vote. There are no admin keys.

Token Allocation
Bonding Curve70%
LP Reserve15%
Agency Treasury10%
Ecosystem Fund5%
Charter Parameters
Graduation Target85 SOL
Protocol Fee2% (200 bps)
Treasury Decay Rate0.20% of remaining / day
Daily Release Cap1,000,000 tokens
Weekly Release Cap5,000,000 tokens
Max Stewardship Duration180 days
Admin KeysNone

Fee Structure

BondIt charges a 2% protocol fee on all trades. This fee is split deterministically — the Agency controls the allocation, not a team wallet.

Fee Split (70 / 20 / 10)
LP Compounding70%
House (Protocol)20%
Referral Pool10%

The 70% LP allocation is the key innovation. Most launchpads keep 100% of fees. BondIt's Agency automatically compounds the majority back into the token's own liquidity pool, creating a self-reinforcing depth flywheel. The deeper the LP, the tighter the spreads, the more volume, the more fees, the deeper the LP.

Treasury Distribution

The Agency controls 10% of total supply in its treasury. It releases tokens using an exponential decay formula at exactly 0.20% of the remaining balance per day. This creates a predictable, decelerating release schedule that prevents dumping.

Distribution Rules
Decay Rate0.20% of remaining / day
Daily Hard Cap1,000,000 tokens
Weekly Hard Cap5,000,000 tokens
Can Be AcceleratedNo
Can Be PausedNo
Visible On-ChainYes — every token card shows progress

No developer, whale, or team member can accelerate the release schedule. The math is the same for every token, every day, and every action is logged on-chain.

Flight Mode

Flight Mode is the Agency's final act — and its entire purpose. The Agency exists to make itself unnecessary. When a token's community is mature enough to sustain itself, the Agency transfers full LP control and dissolves permanently.

Flight Conditions (all must be met)
Holder Count≥ 15,000
Top-10 Concentration≤ 18%
Treasury Remaining≤ 5%
Forced Sunset
Trigger180 days without flight conditions met
ActionAgency dissolves, LP transferred to community
OverrideNot possible — no admin keys

The forced sunset ensures no token is stuck in perpetual stewardship. Every Agency has a maximum lifespan of 180 days. The community either achieves independence organically or receives a clean, deterministic exit.

Referral System

10% of all trading fees flow into the referral pool. Referrers earn a share of fees generated by users they onboard. Payouts are processed by the keeper service and sent directly to referrer wallets in SOL.

Referral Mechanics
Fee Allocation10% of protocol fees
Payout CurrencySOL
Min Payout Threshold0.01 SOL
Payout FrequencyEvery 30 minutes (cron)
Max Payouts Per Run50
TrackingURL param ?ref=CODE → cookie → DB attribution

Technical Architecture

BondIt consists of five on-chain Solana programs and four off-chain services. The on-chain programs handle token operations deterministically. The off-chain services provide indexing, scheduled execution, and AI advisory.

On-Chain Programs

Launch FactoryCreates launches, mints allocations
Bonding CurveHandles curve trading, fee collection
Agency VaultsManages LP positions, treasury, distributions
Policy EngineEnforces charter rules, flight conditions
Fee AccumulatorSplits and routes protocol fees

Off-Chain Services

Indexer (port 4000)Streams events, builds analytics API
KeeperCron: monitor, execute, compound, flight-check, referral payout
OpenClaw AIAdvisory: reports, anomaly scans, Q&A
Vanity WorkerGrinds branded mint addresses (…LoL)

Infrastructure

FrontendNext.js on Vercel
IndexerNode.js on Render
DatabasePostgreSQL on Render
Cron Triggerscron-jobs.org → Vercel API routes
RPCSolana mainnet-beta

OpenClaw AI

OpenClaw is BondIt's intelligence layer. Every launch can optionally connect an AI agent powered by Anthropic or OpenAI for community engagement via Telegram or Discord. OpenClaw is advisory only — it has zero execution authority.

OpenClaw Boundaries
RoleAdvisory: reports, anomaly scans, Q&A
Can Execute TradesNo
Can Modify CharterNo
Can Access Private KeysNo
Data SourceReads from indexer API (public data only)
API Endpoints
POST/api/reports/daily/:launchId
POST/api/reports/weekly/:launchId
POST/api/query

CLI Tools

BondIt provides a headless CLI for launching tokens programmatically. It supports Phantom wallet integration, pre-launch simulation, and branded vanity mint addresses.

$ bondit launch init --yes
✔ Created bondit-launch.json

$ bondit launch simulate
✔ Simulation passed — Compute units: 142,500

$ bondit launch create --vanity
✔ Token is live on curve
  Mint: 7xK...LoL
CLI Commands
bondit launch initScaffold a launch config file
bondit launch simulateDry-run with CU estimation
bondit launch createSubmit the on-chain launch transaction
--vanityGrind for branded mint address (…LoL)
--yesSkip confirmation prompts

API Reference

The indexer exposes a REST API for querying launch data, analytics, and real-time token information. All endpoints are public and do not require authentication.

Launch Discovery

GET/api/launches
GET/api/launches/:launchId/dashboard
GET/api/launches/:launchId/charter
GET/api/launches/:launchId/liquidity
GET/api/launches/:launchId/flight-status
GET/api/launches/:launchId/fees

Referral System

POST/api/referral/create-code
POST/api/referral/attribute
POST/api/referral/record-earning
GET/api/referral/stats/:wallet

Cron Endpoints (authenticated)

GET/api/cron/referral-payout
GET/api/cron/keeper?job=monitor
GET/api/cron/keeper?job=execute
GET/api/cron/keeper?job=compound
GET/api/cron/keeper?job=flight-check
AuthAuthorization: Bearer CRON_SECRET

BondIt.lol — Launch where the volume is. Build where the trust is. Documentation is append-only.