@forgekit-labs/curve

Bonding curve math. Starting price, graduation threshold, progress, market cap. Pure functions, no network, zero third-party dependencies.

Install

npm install @forgekit-labs/curve

Usage

import { curve } from '@forgekit-labs/curve';

const c = curve('my-token')
  .supply(980_000_000)
  .solPrice(180);

c.startPrice(5_000);                  // SOL/token for $5K starting MC
c.graduationAt(50_000);               // lamports needed to graduate at $50K
c.progress(raised, threshold);        // { pct, remaining }
c.marketCap(spotPriceSol);            // USD market cap

Utilities

Standalone helpers for the cases where you do not need the builder:

import {
  lamportsToSol,
  solToLamports,
  pricePerToken,
  spotPrice,
  progress,
  marketCap,
  basisOf,
} from '@forgekit-labs/curve';

All utilities are BigInt-safe and return strings for amounts above the JavaScript float limit.

Error Handling

import { curve, ForgeValidationError } from '@forgekit-labs/curve';

try {
  curve('my-token').supply(-1);
} catch (err) {
  if (err instanceof ForgeValidationError) {
    console.error(err.message);
    console.error(err.hint);
  }
}

License

MIT