@andrewkimjoseph/celina-sdk 0.2.6 → 0.2.7

package/build/abis/permit2.d.ts

@@ -0,0 +1,43 @@
+export declare const permit2Abi: readonly [{
+    readonly name: "allowance";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint48";
+    }];
+}, {
+    readonly name: "approve";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint160";
+    }, {
+        readonly name: "expiration";
+        readonly type: "uint48";
+    }];
+    readonly outputs: readonly [];
+}];

package/build/abis/permit2.js

@@ -0,0 +1,30 @@
+export const permit2Abi = [
+    {
+        name: "allowance",
+        type: "function",
+        stateMutability: "view",
+        inputs: [
+            { name: "owner", type: "address" },
+            { name: "token", type: "address" },
+            { name: "spender", type: "address" },
+        ],
+        outputs: [
+            { name: "amount", type: "uint160" },
+            { name: "expiration", type: "uint48" },
+            { name: "nonce", type: "uint48" },
+        ],
+    },
+    {
+        name: "approve",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "token", type: "address" },
+            { name: "spender", type: "address" },
+            { name: "amount", type: "uint160" },
+            { name: "expiration", type: "uint48" },
+        ],
+        outputs: [],
+    },
+];
+//# sourceMappingURL=permit2.js.map

package/build/abis/permit2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permit2.js","sourceRoot":"","sources":["../../src/abis/permit2.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACrC;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;YACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;SAClC;KACF;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE;SACvC;QACD,OAAO,EAAE,EAAE;KACZ;CACO,CAAC"}

package/build/abis/uniswap-state-view.d.ts

@@ -0,0 +1,34 @@
+export declare const stateViewAbi: readonly [{
+    readonly name: "getSlot0";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "sqrtPriceX96";
+        readonly type: "uint160";
+    }, {
+        readonly name: "tick";
+        readonly type: "int24";
+    }, {
+        readonly name: "protocolFee";
+        readonly type: "uint24";
+    }, {
+        readonly name: "lpFee";
+        readonly type: "uint24";
+    }];
+}, {
+    readonly name: "getLiquidity";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "poolId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "liquidity";
+        readonly type: "uint128";
+    }];
+}];

package/build/abis/uniswap-state-view.js

@@ -0,0 +1,22 @@
+export const stateViewAbi = [
+    {
+        name: "getSlot0",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "poolId", type: "bytes32" }],
+        outputs: [
+            { name: "sqrtPriceX96", type: "uint160" },
+            { name: "tick", type: "int24" },
+            { name: "protocolFee", type: "uint24" },
+            { name: "lpFee", type: "uint24" },
+        ],
+    },
+    {
+        name: "getLiquidity",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "poolId", type: "bytes32" }],
+        outputs: [{ name: "liquidity", type: "uint128" }],
+    },
+];
+//# sourceMappingURL=uniswap-state-view.js.map

package/build/abis/uniswap-state-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-state-view.js","sourceRoot":"","sources":["../../src/abis/uniswap-state-view.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;YACzC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE;YAC/B,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;SAClC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;QACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAClD;CACO,CAAC"}

package/build/abis/uniswap-v4-quoter.d.ts

@@ -0,0 +1,86 @@
+export declare const v4QuoterAbi: readonly [{
+    readonly name: "quoteExactInputSingle";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "poolKey";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "currency0";
+                readonly type: "address";
+            }, {
+                readonly name: "currency1";
+                readonly type: "address";
+            }, {
+                readonly name: "fee";
+                readonly type: "uint24";
+            }, {
+                readonly name: "tickSpacing";
+                readonly type: "int24";
+            }, {
+                readonly name: "hooks";
+                readonly type: "address";
+            }];
+        }, {
+            readonly name: "zeroForOne";
+            readonly type: "bool";
+        }, {
+            readonly name: "exactAmount";
+            readonly type: "uint128";
+        }, {
+            readonly name: "hookData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "quoteExactInput";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "params";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "exactCurrency";
+            readonly type: "address";
+        }, {
+            readonly name: "path";
+            readonly type: "tuple[]";
+            readonly components: readonly [{
+                readonly name: "intermediateCurrency";
+                readonly type: "address";
+            }, {
+                readonly name: "fee";
+                readonly type: "uint24";
+            }, {
+                readonly name: "tickSpacing";
+                readonly type: "int24";
+            }, {
+                readonly name: "hooks";
+                readonly type: "address";
+            }, {
+                readonly name: "hookData";
+                readonly type: "bytes";
+            }];
+        }, {
+            readonly name: "exactAmount";
+            readonly type: "uint128";
+        }];
+    }];
+    readonly outputs: readonly [{
+        readonly name: "amountOut";
+        readonly type: "uint256";
+    }, {
+        readonly name: "gasEstimate";
+        readonly type: "uint256";
+    }];
+}];

package/build/abis/uniswap-v4-quoter.js

@@ -0,0 +1,64 @@
+export const v4QuoterAbi = [
+    {
+        name: "quoteExactInputSingle",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    {
+                        name: "poolKey",
+                        type: "tuple",
+                        components: [
+                            { name: "currency0", type: "address" },
+                            { name: "currency1", type: "address" },
+                            { name: "fee", type: "uint24" },
+                            { name: "tickSpacing", type: "int24" },
+                            { name: "hooks", type: "address" },
+                        ],
+                    },
+                    { name: "zeroForOne", type: "bool" },
+                    { name: "exactAmount", type: "uint128" },
+                    { name: "hookData", type: "bytes" },
+                ],
+            },
+        ],
+        outputs: [
+            { name: "amountOut", type: "uint256" },
+            { name: "gasEstimate", type: "uint256" },
+        ],
+    },
+    {
+        name: "quoteExactInput",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "params",
+                type: "tuple",
+                components: [
+                    { name: "exactCurrency", type: "address" },
+                    {
+                        name: "path",
+                        type: "tuple[]",
+                        components: [
+                            { name: "intermediateCurrency", type: "address" },
+                            { name: "fee", type: "uint24" },
+                            { name: "tickSpacing", type: "int24" },
+                            { name: "hooks", type: "address" },
+                            { name: "hookData", type: "bytes" },
+                        ],
+                    },
+                    { name: "exactAmount", type: "uint128" },
+                ],
+            },
+        ],
+        outputs: [
+            { name: "amountOut", type: "uint256" },
+            { name: "gasEstimate", type: "uint256" },
+        ],
+    },
+];
+//# sourceMappingURL=uniswap-v4-quoter.js.map

package/build/abis/uniswap-v4-quoter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-v4-quoter.js","sourceRoot":"","sources":["../../src/abis/uniswap-v4-quoter.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,OAAO;wBACb,UAAU,EAAE;4BACV,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;4BACtC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;4BACtC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;4BAC/B,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;4BACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;yBACnC;qBACF;oBACD,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE;oBACpC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;oBACxC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;iBACpC;aACF;SACF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SACzC;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,YAAY;QAC7B,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE;oBACV,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1C;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;wBACf,UAAU,EAAE;4BACV,EAAE,IAAI,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE;4BACjD,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;4BAC/B,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE;4BACtC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;4BAClC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;yBACpC;qBACF;oBACD,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;iBACzC;aACF;SACF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE;YACtC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE;SACzC;KACF;CACO,CAAC"}

package/build/abis/universal-router.d.ts

@@ -0,0 +1,16 @@
+export declare const universalRouterAbi: readonly [{
+    readonly name: "execute";
+    readonly type: "function";
+    readonly stateMutability: "payable";
+    readonly inputs: readonly [{
+        readonly name: "commands";
+        readonly type: "bytes";
+    }, {
+        readonly name: "inputs";
+        readonly type: "bytes[]";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];

package/build/abis/universal-router.js

@@ -0,0 +1,14 @@
+export const universalRouterAbi = [
+    {
+        name: "execute",
+        type: "function",
+        stateMutability: "payable",
+        inputs: [
+            { name: "commands", type: "bytes" },
+            { name: "inputs", type: "bytes[]" },
+            { name: "deadline", type: "uint256" },
+        ],
+        outputs: [],
+    },
+];
+//# sourceMappingURL=universal-router.js.map

package/build/abis/universal-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-router.js","sourceRoot":"","sources":["../../src/abis/universal-router.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE;YACnC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE;SACtC;QACD,OAAO,EAAE,EAAE;KACZ;CACO,CAAC"}

package/build/clients/uniswap-sdk.d.ts

@@ -0,0 +1,4 @@
+export declare const Actions: typeof import("@uniswap/v4-sdk").Actions, V4Planner: typeof import("@uniswap/v4-sdk").V4Planner;
+export declare const CommandType: typeof import("@uniswap/universal-router-sdk").CommandType, RoutePlanner: typeof import("@uniswap/universal-router-sdk").RoutePlanner;
+export declare const ChainId: typeof import("@uniswap/sdk-core").ChainId;
+export type { SwapExactInSingle, SwapExactIn } from "@uniswap/v4-sdk";

package/build/clients/uniswap-sdk.js

@@ -0,0 +1,9 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const v4Sdk = require("@uniswap/v4-sdk");
+const universalRouterSdk = require("@uniswap/universal-router-sdk");
+const sdkCore = require("@uniswap/sdk-core");
+export const { Actions, V4Planner } = v4Sdk;
+export const { CommandType, RoutePlanner } = universalRouterSdk;
+export const { ChainId } = sdkCore;
+//# sourceMappingURL=uniswap-sdk.js.map

package/build/clients/uniswap-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap-sdk.js","sourceRoot":"","sources":["../../src/clients/uniswap-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAqC,CAAC;AAC7E,MAAM,kBAAkB,GACtB,OAAO,CAAC,+BAA+B,CAAmD,CAAC;AAC7F,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAuC,CAAC;AAEnF,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;AAC5C,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAAC;AAChE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC"}

package/build/config/uniswap.d.ts

@@ -0,0 +1,36 @@
+/** Uniswap v4 on Celo mainnet — https://docs.celo.org/tooling/contracts/uniswap-contracts */
+export declare const UNISWAP_V4: {
+    readonly poolManager: "0x288dc841A52FCA2707c6947B3A777c5E56cd87BC";
+    readonly v4Quoter: "0x28566da1093609182dff2cb2a91cfd72e61d66cd";
+    readonly stateView: "0xbc21f8720babf4b20d195ee5c6e99c52b76f2bfb";
+    readonly universalRouter: "0xcb695bc5d3aa22cad1e6df07801b061a05a0233a";
+    readonly permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+    readonly zeroHooks: "0x0000000000000000000000000000000000000000";
+    readonly nativeCurrency: "0x0000000000000000000000000000000000000000";
+};
+export declare const UNISWAP_SUBGRAPH_URL = "https://api.studio.thegraph.com/query/111767/uniswap-v-4-celo/version/latest";
+export declare const UNISWAP_POOL_CACHE_TTL_MS: number;
+/** Common v4 fee tiers and default tick spacings (probed on-chain when building index). */
+export declare const UNISWAP_FEE_TIERS: readonly [100, 500, 3000, 10000, 30000];
+export declare const UNISWAP_DEFAULT_TICK_SPACING: Record<number, number>;
+/** Hub tokens for on-chain pool index fallback (Uniswap routing graph). */
+export declare const UNISWAP_HUB_CURRENCIES: readonly `0x${string}`[];
+export type UniswapPoolKey = {
+    currency0: `0x${string}`;
+    currency1: `0x${string}`;
+    fee: number;
+    tickSpacing: number;
+    hooks: `0x${string}`;
+};
+export declare function sortUniswapCurrencies(a: `0x${string}`, b: `0x${string}`): [`0x${string}`, `0x${string}`];
+export declare function normalizeUniswapPoolKey(poolKey: UniswapPoolKey): UniswapPoolKey;
+/** Map registry token to Uniswap v4 currency address (native CELO → address(0)). */
+export declare function toUniswapCurrency(address: `0x${string}` | "native"): `0x${string}`;
+/**
+ * Map registry token to the currency used for pool discovery / quoting.
+ * Celo v4 liquidity is on WCELO pairs, not native address(0).
+ */
+export declare function toUniswapRoutingCurrency(address: `0x${string}` | "native"): `0x${string}`;
+/** ERC-20 used as swap input when registry token is native CELO. */
+export declare function uniswapInputTokenAddress(address: `0x${string}` | "native"): `0x${string}` | "native";
+export declare function isNativeUniswapCurrency(currency: `0x${string}`): boolean;

package/build/config/uniswap.js

@@ -0,0 +1,67 @@
+import { MENTO_CELO_ADDRESS } from "./chains.js";
+/** Uniswap v4 on Celo mainnet — https://docs.celo.org/tooling/contracts/uniswap-contracts */
+export const UNISWAP_V4 = {
+    poolManager: "0x288dc841A52FCA2707c6947B3A777c5E56cd87BC",
+    v4Quoter: "0x28566da1093609182dff2cb2a91cfd72e61d66cd",
+    stateView: "0xbc21f8720babf4b20d195ee5c6e99c52b76f2bfb",
+    universalRouter: "0xcb695bc5d3aa22cad1e6df07801b061a05a0233a",
+    permit2: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+    zeroHooks: "0x0000000000000000000000000000000000000000",
+    nativeCurrency: "0x0000000000000000000000000000000000000000",
+};
+export const UNISWAP_SUBGRAPH_URL = "https://api.studio.thegraph.com/query/111767/uniswap-v-4-celo/version/latest";
+export const UNISWAP_POOL_CACHE_TTL_MS = 5 * 60 * 1000;
+/** Common v4 fee tiers and default tick spacings (probed on-chain when building index). */
+export const UNISWAP_FEE_TIERS = [100, 500, 3000, 10000, 30000];
+export const UNISWAP_DEFAULT_TICK_SPACING = {
+    100: 1,
+    500: 10,
+    3000: 60,
+    10000: 200,
+    30000: 600,
+};
+/** Hub tokens for on-chain pool index fallback (Uniswap routing graph). */
+export const UNISWAP_HUB_CURRENCIES = [
+    UNISWAP_V4.nativeCurrency,
+    MENTO_CELO_ADDRESS,
+    "0xceba9300f2b948710d2653dd7b07f33a8b32118c", // USDC
+    "0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e", // USDT
+    "0xD221812de1BD094f35587EE8E174B07B6167D9Af", // WETH
+    "0x765de816845861e75a25fca122bb6898b8b1282a", // USDm
+    "0x62B8B11039FcfE5aB0C56E502b1C372A3d2a9c7A", // GoodDollar (G$)
+];
+export function sortUniswapCurrencies(a, b) {
+    return a.toLowerCase() < b.toLowerCase() ? [a, b] : [b, a];
+}
+export function normalizeUniswapPoolKey(poolKey) {
+    const [currency0, currency1] = sortUniswapCurrencies(poolKey.currency0, poolKey.currency1);
+    return { ...poolKey, currency0, currency1 };
+}
+/** Map registry token to Uniswap v4 currency address (native CELO → address(0)). */
+export function toUniswapCurrency(address) {
+    if (address === "native") {
+        return UNISWAP_V4.nativeCurrency;
+    }
+    return address;
+}
+/**
+ * Map registry token to the currency used for pool discovery / quoting.
+ * Celo v4 liquidity is on WCELO pairs, not native address(0).
+ */
+export function toUniswapRoutingCurrency(address) {
+    if (address === "native") {
+        return MENTO_CELO_ADDRESS;
+    }
+    return address;
+}
+/** ERC-20 used as swap input when registry token is native CELO. */
+export function uniswapInputTokenAddress(address) {
+    if (address === "native") {
+        return MENTO_CELO_ADDRESS;
+    }
+    return address;
+}
+export function isNativeUniswapCurrency(currency) {
+    return currency.toLowerCase() === UNISWAP_V4.nativeCurrency;
+}
+//# sourceMappingURL=uniswap.js.map

package/build/config/uniswap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniswap.js","sourceRoot":"","sources":["../../src/config/uniswap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW,EAAE,4CAAqD;IAClE,QAAQ,EAAE,4CAAqD;IAC/D,SAAS,EAAE,4CAAqD;IAChE,eAAe,EAAE,4CAAqD;IACtE,OAAO,EAAE,4CAAqD;IAC9D,SAAS,EAAE,4CAAqD;IAChE,cAAc,EAAE,4CAAqD;CAC7D,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8EAA8E,CAAC;AAEjF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAEzE,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,EAAE;IACP,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAA6B;IAC9D,UAAU,CAAC,cAAc;IACzB,kBAAkB;IAClB,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,OAAO;IACrD,4CAA4C,EAAE,kBAAkB;CACjE,CAAC;AAUF,MAAM,UAAU,qBAAqB,CACnC,CAAgB,EAChB,CAAgB;IAEhB,OAAO,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,qBAAqB,CAClD,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,SAAS,CAClB,CAAC;IACF,OAAO,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,cAAc,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAiC;IAEjC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,wBAAwB,CACtC,OAAiC;IAEjC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAuB;IAC7D,OAAO,QAAQ,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,cAAc,CAAC;AAC9D,CAAC"}

package/build/index.d.ts

@@ -7,6 +7,7 @@ import { EnsService } from "./services/ens.service.js";
 import { GoodDollarService } from "./services/gooddollar.service.js";
 import { GovernanceService } from "./services/governance.service.js";
 import { MentoFxService } from "./services/mento-fx.service.js";
+import { UniswapService } from "./services/uniswap.service.js";
 import { NftService } from "./services/nft.service.js";
 import { StakingService } from "./services/staking.service.js";
 import { TokenService } from "./services/token.service.js";
@@ -25,6 +26,8 @@ export interface CelinaClient {
     transaction: TransactionService;
     /** Mento FX quotes, estimates, and `prepareFx` flows. */
     mentoFx: MentoFxService;
+    /** Uniswap v4 quotes, estimates, and `prepareSwap` flows. */
+    uniswap: UniswapService;
     /** Aave V3 `prepareSupply` and `prepareWithdraw` flows on Celo. */
     aave: AaveService;
     /** GoodDollar IdentityV4 whitelist status. */
@@ -50,5 +53,6 @@ export { serializePreparedFlow } from "./types/prepared.js";
 export type { SdkConfig } from "./config/sdk-config.js";
 export type { ResolvedToken } from "./services/token.service.js";
 export type { MentoFxParams } from "./services/mento-fx.service.js";
+export type { UniswapSwapParams } from "./services/uniswap.service.js";
 export type { GovernanceProposalsOptions } from "./services/governance.service.js";
 export type { ContractCallParams } from "./services/contract.service.js";

package/build/index.js

@@ -15,6 +15,7 @@ import { EnsService } from "./services/ens.service.js";
 import { GoodDollarService } from "./services/gooddollar.service.js";
 import { GovernanceService } from "./services/governance.service.js";
 import { MentoFxService } from "./services/mento-fx.service.js";
+import { UniswapService } from "./services/uniswap.service.js";
 import { NftService } from "./services/nft.service.js";
 import { StakingService } from "./services/staking.service.js";
 import { TokenService } from "./services/token.service.js";
@@ -33,6 +34,7 @@ export function createCelinaClient(opts) {
         token: new TokenService(clientFactory),
         transaction: new TransactionService(clientFactory),
         mentoFx: new MentoFxService(clientFactory),
+        uniswap: new UniswapService(clientFactory),
         aave: new AaveService(clientFactory),
         gooddollar: new GoodDollarService(clientFactory),
         ens: new EnsService(ensClientFactory),

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAiCvE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA0B;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO;QACL,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,GAAG,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC;QACrC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,GAAG,EAAE,IAAI,UAAU,CAAC,aAAa,CAAC;QAClC,QAAQ,EAAE,IAAI,eAAe,CAAC,aAAa,CAAC;KAC7C,CAAC;AACJ,CAAC;AAQD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAkB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAmCvE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA0B;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO;QACL,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,GAAG,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC;QACrC,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,GAAG,EAAE,IAAI,UAAU,CAAC,aAAa,CAAC;QAClC,QAAQ,EAAE,IAAI,eAAe,CAAC,aAAa,CAAC;KAC7C,CAAC;AACJ,CAAC;AAQD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/build/services/uniswap-path-router.d.ts

@@ -0,0 +1,22 @@
+import type { PublicClient } from "viem";
+import { type UniswapPoolKey } from "../config/uniswap.js";
+export type UniswapPathKey = {
+    intermediateCurrency: `0x${string}`;
+    fee: number;
+    tickSpacing: number;
+    hooks: `0x${string}`;
+    hookData: `0x${string}`;
+};
+export type UniswapSwapRoute = {
+    currencyIn: `0x${string}`;
+    currencyOut: `0x${string}`;
+    pools: UniswapPoolKey[];
+    pathKeys: UniswapPathKey[];
+    hops: number;
+};
+export declare function findBestUniswapRoute(client: PublicClient, currencyIn: `0x${string}`, currencyOut: `0x${string}`, amountIn: bigint): Promise<{
+    route: UniswapSwapRoute;
+    amountOut: bigint;
+    indexSource: string;
+} | null>;
+export declare function applySlippage(amountOut: bigint, slippagePercent: number): bigint;