chia-explorer 0.1.6 → 0.2.1

package/README.md

@@ -20,25 +20,48 @@ Backed by the public [coinset.org](https://www.coinset.org) full-node API for ch
 
 ## Install
 
+The server is a single npm package. No global install needed — every config below uses `npx` so it stays up to date.
+
 ```bash
-npm install -g chia-explorer
+npx chia-explorer
 ```
 
-Or run via `npx`:
+If you want it on your PATH:
 
 ```bash
-npx chia-explorer
+npm install -g chia-explorer
 ```
 
-## Use with Claude Code
+Requires Node.js 20+.
+
+## Use it with your AI client
+
+### Claude Code
 
 ```bash
 claude mcp add chia-explorer -- npx chia-explorer
 ```
 
-## Use with Claude Desktop
+### Claude Desktop
+
+Edit `claude_desktop_config.json` (Settings → Developer → Edit Config):
+
+```json
+{
+  "mcpServers": {
+    "chia-explorer": {
+      "command": "npx",
+      "args": ["chia-explorer"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop.
 
-Add to your `claude_desktop_config.json`:
+### Cursor
+
+Create or edit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` inside a project:
 
 ```json
 {
@@ -51,6 +74,122 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
+Restart Cursor and enable the server under Settings → MCP.
+
+### Codex CLI
+
+Edit `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.chia-explorer]
+command = "npx"
+args = ["chia-explorer"]
+```
+
+### VS Code (native MCP)
+
+Create `.vscode/mcp.json` in your workspace:
+
+```json
+{
+  "servers": {
+    "chia-explorer": {
+      "command": "npx",
+      "args": ["chia-explorer"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Edit `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "chia-explorer": {
+      "command": "npx",
+      "args": ["chia-explorer"]
+    }
+  }
+}
+```
+
+### Anything else that speaks MCP
+
+It's a standard stdio MCP server. The recipe is always the same: `command = npx`, `args = ["chia-explorer"]`. Set `COINGECKO_API_KEY` as an env var if you have one.
+
+## Example prompts
+
+Drop these into a chat once the server is wired up.
+
+**Offers**
+
+> Decode this offer and tell me what's being traded: `offer1qqr83wcuu2rykcmqvpsxgfgqmqys...`
+
+> I just got sent this `offer1...` string in Discord. Is it safe to take? What do I give and what do I get?
+
+**Smart-coin inspection**
+
+> What kind of coin is `0xabc...123`? Pull its puzzle reveal at height 6500000 and tell me if it's a CAT, NFT, DID, or plain XCH.
+
+> Walk the children of coin `0xabc...` for two hops. Classify each child.
+
+**Mempool and fees**
+
+> Is `0xdeadbeef...` (my tx) currently in the mempool?
+
+> How many transactions are pending right now? What does the fee market look like for inclusion in the next minute?
+
+> What fee should I attach to a take_offer spend to get included in the next 5 minutes?
+
+**Balances and pricing**
+
+> What's the XCH balance of `xch1yxqsmyuyjdlgxw4sqjg4vqlqv5ms2qzex00586nu643jqemmarwslh08yl`? How much is that in USD and EUR right now?
+
+> Convert 1.5 XCH to GBP, EUR, BTC, and SAT.
+
+**Chain state**
+
+> What block was Chia at one hour ago — height, header hash, transaction count?
+
+> Is the network synced? What's the current netspace in EiB?
+
+**Strategic reserve**
+
+> How much of the 21M XCH strategic reserve has been spent? Where did the most recent five outflows go — partners, market makers, or exchanges?
+
+> Show me every spend from the Swiss cold wallet, with the destination labelled.
+
+**Identifier glue**
+
+> Convert this puzzle hash to a mainnet address: `4bf5122f344554c53bde2ebb8cd2b7e3d1600ad631c385a5d7cce23c7785459a`.
+
+> What's the coin name for parent `0xaaa...`, puzzle hash `0xbbb...`, amount 1000000000000?
+
+## Pre-built workflows: chia-skills
+
+[**chia-skills**](https://github.com/Spacetime-Technology/chia-skills) is a companion package of Claude Code skills built on top of this MCP. It turns the read-only tools below into finished workflows you can actually schedule and get notified about: deposit alerts, price triggers, offer safety checks, NFT provenance, invoice watching.
+
+```bash
+npx chia-skills install
+```
+
+What's in the box:
+
+- `watch-address` — push notification when XCH, a CAT, or an NFT lands at (or leaves) an address
+- `watch-tx-confirmation` — ping when a specific tx_id moves from mempool to confirmed
+- `watch-xch-price` — alert when XCH crosses a threshold in any CoinGecko currency
+- `watch-fee-market` — catch cheap fee windows to broadcast
+- `watch-prefarm-spend` — flag new strategic-reserve outflows with destinations labelled
+- `address-daily-digest` — daily summary of one or more addresses with USD values
+- `offer-safety-check` — decode an `offer1...` and check both sides against market prices
+- `coin-lineage` / `nft-provenance` — walk coin or NFT history N hops in either direction
+- `invoice-watch` — generate an invoice, watch for the matching deposit, emit a paid receipt
+
+Skills are read-only and idempotent, persist state between runs, and accept structured inputs so other skills or agents can chain them. If you want to see what's possible with chia-explorer beyond ad-hoc prompts, start there. If you want to write your own, the skills repo is the reference.
+
 ## Tools
 
 | Tool | What it does |
@@ -81,12 +220,17 @@ Add to your `claude_desktop_config.json`:
 | `get_prefarm_status` | Live per-wallet balances of the 21M XCH strategic reserve, plus total spent |
 | `get_prefarm_spends` | Outflows from the reserve, with destinations labelled when known (partners / market makers / exchanges). Filter by wallet, height, or count |
 | `list_prefarm_addresses` | The hardcoded registry: custody wallets and known destination addresses. No network call |
+| `list_chips` | All Chia Improvement Proposals from the canonical README index in `Chia-Network/chips`, across every status (Living, Draft, Review, Final, Stagnant, Withdrawn, Obsolete, Grandfathered). Draft and Review entries link to open PRs; Final entries link to merged files. Status comes from the README; front matter is enriched in. Filter by status or category |
+| `get_chip` | One CHIP by number. Returns the merged version (if any), any open PR drafts proposing the same number, and optionally the full markdown |
+| `list_chip_drafts` | Open PRs against `Chia-Network/chips` that add or modify a CHIP, with parsed front matter and PR context (author, reviewers, draft flag) |
+| `search_chips` | Keyword search across merged CHIPs and open PR drafts (title, description, abstract, authors) |
 
-Blockchain tools take an optional `network: "mainnet" | "testnet11"` (default `mainnet`). The price tools take no network arg. The prefarm tools are mainnet only.
+Blockchain tools take an optional `network: "mainnet" | "testnet11"` (default `mainnet`). The price and CHIPs tools take no network arg. The prefarm tools are mainnet only.
 
 ## 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.
+- `GITHUB_TOKEN` — if set, sent as `Authorization: Bearer …` to the GitHub API. Lifts the unauthenticated 60/hr limit to 5000/hr for CHIPs listings. Raw file fetches don't need it. The CHIPs tools work without it.
 
 ## Prompts
 

package/dist/chips/index.d.ts

@@ -0,0 +1,76 @@
+import { type AuthorRef } from './parser.js';
+export interface ChipSummary {
+    number: number | null;
+    title: string | null;
+    status: string | null;
+    category: string | null;
+    sub_category: string | null;
+    type: string | null;
+    authors: AuthorRef[];
+    editors: AuthorRef[];
+    description: string | null;
+    abstract: string | null;
+    created: string | null;
+    updated: string | null;
+    comments_uri: string | null;
+    requires: string | null;
+    replaces: string | null;
+    superseded_by: string | null;
+    source_url: string;
+    filename: string | null;
+}
+export interface MergedChip extends ChipSummary {
+    source: 'merged';
+    ref: 'main';
+    body?: string;
+}
+export interface DraftChip extends ChipSummary {
+    source: 'draft';
+    ref: string;
+    pr: PrContext;
+    modifies_existing: boolean;
+    body?: string;
+}
+export interface ChipIndexEntry extends ChipSummary {
+    kind: 'file' | 'pr' | 'external';
+    pr: PrContext | null;
+    ref: string | null;
+}
+export interface PrContext {
+    number: number;
+    url: string;
+    title: string;
+    state: string;
+    draft: boolean;
+    author: string | null;
+    requested_reviewers: string[];
+    created_at: string;
+    updated_at: string;
+    head_sha: string;
+    head_ref: string;
+    base_ref: string;
+}
+export declare function getMergedChip(number: number, options?: {
+    includeBody?: boolean;
+}): Promise<MergedChip | null>;
+export declare function listChipDrafts(): Promise<DraftChip[]>;
+export declare function getChipFromPr(prNumber: number, options?: {
+    includeBody?: boolean;
+}): Promise<DraftChip | null>;
+export declare function findChipByNumber(number: number, options?: {
+    includeBody?: boolean;
+}): Promise<{
+    merged: MergedChip | null;
+    drafts: DraftChip[];
+}>;
+export declare function listChipsFromReadme(): Promise<ChipIndexEntry[]>;
+export interface SearchOptions {
+    status?: string;
+    source?: 'merged' | 'draft' | 'both';
+    limit?: number;
+}
+export interface SearchMatch extends ChipIndexEntry {
+    source: 'merged' | 'draft';
+}
+export declare function searchChips(query: string, options?: SearchOptions): Promise<SearchMatch[]>;
+export { resetCache } from '../github/cache.js';

package/dist/chips/index.js

@@ -0,0 +1,288 @@
+import { FileNotFoundError, fetchRawFile, githubApi } from '../github/client.js';
+import { getCached } from '../github/cache.js';
+import { buildChipFileName, extractAbstract, extractChipPathInfo, parseChipFrontMatter, } from './parser.js';
+import { getChipReadmeIndex } from './readme-index.js';
+const REPO = 'Chia-Network/chips';
+const DEFAULT_REF = 'main';
+const CONTENT_TTL_MS = 10 * 60_000;
+const PR_LIST_TTL_MS = 2 * 60_000;
+function summarize(fm, body, ref, filename) {
+    return {
+        number: fm.number,
+        title: fm.title,
+        status: fm.status,
+        category: fm.category,
+        sub_category: fm.sub_category,
+        type: fm.type,
+        authors: fm.authors,
+        editors: fm.editors,
+        description: fm.description,
+        abstract: extractAbstract(body),
+        created: fm.created,
+        updated: fm.updated,
+        comments_uri: fm.comments_uri,
+        requires: fm.requires,
+        replaces: fm.replaces,
+        superseded_by: fm.superseded_by,
+        source_url: `https://github.com/${REPO}/blob/${ref}/${filename}`,
+        filename,
+    };
+}
+async function fetchChipFile(ref, path) {
+    return getCached(`chips:raw:${ref}:${path}`, () => fetchRawFile(REPO, ref, path), CONTENT_TTL_MS);
+}
+export async function getMergedChip(number, options = {}) {
+    const filename = `CHIPs/${buildChipFileName(number)}`;
+    try {
+        const body = await fetchChipFile(DEFAULT_REF, filename);
+        const fm = parseChipFrontMatter(body);
+        const summary = summarize(fm, body, DEFAULT_REF, filename);
+        const chip = {
+            ...summary,
+            source: 'merged',
+            ref: 'main',
+        };
+        if (options.includeBody)
+            chip.body = body;
+        return chip;
+    }
+    catch (err) {
+        if (err instanceof FileNotFoundError)
+            return null;
+        throw err;
+    }
+}
+async function listOpenChipPrs() {
+    return getCached(`chips:prs:open`, () => githubApi(`/repos/${REPO}/pulls?state=open&per_page=100&sort=updated&direction=desc`), PR_LIST_TTL_MS);
+}
+async function listPrChipFiles(prNumber) {
+    return getCached(`chips:pr-files:${prNumber}`, () => githubApi(`/repos/${REPO}/pulls/${prNumber}/files?per_page=100`), PR_LIST_TTL_MS);
+}
+function prContext(pr) {
+    return {
+        number: pr.number,
+        url: pr.html_url,
+        title: pr.title,
+        state: pr.state,
+        draft: pr.draft,
+        author: pr.user?.login ?? null,
+        requested_reviewers: pr.requested_reviewers.map((r) => r.login),
+        created_at: pr.created_at,
+        updated_at: pr.updated_at,
+        head_sha: pr.head.sha,
+        head_ref: pr.head.ref,
+        base_ref: pr.base.ref,
+    };
+}
+async function buildDraftFromPr(pr, file, options = {}) {
+    if (file.status === 'removed')
+        return null;
+    const info = extractChipPathInfo(file.filename);
+    if (!info)
+        return null;
+    let body;
+    try {
+        body = await fetchChipFile(pr.head.sha, file.filename);
+    }
+    catch (err) {
+        if (err instanceof FileNotFoundError)
+            return null;
+        throw err;
+    }
+    const fm = parseChipFrontMatter(body);
+    const summary = summarize(fm, body, pr.head.sha, file.filename);
+    if (summary.number == null)
+        summary.number = info.number;
+    const draft = {
+        ...summary,
+        source: 'draft',
+        ref: pr.head.sha,
+        pr: prContext(pr),
+        modifies_existing: file.status === 'modified' || file.status === 'renamed',
+    };
+    if (options.includeBody)
+        draft.body = body;
+    return draft;
+}
+export async function listChipDrafts() {
+    const prs = await listOpenChipPrs();
+    const results = [];
+    for (const pr of prs) {
+        const files = await listPrChipFiles(pr.number).catch(() => []);
+        const chipFiles = files.filter((f) => extractChipPathInfo(f.filename));
+        for (const file of chipFiles) {
+            const draft = await buildDraftFromPr(pr, file).catch(() => null);
+            if (draft)
+                results.push(draft);
+        }
+    }
+    return results;
+}
+export async function getChipFromPr(prNumber, options = {}) {
+    const prs = await listOpenChipPrs();
+    const pr = prs.find((p) => p.number === prNumber);
+    if (!pr)
+        return null;
+    const files = await listPrChipFiles(prNumber);
+    for (const file of files) {
+        if (!extractChipPathInfo(file.filename))
+            continue;
+        const draft = await buildDraftFromPr(pr, file, options);
+        if (draft)
+            return draft;
+    }
+    return null;
+}
+export async function findChipByNumber(number, options = {}) {
+    const merged = await getMergedChip(number, options);
+    const allDrafts = await listChipDrafts();
+    const drafts = [];
+    for (const d of allDrafts) {
+        if (d.number !== number)
+            continue;
+        if (options.includeBody) {
+            const full = await getChipFromPr(d.pr.number, { includeBody: true });
+            if (full)
+                drafts.push(full);
+            else
+                drafts.push(d);
+        }
+        else {
+            drafts.push(d);
+        }
+    }
+    return { merged, drafts };
+}
+function sparseEntry(idx) {
+    return {
+        number: idx.number,
+        title: idx.title,
+        status: idx.status,
+        category: null,
+        sub_category: null,
+        type: null,
+        authors: [],
+        editors: [],
+        description: null,
+        abstract: null,
+        created: null,
+        updated: null,
+        comments_uri: null,
+        requires: null,
+        replaces: null,
+        superseded_by: null,
+        source_url: idx.url,
+        filename: idx.filename,
+        kind: idx.kind,
+        pr: null,
+        ref: null,
+    };
+}
+async function buildIndexEntry(idx, openPrs) {
+    if (idx.kind === 'file' && idx.filename) {
+        try {
+            const body = await fetchChipFile(DEFAULT_REF, idx.filename);
+            const fm = parseChipFrontMatter(body);
+            const summary = summarize(fm, body, DEFAULT_REF, idx.filename);
+            return {
+                ...summary,
+                number: idx.number ?? summary.number,
+                title: summary.title ?? idx.title,
+                status: idx.status,
+                source_url: idx.url,
+                kind: 'file',
+                pr: null,
+                ref: DEFAULT_REF,
+            };
+        }
+        catch (err) {
+            if (err instanceof FileNotFoundError)
+                return sparseEntry(idx);
+            throw err;
+        }
+    }
+    if (idx.kind === 'pr' && idx.prNumber != null) {
+        const pr = openPrs.get(idx.prNumber);
+        if (pr) {
+            const files = await listPrChipFiles(pr.number).catch(() => []);
+            const chipFiles = files.filter((f) => f.status !== 'removed' && extractChipPathInfo(f.filename));
+            let chipFile;
+            if (idx.number != null) {
+                const target = buildChipFileName(idx.number);
+                chipFile = chipFiles.find((f) => f.filename.toLowerCase().endsWith(target.toLowerCase()));
+            }
+            if (!chipFile)
+                chipFile = chipFiles[0];
+            if (chipFile) {
+                const body = await fetchChipFile(pr.head.sha, chipFile.filename).catch(() => null);
+                if (body) {
+                    const fm = parseChipFrontMatter(body);
+                    const summary = summarize(fm, body, pr.head.sha, chipFile.filename);
+                    return {
+                        ...summary,
+                        number: idx.number ?? summary.number,
+                        title: summary.title ?? idx.title,
+                        status: idx.status,
+                        source_url: idx.url,
+                        kind: 'pr',
+                        pr: prContext(pr),
+                        ref: pr.head.sha,
+                    };
+                }
+            }
+        }
+        return sparseEntry(idx);
+    }
+    return sparseEntry(idx);
+}
+export async function listChipsFromReadme() {
+    const [index, openPrsList] = await Promise.all([getChipReadmeIndex(), listOpenChipPrs()]);
+    const openPrs = new Map(openPrsList.map((pr) => [pr.number, pr]));
+    const entries = await Promise.all(index.map((idx) => buildIndexEntry(idx, openPrs)));
+    entries.sort((a, b) => {
+        if (a.number == null && b.number == null)
+            return 0;
+        if (a.number == null)
+            return 1;
+        if (b.number == null)
+            return -1;
+        return a.number - b.number;
+    });
+    return entries;
+}
+function matchesQuery(s, q) {
+    const needle = q.toLowerCase();
+    const haystacks = [];
+    if (s.title)
+        haystacks.push(s.title);
+    if (s.description)
+        haystacks.push(s.description);
+    if (s.abstract)
+        haystacks.push(s.abstract);
+    for (const a of s.authors)
+        haystacks.push(a.name);
+    if (s.number != null)
+        haystacks.push(String(s.number));
+    return haystacks.some((h) => h.toLowerCase().includes(needle));
+}
+function kindToSource(kind) {
+    return kind === 'pr' ? 'draft' : 'merged';
+}
+export async function searchChips(query, options = {}) {
+    const source = options.source ?? 'both';
+    const limit = options.limit ?? 20;
+    const statusFilter = options.status?.toLowerCase();
+    const entries = await listChipsFromReadme();
+    const filtered = entries
+        .map((e) => ({ ...e, source: kindToSource(e.kind) }))
+        .filter((e) => {
+        if (source !== 'both' && e.source !== source)
+            return false;
+        if (statusFilter && (e.status?.toLowerCase() ?? '') !== statusFilter)
+            return false;
+        return matchesQuery(e, query);
+    });
+    return filtered.slice(0, limit);
+}
+export { resetCache } from '../github/cache.js';
+//# sourceMappingURL=index.js.map

package/dist/chips/index.js.map

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

package/dist/chips/parser.d.ts

@@ -0,0 +1,30 @@
+export interface AuthorRef {
+    name: string;
+    url: string | null;
+}
+export interface ChipFrontMatter {
+    number: number | null;
+    title: string | null;
+    description: string | null;
+    authors: AuthorRef[];
+    editors: AuthorRef[];
+    comments_uri: string | null;
+    status: string | null;
+    category: string | null;
+    sub_category: string | null;
+    type: string | null;
+    created: string | null;
+    updated: string | null;
+    requires: string | null;
+    replaces: string | null;
+    superseded_by: string | null;
+    extra: Record<string, string>;
+}
+export declare function parseAuthors(raw: string): AuthorRef[];
+export declare function parseChipFrontMatter(markdown: string): ChipFrontMatter;
+export declare function extractAbstract(markdown: string): string | null;
+export declare function buildChipFileName(number: number): string;
+export declare function extractChipPathInfo(path: string): {
+    number: number;
+    filename: string;
+} | null;