imm-cli 0.1.0

package/dist/jaine/pathEncoding.js

@@ -0,0 +1,98 @@
+import { concat, pad, toHex } from "viem";
+/**
+ * Encode path for Uniswap V3 exactInput
+ * Format: token0 + fee0 + token1 + fee1 + token2 + ...
+ *
+ * @param tokens - Array of token addresses in swap order
+ * @param fees - Array of fee tiers (length = tokens.length - 1)
+ * @returns Encoded path bytes
+ */
+export function encodePath(tokens, fees) {
+    if (tokens.length < 2) {
+        throw new Error("Path must have at least 2 tokens");
+    }
+    if (fees.length !== tokens.length - 1) {
+        throw new Error("Fees length must be tokens.length - 1");
+    }
+    // Each address is 20 bytes, each fee is 3 bytes
+    const parts = [];
+    for (let i = 0; i < tokens.length; i++) {
+        // Add token address (20 bytes)
+        parts.push(tokens[i].toLowerCase());
+        // Add fee if not last token (3 bytes)
+        if (i < fees.length) {
+            // Fee is uint24, encode as 3 bytes
+            const feeHex = pad(toHex(fees[i]), { size: 3 });
+            parts.push(feeHex);
+        }
+    }
+    return concat(parts);
+}
+/**
+ * Encode path for Uniswap V3 exactOutput
+ * Note: exactOutput requires REVERSED path (tokenOut first)
+ *
+ * @param tokens - Array of token addresses in swap order (tokenIn → tokenOut)
+ * @param fees - Array of fee tiers
+ * @returns Encoded path bytes (reversed for exactOutput)
+ */
+export function encodePathForExactOutput(tokens, fees) {
+    // Reverse both arrays for exactOutput
+    const reversedTokens = [...tokens].reverse();
+    const reversedFees = [...fees].reverse();
+    return encodePath(reversedTokens, reversedFees);
+}
+/**
+ * Decode path bytes into tokens and fees
+ *
+ * @param path - Encoded path bytes
+ * @returns Object with tokens array and fees array
+ */
+export function decodePath(path) {
+    // Remove 0x prefix
+    const data = path.slice(2);
+    // Each token is 20 bytes (40 hex chars), each fee is 3 bytes (6 hex chars)
+    const tokens = [];
+    const fees = [];
+    let offset = 0;
+    let isToken = true;
+    while (offset < data.length) {
+        if (isToken) {
+            // Read 20 bytes for token
+            const tokenHex = data.slice(offset, offset + 40);
+            tokens.push(`0x${tokenHex}`);
+            offset += 40;
+            isToken = false;
+        }
+        else {
+            // Read 3 bytes for fee
+            const feeHex = data.slice(offset, offset + 6);
+            fees.push(parseInt(feeHex, 16));
+            offset += 6;
+            isToken = true;
+        }
+    }
+    return { tokens, fees };
+}
+/**
+ * Calculate the number of hops in a path
+ */
+export function getPathHops(tokens) {
+    return tokens.length - 1;
+}
+/**
+ * Format path as human-readable string
+ * e.g., "USDC → [0.3%] → w0G → [0.05%] → WETH"
+ */
+export function formatPath(tokens, fees, getSymbol) {
+    const parts = [];
+    for (let i = 0; i < tokens.length; i++) {
+        parts.push(getSymbol(tokens[i]));
+        if (i < fees.length) {
+            const feePercent = (fees[i] / 10000).toFixed(2);
+            parts.push(`→ [${feePercent}%] →`);
+        }
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=pathEncoding.js.map

package/dist/jaine/pathEncoding.js.map

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

package/dist/jaine/paths.d.ts

@@ -0,0 +1,11 @@
+/** Jaine-specific data directory */
+export declare const JAINE_DIR: string;
+/** Pool cache file */
+export declare const POOLS_CACHE_FILE: string;
+/** User token aliases file */
+export declare const TOKENS_FILE: string;
+/**
+ * Ensure Jaine data directory exists
+ */
+export declare function ensureJaineDir(): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/jaine/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/jaine/paths.ts"],"names":[],"mappings":"AAKA,oCAAoC;AACpC,eAAO,MAAM,SAAS,QAA4B,CAAC;AAEnD,sBAAsB;AACtB,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AAEvE,8BAA8B;AAC9B,eAAO,MAAM,WAAW,QAAiC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAKrC"}

package/dist/jaine/paths.js

@@ -0,0 +1,20 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { CONFIG_DIR } from "../config/paths.js";
+import logger from "../utils/logger.js";
+/** Jaine-specific data directory */
+export const JAINE_DIR = join(CONFIG_DIR, "jaine");
+/** Pool cache file */
+export const POOLS_CACHE_FILE = join(JAINE_DIR, "pools-cache.v1.json");
+/** User token aliases file */
+export const TOKENS_FILE = join(JAINE_DIR, "tokens.json");
+/**
+ * Ensure Jaine data directory exists
+ */
+export function ensureJaineDir() {
+    if (!existsSync(JAINE_DIR)) {
+        mkdirSync(JAINE_DIR, { recursive: true });
+        logger.debug(`Created Jaine directory: ${JAINE_DIR}`);
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/jaine/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/jaine/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,oCAAoC;AACpC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAEnD,sBAAsB;AACtB,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AAEvE,8BAA8B;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/jaine/poolCache.d.ts

@@ -0,0 +1,42 @@
+import type { Address } from "viem";
+import { type FeeTier } from "./abi/factory.js";
+export interface PoolInfo {
+    address: Address;
+    token0: Address;
+    token1: Address;
+    fee: FeeTier;
+}
+export interface PoolsCache {
+    version: number;
+    chainId: number;
+    generatedAt: string;
+    pools: PoolInfo[];
+}
+/**
+ * Load pools cache from disk
+ */
+export declare function loadPoolsCache(): PoolsCache | null;
+/**
+ * Save pools cache to disk (atomic write)
+ */
+export declare function savePoolsCache(cache: PoolsCache): void;
+/**
+ * Scan factory for pools between core tokens
+ * @param feeTiers - Fee tiers to scan (defaults to all standard tiers)
+ * @param onProgress - Optional progress callback (poolsFound, pairsScanned)
+ */
+export declare function scanCorePools(feeTiers?: readonly FeeTier[], onProgress?: (poolsFound: number, pairsScanned: number) => void): Promise<PoolInfo[]>;
+/**
+ * Get pool for specific token pair and fee
+ */
+export declare function getPool(tokenA: Address, tokenB: Address, fee: FeeTier): Promise<Address | null>;
+/**
+ * Find pools containing a specific token from cache
+ */
+export declare function findPoolsForToken(token: Address, cache?: PoolsCache | null): PoolInfo[];
+/**
+ * Find pool between two tokens from cache
+ * Returns all matching pools (different fee tiers)
+ */
+export declare function findPoolsBetweenTokens(tokenA: Address, tokenB: Address, cache?: PoolsCache | null): PoolInfo[];
+//# sourceMappingURL=poolCache.d.ts.map

package/dist/jaine/poolCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolCache.d.ts","sourceRoot":"","sources":["../../src/jaine/poolCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGpC,OAAO,EAA0B,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQxE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,GAAG,IAAI,CA0BlD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAoBtD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,SAAS,OAAO,EAAc,EACxC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,GAC9D,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsDrB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAmBzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,QAAQ,EAAE,CAQvF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,GACxB,QAAQ,EAAE,CAYZ"}

package/dist/jaine/poolCache.js

@@ -0,0 +1,164 @@
+import { existsSync, readFileSync, writeFileSync, renameSync, unlinkSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAddress, zeroAddress } from "viem";
+import { POOLS_CACHE_FILE, ensureJaineDir } from "./paths.js";
+import { FACTORY_ABI, FEE_TIERS } from "./abi/factory.js";
+import { getCoreTokenAddresses } from "./coreTokens.js";
+import { getPublicClient } from "../wallet/client.js";
+import { loadConfig } from "../config/store.js";
+import logger from "../utils/logger.js";
+const CACHE_VERSION = 1;
+/**
+ * Load pools cache from disk
+ */
+export function loadPoolsCache() {
+    if (!existsSync(POOLS_CACHE_FILE)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(POOLS_CACHE_FILE, "utf-8");
+        const parsed = JSON.parse(raw);
+        // Validate version and chain
+        if (parsed.version !== CACHE_VERSION) {
+            logger.debug(`Pool cache version mismatch: ${parsed.version} != ${CACHE_VERSION}`);
+            return null;
+        }
+        const cfg = loadConfig();
+        if (parsed.chainId !== cfg.chain.chainId) {
+            logger.debug(`Pool cache chain mismatch: ${parsed.chainId} != ${cfg.chain.chainId}`);
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        logger.error(`Failed to parse pool cache: ${err}`);
+        return null;
+    }
+}
+/**
+ * Save pools cache to disk (atomic write)
+ */
+export function savePoolsCache(cache) {
+    ensureJaineDir();
+    const dir = dirname(POOLS_CACHE_FILE);
+    const tmpFile = join(dir, `.pools-cache.tmp.${Date.now()}.json`);
+    try {
+        writeFileSync(tmpFile, JSON.stringify(cache, null, 2), "utf-8");
+        renameSync(tmpFile, POOLS_CACHE_FILE);
+        logger.debug(`Pool cache saved: ${cache.pools.length} pools`);
+    }
+    catch (err) {
+        try {
+            if (existsSync(tmpFile)) {
+                unlinkSync(tmpFile);
+            }
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw err;
+    }
+}
+/**
+ * Scan factory for pools between core tokens
+ * @param feeTiers - Fee tiers to scan (defaults to all standard tiers)
+ * @param onProgress - Optional progress callback (poolsFound, pairsScanned)
+ */
+export async function scanCorePools(feeTiers = FEE_TIERS, onProgress) {
+    const cfg = loadConfig();
+    const client = getPublicClient();
+    const factoryAddress = cfg.protocol.jaineFactory;
+    const coreTokens = getCoreTokenAddresses();
+    const pools = [];
+    let pairsScanned = 0;
+    // Generate all unique token pairs
+    const pairs = [];
+    for (let i = 0; i < coreTokens.length; i++) {
+        for (let j = i + 1; j < coreTokens.length; j++) {
+            pairs.push([coreTokens[i], coreTokens[j]]);
+        }
+    }
+    // Scan each pair × fee tier sequentially (avoid rate limiting)
+    for (const [tokenA, tokenB] of pairs) {
+        for (const fee of feeTiers) {
+            try {
+                const poolAddress = await client.readContract({
+                    address: factoryAddress,
+                    abi: FACTORY_ABI,
+                    functionName: "getPool",
+                    args: [tokenA, tokenB, fee],
+                });
+                if (poolAddress && poolAddress !== zeroAddress) {
+                    // Sort tokens to ensure consistent ordering (token0 < token1)
+                    const [token0, token1] = tokenA.toLowerCase() < tokenB.toLowerCase()
+                        ? [tokenA, tokenB]
+                        : [tokenB, tokenA];
+                    pools.push({
+                        address: getAddress(poolAddress),
+                        token0: getAddress(token0),
+                        token1: getAddress(token1),
+                        fee,
+                    });
+                }
+            }
+            catch (err) {
+                logger.debug(`Failed to query pool ${tokenA}/${tokenB}/${fee}: ${err}`);
+                // Continue scanning other pools
+            }
+        }
+        pairsScanned++;
+        if (onProgress) {
+            onProgress(pools.length, pairsScanned);
+        }
+    }
+    return pools;
+}
+/**
+ * Get pool for specific token pair and fee
+ */
+export async function getPool(tokenA, tokenB, fee) {
+    const cfg = loadConfig();
+    const client = getPublicClient();
+    try {
+        const poolAddress = await client.readContract({
+            address: cfg.protocol.jaineFactory,
+            abi: FACTORY_ABI,
+            functionName: "getPool",
+            args: [tokenA, tokenB, fee],
+        });
+        if (poolAddress && poolAddress !== zeroAddress) {
+            return getAddress(poolAddress);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find pools containing a specific token from cache
+ */
+export function findPoolsForToken(token, cache) {
+    const c = cache ?? loadPoolsCache();
+    if (!c)
+        return [];
+    const tokenLower = token.toLowerCase();
+    return c.pools.filter((p) => p.token0.toLowerCase() === tokenLower || p.token1.toLowerCase() === tokenLower);
+}
+/**
+ * Find pool between two tokens from cache
+ * Returns all matching pools (different fee tiers)
+ */
+export function findPoolsBetweenTokens(tokenA, tokenB, cache) {
+    const c = cache ?? loadPoolsCache();
+    if (!c)
+        return [];
+    const aLower = tokenA.toLowerCase();
+    const bLower = tokenB.toLowerCase();
+    return c.pools.filter((p) => {
+        const t0 = p.token0.toLowerCase();
+        const t1 = p.token1.toLowerCase();
+        return (t0 === aLower && t1 === bLower) || (t0 === bLower && t1 === aLower);
+    });
+}
+//# sourceMappingURL=poolCache.js.map

package/dist/jaine/poolCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poolCache.js","sourceRoot":"","sources":["../../src/jaine/poolCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAgB,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,MAAM,aAAa,GAAG,CAAC,CAAC;AAgBxB;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QAE7C,6BAA6B;QAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,OAAO,OAAO,aAAa,EAAE,CAAC,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,OAAO,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,OAAO,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB;IAC9C,cAAc,EAAE,CAAC;IAEjB,MAAM,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,oBAAoB,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAEjE,IAAI,CAAC;QACH,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,UAAU,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,UAAU,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAA+B,SAAS,EACxC,UAA+D;IAE/D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC;IAEjD,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,kCAAkC;IAClC,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;oBAC5C,OAAO,EAAE,cAAc;oBACvB,GAAG,EAAE,WAAW;oBAChB,YAAY,EAAE,SAAS;oBACvB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC;iBAC5B,CAAC,CAAC;gBAEH,IAAI,WAAW,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;oBAC/C,8DAA8D;oBAC9D,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpB,MAAM,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE;wBACzC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;wBAClB,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAEvB,KAAK,CAAC,IAAI,CAAC;wBACT,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC;wBAChC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;wBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;wBAC1B,GAAG;qBACJ,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,IAAI,MAAM,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;gBACxE,gCAAgC;YAClC,CAAC;QACH,CAAC;QACD,YAAY,EAAE,CAAC;QACf,IAAI,UAAU,EAAE,CAAC;YACf,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAe,EACf,MAAe,EACf,GAAY;IAEZ,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;YAC5C,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,YAAY;YAClC,GAAG,EAAE,WAAW;YAChB,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC;SAC5B,CAAC,CAAC;QAEH,IAAI,WAAW,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAC/C,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,KAAyB;IACzE,MAAM,CAAC,GAAG,KAAK,IAAI,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CACnB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,UAAU,CACtF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAe,EACf,MAAe,EACf,KAAyB;IAEzB,MAAM,CAAC,GAAG,KAAK,IAAI,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAEpC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,CAAC,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,IAAI,EAAE,KAAK,MAAM,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/jaine/routing.d.ts

@@ -0,0 +1,41 @@
+import type { Address, Hex } from "viem";
+import { type PoolsCache } from "./poolCache.js";
+export interface Route {
+    tokens: Address[];
+    fees: number[];
+    pools: Address[];
+}
+export interface QuotedRoute extends Route {
+    amountIn: bigint;
+    amountOut: bigint;
+    encodedPath: Hex;
+    gasEstimate: bigint;
+}
+export interface FindRouteOptions {
+    maxHops?: number;
+    maxCandidates?: number;
+    cache?: PoolsCache | null;
+}
+/**
+ * Find the best route for a swap (exactInput)
+ * @param tokenIn - Input token address
+ * @param tokenOut - Output token address
+ * @param amountIn - Input amount
+ * @param options - Routing options
+ * @returns Best route or null if no route found
+ */
+export declare function findBestRouteExactInput(tokenIn: Address, tokenOut: Address, amountIn: bigint, options?: FindRouteOptions): Promise<QuotedRoute | null>;
+/**
+ * Find the best route for a swap (exactOutput)
+ * @param tokenIn - Input token address
+ * @param tokenOut - Output token address
+ * @param amountOut - Desired output amount
+ * @param options - Routing options
+ * @returns Best route or null if no route found
+ */
+export declare function findBestRouteExactOutput(tokenIn: Address, tokenOut: Address, amountOut: bigint, options?: FindRouteOptions): Promise<QuotedRoute | null>;
+/**
+ * Format route for display
+ */
+export declare function formatRoute(route: Route, userAliases?: Record<string, Address>): string;
+//# sourceMappingURL=routing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/jaine/routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,EAAiC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYhF,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,GAAG,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AA8KD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyD7B;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwD7B;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,KAAK,EACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,CAIR"}

package/dist/jaine/routing.js

@@ -0,0 +1,247 @@
+import { getAddress } from "viem";
+import { loadPoolsCache } from "./poolCache.js";
+import { encodePath, encodePathForExactOutput, formatPath } from "./pathEncoding.js";
+import { getTokenSymbol } from "./coreTokens.js";
+import { QUOTER_ABI } from "./abi/quoter.js";
+import { getPublicClient } from "../wallet/client.js";
+import { loadConfig } from "../config/store.js";
+import { ImmError, ErrorCodes } from "../errors.js";
+import logger from "../utils/logger.js";
+const DEFAULT_MAX_HOPS = 3;
+const DEFAULT_MAX_CANDIDATES = 20;
+/**
+ * Build a graph of pools for routing
+ */
+function buildPoolGraph(pools) {
+    // Graph: token -> (neighbor token -> pools)
+    const graph = new Map();
+    const ensureNode = (token) => {
+        if (!graph.has(token)) {
+            graph.set(token, new Map());
+        }
+    };
+    for (const pool of pools) {
+        const t0 = pool.token0.toLowerCase();
+        const t1 = pool.token1.toLowerCase();
+        ensureNode(t0);
+        ensureNode(t1);
+        // Add bidirectional edges
+        const t0Neighbors = graph.get(t0);
+        const t1Neighbors = graph.get(t1);
+        if (!t0Neighbors.has(t1)) {
+            t0Neighbors.set(t1, []);
+        }
+        t0Neighbors.get(t1).push(pool);
+        if (!t1Neighbors.has(t0)) {
+            t1Neighbors.set(t0, []);
+        }
+        t1Neighbors.get(t0).push(pool);
+    }
+    return graph;
+}
+/**
+ * BFS to find all routes between tokenIn and tokenOut
+ */
+function findAllRoutes(tokenIn, tokenOut, pools, maxHops) {
+    const graph = buildPoolGraph(pools);
+    const routes = [];
+    const inLower = tokenIn.toLowerCase();
+    const outLower = tokenOut.toLowerCase();
+    const queue = [
+        {
+            current: inLower,
+            tokens: [getAddress(tokenIn)],
+            fees: [],
+            pools: [],
+            visited: new Set([inLower]),
+        },
+    ];
+    while (queue.length > 0) {
+        const state = queue.shift();
+        const { current, tokens, fees, pools: routePools, visited } = state;
+        // Check if we reached destination
+        if (current === outLower) {
+            routes.push({
+                tokens: [...tokens],
+                fees: [...fees],
+                pools: [...routePools],
+            });
+            continue;
+        }
+        // Don't explore further if max hops reached
+        if (tokens.length > maxHops) {
+            continue;
+        }
+        // Get neighbors
+        const neighbors = graph.get(current);
+        if (!neighbors)
+            continue;
+        for (const [neighborToken, poolsToNeighbor] of neighbors) {
+            // Skip if already visited (no cycles)
+            if (visited.has(neighborToken))
+                continue;
+            // For each pool option to this neighbor
+            for (const pool of poolsToNeighbor) {
+                queue.push({
+                    current: neighborToken,
+                    tokens: [...tokens, getAddress(neighborToken)],
+                    fees: [...fees, pool.fee],
+                    pools: [...routePools, pool.address],
+                    visited: new Set([...visited, neighborToken]),
+                });
+            }
+        }
+    }
+    return routes;
+}
+/**
+ * Quote a route using the quoter contract
+ */
+async function quoteRoute(route, amountIn, quoterAddress, direction) {
+    const client = getPublicClient();
+    try {
+        if (direction === "exactInput") {
+            const path = encodePath(route.tokens, route.fees);
+            // QuoterV1 returns single uint256, not tuple
+            const amountOut = await client.readContract({
+                address: quoterAddress,
+                abi: QUOTER_ABI,
+                functionName: "quoteExactInput",
+                args: [path, amountIn],
+            });
+            return {
+                ...route,
+                amountIn,
+                amountOut,
+                encodedPath: path,
+                gasEstimate: 0n,
+            };
+        }
+        else {
+            // exactOutput - path is reversed
+            const path = encodePathForExactOutput(route.tokens, route.fees);
+            // QuoterV1 returns single uint256, not tuple
+            const amountInRequired = await client.readContract({
+                address: quoterAddress,
+                abi: QUOTER_ABI,
+                functionName: "quoteExactOutput",
+                args: [path, amountIn], // amountIn is actually amountOut for exactOutput
+            });
+            return {
+                ...route,
+                amountIn: amountInRequired,
+                amountOut: amountIn, // The desired output
+                encodedPath: path,
+                gasEstimate: 0n,
+            };
+        }
+    }
+    catch (err) {
+        logger.debug(`Quote failed for route: ${err}`);
+        return null;
+    }
+}
+/**
+ * Find the best route for a swap (exactInput)
+ * @param tokenIn - Input token address
+ * @param tokenOut - Output token address
+ * @param amountIn - Input amount
+ * @param options - Routing options
+ * @returns Best route or null if no route found
+ */
+export async function findBestRouteExactInput(tokenIn, tokenOut, amountIn, options = {}) {
+    const { maxHops = DEFAULT_MAX_HOPS, maxCandidates = DEFAULT_MAX_CANDIDATES } = options;
+    const cache = options.cache !== undefined ? options.cache : loadPoolsCache();
+    if (!cache || cache.pools.length === 0) {
+        throw new ImmError(ErrorCodes.NO_ROUTE_FOUND, "Pool cache is empty", "Run: imm jaine pools scan-core");
+    }
+    const cfg = loadConfig();
+    const quoterAddress = cfg.protocol.quoter;
+    // Find all possible routes
+    const routes = findAllRoutes(tokenIn, tokenOut, cache.pools, maxHops);
+    if (routes.length === 0) {
+        return null;
+    }
+    // Limit candidates
+    const candidates = routes.slice(0, maxCandidates);
+    // Quote all routes in parallel (with limit)
+    const quotedRoutes = [];
+    // Process in batches of 5 to avoid rate limiting
+    const batchSize = 5;
+    for (let i = 0; i < candidates.length; i += batchSize) {
+        const batch = candidates.slice(i, i + batchSize);
+        const results = await Promise.all(batch.map((route) => quoteRoute(route, amountIn, quoterAddress, "exactInput")));
+        for (const result of results) {
+            if (result) {
+                quotedRoutes.push(result);
+            }
+        }
+    }
+    if (quotedRoutes.length === 0) {
+        return null;
+    }
+    // Sort by amountOut descending, then by fewer hops
+    quotedRoutes.sort((a, b) => {
+        const amountDiff = b.amountOut - a.amountOut;
+        if (amountDiff !== 0n) {
+            return amountDiff > 0n ? 1 : -1;
+        }
+        return a.tokens.length - b.tokens.length;
+    });
+    return quotedRoutes[0];
+}
+/**
+ * Find the best route for a swap (exactOutput)
+ * @param tokenIn - Input token address
+ * @param tokenOut - Output token address
+ * @param amountOut - Desired output amount
+ * @param options - Routing options
+ * @returns Best route or null if no route found
+ */
+export async function findBestRouteExactOutput(tokenIn, tokenOut, amountOut, options = {}) {
+    const { maxHops = DEFAULT_MAX_HOPS, maxCandidates = DEFAULT_MAX_CANDIDATES } = options;
+    const cache = options.cache !== undefined ? options.cache : loadPoolsCache();
+    if (!cache || cache.pools.length === 0) {
+        throw new ImmError(ErrorCodes.NO_ROUTE_FOUND, "Pool cache is empty", "Run: imm jaine pools scan-core");
+    }
+    const cfg = loadConfig();
+    const quoterAddress = cfg.protocol.quoter;
+    // Find all possible routes
+    const routes = findAllRoutes(tokenIn, tokenOut, cache.pools, maxHops);
+    if (routes.length === 0) {
+        return null;
+    }
+    // Limit candidates
+    const candidates = routes.slice(0, maxCandidates);
+    // Quote all routes
+    const quotedRoutes = [];
+    const batchSize = 5;
+    for (let i = 0; i < candidates.length; i += batchSize) {
+        const batch = candidates.slice(i, i + batchSize);
+        const results = await Promise.all(batch.map((route) => quoteRoute(route, amountOut, quoterAddress, "exactOutput")));
+        for (const result of results) {
+            if (result) {
+                quotedRoutes.push(result);
+            }
+        }
+    }
+    if (quotedRoutes.length === 0) {
+        return null;
+    }
+    // Sort by amountIn ascending (minimize input), then by fewer hops
+    quotedRoutes.sort((a, b) => {
+        const amountDiff = a.amountIn - b.amountIn;
+        if (amountDiff !== 0n) {
+            return amountDiff > 0n ? 1 : -1;
+        }
+        return a.tokens.length - b.tokens.length;
+    });
+    return quotedRoutes[0];
+}
+/**
+ * Format route for display
+ */
+export function formatRoute(route, userAliases) {
+    return formatPath(route.tokens, route.fees, (addr) => getTokenSymbol(addr, userAliases));
+}
+//# sourceMappingURL=routing.js.map