@andrewkimjoseph/celina 0.3.1 → 0.3.3

package/README.md

@@ -1,5 +1,6 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/andrewkimjoseph/celina/main/assets/logo.png" alt="Celina logo — yellow C with profile silhouette on black" width="160" />
+  <img src="https://raw.githubusercontent.com/andrewkimjoseph/celina/main/assets/logo-yellow.png#gh-dark-mode-only" alt="Celina logo — yellow C with profile silhouette on black" width="160" />
+  <img src="https://raw.githubusercontent.com/andrewkimjoseph/celina/main/assets/logo-black.png#gh-light-mode-only" alt="Celina logo — black C with profile silhouette" width="160" />
 </p>
 
 <h1 align="center">Celina — Celo MCP Server</h1>
@@ -24,9 +25,9 @@ npm: [@andrewkimjoseph/celina](https://www.npmjs.com/package/@andrewkimjoseph/ce
 
 ## Quick start
 
-Celina is not meant to be run manually in a terminal for normal use. Your MCP client (Cursor, Claude Desktop, LM Studio, etc.) spawns it as a child process and talks to it over stdio. Install the package, then add it to your MCP config (see [Cursor / Claude Desktop config](#cursor--claude-desktop-config)).
+Celina is not meant to be run manually in a terminal for normal use. Your MCP client (Cursor, Claude Desktop, LM Studio, etc.) spawns it as a child process and talks to it over stdio.
 
-**From npm:**
+**Recommended:** install from npm, then add Celina to your MCP config (see [MCP setup](#mcp-setup)).
 
 ```bash
 npm i @andrewkimjoseph/celina
@@ -40,30 +41,39 @@ npm run build
 npm start
 ```
 
-## Deploy to Render
+## MCP setup
 
-This project includes a [Render Blueprint](render.yaml) for one-click deployment as a public Streamable HTTP MCP server.
+Pick your client, install the package, paste the config, restart. Celina shows up as MCP tools your LLM can call.
 
-### 1. Generate an RSA key pair
+### Local stdio (recommended)
 
-```bash
-openssl genpkey -algorithm RSA -out private.pem -pkeyopt rsa_keygen_bits:2048
-openssl rsa -pubout -in private.pem -out public.pem
-```
+Install the package, then point your MCP client at the built entry. Works in any stdio client (Cursor, Claude Desktop, LM Studio, Continue, MCP Inspector). Requires Node.js ≥ 20.
 
-### 2. Deploy
+1. Run `npm i @andrewkimjoseph/celina`
+2. Open your MCP config (e.g. `claude_desktop_config.json`, Cursor **Settings → MCP**) and merge the snippet below into `mcpServers`
+3. Replace the path with your absolute path to `node_modules/@andrewkimjoseph/celina/build/index.js`, then restart the client
 
-1. Push this repo to GitHub
-2. Render Dashboard → **New → Blueprint** → connect the repo
-3. Set `WALLET_ENCRYPTION_PRIVATE_KEY` in the Render Environment tab (paste contents of `private.pem`)
-4. (Optional) Add a custom domain in Render and set `ALLOWED_HOSTS` to that hostname (comma-separated if multiple)
-5. Your MCP endpoint will be at your Render URL + `/mcp`
+```json
+{
+  "mcpServers": {
+    "celina": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/path/to/node_modules/@andrewkimjoseph/celina/build/index.js"],
+      "env": {
+        "CELO_PRIVATE_KEY": "0x...",
+        "SELF_AGENT_PRIVATE_KEY": "0x..."
+      }
+    }
+  }
+}
+```
 
-> **Note:** Free Render services spin down after ~15 minutes of inactivity. Cold starts can take 30–60 seconds and may cause MCP client timeouts. Use a Starter plan for always-on hosting.
+Keep `CELO_PRIVATE_KEY` and `SELF_AGENT_PRIVATE_KEY` out of source control — they stay on your machine. Omit both for read-only chain queries.
 
-## Cursor / Claude Desktop config
+### Cursor — remote (streamable HTTP)
 
-### Cursor — remote (recommended)
+No local install — paste and go. Write tools use the [hosted encryption flow](#write-tools-hosted-mode) (no plaintext keys in config).
 
 ```json
 {
@@ -101,43 +111,46 @@ Fully quit and relaunch Claude Desktop after editing the config (closing the win
 
 > **Pro / Max / Team / Enterprise:** you can skip `mcp-remote` and add `https://mcp.celina.andrewkimjoseph.com/mcp` under **Settings → Integrations** instead.
 
-### Local stdio (npm)
+### Local stdio (from source)
 
-After `npm i @andrewkimjoseph/celina`, point your MCP client at the installed entry file (use an absolute path):
+For development from a cloned repo, point at your local `build/index.js`:
 
 ```json
 {
   "mcpServers": {
     "celina": {
+      "type": "stdio",
       "command": "node",
-      "args": ["/absolute/path/to/node_modules/@andrewkimjoseph/celina/build/index.js"]
+      "args": ["/absolute/path/to/celina/build/index.js"],
+      "env": {
+        "CELO_PRIVATE_KEY": "0x...",
+        "SELF_AGENT_PRIVATE_KEY": "0x..."
+      }
     }
   }
 }
 ```
 
-### Local stdio (from source)
+## Deploy to Render
 
-```json
-{
-  "mcpServers": {
-    "celina": {
-      "command": "node",
-      "args": ["/absolute/path/to/celina/build/index.js"]
-    }
-  }
-}
-```
+This project includes a [Render Blueprint](render.yaml) for one-click deployment as a public Streamable HTTP MCP server.
 
-For local write tools, add a funded mainnet wallet:
+### 1. Generate an RSA key pair
 
-```json
-"env": {
-  "CELO_PRIVATE_KEY": "0x..."
-}
+```bash
+openssl genpkey -algorithm RSA -out private.pem -pkeyopt rsa_keygen_bits:2048
+openssl rsa -pubout -in private.pem -out public.pem
 ```
 
-Never commit private keys. Use env vars only.
+### 2. Deploy
+
+1. Push this repo to GitHub
+2. Render Dashboard → **New → Blueprint** → connect the repo
+3. Set `WALLET_ENCRYPTION_PRIVATE_KEY` in the Render Environment tab (paste contents of `private.pem`)
+4. (Optional) Add a custom domain in Render and set `ALLOWED_HOSTS` to that hostname (comma-separated if multiple)
+5. Your MCP endpoint will be at your Render URL + `/mcp`
+
+> **Note:** Free Render services spin down after ~15 minutes of inactivity. Cold starts can take 30–60 seconds and may cause MCP client timeouts. Use a Starter plan for always-on hosting.
 
 ## Local LLM integration
 
@@ -147,10 +160,10 @@ Read-only tools (balances, blocks, GoodDollar status, etc.) work out of the box.
 
 ### LM Studio (0.3.17+)
 
-LM Studio can host MCP servers directly via `mcp.json` (same format as Cursor).
+LM Studio can host MCP servers directly via `mcp.json`. After `npm i @andrewkimjoseph/celina`:
 
 1. Open LM Studio → **Program** → **Install** → **Edit mcp.json**
-2. Add Celina under `mcpServers`
+2. Add Celina under `mcpServers` (same JSON as [Local stdio (recommended)](#local-stdio-recommended))
 3. In **Server Settings**, enable **Allow calling servers from mcp.json**
 4. Chat with a tool-capable model (e.g. Qwen 2.5, Llama 3.1+)
 
@@ -158,17 +171,19 @@ LM Studio can host MCP servers directly via `mcp.json` (same format as Cursor).
 {
   "mcpServers": {
     "celina": {
+      "type": "stdio",
       "command": "node",
       "args": ["/absolute/path/to/node_modules/@andrewkimjoseph/celina/build/index.js"],
       "env": {
-        "CELO_PRIVATE_KEY": "0x..."
+        "CELO_PRIVATE_KEY": "0x...",
+        "SELF_AGENT_PRIVATE_KEY": "0x..."
       }
     }
   }
 }
 ```
 
-Omit `CELO_PRIVATE_KEY` if you only need read-only chain queries.
+Omit both env vars for read-only chain queries.
 
 ### Open WebUI + Ollama
 
@@ -197,7 +212,9 @@ For write tools over HTTP, set `WALLET_ENCRYPTION_PRIVATE_KEY` in `.env` (see [D
 
 [Continue](https://docs.continue.dev/customize/deep-dives/mcp) works with local models (Ollama, LM Studio, etc.) in **agent mode**.
 
-Create `.continue/mcpServers/celina.yaml` in your workspace:
+1. Run `npm i @andrewkimjoseph/celina`
+2. Create `.continue/mcpServers/celina.yaml` in your workspace
+3. Switch Continue to agent mode and prompt
 
 ```yaml
 name: Celina
@@ -206,14 +223,13 @@ schema: v1
 mcpServers:
   - name: celina
     type: stdio
-    command: node
+    command: npx
     args:
-      - "/absolute/path/to/node_modules/@andrewkimjoseph/celina/build/index.js"
-    env:
-      CELO_PRIVATE_KEY: "0x..."
+      - "-y"
+      - "@andrewkimjoseph/celina"
 ```
 
-Alternatively, copy the [local stdio JSON](#local-stdio-npm) from the Cursor section into `.continue/mcpServers/mcp.json` — Continue picks up Claude/Cursor-style configs automatically.
+Alternatively, copy the [local stdio JSON](#local-stdio-recommended) into `.continue/mcpServers/mcp.json` — Continue picks up Claude/Cursor-style configs automatically.
 
 ### Test without an LLM
 

package/build/clients/ens-client.d.ts

@@ -0,0 +1,10 @@
+import { type PublicClient } from "viem";
+import type { AppConfig } from "../config/env.js";
+export declare const DEFAULT_ETH_RPC_URL = "https://ethereum.publicnode.com";
+export declare const ENS_CCIP_GATEWAY = "https://ccip.ens.xyz";
+export declare class EnsClientFactory {
+    private readonly config;
+    private client;
+    constructor(config: AppConfig);
+    getClient(): PublicClient;
+}

package/build/clients/ens-client.js

@@ -0,0 +1,23 @@
+import { createPublicClient, http } from "viem";
+import { mainnet } from "viem/chains";
+export const DEFAULT_ETH_RPC_URL = "https://ethereum.publicnode.com";
+export const ENS_CCIP_GATEWAY = "https://ccip.ens.xyz";
+export class EnsClientFactory {
+    config;
+    client = null;
+    constructor(config) {
+        this.config = config;
+    }
+    getClient() {
+        if (this.client) {
+            return this.client;
+        }
+        const rpcUrl = this.config.ethRpcUrl ?? DEFAULT_ETH_RPC_URL;
+        this.client = createPublicClient({
+            chain: mainnet,
+            transport: http(rpcUrl, { timeout: 15_000 }),
+        });
+        return this.client;
+    }
+}
+//# sourceMappingURL=ens-client.js.map

package/build/clients/ens-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ens-client.js","sourceRoot":"","sources":["../../src/clients/ens-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAqB,MAAM,MAAM,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAErE,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,MAAM,OAAO,gBAAgB;IAGE;IAFrB,MAAM,GAAwB,IAAI,CAAC;IAE3C,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAElD,SAAS;QACP,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,mBAAmB,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC;YAC/B,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC7C,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/build/config/env.d.ts

@@ -1,5 +1,6 @@
 export interface AppConfig {
     rpcUrl: string;
+    ethRpcUrl?: string;
     privateKey?: `0x${string}`;
     selfAgentPrivateKey?: `0x${string}`;
 }

package/build/config/env.js

@@ -1,6 +1,7 @@
 export function loadConfig() {
     return {
         rpcUrl: process.env.CELO_RPC_URL_MAINNET ?? "https://forno.celo.org",
+        ethRpcUrl: process.env.ETH_RPC_URL_MAINNET,
         privateKey: process.env.CELO_PRIVATE_KEY,
         selfAgentPrivateKey: process.env.SELF_AGENT_PRIVATE_KEY,
     };

package/build/config/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB;QACpE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6C;QACrE,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAEpB;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB;QACpE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;QAC1C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAA6C;QACrE,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAEpB;KACd,CAAC;AACJ,CAAC"}

package/build/context/app-context.d.ts

@@ -1,4 +1,5 @@
 import type { CeloClientFactory } from "../clients/celo-client.js";
+import type { EnsClientFactory } from "../clients/ens-client.js";
 import { BlockchainService } from "../services/blockchain.service.js";
 import { AccountService } from "../services/account.service.js";
 import { TokenService } from "../services/token.service.js";
@@ -7,6 +8,7 @@ import { MentoFxService } from "../services/mento-fx.service.js";
 import { GoodDollarService } from "../services/gooddollar.service.js";
 import { AaveService } from "../services/aave.service.js";
 import { SelfService } from "../services/self.service.js";
+import { EnsService } from "../services/ens.service.js";
 export interface AppContext {
     config: {
         hasWallet: boolean;
@@ -21,5 +23,6 @@ export interface AppContext {
     gooddollar: GoodDollarService;
     aave: AaveService;
     self: SelfService;
+    ens: EnsService;
 }
-export declare function createAppContext(clientFactory: CeloClientFactory, walletAddress?: `0x${string}`, selfAgentPrivateKey?: `0x${string}`): AppContext;
+export declare function createAppContext(clientFactory: CeloClientFactory, ensClientFactory: EnsClientFactory, walletAddress?: `0x${string}`, selfAgentPrivateKey?: `0x${string}`): AppContext;

package/build/context/app-context.js

@@ -6,7 +6,8 @@ import { MentoFxService } from "../services/mento-fx.service.js";
 import { GoodDollarService } from "../services/gooddollar.service.js";
 import { AaveService } from "../services/aave.service.js";
 import { SelfService } from "../services/self.service.js";
-export function createAppContext(clientFactory, walletAddress, selfAgentPrivateKey) {
+import { EnsService } from "../services/ens.service.js";
+export function createAppContext(clientFactory, ensClientFactory, walletAddress, selfAgentPrivateKey) {
     return {
         config: {
             hasWallet: Boolean(walletAddress),
@@ -21,6 +22,7 @@ export function createAppContext(clientFactory, walletAddress, selfAgentPrivateK
         gooddollar: new GoodDollarService(clientFactory),
         aave: new AaveService(clientFactory),
         self: new SelfService(clientFactory, selfAgentPrivateKey),
+        ens: new EnsService(ensClientFactory),
     };
 }
 //# sourceMappingURL=app-context.js.map

package/build/context/app-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAkB1D,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,aAA6B,EAC7B,mBAAmC;IAEnC,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;YACb,eAAe,EAAE,OAAO,CAAC,mBAAmB,CAAC;SAC9C;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC;KAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"app-context.js","sourceRoot":"","sources":["../../src/context/app-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAmBxD,MAAM,UAAU,gBAAgB,CAC9B,aAAgC,EAChC,gBAAkC,EAClC,aAA6B,EAC7B,mBAAmC;IAEnC,OAAO;QACL,MAAM,EAAE;YACN,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC;YACjC,aAAa;YACb,eAAe,EAAE,OAAO,CAAC,mBAAmB,CAAC;SAC9C;QACD,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,KAAK,EAAE,IAAI,YAAY,CAAC,aAAa,CAAC;QACtC,WAAW,EAAE,IAAI,kBAAkB,CAAC,aAAa,CAAC;QAClD,OAAO,EAAE,IAAI,cAAc,CAAC,aAAa,CAAC;QAC1C,UAAU,EAAE,IAAI,iBAAiB,CAAC,aAAa,CAAC;QAChD,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,CAAC;QACpC,IAAI,EAAE,IAAI,WAAW,CAAC,aAAa,EAAE,mBAAmB,CAAC;QACzD,GAAG,EAAE,IAAI,UAAU,CAAC,gBAAgB,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/build/schemas/common.d.ts

@@ -1,4 +1,6 @@
 import { z } from "zod";
 export declare const addressSchema: z.ZodString;
+export declare const addressOrEnsSchema: z.ZodString;
 export declare const blockIdSchema: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodLiteral<"latest">, z.ZodLiteral<"pending">]>;
 export declare const tokenSymbolSchema: z.ZodString;
+export declare const ensNameSchema: z.ZodString;

package/build/schemas/common.js

@@ -2,6 +2,10 @@ import { z } from "zod";
 export const addressSchema = z
     .string()
     .regex(/^0x[a-fA-F0-9]{40}$/, "Invalid Ethereum address");
+export const addressOrEnsSchema = z
+    .string()
+    .min(3)
+    .describe("Recipient 0x address or ENS name (e.g. andrewkimjoseph.celo.eth, celina.eth)");
 export const blockIdSchema = z
     .union([
     z.number().int().nonnegative(),
@@ -13,4 +17,8 @@ export const blockIdSchema = z
 export const tokenSymbolSchema = z
     .string()
     .describe("Token symbol (e.g. CELO, USDm, G$, GoodDollar) or 0x contract address");
+export const ensNameSchema = z
+    .string()
+    .min(3)
+    .describe("ENS name, e.g. celina.eth or vitalik.eth");
 //# sourceMappingURL=common.js.map

package/build/schemas/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,KAAK,CAAC;IACL,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAC1D,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACrB,CAAC;KACD,QAAQ,CAAC,uCAAuC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,QAAQ,CAAC,uEAAuE,CAAC,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,0BAA0B,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CACP,8EAA8E,CAC/E,CAAC;AAEJ,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,KAAK,CAAC;IACL,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC9B,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IAC1D,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACrB,CAAC;KACD,QAAQ,CAAC,uCAAuC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,QAAQ,CAAC,uEAAuE,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,0CAA0C,CAAC,CAAC"}

package/build/server/create-server.js

@@ -1,12 +1,14 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { loadConfig } from "../config/env.js";
 import { CeloClientFactory } from "../clients/celo-client.js";
+import { EnsClientFactory } from "../clients/ens-client.js";
 import { createAppContext } from "../context/app-context.js";
 import { registerAllTools } from "../tools/index.js";
 import { SERVER_INSTRUCTIONS } from "./instructions.js";
 export function createServer() {
     const config = loadConfig();
     const clientFactory = new CeloClientFactory(config);
+    const ensClientFactory = new EnsClientFactory(config);
     const clients = clientFactory.getClients();
     const server = new McpServer({ name: "celina", version: "0.2.0" }, {
         instructions: SERVER_INSTRUCTIONS,
@@ -15,7 +17,7 @@ export function createServer() {
             logging: {},
         },
     });
-    registerAllTools(server, createAppContext(clientFactory, clients.accountAddress, config.selfAgentPrivateKey));
+    registerAllTools(server, createAppContext(clientFactory, ensClientFactory, clients.accountAddress, config.selfAgentPrivateKey));
     return server;
 }
 //# sourceMappingURL=create-server.js.map

package/build/server/create-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC;QACE,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,gBAAgB,CACd,MAAM,EACN,gBAAgB,CACd,aAAa,EACb,OAAO,CAAC,cAAc,EACtB,MAAM,CAAC,mBAAmB,CAC3B,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EACpC;QACE,YAAY,EAAE,mBAAmB;QACjC,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,OAAO,EAAE,EAAE;SACZ;KACF,CACF,CAAC;IAEF,gBAAgB,CACd,MAAM,EACN,gBAAgB,CACd,aAAa,EACb,gBAAgB,EAChB,OAAO,CAAC,cAAc,EACtB,MAAM,CAAC,mBAAmB,CAC3B,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/server/instructions.js

@@ -2,7 +2,8 @@ export const SERVER_INSTRUCTIONS = `
 You are connected to Celina, the Celo MCP server (mainnet only).
 
 Guidelines:
-- Prefer read-only tools (get_*) before any write operation.
+- Prefer read-only tools (get_*, resolve_ens) before any write operation.
+- send_token and estimate_send accept ENS names (e.g. andrewkimjoseph.celo.eth) directly; use resolve_ens for standalone lookups.
 - Always call estimate_send before send_token when possible.
 - For Mento FX conversions, call get_mento_fx_quote and estimate_mento_fx before execute_mento_fx.
 - Write tools require CELO_PRIVATE_KEY in the server environment.

package/build/server/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;CAmBlC,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBlC,CAAC,IAAI,EAAE,CAAC"}

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

@@ -0,0 +1,30 @@
+import { type EnsClientFactory } from "../clients/ens-client.js";
+export type EnsResolveChain = "celo" | "ethereum";
+export type ResolvedRecipient = {
+    address: `0x${string}`;
+    ens?: {
+        name: string;
+        normalizedName: string;
+        resolvedVia?: "celo" | "ethereum";
+    };
+};
+export declare class EnsService {
+    private readonly ensClientFactory;
+    constructor(ensClientFactory: EnsClientFactory);
+    resolveEns(name: string, chain?: EnsResolveChain): Promise<{
+        name: string;
+        normalizedName: string;
+        address: `0x${string}`;
+        coinType: string;
+        chain: "ethereum";
+        resolvedVia?: undefined;
+    } | {
+        name: string;
+        normalizedName: string;
+        address: `0x${string}`;
+        coinType: string;
+        chain: "celo";
+        resolvedVia: "celo" | "ethereum";
+    }>;
+    resolveAddressOrEns(input: string): Promise<ResolvedRecipient>;
+}

package/build/services/ens.service.js

@@ -0,0 +1,78 @@
+import { toCoinType } from "viem";
+import { celo } from "viem/chains";
+import { getEnsAddress, normalize } from "viem/ens";
+import { ENS_CCIP_GATEWAY, } from "../clients/ens-client.js";
+const ADDRESS_PATTERN = /^0x[a-fA-F0-9]{40}$/;
+export class EnsService {
+    ensClientFactory;
+    constructor(ensClientFactory) {
+        this.ensClientFactory = ensClientFactory;
+    }
+    async resolveEns(name, chain = "celo") {
+        const trimmedName = name.trim();
+        const normalizedName = normalize(trimmedName);
+        const client = this.ensClientFactory.getClient();
+        const gatewayUrls = [ENS_CCIP_GATEWAY];
+        if (chain === "ethereum") {
+            const address = await getEnsAddress(client, {
+                name: normalizedName,
+                gatewayUrls,
+            });
+            if (!address) {
+                throw new Error(`ENS name "${trimmedName}" has no Ethereum address record`);
+            }
+            return {
+                name: trimmedName,
+                normalizedName,
+                address,
+                coinType: "60",
+                chain: "ethereum",
+            };
+        }
+        const celoCoinType = toCoinType(celo.id);
+        let address = await getEnsAddress(client, {
+            name: normalizedName,
+            coinType: celoCoinType,
+            gatewayUrls,
+        });
+        let coinType = celoCoinType.toString();
+        let resolvedVia = "celo";
+        if (!address) {
+            address = await getEnsAddress(client, {
+                name: normalizedName,
+                gatewayUrls,
+            });
+            coinType = "60";
+            resolvedVia = "ethereum";
+        }
+        if (!address) {
+            throw new Error(`ENS name "${trimmedName}" could not be resolved to an address`);
+        }
+        return {
+            name: trimmedName,
+            normalizedName,
+            address,
+            coinType,
+            chain: "celo",
+            resolvedVia,
+        };
+    }
+    async resolveAddressOrEns(input) {
+        const trimmed = input.trim();
+        if (ADDRESS_PATTERN.test(trimmed)) {
+            return { address: trimmed };
+        }
+        const resolved = await this.resolveEns(trimmed);
+        return {
+            address: resolved.address,
+            ens: {
+                name: resolved.name,
+                normalizedName: resolved.normalizedName,
+                ...(resolved.chain === "celo"
+                    ? { resolvedVia: resolved.resolvedVia }
+                    : {}),
+            },
+        };
+    }
+}
+//# sourceMappingURL=ens.service.js.map

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

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

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

@@ -0,0 +1,2 @@
+import type { ToolModule } from "./types.js";
+export declare const ensTools: ToolModule;

package/build/tools/ens.tools.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { ensNameSchema } from "../schemas/common.js";
+import { err, ok } from "./helpers.js";
+export const ensTools = {
+    register(server, ctx) {
+        server.registerTool("resolve_ens", {
+            title: "Resolve ENS",
+            description: "Resolve an ENS name (e.g. celina.eth) to a 0x address via Ethereum mainnet. Defaults to Celo: tries the Celo coin record first, then falls back to the standard Ethereum address.",
+            inputSchema: z.object({
+                name: ensNameSchema,
+                chain: z
+                    .enum(["celo", "ethereum"])
+                    .default("celo")
+                    .describe("Target chain. celo: Celo coin record with Ethereum fallback. ethereum: Ethereum address only."),
+            }),
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        }, async ({ name, chain }) => {
+            try {
+                return ok(await ctx.ens.resolveEns(name, chain));
+            }
+            catch (error) {
+                return err(error instanceof Error ? error.message : String(error));
+            }
+        });
+    },
+};
+//# sourceMappingURL=ens.tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ens.tools.js","sourceRoot":"","sources":["../../src/tools/ens.tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,QAAQ,GAAe;IAClC,QAAQ,CAAC,MAAiB,EAAE,GAAe;QACzC,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;YACE,KAAK,EAAE,aAAa;YACpB,WAAW,EACT,mLAAmL;YACrL,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,CAAC;qBACL,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;qBAC1B,OAAO,CAAC,MAAM,CAAC;qBACf,QAAQ,CACP,+FAA+F,CAChG;aACJ,CAAC;YACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;SAC1D,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;YACxB,IAAI,CAAC;gBACH,OAAO,EAAE,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}

package/build/tools/index.js

@@ -6,9 +6,11 @@ import { transactionTools } from "./transaction.tools.js";
 import { mentoFxTools } from "./mento-fx.tools.js";
 import { aaveTools } from "./aave.tools.js";
 import { walletTools } from "./wallet.tools.js";
+import { ensTools } from "./ens.tools.js";
 export const toolModules = [
     blockchainTools,
     accountTools,
+    ensTools,
     tokenTools,
     walletTools,
     transactionTools,

package/build/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,eAAe;IACf,YAAY;IACZ,UAAU;IACV,WAAW;IACX,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,eAAe;IACf,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAe;IACjE,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,eAAe;IACf,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,WAAW;IACX,gBAAgB;IAChB,YAAY;IACZ,SAAS;IACT,eAAe;IACf,SAAS;CACV,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAe;IACjE,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/build/tools/transaction.tools.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { addressSchema, tokenSymbolSchema } from "../schemas/common.js";
+import { addressOrEnsSchema, tokenSymbolSchema } from "../schemas/common.js";
 import { err, ok } from "./helpers.js";
 const encryptedPrivateKeySchema = z
     .string()
@@ -9,9 +9,9 @@ export const transactionTools = {
     register(server, ctx) {
         server.registerTool("estimate_send", {
             title: "Estimate Send",
-            description: "Estimates gas for sending CELO or an ERC-20 token on mainnet. Requires encryptedPrivateKey (hosted) or CELO_PRIVATE_KEY (local).",
+            description: "Estimates gas for sending CELO or an ERC-20 token on mainnet. Accepts a 0x address or ENS name as recipient. Requires encryptedPrivateKey (hosted) or CELO_PRIVATE_KEY (local).",
             inputSchema: z.object({
-                to: addressSchema,
+                to: addressOrEnsSchema,
                 token: tokenSymbolSchema.default("CELO"),
                 amount: z.string().describe("Human-readable amount, e.g. 1.5"),
                 encryptedPrivateKey: encryptedPrivateKeySchema,
@@ -19,7 +19,9 @@ export const transactionTools = {
             annotations: { readOnlyHint: true },
         }, async ({ to, token, amount, encryptedPrivateKey }) => {
             try {
-                return ok(await ctx.transaction.estimateSend(to, token, amount, encryptedPrivateKey));
+                const { address, ens } = await ctx.ens.resolveAddressOrEns(to);
+                const estimate = await ctx.transaction.estimateSend(address, token, amount, encryptedPrivateKey);
+                return ok(ens ? { ...estimate, ens } : estimate);
             }
             catch (error) {
                 return err(error instanceof Error ? error.message : String(error));
@@ -27,9 +29,9 @@ export const transactionTools = {
         });
         server.registerTool("send_token", {
             title: "Send Token",
-            description: "Send CELO or an ERC-20 token on mainnet. User must encrypt their private key with the server's public key (get_wallet_encryption_public_key) before calling.",
+            description: "Send CELO or an ERC-20 token on mainnet. Accepts a 0x address or ENS name as recipient. User must encrypt their private key with the server's public key (get_wallet_encryption_public_key) before calling.",
             inputSchema: z.object({
-                to: addressSchema,
+                to: addressOrEnsSchema,
                 token: tokenSymbolSchema.default("CELO"),
                 amount: z.string().describe("Human-readable amount, e.g. 0.01"),
                 encryptedPrivateKey: encryptedPrivateKeySchema,
@@ -40,7 +42,9 @@ export const transactionTools = {
             },
         }, async ({ to, token, amount, encryptedPrivateKey }) => {
             try {
-                return ok(await ctx.transaction.sendToken(to, token, amount, encryptedPrivateKey));
+                const { address, ens } = await ctx.ens.resolveAddressOrEns(to);
+                const result = await ctx.transaction.sendToken(address, token, amount, encryptedPrivateKey);
+                return ok(ens ? { ...result, ens } : result);
             }
             catch (error) {
                 return err(error instanceof Error ? error.message : String(error));

package/build/tools/transaction.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.tools.js","sourceRoot":"","sources":["../../src/tools/transaction.tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,yBAAyB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,iGAAiG,CAClG,CAAC;AAEJ,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,QAAQ,CAAC,MAAiB,EAAE,GAAe;QACzC,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;YACE,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,kIAAkI;YACpI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,EAAE,EAAE,aAAa;gBACjB,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC;gBACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;gBAC9D,mBAAmB,EAAE,yBAAyB;aAC/C,CAAC;YACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;SACpC,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,EAAE;YACnD,IAAI,CAAC;gBACH,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,WAAW,CAAC,YAAY,CAChC,EAAmB,EACnB,KAAK,EACL,MAAM,EACN,mBAAmB,CACpB,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;YACE,KAAK,EAAE,YAAY;YACnB,WAAW,EACT,8JAA8J;YAChK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,EAAE,EAAE,aAAa;gBACjB,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC;gBACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;gBAC/D,mBAAmB,EAAE,yBAAyB;aAC/C,CAAC;YACF,WAAW,EAAE;gBACX,eAAe,EAAE,IAAI;gBACrB,aAAa,EAAE,IAAI;aACpB;SACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,EAAE;YACnD,IAAI,CAAC;gBACH,OAAO,EAAE,CACP,MAAM,GAAG,CAAC,WAAW,CAAC,SAAS,CAC7B,EAAmB,EACnB,KAAK,EACL,MAAM,EACN,mBAAmB,CACpB,CACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"transaction.tools.js","sourceRoot":"","sources":["../../src/tools/transaction.tools.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Celina — MCP server for Celo mainnet. Balances, transfers, Self Agent ID, and chain reads for LLM agents.",
   "type": "module",
   "main": "build/index.js",