@echoclaw/echo-0g 1.0.0

package/dist/jaine/allowance.js

@@ -0,0 +1,192 @@
+import { maxUint256, getAddress } from "viem";
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { ERC20_EXTENDED_ABI } from "./abi/erc20.js";
+import { getPublicClient } from "../wallet/client.js";
+import { loadConfig } from "../config/store.js";
+import { EchoError, ErrorCodes } from "../errors.js";
+import logger from "../utils/logger.js";
+/**
+ * Allowed spenders - only these addresses can be approved
+ */
+export function getAllowedSpenders() {
+    const cfg = loadConfig();
+    return {
+        router: cfg.protocol.jaineRouter,
+        nft: cfg.protocol.nftPositionManager,
+    };
+}
+/**
+ * Validate that spender is in the allowlist
+ */
+export function validateSpender(spender) {
+    const allowed = getAllowedSpenders();
+    const isAllowed = Object.values(allowed).some((addr) => getAddress(addr) === getAddress(spender));
+    if (!isAllowed) {
+        throw new EchoError(ErrorCodes.INVALID_SPENDER, `Spender ${spender} is not in allowlist`, `Allowed spenders: router (${allowed.router}), nft (${allowed.nft})`);
+    }
+}
+/**
+ * Get spender address by type
+ */
+export function getSpenderAddress(spenderType) {
+    const allowed = getAllowedSpenders();
+    return allowed[spenderType];
+}
+/**
+ * Get current allowance for a token
+ */
+export async function getAllowance(token, owner, spender) {
+    const client = getPublicClient();
+    const allowance = await client.readContract({
+        address: token,
+        abi: ERC20_EXTENDED_ABI,
+        functionName: "allowance",
+        args: [owner, spender],
+    });
+    return allowance;
+}
+/**
+ * Get allowances for both spenders
+ */
+export async function getAllAllowances(token, owner) {
+    const allowed = getAllowedSpenders();
+    const client = getPublicClient();
+    const [routerAllowance, nftAllowance] = await Promise.all([
+        client.readContract({
+            address: token,
+            abi: ERC20_EXTENDED_ABI,
+            functionName: "allowance",
+            args: [owner, allowed.router],
+        }),
+        client.readContract({
+            address: token,
+            abi: ERC20_EXTENDED_ABI,
+            functionName: "allowance",
+            args: [owner, allowed.nft],
+        }),
+    ]);
+    return {
+        router: routerAllowance,
+        nft: nftAllowance,
+    };
+}
+/**
+ * Safe approve with USDT-style reset handling
+ *
+ * Some tokens (like USDT) require setting allowance to 0 before
+ * setting a new non-zero allowance if current allowance is non-zero.
+ *
+ * @param token - Token address
+ * @param spender - Spender address (must be in allowlist)
+ * @param amount - Amount to approve (use maxUint256 for unlimited)
+ * @param privateKey - Private key for signing
+ * @returns Transaction hash(es)
+ */
+export async function safeApprove(token, spender, amount, privateKey) {
+    // Validate spender is in allowlist
+    validateSpender(spender);
+    const cfg = loadConfig();
+    const client = getPublicClient();
+    const account = privateKeyToAccount(privateKey);
+    const walletClient = createWalletClient({
+        account,
+        chain: {
+            id: cfg.chain.chainId,
+            name: "0G",
+            nativeCurrency: { name: "0G", symbol: "0G", decimals: 18 },
+            rpcUrls: { default: { http: [cfg.chain.rpcUrl] } },
+        },
+        transport: http(cfg.chain.rpcUrl, {
+            timeout: 30_000,
+            retryCount: 2,
+        }),
+    });
+    // Check current allowance
+    const currentAllowance = await getAllowance(token, account.address, spender);
+    // If current allowance is sufficient, no action needed
+    if (currentAllowance >= amount) {
+        logger.debug(`Allowance already sufficient: ${currentAllowance} >= ${amount}`);
+        return { txHash: "0x0" }; // No-op
+    }
+    let resetTxHash;
+    // If current allowance > 0 and < amount, reset to 0 first (USDT-style)
+    if (currentAllowance > 0n && currentAllowance < amount) {
+        logger.debug("Resetting allowance to 0 (USDT-style)");
+        try {
+            resetTxHash = await walletClient.writeContract({
+                address: token,
+                abi: ERC20_EXTENDED_ABI,
+                functionName: "approve",
+                args: [spender, 0n],
+            });
+            // Wait for reset tx to confirm
+            await client.waitForTransactionReceipt({ hash: resetTxHash });
+        }
+        catch (err) {
+            throw new EchoError(ErrorCodes.APPROVAL_FAILED, `Failed to reset allowance: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    // Approve the target amount
+    try {
+        const txHash = await walletClient.writeContract({
+            address: token,
+            abi: ERC20_EXTENDED_ABI,
+            functionName: "approve",
+            args: [spender, amount],
+        });
+        // Wait for approve tx to confirm before returning
+        await client.waitForTransactionReceipt({ hash: txHash });
+        return { txHash, resetTxHash };
+    }
+    catch (err) {
+        throw new EchoError(ErrorCodes.APPROVAL_FAILED, `Failed to approve: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * Revoke approval (set to 0)
+ */
+export async function revokeApproval(token, spender, privateKey) {
+    // Validate spender is in allowlist
+    validateSpender(spender);
+    const cfg = loadConfig();
+    const account = privateKeyToAccount(privateKey);
+    const walletClient = createWalletClient({
+        account,
+        chain: {
+            id: cfg.chain.chainId,
+            name: "0G",
+            nativeCurrency: { name: "0G", symbol: "0G", decimals: 18 },
+            rpcUrls: { default: { http: [cfg.chain.rpcUrl] } },
+        },
+        transport: http(cfg.chain.rpcUrl, {
+            timeout: 30_000,
+            retryCount: 2,
+        }),
+    });
+    try {
+        const txHash = await walletClient.writeContract({
+            address: token,
+            abi: ERC20_EXTENDED_ABI,
+            functionName: "approve",
+            args: [spender, 0n],
+        });
+        return txHash;
+    }
+    catch (err) {
+        throw new EchoError(ErrorCodes.APPROVAL_FAILED, `Failed to revoke approval: ${err instanceof Error ? err.message : err}`);
+    }
+}
+/**
+ * Ensure allowance is sufficient, approve if needed
+ */
+export async function ensureAllowance(token, spender, requiredAmount, privateKey, approveExact = false) {
+    const account = privateKeyToAccount(privateKey);
+    const currentAllowance = await getAllowance(token, account.address, spender);
+    if (currentAllowance >= requiredAmount) {
+        return null; // No approval needed
+    }
+    const approveAmount = approveExact ? requiredAmount : maxUint256;
+    return safeApprove(token, spender, approveAmount, privateKey);
+}
+//# sourceMappingURL=allowance.js.map

package/dist/jaine/allowance.js.map

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

package/dist/jaine/coreTokens.d.ts

@@ -0,0 +1,32 @@
+import type { Address } from "viem";
+/**
+ * Core tokens on 0G mainnet supported by Jaine DEX
+ * Addresses from MOLTBOT/jaine.md
+ */
+export declare const CORE_TOKENS: Record<string, Address>;
+/** List of core token symbols */
+export declare const CORE_TOKEN_SYMBOLS: (keyof typeof CORE_TOKENS)[];
+/**
+ * Resolve token symbol or address to checksummed address
+ * @param tokenOrSymbol - Token symbol (e.g., "USDC") or address (0x...)
+ * @param userAliases - Optional user-defined token aliases
+ * @returns Checksummed address
+ * @throws EchoError if token not found
+ */
+export declare function resolveToken(tokenOrSymbol: string, userAliases?: Record<string, Address>): Address;
+/**
+ * Get symbol for a token address (reverse lookup)
+ * @param address - Token address
+ * @param userAliases - Optional user-defined token aliases
+ * @returns Symbol if found, shortened address otherwise
+ */
+export declare function getTokenSymbol(address: Address, userAliases?: Record<string, Address>): string;
+/**
+ * Check if a token is a core token
+ */
+export declare function isCoreToken(address: Address): boolean;
+/**
+ * Get all core token addresses
+ */
+export declare function getCoreTokenAddresses(): Address[];
+//# sourceMappingURL=coreTokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coreTokens.d.ts","sourceRoot":"","sources":["../../src/jaine/coreTokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIpC;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAatC,CAAC;AAEX,iCAAiC;AACjC,eAAO,MAAM,kBAAkB,EAA+B,CAAC,MAAM,OAAO,WAAW,CAAC,EAAE,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CA8BT;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,EAAE,CAEjD"}

package/dist/jaine/coreTokens.js

@@ -0,0 +1,91 @@
+import { isAddress, getAddress } from "viem";
+import { EchoError, ErrorCodes } from "../errors.js";
+/**
+ * Core tokens on 0G mainnet supported by Jaine DEX
+ * Addresses from MOLTBOT/jaine.md
+ */
+export const CORE_TOKENS = {
+    USDC: "0x1f3aa82227281ca364bfb3d253b0f1af1da6473e",
+    WETH: "0x564770837ef8bbf077cfe54e5f6106538c815b22",
+    stgUSDT: "0x9FBBAFC2Ad79af2b57eD23C60DfF79eF5c2b0FB5",
+    stgUSDC: "0x8a2B28364102Bea189D99A475C494330Ef2bDD0B",
+    w0G: "0x1Cd0690fF9a693f5EF2dD976660a8dAFc81A109c",
+    st0G: "0x7bBC63D01CA42491c3E084C941c3E86e55951404",
+    wstETH: "0x161a128567BF0C005b58211757F7e46eed983F02",
+    PAI: "0x59ef6F3943bBdFE2fB19565037Ac85071223E94C",
+    oUSDT: "0x1217BfE6c773EEC6cc4A38b5Dc45B92292B6E189",
+    LINK: "0x76159c2b43ff6F630193e37EC68452169914C1Bb",
+    coinbaseBTC: "0xa5613ac7f1E83a68719b1398c8F6aAA25581db82",
+    HAIO: "0xbCB868d3d0A823ced82B77DD72E4f7A3C720A40E",
+};
+/** List of core token symbols */
+export const CORE_TOKEN_SYMBOLS = Object.keys(CORE_TOKENS);
+/**
+ * Resolve token symbol or address to checksummed address
+ * @param tokenOrSymbol - Token symbol (e.g., "USDC") or address (0x...)
+ * @param userAliases - Optional user-defined token aliases
+ * @returns Checksummed address
+ * @throws EchoError if token not found
+ */
+export function resolveToken(tokenOrSymbol, userAliases) {
+    // If it's already a valid address, return checksummed
+    if (isAddress(tokenOrSymbol)) {
+        return getAddress(tokenOrSymbol);
+    }
+    // Normalize symbol to match case-insensitive
+    const upperSymbol = tokenOrSymbol.toUpperCase();
+    // Check user aliases first (they have priority)
+    if (userAliases) {
+        for (const [symbol, addr] of Object.entries(userAliases)) {
+            if (symbol.toUpperCase() === upperSymbol) {
+                return getAddress(addr);
+            }
+        }
+    }
+    // Check core tokens (case-insensitive)
+    for (const [symbol, addr] of Object.entries(CORE_TOKENS)) {
+        if (symbol.toUpperCase() === upperSymbol) {
+            return getAddress(addr);
+        }
+    }
+    throw new EchoError(ErrorCodes.TOKEN_NOT_FOUND, `Token not found: ${tokenOrSymbol}`, `Use a valid address or one of: ${CORE_TOKEN_SYMBOLS.join(", ")}`);
+}
+/**
+ * Get symbol for a token address (reverse lookup)
+ * @param address - Token address
+ * @param userAliases - Optional user-defined token aliases
+ * @returns Symbol if found, shortened address otherwise
+ */
+export function getTokenSymbol(address, userAliases) {
+    const checksummed = getAddress(address);
+    // Check user aliases first
+    if (userAliases) {
+        for (const [symbol, addr] of Object.entries(userAliases)) {
+            if (getAddress(addr) === checksummed) {
+                return symbol;
+            }
+        }
+    }
+    // Check core tokens
+    for (const [symbol, addr] of Object.entries(CORE_TOKENS)) {
+        if (getAddress(addr) === checksummed) {
+            return symbol;
+        }
+    }
+    // Return shortened address if not found
+    return `${checksummed.slice(0, 6)}...${checksummed.slice(-4)}`;
+}
+/**
+ * Check if a token is a core token
+ */
+export function isCoreToken(address) {
+    const checksummed = getAddress(address);
+    return Object.values(CORE_TOKENS).some((addr) => getAddress(addr) === checksummed);
+}
+/**
+ * Get all core token addresses
+ */
+export function getCoreTokenAddresses() {
+    return Object.values(CORE_TOKENS).map((addr) => getAddress(addr));
+}
+//# sourceMappingURL=coreTokens.js.map

package/dist/jaine/coreTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coreTokens.js","sourceRoot":"","sources":["../../src/jaine/coreTokens.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAA4B;IAClD,IAAI,EAAE,4CAA4C;IAClD,IAAI,EAAE,4CAA4C;IAClD,OAAO,EAAE,4CAA4C;IACrD,OAAO,EAAE,4CAA4C;IACrD,GAAG,EAAE,4CAA4C;IACjD,IAAI,EAAE,4CAA4C;IAClD,MAAM,EAAE,4CAA4C;IACpD,GAAG,EAAE,4CAA4C;IACjD,KAAK,EAAE,4CAA4C;IACnD,IAAI,EAAE,4CAA4C;IAClD,WAAW,EAAE,4CAA4C;IACzD,IAAI,EAAE,4CAA4C;CAC1C,CAAC;AAEX,iCAAiC;AACjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAiC,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,aAAqB,EACrB,WAAqC;IAErC,sDAAsD;IACtD,IAAI,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAED,6CAA6C;IAC7C,MAAM,WAAW,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAEhD,gDAAgD;IAChD,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACzD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;gBACzC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;YACzC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,UAAU,CAAC,eAAe,EAC1B,oBAAoB,aAAa,EAAE,EACnC,kCAAkC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAgB,EAChB,WAAqC;IAErC,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAExC,2BAA2B;IAC3B,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACzD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;gBACrC,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACzD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YACrC,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,CAAC;AACrF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/jaine/pathEncoding.d.ts

@@ -0,0 +1,39 @@
+import type { Address, Hex } 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 declare function encodePath(tokens: Address[], fees: number[]): Hex;
+/**
+ * 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 declare function encodePathForExactOutput(tokens: Address[], fees: number[]): Hex;
+/**
+ * Decode path bytes into tokens and fees
+ *
+ * @param path - Encoded path bytes
+ * @returns Object with tokens array and fees array
+ */
+export declare function decodePath(path: Hex): {
+    tokens: Address[];
+    fees: number[];
+};
+/**
+ * Calculate the number of hops in a path
+ */
+export declare function getPathHops(tokens: Address[]): number;
+/**
+ * Format path as human-readable string
+ * e.g., "USDC → [0.3%] → w0G → [0.05%] → WETH"
+ */
+export declare function formatPath(tokens: Address[], fees: number[], getSymbol: (addr: Address) => string): string;
+//# sourceMappingURL=pathEncoding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathEncoding.d.ts","sourceRoot":"","sources":["../../src/jaine/pathEncoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAGzC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAwBjE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAK/E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG;IAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA4B3E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,OAAO,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GACnC,MAAM,CAaR"}

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,47 @@
+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>;
+/**
+ * Sync pool cache from Goldsky subgraph (fast, read-only).
+ * Fetches top pools by TVL and maps them to PoolInfo format.
+ */
+export declare function syncPoolsFromSubgraph(maxPools?: number, onProgress?: (poolsFetched: number) => void): Promise<PoolInfo[]>;
+/**
+ * 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;AAUxE,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;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,GAAE,MAA6C,EACvD,UAAU,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,GAC1C,OAAO,CAAC,QAAQ,EAAE,CAAC,CA4BrB;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"}