fourmm 0.1.0

package/dist/lib/pricing.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Token pricing.
+ *
+ * Dual-path:
+ *   1. Bonding curve (liquidityAdded=false) → read on-chain
+ *      TokenManagerHelper3.getTokenInfo.lastPrice directly. No network round-trip
+ *      to a third-party pricing API.
+ *   2. Graduated (liquidityAdded=true) → query GeckoTerminal
+ *      (`/api/v2/networks/bsc/tokens/{address}`) for PancakeSwap-derived price.
+ *
+ * BNB→USD conversion uses CoinGecko's free simple-price endpoint, cached for
+ * 60 seconds in DataStore's global/bnb-price.json.
+ *
+ * All price outputs are in BNB per token (float). The raw on-chain lastPrice
+ * is BNB-wei per smallest-token-unit (18 decimals); for meme tokens the price
+ * is tiny (well below 1e-6 BNB), so converting via Number() is safe in
+ * practice. If Week 3 bot code cares about sub-wei precision we'll switch to
+ * BigInt-to-string formatting.
+ */
+import type { Address, PublicClient } from 'viem';
+import type { TradingPathKind } from '../datastore/types.js';
+/**
+ * Where the price value came from (freshness axis).
+ *
+ * - `live`  → just fetched from Helper3 or GeckoTerminal this invocation
+ * - `cache` → served from DataStore pool-info within TTL
+ * - `stale` → cache hit beyond TTL but upstream fetch failed (best-effort)
+ */
+export type PriceOrigin = 'live' | 'cache' | 'stale';
+export type TokenPrice = {
+    ca: Address;
+    priceBnb: number;
+    priceUsd: number;
+    /** Trading path: bonding-curve / pancake (static token property) */
+    path: TradingPathKind;
+    /** Freshness of this value */
+    origin: PriceOrigin;
+    /** Unix ms */
+    updatedAt: number;
+    liquidityAdded: boolean;
+};
+/**
+ * Get the current price of a Four.meme token.
+ *
+ * Cache-through: checks DataStore pool-info first; on miss or expiry,
+ * fetches live and writes back. Network failures are surfaced via
+ * throwing, but we fall back to cache if the fresh fetch fails and a stale
+ * value exists.
+ */
+export declare function getTokenPrice(client: PublicClient, ca: Address, options?: {
+    fetchImpl?: typeof fetch | undefined;
+}): Promise<TokenPrice>;
+/**
+ * Get BNB → USD price with 60s cache.
+ *
+ * Primary source: on-chain PancakeSwap WBNB/USDT pair reserves (no external
+ * API dependency — uses the same viem client that's already working for RPC).
+ *
+ * Fallback: CoinGecko simple/price endpoint (may fail in restricted networks).
+ */
+export declare function getBnbUsdPrice(clientOrFetch?: PublicClient | typeof fetch | undefined): Promise<number>;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/lib/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/lib/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAwBjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEpD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,IAAI,EAAE,eAAe,CAAA;IACrB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,CAAA;IACnB,cAAc;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,OAAO,CAAA;CACxB,CAAA;AAcD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,OAAO,EACX,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAA;CAAO,GACrD,OAAO,CAAC,UAAU,CAAC,CAmJrB;AAuCD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,aAAa,CAAC,EAAE,YAAY,GAAG,OAAO,KAAK,GAAG,SAAS,GACtD,OAAO,CAAC,MAAM,CAAC,CA0DjB"}

package/dist/lib/pricing.js

@@ -0,0 +1,302 @@
+/**
+ * Token pricing.
+ *
+ * Dual-path:
+ *   1. Bonding curve (liquidityAdded=false) → read on-chain
+ *      TokenManagerHelper3.getTokenInfo.lastPrice directly. No network round-trip
+ *      to a third-party pricing API.
+ *   2. Graduated (liquidityAdded=true) → query GeckoTerminal
+ *      (`/api/v2/networks/bsc/tokens/{address}`) for PancakeSwap-derived price.
+ *
+ * BNB→USD conversion uses CoinGecko's free simple-price endpoint, cached for
+ * 60 seconds in DataStore's global/bnb-price.json.
+ *
+ * All price outputs are in BNB per token (float). The raw on-chain lastPrice
+ * is BNB-wei per smallest-token-unit (18 decimals); for meme tokens the price
+ * is tiny (well below 1e-6 BNB), so converting via Number() is safe in
+ * practice. If Week 3 bot code cares about sub-wei precision we'll switch to
+ * BigInt-to-string formatting.
+ */
+import { TOKEN_MANAGER_HELPER3, PANCAKE_V2_FACTORY, WBNB } from './const.js';
+import { tokenManagerHelper3Abi } from '../contracts/tokenManagerHelper3.js';
+import { getDataStore } from '../datastore/index.js';
+import { loadConfig } from './config.js';
+// PancakeFactory getPair — to resolve LP pair address for graduated tokens
+const pancakeFactoryAbi = [
+    {
+        type: 'function',
+        name: 'getPair',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'tokenA', type: 'address' },
+            { name: 'tokenB', type: 'address' },
+        ],
+        outputs: [{ name: 'pair', type: 'address' }],
+    },
+];
+// ============================================================
+// Constants
+// ============================================================
+const BNB_DECIMALS = 18;
+const POOL_CACHE_TTL_MS = 30_000;
+const BNB_PRICE_TTL_MS = 60_000;
+// ============================================================
+// Public API
+// ============================================================
+/**
+ * Get the current price of a Four.meme token.
+ *
+ * Cache-through: checks DataStore pool-info first; on miss or expiry,
+ * fetches live and writes back. Network failures are surfaced via
+ * throwing, but we fall back to cache if the fresh fetch fails and a stale
+ * value exists.
+ */
+export async function getTokenPrice(client, ca, options = {}) {
+    const ds = getDataStore();
+    // Check cached pool-info first
+    const cached = ds.getPoolInfo(ca);
+    const now = Date.now();
+    if (cached && now - cached.updatedAt < POOL_CACHE_TTL_MS) {
+        return {
+            ca,
+            priceBnb: cached.priceBnb,
+            priceUsd: cached.priceUsd,
+            path: cached.path,
+            origin: 'cache',
+            updatedAt: cached.updatedAt,
+            liquidityAdded: cached.path === 'pancake',
+        };
+    }
+    // Hit Helper3 to learn graduation status + on-chain lastPrice
+    let info;
+    try {
+        info = await client.readContract({
+            address: TOKEN_MANAGER_HELPER3,
+            abi: tokenManagerHelper3Abi,
+            functionName: 'getTokenInfo',
+            args: [ca],
+        });
+    }
+    catch (err) {
+        if (cached) {
+            // Fresh fetch failed — return the stale cache we have
+            return {
+                ca,
+                priceBnb: cached.priceBnb,
+                priceUsd: cached.priceUsd,
+                path: cached.path,
+                origin: 'stale',
+                updatedAt: cached.updatedAt,
+                liquidityAdded: cached.path === 'pancake',
+            };
+        }
+        throw new Error(`pricing.getTokenPrice(${ca}): Helper3 read failed${err instanceof Error ? `: ${err.message}` : ''}`);
+    }
+    const version = info[0];
+    const lastPrice = info[3];
+    const liquidityAdded = info[11];
+    if (version === 0n) {
+        throw new Error(`pricing.getTokenPrice(${ca}): token not found on Four.meme`);
+    }
+    // ---- Branch 1: bonding curve ----
+    if (!liquidityAdded) {
+        const priceBnb = Number(lastPrice) / 10 ** BNB_DECIMALS;
+        const bnbUsd = await getBnbUsdPrice(client).catch(() => 0);
+        const priceUsd = priceBnb * bnbUsd;
+        ds.savePoolInfo({
+            ca,
+            pairAddress: '',
+            path: 'bonding-curve',
+            priceBnb,
+            priceUsd,
+            graduationProgress: null,
+            updatedAt: now,
+        });
+        return {
+            ca,
+            priceBnb,
+            priceUsd,
+            path: 'bonding-curve',
+            origin: 'live',
+            updatedAt: now,
+            liquidityAdded: false,
+        };
+    }
+    // ---- Branch 2: graduated → GeckoTerminal ----
+    const gecko = await fetchGeckoTerminalPrice(ca, options.fetchImpl).catch(() => null);
+    if (!gecko) {
+        if (cached) {
+            return {
+                ca,
+                priceBnb: cached.priceBnb,
+                priceUsd: cached.priceUsd,
+                path: cached.path,
+                origin: 'stale',
+                updatedAt: cached.updatedAt,
+                liquidityAdded: true,
+            };
+        }
+        throw new Error(`pricing.getTokenPrice(${ca}): token has graduated but GeckoTerminal fetch failed`);
+    }
+    const bnbUsd = await getBnbUsdPrice(client).catch(() => 0);
+    const priceUsd = gecko.priceUsd;
+    // Convert USD → BNB when we know the BNB price
+    const priceBnb = bnbUsd > 0 ? priceUsd / bnbUsd : 0;
+    // Resolve PancakeSwap LP pair address so `query kline` can auto-resolve it
+    let pairAddress = '';
+    try {
+        const pair = await client.readContract({
+            address: PANCAKE_V2_FACTORY,
+            abi: pancakeFactoryAbi,
+            functionName: 'getPair',
+            args: [ca, WBNB],
+        });
+        if (pair && pair !== '0x0000000000000000000000000000000000000000') {
+            pairAddress = pair;
+        }
+    }
+    catch {
+        // Factory query failed — pairAddress stays empty, kline needs --pool
+    }
+    ds.savePoolInfo({
+        ca,
+        pairAddress,
+        path: 'pancake',
+        priceBnb,
+        priceUsd,
+        graduationProgress: null,
+        updatedAt: now,
+    });
+    return {
+        ca,
+        priceBnb,
+        priceUsd,
+        path: 'pancake',
+        origin: 'live',
+        updatedAt: now,
+        liquidityAdded: true,
+    };
+}
+// ============================================================
+// BNB / USD price (CoinGecko)
+// ============================================================
+/**
+ * Get BNB → USD price with 60s cache.
+ *
+ * We use CoinGecko's public `simple/price` endpoint (no auth). If it fails
+ * or is rate-limited, we return the cached value if present, else 0 (so the
+ * rest of the pipeline still returns a priceBnb but priceUsd will be 0).
+ */
+// PancakeSwap WBNB/USDT pair — used for on-chain BNB/USD pricing
+// This avoids depending on external APIs (CoinGecko/GeckoTerminal) that
+// may be unreachable from certain environments (e.g. WSL2 TLS issues).
+const PANCAKE_WBNB_USDT_PAIR = '0x16b9a82891338f9ba80e2d6970fdda79d1eb0dae';
+const pairReservesAbi = [
+    {
+        type: 'function',
+        name: 'getReserves',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [
+            { name: 'reserve0', type: 'uint112' },
+            { name: 'reserve1', type: 'uint112' },
+            { name: 'blockTimestampLast', type: 'uint32' },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'token0',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'address' }],
+    },
+];
+/**
+ * Get BNB → USD price with 60s cache.
+ *
+ * Primary source: on-chain PancakeSwap WBNB/USDT pair reserves (no external
+ * API dependency — uses the same viem client that's already working for RPC).
+ *
+ * Fallback: CoinGecko simple/price endpoint (may fail in restricted networks).
+ */
+export async function getBnbUsdPrice(clientOrFetch) {
+    const ds = getDataStore();
+    const cached = ds.getBnbPrice();
+    const now = Date.now();
+    if (cached && now - cached.updatedAt < BNB_PRICE_TTL_MS) {
+        return cached.priceUsd;
+    }
+    // Try on-chain first: read PancakeSwap WBNB/USDT reserves
+    if (clientOrFetch && typeof clientOrFetch === 'object' && 'readContract' in clientOrFetch) {
+        const client = clientOrFetch;
+        try {
+            const token0 = await client.readContract({
+                address: PANCAKE_WBNB_USDT_PAIR,
+                abi: pairReservesAbi,
+                functionName: 'token0',
+            });
+            const [reserve0, reserve1] = await client.readContract({
+                address: PANCAKE_WBNB_USDT_PAIR,
+                abi: pairReservesAbi,
+                functionName: 'getReserves',
+            });
+            // Determine which reserve is WBNB and which is USDT
+            const wbnbLower = WBNB.toLowerCase();
+            const isToken0Wbnb = token0.toLowerCase() === wbnbLower;
+            const wbnbReserve = isToken0Wbnb ? reserve0 : reserve1;
+            const usdtReserve = isToken0Wbnb ? reserve1 : reserve0;
+            // WBNB = 18 decimals, USDT = 18 decimals on BSC
+            if (wbnbReserve > 0n) {
+                const price = Number(usdtReserve) / Number(wbnbReserve);
+                if (price > 0) {
+                    ds.saveBnbPrice(price);
+                    return price;
+                }
+            }
+        }
+        catch {
+            // On-chain query failed — try API fallback
+        }
+    }
+    // Fallback: CoinGecko API
+    try {
+        const fetchFn = (typeof clientOrFetch === 'function' ? clientOrFetch : globalThis.fetch);
+        const res = await fetchFn('https://api.coingecko.com/api/v3/simple/price?ids=binancecoin&vs_currencies=usd');
+        if (!res.ok)
+            return cached?.priceUsd ?? 0;
+        const json = (await res.json());
+        const price = json.binancecoin?.usd;
+        if (typeof price === 'number' && price > 0) {
+            ds.saveBnbPrice(price);
+            return price;
+        }
+    }
+    catch {
+        // API also failed
+    }
+    return cached?.priceUsd ?? 0;
+}
+async function fetchGeckoTerminalPrice(ca, fetchImpl) {
+    const fetchFn = fetchImpl ?? globalThis.fetch;
+    const config = loadConfig();
+    const url = `${config.geckoTerminalUrl}/networks/bsc/tokens/${ca}`;
+    try {
+        const res = await fetchFn(url, {
+            headers: { accept: 'application/json' },
+        });
+        if (!res.ok)
+            return null;
+        const json = (await res.json());
+        const raw = json.data?.attributes?.price_usd;
+        if (!raw)
+            return null;
+        const priceUsd = Number.parseFloat(raw);
+        if (!Number.isFinite(priceUsd) || priceUsd <= 0)
+            return null;
+        return { priceUsd };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pricing.js.map

package/dist/lib/pricing.js.map

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

package/dist/lib/routing.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Trading path resolution.
+ *
+ * Every trade / tools command MUST call `resolveTradingPath(client, ca)`
+ * before any on-chain write. The result tells the caller which contract
+ * interface to use (bonding-curve TokenManager2 vs graduated PancakeSwap
+ * router) AND exposes the raw Helper3.getTokenInfo result so downstream
+ * code can reuse fields (launchTime, offers, funds, etc.) without firing
+ * another RPC call.
+ *
+ * This is the single source of truth for routing — do NOT hardcode
+ * TOKEN_MANAGER_V2 anywhere else.
+ */
+import type { Address, PublicClient, ReadContractReturnType } from 'viem';
+import { tokenManagerHelper3Abi } from '../contracts/tokenManagerHelper3.js';
+/** The raw tuple that Helper3.getTokenInfo returns */
+export type GetTokenInfoResult = ReadContractReturnType<typeof tokenManagerHelper3Abi, 'getTokenInfo'>;
+export type BondingCurvePath = {
+    path: 'bonding-curve';
+    /** The V1 or V2 TokenManager that owns this token — use this, not a hardcoded address */
+    router: Address;
+    version: 1 | 2;
+    /** Quote token (address(0) = BNB) */
+    quote: Address;
+};
+export type PancakePath = {
+    path: 'pancake';
+    /** PancakeSwap V2 router on BSC mainnet */
+    router: Address;
+    /** LP pair address if known (0x0 for now; Week 3 will resolve from factory) */
+    pairAddress: Address | '0x0000000000000000000000000000000000000000';
+    /** Quote token — always BNB for Four.meme graduated tokens */
+    quote: Address;
+};
+export type TradingPath = BondingCurvePath | PancakePath;
+/**
+ * Full result of a routing call: the chosen path PLUS the raw Helper3 info
+ * tuple the caller can reuse. Downstream code reads:
+ *   - `rawInfo[6]`  launchTime  (for tradeable check)
+ *   - `rawInfo[7]`  offers
+ *   - `rawInfo[8]`  maxOffers
+ *   - `rawInfo[9]`  funds
+ *   - `rawInfo[10]` maxFunds
+ */
+export type ResolveResult = {
+    tradingPath: TradingPath;
+    rawInfo: GetTokenInfoResult;
+};
+/**
+ * Inspect a token's on-chain state and pick the correct trading path.
+ *
+ * Throws on a malformed / unknown token (version 0). Callers should wrap
+ * this in the command's error handler so the agent gets a structured error
+ * instead of a viem revert trace.
+ */
+export declare function resolveTradingPath(client: PublicClient, ca: Address): Promise<ResolveResult>;
+//# sourceMappingURL=routing.d.ts.map

package/dist/lib/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/lib/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,MAAM,CAAA;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAM5E,sDAAsD;AACtD,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CACrD,OAAO,sBAAsB,EAC7B,cAAc,CACf,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,eAAe,CAAA;IACrB,yFAAyF;IACzF,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;IACd,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,CAAA;IACf,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAA;IACf,+EAA+E;IAC/E,WAAW,EAAE,OAAO,GAAG,4CAA4C,CAAA;IACnE,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,WAAW,CAAA;AAExD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,kBAAkB,CAAA;CAC5B,CAAA;AAMD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,OAAO,GACV,OAAO,CAAC,aAAa,CAAC,CAgDxB"}

package/dist/lib/routing.js

@@ -0,0 +1,67 @@
+/**
+ * Trading path resolution.
+ *
+ * Every trade / tools command MUST call `resolveTradingPath(client, ca)`
+ * before any on-chain write. The result tells the caller which contract
+ * interface to use (bonding-curve TokenManager2 vs graduated PancakeSwap
+ * router) AND exposes the raw Helper3.getTokenInfo result so downstream
+ * code can reuse fields (launchTime, offers, funds, etc.) without firing
+ * another RPC call.
+ *
+ * This is the single source of truth for routing — do NOT hardcode
+ * TOKEN_MANAGER_V2 anywhere else.
+ */
+import { PANCAKE_V2_ROUTER, TOKEN_MANAGER_HELPER3 } from './const.js';
+import { tokenManagerHelper3Abi } from '../contracts/tokenManagerHelper3.js';
+// ============================================================
+// Public API
+// ============================================================
+/**
+ * Inspect a token's on-chain state and pick the correct trading path.
+ *
+ * Throws on a malformed / unknown token (version 0). Callers should wrap
+ * this in the command's error handler so the agent gets a structured error
+ * instead of a viem revert trace.
+ */
+export async function resolveTradingPath(client, ca) {
+    let info;
+    try {
+        info = await client.readContract({
+            address: TOKEN_MANAGER_HELPER3,
+            abi: tokenManagerHelper3Abi,
+            functionName: 'getTokenInfo',
+            args: [ca],
+        });
+    }
+    catch (err) {
+        throw new Error(`resolveTradingPath(${ca}): Helper3 read failed${err instanceof Error ? `: ${err.message}` : ''}`);
+    }
+    const version = info[0];
+    const tokenManager = info[1];
+    const quote = info[2];
+    const liquidityAdded = info[11];
+    if (version === 0n) {
+        throw new Error(`resolveTradingPath(${ca}): token not registered with Four.meme TokenManager`);
+    }
+    let tradingPath;
+    if (liquidityAdded) {
+        tradingPath = {
+            path: 'pancake',
+            router: PANCAKE_V2_ROUTER,
+            // Pair lookup is Week 3 — Router uses factory.getPair at tx build time
+            pairAddress: '0x0000000000000000000000000000000000000000',
+            quote,
+        };
+    }
+    else {
+        const normalized = version === 1n ? 1 : 2;
+        tradingPath = {
+            path: 'bonding-curve',
+            router: tokenManager,
+            version: normalized,
+            quote,
+        };
+    }
+    return { tradingPath, rawInfo: info };
+}
+//# sourceMappingURL=routing.js.map

package/dist/lib/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../src/lib/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AA+C5E,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,EAAW;IAEX,IAAI,IAAwB,CAAA;IAC5B,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;YAC/B,OAAO,EAAE,qBAAqB;YAC9B,GAAG,EAAE,sBAAsB;YAC3B,YAAY,EAAE,cAAc;YAC5B,IAAI,EAAE,CAAC,EAAE,CAAC;SACX,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,sBAAsB,EAAE,yBACtB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAC9C,EAAE,CACH,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACvB,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACrB,MAAM,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;IAE/B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sBAAsB,EAAE,qDAAqD,CAC9E,CAAA;IACH,CAAC;IAED,IAAI,WAAwB,CAAA;IAC5B,IAAI,cAAc,EAAE,CAAC;QACnB,WAAW,GAAG;YACZ,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,iBAAiB;YACzB,uEAAuE;YACvE,WAAW,EAAE,4CAA4C;YACzD,KAAK;SACN,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAU,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAChD,WAAW,GAAG;YACZ,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,YAAY;YACpB,OAAO,EAAE,UAAU;YACnB,KAAK;SACN,CAAA;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACvC,CAAC"}

package/dist/lib/slippage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Slippage calculation helpers for Router calls.
+ *
+ * Two paths:
+ *   - Bonding curve: uses Helper3.tryBuy to estimate output
+ *   - PancakeSwap (graduated): uses PancakeRouter.getAmountsOut
+ *
+ * Without proper minimums, passing 0n makes every tx fully sandwichable.
+ */
+import type { Address, PublicClient } from 'viem';
+/**
+ * Compute slippage-protected minimums for volume (buy+sell round-trip).
+ *
+ * Tries bonding-curve estimation first (tryBuy). If that fails (token has
+ * graduated), falls back to PancakeSwap getAmountsOut. If both fail,
+ * returns 0n (no protection — last resort).
+ */
+export declare function computeVolumeSlippage(client: PublicClient, token: Address, bnbWei: bigint, slippageBps: number): Promise<{
+    minTokenOut: bigint;
+    minBnbBack: bigint;
+}>;
+/**
+ * Compute minTokenOut for a turnover (buy-only, no sell leg).
+ * Same dual-path logic as computeVolumeSlippage but only the buy side.
+ */
+export declare function computeTurnoverSlippage(client: PublicClient, token: Address, bnbWei: bigint, slippageBps: number): Promise<{
+    minTokenOut: bigint;
+}>;
+//# sourceMappingURL=slippage.d.ts.map

package/dist/lib/slippage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slippage.d.ts","sourceRoot":"","sources":["../../src/lib/slippage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAkBjD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA4CtD;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA6BlC"}

package/dist/lib/slippage.js

@@ -0,0 +1,110 @@
+/**
+ * Slippage calculation helpers for Router calls.
+ *
+ * Two paths:
+ *   - Bonding curve: uses Helper3.tryBuy to estimate output
+ *   - PancakeSwap (graduated): uses PancakeRouter.getAmountsOut
+ *
+ * Without proper minimums, passing 0n makes every tx fully sandwichable.
+ */
+import { TOKEN_MANAGER_HELPER3, PANCAKE_V2_ROUTER, WBNB } from './const.js';
+import { tokenManagerHelper3Abi } from '../contracts/tokenManagerHelper3.js';
+// PancakeSwap getAmountsOut ABI (just what we need)
+const pancakeGetAmountsOutAbi = [
+    {
+        type: 'function',
+        name: 'getAmountsOut',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'amountIn', type: 'uint256' },
+            { name: 'path', type: 'address[]' },
+        ],
+        outputs: [{ name: 'amounts', type: 'uint256[]' }],
+    },
+];
+/**
+ * Compute slippage-protected minimums for volume (buy+sell round-trip).
+ *
+ * Tries bonding-curve estimation first (tryBuy). If that fails (token has
+ * graduated), falls back to PancakeSwap getAmountsOut. If both fail,
+ * returns 0n (no protection — last resort).
+ */
+export async function computeVolumeSlippage(client, token, bnbWei, slippageBps) {
+    const slipBig = BigInt(slippageBps);
+    // --- Try bonding curve first ---
+    let minTokenOut = 0n;
+    let usedPancake = false;
+    try {
+        const result = await client.readContract({
+            address: TOKEN_MANAGER_HELPER3,
+            abi: tokenManagerHelper3Abi,
+            functionName: 'tryBuy',
+            args: [token, 0n, bnbWei],
+        });
+        const estimatedTokens = result[2];
+        minTokenOut = (estimatedTokens * (10000n - slipBig)) / 10000n;
+    }
+    catch {
+        // tryBuy failed — token is likely graduated. Try PancakeSwap.
+        try {
+            const amounts = await client.readContract({
+                address: PANCAKE_V2_ROUTER,
+                abi: pancakeGetAmountsOutAbi,
+                functionName: 'getAmountsOut',
+                args: [bnbWei, [WBNB, token]],
+            });
+            if (amounts.length >= 2) {
+                const estimatedTokens = amounts[1];
+                minTokenOut = (estimatedTokens * (10000n - slipBig)) / 10000n;
+                usedPancake = true;
+            }
+        }
+        catch {
+            // Both paths failed — throw so callers refuse to send an unprotected tx
+            throw new Error('Slippage estimation failed: neither bonding-curve tryBuy nor PancakeSwap getAmountsOut returned a quote. Refusing to send tx with 0 slippage protection.');
+        }
+    }
+    // For the sell leg: estimate how much BNB we'd get back after a round-trip.
+    // Bonding curve: ~2.5% round-trip fee. PancakeSwap: ~0.5% LP fee × 2 = 1%.
+    const estimatedFeeBps = usedPancake ? 150n : 250n;
+    const totalDiscountBps = slipBig + estimatedFeeBps;
+    const effectiveBps = totalDiscountBps > 10000n ? 10000n : totalDiscountBps;
+    const minBnbBack = (bnbWei * (10000n - effectiveBps)) / 10000n;
+    return { minTokenOut, minBnbBack };
+}
+/**
+ * Compute minTokenOut for a turnover (buy-only, no sell leg).
+ * Same dual-path logic as computeVolumeSlippage but only the buy side.
+ */
+export async function computeTurnoverSlippage(client, token, bnbWei, slippageBps) {
+    const slipBig = BigInt(slippageBps);
+    // Try bonding curve
+    try {
+        const result = await client.readContract({
+            address: TOKEN_MANAGER_HELPER3,
+            abi: tokenManagerHelper3Abi,
+            functionName: 'tryBuy',
+            args: [token, 0n, bnbWei],
+        });
+        return { minTokenOut: (result[2] * (10000n - slipBig)) / 10000n };
+    }
+    catch {
+        // Fallback: PancakeSwap
+        try {
+            const amounts = await client.readContract({
+                address: PANCAKE_V2_ROUTER,
+                abi: pancakeGetAmountsOutAbi,
+                functionName: 'getAmountsOut',
+                args: [bnbWei, [WBNB, token]],
+            });
+            if (amounts.length >= 2) {
+                return { minTokenOut: (amounts[1] * (10000n - slipBig)) / 10000n };
+            }
+        }
+        catch {
+            // both failed
+        }
+        throw new Error('Slippage estimation failed: neither bonding-curve tryBuy nor PancakeSwap getAmountsOut returned a quote. Refusing to send tx with 0 slippage protection.');
+    }
+}
+//# sourceMappingURL=slippage.js.map

package/dist/lib/slippage.js.map

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