@parabolicfamily/mcp 0.1.0

package/dist/parabolic.d.ts

@@ -0,0 +1,780 @@
+import { type Address } from "viem";
+import { type Rpc } from "./chain.js";
+import { type CoinSummary, type SortKey, type StatusKey } from "./coins.js";
+import { type Config } from "./config.js";
+import { Subgraph, type Fetch } from "./subgraph.js";
+import { type Socials, type TokenParams } from "./tx.js";
+export declare const PHASES: readonly ["NotGraduated", "Swept", "PoolCreated", "Rescued"];
+export declare const DEFAULT_SLIPPAGE_BPS = 100;
+export declare const DEV_BUY_SLIPPAGE_BPS = 200n;
+/** ParabolicLaunchDeployer metadata caps, in bytes. */
+export declare const METADATA_LIMITS: {
+    readonly name: 64;
+    readonly symbol: 16;
+    readonly logo: 512;
+    readonly description: 2048;
+    readonly social: 256;
+};
+/** Newest launches the TokenLaunched log scan considers when no subgraph is configured. */
+export declare const CHAIN_LIST_MAX = 50;
+export type Launch = {
+    token: Address;
+    curve: Address;
+    deployer: Address;
+    creatorFeeRecipient?: Address;
+    pairToken: Address;
+    graduationThreshold: bigint;
+    poolFee?: number;
+    tickSpacing?: number;
+    creatorTaxBps?: number;
+    buybackEnabled?: boolean;
+    phase?: number;
+    source: "factory" | "subgraph";
+};
+export type ListInput = {
+    status?: StatusKey;
+    sort?: SortKey;
+    limit?: number;
+};
+export type QuoteBuyInput = {
+    address: string;
+    quoteIn: string | number;
+    buyer?: string;
+    slippageBps?: number;
+};
+export type QuoteSellInput = {
+    address: string;
+    tokensIn: string | number;
+    slippageBps?: number;
+};
+export type BuildBuyInput = QuoteBuyInput & {
+    minTokensOut?: string | number;
+    recipient: string;
+    memo?: {
+        referral?: string;
+        note?: string;
+    };
+};
+export type BuildSellInput = QuoteSellInput & {
+    minQuoteOut?: string | number;
+    recipient: string;
+};
+export type BuildLaunchInput = {
+    name: string;
+    ticker: string;
+    image?: string;
+    description?: string;
+    socials?: Partial<Socials>;
+    pair?: "USDC" | "EURC";
+    devBuy?: string | number;
+    creatorTaxBps?: number;
+    creator: string;
+    buybackEnabled?: boolean;
+};
+/**
+ * Read-only view of Parabolic plus unsigned-transaction builders. Holds no keys; every method either reads
+ * (RPC and/or subgraph) or encodes calldata for the caller's wallet to sign.
+ */
+export declare class Parabolic {
+    readonly config: Config;
+    readonly rpc: Rpc;
+    readonly subgraph: Subgraph | undefined;
+    private hookPromise;
+    constructor(config: Config, deps?: {
+        rpc?: Rpc;
+        fetch?: Fetch;
+    });
+    private read;
+    private readMany;
+    private requireFactory;
+    private hookAddress;
+    private launchFromFactory;
+    private launchFromGql;
+    /** Finds a launch by token address (or curve address) through the factory, falling back to the subgraph. */
+    resolveLaunch(input: string): Promise<Launch>;
+    private liveTerms;
+    private assertOpen;
+    listCoins(input?: ListInput): Promise<{
+        source: string;
+        sort: "trending" | "new" | "near_graduation" | "market_cap";
+        status: string;
+        count: number;
+        coins: CoinSummary[];
+    }>;
+    /**
+     * Newest TokenLaunched logs, walked backwards from head in bounded windows.
+     *
+     * A single scan from the deployment block is refused by every public Arc RPC: they cap eth_getLogs
+     * at about 10,000 blocks and answer `requested range too large`, so the old unbounded scan made
+     * list_coins fail outright on a default install. Walking back a window at a time returns the newest
+     * launches, which is what this listing promises, and stops as soon as it has enough. A rate-limited
+     * or refused window ends the walk with what has been collected rather than failing the call.
+     *
+     * This covers recent history only. PARABOLIC_SUBGRAPH_URL is the full list, and carries holders and
+     * volume with it.
+     */
+    private recentLaunchLogs;
+    private chainCoins;
+    getCoin(address: string): Promise<{
+        holders: number | null;
+        volume24h: number | null;
+        change24h: number | null;
+        tradeCount: number | null;
+        lastTradeAt: number | null;
+        pool: {
+            poolId: string | null;
+            positionId: string | null;
+            poolFee: number | null;
+            tickSpacing: number | null;
+            hook: `0x${string}` | null;
+        };
+        logo: string;
+        description: string;
+        indexed: {
+            status: import("./subgraph.js").GqlCoinStatus;
+            graduatedAt: number | null;
+            volumeQuote: {
+                amount: string;
+                raw: string;
+            };
+            buyCount: number;
+            sellCount: number;
+        } | null;
+        sources: {
+            chain: string;
+            subgraph: string;
+        };
+        address: `0x${string}`;
+        curve: `0x${string}`;
+        name: string;
+        ticker: string;
+        creator: `0x${string}`;
+        creatorFeeRecipient: `0x${string}` | null;
+        pair: string;
+        pairToken: `0x${string}`;
+        quoteDecimals: number;
+        status: string;
+        phase: "NotGraduated" | "Swept" | "PoolCreated" | "Rescued";
+        readyToGraduate: boolean;
+        raised: {
+            amount: string;
+            raw: string;
+        };
+        threshold: {
+            amount: string;
+            raw: string;
+        };
+        progressPct: number;
+        price: number;
+        marketCap: number;
+        marketCapSource: string;
+        supply: {
+            amount: string;
+            raw: string;
+        };
+        reserves: {
+            quote: {
+                amount: string;
+                raw: string;
+            };
+            tokens: {
+                amount: string;
+                raw: string;
+            };
+            realQuote: {
+                amount: string;
+                raw: string;
+            };
+            phantomQuote: {
+                amount: string;
+                raw: string;
+            };
+            reservedTokens: {
+                amount: string;
+                raw: string;
+            };
+            sellableTokens: {
+                amount: string;
+                raw: string;
+            };
+        };
+        fees: {
+            feeBps: number;
+            creatorTaxBps: number;
+            split: {
+                protocolBps: number;
+                buybackBps: number;
+                creatorBps: number;
+                note: string;
+            };
+            policy: {
+                protocolFeeShareBps: number;
+                buybackBurnBps: number;
+            };
+        };
+        snipeTax: {
+            currentBps: number;
+            startBps: number;
+            windowSeconds: number;
+            launchedAt: number;
+            windowEndsAt: number;
+            windowOpen: boolean;
+            secondsRemaining: number;
+            exempt: string;
+        };
+        createdAt: number | null;
+        socials: {
+            twitter: string;
+            telegram: string;
+            discord: string;
+            website: string;
+            farcaster: string;
+        };
+        links: {
+            app: string;
+            token: string | null;
+            curve: string | null;
+            creator: string | null;
+        };
+        source: string;
+    }>;
+    private chainDetail;
+    private buyerSnipeBps;
+    quoteBuy(input: QuoteBuyInput): Promise<{
+        side: string;
+        coin: `0x${string}`;
+        curve: `0x${string}`;
+        pair: string;
+        quoteIn: {
+            amount: string;
+            raw: string;
+        };
+        tokensOut: {
+            amount: string;
+            raw: string;
+        };
+        minTokensOut: {
+            slippageBps: number;
+            amount: string;
+            raw: string;
+        };
+        spent: {
+            amount: string;
+            raw: string;
+        };
+        refund: {
+            amount: string;
+            raw: string;
+        };
+        fees: {
+            totalBps: number;
+            fee: {
+                amount: string;
+                raw: string;
+                bps: number;
+            };
+            creatorTax: {
+                amount: string;
+                raw: string;
+                bps: number;
+            };
+            snipeTax: {
+                windowOpen: boolean;
+                buyerExempt: boolean;
+                amount: string;
+                raw: string;
+                bps: number;
+            };
+            netToCurve: {
+                amount: string;
+                raw: string;
+            };
+        };
+        spotPrice: number;
+        effectivePrice: number;
+        priceImpactPct: number;
+        graduatesCoin: boolean;
+        reserves: {
+            quote: {
+                amount: string;
+                raw: string;
+            };
+            tokens: {
+                amount: string;
+                raw: string;
+            };
+            sellableTokens: {
+                amount: string;
+                raw: string;
+            };
+        };
+        notes: string[];
+    }>;
+    quoteSell(input: QuoteSellInput): Promise<{
+        side: string;
+        coin: `0x${string}`;
+        curve: `0x${string}`;
+        pair: string;
+        tokensIn: {
+            amount: string;
+            raw: string;
+        };
+        quoteOut: {
+            amount: string;
+            raw: string;
+        };
+        minQuoteOut: {
+            slippageBps: number;
+            amount: string;
+            raw: string;
+        };
+        fees: {
+            totalBps: number;
+            fee: {
+                amount: string;
+                raw: string;
+                bps: number;
+            };
+            creatorTax: {
+                amount: string;
+                raw: string;
+                bps: number;
+            };
+            gross: {
+                amount: string;
+                raw: string;
+            };
+            snipeTax: {
+                bps: number;
+                note: string;
+            };
+        };
+        spotPrice: number;
+        effectivePrice: number;
+        priceImpactPct: number;
+        reserves: {
+            quote: {
+                amount: string;
+                raw: string;
+            };
+            tokens: {
+                amount: string;
+                raw: string;
+            };
+        };
+        notes: string[];
+    }>;
+    buildBuyTx(input: BuildBuyInput): Promise<{
+        kind: string;
+        coin: `0x${string}`;
+        curve: `0x${string}`;
+        eoaOnly: boolean;
+        steps: string[];
+        approval: import("./tx.js").UnsignedTx;
+        tx: import("./tx.js").UnsignedTx;
+        usdcUnits: string;
+        memo: {
+            id: `0x${string}`;
+            payload: `0x${string}`;
+            referral: string | null;
+            note: string;
+        };
+        quote: {
+            quoteIn: {
+                amount: string;
+                raw: string;
+            };
+            expectedTokensOut: {
+                amount: string;
+                raw: string;
+            };
+            minTokensOut: {
+                amount: string;
+                raw: string;
+            };
+            slippageBps: number | null;
+            fees: {
+                feeBps: number;
+                creatorTaxBps: number;
+                snipeTaxBps: number;
+                buyerExempt: boolean;
+            };
+            priceImpactPct: number;
+            graduatesCoin: boolean;
+            refund: {
+                amount: string;
+                raw: string;
+            };
+        };
+        gas: {
+            note: string;
+        };
+        warnings: string[];
+        notes: string[];
+    } | {
+        kind: string;
+        coin: `0x${string}`;
+        curve: `0x${string}`;
+        steps: string[];
+        approval: import("./tx.js").UnsignedTx | null;
+        tx: import("./tx.js").UnsignedTx;
+        quote: {
+            quoteIn: {
+                amount: string;
+                raw: string;
+            };
+            expectedTokensOut: {
+                amount: string;
+                raw: string;
+            };
+            minTokensOut: {
+                amount: string;
+                raw: string;
+            };
+            slippageBps: number | null;
+            fees: {
+                feeBps: number;
+                creatorTaxBps: number;
+                snipeTaxBps: number;
+                buyerExempt: boolean;
+            };
+            priceImpactPct: number;
+            graduatesCoin: boolean;
+            refund: {
+                amount: string;
+                raw: string;
+            };
+        };
+        gas: {
+            note: string;
+        };
+        warnings: string[];
+        notes: string[];
+        eoaOnly?: undefined;
+        usdcUnits?: undefined;
+        memo?: undefined;
+    }>;
+    buildSellTx(input: BuildSellInput): Promise<{
+        kind: string;
+        coin: `0x${string}`;
+        curve: `0x${string}`;
+        steps: string[];
+        approval: import("./tx.js").UnsignedTx;
+        tx: import("./tx.js").UnsignedTx;
+        quote: {
+            tokensIn: {
+                amount: string;
+                raw: string;
+            };
+            expectedQuoteOut: {
+                amount: string;
+                raw: string;
+            };
+            minQuoteOut: {
+                amount: string;
+                raw: string;
+            };
+            slippageBps: number | null;
+            fees: {
+                feeBps: number;
+                creatorTaxBps: number;
+            };
+            priceImpactPct: number;
+        };
+        warnings: string[];
+        notes: string[];
+    }>;
+    buildLaunchTx(input: BuildLaunchInput): Promise<{
+        snipeTaxExemptions: never[];
+        devBuy: {
+            quoteIn: {
+                amount: string;
+                raw: string;
+            };
+            expectedTokensOut: {
+                amount: string;
+                raw: string;
+            };
+            minTokensOut: {
+                slippageBps: number;
+                amount: string;
+                raw: string;
+            };
+            fees: {
+                feeBps: number;
+                creatorTaxBps: number;
+                snipeTaxBps: number;
+            };
+            graduatesCoin: boolean;
+            refund: {
+                amount: string;
+                raw: string;
+            };
+            atomic: boolean;
+        };
+        events: string[];
+        notes: string[];
+        params: TokenParams;
+        launchConfigId: string;
+        pair: "USDC" | "EURC";
+        pairToken: `0x${string}`;
+        launchFee: {
+            amount: string;
+            raw: string;
+        };
+        terms: {
+            supply: {
+                amount: string;
+                raw: string;
+            };
+            curveFeeBps: number;
+            creatorTaxBps: number;
+            phantomQuote: {
+                amount: string;
+                raw: string;
+            };
+            graduationThreshold: {
+                amount: string;
+                raw: string;
+            };
+            reservedTokens: {
+                pct: number;
+                amount: string;
+                raw: string;
+            };
+            poolSeedTokens: {
+                pct: number;
+                amount: string;
+                raw: string;
+            };
+            lockedTokens: {
+                pct: number;
+                amount: string;
+                raw: string;
+            };
+            openingMarketCap: number;
+            graduationMarketCap: number;
+            snipeTax: {
+                startBps: number;
+                windowSeconds: number;
+            };
+            poolFee: number;
+            tickSpacing: number;
+        };
+        event: string;
+        warnings: string[];
+        kind: string;
+        tx: import("./tx.js").UnsignedTx;
+        approval: import("./tx.js").UnsignedTx | null;
+        steps: string[];
+    } | {
+        devBuy: {
+            approvalNeeded: string | null;
+            quoteIn: {
+                amount: string;
+                raw: string;
+            };
+            expectedTokensOut: {
+                amount: string;
+                raw: string;
+            };
+            minTokensOut: {
+                slippageBps: number;
+                amount: string;
+                raw: string;
+            };
+            fees: {
+                feeBps: number;
+                creatorTaxBps: number;
+                snipeTaxBps: number;
+            };
+            graduatesCoin: boolean;
+            refund: {
+                amount: string;
+                raw: string;
+            };
+            atomic: boolean;
+            how: string;
+            to: null;
+            toHint: string;
+            data: `0x${string}`;
+            value: `0x${string}`;
+            valueWei: string;
+            chainId: number;
+        } | null;
+        notes: string[];
+        params: TokenParams;
+        launchConfigId: string;
+        pair: "USDC" | "EURC";
+        pairToken: `0x${string}`;
+        launchFee: {
+            amount: string;
+            raw: string;
+        };
+        terms: {
+            supply: {
+                amount: string;
+                raw: string;
+            };
+            curveFeeBps: number;
+            creatorTaxBps: number;
+            phantomQuote: {
+                amount: string;
+                raw: string;
+            };
+            graduationThreshold: {
+                amount: string;
+                raw: string;
+            };
+            reservedTokens: {
+                pct: number;
+                amount: string;
+                raw: string;
+            };
+            poolSeedTokens: {
+                pct: number;
+                amount: string;
+                raw: string;
+            };
+            lockedTokens: {
+                pct: number;
+                amount: string;
+                raw: string;
+            };
+            openingMarketCap: number;
+            graduationMarketCap: number;
+            snipeTax: {
+                startBps: number;
+                windowSeconds: number;
+            };
+            poolFee: number;
+            tickSpacing: number;
+        };
+        event: string;
+        warnings: string[];
+        kind: string;
+        tx: import("./tx.js").UnsignedTx;
+        steps: string[];
+    }>;
+    protocolStats(): Promise<{
+        chain: {
+            id: number;
+            name: string;
+            rpc: string;
+        };
+        indexed: {
+            coinsLaunched: number;
+            coinsGraduated: number;
+            graduationRatePct: number;
+            tradeCount: number;
+            volume: {
+                amount: string;
+                raw: string;
+            };
+            fees: {
+                amount: string;
+                raw: string;
+            };
+            today: {
+                day: number;
+                date: string;
+                coinsLaunched: number;
+                coinsGraduated: number;
+                tradeCount: number;
+                volume: {
+                    amount: string;
+                    raw: string;
+                };
+                fees: {
+                    amount: string;
+                    raw: string;
+                };
+            } | null;
+            daily: {
+                day: number;
+                date: string;
+                coinsLaunched: number;
+                coinsGraduated: number;
+                tradeCount: number;
+                volume: {
+                    amount: string;
+                    raw: string;
+                };
+                fees: {
+                    amount: string;
+                    raw: string;
+                };
+            }[];
+            units: string;
+        } | {
+            error: string;
+        } | null;
+        factory: {
+            address: `0x${string}`;
+            launchFee: {
+                amount: string;
+                raw: string;
+            };
+            launchEnabled: boolean;
+            maxCreatorTaxBps: number;
+            snipeTax: {
+                startBps: number;
+                windowSeconds: number;
+            };
+            launchConfigCount: number;
+            launchConfig: {
+                id: string;
+                enabled: boolean;
+                supply: {
+                    amount: string;
+                    raw: string;
+                };
+                curveFeeBps: number;
+                phantomQuote: {
+                    amount: string;
+                    raw: string;
+                };
+                graduationThreshold: {
+                    amount: string;
+                    raw: string;
+                };
+                reservedTokens: {
+                    amount: string;
+                    raw: string;
+                };
+                reservedPct: number;
+                poolSeedTokens: {
+                    amount: string;
+                    raw: string;
+                };
+                poolSeedPct: number;
+                lockedTokens: {
+                    amount: string;
+                    raw: string;
+                };
+                lockedPct: number;
+                openingMarketCap: number;
+                graduationMarketCap: number;
+                poolFee: number;
+                tickSpacing: number;
+            };
+            contracts: {
+                feeEscrow: `0x${string}`;
+                buybackVault: `0x${string}`;
+                locker: `0x${string}`;
+                hook: `0x${string}`;
+                poolManager: `0x${string}`;
+                positionManager: `0x${string}`;
+                launchDeployer: `0x${string}`;
+                graduationExecutor: `0x${string}`;
+                launchForwarder: `0x${string}`;
+                owner: `0x${string}`;
+            };
+        } | {
+            error: string;
+        } | null;
+        notes: string[];
+    }>;
+    private factoryStats;
+    docs(): string;
+}