zano-mcp 0.1.0

package/README.md

@@ -0,0 +1,195 @@
+# zano-mcp
+
+MCP server for the [Zano](https://zano.org) blockchain. Wraps Zano's daemon, wallet, and trade JSON-RPC APIs as MCP tools.
+
+## Installation
+
+```json
+{
+  "mcpServers": {
+    "zano": {
+      "command": "npx",
+      "args": ["-y", "zano-mcp"],
+      "env": {
+        "ZANO_DAEMON_URL": "http://127.0.0.1:11211/json_rpc"
+      }
+    }
+  }
+}
+```
+
+**Public node (zero setup):**
+
+```json
+{
+  "mcpServers": {
+    "zano": {
+      "command": "npx",
+      "args": ["-y", "zano-mcp"],
+      "env": {
+        "ZANO_DAEMON_URL": "http://37.27.100.59:10500/json_rpc"
+      }
+    }
+  }
+}
+```
+
+**Full config (daemon + wallet + trade):**
+
+```json
+{
+  "mcpServers": {
+    "zano": {
+      "command": "npx",
+      "args": ["-y", "zano-mcp"],
+      "env": {
+        "ZANO_DAEMON_URL": "http://127.0.0.1:11211/json_rpc",
+        "ZANO_WALLET_URL": "http://127.0.0.1:11212/json_rpc",
+        "ZANO_TRADE_TOKEN": "your_trade_api_token"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+All environment variables are optional with sensible defaults.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `ZANO_DAEMON_URL` | `http://127.0.0.1:11211/json_rpc` | Daemon RPC endpoint |
+| `ZANO_WALLET_URL` | (none) | Wallet RPC endpoint. If unset, wallet tools are not registered |
+| `ZANO_WALLET_AUTH` | (none) | JWT secret for wallet RPC auth |
+| `ZANO_TRADE_URL` | `https://api.trade.zano.org` | Trade API base URL |
+| `ZANO_TRADE_TOKEN` | (none) | Trade API auth token. If unset, only public trade tools |
+| `ZANO_NETWORK` | `mainnet` | `mainnet` or `testnet` |
+| `ZANO_LOG_LEVEL` | `info` | `debug`, `info`, `warn`, `error` |
+
+CLI args override env vars: `--daemon-url`, `--wallet-url`, `--network`, etc.
+
+## Feature Gating
+
+Tools are conditionally registered based on what's configured:
+
+| Config present | Tools available |
+|---------------|----------------|
+| Always | Daemon tools (15) + Public trade tools (2) |
+| `ZANO_WALLET_URL` | + Wallet (12) + Asset (7) + Swap (3) tools |
+| `ZANO_TRADE_TOKEN` | + Authenticated trade tools (7) |
+
+## Available Tools
+
+### Daemon Tools (15)
+
+| Tool | Description |
+|------|-------------|
+| `get_network_info` | Network status (height, difficulty, hashrate, connections) |
+| `get_height` | Current blockchain height |
+| `get_block_by_height` | Block header at a given height |
+| `get_block_by_hash` | Block header by hash |
+| `get_last_block` | Latest block header |
+| `get_block_details` | Full block with transaction list |
+| `get_transaction` | Transaction details by hash |
+| `get_transactions` | Batch transaction lookup |
+| `get_pool_info` | Mempool status |
+| `get_asset_info` | Asset metadata by ID |
+| `get_assets_list` | All registered assets |
+| `resolve_alias` | Address for a Zano alias |
+| `get_alias_by_address` | Alias for an address |
+| `search_blockchain` | Search by hash/alias |
+| `validate_signature` | Verify a signed message |
+
+### Wallet Tools (12) - requires `ZANO_WALLET_URL`
+
+| Tool | Description |
+|------|-------------|
+| `get_balance` | Wallet balance (all assets, human-readable) |
+| `get_address` | Wallet public address |
+| `get_wallet_status` | Sync status, watch-only flag |
+| `transfer` | Send ZANO or assets (human-readable amounts) |
+| `get_recent_transactions` | Recent transaction history |
+| `search_transactions` | Search by various criteria |
+| `sign_message` | Sign arbitrary data |
+| `save_wallet` | Persist wallet state |
+| `make_integrated_address` | Create with payment ID |
+| `split_integrated_address` | Decode integrated address |
+| `get_mining_history` | PoS staking rewards |
+| `sweep_below` | Consolidate small outputs |
+
+### Asset Tools (7) - requires `ZANO_WALLET_URL`
+
+| Tool | Description |
+|------|-------------|
+| `deploy_asset` | Create a new asset |
+| `emit_asset` | Mint additional supply |
+| `burn_asset` | Burn tokens |
+| `update_asset` | Update metadata |
+| `transfer_asset_ownership` | Change asset owner |
+| `whitelist_asset` | Add to wallet whitelist |
+| `remove_asset_from_whitelist` | Remove from whitelist |
+
+### Swap Tools (3) - requires `ZANO_WALLET_URL`
+
+| Tool | Description |
+|------|-------------|
+| `create_swap_proposal` | Create an ionic swap proposal |
+| `get_swap_info` | View proposal details |
+| `accept_swap` | Accept and execute a swap |
+
+### Trade Tools (2 public + 7 authenticated)
+
+**Public (always available):**
+
+| Tool | Description |
+|------|-------------|
+| `get_trading_pair` | Pair info by ID |
+| `get_order_book` | Order book with depth/spread |
+
+**Authenticated (requires `ZANO_TRADE_TOKEN`):**
+
+| Tool | Description |
+|------|-------------|
+| `dex_authenticate` | Authenticate with Trade API |
+| `create_order` | Create buy/sell order |
+| `cancel_order` | Cancel an order |
+| `get_my_orders` | Your active orders + tips |
+| `apply_order` | Match with another order |
+| `confirm_trade` | Confirm a trade |
+| `get_active_trade` | Get trade by order IDs |
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `zano://network/info` | Current network configuration |
+| `zano://assets/whitelist` | Official asset whitelist |
+
+## Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `check-network` | Generate a network status report |
+| `analyze-order-book` | Analyze order book for a pair |
+| `explain-transaction` | Explain a transaction in plain language |
+| `swap-calculator` | Calculate swap parameters |
+
+## Requirements
+
+- Node.js >= 18
+- A running Zano daemon (local or public node)
+- Wallet RPC running if you want wallet/asset/swap tools
+- Trade API token if you want authenticated DEX operations
+
+## Development
+
+```bash
+git clone https://github.com/PRavaga/zano-mcp.git
+cd zano-mcp
+npm install
+ZANO_DAEMON_URL=http://37.27.100.59:10500/json_rpc npm run dev
+```
+
+## License
+
+MIT

package/dist/clients/daemon.d.ts

@@ -0,0 +1,6 @@
+export declare class DaemonClient {
+    private url;
+    constructor(url: string);
+    call<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/dist/clients/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/clients/daemon.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAIjB,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CA+B1F"}

package/dist/clients/daemon.js

@@ -0,0 +1,30 @@
+import { logger } from "../logger.js";
+export class DaemonClient {
+    url;
+    constructor(url) {
+        this.url = url;
+    }
+    async call(method, params = {}) {
+        const body = JSON.stringify({
+            jsonrpc: "2.0",
+            id: 0,
+            method,
+            params,
+        });
+        logger.debug(`Daemon RPC: ${method}`, params);
+        const res = await fetch(this.url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body,
+        });
+        if (!res.ok) {
+            throw new Error(`Daemon RPC HTTP ${res.status}: ${res.statusText}`);
+        }
+        const json = (await res.json());
+        if (json.error) {
+            throw new Error(`Daemon RPC error: ${json.error.message} (code: ${json.error.code})`);
+        }
+        return json.result;
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/clients/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/clients/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,OAAO,YAAY;IACf,GAAG,CAAS;IAEpB,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAc,MAAc,EAAE,SAAkC,EAAE;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,CAAC;YACL,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;QAE9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,OAAO,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,IAAI,CAAC,MAAW,CAAC;IAC1B,CAAC;CACF"}

package/dist/clients/trade.d.ts

@@ -0,0 +1,8 @@
+export declare class TradeClient {
+    private baseUrl;
+    private token?;
+    constructor(baseUrl: string, token?: string);
+    setToken(token: string): void;
+    post<T = unknown>(path: string, data?: Record<string, unknown>, requireAuth?: boolean): Promise<T>;
+}
+//# sourceMappingURL=trade.d.ts.map

package/dist/clients/trade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.d.ts","sourceRoot":"","sources":["../../src/clients/trade.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAK3C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIvB,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,WAAW,UAAQ,GAClB,OAAO,CAAC,CAAC,CAAC;CA+Bd"}

package/dist/clients/trade.js

@@ -0,0 +1,33 @@
+import { logger } from "../logger.js";
+export class TradeClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.token = token;
+    }
+    setToken(token) {
+        this.token = token;
+    }
+    async post(path, data = {}, requireAuth = false) {
+        if (requireAuth && !this.token) {
+            throw new Error("Trade API authentication required. Set ZANO_TRADE_TOKEN or call dex_authenticate first.");
+        }
+        const payload = requireAuth ? { ...data, token: this.token } : data;
+        logger.debug(`Trade API: POST ${path}`, data);
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            throw new Error(`Trade API HTTP ${res.status}: ${res.statusText}`);
+        }
+        const json = (await res.json());
+        if (!json.success) {
+            throw new Error(`Trade API error: ${json.error || json.data || "Unknown error"}`);
+        }
+        return json.data;
+    }
+}
+//# sourceMappingURL=trade.js.map

package/dist/clients/trade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.js","sourceRoot":"","sources":["../../src/clients/trade.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,OAAO,WAAW;IACd,OAAO,CAAS;IAChB,KAAK,CAAU;IAEvB,YAAY,OAAe,EAAE,KAAc;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,OAAgC,EAAE,EAClC,WAAW,GAAG,KAAK;QAEnB,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpE,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAE9C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAI7B,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,eAAe,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,IAAI,CAAC,IAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/clients/wallet.d.ts

@@ -0,0 +1,8 @@
+export declare class WalletClient {
+    private url;
+    private auth?;
+    constructor(url: string, auth?: string);
+    call<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+    private generateAccessToken;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/clients/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/clients/wallet.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,IAAI,CAAC,CAAS;gBAEV,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAKhC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAwCzF,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/clients/wallet.js

@@ -0,0 +1,45 @@
+import { logger } from "../logger.js";
+export class WalletClient {
+    url;
+    auth;
+    constructor(url, auth) {
+        this.url = url;
+        this.auth = auth;
+    }
+    async call(method, params = {}) {
+        const body = JSON.stringify({
+            jsonrpc: "2.0",
+            id: 0,
+            method,
+            params,
+        });
+        logger.debug(`Wallet RPC: ${method}`, params);
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.auth) {
+            headers["Zano-Access-Token"] = this.generateAccessToken(body);
+        }
+        const res = await fetch(this.url, {
+            method: "POST",
+            headers,
+            body,
+        });
+        if (!res.ok) {
+            throw new Error(`Wallet RPC HTTP ${res.status}: ${res.statusText}`);
+        }
+        const json = (await res.json());
+        if (json.error) {
+            throw new Error(`Wallet RPC error: ${json.error.message} (code: ${json.error.code})`);
+        }
+        return json.result;
+    }
+    generateAccessToken(httpBody) {
+        // JWT-based auth for wallet RPC
+        // Uses SHA-256 hash of the body as part of the token payload
+        // For now, return the auth secret directly as a simple bearer token
+        // Full JWT implementation would require a JWT library
+        return this.auth || "";
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/clients/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/clients/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,OAAO,YAAY;IACf,GAAG,CAAS;IACZ,IAAI,CAAU;IAEtB,YAAY,GAAW,EAAE,IAAa;QACpC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CAAc,MAAc,EAAE,SAAkC,EAAE;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,CAAC;YACL,MAAM;YACN,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;QAE9C,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,OAAO,WAAW,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,IAAI,CAAC,MAAW,CAAC;IAC1B,CAAC;IAEO,mBAAmB,CAAC,QAAgB;QAC1C,gCAAgC;QAChC,6DAA6D;QAC7D,oEAAoE;QACpE,sDAAsD;QACtD,OAAO,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod";
+export declare const configSchema: z.ZodObject<{
+    daemonUrl: z.ZodString;
+    walletUrl: z.ZodOptional<z.ZodString>;
+    walletAuth: z.ZodOptional<z.ZodString>;
+    tradeUrl: z.ZodString;
+    tradeToken: z.ZodOptional<z.ZodString>;
+    network: z.ZodEnum<["mainnet", "testnet"]>;
+    logLevel: z.ZodEnum<["debug", "info", "warn", "error"]>;
+}, "strip", z.ZodTypeAny, {
+    daemonUrl: string;
+    tradeUrl: string;
+    network: "mainnet" | "testnet";
+    logLevel: "debug" | "info" | "warn" | "error";
+    walletUrl?: string | undefined;
+    walletAuth?: string | undefined;
+    tradeToken?: string | undefined;
+}, {
+    daemonUrl: string;
+    tradeUrl: string;
+    network: "mainnet" | "testnet";
+    logLevel: "debug" | "info" | "warn" | "error";
+    walletUrl?: string | undefined;
+    walletAuth?: string | undefined;
+    tradeToken?: string | undefined;
+}>;
+export type Config = z.infer<typeof configSchema>;
+export declare function loadConfig(cliArgs: Record<string, string | undefined>): Config;
+export declare function parseCliArgs(argv: string[]): Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;EAQvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CA2B9E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUnE"}

package/dist/config.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { DEFAULT_PORTS, TRADE_API_URL } from "./utils/constants.js";
+export const configSchema = z.object({
+    daemonUrl: z.string().url(),
+    walletUrl: z.string().url().optional(),
+    walletAuth: z.string().optional(),
+    tradeUrl: z.string().url(),
+    tradeToken: z.string().optional(),
+    network: z.enum(["mainnet", "testnet"]),
+    logLevel: z.enum(["debug", "info", "warn", "error"]),
+});
+export function loadConfig(cliArgs) {
+    const network = (cliArgs.network || process.env.ZANO_NETWORK || "mainnet");
+    const ports = DEFAULT_PORTS[network] || DEFAULT_PORTS.mainnet;
+    const defaultDaemonUrl = `http://127.0.0.1:${ports.daemon}/json_rpc`;
+    const raw = {
+        daemonUrl: cliArgs["daemon-url"] ||
+            process.env.ZANO_DAEMON_URL ||
+            defaultDaemonUrl,
+        walletUrl: cliArgs["wallet-url"] || process.env.ZANO_WALLET_URL || undefined,
+        walletAuth: cliArgs["wallet-auth"] || process.env.ZANO_WALLET_AUTH || undefined,
+        tradeUrl: cliArgs["trade-url"] || process.env.ZANO_TRADE_URL || TRADE_API_URL,
+        tradeToken: cliArgs["trade-token"] || process.env.ZANO_TRADE_TOKEN || undefined,
+        network,
+        logLevel: (cliArgs["log-level"] ||
+            process.env.ZANO_LOG_LEVEL ||
+            "info"),
+    };
+    return configSchema.parse(raw);
+}
+export function parseCliArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--") && i + 1 < argv.length) {
+            const key = arg.slice(2);
+            args[key] = argv[++i];
+        }
+    }
+    return args;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CACrD,CAAC,CAAC;AAIH,MAAM,UAAU,UAAU,CAAC,OAA2C;IACpE,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,SAAS,CAE5D,CAAC;IACd,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC;IAC9D,MAAM,gBAAgB,GAAG,oBAAoB,KAAK,CAAC,MAAM,WAAW,CAAC;IAErE,MAAM,GAAG,GAAG;QACV,SAAS,EACP,OAAO,CAAC,YAAY,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,eAAe;YAC3B,gBAAgB;QAClB,SAAS,EACP,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS;QACnE,UAAU,EACR,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,SAAS;QACrE,QAAQ,EACN,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,aAAa;QACrE,UAAU,EACR,OAAO,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,SAAS;QACrE,OAAO;QACP,QAAQ,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,cAAc;YAC1B,MAAM,CAAa;KACtB,CAAC;IAEF,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig, parseCliArgs } from "./config.js";
+import { setLogLevel } from "./logger.js";
+import { logger } from "./logger.js";
+import { createServer } from "./server.js";
+const cliArgs = parseCliArgs(process.argv.slice(2));
+const config = loadConfig(cliArgs);
+setLogLevel(config.logLevel);
+logger.info("Starting Zano MCP server...");
+const server = createServer(config);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+logger.info("Zano MCP server running on stdio");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;AACnC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAE7B,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAcD,eAAO,MAAM,MAAM;qBACA,OAAO,EAAE;oBACV,OAAO,EAAE;oBACT,OAAO,EAAE;qBACR,OAAO,EAAE;CAC3B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,28 @@
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = "info";
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LEVELS[level] >= LEVELS[currentLevel];
+}
+function log(level, ...args) {
+    if (!shouldLog(level))
+        return;
+    const ts = new Date().toISOString();
+    const prefix = `[${ts}] [${level.toUpperCase()}]`;
+    // All logging goes to stderr to avoid interfering with JSON-RPC on stdout
+    console.error(prefix, ...args);
+}
+export const logger = {
+    debug: (...args) => log("debug", ...args),
+    info: (...args) => log("info", ...args),
+    warn: (...args) => log("warn", ...args),
+    error: (...args) => log("error", ...args),
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,GAAG,CAAC,KAAe,EAAE,GAAG,IAAe;IAC9C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAC9B,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;IAClD,0EAA0E;IAC1E,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;CACrD,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "../config.js";
+export declare function registerPrompts(server: McpServer, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA0EvE"}

package/dist/prompts/index.js

@@ -0,0 +1,54 @@
+import { logger } from "../logger.js";
+import { z } from "zod";
+export function registerPrompts(server, config) {
+    server.prompt("check-network", "Check Zano network status - calls get_network_info and formats a report", {}, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Use the get_network_info tool to check the current Zano network status. Report the block height, sync status, difficulty, hashrate, connection count, and pool size. Flag anything unusual (low connections, sync lag, empty pool).",
+                },
+            },
+        ],
+    }));
+    server.prompt("analyze-order-book", "Analyze the DEX order book for a trading pair", { pair_id: z.string().describe("Trading pair ID (e.g. 643 for FUSD)") }, async ({ pair_id }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Use the get_order_book tool with pairId ${pair_id} and the get_trading_pair tool with id ${pair_id}. Analyze the order book depth, bid/ask spread, instant vs non-instant orders, and top traders. Summarize liquidity and any arbitrage opportunities.`,
+                },
+            },
+        ],
+    }));
+    server.prompt("explain-transaction", "Explain a Zano transaction in human-readable terms", { tx_hash: z.string().describe("Transaction hash") }, async ({ tx_hash }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Use the get_transaction tool with tx_hash "${tx_hash}". Explain the transaction in human-readable terms: what happened, how much was sent, the fee, confirmations, and any asset operations.`,
+                },
+            },
+        ],
+    }));
+    server.prompt("swap-calculator", "Calculate what an ionic swap would look like between two assets", {
+        from_asset: z.string().describe("Source asset ticker or ID"),
+        to_asset: z.string().describe("Destination asset ticker or ID"),
+        amount: z.string().describe("Amount to swap (human-readable)"),
+    }, async ({ from_asset, to_asset, amount }) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `I want to swap ${amount} ${from_asset} for ${to_asset}. Look up both assets using get_asset_info if needed. Calculate the swap parameters and explain what the ionic swap proposal would contain, including atomic amounts, fees, and the expected outcome.`,
+                },
+            },
+        ],
+    }));
+    logger.info("Prompts registered (4 prompts)");
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,MAAc;IAC/D,MAAM,CAAC,MAAM,CACX,eAAe,EACf,yEAAyE,EACzE,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qOAAqO;iBAC5O;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,+CAA+C,EAC/C,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EACvE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2CAA2C,OAAO,0CAA0C,OAAO,sJAAsJ;iBAChQ;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,qBAAqB,EACrB,oDAAoD,EACpD,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,EACpD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8CAA8C,OAAO,yIAAyI;iBACrM;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,iEAAiE,EACjE;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC5D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KAC/D,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3C,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kBAAkB,MAAM,IAAI,UAAU,QAAQ,QAAQ,uMAAuM;iBACpQ;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "../config.js";
+export declare function registerResources(server: McpServer, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAI3C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAmEzE"}