@parabolicfamily/mcp 0.1.0

package/dist/abi.d.ts

@@ -0,0 +1,17 @@
+import type { Abi } from "viem";
+/**
+ * ABI loader. `scripts/sync-abis.mjs` copies the `abi` field of the Foundry artifacts in
+ * ../contracts/out into mcp/abi/*.json; this module reads them at import time. The directory is
+ * one level above both src/ (tests) and dist/ (build), so the same relative path works for both.
+ * Override with PARABOLIC_ABI_DIR when the package is bundled elsewhere.
+ */
+export declare const ABI_DIR: string;
+export declare const ABI_NAMES: readonly ["ParabolicLaunchFactory", "ParabolicBondingCurve", "ParabolicLauncherToken", "ParabolicMemoRouter"];
+export type AbiName = (typeof ABI_NAMES)[number];
+export declare function loadAbi(name: AbiName): Abi;
+export declare const factoryAbi: Abi;
+export declare const curveAbi: Abi;
+export declare const tokenAbi: Abi;
+export declare const memoRouterAbi: Abi;
+/** Names of all functions in an ABI (used to document what the factory can and cannot enumerate). */
+export declare const functionNames: (abi: Abi) => string[];

package/dist/abi.js

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * ABI loader. `scripts/sync-abis.mjs` copies the `abi` field of the Foundry artifacts in
+ * ../contracts/out into mcp/abi/*.json; this module reads them at import time. The directory is
+ * one level above both src/ (tests) and dist/ (build), so the same relative path works for both.
+ * Override with PARABOLIC_ABI_DIR when the package is bundled elsewhere.
+ */
+export const ABI_DIR = process.env.PARABOLIC_ABI_DIR ?? resolve(dirname(fileURLToPath(import.meta.url)), "..", "abi");
+export const ABI_NAMES = ["ParabolicLaunchFactory", "ParabolicBondingCurve", "ParabolicLauncherToken", "ParabolicMemoRouter"];
+const cache = new Map();
+export function loadAbi(name) {
+    const hit = cache.get(name);
+    if (hit)
+        return hit;
+    const file = join(ABI_DIR, `${name}.json`);
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(file, "utf8"));
+    }
+    catch (e) {
+        throw new Error(`Cannot read the bundled ABI ${file}. The package ships abi/*.json; a missing file means a damaged install, so reinstall @parabolicfamily/mcp (${e.message})`);
+    }
+    if (!Array.isArray(parsed))
+        throw new Error(`ABI ${file} is not a JSON array`);
+    const abi = parsed;
+    cache.set(name, abi);
+    return abi;
+}
+export const factoryAbi = loadAbi("ParabolicLaunchFactory");
+export const curveAbi = loadAbi("ParabolicBondingCurve");
+export const tokenAbi = loadAbi("ParabolicLauncherToken");
+export const memoRouterAbi = loadAbi("ParabolicMemoRouter");
+/** Names of all functions in an ABI (used to document what the factory can and cannot enumerate). */
+export const functionNames = (abi) => abi.flatMap((e) => (e.type === "function" ? [e.name] : []));
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAEtH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,wBAAwB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,qBAAqB,CAAU,CAAC;AAGvI,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;AAEtC,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IAC3C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,8GAA+G,CAAW,CAAC,OAAO,GAAG,CAAC,CAAC;IAC5L,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,MAAa,CAAC;IAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAQ,OAAO,CAAC,wBAAwB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,QAAQ,GAAQ,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAQ,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,aAAa,GAAQ,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEjE,qGAAqG;AACrG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAQ,EAAY,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/chain.d.ts

@@ -0,0 +1,32 @@
+import { type Abi, type Address, type Chain, type Hex } from "viem";
+/** The narrow RPC surface the server needs; tests substitute an in-memory implementation. */
+export type ReadArgs = {
+    address: Address;
+    abi: Abi;
+    functionName: string;
+    args?: readonly unknown[];
+};
+export type LogsArgs = {
+    address: Address;
+    abi: Abi;
+    eventName: string;
+    fromBlock: bigint;
+    toBlock?: bigint;
+};
+export type DecodedLog = {
+    args: Record<string, unknown>;
+    blockNumber: bigint;
+    transactionHash: Hex;
+    logIndex: number;
+};
+export interface Rpc {
+    read(a: ReadArgs): Promise<unknown>;
+    logs(a: LogsArgs): Promise<DecodedLog[]>;
+    blockNumber(): Promise<bigint>;
+}
+/** Arc chain definition for viem: native USDC with 18-decimal native accounting. */
+export declare function arcChain(chainId: number, rpcUrl: string): Chain;
+/** viem-backed Rpc. HTTP batching folds the many small reads of get_coin / list_coins into a few JSON-RPC requests. */
+export declare function viemRpc(rpcUrl: string, chainId: number): Rpc;
+/** Runs `fn` over `items` with at most `limit` in flight, preserving order. */
+export declare function mapLimit<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/chain.js

@@ -0,0 +1,48 @@
+import { createPublicClient, defineChain, getAbiItem, http } from "viem";
+import { chainName, explorerBase } from "./config.js";
+/** Arc chain definition for viem: native USDC with 18-decimal native accounting. */
+export function arcChain(chainId, rpcUrl) {
+    const explorer = explorerBase(chainId);
+    return defineChain({
+        id: chainId,
+        name: chainName(chainId),
+        nativeCurrency: { name: "USDC", symbol: "USDC", decimals: 18 },
+        rpcUrls: { default: { http: [rpcUrl] } },
+        ...(explorer ? { blockExplorers: { default: { name: "Arcscan", url: explorer } } } : {}),
+        testnet: chainId !== 5042,
+    });
+}
+/** viem-backed Rpc. HTTP batching folds the many small reads of get_coin / list_coins into a few JSON-RPC requests. */
+export function viemRpc(rpcUrl, chainId) {
+    const client = createPublicClient({ chain: arcChain(chainId, rpcUrl), transport: http(rpcUrl, { batch: { batchSize: 50, wait: 5 } }) });
+    return {
+        read: (a) => client.readContract({ address: a.address, abi: a.abi, functionName: a.functionName, args: a.args ?? [] }),
+        async logs(a) {
+            const event = getAbiItem({ abi: a.abi, name: a.eventName });
+            if (!event || event.type !== "event")
+                throw new Error(`No event ${a.eventName} in ABI`);
+            const logs = await client.getLogs({ address: a.address, event, fromBlock: a.fromBlock, toBlock: a.toBlock ?? "latest", strict: false });
+            return logs.map((l) => ({
+                args: (l.args ?? {}),
+                blockNumber: l.blockNumber ?? 0n,
+                transactionHash: (l.transactionHash ?? "0x"),
+                logIndex: l.logIndex ?? 0,
+            }));
+        },
+        blockNumber: () => client.getBlockNumber(),
+    };
+}
+/** Runs `fn` over `items` with at most `limit` in flight, preserving order. */
+export async function mapLimit(items, limit, fn) {
+    const out = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
+        while (next < items.length) {
+            const i = next++;
+            out[i] = await fn(items[i], i);
+        }
+    });
+    await Promise.all(workers);
+    return out;
+}
+//# sourceMappingURL=chain.js.map

package/dist/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"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"}

package/dist/coins.d.ts

@@ -0,0 +1,52 @@
+import { type Address } from "viem";
+import type { GqlCoin } from "./subgraph.js";
+export type StatusKey = "climbing" | "graduated";
+export declare const SORT_KEYS: readonly ["trending", "new", "near_graduation", "market_cap"];
+export type SortKey = (typeof SORT_KEYS)[number];
+export type CoinSummary = {
+    address: Address;
+    curve: Address;
+    name: string;
+    ticker: string;
+    creator: Address;
+    pair: "USDC" | "EURC";
+    pairToken: Address;
+    quoteDecimals: number;
+    status: StatusKey;
+    /** Quote raised on the curve (net of fees), whole units; for a graduated coin the threshold it crossed. */
+    raised: string;
+    raisedRaw: bigint;
+    threshold: string;
+    thresholdRaw: bigint;
+    progressPct: number;
+    /** Whole quote units per whole token. */
+    price: number;
+    marketCap: number;
+    holders?: number;
+    volume24h?: number;
+    change24h?: number;
+    tradeCount?: number;
+    createdAt?: number;
+    lastTradeAt?: number;
+    graduatedAt?: number;
+    poolId?: string;
+    logo?: string;
+    description?: string;
+    launchConfigId?: number;
+    source: "subgraph" | "chain";
+};
+export declare const isNative: (pairToken: string) => boolean;
+export declare const quoteDecimalsOf: (pairToken: string) => number;
+/** Curve progress in percent with three decimals, capped at 100. */
+export declare const progressPct: (raised: bigint, threshold: bigint) => number;
+/**
+ * 24h figures from the coin's two most recent UTC day buckets, the same derivation as web/lib/data.ts:
+ * volume = today + yesterday; change = current price against yesterday's close (or today's open).
+ */
+export declare function dayStats(g: GqlCoin, now: number, quoteDecimals: number): {
+    volume24h: number;
+    change24h: number;
+};
+export declare function summaryFromGql(g: GqlCoin, now?: number): CoinSummary;
+/** Pure sort used by list_coins; `near_graduation` ranks climbing coins by progress and puts graduated ones last. */
+export declare function sortCoins(list: CoinSummary[], sort: SortKey): CoinSummary[];

package/dist/coins.js

@@ -0,0 +1,75 @@
+import { formatUnits, getAddress } from "viem";
+import { NATIVE_QUOTE } from "./config.js";
+import { toNumber } from "./curve.js";
+export const SORT_KEYS = ["trending", "new", "near_graduation", "market_cap"];
+export const isNative = (pairToken) => pairToken.toLowerCase() === NATIVE_QUOTE;
+export const quoteDecimalsOf = (pairToken) => (isNative(pairToken) ? 18 : 6);
+/** Curve progress in percent with three decimals, capped at 100. */
+export const progressPct = (raised, threshold) => (threshold <= 0n ? 0 : Math.min(100, Number((raised * 100000n) / threshold) / 1000));
+const dayOf = (sec) => Math.floor(sec / 86_400);
+/**
+ * 24h figures from the coin's two most recent UTC day buckets, the same derivation as web/lib/data.ts:
+ * volume = today + yesterday; change = current price against yesterday's close (or today's open).
+ */
+export function dayStats(g, now, quoteDecimals) {
+    const today = dayOf(now);
+    const buckets = g.dayData ?? [];
+    const volume24h = buckets.filter((d) => d.day >= today - 1).reduce((sum, d) => sum + toNumber(BigInt(d.volumeQuote), quoteDecimals), 0);
+    const todayBucket = buckets.find((d) => d.day === today);
+    const yesterday = buckets.find((d) => d.day === today - 1);
+    const ref = yesterday ? Number(yesterday.closePrice) : todayBucket ? Number(todayBucket.openPrice) : 0;
+    const current = Number(g.price);
+    const change24h = ref > 0 && current > 0 ? ((current - ref) / ref) * 100 : 0;
+    return { volume24h, change24h };
+}
+export function summaryFromGql(g, now = Math.floor(Date.now() / 1000)) {
+    const native = isNative(g.pairToken);
+    const quoteDecimals = native ? 18 : 6;
+    const graduated = g.status !== "CLIMBING";
+    const raisedRaw = BigInt(g.raised);
+    const thresholdRaw = BigInt(g.graduationThreshold);
+    const { volume24h, change24h } = dayStats(g, now, quoteDecimals);
+    return {
+        address: getAddress(g.id),
+        curve: getAddress(g.curve),
+        name: g.name,
+        ticker: g.symbol,
+        creator: getAddress(g.deployer),
+        pair: native ? "USDC" : "EURC",
+        pairToken: getAddress(g.pairToken),
+        quoteDecimals,
+        status: graduated ? "graduated" : "climbing",
+        raised: formatUnits(graduated ? thresholdRaw : raisedRaw, quoteDecimals),
+        raisedRaw: graduated ? thresholdRaw : raisedRaw,
+        threshold: formatUnits(thresholdRaw, quoteDecimals),
+        thresholdRaw,
+        progressPct: graduated ? 100 : progressPct(raisedRaw, thresholdRaw),
+        price: Number(g.price),
+        marketCap: Number(g.marketCap),
+        holders: Number(g.holderCount),
+        volume24h,
+        change24h,
+        tradeCount: Number(g.tradeCount),
+        createdAt: Number(g.createdAt),
+        lastTradeAt: Number(g.lastTradeAt),
+        graduatedAt: g.graduatedAt ? Number(g.graduatedAt) : undefined,
+        poolId: g.poolId ?? undefined,
+        logo: g.logo || undefined,
+        description: g.description || undefined,
+        launchConfigId: Number(g.launchConfigId),
+        source: "subgraph",
+    };
+}
+const cmpBig = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+const statusRank = (c) => (c.status === "climbing" ? 0 : 1);
+/** Pure sort used by list_coins; `near_graduation` ranks climbing coins by progress and puts graduated ones last. */
+export function sortCoins(list, sort) {
+    const by = {
+        trending: (a, b) => (b.volume24h ?? 0) - (a.volume24h ?? 0) || (b.lastTradeAt ?? 0) - (a.lastTradeAt ?? 0) || cmpBig(b.raisedRaw, a.raisedRaw),
+        new: (a, b) => (b.createdAt ?? 0) - (a.createdAt ?? 0),
+        near_graduation: (a, b) => statusRank(a) - statusRank(b) || b.progressPct - a.progressPct || cmpBig(b.raisedRaw, a.raisedRaw),
+        market_cap: (a, b) => b.marketCap - a.marketCap,
+    };
+    return [...list].sort(by[sort]);
+}
+//# sourceMappingURL=coins.js.map

package/dist/coins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coins.js","sourceRoot":"","sources":["../src/coins.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,55 @@
+import { type Address } from "viem";
+/** Arc's system `Memo` contract (CREATE2, zero salt), verified on Arc Testnet; expected to match on mainnet. */
+export declare const ARC_MEMO_DEFAULT: Address;
+/** ERC-20 view of native USDC on Arc (6 decimals, same balance as the 18-decimal native asset). */
+export declare const USDC_VIEW: Address;
+/** `address(0)` as the pair token means the curve is quoted in native USDC. */
+export declare const NATIVE_QUOTE: Address;
+export declare const DEFAULT_CHAIN_ID = 5042002;
+/**
+ * Deployed Parabolic addresses per chain, so the server is useful with no configuration at all.
+ * The source repository is private; these are the same addresses the site publishes at
+ * https://www.parabolic.family/docs#contracts and that are verified on Arcscan.
+ *
+ * Arc mainnet (5042) opens on 16 September 2026. Its addresses ship in the release that follows the
+ * deployment; until then a mainnet chain id resolves the RPC and nothing else, and any tool that
+ * needs the factory says so.
+ */
+export declare const DEPLOYMENTS: Record<number, {
+    rpcUrl: string;
+    factory?: Address;
+    memoRouter?: Address;
+    eurc?: Address;
+    /** Deployment block. The no-subgraph listing scans TokenLaunched from here; a public RPC refuses a scan from 0. */
+    startBlock?: number;
+}>;
+export declare const DEFAULT_RPC_URL: string;
+export type Config = {
+    /** JSON-RPC endpoint for Arc. */
+    rpcUrl: string;
+    /** 5042002 = Arc Testnet, 5042 = Arc mainnet (id unofficial until Circle publishes it). */
+    chainId: number;
+    /** ParabolicLaunchFactory. Required for on-chain coin lookups and for building launch transactions. */
+    factory?: Address;
+    /** ParabolicMemoRouter. Optional; enables the memo-routed (referral-carrying) buy variant. */
+    memoRouter?: Address;
+    /** Parabolic subgraph GraphQL endpoint. Recommended: listing, holders, volume and stats come from here. */
+    subgraphUrl?: string;
+    /** ERC-20 EURC on Arc, required only to build EURC-quoted launches. */
+    eurc?: Address;
+    /** ParabolicHook (Uniswap v4). Optional; read from `factory.memeHook()` when unset. Used to derive pool ids. */
+    hook?: Address;
+    /** Arc's Memo system contract. */
+    arcMemo: Address;
+    /** Launch config index on the factory; preset 0 is the adopted $5K / $12,500 curve. */
+    launchConfigId: bigint;
+    /** First block to scan for `TokenLaunched` logs when listing without a subgraph. */
+    factoryStartBlock: bigint;
+};
+/** Environment variables the server reads, with their meaning (also rendered by `parabolic.docs`). */
+export declare const ENV_VARS: Array<[name: string, meaning: string]>;
+export declare function configFromEnv(env?: Record<string, string | undefined>): Config;
+export declare const chainName: (chainId: number) => string;
+/** Arcscan base URL for the chain, undefined where there is no explorer (Anvil). */
+export declare const explorerBase: (chainId: number) => string | undefined;
+export declare const explorerUrl: (chainId: number, kind: "address" | "tx", value: string) => string | undefined;

package/dist/config.js

@@ -0,0 +1,86 @@
+import { getAddress, isAddress } from "viem";
+/** Arc's system `Memo` contract (CREATE2, zero salt), verified on Arc Testnet; expected to match on mainnet. */
+export const ARC_MEMO_DEFAULT = "0x5294E9927c3306DcBaDb03fe70b92e01cCede505";
+/** ERC-20 view of native USDC on Arc (6 decimals, same balance as the 18-decimal native asset). */
+export const USDC_VIEW = "0x3600000000000000000000000000000000000000";
+/** `address(0)` as the pair token means the curve is quoted in native USDC. */
+export const NATIVE_QUOTE = "0x0000000000000000000000000000000000000000";
+export const DEFAULT_CHAIN_ID = 5042002;
+/**
+ * Deployed Parabolic addresses per chain, so the server is useful with no configuration at all.
+ * The source repository is private; these are the same addresses the site publishes at
+ * https://www.parabolic.family/docs#contracts and that are verified on Arcscan.
+ *
+ * Arc mainnet (5042) opens on 16 September 2026. Its addresses ship in the release that follows the
+ * deployment; until then a mainnet chain id resolves the RPC and nothing else, and any tool that
+ * needs the factory says so.
+ */
+export const DEPLOYMENTS = {
+    5042002: {
+        rpcUrl: "https://rpc.testnet.arc.io",
+        factory: "0xDA14d24385483c5876e0E170c6135F14Fc3BCEc3",
+        memoRouter: "0x32E6e071eA1Fe58DF86C4D3f419a8BAF2118f505",
+        eurc: "0x89B50855Aa3bE2F677cD6303Cec089B5F319D72a",
+        startBlock: 61040913,
+    },
+    5042: {
+        rpcUrl: "https://rpc.arc.io",
+    },
+};
+export const DEFAULT_RPC_URL = DEPLOYMENTS[DEFAULT_CHAIN_ID].rpcUrl;
+/** Environment variables the server reads, with their meaning (also rendered by `parabolic.docs`). */
+export const ENV_VARS = [
+    ["PARABOLIC_RPC_URL", `Arc JSON-RPC endpoint (default ${DEFAULT_RPC_URL})`],
+    ["PARABOLIC_CHAIN_ID", `chain id (default ${DEFAULT_CHAIN_ID}, Arc Testnet)`],
+    ["PARABOLIC_FACTORY", "ParabolicLaunchFactory address (on-chain lookups, launch transactions, log-scan listing)"],
+    ["PARABOLIC_MEMO_ROUTER", "ParabolicMemoRouter address (memo-routed buys carrying a referral code; EOA-only)"],
+    ["PARABOLIC_SUBGRAPH_URL", "Parabolic subgraph endpoint (listing, holders, volume, protocol stats)"],
+    ["PARABOLIC_EURC", "ERC-20 EURC address (EURC-quoted launches only)"],
+    ["PARABOLIC_HOOK", "ParabolicHook address (optional; read from the factory when unset)"],
+    ["PARABOLIC_ARC_MEMO", `Arc Memo system contract (default ${ARC_MEMO_DEFAULT})`],
+    ["PARABOLIC_LAUNCH_CONFIG_ID", "factory launch config index (default 0)"],
+    ["PARABOLIC_FACTORY_START_BLOCK", "first block for the TokenLaunched log scan (default 0)"],
+];
+function addr(name, v) {
+    if (v === undefined || v.trim() === "")
+        return undefined;
+    const s = v.trim();
+    if (!isAddress(s, { strict: false }))
+        throw new Error(`${name} is not an address: ${s}`);
+    return getAddress(s);
+}
+function int(name, v, fallback) {
+    if (v === undefined || v.trim() === "")
+        return fallback;
+    const n = Number(v.trim());
+    if (!Number.isInteger(n) || n < 0)
+        throw new Error(`${name} must be a non-negative integer, got ${v}`);
+    return n;
+}
+export function configFromEnv(env = process.env) {
+    // Chain id first: every other default is read off the deployment for that chain, so setting
+    // PARABOLIC_CHAIN_ID=5042 alone moves the RPC and the addresses together instead of leaving a
+    // mainnet chain id pointed at the testnet endpoint.
+    const chainId = int("PARABOLIC_CHAIN_ID", env.PARABOLIC_CHAIN_ID, DEFAULT_CHAIN_ID);
+    const known = DEPLOYMENTS[chainId];
+    return {
+        rpcUrl: env.PARABOLIC_RPC_URL?.trim() || known?.rpcUrl || DEFAULT_RPC_URL,
+        chainId,
+        factory: addr("PARABOLIC_FACTORY", env.PARABOLIC_FACTORY) ?? known?.factory,
+        memoRouter: addr("PARABOLIC_MEMO_ROUTER", env.PARABOLIC_MEMO_ROUTER) ?? known?.memoRouter,
+        subgraphUrl: env.PARABOLIC_SUBGRAPH_URL?.trim() || undefined,
+        eurc: addr("PARABOLIC_EURC", env.PARABOLIC_EURC) ?? known?.eurc,
+        hook: addr("PARABOLIC_HOOK", env.PARABOLIC_HOOK),
+        arcMemo: addr("PARABOLIC_ARC_MEMO", env.PARABOLIC_ARC_MEMO) ?? ARC_MEMO_DEFAULT,
+        launchConfigId: BigInt(int("PARABOLIC_LAUNCH_CONFIG_ID", env.PARABOLIC_LAUNCH_CONFIG_ID, 0)),
+        factoryStartBlock: BigInt(int("PARABOLIC_FACTORY_START_BLOCK", env.PARABOLIC_FACTORY_START_BLOCK, known?.startBlock ?? 0)),
+    };
+}
+export const chainName = (chainId) => (chainId === 5042002 ? "Arc Testnet" : chainId === 5042 ? "Arc" : `chain ${chainId}`);
+/** Arcscan base URL for the chain, undefined where there is no explorer (Anvil). */
+export const explorerBase = (chainId) => chainId === 5042002 ? "https://testnet.arcscan.app" : chainId === 5042 ? "https://arcscan.app" : undefined;
+export const explorerUrl = (chainId, kind, value) => {
+    const base = explorerBase(chainId);
+    return base ? `${base}/${kind}/${value}` : undefined;
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/curve.d.ts

@@ -0,0 +1,92 @@
+import { type Address, type Hex } from "viem";
+/**
+ * Bonding-curve math, ported from contracts/src/ParabolicBondingCurve.sol + libraries/ParabolicBondingCurveMath.sol
+ * and web/lib/curve.ts. Everything is bigint in raw units (18-dec tokens, 18-dec native USDC or 6-dec EURC),
+ * matching the contract's integer arithmetic step for step, including the clamped "crossing" buy that fills the
+ * curve's last sellable tokens and refunds the rest.
+ */
+export declare const BPS = 10000n;
+export declare const TOKEN_DECIMALS = 18;
+/** OpenZeppelin Math.mulDiv(a, b, d, Rounding.Ceil) for non-negative inputs. */
+export declare const mulDivCeil: (a: bigint, b: bigint, d: bigint) => bigint;
+/**
+ * Constant-product output for an exact input, net of `feeBps` on the input. Mirrors
+ * ParabolicBondingCurveMath._amountOut; returns 0 where the library would revert (web/lib/curve.ts does the same).
+ * With feeBps = 0 this is exactly `amountIn * reserveOut / (reserveIn + amountIn)`.
+ */
+export declare function getAmountOut(amountIn: bigint, reserveIn: bigint, reserveOut: bigint, feeBps?: bigint): bigint;
+/** Input required for an exact output; mirrors ParabolicBondingCurveMath.getAmountIn (rounds up by one). */
+export declare function getAmountIn(amountOut: bigint, reserveIn: bigint, reserveOut: bigint, feeBps?: bigint): bigint;
+export type CurveTerms = {
+    /** phantomQuote + trackedQuote - fees pending sweep (curve.getReserves()[0]). */
+    quoteReserve: bigint;
+    /** trackedTokens (curve.getReserves()[1]). */
+    tokenReserve: bigint;
+    feeBps: bigint;
+    creatorTaxBps: bigint;
+    /** Snipe tax the buyer pays now (curve.currentSnipeTaxBps(), 0 for exempt buyers); ignored on sells. */
+    snipeBps: bigint;
+    /** curve.sellableTokens(): tokenReserve minus the reserved pool seed. Defaults to the whole reserve when unknown. */
+    sellableTokens?: bigint;
+};
+export type BuyQuote = {
+    tokensOut: bigint;
+    /** Quote actually taken by the curve; equals quoteIn unless the buy is clamped to the last sellable tokens. */
+    spent: bigint;
+    refund: bigint;
+    fee: bigint;
+    creatorTax: bigint;
+    snipeTax: bigint;
+    /** spent - fee - creatorTax - snipeTax: what moves the reserves. */
+    netToCurve: bigint;
+    /** True when the buy takes the curve's last sellable token, which graduates the coin in the same transaction. */
+    crossing: boolean;
+};
+export declare class CurveClosedError extends Error {
+    constructor();
+}
+/** Port of ParabolicBondingCurve._buy pricing: fee legs off the input, constant product, clamp to sellable, refund. */
+export declare function quoteBuy(quoteIn: bigint, t: CurveTerms): BuyQuote;
+export type SellQuote = {
+    quoteOut: bigint;
+    gross: bigint;
+    fee: bigint;
+    creatorTax: bigint;
+};
+/** Port of ParabolicBondingCurve.sell pricing: constant product, then fee and creator tax off the gross quote output. */
+export declare function quoteSell(tokensIn: bigint, t: Pick<CurveTerms, "quoteReserve" | "tokenReserve" | "feeBps" | "creatorTaxBps">): SellQuote;
+/**
+ * The curve enforces `spent * minTokensOut <= received * tokensOut` (a price bound, so a clamped crossing buy still
+ * honours the caller's terms). True when a buy quoted as `q` for `quoteIn` passes with `minTokensOut`.
+ */
+export declare const passesPriceBound: (quoteIn: bigint, q: BuyQuote, minTokensOut: bigint) => boolean;
+export declare const applySlippage: (v: bigint, bps: bigint) => bigint;
+/** Tokens the curve never sells (the v4 pool seed): supply * phantomQuote / (phantomQuote + graduationThreshold), floored. */
+export declare const reservedTokensFor: (supply: bigint, phantomQuote: bigint, graduationThreshold: bigint) => bigint;
+/**
+ * Where the reserved tokens go at graduation. The v4 full-range position is seeded at the curve's terminal price
+ * ((phantom + threshold) / reserved) with the real quote raised, which takes reserved × threshold / (phantom + threshold)
+ * tokens; the rest, the phantom reserve's share, is permanently locked (GraduationTokensPermanentlyLocked).
+ * Adopted parameters: 28.57% reserved → ≈ 20.4% of supply seeds the pool, ≈ 8.2% is locked.
+ */
+export declare const graduationSplit: (reservedTokens: bigint, phantomQuote: bigint, graduationThreshold: bigint) => {
+    poolSeed: bigint;
+    locked: bigint;
+};
+/**
+ * Port of ParabolicBondingCurve.currentSnipeTaxBps: starts at `startBps` when the launch opens and decays to zero at
+ * `windowSeconds` along a quadratic ease-out (remaining² / window²), capped so at least one basis point of the spend
+ * reaches the curve. Integer seconds, like block.timestamp.
+ */
+export declare function snipeTaxBpsAt(elapsedSeconds: bigint, windowSeconds: bigint, startBps: bigint, feeBps: bigint, creatorTaxBps: bigint): bigint;
+export declare const toNumber: (v: bigint, decimals?: number) => number;
+/** Spot market cap in whole quote units for `supply` at the current curve price (quoteDecimals 18 for native USDC, 6 for EURC). */
+export declare const marketCap: (quoteReserve: bigint, tokenReserve: bigint, supply: bigint, quoteDecimals?: number) => number;
+/** Market cap at the price the v4 pool is seeded with: (phantomQuote + graduationThreshold) / reservedTokens. */
+export declare const graduationMarketCap: (phantomQuote: bigint, graduationThreshold: bigint, reservedTokens: bigint, supply: bigint, quoteDecimals?: number) => number;
+/** Spot price in whole quote units per whole token. */
+export declare const spotPrice: (quoteReserve: bigint, tokenReserve: bigint, quoteDecimals?: number) => number;
+/** Price impact in percent of a fill (gross amount in, amount out) against the spot price; same definition as the web trade panel. */
+export declare const priceImpact: (amountIn: bigint, amountOut: bigint, reserveIn: bigint, reserveOut: bigint) => number;
+/** Uniswap v4 PoolId = keccak256(abi.encode(PoolKey)) with currency0 < currency1 (native USDC, address(0), is always currency0). */
+export declare const poolIdOf: (token: Address, pairToken: Address, fee: number, tickSpacing: number, hooks: Address) => Hex;