chia-explorer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spacetime Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# chia-explorer
+
+MCP server that answers questions about the Chia blockchain. Read-only, no keys, no signing.
+
+Backed by the public [coinset.org](https://www.coinset.org) full-node API. Supports mainnet (default) and testnet11. Auto-detects network from `xch` or `txch` address prefixes.
+
+## What it can answer
+
+- What is the current netspace? Peak height? Sync status?
+- What is the header hash of block N? How many transactions in that block?
+- 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.
+
+## Install
+
+```bash
+npm install -g chia-explorer
+```
+
+Or run via `npx`:
+
+```bash
+npx chia-explorer
+```
+
+## Use with Claude Code
+
+```bash
+claude mcp add chia-explorer -- npx chia-explorer
+```
+
+## Use with Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "chia-explorer": {
+      "command": "npx",
+      "args": ["chia-explorer"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `get_blockchain_state` | Peak height, netspace (EiB), difficulty, sync status |
+| `get_netspace` | Just the netspace in bytes, EiB, and PiB |
+| `get_peak_height` | Just the peak height |
+| `get_block_by_height` | Block record + header hash for a height |
+| `get_block_by_hash` | Block record for a header hash |
+| `count_block_transactions` | Coin spends, additions, removals counts for a block |
+| `get_balance` | Balance of an address or puzzle hash (paginated, unspent coins) |
+| `get_coin_records_by_puzzle_hash` | Raw coin records for a puzzle hash or address |
+| `get_coin_by_name` | Coin record by coin name |
+| `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 |
+
+All tools take an optional `network: "mainnet" | "testnet11"` (default `mainnet`).
+
+## Prompts
+
+- `network_status` — quick snapshot of current chain state
+- `address_summary` — balance and recent activity for an address
+- `block_summary` — block details plus transaction counts
+
+## What it isn't
+
+- A wallet. No private keys, no signing, no `push_tx`.
+- A full node. Talks to public coinset.org RPC.
+- A mempool watcher. Snapshot data only.
+
+## License
+
+MIT

package/dist/chia/amounts.d.ts

@@ -0,0 +1,11 @@
+export declare const MOJOS_PER_XCH = 1000000000000n;
+export declare function toBigInt(v: bigint | number | string): bigint;
+export declare function mojoToXch(mojo: bigint | number | string): string;
+export interface NetspaceFormat {
+    bytes: string;
+    eib: string;
+    pib: string;
+    tib: string;
+    human: string;
+}
+export declare function formatNetspace(bytes: bigint | number | string): NetspaceFormat;

package/dist/chia/amounts.js

@@ -0,0 +1,52 @@
+export const MOJOS_PER_XCH = 1000000000000n;
+export function toBigInt(v) {
+    if (typeof v === 'bigint')
+        return v;
+    if (typeof v === 'number') {
+        if (!Number.isInteger(v))
+            throw new Error(`expected integer, got ${v}`);
+        return BigInt(v);
+    }
+    return BigInt(v);
+}
+export function mojoToXch(mojo) {
+    const v = toBigInt(mojo);
+    const neg = v < 0n;
+    const abs = neg ? -v : v;
+    const whole = abs / MOJOS_PER_XCH;
+    const frac = abs % MOJOS_PER_XCH;
+    if (frac === 0n)
+        return `${neg ? '-' : ''}${whole.toString()}`;
+    let fracStr = frac.toString().padStart(12, '0').replace(/0+$/, '');
+    if (fracStr === '')
+        fracStr = '0';
+    return `${neg ? '-' : ''}${whole.toString()}.${fracStr}`;
+}
+const EIB = 2n ** 60n;
+const PIB = 2n ** 50n;
+const TIB = 2n ** 40n;
+function bigIntDivToDecimal(num, denom, decimals) {
+    if (denom === 0n)
+        throw new Error('division by zero');
+    const scale = 10n ** BigInt(decimals);
+    const scaled = (num * scale) / denom;
+    const whole = scaled / scale;
+    const frac = scaled % scale;
+    const fracStr = frac.toString().padStart(decimals, '0').replace(/0+$/, '');
+    return fracStr === '' ? whole.toString() : `${whole.toString()}.${fracStr}`;
+}
+export function formatNetspace(bytes) {
+    const v = toBigInt(bytes);
+    const eib = bigIntDivToDecimal(v, EIB, 3);
+    const pib = bigIntDivToDecimal(v, PIB, 3);
+    const tib = bigIntDivToDecimal(v, TIB, 3);
+    let human;
+    if (v >= EIB)
+        human = `${eib} EiB`;
+    else if (v >= PIB)
+        human = `${pib} PiB`;
+    else
+        human = `${tib} TiB`;
+    return { bytes: v.toString(), eib, pib, tib, human };
+}
+//# sourceMappingURL=amounts.js.map

package/dist/chia/amounts.js.map

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

package/dist/chia/bech32.d.ts

@@ -0,0 +1,8 @@
+import { Network } from '../network.js';
+export declare function puzzleHashToAddress(puzzleHashHex: string, network: Network): string;
+export interface DecodedAddress {
+    puzzleHash: string;
+    network: Network;
+}
+export declare function addressToPuzzleHash(address: string): DecodedAddress;
+export declare function looksLikeAddress(s: string): boolean;

package/dist/chia/bech32.js

@@ -0,0 +1,31 @@
+import { bech32m } from '@scure/base';
+import { ADDRESS_PREFIX, networkFromPrefix } from '../network.js';
+import { bytesToHex, hexToBytes } from './hex.js';
+export function puzzleHashToAddress(puzzleHashHex, network) {
+    const ph = hexToBytes(puzzleHashHex);
+    if (ph.length !== 32)
+        throw new Error('puzzle hash must be 32 bytes');
+    return bech32m.encode(ADDRESS_PREFIX[network], bech32m.toWords(ph));
+}
+export function addressToPuzzleHash(address) {
+    let decoded;
+    try {
+        decoded = bech32m.decode(address);
+    }
+    catch (err) {
+        throw new Error(`invalid bech32m address: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    const network = networkFromPrefix(decoded.prefix);
+    if (!network) {
+        throw new Error(`unknown address prefix '${decoded.prefix}' — expected 'xch' (mainnet) or 'txch' (testnet11)`);
+    }
+    const bytes = bech32m.fromWords(decoded.words);
+    if (bytes.length !== 32) {
+        throw new Error(`decoded payload must be 32 bytes, got ${bytes.length}`);
+    }
+    return { puzzleHash: bytesToHex(bytes), network };
+}
+export function looksLikeAddress(s) {
+    return /^(xch|txch)1[02-9ac-hj-np-z]+$/i.test(s);
+}
+//# sourceMappingURL=bech32.js.map

package/dist/chia/bech32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bech32.js","sourceRoot":"","sources":["../../src/chia/bech32.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,cAAc,EAAW,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,UAAU,mBAAmB,CAAC,aAAqB,EAAE,OAAgB;IACzE,MAAM,EAAE,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC;AAOD,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,OAAgC,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC9E,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,CAAC,MAAM,oDAAoD,CAC9F,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/chia/coin-name.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Big-endian minimal-length two's-complement encoding of a non-negative bigint,
+ * matching Chia's int_to_bytes serialization used in coin name calculation.
+ *
+ * Why: coin name = sha256(parent_coin_info || puzzle_hash || amount_bytes) where
+ * amount_bytes follows Python's int.to_bytes(signed=True) with the minimum length
+ * needed. Off-by-one here produces wrong coin names.
+ */
+export declare function bigIntToBytes(n: bigint): Uint8Array;
+export interface CoinFields {
+    parent_coin_info: string;
+    puzzle_hash: string;
+    amount: bigint | number | string;
+}
+export declare function coinName(coin: CoinFields): string;

package/dist/chia/coin-name.js

@@ -0,0 +1,40 @@
+import { createHash } from 'node:crypto';
+import { bytesToHex, hexToBytes } from './hex.js';
+/**
+ * Big-endian minimal-length two's-complement encoding of a non-negative bigint,
+ * matching Chia's int_to_bytes serialization used in coin name calculation.
+ *
+ * Why: coin name = sha256(parent_coin_info || puzzle_hash || amount_bytes) where
+ * amount_bytes follows Python's int.to_bytes(signed=True) with the minimum length
+ * needed. Off-by-one here produces wrong coin names.
+ */
+export function bigIntToBytes(n) {
+    if (n < 0n)
+        throw new Error('coin amount must be non-negative');
+    if (n === 0n)
+        return new Uint8Array(0);
+    const buf = [];
+    let v = n;
+    while (v > 0n) {
+        buf.unshift(Number(v & 0xffn));
+        v >>= 8n;
+    }
+    if ((buf[0] ?? 0) & 0x80)
+        buf.unshift(0);
+    return Uint8Array.from(buf);
+}
+export function coinName(coin) {
+    const parent = hexToBytes(coin.parent_coin_info);
+    const ph = hexToBytes(coin.puzzle_hash);
+    if (parent.length !== 32)
+        throw new Error('parent_coin_info must be 32 bytes');
+    if (ph.length !== 32)
+        throw new Error('puzzle_hash must be 32 bytes');
+    const amount = bigIntToBytes(BigInt(coin.amount));
+    const hash = createHash('sha256');
+    hash.update(parent);
+    hash.update(ph);
+    hash.update(amount);
+    return bytesToHex(new Uint8Array(hash.digest()));
+}
+//# sourceMappingURL=coin-name.js.map

package/dist/chia/coin-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coin-name.js","sourceRoot":"","sources":["../../src/chia/coin-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QACd,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAC/B,CAAC,KAAK,EAAE,CAAC;IACX,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;QAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAQD,MAAM,UAAU,QAAQ,CAAC,IAAgB;IACvC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC/E,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/chia/hex.d.ts

@@ -0,0 +1,4 @@
+export declare function stripHexPrefix(s: string): string;
+export declare function hexToBytes(hex: string): Uint8Array;
+export declare function bytesToHex(bytes: Uint8Array): string;
+export declare function isHex32(s: string): boolean;

package/dist/chia/hex.js

@@ -0,0 +1,26 @@
+export function stripHexPrefix(s) {
+    return s.startsWith('0x') || s.startsWith('0X') ? s.slice(2) : s;
+}
+export function hexToBytes(hex) {
+    const stripped = stripHexPrefix(hex);
+    if (stripped.length % 2 !== 0)
+        throw new Error('hex string has odd length');
+    if (!/^[0-9a-fA-F]*$/.test(stripped))
+        throw new Error('hex string contains non-hex characters');
+    const out = new Uint8Array(stripped.length / 2);
+    for (let i = 0; i < out.length; i++) {
+        out[i] = parseInt(stripped.slice(i * 2, i * 2 + 2), 16);
+    }
+    return out;
+}
+export function bytesToHex(bytes) {
+    let s = '';
+    for (const b of bytes)
+        s += b.toString(16).padStart(2, '0');
+    return s;
+}
+export function isHex32(s) {
+    const stripped = stripHexPrefix(s);
+    return stripped.length === 64 && /^[0-9a-fA-F]+$/.test(stripped);
+}
+//# sourceMappingURL=hex.js.map

package/dist/chia/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../src/chia/hex.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC5E,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAChG,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAiB;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,CAAS;IAC/B,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC,MAAM,KAAK,EAAE,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACnE,CAAC"}

package/dist/coinset/agent.d.ts

@@ -0,0 +1,7 @@
+import { RPCAgent } from 'chia-agent';
+import { Network } from '../network.js';
+export declare function getAgent(network: Network): RPCAgent;
+/** Test-only hook to inject a stub agent. */
+export declare function setAgent(network: Network, agent: RPCAgent): void;
+/** Test-only hook to clear cached agents. */
+export declare function resetAgents(): void;

package/dist/coinset/agent.js

@@ -0,0 +1,26 @@
+import { RPCAgent } from 'chia-agent';
+import { COINSET_HOST } from '../network.js';
+const cache = new Map();
+export function getAgent(network) {
+    let agent = cache.get(network);
+    if (!agent) {
+        agent = new RPCAgent({
+            protocol: 'https',
+            host: COINSET_HOST[network],
+            port: 443,
+            keepAlive: true,
+            timeout: 30_000,
+        });
+        cache.set(network, agent);
+    }
+    return agent;
+}
+/** Test-only hook to inject a stub agent. */
+export function setAgent(network, agent) {
+    cache.set(network, agent);
+}
+/** Test-only hook to clear cached agents. */
+export function resetAgents() {
+    cache.clear();
+}
+//# sourceMappingURL=agent.js.map

package/dist/coinset/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/coinset/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAW,MAAM,eAAe,CAAC;AAEtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE3C,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,QAAQ,CAAC;YACnB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC;YAC3B,IAAI,EAAE,GAAG;YACT,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,QAAQ,CAAC,OAAgB,EAAE,KAAe;IACxD,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW;IACzB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/coinset/pagination.d.ts

@@ -0,0 +1,24 @@
+import { RPCAgent } from 'chia-agent';
+export interface CoinRecordLike {
+    coin: {
+        parent_coin_info: string;
+        puzzle_hash: string;
+        amount: bigint | number | string;
+    };
+    confirmed_block_index: number;
+    spent_block_index: number;
+    coinbase: boolean;
+    timestamp: bigint | number;
+    spent?: boolean;
+}
+/**
+ * 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.
+ */
+export declare function fetchCoinRecordsByPuzzleHash(agent: RPCAgent, puzzleHashHex: string, options?: {
+    includeSpent?: boolean;
+    startHeight?: number;
+    endHeight?: number;
+}): Promise<CoinRecordLike[]>;

package/dist/coinset/pagination.js

@@ -0,0 +1,42 @@
+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.
+ */
+export async function fetchCoinRecordsByPuzzleHash(agent, puzzleHashHex, options = {}) {
+    const includeSpent = options.includeSpent ?? false;
+    let start = options.startHeight ?? 0;
+    const end = options.endHeight ?? MAX_HEIGHT;
+    const all = [];
+    const seen = new Set();
+    while (start <= end) {
+        const res = await get_coin_records_by_puzzle_hash(agent, {
+            puzzle_hash: puzzleHashHex,
+            start_height: start,
+            end_height: end,
+            include_spent_coins: includeSpent,
+        });
+        const records = (res.coin_records ?? []);
+        let maxHeight = start;
+        for (const r of records) {
+            const key = `${r.coin.parent_coin_info}|${r.coin.puzzle_hash}|${r.coin.amount.toString()}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            all.push(r);
+            if (r.confirmed_block_index > maxHeight)
+                maxHeight = r.confirmed_block_index;
+        }
+        if (records.length < PAGE_SIZE_LIMIT)
+            break;
+        if (maxHeight <= start)
+            break;
+        start = maxHeight + 1;
+    }
+    return all;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/coinset/pagination.js.map

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+const shutdown = () => {
+    void server.close().then(() => process.exit(0));
+};
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,MAAM,QAAQ,GAAG,GAAS,EAAE;IAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC"}

package/dist/network.d.ts

@@ -0,0 +1,6 @@
+export type Network = 'mainnet' | 'testnet11';
+export declare const NETWORKS: readonly Network[];
+export declare const DEFAULT_NETWORK: Network;
+export declare const COINSET_HOST: Record<Network, string>;
+export declare const ADDRESS_PREFIX: Record<Network, string>;
+export declare function networkFromPrefix(hrp: string): Network | null;

package/dist/network.js

@@ -0,0 +1,18 @@
+export const NETWORKS = ['mainnet', 'testnet11'];
+export const DEFAULT_NETWORK = 'mainnet';
+export const COINSET_HOST = {
+    mainnet: 'api.coinset.org',
+    testnet11: 'api-testnet11.coinset.org',
+};
+export const ADDRESS_PREFIX = {
+    mainnet: 'xch',
+    testnet11: 'txch',
+};
+export function networkFromPrefix(hrp) {
+    if (hrp === 'xch')
+        return 'mainnet';
+    if (hrp === 'txch')
+        return 'testnet11';
+    return null;
+}
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAuB,CAAC,SAAS,EAAE,WAAW,CAAU,CAAC;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAY,SAAS,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,OAAO,EAAE,iBAAiB;IAC1B,SAAS,EAAE,2BAA2B;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,MAAM;CAClB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/prompts/address-summary.d.ts

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

package/dist/prompts/address-summary.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export function register(server) {
+    server.registerPrompt('address_summary', {
+        title: 'Chia address summary',
+        description: 'Balance and recent activity for a Chia address or puzzle hash.',
+        argsSchema: {
+            address: z.string().describe('An xch/txch bech32m address OR a 32-byte hex puzzle hash.'),
+            network: z
+                .enum(['mainnet', 'testnet11'])
+                .optional()
+                .describe('Override network. Auto-detected from address prefix when omitted.'),
+        },
+    }, ({ address, network }) => {
+        const lines = [
+            `Summarise the address ${address} on the Chia blockchain.`,
+            ``,
+            `Steps:`,
+            `1. If the input looks like a bech32m address (starts with xch1 or txch1), call \`address_to_puzzle_hash\` to confirm the puzzle hash and detected network. If it is a hex puzzle hash, call \`puzzle_hash_to_address\` with the appropriate network to produce the address.`,
+            `2. Call \`get_balance\` with \`address_or_puzzle_hash: "${address}"\`${network ? ` and \`network: "${network}"\`` : ''}.`,
+            `3. Call \`get_coin_records_by_puzzle_hash\` with the same input, \`include_spent_coins: false\`, to fetch unspent coins. If the count is large, show only the 10 highest-value coins.`,
+            `4. Present:`,
+            `   - Network and address (canonical form).`,
+            `   - Puzzle hash.`,
+            `   - Balance in XCH and mojos.`,
+            `   - Number of unspent coins.`,
+            `   - Top coins by amount (coin amount in XCH, confirmed_block_index).`,
+            `5. Keep the summary short. Use plain prose, no tables unless the user asks.`,
+        ];
+        return {
+            messages: [{ role: 'user', content: { type: 'text', text: lines.join('\n') } }],
+        };
+    });
+}
+//# sourceMappingURL=address-summary.js.map

package/dist/prompts/address-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-summary.js","sourceRoot":"","sources":["../../src/prompts/address-summary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gEAAgE;QAC7E,UAAU,EAAE;YACV,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;YACzF,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;SACjF;KACF,EACD,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QACvB,MAAM,KAAK,GAAG;YACZ,yBAAyB,OAAO,0BAA0B;YAC1D,EAAE;YACF,QAAQ;YACR,6QAA6Q;YAC7Q,2DAA2D,OAAO,MAAM,OAAO,CAAC,CAAC,CAAC,oBAAoB,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG;YAC1H,uLAAuL;YACvL,aAAa;YACb,4CAA4C;YAC5C,mBAAmB;YACnB,gCAAgC;YAChC,+BAA+B;YAC/B,uEAAuE;YACvE,6EAA6E;SAC9E,CAAC;QACF,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;SAChF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/block-summary.d.ts

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

package/dist/prompts/block-summary.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export function register(server) {
+    server.registerPrompt('block_summary', {
+        title: 'Chia block summary',
+        description: 'Block details plus transaction counts, by height or header hash.',
+        argsSchema: {
+            height: z
+                .string()
+                .optional()
+                .describe('Block height (as a string — MCP prompt args are strings).'),
+            header_hash: z
+                .string()
+                .optional()
+                .describe('Block header hash (32-byte hex, optional 0x prefix).'),
+            network: z
+                .enum(['mainnet', 'testnet11'])
+                .optional()
+                .describe('Network. Defaults to mainnet.'),
+        },
+    }, ({ height, header_hash, network }) => {
+        const net = network ?? 'mainnet';
+        const lookupCall = header_hash
+            ? `\`get_block_by_hash\` with \`header_hash: "${header_hash}"\` and \`network: "${net}"\``
+            : height !== undefined
+                ? `\`get_block_by_height\` with \`height: ${height}\` and \`network: "${net}"\``
+                : `either \`get_block_by_height\` (if a height is supplied) or \`get_block_by_hash\` (if a header hash is supplied)`;
+        const countCall = header_hash
+            ? `\`count_block_transactions\` with \`header_hash: "${header_hash}"\` and \`network: "${net}"\``
+            : height !== undefined
+                ? `\`count_block_transactions\` with \`height: ${height}\` and \`network: "${net}"\``
+                : `\`count_block_transactions\` with the matching identifier and \`network: "${net}"\``;
+        const text = [
+            `Summarise the Chia ${net} block.`,
+            ``,
+            `Steps:`,
+            `1. Fetch the block record via ${lookupCall}.`,
+            `2. Fetch transaction counts via ${countCall}.`,
+            `3. Present:`,
+            `   - Height and header hash (and previous hash).`,
+            `   - Timestamp (UTC). If null, note that this is not a transaction block.`,
+            `   - is_transaction_block.`,
+            `   - coin_spends_count, additions_count, removals_count.`,
+            `4. Keep it short.`,
+        ].join('\n');
+        return {
+            messages: [{ role: 'user', content: { type: 'text', text } }],
+        };
+    });
+}
+//# sourceMappingURL=block-summary.js.map

package/dist/prompts/block-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-summary.js","sourceRoot":"","sources":["../../src/prompts/block-summary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,kEAAkE;QAC/E,UAAU,EAAE;YACV,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,2DAA2D,CAAC;YACxE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;YACnE,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CAAC,+BAA+B,CAAC;SAC7C;KACF,EACD,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,OAAO,IAAI,SAAS,CAAC;QACjC,MAAM,UAAU,GAAG,WAAW;YAC5B,CAAC,CAAC,8CAA8C,WAAW,uBAAuB,GAAG,KAAK;YAC1F,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,0CAA0C,MAAM,sBAAsB,GAAG,KAAK;gBAChF,CAAC,CAAC,kHAAkH,CAAC;QAEzH,MAAM,SAAS,GAAG,WAAW;YAC3B,CAAC,CAAC,qDAAqD,WAAW,uBAAuB,GAAG,KAAK;YACjG,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,+CAA+C,MAAM,sBAAsB,GAAG,KAAK;gBACrF,CAAC,CAAC,6EAA6E,GAAG,KAAK,CAAC;QAE5F,MAAM,IAAI,GAAG;YACX,sBAAsB,GAAG,SAAS;YAClC,EAAE;YACF,QAAQ;YACR,iCAAiC,UAAU,GAAG;YAC9C,mCAAmC,SAAS,GAAG;YAC/C,aAAa;YACb,kDAAkD;YAClD,2EAA2E;YAC3E,4BAA4B;YAC5B,0DAA0D;YAC1D,mBAAmB;SACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;SAC9D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/prompts/network-status.d.ts

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

package/dist/prompts/network-status.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export function register(server) {
+    server.registerPrompt('network_status', {
+        title: 'Chia network status',
+        description: 'Summarise the current state of the Chia blockchain: peak height, netspace, sync, difficulty.',
+        argsSchema: {
+            network: z
+                .enum(['mainnet', 'testnet11'])
+                .optional()
+                .describe('Network to query. Defaults to mainnet.'),
+        },
+    }, ({ network }) => {
+        const net = network ?? 'mainnet';
+        const text = `Summarise the current state of the Chia ${net} blockchain.\n\n` +
+            `Steps:\n` +
+            `1. Call \`get_blockchain_state\` with \`network: "${net}"\`.\n` +
+            `2. From the response present, in this order:\n` +
+            `   - Peak height and the time of that block (timestamp, as UTC).\n` +
+            `   - Netspace in EiB (use \`space_eib\` plus a "PiB" fallback if it is less than 1 EiB).\n` +
+            `   - Difficulty and sub_slot_iters.\n` +
+            `   - Sync status: synced yes/no, plus sync_tip_height and sync_progress_height if not synced.\n` +
+            `   - Mempool size and cost.\n` +
+            `3. Keep the summary short and scannable. One short line per item.`;
+        return {
+            messages: [{ role: 'user', content: { type: 'text', text } }],
+        };
+    });
+}
+//# sourceMappingURL=network-status.js.map

package/dist/prompts/network-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-status.js","sourceRoot":"","sources":["../../src/prompts/network-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,cAAc,CACnB,gBAAgB,EAChB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,8FAA8F;QAChG,UAAU,EAAE;YACV,OAAO,EAAE,CAAC;iBACP,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;iBAC9B,QAAQ,EAAE;iBACV,QAAQ,CAAC,wCAAwC,CAAC;SACtD;KACF,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;QACd,MAAM,GAAG,GAAG,OAAO,IAAI,SAAS,CAAC;QACjC,MAAM,IAAI,GACR,2CAA2C,GAAG,kBAAkB;YAChE,UAAU;YACV,qDAAqD,GAAG,QAAQ;YAChE,gDAAgD;YAChD,oEAAoE;YACpE,4FAA4F;YAC5F,uCAAuC;YACvC,iGAAiG;YACjG,+BAA+B;YAC/B,mEAAmE,CAAC;QACtE,OAAO;YACL,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;SAC9D,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}