@andrewkimjoseph/celina-sdk 0.9.7 → 0.9.9

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

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { addressSchema, optionalWalletAddressSchema, tokenIdSchema, } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const nftToolDefinitions = [
+    {
+        name: "get_nft_info",
+        description: "NFT token information including metadata for ERC-721 or ERC-1155.",
+        inputSchema: z.object({
+            contract_address: addressSchema,
+            token_id: tokenIdSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get NFT Info", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.nft.getNftInfo(input.contract_address, input.token_id),
+    },
+    {
+        name: "get_nft_balance",
+        description: "NFT balance for an address. Token ID required for ERC-1155.",
+        inputSchema: z.object({
+            contract_address: addressSchema,
+            address: optionalWalletAddressSchema,
+            token_id: tokenIdSchema.optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get NFT Balance", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.nft.getNftBalance(input.contract_address, target, input.token_id);
+        },
+    },
+];
+//# sourceMappingURL=nft.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nft.js","sourceRoot":"","sources":["../../../../src/tools/domains/nft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,QAAQ,GAAG;IACf,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,mEAAmE;QACrE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,aAAa;YAC/B,QAAQ,EAAE,aAAa;SACxB,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE;QACrD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAC3B,KAAK,CAAC,gBAAiC,EACvC,KAAK,CAAC,QAAkB,CACzB;KACJ;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,6DAA6D;QAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,aAAa;YAC/B,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;SACnC,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE;QACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE;gBAC/C,OAAO,EAAE,KAAK,CAAC,OAA6B;aAC7C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CACrC,KAAK,CAAC,gBAAiC,EACvC,MAAM,EACN,KAAK,CAAC,QAA8B,CACrC,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

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

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

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

@@ -0,0 +1,187 @@
+import { selfDemoUrl } from "../../config/self.js";
+import { z } from "zod";
+import { addressSchema, httpRequestPathSchema, optionalAgeLiteralSchema, optionalBooleanSchema, optionalEnumSchema, optionalHexKeySchema, optionalPositiveIntSchema, optionalStringSchema, positiveIntSchema, } from "../schemas/common.js";
+const SELF_DEMO_VERIFY_URL = selfDemoUrl("/api/demo/verify");
+const selfRegistrationModeSchema = optionalEnumSchema([
+    "linked",
+    "wallet-free",
+    "smartwallet",
+    "self-custody",
+    "ed25519",
+    "ed25519-linked",
+]);
+function requireSelf(runtime) {
+    const self = runtime.executors?.self;
+    if (!self) {
+        throw new Error("Self executor not configured.");
+    }
+    return self;
+}
+export const selfToolDefinitions = [
+    {
+        name: "verify_self_agent",
+        description: "Verify whether an agent address is backed by a real human on Self Agent ID (Celo mainnet).",
+        inputSchema: z.object({
+            agent_address: addressSchema,
+            require_age: optionalAgeLiteralSchema,
+            require_ofac: optionalBooleanSchema,
+            require_self_provider: optionalBooleanSchema,
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Verify Self Agent",
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).verifyAgent(input),
+    },
+    {
+        name: "lookup_self_agent",
+        description: "Look up a Self Agent ID by numeric on-chain ID.",
+        inputSchema: z.object({
+            agent_id: positiveIntSchema,
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Look Up Self Agent",
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).lookupAgent(input.agent_id),
+    },
+    {
+        name: "verify_self_request",
+        description: "Verify incoming HTTP request headers signed by a Self Agent (not file system access).",
+        inputSchema: z.object({
+            agent_signature: z.string().regex(/^0x[a-fA-F0-9]+$/),
+            agent_timestamp: z.string(),
+            method: z.string(),
+            request_path: httpRequestPathSchema,
+            body: optionalStringSchema,
+            keytype: optionalStringSchema,
+            agent_key: optionalHexKeySchema,
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Verify Self Agent Request",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).verifyRequest(input),
+    },
+    {
+        name: "register_self_agent",
+        description: "Start Self Agent ID registration. Returns qr_code_url and deep_link — present BOTH to the user.",
+        inputSchema: z.object({
+            mode: selfRegistrationModeSchema,
+            minimum_age: optionalAgeLiteralSchema,
+            ofac: optionalBooleanSchema,
+            human_address: addressSchema.optional(),
+            agent_name: optionalStringSchema,
+            agent_description: optionalStringSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_SESSION"],
+        mcp: {
+            title: "Register Self Agent",
+            annotations: { destructiveHint: true, openWorldHint: true },
+            responseKind: "self_session",
+        },
+        handler: async (runtime, input) => requireSelf(runtime).registerAgent(input),
+    },
+    {
+        name: "check_self_registration",
+        description: "Poll a pending Self registration, proof refresh, or deregistration session.",
+        inputSchema: z.object({
+            session_id: z.string(),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_SESSION"],
+        mcp: {
+            title: "Check Self Registration",
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).checkRegistration(input.session_id),
+    },
+    {
+        name: "get_self_identity",
+        description: "Return the configured Self agent identity. Requires SELF_AGENT_PRIVATE_KEY.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_AGENT_PRIVATE_KEY"],
+        mcp: {
+            title: "Get Self Agent Identity",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime) => requireSelf(runtime).getIdentity(),
+    },
+    {
+        name: "refresh_self_proof",
+        description: "Start a human proof refresh after on-chain proof expiry. Returns qr_code_url and deep_link.",
+        inputSchema: z.object({
+            agent_id: optionalPositiveIntSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_AGENT_PRIVATE_KEY"],
+        mcp: {
+            title: "Refresh Self Proof",
+            annotations: { openWorldHint: true },
+            responseKind: "self_session",
+        },
+        handler: async (runtime, input) => requireSelf(runtime).refreshProof(input),
+    },
+    {
+        name: "deregister_self_agent",
+        description: "Start irreversible Self agent deregistration. Returns qr_code_url and deep_link.",
+        inputSchema: z.object({}),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_AGENT_PRIVATE_KEY"],
+        mcp: {
+            title: "Deregister Self Agent",
+            annotations: { destructiveHint: true, openWorldHint: true },
+            responseKind: "self_session",
+        },
+        handler: async (runtime) => requireSelf(runtime).deregisterAgent(),
+    },
+    {
+        name: "sign_self_request",
+        description: `Sign an HTTP request with the configured Self agent. Demo verify: POST ${SELF_DEMO_VERIFY_URL}`,
+        inputSchema: z.object({
+            method: z.enum(["GET", "POST", "PUT", "DELETE"]),
+            url: z.string().url(),
+            body: optionalStringSchema,
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_AGENT_PRIVATE_KEY"],
+        mcp: {
+            title: "Sign Self Agent Request",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).signRequest(input),
+    },
+    {
+        name: "authenticated_self_fetch",
+        description: `HTTP request with Self Agent ID auth headers. Demo: ?network=celo-mainnet — ${SELF_DEMO_VERIFY_URL}`,
+        inputSchema: z.object({
+            method: z.enum(["GET", "POST", "PUT", "DELETE"]),
+            url: z.string().url(),
+            body: optionalStringSchema,
+            content_type: optionalStringSchema,
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        requiresEnv: ["SELF_AGENT_PRIVATE_KEY"],
+        mcp: {
+            title: "Authenticated Self Fetch",
+            annotations: { openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).authenticatedFetch(input),
+    },
+];
+//# sourceMappingURL=self.js.map

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

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

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

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

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

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { addressSchema, optionalBoundedPositiveInt, optionalWalletAddressSchema, paginationFields, } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const stakingToolDefinitions = [
+    {
+        name: "get_staking_balances",
+        description: "Active and pending staking votes for an address by validator group.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Staking Balances", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.staking.getStakingBalances(target);
+        },
+    },
+    {
+        name: "get_activatable_stakes",
+        description: "Validator groups where pending stakes can be activated for an address.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Activatable Stakes", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.staking.getActivatableStakes(target);
+        },
+    },
+    {
+        name: "get_validator_groups",
+        description: "Paginated validator groups with votes, capacity, and member counts.",
+        inputSchema: z.object({
+            ...paginationFields,
+            page_size: optionalBoundedPositiveInt(50),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Validator Groups", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.staking.getValidatorGroups({
+            page: input.page,
+            pageSize: input.page_size,
+            offset: input.offset,
+            limit: input.limit,
+        }),
+    },
+    {
+        name: "get_validator_group_details",
+        description: "Detailed information about a validator group including members.",
+        inputSchema: z.object({
+            group_address: addressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Validator Group Details", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.staking.getValidatorGroupDetails(input.group_address),
+    },
+    {
+        name: "get_total_staking_info",
+        description: "Network-wide staking participation metrics.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        mcp: { title: "Get Total Staking Info", annotations: readOnly },
+        handler: async (runtime) => runtime.celina.staking.getTotalStakingInfo(),
+    },
+];
+//# sourceMappingURL=staking.js.map

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

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

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

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

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

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { optionalWalletAddressSchema, tokenSymbolSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+const NON_IDENTITY_BALANCE_NOTE = " Reads on-chain balances for the given address only; GoodDollar connected-wallet identity is not resolved.";
+export const tokenToolDefinitions = [
+    {
+        name: "get_celo_balances",
+        description: `Balances for named registry tokens on Celo mainnet. Default tokens: CELO + USDm.${NON_IDENTITY_BALANCE_NOTE}`,
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+            tokens: z.array(tokenSymbolSchema).optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Celo Balances", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.token.getBalances(target, input.tokens);
+        },
+    },
+    {
+        name: "get_stablecoin_balances",
+        description: `Scan fiat-pegged registry stablecoins (Mento *m, USDT, USDC, etc.) for an address in one call. Omits zero balances by default. Excludes GoodDollar (G$) and WETH — use get_token_balance or GoodDollar tools for those.${NON_IDENTITY_BALANCE_NOTE}`,
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+            stablecoins: z.array(z.string()).optional(),
+            include_zero: z.boolean().optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Stablecoin Balances", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.token.getStablecoinBalances(target, {
+                stablecoins: input.stablecoins,
+                includeZero: input.include_zero,
+            });
+        },
+    },
+    {
+        name: "get_token_info",
+        description: "Registry token metadata (symbol, address, decimals). Does not read balances.",
+        inputSchema: z.object({
+            token: tokenSymbolSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Token Info", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.token.getTokenInfo(normalizeRegistryTokenInput(input.token)),
+    },
+    {
+        name: "get_token_balance",
+        description: `Balance for one registry token. Pass a symbol or known registry contract address.${NON_IDENTITY_BALANCE_NOTE}`,
+        inputSchema: z.object({
+            token: tokenSymbolSchema,
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Token Balance", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.token.getTokenBalance(normalizeRegistryTokenInput(input.token), target);
+        },
+    },
+];
+//# sourceMappingURL=token.js.map

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

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

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

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

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[];