@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

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

@@ -0,0 +1,86 @@
+import { z } from "zod";
+import { blockIdSchema, nonNegativeIntSchema, optionalBoundedPositiveIntRange, optionalWalletAddressSchema, } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const blockchainToolDefinitions = [
+    {
+        name: "get_network_status",
+        description: "Returns Celo mainnet chain ID, latest block, and gas price.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        mcp: { title: "Get Network Status", annotations: readOnly },
+        handler: async (runtime) => runtime.celina.blockchain.getNetworkStatus(),
+    },
+    {
+        name: "get_block",
+        description: "Fetch a Celo mainnet block by number, hash, or latest.",
+        inputSchema: z.object({
+            block_id: blockIdSchema,
+            include_transactions: z.boolean().optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Block", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.blockchain.getBlock(input.block_id, {
+            includeTransactions: input.include_transactions,
+        }),
+    },
+    {
+        name: "get_latest_blocks",
+        description: "Fetch the most recent blocks on Celo mainnet.",
+        inputSchema: z.object({
+            count: optionalBoundedPositiveIntRange(1, 100),
+            offset: nonNegativeIntSchema.optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Latest Blocks", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.blockchain.getLatestBlocks(input.count ?? 5, input.offset ?? 0),
+    },
+    {
+        name: "get_transaction",
+        description: "Fetch a transaction and receipt by hash on Celo mainnet.",
+        inputSchema: z.object({
+            hash: z.string().regex(/^0x[a-fA-F0-9]{64}$/),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Transaction", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.blockchain.getTransaction(input.hash),
+    },
+    {
+        name: "get_wallet_address",
+        description: "Returns the wallet address derived from CELO_PRIVATE_KEY in the MCP server env.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        surfaces: ["mcp"],
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        mcp: { title: "Get Wallet Address", annotations: readOnly },
+        handler: async (runtime) => {
+            if (!runtime.mcpWallet?.hasWallet) {
+                throw new Error("No wallet configured. Set CELO_PRIVATE_KEY in the server env.");
+            }
+            return {
+                wallet_address: runtime.mcpWallet.address,
+                has_wallet: true,
+                source: "CELO_PRIVATE_KEY",
+            };
+        },
+    },
+    {
+        name: "get_account",
+        description: "Returns native CELO balance, nonce, and whether the address is a contract.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Account", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.account.getAccount(target);
+        },
+    },
+];
+//# sourceMappingURL=blockchain.js.map

package/build/src/tools/domains/blockchain.js.map

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

package/build/src/tools/domains/browser.d.ts

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

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

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { getSwapQuoteWithFallback, prepareSwapWithFallback, } from "../swap-routing.js";
+import { goodDollarReserveAmountSideSchema, uniswapWalletSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+export const browserToolDefinitions = [
+    {
+        name: "get_swap_quote",
+        description: "Best swap quote on Celo — tries Mento FX, GoodDollar reserve (G$ ↔ USDm), and Uniswap v4 in parallel.",
+        inputSchema: z.object({
+            token_in: z.string(),
+            token_out: z.string(),
+            amount: z.string(),
+        }),
+        families: ["read"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const from = resolveWalletFromRuntime(runtime, {});
+            return getSwapQuoteWithFallback(runtime.celina, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, from);
+        },
+    },
+    {
+        name: "prepare_swap",
+        description: "Prepare unsigned swap using the best route (Mento FX, GoodDollar reserve, or Uniswap v4).",
+        inputSchema: uniswapWalletSchema.extend({
+            protocol: z.enum(["mento_fx", "uniswap_v4", "gooddollar_reserve"]).optional(),
+            amount_side: goodDollarReserveAmountSideSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            const amountSide = input.amount_side === "out" ? "out" : "in";
+            return prepareSwapWithFallback(runtime.celina, sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, {
+                recipient: input.recipient,
+                slippageTolerance: input.slippage_tolerance,
+                deadlineMinutes: input.deadline_minutes,
+                amountSide,
+            }, input.protocol);
+        },
+    },
+];
+//# sourceMappingURL=browser.js.map

package/build/src/tools/domains/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../../src/tools/domains/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,iCAAiC,EACjC,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,uGAAuG;QACzG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,wBAAwB,CAC7B,OAAO,CAAC,MAAM,EACd,2BAA2B,CAAC,KAAK,CAAC,QAAkB,CAAC,EACrD,2BAA2B,CAAC,KAAK,CAAC,SAAmB,CAAC,EACtD,KAAK,CAAC,MAAgB,EACtB,IAAI,CACL,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,2FAA2F;QAC7F,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC7E,WAAW,EAAE,iCAAiC;SAC/C,CAAC;QACF,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE;gBAC/C,IAAI,EAAE,KAAK,CAAC,IAA0B;aACvC,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9D,OAAO,uBAAuB,CAC5B,OAAO,CAAC,MAAM,EACd,MAAM,EACN,2BAA2B,CAAC,KAAK,CAAC,QAAkB,CAAC,EACrD,2BAA2B,CAAC,KAAK,CAAC,SAAmB,CAAC,EACtD,KAAK,CAAC,MAAgB,EACtB;gBACE,SAAS,EAAE,KAAK,CAAC,SAAsC;gBACvD,iBAAiB,EAAE,KAAK,CAAC,kBAAwC;gBACjE,eAAe,EAAE,KAAK,CAAC,gBAAsC;gBAC7D,UAAU;aACX,EACD,KAAK,CAAC,QAAoC,CAC3C,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/build/src/tools/domains/contract.d.ts

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

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

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { abiSchema, addressSchema, optionalWalletAddressSchema, } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+export const contractToolDefinitions = [
+    {
+        name: "call_contract_function",
+        description: "Calls a read-only contract function. Requires caller-supplied ABI JSON.",
+        inputSchema: z.object({
+            contract_address: addressSchema,
+            function_name: z.string().min(1),
+            abi: abiSchema,
+            function_args: z.array(z.unknown()).optional(),
+            from_address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: {
+            title: "Call Contract Function",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => {
+            const from = input.from_address
+                ? resolveWalletFromRuntime(runtime, {
+                    address: input.from_address,
+                })
+                : undefined;
+            return runtime.celina.contract.callFunction({
+                contractAddress: input.contract_address,
+                functionName: input.function_name,
+                abi: input.abi,
+                functionArgs: input.function_args,
+                fromAddress: from,
+            });
+        },
+    },
+    {
+        name: "estimate_contract_gas",
+        description: "Estimates gas for a contract function call. Requires caller-supplied ABI JSON.",
+        inputSchema: z.object({
+            contract_address: addressSchema,
+            function_name: z.string().min(1),
+            abi: abiSchema,
+            function_args: z.array(z.unknown()).optional(),
+            value: z.string().optional(),
+            from: optionalWalletAddressSchema,
+            from_address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Estimate Contract Gas", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const fromField = input.from ??
+                input.from_address;
+            const from = resolveWalletFromRuntime(runtime, {
+                from: fromField,
+                address: fromField,
+            });
+            return runtime.celina.contract.estimateGas({
+                contractAddress: input.contract_address,
+                functionName: input.function_name,
+                abi: input.abi,
+                functionArgs: input.function_args,
+                fromAddress: from,
+                value: input.value,
+            });
+        },
+    },
+];
+//# sourceMappingURL=contract.js.map

package/build/src/tools/domains/contract.js.map

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

package/build/src/tools/domains/ens.d.ts

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

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

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { ensNameSchema } from "../schemas/common.js";
+export const ensToolDefinitions = [
+    {
+        name: "resolve_ens",
+        description: "Resolve a Celo or Ethereum ENS name to an address. Defaults to Celo coin record with Ethereum fallback.",
+        inputSchema: z.object({
+            name: ensNameSchema,
+            chain: z.enum(["celo", "ethereum"]).optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Resolve ENS", annotations: { readOnlyHint: true, idempotentHint: true } },
+        handler: async (runtime, input) => runtime.celina.ens.resolveEns(input.name, input.chain ?? "celo"),
+    },
+];
+//# sourceMappingURL=ens.js.map

package/build/src/tools/domains/ens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ens.js","sourceRoot":"","sources":["../../../../src/tools/domains/ens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,yGAAyG;QAC3G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC/C,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE;QACxF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAC3B,KAAK,CAAC,IAAc,EACnB,KAAK,CAAC,KAAyC,IAAI,MAAM,CAC3D;KACJ;CACF,CAAC"}

package/build/src/tools/domains/gooddollar.d.ts

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

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

@@ -0,0 +1,171 @@
+import { z } from "zod";
+import { goodDollarReserveQuoteSchema, goodDollarReserveWalletSchema, optionalWalletAddressSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime, useMcpServerExecutor } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+function mapReserveWalletOptions(input) {
+    const amountSide = input.amount_side === "out" ? "out" : "in";
+    return {
+        recipient: input.recipient,
+        slippageTolerance: input.slippage_tolerance,
+        amountSide: amountSide,
+    };
+}
+function mapReserveQuoteOptions(input) {
+    return {
+        amountSide: input.amount_side === "out" ? "out" : "in",
+    };
+}
+const NON_IDENTITY_RESERVE_NOTE = " Uses the literal signing wallet address for balances; does not resolve GoodDollar identity roots.";
+export const gooddollarToolDefinitions = [
+    {
+        name: "get_gooddollar_whitelisting_info",
+        description: "Check GoodDollar IdentityV4 whitelist status for a wallet. Connected wallets resolve to their verified root; returns isWhitelisted, whitelistedRoot, and checkedAddress.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get GoodDollar Whitelisting Info", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.gooddollar.getWhitelistingInfo(target);
+        },
+    },
+    {
+        name: "get_gooddollar_identity_link",
+        description: "How a wallet links to GoodDollar IdentityV4: whitelisted root, connected-to root, and live whitelist status.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get GoodDollar Identity Link", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.gooddollar.getIdentityLink(target);
+        },
+    },
+    {
+        name: "get_gooddollar_ubi_entitlement",
+        description: "Daily GoodDollar UBI claim eligibility: whitelist root, claimable G$, already claimed. Nested identity.isWhitelisted reflects the resolved root.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get GoodDollar UBI Entitlement", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.gooddollar.getUbiClaimEligibility(target);
+        },
+    },
+    {
+        name: "claim_daily_gooddollar_ubi",
+        description: "Claim today's GoodDollar UBI for the MCP server wallet. Requires CELO_PRIVATE_KEY.",
+        inputSchema: z.object({}),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        mcp: {
+            title: "Claim Daily GoodDollar UBI",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime) => {
+            const write = runtime.executors?.gooddollarWrite;
+            if (!write) {
+                throw new Error("GoodDollar write executor not configured.");
+            }
+            return write.claimDailyUbi();
+        },
+    },
+    {
+        name: "prepare_claim_daily_gooddollar_ubi",
+        description: "Prepare unsigned GoodDollar daily UBI claim. User must sign in wallet.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.gooddollar.prepareClaimUbi(sender);
+        },
+    },
+    {
+        name: "get_gooddollar_reserve_quote",
+        description: `GoodDollar reserve quote for G$ ↔ USDm on Celo (MentoBroker bonding curve). Use amount_side "out" when the user names the amount they want to receive (e.g. "get 0.6 USDm").${NON_IDENTITY_RESERVE_NOTE}`,
+        inputSchema: goodDollarReserveQuoteSchema,
+        families: ["read"],
+        mcp: { title: "Get GoodDollar Reserve Quote", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.gooddollar.getReserveQuote(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapReserveQuoteOptions(input)),
+    },
+    {
+        name: "estimate_gooddollar_reserve_swap",
+        description: `Estimate gas for a GoodDollar reserve swap (G$ ↔ USDm), including ERC-20 approval when needed.${NON_IDENTITY_RESERVE_NOTE}`,
+        inputSchema: goodDollarReserveWalletSchema,
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Estimate GoodDollar Reserve Swap",
+            annotations: readOnly,
+        },
+        handler: async (runtime, input) => {
+            const from = input.from;
+            const sender = resolveWalletFromRuntime(runtime, { from });
+            const tokenIn = normalizeRegistryTokenInput(input.token_in);
+            const tokenOut = normalizeRegistryTokenInput(input.token_out);
+            const amount = input.amount;
+            const options = mapReserveWalletOptions(input);
+            if (runtime.executors?.gooddollarWrite &&
+                useMcpServerExecutor(runtime, from)) {
+                return runtime.executors.gooddollarWrite.estimateReserveSwap(tokenIn, tokenOut, amount, {
+                    ...options,
+                    recipient: options.recipient ?? sender,
+                });
+            }
+            return runtime.celina.gooddollar.estimateReserveSwap(sender, tokenIn, tokenOut, amount, options);
+        },
+    },
+    {
+        name: "execute_gooddollar_reserve_swap",
+        description: "Execute a GoodDollar reserve swap (G$ ↔ USDm) on mainnet. Requires CELO_PRIVATE_KEY.",
+        inputSchema: goodDollarReserveWalletSchema,
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        mcp: {
+            title: "Execute GoodDollar Reserve Swap",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.gooddollarWrite;
+            if (!write) {
+                throw new Error("GoodDollar write executor not configured.");
+            }
+            return write.executeReserveSwap(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapReserveWalletOptions(input));
+        },
+    },
+    {
+        name: "prepare_gooddollar_reserve_swap",
+        description: `Prepare unsigned GoodDollar reserve swap for G$ ↔ USDm. User must sign in wallet. Use amount_side "out" when the user names the receive amount (same params as quote).${NON_IDENTITY_RESERVE_NOTE}`,
+        inputSchema: goodDollarReserveWalletSchema,
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.gooddollar.prepareReserveSwap(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapReserveWalletOptions(input));
+        },
+    },
+];
+//# sourceMappingURL=gooddollar.js.map

package/build/src/tools/domains/gooddollar.js.map

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

package/build/src/tools/domains/governance.d.ts

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

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

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { nonNegativeIntSchema, optionalBooleanSchema, optionalBoundedPositiveInt, paginationFields, } from "../schemas/common.js";
+export const governanceToolDefinitions = [
+    {
+        name: "get_governance_proposals",
+        description: "Returns Celo governance proposals with pagination. Set include_metadata=false for faster responses.",
+        inputSchema: z.object({
+            include_inactive: optionalBooleanSchema,
+            include_metadata: optionalBooleanSchema,
+            ...paginationFields,
+            page_size: optionalBoundedPositiveInt(20),
+        }),
+        families: ["read"],
+        mcp: {
+            title: "Get Governance Proposals",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => runtime.celina.governance.getGovernanceProposals({
+            includeInactive: input.include_inactive,
+            includeMetadata: input.include_metadata,
+            page: input.page,
+            pageSize: input.page_size,
+            offset: input.offset,
+            limit: input.limit,
+        }),
+    },
+    {
+        name: "get_proposal_details",
+        description: "Returns detailed information about a Celo governance proposal.",
+        inputSchema: z.object({
+            proposal_id: nonNegativeIntSchema,
+        }),
+        families: ["read"],
+        mcp: {
+            title: "Get Proposal Details",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => runtime.celina.governance.getProposalDetails(input.proposal_id),
+    },
+];
+//# sourceMappingURL=governance.js.map

package/build/src/tools/domains/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../../src/tools/domains/governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,qGAAqG;QACvG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,qBAAqB;YACvC,gBAAgB,EAAE,qBAAqB;YACvC,GAAG,gBAAgB;YACnB,SAAS,EAAE,0BAA0B,CAAC,EAAE,CAAC;SAC1C,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE;YACH,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;SAC1D;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAC/C,eAAe,EAAE,KAAK,CAAC,gBAAuC;YAC9D,eAAe,EAAE,KAAK,CAAC,gBAAuC;YAC9D,IAAI,EAAE,KAAK,CAAC,IAA0B;YACtC,QAAQ,EAAE,KAAK,CAAC,SAA+B;YAC/C,MAAM,EAAE,KAAK,CAAC,MAA4B;YAC1C,KAAK,EAAE,KAAK,CAAC,KAA2B;SACzC,CAAC;KACL;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gEAAgE;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,oBAAoB;SAClC,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE;YACH,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;SAC1D;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,WAAqB,CAAC;KAC5E;CACF,CAAC"}

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

@@ -0,0 +1 @@
+export declare const allDomainToolDefinitions: import("../types.js").ToolDefinition[];

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

@@ -0,0 +1,31 @@
+import { aaveToolDefinitions } from "./aave.js";
+import { blockchainToolDefinitions } from "./blockchain.js";
+import { browserToolDefinitions } from "./browser.js";
+import { contractToolDefinitions } from "./contract.js";
+import { ensToolDefinitions } from "./ens.js";
+import { gooddollarToolDefinitions } from "./gooddollar.js";
+import { governanceToolDefinitions } from "./governance.js";
+import { mentoFxToolDefinitions } from "./mento-fx.js";
+import { nftToolDefinitions } from "./nft.js";
+import { selfToolDefinitions } from "./self.js";
+import { stakingToolDefinitions } from "./staking.js";
+import { tokenToolDefinitions } from "./token.js";
+import { transactionToolDefinitions } from "./transaction.js";
+import { uniswapToolDefinitions } from "./uniswap.js";
+export const allDomainToolDefinitions = [
+    ...blockchainToolDefinitions,
+    ...tokenToolDefinitions,
+    ...transactionToolDefinitions,
+    ...mentoFxToolDefinitions,
+    ...uniswapToolDefinitions,
+    ...aaveToolDefinitions,
+    ...ensToolDefinitions,
+    ...gooddollarToolDefinitions,
+    ...governanceToolDefinitions,
+    ...stakingToolDefinitions,
+    ...nftToolDefinitions,
+    ...contractToolDefinitions,
+    ...selfToolDefinitions,
+    ...browserToolDefinitions,
+];
+//# sourceMappingURL=index.js.map

package/build/src/tools/domains/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/domains/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,yBAAyB;IAC5B,GAAG,oBAAoB;IACvB,GAAG,0BAA0B;IAC7B,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;IACzB,GAAG,mBAAmB;IACtB,GAAG,kBAAkB;IACrB,GAAG,yBAAyB;IAC5B,GAAG,yBAAyB;IAC5B,GAAG,sBAAsB;IACzB,GAAG,kBAAkB;IACrB,GAAG,uBAAuB;IAC1B,GAAG,mBAAmB;IACtB,GAAG,sBAAsB;CAC1B,CAAC"}

package/build/src/tools/domains/mento-fx.d.ts

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

package/build/src/tools/domains/mento-fx.js

@@ -0,0 +1,67 @@
+import { mentoFxQuoteSchema, mentoFxWalletSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime, useMcpServerExecutor } from "../utils/wallet.js";
+function mapMentoWalletOptions(input) {
+    return {
+        recipient: input.recipient,
+        slippageTolerance: input.slippage_tolerance,
+        deadlineMinutes: input.deadline_minutes,
+    };
+}
+export const mentoFxToolDefinitions = [
+    {
+        name: "get_mento_fx_quote",
+        description: "Mento FX oracle quote for a token pair on mainnet. Read-only.",
+        inputSchema: mentoFxQuoteSchema,
+        families: ["read"],
+        mcp: { title: "Get Mento FX Quote", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => runtime.celina.mentoFx.getFxQuote(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount),
+    },
+    {
+        name: "estimate_mento_fx",
+        description: "Estimate gas for a Mento FX conversion including approval if needed.",
+        inputSchema: mentoFxWalletSchema,
+        families: ["read"],
+        mcp: { title: "Estimate Mento FX", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const from = input.from;
+            const sender = resolveWalletFromRuntime(runtime, { from });
+            if (runtime.executors?.mentoFx && useMcpServerExecutor(runtime, from)) {
+                return runtime.executors.mentoFx.estimate(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, { ...mapMentoWalletOptions(input), recipient: input.recipient ?? sender });
+            }
+            return runtime.celina.mentoFx.estimateFx(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapMentoWalletOptions(input));
+        },
+    },
+    {
+        name: "execute_mento_fx",
+        description: "Execute a Mento FX conversion on mainnet. Requires CELO_PRIVATE_KEY.",
+        inputSchema: mentoFxWalletSchema,
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["CELO_PRIVATE_KEY"],
+        mcp: {
+            title: "Execute Mento FX",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const fx = runtime.executors?.mentoFx;
+            if (!fx)
+                throw new Error("Mento FX executor not configured.");
+            return fx.execute(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapMentoWalletOptions(input));
+        },
+    },
+    {
+        name: "prepare_mento_fx",
+        description: "Prepare Mento FX swap only. For general swaps after get_swap_quote, use prepare_swap.",
+        inputSchema: mentoFxWalletSchema,
+        families: ["prepare"],
+        surfaces: ["browser"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.mentoFx.prepareFx(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapMentoWalletOptions(input));
+        },
+    },
+];
+//# sourceMappingURL=mento-fx.js.map

package/build/src/tools/domains/mento-fx.js.map

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

package/build/src/tools/domains/nft.d.ts

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