chia-explorer 0.1.0

package/dist/schemas/common.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const networkSchema: z.ZodDefault<z.ZodEnum<[string, ...string[]]>>;
+export declare const networkSchemaOptional: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+export declare const hex32Schema: z.ZodString;
+export declare const addressSchema: z.ZodString;
+export declare const addressOrPuzzleHashSchema: z.ZodString;
+export declare const heightSchema: z.ZodNumber;

package/dist/schemas/common.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { DEFAULT_NETWORK, NETWORKS } from '../network.js';
+export const networkSchema = z
+    .enum(NETWORKS)
+    .default(DEFAULT_NETWORK)
+    .describe("Chia network: 'mainnet' (default) or 'testnet11'");
+export const networkSchemaOptional = z
+    .enum(NETWORKS)
+    .optional()
+    .describe("Chia network: 'mainnet' or 'testnet11'. Optional — auto-detected from address prefix when an address is supplied.");
+const HEX32_REGEX = /^(0x)?[0-9a-fA-F]{64}$/;
+const ADDRESS_REGEX = /^(xch|txch)1[02-9ac-hj-np-z]{6,}$/i;
+export const hex32Schema = z
+    .string()
+    .regex(HEX32_REGEX, '32-byte hex string (64 hex chars, optional 0x prefix)');
+export const addressSchema = z
+    .string()
+    .regex(ADDRESS_REGEX, "bech32m address starting with 'xch1' or 'txch1'");
+export const addressOrPuzzleHashSchema = z
+    .string()
+    .min(1)
+    .describe('An xch/txch bech32m address OR a 32-byte hex puzzle hash (optional 0x prefix)');
+export const heightSchema = z.number().int().nonnegative().describe('Block height');
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,IAAI,CAAC,QAA4C,CAAC;KAClD,OAAO,CAAC,eAAe,CAAC;KACxB,QAAQ,CAAC,kDAAkD,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,IAAI,CAAC,QAA4C,CAAC;KAClD,QAAQ,EAAE;KACV,QAAQ,CACP,mHAAmH,CACpH,CAAC;AAEJ,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAC7C,MAAM,aAAa,GAAG,oCAAoC,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,KAAK,CAAC,WAAW,EAAE,uDAAuD,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,EAAE;KACR,KAAK,CAAC,aAAa,EAAE,iDAAiD,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,+EAA+E,CAAC,CAAC;AAE7F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC"}

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,42 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { VERSION } from './version.js';
+import { register as registerGetBlockchainState } from './tools/blockchain/get-blockchain-state.js';
+import { register as registerGetNetspace } from './tools/blockchain/get-netspace.js';
+import { register as registerGetPeakHeight } from './tools/blockchain/get-peak-height.js';
+import { register as registerGetBlockByHeight } from './tools/blockchain/get-block-by-height.js';
+import { register as registerGetBlockByHash } from './tools/blockchain/get-block-by-hash.js';
+import { register as registerCountBlockTransactions } from './tools/blockchain/count-block-transactions.js';
+import { register as registerGetBalance } from './tools/coins/get-balance.js';
+import { register as registerGetCoinRecordsByPuzzleHash } from './tools/coins/get-coin-records-by-puzzle-hash.js';
+import { register as registerGetCoinByName } from './tools/coins/get-coin-by-name.js';
+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 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. ' +
+            '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).',
+    });
+    registerGetBlockchainState(server);
+    registerGetNetspace(server);
+    registerGetPeakHeight(server);
+    registerGetBlockByHeight(server);
+    registerGetBlockByHash(server);
+    registerCountBlockTransactions(server);
+    registerGetBalance(server);
+    registerGetCoinRecordsByPuzzleHash(server);
+    registerGetCoinByName(server);
+    registerCalculateCoinName(server);
+    registerAddressToPuzzleHash(server);
+    registerPuzzleHashToAddress(server);
+    registerNetworkStatusPrompt(server);
+    registerAddressSummaryPrompt(server);
+    registerBlockSummaryPrompt(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/addresses/address-to-puzzle-hash.d.ts

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

package/dist/tools/addresses/address-to-puzzle-hash.js

@@ -0,0 +1,21 @@
+import { addressSchema } from '../../schemas/common.js';
+import { addressToPuzzleHash } from '../../chia/bech32.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('address_to_puzzle_hash', 'Decode an xch1/txch1 bech32m address to its 32-byte puzzle hash. Also reports the detected network. Local computation only — no RPC.', {
+        address: addressSchema,
+    }, async ({ address }) => {
+        try {
+            const { puzzleHash, network } = addressToPuzzleHash(address.trim());
+            return jsonText({
+                address: address.trim().toLowerCase(),
+                puzzle_hash: puzzleHash,
+                network,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=address-to-puzzle-hash.js.map

package/dist/tools/addresses/address-to-puzzle-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-to-puzzle-hash.js","sourceRoot":"","sources":["../../../src/tools/addresses/address-to-puzzle-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,sIAAsI,EACtI;QACE,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO,QAAQ,CAAC;gBACd,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,WAAW,EAAE,UAAU;gBACvB,OAAO;aACR,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/addresses/puzzle-hash-to-address.d.ts

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

package/dist/tools/addresses/puzzle-hash-to-address.js

@@ -0,0 +1,24 @@
+import { hex32Schema, networkSchema } from '../../schemas/common.js';
+import { puzzleHashToAddress } from '../../chia/bech32.js';
+import { stripHexPrefix } from '../../chia/hex.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('puzzle_hash_to_address', 'Encode a 32-byte puzzle hash to a bech32m xch/txch address. Use `network` to select mainnet (xch) or testnet11 (txch). Local computation only — no RPC.', {
+        puzzle_hash: hex32Schema,
+        network: networkSchema,
+    }, async ({ puzzle_hash, network }) => {
+        try {
+            const ph = stripHexPrefix(puzzle_hash).toLowerCase();
+            const address = puzzleHashToAddress(ph, network);
+            return jsonText({
+                puzzle_hash: ph,
+                network,
+                address,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=puzzle-hash-to-address.js.map

package/dist/tools/addresses/puzzle-hash-to-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"puzzle-hash-to-address.js","sourceRoot":"","sources":["../../../src/tools/addresses/puzzle-hash-to-address.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,yJAAyJ,EACzJ;QACE,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YACrD,MAAM,OAAO,GAAG,mBAAmB,CAAC,EAAE,EAAE,OAAkB,CAAC,CAAC;YAC5D,OAAO,QAAQ,CAAC;gBACd,WAAW,EAAE,EAAE;gBACf,OAAO;gBACP,OAAO;aACR,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/blockchain/count-block-transactions.d.ts

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

package/dist/tools/blockchain/count-block-transactions.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { get_additions_and_removals, get_block_record_by_height, get_block_spends, } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { hex32Schema, heightSchema, networkSchema } from '../../schemas/common.js';
+import { stripHexPrefix } from '../../chia/hex.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('count_block_transactions', "Count the 'transactions' in a Chia block. Returns coin_spends_count (the canonical analogue), plus additions_count and removals_count. Pass either height OR header_hash.", {
+        height: heightSchema.optional(),
+        header_hash: hex32Schema.optional(),
+        network: networkSchema,
+    }, async ({ height, header_hash, network }) => {
+        try {
+            if (height === undefined && header_hash === undefined) {
+                throw new Error('provide either height or header_hash');
+            }
+            const agent = getAgent(network);
+            let resolvedHash;
+            let resolvedHeight = null;
+            let isTransactionBlock = true;
+            if (header_hash !== undefined) {
+                resolvedHash = stripHexPrefix(header_hash).toLowerCase();
+            }
+            else {
+                const rec = await get_block_record_by_height(agent, { height: height });
+                if (!rec.block_record)
+                    throw new Error(`no block record at height ${height}`);
+                resolvedHash = rec.block_record.header_hash;
+                resolvedHeight = rec.block_record.height;
+                isTransactionBlock = rec.block_record.timestamp != null;
+            }
+            const [spendsRes, addRemRes] = await Promise.all([
+                get_block_spends(agent, { header_hash: resolvedHash }),
+                get_additions_and_removals(agent, { header_hash: resolvedHash }),
+            ]);
+            return jsonText({
+                network,
+                height: resolvedHeight,
+                header_hash: resolvedHash,
+                is_transaction_block: isTransactionBlock,
+                coin_spends_count: spendsRes.block_spends?.length ?? 0,
+                additions_count: addRemRes.additions?.length ?? 0,
+                removals_count: addRemRes.removals?.length ?? 0,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+void z;
+//# sourceMappingURL=count-block-transactions.js.map

package/dist/tools/blockchain/count-block-transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-block-transactions.js","sourceRoot":"","sources":["../../../src/tools/blockchain/count-block-transactions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,GACjB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,2KAA2K,EAC3K;QACE,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE;QAC/B,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;QACnC,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,IAAI,MAAM,KAAK,SAAS,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC1D,CAAC;YACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,IAAI,YAAoB,CAAC;YACzB,IAAI,cAAc,GAAkB,IAAI,CAAC;YACzC,IAAI,kBAAkB,GAAG,IAAI,CAAC;YAC9B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,YAAY,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,MAAM,0BAA0B,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAgB,EAAE,CAAC,CAAC;gBAClF,IAAI,CAAC,GAAG,CAAC,YAAY;oBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAO,EAAE,CAAC,CAAC;gBAC/E,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC;gBAC5C,cAAc,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC;gBACzC,kBAAkB,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,IAAI,IAAI,CAAC;YAC1D,CAAC;YAED,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,gBAAgB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;gBACtD,0BAA0B,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;aACjE,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,MAAM,EAAE,cAAc;gBACtB,WAAW,EAAE,YAAY;gBACzB,oBAAoB,EAAE,kBAAkB;gBACxC,iBAAiB,EAAE,SAAS,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;gBACtD,eAAe,EAAE,SAAS,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;gBACjD,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;aAChD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,KAAK,CAAC,CAAC"}

package/dist/tools/blockchain/get-block-by-hash.d.ts

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

package/dist/tools/blockchain/get-block-by-hash.js

@@ -0,0 +1,27 @@
+import { get_block_record } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { hex32Schema, networkSchema } from '../../schemas/common.js';
+import { stripHexPrefix } from '../../chia/hex.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_block_by_hash', 'Get the block record for a given header hash (32-byte hex, optional 0x prefix).', {
+        header_hash: hex32Schema,
+        network: networkSchema,
+    }, async ({ header_hash, network }) => {
+        try {
+            const agent = getAgent(network);
+            const normalized = stripHexPrefix(header_hash).toLowerCase();
+            const res = await get_block_record(agent, { header_hash: normalized });
+            return jsonText({
+                network,
+                header_hash: normalized,
+                block_record: res.block_record,
+                height: res.block_record?.height ?? null,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-block-by-hash.js.map

package/dist/tools/blockchain/get-block-by-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-block-by-hash.js","sourceRoot":"","sources":["../../../src/tools/blockchain/get-block-by-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,iFAAiF,EACjF;QACE,WAAW,EAAE,WAAW;QACxB,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;YACvE,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,WAAW,EAAE,UAAU;gBACvB,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,IAAI;aACzC,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/blockchain/get-block-by-height.d.ts

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

package/dist/tools/blockchain/get-block-by-height.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { get_block_record_by_height } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { heightSchema, networkSchema } from '../../schemas/common.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_block_by_height', 'Get the block record (including header hash, timestamp and previous hash) for a block at the given height.', {
+        height: heightSchema,
+        network: networkSchema,
+    }, async ({ height, network }) => {
+        try {
+            const agent = getAgent(network);
+            const res = await get_block_record_by_height(agent, { height });
+            return jsonText({
+                network,
+                height,
+                block_record: res.block_record,
+                header_hash: res.block_record?.header_hash ?? null,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+// Silence unused-import warning in some configurations.
+void z;
+//# sourceMappingURL=get-block-by-height.js.map

package/dist/tools/blockchain/get-block-by-height.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-block-by-height.js","sourceRoot":"","sources":["../../../src/tools/blockchain/get-block-by-height.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,4GAA4G,EAC5G;QACE,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,0BAA0B,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,MAAM;gBACN,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,WAAW,IAAI,IAAI;aACnD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,KAAK,CAAC,CAAC"}

package/dist/tools/blockchain/get-blockchain-state.d.ts

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

package/dist/tools/blockchain/get-blockchain-state.js

@@ -0,0 +1,37 @@
+import { get_blockchain_state } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { formatNetspace } from '../../chia/amounts.js';
+import { networkSchema } from '../../schemas/common.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_blockchain_state', 'Get the current Chia blockchain state: peak height, netspace (raw + formatted EiB/PiB), difficulty, mempool stats and sync status. Defaults to mainnet.', { network: networkSchema }, async ({ network }) => {
+        try {
+            const agent = getAgent(network);
+            const res = await get_blockchain_state(agent);
+            const bs = res.blockchain_state;
+            const space = formatNetspace(bs.space);
+            return jsonText({
+                network,
+                peak_height: bs.peak?.height ?? null,
+                peak_header_hash: bs.peak?.header_hash ?? null,
+                peak_timestamp: bs.peak?.timestamp ?? null,
+                space_bytes: space.bytes,
+                space_eib: space.eib,
+                space_pib: space.pib,
+                space_human: space.human,
+                difficulty: bs.difficulty,
+                sub_slot_iters: bs.sub_slot_iters,
+                average_block_time_seconds: bs.average_block_time ?? null,
+                mempool_size: bs.mempool_size,
+                mempool_cost: bs.mempool_cost,
+                mempool_min_fees: bs.mempool_min_fees,
+                sync: bs.sync,
+                node_id: bs.node_id,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-blockchain-state.js.map

package/dist/tools/blockchain/get-blockchain-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-blockchain-state.js","sourceRoot":"","sources":["../../../src/tools/blockchain/get-blockchain-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,yJAAyJ,EACzJ,EAAE,OAAO,EAAE,aAAa,EAAE,EAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,EAAE,GAAG,GAAG,CAAC,gBAAgB,CAAC;YAChC,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACvC,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI;gBACpC,gBAAgB,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,IAAI,IAAI;gBAC9C,cAAc,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,IAAI,IAAI;gBAC1C,WAAW,EAAE,KAAK,CAAC,KAAK;gBACxB,SAAS,EAAE,KAAK,CAAC,GAAG;gBACpB,SAAS,EAAE,KAAK,CAAC,GAAG;gBACpB,WAAW,EAAE,KAAK,CAAC,KAAK;gBACxB,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,cAAc,EAAE,EAAE,CAAC,cAAc;gBACjC,0BAA0B,EAAE,EAAE,CAAC,kBAAkB,IAAI,IAAI;gBACzD,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,gBAAgB,EAAE,EAAE,CAAC,gBAAgB;gBACrC,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,OAAO,EAAE,EAAE,CAAC,OAAO;aACpB,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/blockchain/get-netspace.d.ts

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

package/dist/tools/blockchain/get-netspace.js

@@ -0,0 +1,26 @@
+import { get_blockchain_state } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { formatNetspace } from '../../chia/amounts.js';
+import { networkSchema } from '../../schemas/common.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_netspace', 'Get the current Chia netspace (estimated total network space). Returns raw bytes and formatted values in EiB, PiB, and TiB.', { network: networkSchema }, async ({ network }) => {
+        try {
+            const agent = getAgent(network);
+            const res = await get_blockchain_state(agent);
+            const space = formatNetspace(res.blockchain_state.space);
+            return jsonText({
+                network,
+                bytes: space.bytes,
+                eib: space.eib,
+                pib: space.pib,
+                tib: space.tib,
+                human: space.human,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-netspace.js.map

package/dist/tools/blockchain/get-netspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-netspace.js","sourceRoot":"","sources":["../../../src/tools/blockchain/get-netspace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,cAAc,EACd,6HAA6H,EAC7H,EAAE,OAAO,EAAE,aAAa,EAAE,EAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,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/blockchain/get-peak-height.d.ts

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

package/dist/tools/blockchain/get-peak-height.js

@@ -0,0 +1,23 @@
+import { get_blockchain_state } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { networkSchema } from '../../schemas/common.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_peak_height', 'Get the current peak block height of the Chia blockchain.', { network: networkSchema }, async ({ network }) => {
+        try {
+            const agent = getAgent(network);
+            const res = await get_blockchain_state(agent);
+            const peak = res.blockchain_state.peak;
+            return jsonText({
+                network,
+                peak_height: peak?.height ?? null,
+                peak_header_hash: peak?.header_hash ?? null,
+                peak_timestamp: peak?.timestamp ?? null,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-peak-height.js.map

package/dist/tools/blockchain/get-peak-height.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-peak-height.js","sourceRoot":"","sources":["../../../src/tools/blockchain/get-peak-height.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,2DAA2D,EAC3D,EAAE,OAAO,EAAE,aAAa,EAAE,EAC1B,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACvC,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,WAAW,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;gBACjC,gBAAgB,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI;gBAC3C,cAAc,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI;aACxC,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/coins/calculate-coin-name.d.ts

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

package/dist/tools/coins/calculate-coin-name.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { coinName } from '../../chia/coin-name.js';
+import { hex32Schema } from '../../schemas/common.js';
+import { errorText, jsonText } from '../shared/response.js';
+const amountSchema = z
+    .union([z.string(), z.number().int().nonnegative()])
+    .describe('Coin amount in mojos. Strings are accepted for values that exceed JS number precision.');
+export function register(server) {
+    server.tool('calculate_coin_name', 'Compute the coin name (sha256 of parent_coin_info || puzzle_hash || amount). Local computation only — no RPC.', {
+        parent_coin_info: hex32Schema.describe('32-byte parent coin id (hex)'),
+        puzzle_hash: hex32Schema.describe('32-byte puzzle hash (hex)'),
+        amount: amountSchema,
+    }, async ({ parent_coin_info, puzzle_hash, amount }) => {
+        try {
+            const name = coinName({ parent_coin_info, puzzle_hash, amount });
+            return jsonText({
+                coin_name: name,
+                parent_coin_info: parent_coin_info.toLowerCase().replace(/^0x/, ''),
+                puzzle_hash: puzzle_hash.toLowerCase().replace(/^0x/, ''),
+                amount: amount.toString(),
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=calculate-coin-name.js.map

package/dist/tools/coins/calculate-coin-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-coin-name.js","sourceRoot":"","sources":["../../../src/tools/coins/calculate-coin-name.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,YAAY,GAAG,CAAC;KACnB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;KACnD,QAAQ,CACP,wFAAwF,CACzF,CAAC;AAEJ,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,+GAA+G,EAC/G;QACE,gBAAgB,EAAE,WAAW,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACtE,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QAC9D,MAAM,EAAE,YAAY;KACrB,EACD,KAAK,EAAE,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE;QAClD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,QAAQ,CAAC;gBACd,SAAS,EAAE,IAAI;gBACf,gBAAgB,EAAE,gBAAgB,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBACnE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBACzD,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;aAC1B,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/coins/get-balance.d.ts

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

package/dist/tools/coins/get-balance.js

@@ -0,0 +1,35 @@
+import { getAgent } from '../../coinset/agent.js';
+import { fetchCoinRecordsByPuzzleHash } from '../../coinset/pagination.js';
+import { mojoToXch, toBigInt } from '../../chia/amounts.js';
+import { addressOrPuzzleHashSchema, networkSchemaOptional } from '../../schemas/common.js';
+import { resolveAddressOrPuzzleHash } from '../shared/address-input.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_balance', 'Get the XCH balance of an address or puzzle hash. Sums all unspent coins (paginated). Accepts xch/txch addresses (network auto-detected from prefix) or a 32-byte hex puzzle hash (network defaults to mainnet, override with `network`).', {
+        address_or_puzzle_hash: addressOrPuzzleHashSchema,
+        network: networkSchemaOptional,
+    }, async ({ address_or_puzzle_hash, network }) => {
+        try {
+            const target = resolveAddressOrPuzzleHash(address_or_puzzle_hash, network);
+            const agent = getAgent(target.network);
+            const records = await fetchCoinRecordsByPuzzleHash(agent, target.puzzleHash, {
+                includeSpent: false,
+            });
+            let total = 0n;
+            for (const r of records)
+                total += toBigInt(r.coin.amount);
+            return jsonText({
+                network: target.network,
+                address: target.address,
+                puzzle_hash: target.puzzleHash,
+                unspent_coin_count: records.length,
+                balance_mojo: total.toString(),
+                balance_xch: mojoToXch(total),
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-balance.js.map

package/dist/tools/coins/get-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-balance.js","sourceRoot":"","sources":["../../../src/tools/coins/get-balance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,aAAa,EACb,2OAA2O,EAC3O;QACE,sBAAsB,EAAE,yBAAyB;QACjD,OAAO,EAAE,qBAAqB;KAC/B,EACD,KAAK,EAAE,EAAE,sBAAsB,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,0BAA0B,CACvC,sBAAsB,EACtB,OAA8B,CAC/B,CAAC;YACF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;gBAC3E,YAAY,EAAE,KAAK;aACpB,CAAC,CAAC;YACH,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,KAAK,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1D,OAAO,QAAQ,CAAC;gBACd,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,kBAAkB,EAAE,OAAO,CAAC,MAAM;gBAClC,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE;gBAC9B,WAAW,EAAE,SAAS,CAAC,KAAK,CAAC;aAC9B,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/coins/get-coin-by-name.d.ts

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

package/dist/tools/coins/get-coin-by-name.js

@@ -0,0 +1,34 @@
+import { get_coin_record_by_name } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { hex32Schema, networkSchema } from '../../schemas/common.js';
+import { stripHexPrefix } from '../../chia/hex.js';
+import { mojoToXch, toBigInt } from '../../chia/amounts.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_coin_by_name', 'Look up a coin record by its coin name (the 32-byte sha256 of parent_coin_info || puzzle_hash || amount).', {
+        name: hex32Schema,
+        network: networkSchema,
+    }, async ({ name, network }) => {
+        try {
+            const agent = getAgent(network);
+            const normalized = stripHexPrefix(name).toLowerCase();
+            const res = await get_coin_record_by_name(agent, { name: normalized });
+            const record = res.coin_record;
+            return jsonText({
+                network,
+                coin_name: normalized,
+                coin_record: record,
+                ...(record
+                    ? {
+                        amount_mojo: record.coin.amount.toString(),
+                        amount_xch: mojoToXch(toBigInt(record.coin.amount)),
+                    }
+                    : {}),
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-coin-by-name.js.map

package/dist/tools/coins/get-coin-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-coin-by-name.js","sourceRoot":"","sources":["../../../src/tools/coins/get-coin-by-name.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,2GAA2G,EAC3G;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;YAC3C,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YACvE,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC;YAC/B,OAAO,QAAQ,CAAC;gBACd,OAAO;gBACP,SAAS,EAAE,UAAU;gBACrB,WAAW,EAAE,MAAM;gBACnB,GAAG,CAAC,MAAM;oBACR,CAAC,CAAC;wBACE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;wBAC1C,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;qBACpD;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,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/coins/get-coin-records-by-puzzle-hash.d.ts

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

package/dist/tools/coins/get-coin-records-by-puzzle-hash.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { getAgent } from '../../coinset/agent.js';
+import { fetchCoinRecordsByPuzzleHash } from '../../coinset/pagination.js';
+import { addressOrPuzzleHashSchema, networkSchemaOptional } from '../../schemas/common.js';
+import { resolveAddressOrPuzzleHash } from '../shared/address-input.js';
+import { errorText, jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('get_coin_records_by_puzzle_hash', 'Return raw coin records for an address or puzzle hash. Optionally include spent coins or restrict to a height window.', {
+        address_or_puzzle_hash: addressOrPuzzleHashSchema,
+        include_spent_coins: z.boolean().optional().describe('Include spent coins (default false)'),
+        start_height: z.number().int().nonnegative().optional(),
+        end_height: z.number().int().nonnegative().optional(),
+        network: networkSchemaOptional,
+    }, async ({ address_or_puzzle_hash, include_spent_coins, start_height, end_height, network }) => {
+        try {
+            const target = resolveAddressOrPuzzleHash(address_or_puzzle_hash, network);
+            const agent = getAgent(target.network);
+            const records = await fetchCoinRecordsByPuzzleHash(agent, target.puzzleHash, {
+                includeSpent: include_spent_coins ?? false,
+                ...(start_height !== undefined ? { startHeight: start_height } : {}),
+                ...(end_height !== undefined ? { endHeight: end_height } : {}),
+            });
+            return jsonText({
+                network: target.network,
+                address: target.address,
+                puzzle_hash: target.puzzleHash,
+                coin_count: records.length,
+                coin_records: records,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-coin-records-by-puzzle-hash.js.map

package/dist/tools/coins/get-coin-records-by-puzzle-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-coin-records-by-puzzle-hash.js","sourceRoot":"","sources":["../../../src/tools/coins/get-coin-records-by-puzzle-hash.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iCAAiC,EACjC,uHAAuH,EACvH;QACE,sBAAsB,EAAE,yBAAyB;QACjD,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAC3F,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QACrD,OAAO,EAAE,qBAAqB;KAC/B,EACD,KAAK,EAAE,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,0BAA0B,CACvC,sBAAsB,EACtB,OAA8B,CAC/B,CAAC;YACF,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,MAAM,4BAA4B,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE;gBAC3E,YAAY,EAAE,mBAAmB,IAAI,KAAK;gBAC1C,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;gBACd,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,WAAW,EAAE,MAAM,CAAC,UAAU;gBAC9B,UAAU,EAAE,OAAO,CAAC,MAAM;gBAC1B,YAAY,EAAE,OAAO;aACtB,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/shared/address-input.d.ts

@@ -0,0 +1,12 @@
+import { Network } from '../../network.js';
+export interface ResolvedTarget {
+    puzzleHash: string;
+    address: string;
+    network: Network;
+}
+/**
+ * Resolve a user-supplied "address or puzzle hash" into a normalized form.
+ * If both an address and a network argument are provided and they disagree,
+ * throws — better to surface the mismatch than silently pick one.
+ */
+export declare function resolveAddressOrPuzzleHash(input: string, requestedNetwork: Network | undefined): ResolvedTarget;