@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2

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

@@ -0,0 +1,92 @@
+/**
+ * AgentKarma reputation tools (read-only, optional ecosystem adapter).
+ *
+ * These expose AgentKarma (https://agentkarma.io) reputation context for Celo
+ * agents through the Celina tool catalog. They are pure reads: no signing, no
+ * transaction execution, no custody, no routing. `openWorldHint` is set because
+ * they call an external service (agentkarma.io), unlike Celina's on-chain reads.
+ */
+import { z } from "zod";
+import { optionalBooleanSchema, optionalEnumSchema, positiveIntSchema, requiredWalletAddressSchema, } from "../schemas/common.js";
+/** Read-only external service: idempotent, open-world (agentkarma.io). */
+const readOnlyOpenWorld = {
+    readOnlyHint: true,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+/**
+ * The counterparty is ALWAYS an explicit subject (required `address`). Unlike
+ * Celina's on-chain reads, these tools call an external host (agentkarma.io), so
+ * they must NOT silently fall back to the operator's signer wallet — that would
+ * disclose the operator's identity to a third party. No `resolveWallet`, no
+ * signer default: the subject must be named.
+ */
+const subjectAddressSchema = requiredWalletAddressSchema.describe("Celo 0x address of the agent/counterparty to look up.");
+/** Optional 0–100 score threshold; tolerates numeric strings and blanks. */
+const optionalScoreSchema = z.preprocess((value) => {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "")
+            return undefined;
+        const parsed = Number(trimmed);
+        return Number.isNaN(parsed) ? value : parsed;
+    }
+    return value;
+}, z.number().int().min(0).max(100).optional());
+export const agentKarmaToolDefinitions = [
+    {
+        name: "get_agentkarma_reputation",
+        description: "Read AgentKarma Provider + Consumer reputation for a Celo agent wallet (read-only, agentkarma.io). Optional trust context — never routes, signs, or holds custody.",
+        inputSchema: z.object({
+            address: subjectAddressSchema,
+            face: optionalEnumSchema(["provider", "consumer", "both"]).describe("Karma face to read: provider, consumer, or both (default)."),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Get AgentKarma Reputation",
+            annotations: readOnlyOpenWorld,
+        },
+        handler: async (runtime, input) => runtime.celina.agentKarma.getKarma(input.address, {
+            face: input.face ?? "both",
+        }),
+    },
+    {
+        name: "get_agentkarma_celo_agent",
+        description: "Resolve a Celo ERC-8004 agent (identity + reputation) by numeric agent ID via AgentKarma (read-only).",
+        inputSchema: z.object({
+            agent_id: positiveIntSchema.describe("ERC-8004 agent ID on Celo."),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Get AgentKarma Celo Agent",
+            annotations: readOnlyOpenWorld,
+        },
+        handler: async (runtime, input) => runtime.celina.agentKarma.getCeloAgent(input.agent_id),
+    },
+    {
+        name: "check_agentkarma_counterparty",
+        description: "Evaluate a Celo counterparty against a local AgentKarma trust policy (min score, receipt-backed). Returns an explainable allow/deny decision plus the snapshot it read. Read-only — never routes, signs, or holds custody.",
+        inputSchema: z.object({
+            address: subjectAddressSchema,
+            face: optionalEnumSchema(["provider", "consumer"]).describe("Face to score the decision on (default provider)."),
+            min_score: optionalScoreSchema.describe("Reject when the face score is below this (0–100)."),
+            require_receipt_backed: optionalBooleanSchema.describe("Require at least one Tier-1 receipt-backed signal on the face."),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Check AgentKarma Counterparty",
+            annotations: readOnlyOpenWorld,
+        },
+        handler: async (runtime, input) => runtime.celina.agentKarma.evaluateCounterparty(input.address, {
+            face: input.face,
+            minScore: input.min_score,
+            requireReceiptBacked: input.require_receipt_backed,
+        }),
+    },
+];
+//# sourceMappingURL=agentkarma.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agentkarma.js","sourceRoot":"","sources":["../../../../src/tools/domains/agentkarma.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC;AAG9B,0EAA0E;AAC1E,MAAM,iBAAiB,GAAG;IACxB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACX,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,2BAA2B,CAAC,QAAQ,CAC/D,uDAAuD,CACxD,CAAC;AAEF,4EAA4E;AAC5E,MAAM,mBAAmB,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,KAAc,EAAE,EAAE;IAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,SAAS,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,oKAAoK;QACtK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,oBAAoB;YAC7B,IAAI,EAAE,kBAAkB,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CACjE,4DAA4D,CAC7D;SACF,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,GAAG,EAAE;YACH,KAAK,EAAE,2BAA2B;YAClC,WAAW,EAAE,iBAAiB;SAC/B;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAiB,EAAE;YAC1D,IAAI,EACD,KAAK,CAAC,IAAqD,IAAI,MAAM;SACzE,CAAC;KACL;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,uGAAuG;QACzG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SACnE,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,GAAG,EAAE;YACH,KAAK,EAAE,2BAA2B;YAClC,WAAW,EAAE,iBAAiB;SAC/B;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,QAAkB,CAAC;KACnE;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,WAAW,EACT,4NAA4N;QAC9N,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,oBAAoB;YAC7B,IAAI,EAAE,kBAAkB,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CACzD,mDAAmD,CACpD;YACD,SAAS,EAAE,mBAAmB,CAAC,QAAQ,CACrC,mDAAmD,CACpD;YACD,sBAAsB,EAAE,qBAAqB,CAAC,QAAQ,CACpD,gEAAgE,CACjE;SACF,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,GAAG,EAAE;YACH,KAAK,EAAE,+BAA+B;YACtC,WAAW,EAAE,iBAAiB;SAC/B;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,KAAK,CAAC,OAAiB,EAAE;YACtE,IAAI,EAAE,KAAK,CAAC,IAA2C;YACvD,QAAQ,EAAE,KAAK,CAAC,SAA+B;YAC/C,oBAAoB,EAAE,KAAK,CAAC,sBAEf;SACd,CAAC;KACL;CACF,CAAC"}

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

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

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

@@ -0,0 +1,122 @@
+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: "verify_attribution_tag",
+        description: "Decode legacy Celina (CELINA|…) and ERC-8021 (celina, app codes) attribution tags from a transaction's calldata on Celo mainnet. Optionally pass tag to check for a specific code on either layer.",
+        inputSchema: z.object({
+            hash: z
+                .string()
+                .regex(/^0x[a-fA-F0-9]{64}$/)
+                .describe("Transaction hash (0x + 64 hex characters)."),
+            tag: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional attribution code to match (e.g. celo_862c21dd97a7, MY_APP). Omit to decode all tags."),
+        }),
+        families: ["read"],
+        mcp: { title: "Verify Attribution Tag", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.blockchain.verifyAttributionInTransaction(input.hash, input.tag),
+    },
+    {
+        name: "check_attribution_tag",
+        description: "List custom attribution tags on a Celo mainnet transaction (unified tags array, excluding platform CELINA/celina), or check whether a specific tag is present. Prefer this for “what tags are on this tx?”; use verify_attribution_tag for raw legacy/ERC-8021 layers only.",
+        inputSchema: z.object({
+            hash: z
+                .string()
+                .regex(/^0x[a-fA-F0-9]{64}$/)
+                .describe("Transaction hash (0x + 64 hex characters)."),
+            tag: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional attribution code to match (e.g. celo_862c21dd97a7, MY_APP). Omit to list all custom tags."),
+        }),
+        families: ["read"],
+        mcp: { title: "Check Attribution Tag", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.blockchain.checkAttributionInTransaction(input.hash, input.tag),
+    },
+    {
+        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[];