chia-explorer 0.1.5 → 0.2.0

package/dist/tools/offers/decompile-puzzle.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { get_puzzle_and_solution } from 'chia-agent/api/rpc/full_node/index.js';
+import { getAgent } from '../../coinset/agent.js';
+import { classifyPuzzle, parseConditions } from '../../chia/offer.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('decompile_puzzle', 'Classify a Chia CLVM puzzle reveal. Returns its kind (xch, cat, nft, did, singleton, unknown), asset_id for CATs, launcher_id for NFTs/DIDs, and the inner p2 puzzle hash. Either pass `puzzle_reveal` as hex directly, OR pass `coin_id` + `height` to auto-fetch from the full node. Set `include_conditions: true` to also parse the conditions a spend emits (requires `solution` hex, or a spent coin reachable via coin_id + height).', {
+        puzzle_reveal: z
+            .string()
+            .optional()
+            .describe('Hex-encoded puzzle reveal. Omit to auto-fetch via coin_id + height.'),
+        solution: z
+            .string()
+            .optional()
+            .describe('Hex-encoded solution. Only used when include_conditions is true.'),
+        coin_id: hex32Schema
+            .optional()
+            .describe('32-byte coin id. Use with `height` to auto-fetch the puzzle reveal.'),
+        height: heightSchema
+            .optional()
+            .describe('The spent_block_index of the coin (where it was spent).'),
+        include_conditions: z
+            .boolean()
+            .default(false)
+            .describe('If true, run the puzzle with the solution and parse the emitted conditions.'),
+        network: networkSchema,
+    }, async ({ puzzle_reveal, solution, coin_id, height, include_conditions, network }) => {
+        try {
+            let revealHex = puzzle_reveal;
+            let solutionHex = solution;
+            if (!revealHex) {
+                if (!coin_id || height === undefined) {
+                    throw new Error('must supply either `puzzle_reveal` (hex) or both `coin_id` and `height` to auto-fetch');
+                }
+                const agent = getAgent(network);
+                const normalizedCoinId = stripHexPrefix(coin_id).toLowerCase();
+                const res = await get_puzzle_and_solution(agent, {
+                    coin_id: normalizedCoinId,
+                    height,
+                });
+                revealHex = res.coin_solution.puzzle_reveal;
+                if (!solutionHex)
+                    solutionHex = res.coin_solution.solution;
+            }
+            const classification = classifyPuzzle(revealHex);
+            const out = { classification };
+            if (include_conditions) {
+                if (!solutionHex) {
+                    throw new Error('`include_conditions: true` requires a `solution` argument (or a fetchable coin_id + height that yields one)');
+                }
+                out.parsed_conditions = parseConditions(revealHex, solutionHex);
+            }
+            return jsonText(out);
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=decompile-puzzle.js.map

package/dist/tools/offers/decompile-puzzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompile-puzzle.js","sourceRoot":"","sources":["../../../src/tools/offers/decompile-puzzle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtE,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,kBAAkB,EAClB,6aAA6a,EAC7a;QACE,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,kEAAkE,CAAC;QAC/E,OAAO,EAAE,WAAW;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,MAAM,EAAE,YAAY;aACjB,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;QACtE,kBAAkB,EAAE,CAAC;aAClB,OAAO,EAAE;aACT,OAAO,CAAC,KAAK,CAAC;aACd,QAAQ,CAAC,6EAA6E,CAAC;QAC1F,OAAO,EAAE,aAAa;KACvB,EACD,KAAK,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;QAClF,IAAI,CAAC;YACH,IAAI,SAAS,GAAG,aAAa,CAAC;YAC9B,IAAI,WAAW,GAAG,QAAQ,CAAC;YAE3B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAkB,CAAC,CAAC;gBAC3C,MAAM,gBAAgB,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC/D,MAAM,GAAG,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE;oBAC/C,OAAO,EAAE,gBAAgB;oBACzB,MAAM;iBACP,CAAC,CAAC;gBACH,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC,aAAa,CAAC;gBAC5C,IAAI,CAAC,WAAW;oBAAE,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC;YAC7D,CAAC;YAED,MAAM,cAAc,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YACjD,MAAM,GAAG,GAA4B,EAAE,cAAc,EAAE,CAAC;YAExD,IAAI,kBAAkB,EAAE,CAAC;gBACvB,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;gBACJ,CAAC;gBACD,GAAG,CAAC,iBAAiB,GAAG,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAClE,CAAC;YAED,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvB,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.5",
+  "version": "0.2.0",
   "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",
@@ -53,6 +53,7 @@
     "@modelcontextprotocol/sdk": "^1.12.0",
     "@scure/base": "^1.1.9",
     "chia-agent": "^14.3.1",
+    "chia-wallet-sdk": "^0.33.0",
     "zod": "^3.24.0"
   },
   "devDependencies": {