@andrewkimjoseph/celina-sdk 0.2.6 → 0.2.8

package/build/services/uniswap-path-router.js

@@ -0,0 +1,155 @@
+import { v4QuoterAbi } from "../abis/uniswap-v4-quoter.js";
+import { normalizeUniswapPoolKey, UNISWAP_V4, } from "../config/uniswap.js";
+import { getUniswapPoolIndex, } from "./uniswap-pool-discovery.js";
+const MAX_HOPS = 2;
+function otherToken(poolKey, currency) {
+    const c = currency.toLowerCase();
+    if (poolKey.currency0.toLowerCase() === c)
+        return poolKey.currency1;
+    if (poolKey.currency1.toLowerCase() === c)
+        return poolKey.currency0;
+    return null;
+}
+function buildPathKeys(pools, currencyIn) {
+    let current = currencyIn;
+    const pathKeys = [];
+    for (const poolKey of pools) {
+        const out = otherToken(poolKey, current);
+        if (!out) {
+            throw new Error("Invalid swap path for Uniswap v4 pools.");
+        }
+        pathKeys.push({
+            intermediateCurrency: out,
+            fee: poolKey.fee,
+            tickSpacing: poolKey.tickSpacing,
+            hooks: poolKey.hooks,
+            hookData: "0x",
+        });
+        current = out;
+    }
+    return pathKeys;
+}
+function enumeratePaths(index, currencyIn, currencyOut) {
+    const start = currencyIn.toLowerCase();
+    const goal = currencyOut.toLowerCase();
+    if (start === goal) {
+        return [];
+    }
+    const results = [];
+    const queue = [{ currency: start, pools: [], visited: new Set([start]) }];
+    while (queue.length > 0) {
+        const node = queue.shift();
+        if (node.pools.length >= MAX_HOPS + 1) {
+            continue;
+        }
+        const neighbors = index.adjacency.get(node.currency);
+        if (!neighbors) {
+            continue;
+        }
+        for (const neighbor of neighbors) {
+            if (node.visited.has(neighbor)) {
+                continue;
+            }
+            const poolKey = index.edges.find((edge) => {
+                const a = edge.tokenA.toLowerCase();
+                const b = edge.tokenB.toLowerCase();
+                return ((a === node.currency && b === neighbor) ||
+                    (a === neighbor && b === node.currency));
+            })?.poolKey;
+            if (!poolKey) {
+                continue;
+            }
+            const nextPools = [...node.pools, poolKey];
+            if (neighbor === goal) {
+                results.push(nextPools);
+                continue;
+            }
+            if (nextPools.length <= MAX_HOPS) {
+                queue.push({
+                    currency: neighbor,
+                    pools: nextPools,
+                    visited: new Set([...node.visited, neighbor]),
+                });
+            }
+        }
+    }
+    return results;
+}
+async function quotePath(client, currencyIn, pools, amountIn) {
+    if (pools.length === 0) {
+        return 0n;
+    }
+    if (pools.length === 1) {
+        const poolKey = normalizeUniswapPoolKey(pools[0]);
+        const zeroForOne = currencyIn.toLowerCase() === poolKey.currency0.toLowerCase();
+        const { result } = await client.simulateContract({
+            address: UNISWAP_V4.v4Quoter,
+            abi: v4QuoterAbi,
+            functionName: "quoteExactInputSingle",
+            args: [
+                {
+                    poolKey,
+                    zeroForOne,
+                    exactAmount: amountIn,
+                    hookData: "0x",
+                },
+            ],
+        });
+        return result[0];
+    }
+    const pathKeys = buildPathKeys(pools, currencyIn);
+    const { result } = await client.simulateContract({
+        address: UNISWAP_V4.v4Quoter,
+        abi: v4QuoterAbi,
+        functionName: "quoteExactInput",
+        args: [
+            {
+                exactCurrency: currencyIn,
+                path: pathKeys,
+                exactAmount: amountIn,
+            },
+        ],
+    });
+    return result[0];
+}
+export async function findBestUniswapRoute(client, currencyIn, currencyOut, amountIn) {
+    const index = await getUniswapPoolIndex(client);
+    const candidatePaths = enumeratePaths(index, currencyIn, currencyOut);
+    let best = null;
+    for (const pools of candidatePaths) {
+        try {
+            const amountOut = await quotePath(client, currencyIn, pools, amountIn);
+            if (amountOut <= 0n) {
+                continue;
+            }
+            if (!best || amountOut > best.amountOut) {
+                best = {
+                    amountOut,
+                    route: {
+                        currencyIn,
+                        currencyOut,
+                        pools,
+                        pathKeys: buildPathKeys(pools, currencyIn),
+                        hops: pools.length,
+                    },
+                };
+            }
+        }
+        catch {
+            // skip paths that fail to quote
+        }
+    }
+    if (!best) {
+        return null;
+    }
+    return {
+        route: best.route,
+        amountOut: best.amountOut,
+        indexSource: index.source,
+    };
+}
+export function applySlippage(amountOut, slippagePercent) {
+    const bps = BigInt(Math.round(slippagePercent * 100));
+    return (amountOut * (10000n - bps)) / 10000n;
+}
+//# sourceMappingURL=uniswap-path-router.js.map

package/build/services/uniswap-path-router.js.map

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

package/build/services/uniswap-pool-discovery.d.ts

@@ -0,0 +1,21 @@
+import { type PublicClient } from "viem";
+import { type UniswapPoolKey } from "../config/uniswap.js";
+export type UniswapPoolEdge = {
+    poolKey: UniswapPoolKey;
+    tokenA: `0x${string}`;
+    tokenB: `0x${string}`;
+};
+export type UniswapPoolIndex = {
+    edges: UniswapPoolEdge[];
+    /** currency address (lowercase) → neighbor currencies */
+    adjacency: Map<string, Set<string>>;
+    source: "subgraph" | "onchain";
+    fetchedAt: number;
+};
+export declare function computeUniswapPoolId(poolKey: UniswapPoolKey): `0x${string}`;
+export declare function getUniswapPoolIndex(client: PublicClient, options?: {
+    forceRefresh?: boolean;
+}): Promise<UniswapPoolIndex>;
+export declare function findPoolBetween(index: UniswapPoolIndex, tokenA: `0x${string}`, tokenB: `0x${string}`): UniswapPoolKey | null;
+/** Reset cached index (for tests). */
+export declare function resetUniswapPoolIndexCache(): void;

package/build/services/uniswap-pool-discovery.js

@@ -0,0 +1,183 @@
+import { encodeAbiParameters, keccak256, parseAbiParameters, } from "viem";
+import { stateViewAbi } from "../abis/uniswap-state-view.js";
+import { normalizeUniswapPoolKey, UNISWAP_DEFAULT_TICK_SPACING, UNISWAP_FEE_TIERS, UNISWAP_HUB_CURRENCIES, UNISWAP_POOL_CACHE_TTL_MS, UNISWAP_SUBGRAPH_URL, UNISWAP_V4, } from "../config/uniswap.js";
+let cachedIndex = null;
+export function computeUniswapPoolId(poolKey) {
+    const normalized = normalizeUniswapPoolKey(poolKey);
+    return keccak256(encodeAbiParameters(parseAbiParameters("address currency0, address currency1, uint24 fee, int24 tickSpacing, address hooks"), [
+        normalized.currency0,
+        normalized.currency1,
+        normalized.fee,
+        normalized.tickSpacing,
+        normalized.hooks,
+    ]));
+}
+function addEdge(edges, adjacency, poolKey) {
+    const normalized = normalizeUniswapPoolKey(poolKey);
+    const a = normalized.currency0.toLowerCase();
+    const b = normalized.currency1.toLowerCase();
+    if (edges.some((edge) => edge.poolKey === normalized)) {
+        return;
+    }
+    edges.push({
+        poolKey: normalized,
+        tokenA: normalized.currency0,
+        tokenB: normalized.currency1,
+    });
+    if (!adjacency.has(a))
+        adjacency.set(a, new Set());
+    if (!adjacency.has(b))
+        adjacency.set(b, new Set());
+    adjacency.get(a).add(b);
+    adjacency.get(b).add(a);
+}
+async function fetchSubgraphPools() {
+    try {
+        const response = await fetch(UNISWAP_SUBGRAPH_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                query: `{
+          pools(first: 500, orderBy: totalValueLockedUSD, orderDirection: desc) {
+            feeTier
+            tickSpacing
+            hooks
+            token0 { id }
+            token1 { id }
+          }
+        }`,
+            }),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const json = (await response.json());
+        const pools = json.data?.pools;
+        if (!pools?.length) {
+            return null;
+        }
+        const edges = [];
+        const adjacency = new Map();
+        for (const pool of pools) {
+            const poolKey = {
+                currency0: pool.token0.id,
+                currency1: pool.token1.id,
+                fee: Number(pool.feeTier),
+                tickSpacing: Number(pool.tickSpacing),
+                hooks: (pool.hooks || UNISWAP_V4.zeroHooks),
+            };
+            addEdge(edges, adjacency, poolKey);
+        }
+        return edges;
+    }
+    catch {
+        return null;
+    }
+}
+async function probePoolOnChain(client, currencyA, currencyB, fee, tickSpacing) {
+    const poolKey = normalizeUniswapPoolKey({
+        currency0: currencyA,
+        currency1: currencyB,
+        fee,
+        tickSpacing,
+        hooks: UNISWAP_V4.zeroHooks,
+    });
+    const poolId = computeUniswapPoolId(poolKey);
+    try {
+        const [slot0, liquidity] = await Promise.all([
+            client.readContract({
+                address: UNISWAP_V4.stateView,
+                abi: stateViewAbi,
+                functionName: "getSlot0",
+                args: [poolId],
+            }),
+            client.readContract({
+                address: UNISWAP_V4.stateView,
+                abi: stateViewAbi,
+                functionName: "getLiquidity",
+                args: [poolId],
+            }),
+        ]);
+        if (slot0[0] > 0n && liquidity > 0n) {
+            return poolKey;
+        }
+    }
+    catch {
+        // pool not initialized
+    }
+    return null;
+}
+async function buildOnChainIndex(client) {
+    const edges = [];
+    const adjacency = new Map();
+    const hubs = [...UNISWAP_HUB_CURRENCIES];
+    for (let i = 0; i < hubs.length; i++) {
+        for (let j = i + 1; j < hubs.length; j++) {
+            const [currency0, currency1] = hubs[i].toLowerCase() < hubs[j].toLowerCase()
+                ? [hubs[i], hubs[j]]
+                : [hubs[j], hubs[i]];
+            for (const fee of UNISWAP_FEE_TIERS) {
+                const tickSpacing = UNISWAP_DEFAULT_TICK_SPACING[fee] ??
+                    UNISWAP_DEFAULT_TICK_SPACING[3000];
+                const poolKey = await probePoolOnChain(client, currency0, currency1, fee, tickSpacing);
+                if (poolKey) {
+                    addEdge(edges, adjacency, poolKey);
+                }
+            }
+        }
+    }
+    return {
+        edges,
+        adjacency,
+        source: "onchain",
+        fetchedAt: Date.now(),
+    };
+}
+export async function getUniswapPoolIndex(client, options) {
+    const now = Date.now();
+    if (!options?.forceRefresh &&
+        cachedIndex &&
+        now - cachedIndex.fetchedAt < UNISWAP_POOL_CACHE_TTL_MS) {
+        return cachedIndex;
+    }
+    const subgraphEdges = await fetchSubgraphPools();
+    if (subgraphEdges?.length) {
+        const adjacency = new Map();
+        for (const edge of subgraphEdges) {
+            const a = edge.tokenA.toLowerCase();
+            const b = edge.tokenB.toLowerCase();
+            if (!adjacency.has(a))
+                adjacency.set(a, new Set());
+            if (!adjacency.has(b))
+                adjacency.set(b, new Set());
+            adjacency.get(a).add(b);
+            adjacency.get(b).add(a);
+        }
+        cachedIndex = {
+            edges: subgraphEdges,
+            adjacency,
+            source: "subgraph",
+            fetchedAt: now,
+        };
+        return cachedIndex;
+    }
+    cachedIndex = await buildOnChainIndex(client);
+    return cachedIndex;
+}
+export function findPoolBetween(index, tokenA, tokenB) {
+    const a = tokenA.toLowerCase();
+    const b = tokenB.toLowerCase();
+    for (const edge of index.edges) {
+        const e0 = edge.tokenA.toLowerCase();
+        const e1 = edge.tokenB.toLowerCase();
+        if ((e0 === a && e1 === b) || (e0 === b && e1 === a)) {
+            return edge.poolKey;
+        }
+    }
+    return null;
+}
+/** Reset cached index (for tests). */
+export function resetUniswapPoolIndexCache() {
+    cachedIndex = null;
+}
+//# sourceMappingURL=uniswap-pool-discovery.js.map

package/build/services/uniswap-pool-discovery.js.map

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

package/build/services/uniswap.service.d.ts

@@ -0,0 +1,81 @@
+import type { CeloClientFactory } from "../clients/celo-client.js";
+import { type SerializedPreparedFlow } from "../types/prepared.js";
+/** Optional parameters for Uniswap v4 swap estimates and prepares. */
+export interface UniswapSwapParams {
+    /** Max slippage tolerance in percent (default `0.5`). */
+    slippageTolerance?: number;
+    /** Swap deadline in minutes from now (default `5`). */
+    deadlineMinutes?: number;
+    /** Address receiving output tokens (default: `from`). */
+    recipient?: `0x${string}`;
+}
+/** Uniswap v4 quotes, gas estimates, and `prepareSwap` flows on Celo mainnet. */
+export declare class UniswapService {
+    private readonly clientFactory;
+    private readonly tokenService;
+    constructor(clientFactory: CeloClientFactory);
+    private resolvePair;
+    private baseQuoteFields;
+    private buildSwapRoute;
+    private buildUniversalRouterCalldata;
+    private getApprovalSteps;
+    private estimateCallGas;
+    private estimateSwapGasWithAllowance;
+    /**
+     * Expected Uniswap v4 output for a token pair — no wallet required.
+     * @param tokenIn - Input token symbol or address
+     * @param tokenOut - Output token symbol or address
+     * @param amount - Human-readable input amount
+     */
+    getSwapQuote(tokenIn: string, tokenOut: string, amount: string): Promise<{
+        route: {
+            pools: import("../config/uniswap.js").UniswapPoolKey[];
+        };
+        protocol: "uniswap_v4";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+        indexSource: string | undefined;
+    }>;
+    /**
+     * Simulate gas for a Uniswap v4 swap from `from`, including Permit2 approvals when needed.
+     * @param from - Sender wallet address
+     * @param tokenIn - Input token symbol or address
+     * @param tokenOut - Output token symbol or address
+     * @param amount - Human-readable input amount
+     * @param params - Optional slippage, deadline, and recipient
+     */
+    estimateSwap(from: `0x${string}`, tokenIn: string, tokenOut: string, amount: string, params?: UniswapSwapParams): Promise<{
+        from: `0x${string}`;
+        recipient: `0x${string}`;
+        amountOutMin: string;
+        approvalStepsNeeded: number;
+        approvalGas: string[];
+        swapGas: string | undefined;
+        swapGasEstimated: boolean;
+        slippageTolerance: number;
+        deadline: string;
+        deadlineMinutes: number;
+        protocol: "uniswap_v4";
+        network: "mainnet";
+        tokenIn: string;
+        tokenOut: string;
+        amountIn: string;
+        expectedOut: string;
+        routeHops: number;
+        indexSource: string | undefined;
+    }>;
+    /**
+     * Build unsigned Uniswap v4 steps (ERC-20 approve → Permit2 approve → swap when needed).
+     * @param from - Sender wallet address
+     * @param tokenIn - Input token symbol or address
+     * @param tokenOut - Output token symbol or address
+     * @param amount - Human-readable input amount
+     * @param params - Optional slippage, deadline, and recipient
+     * @returns 1–3 step `SerializedPreparedFlow` for sequential wallet signing
+     */
+    prepareSwap(from: `0x${string}`, tokenIn: string, tokenOut: string, amount: string, params?: UniswapSwapParams): Promise<SerializedPreparedFlow>;
+}