imm-cli 0.1.0

package/dist/jaine/abi/router.js

@@ -0,0 +1,88 @@
+/**
+ * Jaine (Uniswap V3) SwapRouter ABI - for executing swaps
+ */
+export const ROUTER_ABI = [
+    {
+        type: "function",
+        name: "exactInput",
+        stateMutability: "payable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    { name: "path", type: "bytes" },
+                    { name: "recipient", type: "address" },
+                    { name: "deadline", type: "uint256" },
+                    { name: "amountIn", type: "uint256" },
+                    { name: "amountOutMinimum", type: "uint256" },
+                ],
+            },
+        ],
+        outputs: [{ name: "amountOut", type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "exactInputSingle",
+        stateMutability: "payable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    { name: "tokenIn", type: "address" },
+                    { name: "tokenOut", type: "address" },
+                    { name: "fee", type: "uint24" },
+                    { name: "recipient", type: "address" },
+                    { name: "deadline", type: "uint256" },
+                    { name: "amountIn", type: "uint256" },
+                    { name: "amountOutMinimum", type: "uint256" },
+                    { name: "sqrtPriceLimitX96", type: "uint160" },
+                ],
+            },
+        ],
+        outputs: [{ name: "amountOut", type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "exactOutput",
+        stateMutability: "payable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    { name: "path", type: "bytes" },
+                    { name: "recipient", type: "address" },
+                    { name: "deadline", type: "uint256" },
+                    { name: "amountOut", type: "uint256" },
+                    { name: "amountInMaximum", type: "uint256" },
+                ],
+            },
+        ],
+        outputs: [{ name: "amountIn", type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "exactOutputSingle",
+        stateMutability: "payable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    { name: "tokenIn", type: "address" },
+                    { name: "tokenOut", type: "address" },
+                    { name: "fee", type: "uint24" },
+                    { name: "recipient", type: "address" },
+                    { name: "deadline", type: "uint256" },
+                    { name: "amountOut", type: "uint256" },
+                    { name: "amountInMaximum", type: "uint256" },
+                    { name: "sqrtPriceLimitX96", type: "uint160" },
+                ],
+            },
+        ],
+        outputs: [{ name: "amountIn", type: "uint256" }],
+    },
+];
+//# sourceMappingURL=router.js.map

package/dist/jaine/abi/router.js.map

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

package/dist/jaine/abi/w0g.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Wrapped 0G (W0G) ABI - WETH9-style wrapper for native 0G token
+ */
+export declare const W0G_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "deposit";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "withdraw";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "wad";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "balanceOf";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "account";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "totalSupply";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}];
+//# sourceMappingURL=w0g.d.ts.map

package/dist/jaine/abi/w0g.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"w0g.d.ts","sourceRoot":"","sources":["../../../src/jaine/abi/w0g.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BV,CAAC"}

package/dist/jaine/abi/w0g.js

@@ -0,0 +1,34 @@
+/**
+ * Wrapped 0G (W0G) ABI - WETH9-style wrapper for native 0G token
+ */
+export const W0G_ABI = [
+    {
+        type: "function",
+        name: "deposit",
+        stateMutability: "payable",
+        inputs: [],
+        outputs: [],
+    },
+    {
+        type: "function",
+        name: "withdraw",
+        stateMutability: "nonpayable",
+        inputs: [{ name: "wad", type: "uint256" }],
+        outputs: [],
+    },
+    {
+        type: "function",
+        name: "balanceOf",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "totalSupply",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+];
+//# sourceMappingURL=w0g.js.map

package/dist/jaine/abi/w0g.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"w0g.js","sourceRoot":"","sources":["../../../src/jaine/abi/w0g.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,SAAS;QACf,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAE;KACZ;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,WAAW;QACjB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,aAAa;QACnB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC;CACO,CAAC"}

package/dist/jaine/allowance.d.ts

@@ -0,0 +1,48 @@
+import type { Address, Hex } from "viem";
+/**
+ * Allowed spenders - only these addresses can be approved
+ */
+export declare function getAllowedSpenders(): Record<string, Address>;
+export type SpenderType = "router" | "nft";
+/**
+ * Validate that spender is in the allowlist
+ */
+export declare function validateSpender(spender: Address): void;
+/**
+ * Get spender address by type
+ */
+export declare function getSpenderAddress(spenderType: SpenderType): Address;
+/**
+ * Get current allowance for a token
+ */
+export declare function getAllowance(token: Address, owner: Address, spender: Address): Promise<bigint>;
+/**
+ * Get allowances for both spenders
+ */
+export declare function getAllAllowances(token: Address, owner: Address): Promise<Record<SpenderType, bigint>>;
+export interface ApproveResult {
+    txHash: Hex;
+    resetTxHash?: Hex;
+}
+/**
+ * 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 declare function safeApprove(token: Address, spender: Address, amount: bigint, privateKey: Hex): Promise<ApproveResult>;
+/**
+ * Revoke approval (set to 0)
+ */
+export declare function revokeApproval(token: Address, spender: Address, privateKey: Hex): Promise<Hex>;
+/**
+ * Ensure allowance is sufficient, approve if needed
+ */
+export declare function ensureAllowance(token: Address, spender: Address, requiredAmount: bigint, privateKey: Hex, approveExact?: boolean): Promise<ApproveResult | null>;
+//# sourceMappingURL=allowance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"allowance.d.ts","sourceRoot":"","sources":["../../src/jaine/allowance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAUzC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5D;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE3C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAatD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAGnE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAuBtC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC;IACZ,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,aAAa,CAAC,CA0ExB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,GAAG,CAAC,CAoCd;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,GAAG,EACf,YAAY,GAAE,OAAe,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAU/B"}

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 { ImmError, 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 ImmError(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 ImmError(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 ImmError(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 ImmError(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 ImmError 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 { ImmError, 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 ImmError 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 ImmError(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":"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"}

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"}