@andrewkimjoseph/celina-sdk 0.4.11 → 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/analytics/mcp-tool-events.js

@@ -6,6 +6,7 @@ export const MCP_TOOL_EVENT_BY_SDK_METHOD = {
     "account.getAccount": "get_account",
     "account.getWalletAddress": "get_wallet_address",
     "blockchain.getBlock": "get_block",
+    "blockchain.getBlockWithTransactions": "get_block",
     "blockchain.getLatestBlocks": "get_latest_blocks",
     "blockchain.getNetworkStatus": "get_network_status",
     "blockchain.getTransaction": "get_transaction",

package/build/analytics/mcp-tool-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tool-events.js","sourceRoot":"","sources":["../../src/analytics/mcp-tool-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,oBAAoB,EAAE,aAAa;IACnC,0BAA0B,EAAE,oBAAoB;IAChD,qBAAqB,EAAE,WAAW;IAClC,4BAA4B,EAAE,mBAAmB;IACjD,6BAA6B,EAAE,oBAAoB;IACnD,2BAA2B,EAAE,iBAAiB;IAC9C,oBAAoB,EAAE,qBAAqB;IAC3C,0BAA0B,EAAE,2BAA2B;IACvD,oBAAoB,EAAE,qBAAqB;IAC3C,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,sBAAsB,EAAE,uBAAuB;IAC/C,oBAAoB,EAAE,qBAAqB;IAC3C,sBAAsB,EAAE,wBAAwB;IAChD,aAAa,EAAE,aAAa;IAC5B,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,sBAAsB;IAC7C,yBAAyB,EAAE,0BAA0B;IACrD,uBAAuB,EAAE,wBAAwB;IACjD,sBAAsB,EAAE,uBAAuB;IAC/C,gBAAgB,EAAE,aAAa;IAC/B,mCAAmC,EAAE,gCAAgC;IACrE,gCAAgC,EAAE,kCAAkC;IACpE,mCAAmC,EAAE,0BAA0B;IAC/D,+BAA+B,EAAE,sBAAsB;IACvD,oBAAoB,EAAE,mBAAmB;IACzC,oBAAoB,EAAE,oBAAoB;IAC1C,mBAAmB,EAAE,iBAAiB;IACtC,gBAAgB,EAAE,cAAc;IAChC,6BAA6B,EAAE,0BAA0B;IACzD,4BAA4B,EAAE,yBAAyB;IACvD,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,wBAAwB,EAAE,qBAAqB;IAC/C,8BAA8B,EAAE,wBAAwB;IACxD,4BAA4B,EAAE,sBAAsB;IACpD,6BAA6B,EAAE,wBAAwB;IACvD,kCAAkC,EAAE,6BAA6B;IACjE,4BAA4B,EAAE,sBAAsB;IACpD,mBAAmB,EAAE,mBAAmB;IACxC,6BAA6B,EAAE,yBAAyB;IACxD,uBAAuB,EAAE,mBAAmB;IAC5C,oBAAoB,EAAE,gBAAgB;IACtC,0BAA0B,EAAE,eAAe;IAC3C,iCAAiC,EAAE,sBAAsB;IACzD,2BAA2B,EAAE,kBAAkB;IAC/C,sBAAsB,EAAE,uBAAuB;IAC/C,sBAAsB,EAAE,mBAAmB;CACnC,CAAC"}
+{"version":3,"file":"mcp-tool-events.js","sourceRoot":"","sources":["../../src/analytics/mcp-tool-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,oBAAoB,EAAE,aAAa;IACnC,0BAA0B,EAAE,oBAAoB;IAChD,qBAAqB,EAAE,WAAW;IAClC,qCAAqC,EAAE,WAAW;IAClD,4BAA4B,EAAE,mBAAmB;IACjD,6BAA6B,EAAE,oBAAoB;IACnD,2BAA2B,EAAE,iBAAiB;IAC9C,oBAAoB,EAAE,qBAAqB;IAC3C,0BAA0B,EAAE,2BAA2B;IACvD,oBAAoB,EAAE,qBAAqB;IAC3C,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,sBAAsB,EAAE,uBAAuB;IAC/C,oBAAoB,EAAE,qBAAqB;IAC3C,sBAAsB,EAAE,wBAAwB;IAChD,aAAa,EAAE,aAAa;IAC5B,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,sBAAsB;IAC7C,yBAAyB,EAAE,0BAA0B;IACrD,uBAAuB,EAAE,wBAAwB;IACjD,sBAAsB,EAAE,uBAAuB;IAC/C,gBAAgB,EAAE,aAAa;IAC/B,mCAAmC,EAAE,gCAAgC;IACrE,gCAAgC,EAAE,kCAAkC;IACpE,mCAAmC,EAAE,0BAA0B;IAC/D,+BAA+B,EAAE,sBAAsB;IACvD,oBAAoB,EAAE,mBAAmB;IACzC,oBAAoB,EAAE,oBAAoB;IAC1C,mBAAmB,EAAE,iBAAiB;IACtC,gBAAgB,EAAE,cAAc;IAChC,6BAA6B,EAAE,0BAA0B;IACzD,4BAA4B,EAAE,yBAAyB;IACvD,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,wBAAwB,EAAE,qBAAqB;IAC/C,8BAA8B,EAAE,wBAAwB;IACxD,4BAA4B,EAAE,sBAAsB;IACpD,6BAA6B,EAAE,wBAAwB;IACvD,kCAAkC,EAAE,6BAA6B;IACjE,4BAA4B,EAAE,sBAAsB;IACpD,mBAAmB,EAAE,mBAAmB;IACxC,6BAA6B,EAAE,yBAAyB;IACxD,uBAAuB,EAAE,mBAAmB;IAC5C,oBAAoB,EAAE,gBAAgB;IACtC,0BAA0B,EAAE,eAAe;IAC3C,iCAAiC,EAAE,sBAAsB;IACzD,2BAA2B,EAAE,kBAAkB;IAC/C,sBAAsB,EAAE,uBAAuB;IAC/C,sBAAsB,EAAE,mBAAmB;CACnC,CAAC"}

package/build/services/blockchain.service.d.ts

@@ -35,7 +35,21 @@ export declare class BlockchainService {
         gasUtilization: number;
         miner: `0x${string}`;
         transactionCount: number;
-        transactions: `0x${string}`[] | undefined;
+        transactions: (`0x${string}` | {
+            hash: `0x${string}`;
+            from: `0x${string}`;
+            to: `0x${string}` | null;
+            value: string;
+            valueCelo: number;
+            nonce: number;
+            gas: string;
+            gasPrice: string | undefined;
+            gasPriceGwei: number | undefined;
+            input: `0x${string}`;
+            blockNumber: string | undefined;
+            transactionIndex: number | null | undefined;
+            type: string | undefined;
+        })[] | undefined;
     }>;
     /**
      * List recent blocks ending at the chain tip (newest last in the array).
@@ -66,12 +80,28 @@ export declare class BlockchainService {
         valueCelo: number;
         nonce: number;
         gas: string;
+        gasPrice: string | undefined;
+        gasPriceGwei: number | undefined;
+        input: `0x${string}`;
+        blockNumber: string | undefined;
+        transactionIndex: number | null | undefined;
+        type: string | undefined;
+    } | {
+        status?: string | undefined;
         gasUsed: string;
         gasEfficiency: number;
+        hash: `0x${string}`;
+        from: `0x${string}`;
+        to: `0x${string}` | null;
+        value: string;
+        valueCelo: number;
+        nonce: number;
+        gas: string;
         gasPrice: string | undefined;
         gasPriceGwei: number | undefined;
         input: `0x${string}`;
-        blockNumber: string;
-        status: "success" | "reverted";
+        blockNumber: string | undefined;
+        transactionIndex: number | null | undefined;
+        type: string | undefined;
     }>;
 }

package/build/services/blockchain.service.js

@@ -1,3 +1,32 @@
+function serializeTransactionSummary(tx, extras) {
+    const base = {
+        hash: tx.hash,
+        from: tx.from,
+        to: tx.to,
+        value: tx.value.toString(),
+        valueCelo: Number(tx.value) / 1e18,
+        nonce: tx.nonce,
+        gas: tx.gas.toString(),
+        gasPrice: tx.gasPrice?.toString(),
+        gasPriceGwei: tx.gasPrice ? Number(tx.gasPrice) / 1e9 : undefined,
+        input: tx.input,
+        blockNumber: tx.blockNumber?.toString(),
+        transactionIndex: tx.transactionIndex,
+        type: tx.type,
+    };
+    if (!extras) {
+        return base;
+    }
+    const gasEfficiency = tx.gas > 0n
+        ? Number((extras.gasUsed * 10000n) / tx.gas) / 100
+        : 0;
+    return {
+        ...base,
+        gasUsed: extras.gasUsed.toString(),
+        gasEfficiency,
+        ...(extras.status !== undefined ? { status: extras.status } : {}),
+    };
+}
 /** Celo mainnet block and transaction queries. */
 export class BlockchainService {
     clientFactory;
@@ -35,16 +64,16 @@ export class BlockchainService {
         const blockParams = typeof blockId === "number"
             ? {
                 blockNumber: BigInt(blockId),
-                includeTransactions: includeTransactions,
+                includeTransactions,
             }
             : blockId === "latest" || blockId === "pending"
                 ? {
                     blockTag: blockId,
-                    includeTransactions: includeTransactions,
+                    includeTransactions,
                 }
                 : {
                     blockHash: blockId,
-                    includeTransactions: includeTransactions,
+                    includeTransactions,
                 };
         const block = await client.getBlock(blockParams);
         if (!block) {
@@ -63,7 +92,11 @@ export class BlockchainService {
             gasUtilization,
             miner: block.miner,
             transactionCount: block.transactions.length,
-            transactions: includeTransactions ? block.transactions : undefined,
+            transactions: includeTransactions
+                ? block.transactions.map((tx) => typeof tx === "string"
+                    ? tx
+                    : serializeTransactionSummary(tx))
+                : undefined,
         };
     }
     /**
@@ -109,24 +142,10 @@ export class BlockchainService {
         if (!tx) {
             throw new Error(`Transaction not found: ${hash}`);
         }
-        const gasUsed = receipt?.gasUsed ?? 0n;
-        const gasEfficiency = tx.gas > 0n ? Number((gasUsed * 10000n) / tx.gas) / 100 : 0;
-        return {
-            hash: tx.hash,
-            from: tx.from,
-            to: tx.to,
-            value: tx.value.toString(),
-            valueCelo: Number(tx.value) / 1e18,
-            nonce: tx.nonce,
-            gas: tx.gas.toString(),
-            gasUsed: gasUsed.toString(),
-            gasEfficiency,
-            gasPrice: tx.gasPrice?.toString(),
-            gasPriceGwei: tx.gasPrice ? Number(tx.gasPrice) / 1e9 : undefined,
-            input: tx.input,
-            blockNumber: tx.blockNumber?.toString(),
+        return serializeTransactionSummary(tx, {
+            gasUsed: receipt?.gasUsed ?? 0n,
             status: receipt?.status,
-        };
+        });
     }
 }
 //# sourceMappingURL=blockchain.service.js.map

package/build/services/blockchain.service.js.map

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

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAC/C,8BAA8B,SAAS,0BAA0B,CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,gDAAgD,SAAS,8BAA8B;QACpG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,CAAC;QACF,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,GAAG,EAAE;YACH,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;SAC5D;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;YACrC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAe,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAgB,CAAC,CAAC;QAC3D,CAAC;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,oDAAoD,SAAS,8BAA8B;QACxG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,cAAc;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACrC,CAAC;QACF,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,KAAK,CAAC;QACjB,GAAG,EAAE;YACH,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;SAC5D;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;YACrC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC5D,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAe,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,QAAQ,CAClB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAA4B,EAClC,KAAK,CAAC,YAAmC,CAC1C,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,8DAA8D;QAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,IAAI,EAAE,2BAA2B;SAClC,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,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAe,CAAC,CAAC;YACtD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CACtC,MAAM,EACN,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAAgB,CACvB,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACpC,IAAI,EAAE,2BAA2B;SAClC,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,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAe,CAAC,CAAC;YACtD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CACxC,MAAM,EACN,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,MAA4B,EAClC,KAAK,CAAC,YAAmC,CAC1C,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

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