Technical Documentation

BondIt Documentation

Launch fast. Build with 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 an ETH-centric launch protocol with deterministic milestone analytics. Tokens launch through explicit EVM controls, then flight-mode readiness is computed from indexed holder, concentration, treasury, and duration metrics. 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
Primary NetworkEthereum mainnet
SettlementETH mainnet
Trust TiersNative / Secured / Tracked
Primary MetricBond Pulse (community signal)
Per Token1 Dedicated Agency (Native)
Human DiscretionZero
Graduation Target25 ETH

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

Creator fees and treasury flow through BondIt-controlled vaults. External launch mechanics stay outside BondIt control. 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 or a team making discretionary supply 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 Uniswap V3 LP position for the token
Fee CompoundingCompounds 60% 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: 25 ETH.

3. Graduation

Curve completes. Agency activates LP management on Uniswap V3 and begins stewardship.

4. Stewardship

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

5. Flight Mode

Conditions met. Agency finalizes stewardship. No LP pull, no reserve dump, 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 so supply allocation, release cadence, fee split, and flight thresholds are not discretionary. Governance can review launches and assign keepers, but it must not be able to accelerate locked supply or pull liquidity.

Token Allocation
Bonding Curve70%
LP Reserve15%
Agency Treasury10%
Ecosystem Fund5%
Charter Parameters
Graduation Target25 ETH
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
Governance ScopeReview, pausing, keeper assignment
Supply OverrideNot allowed

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 (60 / 25 / 15)
LP Compounding60%
House (Protocol)25%
Referral Pool15%
EVM Execution
Buy / SellNative ETH curve functions on the launch controller
QuotesquoteBuy and quoteSell expose deterministic slippage checks
Fee RoutingProtocolFeeRouted event records LP, house, and referral buckets
House WithdrawalsOwner-gated and limited to accrued house fees

The 60% 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 finalizes stewardship and dissolves permanently. Flight Mode does not unlock a large token reserve and does not remove liquidity from trading pools.

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; liquidity stays tradeable
OverrideNo reserve dump or LP pull

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

15% of protocol fees flow into the referral pool. Referrers earn a share of fees generated by users they onboard. The reserve is chain-aware for ETH launches, and unused referral allocation is tracked for future airdrops and incentive programs.

Referral Mechanics
Fee Allocation15% of protocol fees
Direct Referrer50% of referral pool (0.15% of trade volume)
Second Degree15% of referral pool (0.045% of trade volume)
Airdrop Reserve35% of referral pool (0.105% of trade volume)
Payout CurrencyNative currency per chain
Payout FrequencyEvery 30 minutes (cron)
Growth TiersScout -> Builder -> Syndicate -> Orbit
TrackingURL param ?ref=CODE → cookie → DB attribution
Referral Abuse Controls
Self-ReferralRejected and logged
Attribution VelocityConfigurable daily cap per referrer
Dust TradesSkipped below minimum fee threshold
Large EarningsMarked for review before payout
Risk Ledgerreferral_risk_events table

Technical Architecture

BondIt consists of EVM launch contracts and off-chain services for indexing, analytics, and scheduled execution. Enforcement decisions are deterministic and milestone-driven; AI is not part of the launch, restriction, or flight-mode path.

On-Chain Components

EVM Launch ControllerPrimary launch status, review, buy/sell execution, fees, graduation, and reserve release path
BondIt ERC-20Token deployment for ETH-mainnet launches
BondIt Pass ERC-72110k flagship ambassador collection for verified PFPs and referral lift

Off-Chain Services

Indexer (port 4000)Streams events, builds analytics API
KeeperRecords fresh EVM milestone snapshots and triggers eligible flight transitions
Operator Console/operator triggers protected keeper workflows
Vanity WorkerGrinds branded mint addresses (…LoL)

Infrastructure

FrontendNext.js on Vercel
IndexerNode.js on Render
DatabaseNeon Postgres
Migrationsinit.sql plus versioned schema_migrations ledger
Cron Triggerscron-jobs.org → Vercel API routes
Primary RPCEthereum mainnet

Milestone Analytics

BondIt's restriction and flight-mode model does not use AI. The indexer builds public analytics snapshots, the milestone engine evaluates the published thresholds, and the keeper submits only policy-permitted transitions.

Flight Mode Inputs
Holder CountIndexed token holder snapshot
Top-10 ConcentrationIndexed holder distribution snapshot
Treasury RemainingContract/indexer treasury balance as bps of supply
DurationDays since graduation or launch milestone
Metric FreshnessSnapshot timestamp and source must be visible
Security Boundary
AINot in launch approval, restrictions, keeper execution, or flight mode
KeeperDedicated role for milestone snapshots and contract-permitted flight mode
OwnerGovernance/multisig role for launch review and keeper assignment
ContractsReject stale snapshots and enforce published thresholds

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. Read endpoints are public. Wallet-owned writes require wallet signatures, and service-owned writes require an Authorization bearer secret.

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/code
POST/api/referral/attribute
POST/api/referral/record-trade (service auth)
GET/api/referral/stats/:wallet
GET/api/referral/program
GET/api/referral/airdrop-pool

Profiles & NFT PFPs

GET/api/profiles/:wallet
POST/api/profiles/:wallet/nonce
PUT/api/profiles/:wallet
POST/api/profiles/:wallet/verify-nft-pfp

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
GET/api/cron/keeper?job=treasury-release
GET/api/cron/keeper?job=referral-payout
POST/api/operator/keeper
AuthAuthorization: Bearer CRON_SECRET

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