@andrewkimjoseph/celina-sdk 0.4.12 → 0.5.0

package/build/tools/domains/token.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { optionalWalletAddressSchema, tokenSymbolSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const tokenToolDefinitions = [
+    {
+        name: "get_celo_balances",
+        description: "Balances for named registry tokens on Celo mainnet. Default tokens: CELO + USDm.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+            tokens: z.array(tokenSymbolSchema).optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Celo Balances", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.token.getBalances(target, input.tokens);
+        },
+    },
+    {
+        name: "get_stablecoin_balances",
+        description: "Scan all registry stablecoins for an address in one call. Omits zero balances by default.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+            stablecoins: z.array(z.string()).optional(),
+            include_zero: z.boolean().optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Stablecoin Balances", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.token.getStablecoinBalances(target, {
+                stablecoins: input.stablecoins,
+                includeZero: input.include_zero,
+            });
+        },
+    },
+    {
+        name: "get_token_info",
+        description: "Registry token metadata (symbol, address, decimals). Does not read balances.",
+        inputSchema: z.object({
+            token: tokenSymbolSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Token Info", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.token.getTokenInfo(normalizeRegistryTokenInput(input.token)),
+    },
+    {
+        name: "get_token_balance",
+        description: "Balance for one registry token. Pass a symbol or known registry contract address.",
+        inputSchema: z.object({
+            token: tokenSymbolSchema,
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Token Balance", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.token.getTokenBalance(normalizeRegistryTokenInput(input.token), target);
+        },
+    },
+];
+//# sourceMappingURL=token.js.map

package/build/tools/domains/token.js.map

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

package/build/tools/domains/transaction.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "../types.js";
+export declare const transactionToolDefinitions: ToolDefinition[];

package/build/tools/domains/transaction.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import { addressOrEnsSchema, addressSchema, hexDataSchema, optionalWalletAddressSchema, tokenSymbolSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+export const transactionToolDefinitions = [
+    {
+        name: "estimate_send",
+        description: "Estimates gas for sending CELO or an ERC-20. Recipient can be ENS.",
+        inputSchema: z.object({
+            to: addressOrEnsSchema,
+            token: tokenSymbolSchema.optional(),
+            amount: z.string(),
+            from: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Estimate Send", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const { address, ens } = await runtime.celina.ens.resolveAddressOrEns(input.to);
+            const token = normalizeRegistryTokenInput(input.token ?? "CELO");
+            const amount = input.amount;
+            if (runtime.executors?.transaction) {
+                const estimate = await runtime.executors.transaction.estimateSend(address, token, amount);
+                if (ens) {
+                    return Object.assign({}, estimate, { ens });
+                }
+                return estimate;
+            }
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+                address: input.from,
+            });
+            const estimate = await runtime.celina.transaction.estimateSend(sender, address, token, amount);
+            return ens ? { ...estimate, ens } : estimate;
+        },
+    },
+    {
+        name: "send_token",
+        description: "Send CELO or an ERC-20 on mainnet. Requires CELO_PRIVATE_KEY in MCP server env.",
+        inputSchema: z.object({
+            to: addressOrEnsSchema,
+            token: tokenSymbolSchema.optional(),
+            amount: z.string(),
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Send Token",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const tx = runtime.executors?.transaction;
+            if (!tx)
+                throw new Error("Transaction executor not configured.");
+            const { address, ens } = await runtime.celina.ens.resolveAddressOrEns(input.to);
+            const result = await tx.sendToken(address, normalizeRegistryTokenInput(input.token ?? "CELO"), input.amount);
+            return ens ? Object.assign({}, result, { ens }) : result;
+        },
+    },
+    {
+        name: "prepare_send",
+        description: "Prepare an unsigned send transaction. User must confirm and sign in wallet.",
+        inputSchema: z.object({
+            to: addressOrEnsSchema,
+            token: z.string(),
+            amount: z.string(),
+            from: optionalWalletAddressSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            const token = normalizeRegistryTokenInput(input.token);
+            const amount = input.amount;
+            await runtime.hooks?.beforePrepareSend?.({ sender, token, amount });
+            const { address } = await runtime.celina.ens.resolveAddressOrEns(input.to);
+            return runtime.celina.transaction.prepareSend(sender, address, token, amount);
+        },
+    },
+    {
+        name: "get_gas_fee_data",
+        description: "Returns current gas fee data including EIP-1559 fees on mainnet.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        mcp: {
+            title: "Get Gas Fee Data",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime) => runtime.celina.transaction.getGasFeeData(),
+    },
+    {
+        name: "estimate_transaction",
+        description: "Estimates gas for a generic transaction (to/value/data) from a wallet.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+            to: addressSchema,
+            value: z.string().optional(),
+            data: hexDataSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Estimate Transaction", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+                address: input.from,
+            });
+            return runtime.celina.transaction.estimateTransaction({
+                from: sender,
+                to: input.to,
+                value: input.value,
+                data: input.data,
+            });
+        },
+    },
+];
+//# sourceMappingURL=transaction.js.map

package/build/tools/domains/transaction.js.map

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

package/build/tools/domains/uniswap.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "../types.js";
+export declare const uniswapToolDefinitions: ToolDefinition[];

package/build/tools/domains/uniswap.js

@@ -0,0 +1,72 @@
+import { uniswapQuoteSchema, uniswapWalletSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+function mapUniswapWalletOptions(input) {
+    return {
+        recipient: input.recipient,
+        slippageTolerance: input.slippage_tolerance,
+        deadlineMinutes: input.deadline_minutes,
+    };
+}
+export const uniswapToolDefinitions = [
+    {
+        name: "get_uniswap_quote",
+        description: "Uniswap v4 AMM quote for a token pair on Celo mainnet.",
+        inputSchema: uniswapQuoteSchema,
+        families: ["read"],
+        mcp: { title: "Get Uniswap Quote", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const from = input.from
+                ? resolveWalletFromRuntime(runtime, { from: input.from })
+                : undefined;
+            return runtime.celina.uniswap.getSwapQuote(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, from);
+        },
+    },
+    {
+        name: "estimate_uniswap_swap",
+        description: "Estimate gas for a Uniswap v4 swap including ERC-20 and Permit2 approvals when needed.",
+        inputSchema: uniswapWalletSchema,
+        families: ["read"],
+        mcp: { title: "Estimate Uniswap Swap", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            if (runtime.executors?.uniswap) {
+                return runtime.executors.uniswap.estimate(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapUniswapWalletOptions(input));
+            }
+            return runtime.celina.uniswap.estimateSwap(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapUniswapWalletOptions(input));
+        },
+    },
+    {
+        name: "execute_uniswap_swap",
+        description: "Execute a Uniswap v4 swap on Celo mainnet. Requires CELO_PRIVATE_KEY.",
+        inputSchema: uniswapWalletSchema,
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Execute Uniswap Swap",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const uni = runtime.executors?.uniswap;
+            if (!uni)
+                throw new Error("Uniswap executor not configured.");
+            return uni.execute(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapUniswapWalletOptions(input));
+        },
+    },
+    {
+        name: "prepare_uniswap_swap",
+        description: "Prepare Uniswap v4 swap only. Prefer prepare_swap after get_swap_quote for automatic routing.",
+        inputSchema: uniswapWalletSchema,
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.uniswap.prepareSwap(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapUniswapWalletOptions(input));
+        },
+    },
+];
+//# sourceMappingURL=uniswap.js.map

package/build/tools/domains/uniswap.js.map

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

package/build/tools/filter.d.ts

@@ -0,0 +1,2 @@
+import type { FilterToolsOptions, ToolDefinition } from "./types.js";
+export declare function filterToolDefinitions(definitions: ToolDefinition[], options?: FilterToolsOptions): ToolDefinition[];

package/build/tools/filter.js

@@ -0,0 +1,28 @@
+const CARBON_PREPARE_PREFIX = "prepare_carbon_";
+const CARBON_EXECUTE_PREFIX = "execute_carbon_";
+export function filterToolDefinitions(definitions, options = {}) {
+    return definitions.filter((def) => {
+        if (options.surface) {
+            const surfaces = def.surfaces ?? ["mcp", "celeste"];
+            if (!surfaces.includes(options.surface)) {
+                return false;
+            }
+        }
+        if (options.families?.length) {
+            if (!options.families.some((f) => def.families.includes(f))) {
+                return false;
+            }
+        }
+        if (options.names?.length && !options.names.includes(def.name)) {
+            return false;
+        }
+        if (def.name.startsWith(CARBON_PREPARE_PREFIX) && options.carbonPrepareEnabled === false) {
+            return false;
+        }
+        if (def.name.startsWith(CARBON_EXECUTE_PREFIX) && options.carbonExecuteEnabled === false) {
+            return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=filter.js.map

package/build/tools/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/tools/filter.ts"],"names":[],"mappings":"AAEA,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAChD,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEhD,MAAM,UAAU,qBAAqB,CACnC,WAA6B,EAC7B,UAA8B,EAAE;IAEhC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACpD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,OAAO,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YACzF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,IAAI,OAAO,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YACzF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/build/tools/index.d.ts

@@ -0,0 +1,7 @@
+export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getCelesteToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, } from "./catalog.js";
+export { filterToolDefinitions } from "./filter.js";
+export { getSwapQuoteWithFallback, prepareSwapWithFallback, type SwapProtocol, type SwapQuoteResult, type SwapPrepareParams, } from "./swap-routing.js";
+export * from "./schemas/common.js";
+export type { FilterToolsOptions, McpToolAnnotations, McpToolMeta, ToolDefinition, ToolFamily, ToolRuntime, ToolRuntimeExecutors, ToolRuntimeHooks, ToolSurface, WalletInput, } from "./types.js";
+export { normalizeRegistryTokenInput } from "./utils/normalize-token.js";
+export { runCarbonPrepare } from "./utils/carbon-prepare-handler.js";

package/build/tools/index.js

@@ -0,0 +1,7 @@
+export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getCelesteToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, } from "./catalog.js";
+export { filterToolDefinitions } from "./filter.js";
+export { getSwapQuoteWithFallback, prepareSwapWithFallback, } from "./swap-routing.js";
+export * from "./schemas/common.js";
+export { normalizeRegistryTokenInput } from "./utils/normalize-token.js";
+export { runCarbonPrepare } from "./utils/carbon-prepare-handler.js";
+//# sourceMappingURL=index.js.map

package/build/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,4BAA4B,GAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GAIxB,MAAM,mBAAmB,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAapC,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}

package/build/tools/schemas/common.d.ts

@@ -0,0 +1,110 @@
+import { z } from "zod";
+export declare const addressSchema: z.ZodString;
+export declare const optionalWalletAddressSchema: z.ZodOptional<z.ZodString>;
+export declare const addressOrEnsSchema: z.ZodString;
+export declare const blockIdSchema: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodLiteral<"latest">, z.ZodLiteral<"pending">]>;
+export declare const tokenSymbolSchema: z.ZodString;
+export declare const ensNameSchema: z.ZodString;
+export declare const tokenIdSchema: z.ZodString;
+export declare const abiSchema: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+export declare const paginationFields: {
+    readonly page: z.ZodOptional<z.ZodNumber>;
+    readonly page_size: z.ZodOptional<z.ZodNumber>;
+    readonly offset: z.ZodOptional<z.ZodNumber>;
+    readonly limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare const hexDataSchema: z.ZodOptional<z.ZodString>;
+export declare const carbonWriteSchema: z.ZodObject<{
+    wallet_address: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    wallet_address: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    wallet_address: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const mentoFxQuoteSchema: z.ZodObject<{
+    token_in: z.ZodString;
+    token_out: z.ZodString;
+    amount: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+}, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+}>;
+export declare const mentoFxWalletSchema: z.ZodObject<{
+    token_in: z.ZodString;
+    token_out: z.ZodString;
+    amount: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+} & {
+    recipient: z.ZodOptional<z.ZodString>;
+    slippage_tolerance: z.ZodOptional<z.ZodNumber>;
+    deadline_minutes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+    recipient?: string | undefined;
+    slippage_tolerance?: number | undefined;
+    deadline_minutes?: number | undefined;
+}, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+    recipient?: string | undefined;
+    slippage_tolerance?: number | undefined;
+    deadline_minutes?: number | undefined;
+}>;
+export declare const uniswapQuoteSchema: z.ZodObject<{
+    token_in: z.ZodString;
+    token_out: z.ZodString;
+    amount: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+}, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+}>;
+export declare const uniswapWalletSchema: z.ZodObject<{
+    token_in: z.ZodString;
+    token_out: z.ZodString;
+    amount: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+} & {
+    recipient: z.ZodOptional<z.ZodString>;
+    slippage_tolerance: z.ZodOptional<z.ZodNumber>;
+    deadline_minutes: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+    recipient?: string | undefined;
+    slippage_tolerance?: number | undefined;
+    deadline_minutes?: number | undefined;
+}, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+    recipient?: string | undefined;
+    slippage_tolerance?: number | undefined;
+    deadline_minutes?: number | undefined;
+}>;

package/build/tools/schemas/common.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+export const addressSchema = z
+    .string()
+    .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address");
+export const optionalWalletAddressSchema = addressSchema
+    .optional()
+    .describe("Wallet on Celo mainnet. Omit to use the connected wallet or MCP CELO_PRIVATE_KEY signer.");
+export const addressOrEnsSchema = z
+    .string()
+    .min(3)
+    .describe("Recipient 0x address or ENS name (e.g. andrewkimjoseph.celo.eth, celina.eth)");
+export const blockIdSchema = z.union([
+    z.number().int().nonnegative(),
+    z.string().regex(/^0x[a-fA-F0-9]+$/, "Invalid block hash"),
+    z.literal("latest"),
+    z.literal("pending"),
+]);
+export const tokenSymbolSchema = z
+    .string()
+    .describe("Celo mainnet token symbol (e.g. CELO, USDm, USDC, USDT)");
+export const ensNameSchema = z
+    .string()
+    .min(3)
+    .describe("ENS name, e.g. celina.eth or vitalik.eth");
+export const tokenIdSchema = z.string().describe("NFT token ID (decimal string)");
+export const abiSchema = z
+    .array(z.record(z.unknown()))
+    .min(1)
+    .describe("Contract ABI as a JSON array");
+export const paginationFields = {
+    page: z.number().int().min(1).optional(),
+    page_size: z.number().int().min(1).optional(),
+    offset: z.number().int().min(0).optional(),
+    limit: z.number().int().min(1).optional(),
+};
+export const hexDataSchema = z
+    .string()
+    .regex(/^0x[a-fA-F0-9]*$/)
+    .optional()
+    .describe("Optional transaction calldata (hex)");
+export const carbonWriteSchema = z
+    .object({
+    wallet_address: optionalWalletAddressSchema,
+    from: addressSchema.optional(),
+})
+    .passthrough();
+export const mentoFxQuoteSchema = z.object({
+    token_in: tokenSymbolSchema.describe("Input token symbol or address"),
+    token_out: tokenSymbolSchema.describe("Output token symbol or address"),
+    amount: z.string().describe("Human-readable amount of token_in, e.g. 100"),
+    from: optionalWalletAddressSchema,
+});
+export const mentoFxWalletSchema = mentoFxQuoteSchema.extend({
+    recipient: addressSchema
+        .optional()
+        .describe("Address that receives output tokens (defaults to signer)"),
+    slippage_tolerance: z
+        .number()
+        .min(0)
+        .max(20)
+        .optional()
+        .describe("Max slippage in percent (default 0.5)"),
+    deadline_minutes: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Transaction deadline in minutes (default 5)"),
+});
+export const uniswapQuoteSchema = z.object({
+    token_in: tokenSymbolSchema,
+    token_out: tokenSymbolSchema,
+    amount: z.string().describe("Human-readable amount of token_in"),
+    from: optionalWalletAddressSchema,
+});
+export const uniswapWalletSchema = uniswapQuoteSchema.extend({
+    recipient: addressSchema.optional(),
+    slippage_tolerance: z.number().min(0).max(20).optional(),
+    deadline_minutes: z.number().int().positive().optional(),
+});
+//# sourceMappingURL=common.js.map

package/build/tools/schemas/common.js.map

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

package/build/tools/swap-routing.d.ts

@@ -0,0 +1,24 @@
+import type { CelinaClient } from "../index.js";
+export type SwapProtocol = "mento_fx" | "uniswap_v4";
+export interface SwapQuoteResult {
+    protocol: SwapProtocol;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    expectedOut: string;
+    routeHops: number;
+    network: "mainnet";
+    alternatives?: Array<{
+        protocol: SwapProtocol;
+        expectedOut: string;
+        error?: string;
+    }>;
+}
+export interface SwapPrepareParams {
+    recipient?: `0x${string}`;
+    slippageTolerance?: number;
+    deadlineMinutes?: number;
+}
+/** Quote a swap across Mento FX and Uniswap v4; returns the best available route. */
+export declare function getSwapQuoteWithFallback(celina: CelinaClient, tokenIn: string, tokenOut: string, amount: string, from?: `0x${string}`): Promise<SwapQuoteResult>;
+export declare function prepareSwapWithFallback(celina: CelinaClient, from: `0x${string}`, tokenIn: string, tokenOut: string, amount: string, params?: SwapPrepareParams, protocol?: SwapProtocol): Promise<import("../index.js").SerializedPreparedFlow>;