chia-explorer 0.1.0 → 0.1.3

package/README.md

@@ -11,6 +11,7 @@ Backed by the public [coinset.org](https://www.coinset.org) full-node API. Suppo
 - What is the balance of `xch1...` (or `txch1...`, or a raw puzzle hash)?
 - Look up a coin by name. Calculate a coin name from its fields.
 - Convert between addresses and puzzle hashes in either direction.
+- What is XCH worth in USD (or EUR, GBP, BTC, ...) right now? What's this balance worth?
 
 ## Install
 
@@ -61,8 +62,14 @@ Add to your `claude_desktop_config.json`:
 | `calculate_coin_name` | sha256(parent_coin_info \|\| puzzle_hash \|\| amount) — no RPC |
 | `address_to_puzzle_hash` | bech32m decode — no RPC |
 | `puzzle_hash_to_address` | bech32m encode — no RPC |
+| `get_xch_price` | Current XCH spot price in one or more currencies (CoinGecko) |
+| `convert_xch_to_fiat` | Convert a mojo amount to fiat using the current XCH price |
 
-All tools take an optional `network: "mainnet" | "testnet11"` (default `mainnet`).
+Blockchain tools take an optional `network: "mainnet" | "testnet11"` (default `mainnet`). The price tools don't take a network arg.
+
+## Optional config
+
+- `COINGECKO_API_KEY` — if set, sent as `x-cg-demo-api-key` to lift the free-tier rate limit. The price tools work without it.
 
 ## Prompts
 

package/dist/coingecko/cache.d.ts

@@ -0,0 +1,6 @@
+export declare function getCachedPrices(currencies: string[]): {
+    cached: Record<string, number>;
+    missing: string[];
+};
+export declare function setCachedPrices(prices: Record<string, number>): void;
+export declare function resetCache(): void;

package/dist/coingecko/cache.js

@@ -0,0 +1,27 @@
+const TTL_MS = 60_000;
+const cache = new Map();
+export function getCachedPrices(currencies) {
+    const now = Date.now();
+    const cached = {};
+    const missing = [];
+    for (const currency of currencies) {
+        const entry = cache.get(currency);
+        if (entry && entry.expiresAt > now) {
+            cached[currency] = entry.price;
+        }
+        else {
+            missing.push(currency);
+        }
+    }
+    return { cached, missing };
+}
+export function setCachedPrices(prices) {
+    const expiresAt = Date.now() + TTL_MS;
+    for (const [currency, price] of Object.entries(prices)) {
+        cache.set(currency, { price, expiresAt });
+    }
+}
+export function resetCache() {
+    cache.clear();
+}
+//# sourceMappingURL=cache.js.map

package/dist/coingecko/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/coingecko/cache.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,MAAM,CAAC;AAOtB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;AAEvC,MAAM,UAAU,eAAe,CAAC,UAAoB;IAIlD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACnC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACtC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/coingecko/client.d.ts

@@ -0,0 +1 @@
+export declare function fetchXchPrices(currencies: string[]): Promise<Record<string, number>>;

package/dist/coingecko/client.js

@@ -0,0 +1,45 @@
+const COINGECKO_URL = 'https://api.coingecko.com/api/v3/simple/price';
+const REQUEST_TIMEOUT_MS = 10_000;
+export async function fetchXchPrices(currencies) {
+    if (currencies.length === 0) {
+        throw new Error('at least one currency is required');
+    }
+    const params = new URLSearchParams({
+        ids: 'chia',
+        vs_currencies: currencies.join(','),
+    });
+    const headers = { accept: 'application/json' };
+    const apiKey = process.env.COINGECKO_API_KEY;
+    if (apiKey)
+        headers['x-cg-demo-api-key'] = apiKey;
+    const res = await fetch(`${COINGECKO_URL}?${params.toString()}`, {
+        headers,
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => '');
+        const detail = body ? `: ${body.slice(0, 200)}` : '';
+        throw new Error(`coingecko ${res.status} ${res.statusText}${detail}`);
+    }
+    const data = (await res.json());
+    if (!data || typeof data !== 'object' || !('chia' in data)) {
+        throw new Error('coingecko response missing `chia` field');
+    }
+    const chia = data.chia;
+    if (!chia || typeof chia !== 'object') {
+        throw new Error('coingecko response `chia` field is not an object');
+    }
+    const out = {};
+    for (const [currency, value] of Object.entries(chia)) {
+        if (typeof value !== 'number' || !Number.isFinite(value)) {
+            throw new Error(`coingecko returned non-numeric price for ${currency}`);
+        }
+        out[currency.toLowerCase()] = value;
+    }
+    const missing = currencies.filter((c) => !(c in out));
+    if (missing.length > 0) {
+        throw new Error(`coingecko returned no price for: ${missing.join(', ')}`);
+    }
+    return out;
+}
+//# sourceMappingURL=client.js.map

package/dist/coingecko/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/coingecko/client.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,+CAA+C,CAAC;AACtE,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAoB;IACvD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,GAAG,EAAE,MAAM;QACX,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,MAAM;QAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAAC;IAElD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE;QAC/D,OAAO;QACP,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC;KAChD,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;IAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/coingecko/index.d.ts

@@ -0,0 +1,2 @@
+export declare function getXchPrices(currencies: string[]): Promise<Record<string, number>>;
+export { resetCache } from './cache.js';

package/dist/coingecko/index.js

@@ -0,0 +1,12 @@
+import { fetchXchPrices } from './client.js';
+import { getCachedPrices, setCachedPrices } from './cache.js';
+export async function getXchPrices(currencies) {
+    const { cached, missing } = getCachedPrices(currencies);
+    if (missing.length === 0)
+        return cached;
+    const fetched = await fetchXchPrices(missing);
+    setCachedPrices(fetched);
+    return { ...cached, ...fetched };
+}
+export { resetCache } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/coingecko/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coingecko/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAoB;IACrD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC9C,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/coinset/pagination.d.ts

@@ -16,6 +16,11 @@ export interface CoinRecordLike {
  * looks capped. Coinset returns up to a fixed number of records per call; when
  * we see exactly that many, we re-query the range above the highest confirmed
  * height we've seen so far.
+ *
+ * Only include start_height / end_height in the payload when the caller asked
+ * for them. coinset.org treats end_height literally as a block height, so the
+ * full-node convention of passing 0xffffffff to mean "no upper bound" returns
+ * zero records.
  */
 export declare function fetchCoinRecordsByPuzzleHash(agent: RPCAgent, puzzleHashHex: string, options?: {
     includeSpent?: boolean;

package/dist/coinset/pagination.js

@@ -1,27 +1,36 @@
 import { get_coin_records_by_puzzle_hash } from 'chia-agent/api/rpc/full_node/index.js';
-const MAX_HEIGHT = 0xffffffff;
 const PAGE_SIZE_LIMIT = 5_000;
 /**
  * Fetch coin records by puzzle hash, paginating by height window if the response
  * looks capped. Coinset returns up to a fixed number of records per call; when
  * we see exactly that many, we re-query the range above the highest confirmed
  * height we've seen so far.
+ *
+ * Only include start_height / end_height in the payload when the caller asked
+ * for them. coinset.org treats end_height literally as a block height, so the
+ * full-node convention of passing 0xffffffff to mean "no upper bound" returns
+ * zero records.
  */
 export async function fetchCoinRecordsByPuzzleHash(agent, puzzleHashHex, options = {}) {
     const includeSpent = options.includeSpent ?? false;
-    let start = options.startHeight ?? 0;
-    const end = options.endHeight ?? MAX_HEIGHT;
+    let start = options.startHeight;
+    const end = options.endHeight;
     const all = [];
     const seen = new Set();
-    while (start <= end) {
-        const res = await get_coin_records_by_puzzle_hash(agent, {
+    while (true) {
+        if (start !== undefined && end !== undefined && start > end)
+            break;
+        const payload = {
             puzzle_hash: puzzleHashHex,
-            start_height: start,
-            end_height: end,
             include_spent_coins: includeSpent,
-        });
+        };
+        if (start !== undefined)
+            payload.start_height = start;
+        if (end !== undefined)
+            payload.end_height = end;
+        const res = await get_coin_records_by_puzzle_hash(agent, payload);
         const records = (res.coin_records ?? []);
-        let maxHeight = start;
+        let maxHeight = start ?? 0;
         for (const r of records) {
             const key = `${r.coin.parent_coin_info}|${r.coin.puzzle_hash}|${r.coin.amount.toString()}`;
             if (seen.has(key))
@@ -33,7 +42,7 @@ export async function fetchCoinRecordsByPuzzleHash(agent, puzzleHashHex, options
         }
         if (records.length < PAGE_SIZE_LIMIT)
             break;
-        if (maxHeight <= start)
+        if (start !== undefined && maxHeight <= start)
             break;
         start = maxHeight + 1;
     }

package/dist/coinset/pagination.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/coinset/pagination.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AAexF,MAAM,UAAU,GAAG,UAAU,CAAC;AAC9B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAAe,EACf,aAAqB,EACrB,UAAgF,EAAE;IAElF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,IAAI,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC;IAC5C,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,OAAO,KAAK,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,MAAM,+BAA+B,CAAC,KAAK,EAAE;YACvD,WAAW,EAAE,aAAa;YAC1B,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,GAAG;YACf,mBAAmB,EAAE,YAAY;SAClC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAqB,CAAC;QAC7D,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC3F,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,CAAC,qBAAqB,GAAG,SAAS;gBAAE,SAAS,GAAG,CAAC,CAAC,qBAAqB,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe;YAAE,MAAM;QAC5C,IAAI,SAAS,IAAI,KAAK;YAAE,MAAM;QAC9B,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/coinset/pagination.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AAiBxF,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAAe,EACf,aAAqB,EACrB,UAAgF,EAAE;IAElF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,IAAI,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;IAC9B,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,GAAG;YAAE,MAAM;QACnE,MAAM,OAAO,GAA+B;YAC1C,WAAW,EAAE,aAAa;YAC1B,mBAAmB,EAAE,YAAY;SAClC,CAAC;QACF,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,YAAY,GAAG,KAAK,CAAC;QACtD,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,+BAA+B,CAAC,KAAK,EAAE,OAA4B,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAqB,CAAC;QAC7D,IAAI,SAAS,GAAG,KAAK,IAAI,CAAC,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC3F,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,CAAC,qBAAqB,GAAG,SAAS;gBAAE,SAAS,GAAG,CAAC,CAAC,qBAAqB,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe;YAAE,MAAM;QAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,SAAS,IAAI,KAAK;YAAE,MAAM;QACrD,KAAK,GAAG,SAAS,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/schemas/price.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const currenciesSchema: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+export declare const mojoAmountSchema: z.ZodString;

package/dist/schemas/price.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const currenciesSchema = z
+    .array(z
+    .string()
+    .min(2)
+    .max(10)
+    .regex(/^[a-zA-Z]+$/))
+    .min(1)
+    .max(20)
+    .default(['usd'])
+    .describe("Fiat or crypto currency codes accepted by CoinGecko (e.g. 'usd', 'eur', 'gbp', 'jpy', 'btc', 'eth'). Case-insensitive. Defaults to ['usd'].");
+export const mojoAmountSchema = z
+    .string()
+    .regex(/^\d+$/)
+    .describe('Non-negative integer mojo amount as a decimal string. 1 XCH = 1,000,000,000,000 mojo. Convert XCH amounts to mojo before passing.');
+//# sourceMappingURL=price.js.map

package/dist/schemas/price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"price.js","sourceRoot":"","sources":["../../src/schemas/price.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,KAAK,CACJ,CAAC;KACE,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,aAAa,CAAC,CACxB;KACA,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;KAChB,QAAQ,CACP,6IAA6I,CAC9I,CAAC;AAEJ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,KAAK,CAAC,OAAO,CAAC;KACd,QAAQ,CACP,mIAAmI,CACpI,CAAC"}

package/dist/server.js

@@ -12,15 +12,19 @@ import { register as registerGetCoinByName } from './tools/coins/get-coin-by-nam
 import { register as registerCalculateCoinName } from './tools/coins/calculate-coin-name.js';
 import { register as registerAddressToPuzzleHash } from './tools/addresses/address-to-puzzle-hash.js';
 import { register as registerPuzzleHashToAddress } from './tools/addresses/puzzle-hash-to-address.js';
+import { register as registerGetXchPrice } from './tools/price/get-xch-price.js';
+import { register as registerConvertXchToFiat } from './tools/price/convert-xch-to-fiat.js';
 import { register as registerNetworkStatusPrompt } from './prompts/network-status.js';
 import { register as registerAddressSummaryPrompt } from './prompts/address-summary.js';
 import { register as registerBlockSummaryPrompt } from './prompts/block-summary.js';
 export function createServer() {
     const server = new McpServer({ name: 'chia-explorer', version: VERSION }, {
-        instructions: 'chia-explorer answers questions about the Chia blockchain via the public coinset.org API. ' +
+        instructions: 'chia-explorer answers questions about the Chia blockchain via the public coinset.org API, ' +
+            'plus XCH spot price and fiat conversion via the public CoinGecko API. ' +
             'Read-only: no signing, no key material, no push_tx. ' +
-            "All tools accept an optional `network: 'mainnet' | 'testnet11'` argument; mainnet is the default. " +
-            'When an address is provided, the network is auto-detected from the prefix (xch / txch).',
+            "Blockchain tools accept an optional `network: 'mainnet' | 'testnet11'` argument; mainnet is the default. " +
+            'When an address is provided, the network is auto-detected from the prefix (xch / txch). ' +
+            'Price tools take no network argument.',
     });
     registerGetBlockchainState(server);
     registerGetNetspace(server);
@@ -34,6 +38,8 @@ export function createServer() {
     registerCalculateCoinName(server);
     registerAddressToPuzzleHash(server);
     registerPuzzleHashToAddress(server);
+    registerGetXchPrice(server);
+    registerConvertXchToFiat(server);
     registerNetworkStatusPrompt(server);
     registerAddressSummaryPrompt(server);
     registerBlockSummaryPrompt(server);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACpG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACjG,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAE5G,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,QAAQ,IAAI,kCAAkC,EAAE,MAAM,kDAAkD,CAAC;AAClH,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAE7F,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AACtG,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAEtG,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAC3C;QACE,YAAY,EACV,4FAA4F;YAC5F,sDAAsD;YACtD,oGAAoG;YACpG,yFAAyF;KAC5F,CACF,CAAC;IAEF,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAEvC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC3C,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACpG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACjG,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,OAAO,EAAE,QAAQ,IAAI,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAE5G,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,QAAQ,IAAI,kCAAkC,EAAE,MAAM,kDAAkD,CAAC;AAClH,OAAO,EAAE,QAAQ,IAAI,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAE7F,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AACtG,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAEtG,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAE5F,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,QAAQ,IAAI,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,QAAQ,IAAI,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAC3C;QACE,YAAY,EACV,4FAA4F;YAC5F,wEAAwE;YACxE,sDAAsD;YACtD,2GAA2G;YAC3G,0FAA0F;YAC1F,uCAAuC;KAC1C,CACF,CAAC;IAEF,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,8BAA8B,CAAC,MAAM,CAAC,CAAC;IAEvC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,kCAAkC,CAAC,MAAM,CAAC,CAAC;IAC3C,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAElC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEpC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEjC,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,4BAA4B,CAAC,MAAM,CAAC,CAAC;IACrC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/price/convert-xch-to-fiat.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/price/convert-xch-to-fiat.js

@@ -0,0 +1,42 @@
+import { getXchPrices } from '../../coingecko/index.js';
+import { mojoToXch, toBigInt } from '../../chia/amounts.js';
+import { currenciesSchema, mojoAmountSchema } from '../../schemas/price.js';
+import { errorText, jsonText } from '../shared/response.js';
+function normalize(currencies) {
+    return Array.from(new Set(currencies.map((c) => c.toLowerCase())));
+}
+export function register(server) {
+    server.tool('convert_xch_to_fiat', 'Convert a mojo amount to its current fiat (or other CoinGecko-supported currency) value. 1 XCH = 1,000,000,000,000 mojo — convert XCH to mojo before calling. Prices come from CoinGecko (cached 60s). Returned values use JS floating-point; precise to far more decimals than any realistic balance.', {
+        mojo: mojoAmountSchema,
+        currencies: currenciesSchema,
+    }, async ({ mojo, currencies }) => {
+        try {
+            const mojoBig = toBigInt(mojo);
+            if (mojoBig < 0n)
+                throw new Error('mojo must be non-negative');
+            const xchString = mojoToXch(mojoBig);
+            const xchNumber = Number(xchString);
+            const normalized = normalize(currencies);
+            const prices = await getXchPrices(normalized);
+            const values = {};
+            for (const currency of normalized) {
+                const price = prices[currency];
+                if (price === undefined)
+                    throw new Error(`missing price for ${currency}`);
+                values[currency] = xchNumber * price;
+            }
+            return jsonText({
+                source: 'coingecko',
+                mojo: mojoBig.toString(),
+                amount_xch: xchString,
+                prices_per_xch: prices,
+                values,
+                fetched_at: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=convert-xch-to-fiat.js.map

package/dist/tools/price/convert-xch-to-fiat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-xch-to-fiat.js","sourceRoot":"","sources":["../../../src/tools/price/convert-xch-to-fiat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,SAAS,SAAS,CAAC,UAAoB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,wSAAwS,EACxS;QACE,IAAI,EAAE,gBAAgB;QACtB,UAAU,EAAE,gBAAgB;KAC7B,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,OAAO,GAAG,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YAEpC,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;YAE9C,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAClC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC/B,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;gBAC1E,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC;YACvC,CAAC;YAED,OAAO,QAAQ,CAAC;gBACd,MAAM,EAAE,WAAW;gBACnB,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE;gBACxB,UAAU,EAAE,SAAS;gBACrB,cAAc,EAAE,MAAM;gBACtB,MAAM;gBACN,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/price/get-xch-price.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/price/get-xch-price.js

@@ -0,0 +1,26 @@
+import { getXchPrices } from '../../coingecko/index.js';
+import { currenciesSchema } from '../../schemas/price.js';
+import { errorText, jsonText } from '../shared/response.js';
+function normalize(currencies) {
+    return Array.from(new Set(currencies.map((c) => c.toLowerCase())));
+}
+export function register(server) {
+    server.tool('get_xch_price', "Current XCH spot price via CoinGecko. Accepts any currency CoinGecko supports (e.g. 'usd', 'eur', 'gbp', 'jpy', 'btc', 'eth'); defaults to ['usd']. Free-tier API is rate-limited; results are cached for 60 seconds.", {
+        currencies: currenciesSchema,
+    }, async ({ currencies }) => {
+        try {
+            const normalized = normalize(currencies);
+            const prices = await getXchPrices(normalized);
+            return jsonText({
+                source: 'coingecko',
+                asset: 'chia',
+                prices,
+                fetched_at: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-xch-price.js.map

package/dist/tools/price/get-xch-price.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-xch-price.js","sourceRoot":"","sources":["../../../src/tools/price/get-xch-price.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,SAAS,SAAS,CAAC,UAAoB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,eAAe,EACf,uNAAuN,EACvN;QACE,UAAU,EAAE,gBAAgB;KAC7B,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;YAC9C,OAAO,QAAQ,CAAC;gBACd,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,MAAM;gBACb,MAAM;gBACN,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chia-explorer",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "MCP server that answers questions about the Chia blockchain via the public coinset.org API",
   "mcpName": "io.github.Spacetime-Technology/chia-explorer",
   "type": "module",