💻 Curve Technical Design

🚀 System Goals

  • All tokens graduate at about $50,000 USD market cap

    • USD Values are based exclusively on the KAS Price at the time of Token Launch

    • Variations in MarketCap at graduation will persist until a realtime on-chain KAS price oracle exists.

  • Bonding curve trades are fair, dynamic, and decentralized

  • LP is formed using all collected KAS (minus fees), matched to reserved tokens at a fixed price

  • Token pricing and curve behavior is consistent across all token supplies

  • Anti-whale and anti-rug protections are enforced on-chain

  • Fees are captured by the protocol treasury for future distribution

Step 1: Token Creation & Initialization

When a user launches a token on Moonbound, the following inputs and constants are set:

🔧 User-Provided Input

  • maxSupply – total token supply (must meet system-defined minimum, e.g. 100,000 tokens)

🔒 Fixed Constants

  • n = 2 (quadratic bonding curve exponent) — For initial launch, this is locked globally for all tokens

  • targetMarketCapUSD = $50,000

  • launchFeeUSD = $5

  • graduationFeeUSD = $500

  • feeRate = 0.01 (1% fee on every trade, captured on the KAS side of the trade)

  • topHolderLimit = 0.10 (no wallet may hold more than 10% of maxSupply)

📈 Oracle Fetch (at time of token creation)

  • Fetch kasPriceUSD (KAS price in USD)

💡 Dynamic Calculations (based on oracle value)

  • P_graduation_USD = $50,000 / maxSupply

  • P_graduation_KAS = P_graduation_USD / kasPriceUSD

  • launchFeeKAS = $5 / kasPriceUSD

  • graduationFeeKAS = $500 / kasPriceUSD

Step 2: Curve Supply, Token Allocation & LP Targeting

The system calculates:

  • S: tokens allocated to the bonding curve (non-reserved, for trading)

  • R: tokens reserved to pair with KAS in the LP

  • K_LP: KAS to match with R at P_graduation_KAS

  • K_total: gross KAS to collect before protocol fees

🧮 Curve Math (n = 2)

R = maxSupply * 0.25

S = maxSupply - R

K_LP = R * P_graduation_KAS

K_eff = K_LP + graduationFeeKAS

K_total = K_eff / (1 - feeRate)

This ensures:

  • The LP is formed with perfect value match at graduation price

  • The bonding curve scales consistently across all token sizes

  • Early and late buyers experience fair relative pricing

Step 3: Bonding Curve Trading Behavior

📊 Curve Price Formula

price(s) = P_graduation_KAS * (s / S)^2

Where:

  • s: number of curve tokens currently held by users (net sold)

  • S: total bonding curve allocation (from Step 2)

🔁 Trading Rules

Buy:

  • Buyer receives amount of curve tokens

  • Pays price(s) per token (curve-based)

  • Pays KAS * (1 + 0.01 fee)

  • Contract checks: balanceOf(buyer) + amount ≤ 0.10 * maxSupply ❗ Reverts if violated

  • Updates: s += amount

Sell:

  • Seller returns tokens to bonding curve

  • Receives price(s) per token * (1 - fee)

  • Contract retains tokens (not burned)

  • Updates: s -= amount

  • Tokens are re-buyable at new lower price

The bonding curve is a revolving supply pool. Tokens can be bought, sold, and re-bought until graduation.

Step 4: Graduation & LP Formation

✅ Graduation Occurs Immediately and Automatically When:

  1. s == S (all curve tokens have been sold)

  2. No wallet holds more than 10% of maxSupply (already enforced per-transaction)

🛠️ At Graduation:

  • Bonding curve is permanently disabled

  • No further buys or sells are possible

  • Contract removes graduationFeeKAS

  • Remaining KAS (K_LP) is paired with R reserved tokens

  • LP is created on Zealous Swap at P_graduation_KAS

  • LP tokens are burned or locked permanently

Step 5: Final Constraints & Failsafes

✅ Oracle Requirements

  • Oracle must provide KAS/USD price at launch

  • Launch fails if oracle price is unavailable

✅ Supply Boundaries

  • minSupply = 100,000

  • recommended maxSupply ≤ 500,000,000,000

  • Curve math supports 100k–500B cleanly via normalized pricing

✅ Gas & Precision

  • Use 18-decimal fixed-point math

  • Normalize values before exponentiation

🎯 Summary of Formulas

Component
Formula

Graduation Price (USD)

$50,000 / maxSupply

Graduation Price (KAS)

P_graduation_USD / kasPriceUSD

Launch Fee (KAS)

$5 / kasPriceUSD

Graduation Fee (KAS)

$500 / kasPriceUSD

Curve Price (n = 2)

P_graduation_KAS * (s / S)^2

Reserved Tokens

R = maxSupply * 0.25

Curve Tokens

S = maxSupply - R

LP KAS Side

K_LP = R * P_graduation_KAS

Required KAS to Collect

(K_LP + graduationFeeKAS) / (1 - feeRate)

This minimalistic bonding curve model ensures Moonbound token launches are trustless, fair, and immediately actionable — with consistent market behavior, guaranteed LP formation, and no off-chain dependencies or time-based gating.

Previous📦 Moonbound TreasuryNext🗺️ Roadmap

Last updated