@andrewkimjoseph/celina-sdk 0.4.12 → 0.5.1

package/build/tools/swap-routing.js

@@ -0,0 +1,105 @@
+function parseExpectedOut(value) {
+    const n = Number(value.replace(/,/g, ""));
+    return Number.isFinite(n) ? n : 0;
+}
+function isMentoRouteError(message) {
+    return /no mento fx route|mento fx market is currently closed/i.test(message);
+}
+function isUniswapRouteError(message) {
+    return /no uniswap v4 route|insufficient liquidity in uniswap v4/i.test(message);
+}
+function isInsufficientBalanceError(message) {
+    return /insufficient .+ balance/i.test(message);
+}
+function rejectionMessage(reason) {
+    return reason instanceof Error ? reason.message : String(reason);
+}
+async function tryMentoQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.mentoFx.getFxQuote(tokenIn, tokenOut, amount, from);
+    return {
+        protocol: "mento_fx",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+async function tryUniswapQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.uniswap.getSwapQuote(tokenIn, tokenOut, amount, from);
+    return {
+        protocol: "uniswap_v4",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+/** Quote a swap across Mento FX and Uniswap v4; returns the best available route. */
+export async function getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount, from) {
+    const [mentoResult, uniswapResult] = await Promise.allSettled([
+        tryMentoQuote(celina, tokenIn, tokenOut, amount, from),
+        tryUniswapQuote(celina, tokenIn, tokenOut, amount, from),
+    ]);
+    const successes = [];
+    const alternatives = [];
+    if (mentoResult.status === "fulfilled") {
+        successes.push(mentoResult.value);
+    }
+    else {
+        const message = rejectionMessage(mentoResult.reason);
+        if (!isMentoRouteError(message)) {
+            alternatives.push({ protocol: "mento_fx", expectedOut: "0", error: message });
+        }
+    }
+    if (uniswapResult.status === "fulfilled") {
+        successes.push(uniswapResult.value);
+    }
+    else {
+        const message = rejectionMessage(uniswapResult.reason);
+        if (!isUniswapRouteError(message)) {
+            alternatives.push({ protocol: "uniswap_v4", expectedOut: "0", error: message });
+        }
+    }
+    if (successes.length === 0) {
+        const failures = [mentoResult, uniswapResult]
+            .filter((result) => result.status === "rejected")
+            .map((result) => rejectionMessage(result.reason));
+        const balanceError = failures.find(isInsufficientBalanceError);
+        if (balanceError) {
+            throw new Error(balanceError);
+        }
+        throw new Error(`No swap route for ${tokenIn} → ${tokenOut} via Mento FX or Uniswap v4.`);
+    }
+    successes.sort((a, b) => parseExpectedOut(b.expectedOut) - parseExpectedOut(a.expectedOut));
+    const best = successes[0];
+    const otherProtocols = successes.slice(1).map((q) => ({
+        protocol: q.protocol,
+        expectedOut: q.expectedOut,
+    }));
+    return {
+        ...best,
+        alternatives: otherProtocols.length > 0 ? otherProtocols : alternatives,
+    };
+}
+export async function prepareSwapWithFallback(celina, from, tokenIn, tokenOut, amount, params, protocol) {
+    const chosen = protocol ??
+        (await getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount, from))
+            .protocol;
+    if (chosen === "mento_fx") {
+        return celina.mentoFx.prepareFx(from, tokenIn, tokenOut, amount, {
+            recipient: params?.recipient,
+            slippageTolerance: params?.slippageTolerance,
+            deadlineMinutes: params?.deadlineMinutes,
+        });
+    }
+    return celina.uniswap.prepareSwap(from, tokenIn, tokenOut, amount, {
+        recipient: params?.recipient,
+        slippageTolerance: params?.slippageTolerance,
+        deadlineMinutes: params?.deadlineMinutes,
+    });
+}
+//# sourceMappingURL=swap-routing.js.map

package/build/tools/swap-routing.js.map

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

package/build/tools/types.d.ts

@@ -0,0 +1,134 @@
+import type { z } from "zod";
+import type { CelinaClient } from "../index.js";
+import type { CarbonWriteBody } from "../services/carbon.service.js";
+export type ToolSurface = "mcp" | "celeste";
+export type ToolFamily = "read" | "prepare" | "execute";
+export type WalletInput = {
+    address?: string;
+    wallet_address?: string;
+    from?: string;
+};
+export type McpToolAnnotations = {
+    readOnlyHint?: boolean;
+    idempotentHint?: boolean;
+    destructiveHint?: boolean;
+    openWorldHint?: boolean;
+};
+export type McpToolMeta = {
+    title?: string;
+    annotations?: McpToolAnnotations;
+    /** MCP adapter uses okSelfSession for QR registration flows. */
+    responseKind?: "default" | "self_session";
+};
+export type ToolRuntimeHooks = {
+    beforePrepareSend?: (params: {
+        sender: `0x${string}`;
+        token: string;
+        amount: string;
+    }) => Promise<void>;
+    carbon?: {
+        validateBody?: (toolName: string, body: CarbonWriteBody) => void;
+        prepare?: (toolName: string, sender: `0x${string}`, prepareFn: (body: CarbonWriteBody) => Promise<unknown>, body: CarbonWriteBody, options?: {
+            marketPriceFallback?: boolean;
+            concentrated?: boolean;
+        }) => Promise<unknown>;
+    };
+};
+export type TransactionExecutors = {
+    estimateSend: (to: `0x${string}`, token: string, amount: string) => Promise<unknown>;
+    sendToken: (to: `0x${string}`, token: string, amount: string) => Promise<unknown>;
+};
+export type MentoFxExecutors = {
+    estimate: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+    execute: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+};
+export type UniswapExecutors = {
+    estimate: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+    execute: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+};
+export type AaveExecutors = {
+    supply: (token: string, amount: string) => Promise<unknown>;
+    withdraw: (token: string, amount?: string, withdrawMax?: boolean) => Promise<unknown>;
+};
+export type CarbonWriteExecutors = {
+    executeLimitOrder: (body: Record<string, unknown>) => Promise<unknown>;
+    executeRangeOrder: (body: Record<string, unknown>) => Promise<unknown>;
+    executeRecurringStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeConcentratedStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeFullRangeStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeRepriceStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeEditStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeDepositBudget: (body: Record<string, unknown>) => Promise<unknown>;
+    executeWithdrawBudget: (body: Record<string, unknown>) => Promise<unknown>;
+    executePauseStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeResumeStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeDeleteStrategy: (body: Record<string, unknown>) => Promise<unknown>;
+    executeTrade: (body: Record<string, unknown>) => Promise<unknown>;
+};
+export type GoodDollarWriteExecutors = {
+    claimDailyUbi: () => Promise<unknown>;
+};
+export type SelfExecutors = {
+    verifyAgent: (args: Record<string, unknown>) => Promise<unknown>;
+    lookupAgent: (agentId: number) => Promise<unknown>;
+    verifyRequest: (args: Record<string, unknown>) => Promise<unknown>;
+    registerAgent: (args: Record<string, unknown>) => Promise<unknown>;
+    checkRegistration: (sessionId: string) => Promise<unknown>;
+    getIdentity: () => Promise<unknown>;
+    refreshProof: (args: Record<string, unknown>) => Promise<unknown>;
+    deregisterAgent: () => Promise<unknown>;
+    signRequest: (args: Record<string, unknown>) => Promise<unknown>;
+    authenticatedFetch: (args: Record<string, unknown>) => Promise<unknown>;
+};
+export type ToolRuntimeExecutors = {
+    transaction?: TransactionExecutors;
+    mentoFx?: MentoFxExecutors;
+    uniswap?: UniswapExecutors;
+    aave?: AaveExecutors;
+    carbonWrite?: CarbonWriteExecutors;
+    gooddollarWrite?: GoodDollarWriteExecutors;
+    self?: SelfExecutors;
+};
+export interface ToolRuntime {
+    celina: CelinaClient;
+    resolveWallet: (input?: WalletInput) => `0x${string}`;
+    hooks?: ToolRuntimeHooks;
+    executors?: ToolRuntimeExecutors;
+    /** MCP session wallet metadata for get_wallet_address. */
+    mcpWallet?: {
+        address: `0x${string}`;
+        hasWallet: boolean;
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodTypeAny;
+    families: ToolFamily[];
+    surfaces?: ToolSurface[];
+    mcp?: McpToolMeta;
+    handler: (runtime: ToolRuntime, input: Record<string, unknown>) => Promise<unknown>;
+}
+export type FilterToolsOptions = {
+    surface?: ToolSurface;
+    families?: ToolFamily[];
+    names?: string[];
+    carbonPrepareEnabled?: boolean;
+    carbonExecuteEnabled?: boolean;
+};

package/build/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/build/tools/utils/carbon-prepare-handler.d.ts

@@ -0,0 +1,6 @@
+import type { CarbonWriteBody } from "../../services/carbon.service.js";
+import type { ToolRuntime } from "../types.js";
+export declare function runCarbonPrepare(runtime: ToolRuntime, toolName: string, prepareFn: (body: CarbonWriteBody) => Promise<unknown>, input: Record<string, unknown>, options?: {
+    marketPriceFallback?: boolean;
+    concentrated?: boolean;
+}): Promise<unknown>;

package/build/tools/utils/carbon-prepare-handler.js

@@ -0,0 +1,17 @@
+import { finalizeCarbonPrepare } from "../../utils/finalize-carbon-prepare.js";
+import { resolveWalletFromRuntime } from "./wallet.js";
+export async function runCarbonPrepare(runtime, toolName, prepareFn, input, options) {
+    const sender = resolveWalletFromRuntime(runtime, {
+        wallet_address: input.wallet_address,
+        from: input.from,
+    });
+    const body = { ...input, wallet_address: sender };
+    if (runtime.hooks?.carbon?.prepare) {
+        return runtime.hooks.carbon.prepare(toolName, sender, prepareFn, body, options);
+    }
+    runtime.hooks?.carbon?.validateBody?.(toolName, body);
+    const prepared = await prepareFn(body);
+    const preparedFlow = await finalizeCarbonPrepare(runtime.celina.carbon, sender, prepared, body);
+    return { ...prepared, preparedFlow };
+}
+//# sourceMappingURL=carbon-prepare-handler.js.map

package/build/tools/utils/carbon-prepare-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon-prepare-handler.js","sourceRoot":"","sources":["../../../src/tools/utils/carbon-prepare-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAoB,EACpB,QAAgB,EAChB,SAAsD,EACtD,KAA8B,EAC9B,OAAmE;IAEnE,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE;QAC/C,cAAc,EAAE,KAAK,CAAC,cAAoC;QAC1D,IAAI,EAAE,KAAK,CAAC,IAA0B;KACvC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,MAAM,EAAqB,CAAC;IAErE,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACnC,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EACrB,MAAM,EACN,QAAuD,EACvD,IAAI,CACL,CAAC;IACF,OAAO,EAAE,GAAI,QAAmB,EAAE,YAAY,EAAE,CAAC;AACnD,CAAC"}

package/build/tools/utils/normalize-token.d.ts

@@ -0,0 +1,2 @@
+/** Normalize common LLM token shorthands before registry lookup. */
+export declare function normalizeRegistryTokenInput(token: string): string;

package/build/tools/utils/normalize-token.js

@@ -0,0 +1,12 @@
+const REGISTRY_ALIASES = {
+    GD: "GoodDollar",
+    "G$": "GoodDollar",
+    GOODDOLLAR: "GoodDollar",
+};
+/** Normalize common LLM token shorthands before registry lookup. */
+export function normalizeRegistryTokenInput(token) {
+    const trimmed = token.trim();
+    const upper = trimmed.toUpperCase();
+    return REGISTRY_ALIASES[upper] ?? REGISTRY_ALIASES[trimmed] ?? trimmed;
+}
+//# sourceMappingURL=normalize-token.js.map

package/build/tools/utils/normalize-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-token.js","sourceRoot":"","sources":["../../../src/tools/utils/normalize-token.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAA2B;IAC/C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AACzE,CAAC"}

package/build/tools/utils/wallet.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRuntime, WalletInput } from "../types.js";
+export declare function resolveWalletFromRuntime(runtime: ToolRuntime, input?: WalletInput): `0x${string}`;

package/build/tools/utils/wallet.js

@@ -0,0 +1,4 @@
+export function resolveWalletFromRuntime(runtime, input) {
+    return runtime.resolveWallet(input);
+}
+//# sourceMappingURL=wallet.js.map

package/build/tools/utils/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../src/tools/utils/wallet.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CACtC,OAAoB,EACpB,KAAmB;IAEnB,OAAO,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.4.12",
+  "version": "0.5.1",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,
@@ -16,6 +16,11 @@
       "types": "./tests/testing-entry.ts",
       "import": "./tests/testing-entry.ts",
       "default": "./tests/testing-entry.ts"
+    },
+    "./tools": {
+      "types": "./build/tools/index.d.ts",
+      "import": "./build/tools/index.js",
+      "default": "./build/tools/index.js"
     }
   },
   "files": [
@@ -69,6 +74,7 @@
   },
   "homepage": "https://andrewkimjoseph.gitbook.io/celina-sdk",
   "dependencies": {
+    "zod": "^3.24.3",
     "@amplitude/analytics-node": "^1.5.21",
     "@noble/ed25519": "^3.1.0",
     "@bancor/carbon-sdk": "0.0.130-DEV",

package/tests/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="../assets/celina-banner.png" alt="Celina — Give your LLM a wallet on Celo">
+</p>
+
 # Celina operations test framework
 
 Live Celo mainnet smoke tests driven by a single operation catalog in `tests/catalog/operations.ts`. Add one `OperationSpec` when you ship a new SDK method or MCP tool.

package/tests/catalog/operations.ts

@@ -16,6 +16,7 @@ import {
 } from "./domains/chain-ext.js";
 import { selfOperations } from "./domains/self.js";
 import { carbonOperations } from "./domains/carbon.js";
+import { getMcpToolNames } from "../../src/tools/catalog.js";
 import type { OperationSpec } from "./types.js";
 
 export const OPERATIONS: OperationSpec[] = [
@@ -45,4 +46,13 @@ export const SDK_OPERATIONS = OPERATIONS.filter(
     Boolean(spec.sdk),
 );
 
-export const MCP_TOOL_NAMES = MCP_OPERATIONS.map((spec) => spec.mcp.tool);
+/** MCP tool names from the SDK tools catalog (stdio: prepare + execute Carbon). */
+export const MCP_TOOL_NAMES = getMcpToolNames({
+  carbonPrepareEnabled: true,
+  carbonExecuteEnabled: true,
+});
+
+/** @deprecated Use MCP_TOOL_NAMES — kept for tests that import the operations-derived list. */
+export const MCP_TOOL_NAMES_FROM_OPERATIONS = MCP_OPERATIONS.map(
+  (spec) => spec.mcp.tool,
+);

package/tests/testing-entry.ts

@@ -9,6 +9,11 @@ export {
   OPERATIONS,
   SDK_OPERATIONS,
 } from "./catalog/operations.js";
+export {
+  ALL_TOOL_DEFINITIONS,
+  getMcpToolNames,
+  getCelesteToolNames,
+} from "../src/tools/catalog.js";
 export { getMainnetFixtures, type MainnetFixtures } from "./fixtures/mainnet.js";
 export {
   allowsDestructiveTests,