@andrewkimjoseph/celina-sdk 0.4.12 → 0.5.0

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/andrewkimjoseph/celina-sdk/main/assets/celina-banner.png" alt="Celina — Give your LLM a wallet on Celo">
+</p>
+
 # Celina SDK
 
 Celo mainnet library for frontend apps and agents: **reads** and **unsigned transaction preparation** (no private keys).

package/build/tools/catalog.d.ts

@@ -0,0 +1,9 @@
+import type { FilterToolsOptions, ToolDefinition, ToolFamily } from "./types.js";
+export declare const ALL_TOOL_DEFINITIONS: ToolDefinition[];
+export declare function getToolNames(options?: FilterToolsOptions): string[];
+export declare function getMcpToolNames(options?: Omit<FilterToolsOptions, "surface">): string[];
+export declare function getCelesteToolNames(options?: Omit<FilterToolsOptions, "surface">): string[];
+export declare function getToolsByFamily(family: ToolFamily): ToolDefinition[];
+export declare function getToolDefinition(name: string): ToolDefinition | undefined;
+export declare function assertSnakeCaseInputKeys(definition: ToolDefinition): void;
+export declare function validateToolCatalogSnakeCase(): void;

package/build/tools/catalog.js

@@ -0,0 +1,36 @@
+import { allDomainToolDefinitions } from "./domains/index.js";
+import { filterToolDefinitions } from "./filter.js";
+export const ALL_TOOL_DEFINITIONS = allDomainToolDefinitions;
+export function getToolNames(options = {}) {
+    return filterToolDefinitions(ALL_TOOL_DEFINITIONS, options).map((d) => d.name);
+}
+export function getMcpToolNames(options = {}) {
+    return getToolNames({ ...options, surface: "mcp" });
+}
+export function getCelesteToolNames(options = {}) {
+    return getToolNames({ ...options, surface: "celeste" });
+}
+export function getToolsByFamily(family) {
+    return filterToolDefinitions(ALL_TOOL_DEFINITIONS, { families: [family] });
+}
+export function getToolDefinition(name) {
+    return ALL_TOOL_DEFINITIONS.find((d) => d.name === name);
+}
+export function assertSnakeCaseInputKeys(definition) {
+    const shape = definition.inputSchema;
+    if (!shape || typeof shape !== "object" || !("shape" in shape)) {
+        return;
+    }
+    const keys = Object.keys(shape.shape);
+    for (const key of keys) {
+        if (key !== key.toLowerCase() || key.includes("-")) {
+            throw new Error(`Tool "${definition.name}" input key "${key}" must be snake_case.`);
+        }
+    }
+}
+export function validateToolCatalogSnakeCase() {
+    for (const def of ALL_TOOL_DEFINITIONS) {
+        assertSnakeCaseInputKeys(def);
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/build/tools/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/tools/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,CAAC,MAAM,oBAAoB,GAAqB,wBAAwB,CAAC;AAE/E,MAAM,UAAU,YAAY,CAAC,UAA8B,EAAE;IAC3D,OAAO,qBAAqB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAA+C,EAAE;IAEjD,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAA+C,EAAE;IAEjD,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,qBAAqB,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,UAA0B;IACjE,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAE,KAA4C,CAAC,KAAK,CAAC,CAAC;IAC9E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,SAAS,UAAU,CAAC,IAAI,gBAAgB,GAAG,uBAAuB,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;AACH,CAAC"}

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

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

package/build/tools/domains/aave.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { AAVE_SUPPORTED_SYMBOLS, resolveAaveAsset, } from "../../config/aave.js";
+import { optionalWalletAddressSchema, tokenSymbolSchema } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const supported = AAVE_SUPPORTED_SYMBOLS.join(", ");
+const aaveTokenField = tokenSymbolSchema.describe(`Aave asset symbol on Celo (${supported}). Pass the symbol only.`);
+export const aaveToolDefinitions = [
+    {
+        name: "supply_aave",
+        description: `Supply tokens to Aave V3 on Celo. Supported: ${supported}. Requires CELO_PRIVATE_KEY.`,
+        inputSchema: z.object({
+            token: aaveTokenField,
+            amount: z.string(),
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Supply Aave",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const aave = runtime.executors?.aave;
+            if (!aave)
+                throw new Error("Aave executor not configured.");
+            const asset = resolveAaveAsset(input.token);
+            return aave.supply(asset.symbol, input.amount);
+        },
+    },
+    {
+        name: "withdraw_aave",
+        description: `Withdraw tokens from Aave V3 on Celo. Supported: ${supported}. Requires CELO_PRIVATE_KEY.`,
+        inputSchema: z.object({
+            token: aaveTokenField,
+            amount: z.string().optional(),
+            withdraw_max: z.boolean().optional(),
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Withdraw Aave",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const aave = runtime.executors?.aave;
+            if (!aave)
+                throw new Error("Aave executor not configured.");
+            const asset = resolveAaveAsset(input.token);
+            return aave.withdraw(asset.symbol, input.amount, input.withdraw_max);
+        },
+    },
+    {
+        name: "prepare_aave_supply",
+        description: "Prepare unsigned Aave V3 supply steps. User signs in wallet.",
+        inputSchema: z.object({
+            token: z.string(),
+            amount: z.string(),
+            from: optionalWalletAddressSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            const asset = resolveAaveAsset(input.token);
+            return runtime.celina.aave.prepareSupply(sender, asset.symbol, input.amount);
+        },
+    },
+    {
+        name: "prepare_aave_withdraw",
+        description: "Prepare unsigned Aave V3 withdraw. User signs in wallet.",
+        inputSchema: z.object({
+            token: z.string(),
+            amount: z.string().optional(),
+            withdraw_max: z.boolean().optional(),
+            from: optionalWalletAddressSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            const asset = resolveAaveAsset(input.token);
+            return runtime.celina.aave.prepareWithdraw(sender, asset.symbol, input.amount, input.withdraw_max);
+        },
+    },
+];
+//# sourceMappingURL=aave.js.map

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

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

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

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

package/build/tools/domains/blockchain.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { blockIdSchema, 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: z.number().int().min(1).max(100).optional(),
+            offset: z.number().int().min(0).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"],
+        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/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/tools/domains/carbon.d.ts

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

package/build/tools/domains/carbon.js

@@ -0,0 +1,187 @@
+import { z } from "zod";
+import { carbonWriteSchema, optionalWalletAddressSchema, } from "../schemas/common.js";
+import { runCarbonPrepare } from "../utils/carbon-prepare-handler.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = { readOnlyHint: true };
+const tokenPairSchema = z.object({
+    base_token: z.string(),
+    quote_token: z.string(),
+});
+const CARBON_PREPARE_SUFFIX = " Returns unsigned steps (approvals + Carbon tx) and warnings. Prices are quote per base; buy budget in quote, sell budget in base.";
+function carbonPrepare(name, title, description, prepareFn, options) {
+    return {
+        name,
+        description: description + CARBON_PREPARE_SUFFIX,
+        inputSchema: carbonWriteSchema,
+        families: ["prepare"],
+        mcp: { title, annotations: { openWorldHint: true } },
+        handler: (runtime, input) => runCarbonPrepare(runtime, name, (body) => prepareFn(runtime, body), input, options),
+    };
+}
+function carbonExecute(name, title, description, executeKey) {
+    return {
+        name,
+        description: description +
+            " Requires CELO_PRIVATE_KEY in MCP server env. Signs and broadcasts locally.",
+        inputSchema: z.object({}).passthrough(),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title,
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const write = runtime.executors?.carbonWrite;
+            if (!write)
+                throw new Error("Carbon write executor not configured.");
+            const fn = write[executeKey];
+            return fn(input);
+        },
+    };
+}
+export const carbonToolDefinitions = [
+    {
+        name: "get_carbon_strategies",
+        description: "Fetch active Carbon DeFi maker strategies for a wallet on Celo.",
+        inputSchema: z.object({
+            wallet_address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Carbon Strategies", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const wallet = resolveWalletFromRuntime(runtime, {
+                wallet_address: input.wallet_address,
+            });
+            return runtime.celina.carbon.getStrategies(wallet);
+        },
+    },
+    {
+        name: "get_carbon_strategy",
+        description: "Look up a Carbon strategy by ID on Celo.",
+        inputSchema: z.object({
+            strategy_id: z.string(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Carbon Strategy", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.getStrategy(input.strategy_id),
+    },
+    {
+        name: "get_carbon_trade_quote",
+        description: "Quote a taker swap against Carbon maker liquidity on Celo.",
+        inputSchema: z
+            .object({
+            source_token: z.string(),
+            target_token: z.string(),
+            amount: z.string(),
+            is_trade_by_target: z.boolean().optional(),
+        })
+            .passthrough(),
+        families: ["read"],
+        mcp: { title: "Get Carbon Trade Quote", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.getTradeQuote(input),
+    },
+    {
+        name: "explore_carbon_pair",
+        description: "Market liquidity and top strategies for a token pair on Carbon.",
+        inputSchema: tokenPairSchema,
+        families: ["read"],
+        mcp: { title: "Explore Carbon Pair", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.explorePair(input),
+    },
+    {
+        name: "resolve_carbon_token",
+        description: "Resolve a token symbol or name to its Celo contract address.",
+        inputSchema: z.object({ token: z.string() }),
+        families: ["read"],
+        mcp: { title: "Resolve Carbon Token", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.resolveToken(input.token),
+    },
+    {
+        name: "get_carbon_activity",
+        description: "Trade and event history for a wallet or strategy on Carbon.",
+        inputSchema: z.object({}).passthrough(),
+        families: ["read"],
+        mcp: { title: "Get Carbon Activity", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const wallet_address = resolveWalletFromRuntime(runtime, {
+                wallet_address: input.wallet_address,
+            });
+            return runtime.celina.carbon.getActivity({ ...input, wallet_address });
+        },
+    },
+    {
+        name: "find_carbon_opportunities",
+        description: "Find discount buys and premium sells vs market on a Carbon pair.",
+        inputSchema: tokenPairSchema.passthrough(),
+        families: ["read"],
+        mcp: { title: "Find Carbon Opportunities", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.findOpportunities(input),
+    },
+    {
+        name: "get_carbon_protocol_stats",
+        description: "Carbon protocol-wide TVL, volume, and fees on Celo.",
+        inputSchema: z.object({}).passthrough(),
+        families: ["read"],
+        mcp: { title: "Get Carbon Protocol Stats", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.getProtocolStats(input),
+    },
+    {
+        name: "get_carbon_price_history",
+        description: "Historical OHLC candles for a Carbon pair on Celo.",
+        inputSchema: z.object({}).passthrough(),
+        families: ["read"],
+        mcp: { title: "Get Carbon Price History", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.getPriceHistory(input),
+    },
+    {
+        name: "simulate_carbon_strategy",
+        description: "Backtest a Carbon strategy against historical prices.",
+        inputSchema: z.object({}).passthrough(),
+        families: ["read"],
+        mcp: { title: "Simulate Carbon Strategy", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.simulateStrategy(input),
+    },
+    {
+        name: "carbon_help",
+        description: "Per-tool guidance for Carbon DeFi operations on Celo.",
+        inputSchema: z.object({ topic: z.string().optional() }),
+        families: ["read"],
+        mcp: { title: "Carbon Help", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.help(input.topic),
+    },
+    {
+        name: "carbon_learn",
+        description: "Carbon DeFi protocol education topics on Celo.",
+        inputSchema: z.object({ topic: z.string().optional() }),
+        families: ["read"],
+        mcp: { title: "Carbon Learn", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.carbon.learn(input.topic),
+    },
+    carbonPrepare("prepare_carbon_limit_order", "Prepare Carbon Limit Order", "Create a one-time Carbon limit order on Celo.", (runtime, body) => runtime.celina.carbon.prepareLimitOrder(body), { marketPriceFallback: true }),
+    carbonPrepare("prepare_carbon_range_order", "Prepare Carbon Range Order", "Create a Carbon range order on Celo.", (runtime, body) => runtime.celina.carbon.prepareRangeOrder(body), { marketPriceFallback: true }),
+    carbonPrepare("prepare_carbon_recurring_strategy", "Prepare Carbon Recurring Strategy", "Create a recurring buy/sell Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareRecurringStrategy(body), { marketPriceFallback: true }),
+    carbonPrepare("prepare_carbon_concentrated_strategy", "Prepare Carbon Concentrated Strategy", "Create concentrated two-sided Carbon liquidity on Celo.", (runtime, body) => runtime.celina.carbon.prepareConcentratedStrategy(body), { concentrated: true, marketPriceFallback: true }),
+    carbonPrepare("prepare_carbon_full_range_strategy", "Prepare Carbon Full Range Strategy", "Create full-range Carbon liquidity on Celo.", (runtime, body) => runtime.celina.carbon.prepareFullRangeStrategy(body), { marketPriceFallback: true }),
+    carbonPrepare("prepare_carbon_reprice_strategy", "Prepare Carbon Reprice", "Update price ranges of an existing Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareRepriceStrategy(body)),
+    carbonPrepare("prepare_carbon_edit_strategy", "Prepare Carbon Edit Strategy", "Edit prices and budgets of a Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareEditStrategy(body)),
+    carbonPrepare("prepare_carbon_deposit_budget", "Prepare Carbon Deposit", "Add funds to a Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareDepositBudget(body)),
+    carbonPrepare("prepare_carbon_withdraw_budget", "Prepare Carbon Withdraw", "Withdraw funds from a Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareWithdrawBudget(body)),
+    carbonPrepare("prepare_carbon_pause_strategy", "Prepare Carbon Pause", "Pause a Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.preparePauseStrategy(body)),
+    carbonPrepare("prepare_carbon_resume_strategy", "Prepare Carbon Resume", "Resume a paused Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareResumeStrategy(body)),
+    carbonPrepare("prepare_carbon_delete_strategy", "Prepare Carbon Delete", "Permanently close a Carbon strategy on Celo.", (runtime, body) => runtime.celina.carbon.prepareDeleteStrategy(body)),
+    carbonPrepare("prepare_carbon_trade", "Prepare Carbon Trade", "Build an unsigned taker swap against Carbon liquidity on Celo.", (runtime, body) => runtime.celina.carbon.prepareTrade(body)),
+    carbonExecute("execute_carbon_limit_order", "Execute Carbon Limit Order", "Create and broadcast a Carbon limit order on Celo.", "executeLimitOrder"),
+    carbonExecute("execute_carbon_range_order", "Execute Carbon Range Order", "Create and broadcast a Carbon range order on Celo.", "executeRangeOrder"),
+    carbonExecute("execute_carbon_recurring_strategy", "Execute Carbon Recurring Strategy", "Create and broadcast a recurring Carbon strategy on Celo.", "executeRecurringStrategy"),
+    carbonExecute("execute_carbon_concentrated_strategy", "Execute Carbon Concentrated Strategy", "Create and broadcast concentrated Carbon liquidity on Celo.", "executeConcentratedStrategy"),
+    carbonExecute("execute_carbon_full_range_strategy", "Execute Carbon Full Range Strategy", "Create and broadcast full-range Carbon liquidity on Celo.", "executeFullRangeStrategy"),
+    carbonExecute("execute_carbon_reprice_strategy", "Execute Carbon Reprice", "Update price ranges of a Carbon strategy on Celo.", "executeRepriceStrategy"),
+    carbonExecute("execute_carbon_edit_strategy", "Execute Carbon Edit Strategy", "Edit a Carbon strategy on Celo.", "executeEditStrategy"),
+    carbonExecute("execute_carbon_deposit_budget", "Execute Carbon Deposit", "Add funds to a Carbon strategy on Celo.", "executeDepositBudget"),
+    carbonExecute("execute_carbon_withdraw_budget", "Execute Carbon Withdraw", "Withdraw funds from a Carbon strategy on Celo.", "executeWithdrawBudget"),
+    carbonExecute("execute_carbon_pause_strategy", "Execute Carbon Pause", "Pause a Carbon strategy on Celo.", "executePauseStrategy"),
+    carbonExecute("execute_carbon_resume_strategy", "Execute Carbon Resume", "Resume a paused Carbon strategy on Celo.", "executeResumeStrategy"),
+    carbonExecute("execute_carbon_delete_strategy", "Execute Carbon Delete", "Permanently close a Carbon strategy on Celo.", "executeDeleteStrategy"),
+    carbonExecute("execute_carbon_trade", "Execute Carbon Trade", "Execute a taker swap against Carbon liquidity on Celo.", "executeTrade"),
+];
+//# sourceMappingURL=carbon.js.map

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

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

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

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

package/build/tools/domains/celeste.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { getSwapQuoteWithFallback, prepareSwapWithFallback, } from "../swap-routing.js";
+import { uniswapWalletSchema } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+export const celesteToolDefinitions = [
+    {
+        name: "get_swap_quote",
+        description: "Best swap quote on Celo — tries Mento FX and Uniswap v4 in parallel.",
+        inputSchema: z.object({
+            token_in: z.string(),
+            token_out: z.string(),
+            amount: z.string(),
+        }),
+        families: ["read"],
+        surfaces: ["celeste"],
+        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 or Uniswap v4).",
+        inputSchema: uniswapWalletSchema.extend({
+            protocol: z.enum(["mento_fx", "uniswap_v4"]).optional(),
+        }),
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            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,
+            }, input.protocol);
+        },
+    },
+];
+//# sourceMappingURL=celeste.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"celeste.js","sourceRoot":"","sources":["../../../src/tools/domains/celeste.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,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,sEAAsE;QACxE,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,sEAAsE;QACxE,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;SACxD,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,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;aAC9D,EACD,KAAK,CAAC,QAAoC,CAC3C,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

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

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

package/build/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/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/tools/domains/ens.d.ts

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

package/build/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/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/tools/domains/gooddollar.d.ts

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