chia-explorer 0.1.2 → 0.1.4

package/README.md

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

package/dist/coingecko/cache.d.ts

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

package/dist/coingecko/cache.js

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

package/dist/coingecko/cache.js.map

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

package/dist/coingecko/client.d.ts

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

package/dist/coingecko/client.js

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

package/dist/coingecko/client.js.map

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

package/dist/coingecko/index.d.ts

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

package/dist/coingecko/index.js

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

package/dist/coingecko/index.js.map

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

package/dist/coinset/pagination.d.ts

@@ -27,3 +27,6 @@ export declare function fetchCoinRecordsByPuzzleHash(agent: RPCAgent, puzzleHash
     startHeight?: number;
     endHeight?: number;
 }): Promise<CoinRecordLike[]>;
+export declare function fetchCoinRecordsByParentIds(agent: RPCAgent, parentIds: readonly string[], options?: {
+    includeSpent?: boolean;
+}): Promise<CoinRecordLike[]>;

package/dist/coinset/pagination.js

@@ -1,4 +1,4 @@
-import { get_coin_records_by_puzzle_hash } from 'chia-agent/api/rpc/full_node/index.js';
+import { get_coin_records_by_parent_ids, get_coin_records_by_puzzle_hash, } from 'chia-agent/api/rpc/full_node/index.js';
 const PAGE_SIZE_LIMIT = 5_000;
 /**
  * Fetch coin records by puzzle hash, paginating by height window if the response
@@ -48,4 +48,22 @@ export async function fetchCoinRecordsByPuzzleHash(agent, puzzleHashHex, options
     }
     return all;
 }
+const PARENT_IDS_BATCH = 200;
+export async function fetchCoinRecordsByParentIds(agent, parentIds, options = {}) {
+    if (parentIds.length === 0)
+        return [];
+    const includeSpent = options.includeSpent ?? true;
+    const all = [];
+    for (let i = 0; i < parentIds.length; i += PARENT_IDS_BATCH) {
+        const batch = parentIds.slice(i, i + PARENT_IDS_BATCH);
+        const payload = {
+            parent_ids: batch,
+            include_spent_coins: includeSpent,
+        };
+        const res = await get_coin_records_by_parent_ids(agent, payload);
+        const records = (res.coin_records ?? []);
+        all.push(...records);
+    }
+    return all;
+}
 //# sourceMappingURL=pagination.js.map

package/dist/coinset/pagination.js.map

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

package/dist/prefarm/registry.d.ts

@@ -0,0 +1,33 @@
+export type WalletId = 'us-cold' | 'us-warm' | 'ch-cold' | 'ch-warm';
+export type Region = 'us' | 'ch';
+export type Temperature = 'cold' | 'warm';
+export type DestinationCategory = 'partner' | 'market-maker' | 'exchange' | 'other';
+export interface PrefarmWallet {
+    id: WalletId;
+    label: string;
+    region: Region;
+    temperature: Temperature;
+    /**
+     * Current on-chain p2 addresses for this custody singleton. Warm wallets carry
+     * more than one because outgoing spends sit at a clawback intermediate before
+     * settling. Empty array = pending population.
+     */
+    addresses: readonly string[];
+    /** Lower-case hex puzzle hashes derived from `addresses`. Same length, same order. */
+    puzzleHashes: readonly string[];
+}
+export interface KnownDestination {
+    address: string;
+    puzzleHash: string;
+    entity: string;
+    label: string;
+    category: DestinationCategory;
+}
+/** Genesis total of the Chia strategic reserve. The only amount we hardcode; everything else is live. */
+export declare const TOTAL_PREFARM_ALLOCATION_MOJO: bigint;
+export declare const PREFARM_WALLETS: readonly PrefarmWallet[];
+export declare const KNOWN_DESTINATIONS: readonly KnownDestination[];
+export declare function lookupDestination(puzzleHashHex: string): KnownDestination | undefined;
+export declare function lookupPrefarmWallet(puzzleHashHex: string): PrefarmWallet | undefined;
+export declare function getWalletById(id: WalletId): PrefarmWallet | undefined;
+export declare function isPopulated(wallet: PrefarmWallet): boolean;

package/dist/prefarm/registry.js

@@ -0,0 +1,121 @@
+import { MOJOS_PER_XCH } from '../chia/amounts.js';
+import { addressToPuzzleHash } from '../chia/bech32.js';
+/** Genesis total of the Chia strategic reserve. The only amount we hardcode; everything else is live. */
+export const TOTAL_PREFARM_ALLOCATION_MOJO = 21000000n * MOJOS_PER_XCH;
+const WALLET_INPUTS = [
+    {
+        id: 'us-cold',
+        label: 'Strategic Reserve — US Cold',
+        region: 'us',
+        temperature: 'cold',
+        addresses: ['xch1yxqsmyuyjdlgxw4sqjg4vqlqv5ms2qzex00586nu643jqemmarwslh08yl'],
+    },
+    {
+        id: 'us-warm',
+        label: 'Strategic Reserve — US Warm',
+        region: 'us',
+        temperature: 'warm',
+        addresses: [
+            'xch12pc7qk46t8aktdsd7ss96pctdp0236sexakfsdvsqefuqyyll3hqzhnldc',
+            'xch1aukdy3djga7j8ckaw06lwjew9pnnv5hugqyx9lu9l2utaxjtgj5snuuwkc',
+        ],
+    },
+    {
+        id: 'ch-cold',
+        label: 'Strategic Reserve — Swiss Cold',
+        region: 'ch',
+        temperature: 'cold',
+        addresses: ['xch1y6krqgs2cjz6mjgz5wy4dd5zqghm3a5pgueccjtudchn2xzcajtsnyzvgy'],
+    },
+    {
+        id: 'ch-warm',
+        label: 'Strategic Reserve — Swiss Warm',
+        region: 'ch',
+        temperature: 'warm',
+        addresses: [
+            'xch18hp0afeqmcvn675dqpnxfhk7gggwcpjaa0huc45huu79tkaa28dsuse43w',
+            'xch1xhghtsdqdtt5eqr307lcacg49nt72zmeuq2qfwu7ymmqvqf0ej0qsruh0w',
+        ],
+    },
+];
+const DESTINATION_INPUTS = [
+    {
+        address: 'xch1drz2ufckxz7dtlaajsw3gwtyd6ztss08vwxyfcr4rz0z0t77ufrq8qqe09',
+        entity: 'silicon',
+        label: 'Silicon.net',
+        category: 'partner',
+    },
+    {
+        address: 'xch1mhw0vz0jl8etxqar0se73excayq2e4jg3g5zegzumyzm2u4htzusjfk8q4',
+        entity: 'koba42',
+        label: 'Koba42 Gaming RFP Grant',
+        category: 'partner',
+    },
+    {
+        address: 'xch1plthft5ykcnnaxvpydzlmu2nlslzcevn3vv4s43rkm908d95nd5sv22nqr',
+        entity: 'nossd',
+        label: 'Purchase Agreement with NoSSD',
+        category: 'partner',
+    },
+    {
+        address: 'xch1hy7r0hcq4xymv2d944dtsn7rw8tv8pntc7adr36u45zhmmh3ad4seh48zz',
+        entity: 'market-maker-primary',
+        label: 'Market Maker (primary)',
+        category: 'market-maker',
+    },
+    {
+        address: 'xch1g8wl32qjyquzx6rnzn0rpj5l2q5acykawzped7nl5kdsfp3drpqqfavwnf',
+        entity: 'market-maker-secondary',
+        label: 'Market Maker (secondary)',
+        category: 'market-maker',
+    },
+    {
+        address: 'xch1d6w3ctu8pqtkkmsa3hjmqam9fuy7q9u4fzy5hqw08rx36whpg3hs4xpjeu',
+        entity: 'market-maker-tertiary',
+        label: 'Market Maker (tertiary)',
+        category: 'market-maker',
+    },
+];
+function buildWallets() {
+    return WALLET_INPUTS.map((w) => {
+        const puzzleHashes = w.addresses.map((addr) => {
+            const { puzzleHash, network } = addressToPuzzleHash(addr);
+            if (network !== 'mainnet') {
+                throw new Error(`prefarm wallet ${w.id} must use mainnet addresses`);
+            }
+            return puzzleHash;
+        });
+        return { ...w, puzzleHashes };
+    });
+}
+function buildDestinations() {
+    return DESTINATION_INPUTS.map((d) => {
+        const { puzzleHash, network } = addressToPuzzleHash(d.address);
+        if (network !== 'mainnet') {
+            throw new Error(`destination ${d.entity} must use a mainnet address`);
+        }
+        return { ...d, puzzleHash };
+    });
+}
+export const PREFARM_WALLETS = buildWallets();
+export const KNOWN_DESTINATIONS = buildDestinations();
+const DESTINATION_INDEX = new Map(KNOWN_DESTINATIONS.map((d) => [d.puzzleHash, d]));
+const WALLET_BY_PUZZLE_HASH = new Map();
+for (const w of PREFARM_WALLETS) {
+    for (const ph of w.puzzleHashes)
+        WALLET_BY_PUZZLE_HASH.set(ph, w);
+}
+const WALLET_BY_ID = new Map(PREFARM_WALLETS.map((w) => [w.id, w]));
+export function lookupDestination(puzzleHashHex) {
+    return DESTINATION_INDEX.get(puzzleHashHex.toLowerCase());
+}
+export function lookupPrefarmWallet(puzzleHashHex) {
+    return WALLET_BY_PUZZLE_HASH.get(puzzleHashHex.toLowerCase());
+}
+export function getWalletById(id) {
+    return WALLET_BY_ID.get(id);
+}
+export function isPopulated(wallet) {
+    return wallet.addresses.length > 0;
+}
+//# sourceMappingURL=registry.js.map

package/dist/prefarm/registry.js.map

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

package/dist/prefarm/spends.d.ts

@@ -0,0 +1,29 @@
+import { RPCAgent } from 'chia-agent';
+import { KnownDestination, PrefarmWallet } from './registry.js';
+export interface DestinationOutflow {
+    puzzle_hash: string;
+    address: string;
+    amount_mojo: string;
+    amount_xch: string;
+    entity: string | null;
+    label: string | null;
+    category: KnownDestination['category'] | 'internal-rotation' | 'unknown';
+    internal_wallet_id?: PrefarmWallet['id'];
+}
+export interface PrefarmSpend {
+    wallet_id: PrefarmWallet['id'];
+    source_address: string;
+    source_puzzle_hash: string;
+    parent_coin_name: string;
+    spent_amount_mojo: string;
+    spent_amount_xch: string;
+    spent_height: number;
+    confirmed_height: number;
+    timestamp: number;
+    destinations: DestinationOutflow[];
+    outflow_mojo: string;
+    outflow_xch: string;
+}
+export declare function getWalletSpends(agent: RPCAgent, wallet: PrefarmWallet, options?: {
+    sinceHeight?: number;
+}): Promise<PrefarmSpend[]>;

package/dist/prefarm/spends.js

@@ -0,0 +1,113 @@
+import { mojoToXch, toBigInt } from '../chia/amounts.js';
+import { puzzleHashToAddress } from '../chia/bech32.js';
+import { coinName } from '../chia/coin-name.js';
+import { fetchCoinRecordsByParentIds, fetchCoinRecordsByPuzzleHash, } from '../coinset/pagination.js';
+import { isPopulated, lookupDestination, lookupPrefarmWallet, } from './registry.js';
+function labelDestination(puzzleHash, address, amountMojo) {
+    const internal = lookupPrefarmWallet(puzzleHash);
+    if (internal) {
+        return {
+            puzzle_hash: puzzleHash,
+            address,
+            amount_mojo: amountMojo.toString(),
+            amount_xch: mojoToXch(amountMojo),
+            entity: 'prefarm',
+            label: internal.label,
+            category: 'internal-rotation',
+            internal_wallet_id: internal.id,
+        };
+    }
+    const known = lookupDestination(puzzleHash);
+    if (known) {
+        return {
+            puzzle_hash: puzzleHash,
+            address,
+            amount_mojo: amountMojo.toString(),
+            amount_xch: mojoToXch(amountMojo),
+            entity: known.entity,
+            label: known.label,
+            category: known.category,
+        };
+    }
+    return {
+        puzzle_hash: puzzleHash,
+        address,
+        amount_mojo: amountMojo.toString(),
+        amount_xch: mojoToXch(amountMojo),
+        entity: null,
+        label: null,
+        category: 'unknown',
+    };
+}
+export async function getWalletSpends(agent, wallet, options = {}) {
+    if (!isPopulated(wallet))
+        return [];
+    const ownPuzzleHashes = new Set(wallet.puzzleHashes.map((ph) => ph.toLowerCase()));
+    const recordGroups = await Promise.all(wallet.puzzleHashes.map((ph) => fetchCoinRecordsByPuzzleHash(agent, ph, {
+        includeSpent: true,
+        ...(options.sinceHeight !== undefined ? { startHeight: options.sinceHeight } : {}),
+    })));
+    const records = recordGroups.flat();
+    const spent = records.filter((r) => r.spent_block_index > 0);
+    if (spent.length === 0)
+        return [];
+    const parentByName = new Map();
+    for (const r of spent) {
+        const name = coinName({
+            parent_coin_info: r.coin.parent_coin_info,
+            puzzle_hash: r.coin.puzzle_hash,
+            amount: toBigInt(r.coin.amount),
+        });
+        parentByName.set(name, r);
+    }
+    const children = await fetchCoinRecordsByParentIds(agent, [...parentByName.keys()], {
+        includeSpent: true,
+    });
+    const childrenByParent = new Map();
+    for (const child of children) {
+        const key = child.coin.parent_coin_info.toLowerCase().replace(/^0x/, '');
+        const list = childrenByParent.get(key) ?? [];
+        list.push(child);
+        childrenByParent.set(key, list);
+    }
+    const out = [];
+    for (const [parentName, parent] of parentByName) {
+        const childCoins = childrenByParent.get(parentName) ?? [];
+        // Filter out children that land back on one of *this* wallet's own puzzle hashes:
+        // those are singleton bookkeeping (e.g. the singleton recreating itself, or
+        // moving between a wallet's primary p2 and its clawback intermediate). Children
+        // landing on a different prefarm wallet are real inter-custody rotations.
+        const meaningful = childCoins.filter((c) => {
+            const ph = c.coin.puzzle_hash.toLowerCase().replace(/^0x/, '');
+            return !ownPuzzleHashes.has(ph);
+        });
+        if (meaningful.length === 0)
+            continue;
+        const destinations = meaningful.map((c) => {
+            const ph = c.coin.puzzle_hash.toLowerCase().replace(/^0x/, '');
+            const addr = puzzleHashToAddress(ph, 'mainnet');
+            return labelDestination(ph, addr, toBigInt(c.coin.amount));
+        });
+        const outflow = destinations
+            .filter((d) => d.category !== 'internal-rotation')
+            .reduce((acc, d) => acc + BigInt(d.amount_mojo), 0n);
+        const sourcePh = parent.coin.puzzle_hash.toLowerCase().replace(/^0x/, '');
+        out.push({
+            wallet_id: wallet.id,
+            source_puzzle_hash: sourcePh,
+            source_address: puzzleHashToAddress(sourcePh, 'mainnet'),
+            parent_coin_name: parentName,
+            spent_amount_mojo: toBigInt(parent.coin.amount).toString(),
+            spent_amount_xch: mojoToXch(toBigInt(parent.coin.amount)),
+            spent_height: parent.spent_block_index,
+            confirmed_height: parent.confirmed_block_index,
+            timestamp: Number(parent.timestamp),
+            destinations,
+            outflow_mojo: outflow.toString(),
+            outflow_xch: mojoToXch(outflow),
+        });
+    }
+    out.sort((a, b) => b.spent_height - a.spent_height);
+    return out;
+}
+//# sourceMappingURL=spends.js.map

package/dist/prefarm/spends.js.map

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

package/dist/prompts/prefarm-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/prefarm-summary.js

@@ -0,0 +1,27 @@
+export function register(server) {
+    server.registerPrompt('prefarm_summary', {
+        title: 'Chia strategic-reserve summary',
+        description: 'Summarise the Chia strategic reserve: how much pre-farm has been spent, how much remains, and where it has gone.',
+        argsSchema: {},
+    }, () => {
+        const text = [
+            `Summarise the state of the Chia strategic reserve (the 21M XCH pre-farm).`,
+            ``,
+            `Steps:`,
+            `1. Call \`get_prefarm_status\` to get headline numbers and per-wallet balances.`,
+            `2. Call \`get_prefarm_spends\` with \`limit: 10\` to get the most recent outflows.`,
+            `3. Call \`get_xch_price\` to convert spent and remaining amounts to USD.`,
+            ``,
+            `Present, in this order:`,
+            `- Total spent vs remaining as both XCH and USD, with the percentage of the 21M reserve spent so far. If some wallets are pending population, say so explicitly and base the percentage only on tracked wallets.`,
+            `- Per-wallet breakdown: id, balance in XCH, percent of its allocation spent. Skip wallets marked \`pending\`.`,
+            `- Last few outflows: height, amount in XCH, destination label (or "unknown" if unlabelled). Skip internal rotations between custody wallets.`,
+            ``,
+            `Keep it tight. Plain prose, no tables unless asked.`,
+        ].join('\n');
+        return {
+            messages: [{ role: 'user', content: { type: 'text', text } }],
+        };
+    });
+}
+//# sourceMappingURL=prefarm-summary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefarm-summary.js","sourceRoot":"","sources":["../../src/prompts/prefarm-summary.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,kHAAkH;QACpH,UAAU,EAAE,EAAE;KACf,EACD,GAAG,EAAE;QACH,MAAM,IAAI,GAAG;YACX,2EAA2E;YAC3E,EAAE;YACF,QAAQ;YACR,iFAAiF;YACjF,oFAAoF;YACpF,0EAA0E;YAC1E,EAAE;YACF,yBAAyB;YACzB,iNAAiN;YACjN,+GAA+G;YAC/G,8IAA8I;YAC9I,EAAE;YACF,qDAAqD;SACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,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/schemas/price.d.ts

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

package/dist/schemas/price.js

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

package/dist/schemas/price.js.map

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

package/dist/server.js

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

package/dist/server.js.map

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

package/dist/tools/prefarm/get-prefarm-spends.d.ts

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

package/dist/tools/prefarm/get-prefarm-spends.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+import { mojoToXch } from '../../chia/amounts.js';
+import { getAgent } from '../../coinset/agent.js';
+import { PREFARM_WALLETS, getWalletById, isPopulated } from '../../prefarm/registry.js';
+import { getWalletSpends } from '../../prefarm/spends.js';
+import { errorText, jsonText } from '../shared/response.js';
+const WALLET_IDS = [
+    'us-cold',
+    'us-warm',
+    'ch-cold',
+    'ch-warm',
+];
+export function register(server) {
+    server.tool('get_prefarm_spends', 'List outflows from the Chia strategic reserve. For each spent coin: the source wallet, the destination addresses (labelled when they map to a known partner / market maker / exchange), and amounts. Internal rotations between custody wallets are flagged and excluded from total outflow. Mainnet only.', {
+        wallet_id: z
+            .enum(WALLET_IDS)
+            .optional()
+            .describe('Restrict to one wallet. Omit to query all four.'),
+        limit: z
+            .number()
+            .int()
+            .positive()
+            .max(500)
+            .optional()
+            .describe('Maximum spends to return, sorted newest first. Default 50.'),
+        since_height: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe('Only include spends at or after this block height.'),
+    }, async ({ wallet_id, limit, since_height }) => {
+        try {
+            const targets = wallet_id
+                ? (() => {
+                    const w = getWalletById(wallet_id);
+                    if (!w)
+                        throw new Error(`unknown wallet_id: ${wallet_id}`);
+                    return [w];
+                })()
+                : [...PREFARM_WALLETS];
+            const populated = targets.filter(isPopulated);
+            const pending = targets.filter((w) => !isPopulated(w)).map((w) => w.id);
+            const agent = getAgent('mainnet');
+            const grouped = await Promise.all(populated.map((w) => getWalletSpends(agent, w, {
+                ...(since_height !== undefined ? { sinceHeight: since_height } : {}),
+            })));
+            const all = grouped.flat();
+            all.sort((a, b) => b.spent_height - a.spent_height);
+            const cap = limit ?? 50;
+            const trimmed = all.slice(0, cap);
+            const totalOutflow = all.reduce((acc, s) => acc + BigInt(s.outflow_mojo), 0n);
+            return jsonText({
+                spends: trimmed,
+                total_spend_count: all.length,
+                returned_count: trimmed.length,
+                total_outflow_mojo: totalOutflow.toString(),
+                total_outflow_xch: mojoToXch(totalOutflow),
+                wallets_queried: populated.map((w) => w.id),
+                wallets_pending: pending,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-prefarm-spends.js.map

package/dist/tools/prefarm/get-prefarm-spends.js.map

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

package/dist/tools/prefarm/get-prefarm-status.d.ts

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

package/dist/tools/prefarm/get-prefarm-status.js

@@ -0,0 +1,72 @@
+import { mojoToXch, toBigInt } from '../../chia/amounts.js';
+import { getAgent } from '../../coinset/agent.js';
+import { fetchCoinRecordsByPuzzleHash } from '../../coinset/pagination.js';
+import { PREFARM_WALLETS, TOTAL_PREFARM_ALLOCATION_MOJO, isPopulated, } from '../../prefarm/registry.js';
+import { errorText, jsonText } from '../shared/response.js';
+async function statusForWallet(wallet) {
+    const base = {
+        id: wallet.id,
+        label: wallet.label,
+        region: wallet.region,
+        temperature: wallet.temperature,
+        addresses: wallet.addresses,
+        puzzle_hashes: wallet.puzzleHashes,
+    };
+    if (!isPopulated(wallet)) {
+        return {
+            ...base,
+            balance_mojo: null,
+            balance_xch: null,
+            unspent_coin_count: null,
+            pending: true,
+        };
+    }
+    const agent = getAgent('mainnet');
+    const groups = await Promise.all(wallet.puzzleHashes.map((ph) => fetchCoinRecordsByPuzzleHash(agent, ph, { includeSpent: false })));
+    let balance = 0n;
+    let coinCount = 0;
+    for (const records of groups) {
+        coinCount += records.length;
+        for (const r of records)
+            balance += toBigInt(r.coin.amount);
+    }
+    return {
+        ...base,
+        balance_mojo: balance.toString(),
+        balance_xch: mojoToXch(balance),
+        unspent_coin_count: coinCount,
+        pending: false,
+    };
+}
+export function register(server) {
+    server.tool('get_prefarm_status', 'Aggregate status of the Chia strategic reserve (21M XCH across four custody wallets: US/CH × cold/warm). Per-wallet balances are read live from coinset.org; the only hardcoded amount is the 21M XCH genesis total. Mainnet only.', {}, async () => {
+        try {
+            const wallets = await Promise.all(PREFARM_WALLETS.map(statusForWallet));
+            const trackedBalance = wallets
+                .filter((w) => !w.pending)
+                .reduce((acc, w) => acc + BigInt(w.balance_mojo ?? '0'), 0n);
+            const walletsPending = wallets.filter((w) => w.pending).length;
+            const totalAllocation = TOTAL_PREFARM_ALLOCATION_MOJO;
+            const trackedSpent = totalAllocation - trackedBalance;
+            const spentPct = walletsPending > 0 ? null : Number((trackedSpent * 10000n) / totalAllocation) / 100;
+            return jsonText({
+                wallets,
+                totals: {
+                    allocation_mojo: totalAllocation.toString(),
+                    allocation_xch: mojoToXch(totalAllocation),
+                    tracked_balance_mojo: trackedBalance.toString(),
+                    tracked_balance_xch: mojoToXch(trackedBalance),
+                    tracked_spent_mojo: trackedSpent.toString(),
+                    tracked_spent_xch: mojoToXch(trackedSpent),
+                    tracked_spent_pct: spentPct,
+                },
+                wallets_configured: wallets.filter((w) => !w.pending).length,
+                wallets_pending: walletsPending,
+            });
+        }
+        catch (err) {
+            return errorText(err);
+        }
+    });
+}
+//# sourceMappingURL=get-prefarm-status.js.map

package/dist/tools/prefarm/get-prefarm-status.js.map

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

package/dist/tools/prefarm/list-prefarm-addresses.d.ts

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

package/dist/tools/prefarm/list-prefarm-addresses.js

@@ -0,0 +1,33 @@
+import { mojoToXch } from '../../chia/amounts.js';
+import { KNOWN_DESTINATIONS, PREFARM_WALLETS, TOTAL_PREFARM_ALLOCATION_MOJO, } from '../../prefarm/registry.js';
+import { jsonText } from '../shared/response.js';
+export function register(server) {
+    server.tool('list_prefarm_addresses', 'Return the hardcoded registry of Chia strategic-reserve custody wallets and labelled destination addresses (partners, market makers, exchanges). Identities only — balances are not returned here; call `get_prefarm_status` for live amounts. Pure local data, no network call.', {}, async () => {
+        const wallets = PREFARM_WALLETS.map((w) => ({
+            id: w.id,
+            label: w.label,
+            region: w.region,
+            temperature: w.temperature,
+            addresses: w.addresses,
+            puzzle_hashes: w.puzzleHashes,
+            pending: w.addresses.length === 0,
+        }));
+        const destinations = KNOWN_DESTINATIONS.map((d) => ({
+            address: d.address,
+            puzzle_hash: d.puzzleHash,
+            entity: d.entity,
+            label: d.label,
+            category: d.category,
+        }));
+        return jsonText({
+            wallets,
+            destinations,
+            total_allocation_mojo: TOTAL_PREFARM_ALLOCATION_MOJO.toString(),
+            total_allocation_xch: mojoToXch(TOTAL_PREFARM_ALLOCATION_MOJO),
+            wallets_configured: wallets.filter((w) => !w.pending).length,
+            wallets_pending: wallets.filter((w) => w.pending).length,
+            destinations_configured: destinations.length,
+        });
+    });
+}
+//# sourceMappingURL=list-prefarm-addresses.js.map

package/dist/tools/prefarm/list-prefarm-addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-prefarm-addresses.js","sourceRoot":"","sources":["../../../src/tools/prefarm/list-prefarm-addresses.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,kRAAkR,EAClR,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,aAAa,EAAE,CAAC,CAAC,YAAY;YAC7B,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;SAClC,CAAC,CAAC,CAAC;QACJ,MAAM,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClD,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,WAAW,EAAE,CAAC,CAAC,UAAU;YACzB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;QACJ,OAAO,QAAQ,CAAC;YACd,OAAO;YACP,YAAY;YACZ,qBAAqB,EAAE,6BAA6B,CAAC,QAAQ,EAAE;YAC/D,oBAAoB,EAAE,SAAS,CAAC,6BAA6B,CAAC;YAC9D,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YAC5D,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YACxD,uBAAuB,EAAE,YAAY,CAAC,MAAM;SAC7C,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

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

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

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

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

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

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chia-explorer",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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",