@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2

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

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import { addressOrEnsSchema, addressSchema, hexDataSchema, optionalWalletAddressSchema, tokenSymbolSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime, useMcpServerExecutor } 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;
+            const from = input.from;
+            if (runtime.executors?.transaction &&
+                useMcpServerExecutor(runtime, from)) {
+                const estimate = await runtime.executors.transaction.estimateSend(address, token, amount);
+                if (ens) {
+                    return Object.assign({}, estimate, { ens });
+                }
+                return estimate;
+            }
+            const sender = resolveWalletFromRuntime(runtime, {
+                from,
+                address: 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"],
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        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: ["browser"],
+        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/src/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/src/tools/domains/uniswap.d.ts

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

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

@@ -0,0 +1,67 @@
+import { uniswapQuoteSchema, uniswapWalletSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime, useMcpServerExecutor } 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) => runtime.celina.uniswap.getSwapQuote(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount),
+    },
+    {
+        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 from = input.from;
+            const sender = resolveWalletFromRuntime(runtime, { from });
+            if (runtime.executors?.uniswap && useMcpServerExecutor(runtime, from)) {
+                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"],
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        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: ["browser"],
+        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/src/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/src/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/src/tools/filter.js

@@ -0,0 +1,50 @@
+import { requireWalletParamsInInputSchema } from "./schemas/wallet-params.js";
+const ESTIMATE_PREFIX = "estimate_";
+function requireExplicitWalletAddresses(definitions) {
+    return definitions.map((def) => {
+        const inputSchema = requireWalletParamsInInputSchema(def.inputSchema, {
+            toolName: def.name,
+        });
+        if (inputSchema === def.inputSchema) {
+            return def;
+        }
+        return { ...def, inputSchema };
+    });
+}
+export function filterToolDefinitions(definitions, options = {}) {
+    const filtered = definitions.filter((def) => {
+        if (options.surface) {
+            const surfaces = def.surfaces ?? ["mcp", "browser"];
+            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(ESTIMATE_PREFIX) && options.estimateToolsEnabled === false) {
+            return false;
+        }
+        if (options.serverKeyToolsEnabled === false && def.requiresEnv?.length) {
+            if (def.requiresEnv.includes("CELO_PRIVATE_KEY") ||
+                def.requiresEnv.includes("SELF_AGENT_PRIVATE_KEY")) {
+                return false;
+            }
+        }
+        if (options.selfSessionToolsEnabled === false &&
+            def.requiresEnv?.includes("SELF_SESSION")) {
+            return false;
+        }
+        return true;
+    });
+    if (options.serverKeyToolsEnabled === false) {
+        return requireExplicitWalletAddresses(filtered);
+    }
+    return filtered;
+}
+//# sourceMappingURL=filter.js.map

package/build/src/tools/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/tools/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAG9E,MAAM,eAAe,GAAG,WAAW,CAAC;AAEpC,SAAS,8BAA8B,CACrC,WAA6B;IAE7B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,WAAW,GAAG,gCAAgC,CAAC,GAAG,CAAC,WAAW,EAAE;YACpE,QAAQ,EAAE,GAAG,CAAC,IAAI;SACnB,CAAC,CAAC;QACH,IAAI,WAAW,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,WAA6B,EAC7B,UAA8B,EAAE;IAEhC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1C,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,eAAe,CAAC,IAAI,OAAO,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YACnF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,OAAO,CAAC,qBAAqB,KAAK,KAAK,IAAI,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YACvE,IACE,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAC5C,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAClD,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IACE,OAAO,CAAC,uBAAuB,KAAK,KAAK;YACzC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC,EACzC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;QAC5C,OAAO,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/build/src/tools/index.d.ts

@@ -0,0 +1,7 @@
+export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getBrowserToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, assertSnakeCaseRecordKeys, getToolInputSchemaShape, } 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 { deriveToolAvailability, getHostedMcpToolCount, getHostedMcpToolDefinitions, getHostedMcpToolNames, getMcpToolNameSet, getWebsiteToolBaselines, HOSTED_MCP_FILTER, toWebsiteToolBaseline, TOOL_CATEGORY_BY_NAME, type WebsiteToolAvailability, type WebsiteToolBaseline, type WebsiteToolCategory, type WebsiteToolKind, } from "./website-sync.js";

package/build/src/tools/index.js

@@ -0,0 +1,7 @@
+export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getBrowserToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, assertSnakeCaseRecordKeys, getToolInputSchemaShape, } 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 { deriveToolAvailability, getHostedMcpToolCount, getHostedMcpToolDefinitions, getHostedMcpToolNames, getMcpToolNameSet, getWebsiteToolBaselines, HOSTED_MCP_FILTER, toWebsiteToolBaseline, TOOL_CATEGORY_BY_NAME, } from "./website-sync.js";
+//# sourceMappingURL=index.js.map

package/build/src/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,EAC5B,yBAAyB,EACzB,uBAAuB,GACxB,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,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GAKtB,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,165 @@
+import { z } from "zod";
+export declare const addressSchema: z.ZodString;
+export declare const optionalWalletAddressSchema: z.ZodOptional<z.ZodString>;
+export declare const requiredWalletAddressSchema: z.ZodString;
+/** Input keys that default to the MCP signer when omitted on local stdio. */
+export declare const WALLET_PARAM_KEYS: readonly ["address", "wallet_address", "from", "from_address"];
+export declare const addressOrEnsSchema: z.ZodString;
+export declare const blockIdSchema: z.ZodEffects<z.ZodUnion<[z.ZodLiteral<"latest">, z.ZodLiteral<"pending">, z.ZodNumber, z.ZodString]>, string | number, unknown>;
+export declare const positiveIntSchema: z.ZodEffects<z.ZodNumber, number, unknown>;
+export declare const optionalPositiveIntSchema: z.ZodEffects<z.ZodOptional<z.ZodNumber>, number | undefined, unknown>;
+export declare const optionalAgeLiteralSchema: z.ZodEffects<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<18>, z.ZodLiteral<21>]>>, 0 | 18 | 21 | undefined, unknown>;
+export declare const optionalBooleanSchema: z.ZodEffects<z.ZodOptional<z.ZodBoolean>, boolean | undefined, unknown>;
+export declare const optionalStringSchema: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
+export declare const optionalHexKeySchema: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, unknown>;
+/** Treat empty form strings as omitted for optional enum fields. */
+export declare function optionalEnumSchema<T extends [string, ...string[]]>(values: T): z.ZodEffects<z.ZodOptional<z.ZodEnum<z.Writeable<T>>>, z.Writeable<T>[number] | undefined, unknown>;
+export declare const nonNegativeIntSchema: z.ZodEffects<z.ZodNumber, number, unknown>;
+export declare const coercedNumberSchema: z.ZodEffects<z.ZodNumber, number, unknown>;
+export declare const slippageToleranceSchema: z.ZodEffects<z.ZodNumber, number, unknown>;
+/** Optional positive integer with an upper bound (e.g. page_size caps). */
+export declare function optionalBoundedPositiveInt(max: number): z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+/** Optional positive integer with min/max (e.g. get_latest_blocks count). */
+export declare function optionalBoundedPositiveIntRange(min: number, max: number): z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+export declare const tokenSymbolSchema: z.ZodString;
+export declare const ensNameSchema: z.ZodString;
+export declare const httpRequestPathSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, unknown>;
+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.ZodEffects<z.ZodNumber, number, unknown>>;
+    readonly page_size: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+    readonly offset: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+    readonly limit: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+};
+export declare const hexDataSchema: z.ZodOptional<z.ZodString>;
+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.ZodEffects<z.ZodNumber, number, unknown>>;
+    deadline_minutes: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+}, "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?: unknown;
+    deadline_minutes?: unknown;
+}>;
+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.ZodEffects<z.ZodNumber, number, unknown>>;
+    deadline_minutes: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+}, "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?: unknown;
+    deadline_minutes?: unknown;
+}>;
+export declare const goodDollarReserveAmountSideSchema: z.ZodDefault<z.ZodOptional<z.ZodEnum<["in", "out"]>>>;
+export declare const goodDollarReserveQuoteSchema: z.ZodObject<{
+    token_in: z.ZodString;
+    token_out: z.ZodString;
+    amount: z.ZodString;
+    amount_side: z.ZodDefault<z.ZodOptional<z.ZodEnum<["in", "out"]>>>;
+    from: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    amount_side: "in" | "out";
+    from?: string | undefined;
+}, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+    amount_side?: "in" | "out" | undefined;
+}>;
+export declare const goodDollarReserveWalletSchema: z.ZodObject<{
+    token_in: z.ZodString;
+    token_out: z.ZodString;
+    amount: z.ZodString;
+    amount_side: z.ZodDefault<z.ZodOptional<z.ZodEnum<["in", "out"]>>>;
+    from: z.ZodOptional<z.ZodString>;
+} & {
+    recipient: z.ZodOptional<z.ZodString>;
+    slippage_tolerance: z.ZodOptional<z.ZodEffects<z.ZodNumber, number, unknown>>;
+}, "strip", z.ZodTypeAny, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    amount_side: "in" | "out";
+    from?: string | undefined;
+    recipient?: string | undefined;
+    slippage_tolerance?: number | undefined;
+}, {
+    amount: string;
+    token_in: string;
+    token_out: string;
+    from?: string | undefined;
+    recipient?: string | undefined;
+    slippage_tolerance?: unknown;
+    amount_side?: "in" | "out" | undefined;
+}>;

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

@@ -0,0 +1,207 @@
+import { z } from "zod";
+import { canonicalizeSigningUrl } from "../../utils/self-signing.js";
+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 requiredWalletAddressSchema = addressSchema.describe("Wallet on Celo mainnet (0x address).");
+/** Input keys that default to the MCP signer when omitted on local stdio. */
+export const WALLET_PARAM_KEYS = [
+    "address",
+    "wallet_address",
+    "from",
+    "from_address",
+];
+export const addressOrEnsSchema = z
+    .string()
+    .min(3)
+    .describe("Recipient 0x address or ENS name (e.g. andrewkimjoseph.celo.eth, celina.eth)");
+function normalizeBlockId(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "latest" || trimmed === "pending") {
+            return trimmed;
+        }
+        if (/^\d+$/.test(trimmed)) {
+            return Number(trimmed);
+        }
+        return trimmed;
+    }
+    return value;
+}
+function normalizeOptionalEmpty(value) {
+    if (value === "" || value === null) {
+        return undefined;
+    }
+    return value;
+}
+function normalizePositiveInt(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "") {
+            return undefined;
+        }
+        if (/^\d+$/.test(trimmed)) {
+            return Number(trimmed);
+        }
+        return trimmed;
+    }
+    return value;
+}
+function normalizeOptionalBoolean(value) {
+    const empty = normalizeOptionalEmpty(value);
+    if (empty === undefined) {
+        return undefined;
+    }
+    if (typeof empty === "string") {
+        const trimmed = empty.trim().toLowerCase();
+        if (trimmed === "true" || trimmed === "1") {
+            return true;
+        }
+        if (trimmed === "false" || trimmed === "0") {
+            return false;
+        }
+    }
+    return empty;
+}
+function normalizeAgeLiteral(value) {
+    const empty = normalizeOptionalEmpty(value);
+    if (empty === undefined) {
+        return undefined;
+    }
+    if (typeof empty === "string") {
+        const trimmed = empty.trim();
+        if (trimmed === "") {
+            return undefined;
+        }
+        if (/^\d+$/.test(trimmed)) {
+            return Number(trimmed);
+        }
+    }
+    return empty;
+}
+function normalizeDecimalNumber(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (/^-?\d+(\.\d+)?$/.test(trimmed)) {
+            return Number(trimmed);
+        }
+        return trimmed;
+    }
+    return value;
+}
+export const blockIdSchema = z.preprocess(normalizeBlockId, z.union([
+    z.literal("latest"),
+    z.literal("pending"),
+    z.number().int().nonnegative(),
+    z.string().regex(/^0x[a-fA-F0-9]+$/, "Invalid block hash"),
+]));
+export const positiveIntSchema = z.preprocess(normalizePositiveInt, z.number().int().positive());
+export const optionalPositiveIntSchema = z.preprocess(normalizePositiveInt, z.number().int().positive().optional());
+export const optionalAgeLiteralSchema = z.preprocess(normalizeAgeLiteral, z.union([z.literal(0), z.literal(18), z.literal(21)]).optional());
+export const optionalBooleanSchema = z.preprocess(normalizeOptionalBoolean, z.boolean().optional());
+export const optionalStringSchema = z.preprocess(normalizeOptionalEmpty, z.string().optional());
+export const optionalHexKeySchema = z.preprocess(normalizeOptionalEmpty, z.string().regex(/^0x[a-fA-F0-9]+$/).optional());
+/** Treat empty form strings as omitted for optional enum fields. */
+export function optionalEnumSchema(values) {
+    return z.preprocess(normalizeOptionalEmpty, z.enum(values).optional());
+}
+export const nonNegativeIntSchema = z.preprocess(normalizePositiveInt, z.number().int().min(0));
+export const coercedNumberSchema = z.preprocess(normalizeDecimalNumber, z.number());
+export const slippageToleranceSchema = z.preprocess(normalizeDecimalNumber, z.number().min(0).max(20));
+/** Optional positive integer with an upper bound (e.g. page_size caps). */
+export function optionalBoundedPositiveInt(max) {
+    return z
+        .preprocess(normalizePositiveInt, z.number().int().min(1).max(max))
+        .optional();
+}
+/** Optional positive integer with min/max (e.g. get_latest_blocks count). */
+export function optionalBoundedPositiveIntRange(min, max) {
+    return z
+        .preprocess(normalizePositiveInt, z.number().int().min(min).max(max))
+        .optional();
+}
+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 andrewkimjoseph.celo.eth");
+function normalizeHttpRequestPath(value) {
+    if (typeof value === "string") {
+        return value.trim();
+    }
+    return value;
+}
+export const httpRequestPathSchema = z.preprocess(normalizeHttpRequestPath, z
+    .string()
+    .min(1)
+    .refine((s) => !s.includes(".."), "HTTP request path must not contain '..'")
+    .transform((s) => canonicalizeSigningUrl(s))
+    .describe("HTTP request path or URL path+query that was signed — not a filesystem path."));
+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: positiveIntSchema.optional(),
+    page_size: positiveIntSchema.optional(),
+    offset: nonNegativeIntSchema.optional(),
+    limit: positiveIntSchema.optional(),
+};
+export const hexDataSchema = z
+    .string()
+    .regex(/^0x[a-fA-F0-9]*$/)
+    .optional()
+    .describe("Optional transaction calldata (hex)");
+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: slippageToleranceSchema
+        .optional()
+        .describe("Max slippage in percent (default 0.5)"),
+    deadline_minutes: positiveIntSchema
+        .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: slippageToleranceSchema.optional(),
+    deadline_minutes: positiveIntSchema.optional(),
+});
+export const goodDollarReserveAmountSideSchema = z
+    .enum(["in", "out"])
+    .optional()
+    .default("in")
+    .describe("'in': amount is token_in spend (default). 'out': amount is desired token_out receive amount.");
+export const goodDollarReserveQuoteSchema = z.object({
+    token_in: tokenSymbolSchema.describe("GoodDollar or G$"),
+    token_out: tokenSymbolSchema.describe("USDm or cUSD"),
+    amount: z
+        .string()
+        .describe("Human-readable amount; paired with amount_side (in = spend, out = receive)"),
+    amount_side: goodDollarReserveAmountSideSchema,
+    from: optionalWalletAddressSchema,
+});
+export const goodDollarReserveWalletSchema = goodDollarReserveQuoteSchema.extend({
+    recipient: addressSchema.optional(),
+    slippage_tolerance: slippageToleranceSchema.optional(),
+});
+//# sourceMappingURL=common.js.map