@aibtc/mcp-server 1.49.0 → 1.50.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.49.0",
+  "version": "1.50.0",
   "description": "Bitcoin-native MCP server for AI agents: BTC/STX wallets, DeFi yield, sBTC peg, NFTs, and x402 payments.",
   "mcpName": "io.github.aibtcdev/mcp-server",
   "type": "module",
@@ -65,6 +65,7 @@
     "light-bolt11-decoder": "^3.2.0",
     "micro-ordinals": "^0.3.0",
     "nostr-tools": "^2.23.3",
+    "path-to-regexp": "^8.4.0",
     "sbtc": "^0.3.2",
     "tslib": "^2.8.1",
     "ws": "^8.19.0",
@@ -76,5 +77,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
+  },
+  "overrides": {
+    "lodash": "^4.18.0"
   }
 }

package/skill/SKILL.md

@@ -4,7 +4,7 @@ description: Bitcoin L1 wallet for agents - check balances, send BTC, manage UTX
 license: MIT
 metadata:
   author: aibtcdev
-  version: 1.49.0 # x-release-please-version
+  version: 1.50.0 # x-release-please-version
   npm: "@aibtc/mcp-server"
   github: https://github.com/aibtcdev/aibtc-mcp-server
 ---

package/dist/services/ordinal-indexer.d.ts

@@ -1,128 +0,0 @@
-/**
- * Ordinal Indexer Service
- *
- * Combines Hiro Ordinals API with mempool.space to classify UTXOs:
- * - Cardinal: Safe to spend (no inscriptions)
- * - Ordinal: Contains inscriptions (must not spend accidentally)
- *
- * Uses free APIs:
- * - Hiro Ordinals API: https://api.hiro.so/ordinals/v1/inscriptions?address={address}
- * - mempool.space API: via MempoolApi service
- */
-import type { Network } from "../config/networks.js";
-import type { UTXO } from "./mempool-api.js";
-/**
- * Inscription data from Hiro Ordinals API
- */
-export interface Inscription {
-    /**
-     * Inscription ID (txid + inscription number)
-     */
-    id: string;
-    /**
-     * Inscription number (global ordinal)
-     */
-    number: number;
-    /**
-     * Content type (e.g., "text/plain", "image/png")
-     */
-    content_type: string;
-    /**
-     * Content length in bytes
-     */
-    content_length: number;
-    /**
-     * Genesis transaction ID
-     */
-    genesis_tx_id: string;
-    /**
-     * Genesis block height
-     */
-    genesis_block_height: number;
-    /**
-     * Genesis block hash
-     */
-    genesis_block_hash: string;
-    /**
-     * Genesis timestamp
-     */
-    genesis_timestamp: number;
-    /**
-     * Location of the inscription (txid:vout:offset)
-     */
-    location: string;
-    /**
-     * Output reference (txid:vout) - this is what we use to match UTXOs
-     */
-    output: string;
-    /**
-     * Current owner address
-     */
-    address: string;
-    /**
-     * Offset within the output
-     */
-    offset: string;
-}
-/**
- * Classified UTXOs
- */
-export interface ClassifiedUtxos {
-    /**
-     * Cardinal UTXOs - safe to spend (no inscriptions)
-     */
-    cardinal: UTXO[];
-    /**
-     * Ordinal UTXOs - contain inscriptions (do not spend)
-     */
-    ordinal: UTXO[];
-}
-/**
- * Ordinal Indexer Service
- *
- * Note: Hiro Ordinals API only supports mainnet. On testnet, all UTXOs are
- * treated as cardinal (safe to spend) since we cannot index inscriptions.
- */
-export declare class OrdinalIndexer {
-    private readonly network;
-    private readonly mempoolApi;
-    private readonly isMainnet;
-    constructor(network: Network);
-    /**
-     * Get all inscriptions for a Bitcoin address
-     *
-     * @param address - Bitcoin address (bc1... for mainnet)
-     * @returns Array of inscriptions with their output references (empty on testnet)
-     * @throws Error if API request fails
-     */
-    getInscriptionsForAddress(address: string): Promise<Inscription[]>;
-    /**
-     * Classify UTXOs into cardinal (safe to spend) and ordinal (contains inscriptions)
-     *
-     * @param address - Bitcoin address
-     * @returns Classified UTXOs
-     * @throws Error if API requests fail
-     */
-    classifyUtxos(address: string): Promise<ClassifiedUtxos>;
-    /**
-     * Get cardinal UTXOs (safe to spend - no inscriptions)
-     *
-     * @param address - Bitcoin address
-     * @returns Cardinal UTXOs only
-     * @throws Error if API requests fail
-     */
-    getCardinalUtxos(address: string): Promise<UTXO[]>;
-    /**
-     * Get ordinal UTXOs (contain inscriptions - do not spend)
-     *
-     * @param address - Bitcoin address
-     * @returns Ordinal UTXOs only
-     * @throws Error if API requests fail
-     */
-    getOrdinalUtxos(address: string): Promise<UTXO[]>;
-}
-/**
- * Create an ordinal indexer for the given network
- */
-export declare function createOrdinalIndexer(network: Network): OrdinalIndexer;
-//# sourceMappingURL=ordinal-indexer.d.ts.map

package/dist/services/ordinal-indexer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ordinal-indexer.d.ts","sourceRoot":"","sources":["../../src/services/ordinal-indexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAYD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,IAAI,EAAE,CAAC;CACjB;AAID;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;gBAExB,OAAO,EAAE,OAAO;IAM5B;;;;;;OAMG;IACG,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA8CxE;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6B9D;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAKxD;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;CAKxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAErE"}

package/dist/services/ordinal-indexer.js

@@ -1,126 +0,0 @@
-/**
- * Ordinal Indexer Service
- *
- * Combines Hiro Ordinals API with mempool.space to classify UTXOs:
- * - Cardinal: Safe to spend (no inscriptions)
- * - Ordinal: Contains inscriptions (must not spend accidentally)
- *
- * Uses free APIs:
- * - Hiro Ordinals API: https://api.hiro.so/ordinals/v1/inscriptions?address={address}
- * - mempool.space API: via MempoolApi service
- */
-import { MempoolApi } from "./mempool-api.js";
-import { HiroApiRateLimitError } from "./hiro-api.js";
-const HIRO_ORDINALS_API_URL = "https://api.hiro.so/ordinals/v1";
-/**
- * Ordinal Indexer Service
- *
- * Note: Hiro Ordinals API only supports mainnet. On testnet, all UTXOs are
- * treated as cardinal (safe to spend) since we cannot index inscriptions.
- */
-export class OrdinalIndexer {
-    network;
-    mempoolApi;
-    isMainnet;
-    constructor(network) {
-        this.network = network;
-        this.mempoolApi = new MempoolApi(network);
-        this.isMainnet = network === "mainnet";
-    }
-    /**
-     * Get all inscriptions for a Bitcoin address
-     *
-     * @param address - Bitcoin address (bc1... for mainnet)
-     * @returns Array of inscriptions with their output references (empty on testnet)
-     * @throws Error if API request fails
-     */
-    async getInscriptionsForAddress(address) {
-        // Testnet: return empty (Hiro API doesn't index testnet inscriptions)
-        if (!this.isMainnet) {
-            return [];
-        }
-        const allInscriptions = [];
-        let offset = 0;
-        const limit = 60; // Hiro API default/max per page
-        // Fetch all pages
-        while (true) {
-            const url = `${HIRO_ORDINALS_API_URL}/inscriptions?address=${address}&limit=${limit}&offset=${offset}`;
-            const response = await fetch(url);
-            if (!response.ok) {
-                if (response.status === 429) {
-                    const retryAfter = response.headers.get("Retry-After");
-                    const retryAfterSeconds = retryAfter && !isNaN(parseInt(retryAfter, 10)) ? parseInt(retryAfter, 10) : 60;
-                    throw new HiroApiRateLimitError(`Hiro Ordinals API rate limit exceeded. Retry after ${retryAfterSeconds}s`, retryAfterSeconds);
-                }
-                const errorText = await response.text().catch(() => "Unknown error");
-                throw new Error(`Failed to fetch inscriptions from Hiro API: ${response.status} ${response.statusText} - ${errorText}`);
-            }
-            const data = (await response.json());
-            allInscriptions.push(...data.results);
-            // Check if we've fetched all inscriptions
-            if (offset + data.results.length >= data.total) {
-                break;
-            }
-            offset += limit;
-        }
-        return allInscriptions;
-    }
-    /**
-     * Classify UTXOs into cardinal (safe to spend) and ordinal (contains inscriptions)
-     *
-     * @param address - Bitcoin address
-     * @returns Classified UTXOs
-     * @throws Error if API requests fail
-     */
-    async classifyUtxos(address) {
-        // Fetch UTXOs from mempool.space
-        const utxos = await this.mempoolApi.getUtxos(address);
-        // Fetch inscriptions from Hiro Ordinals API
-        const inscriptions = await this.getInscriptionsForAddress(address);
-        // Build set of outputs that contain inscriptions
-        // Hiro API returns "output" field as "txid:vout"
-        const ordinalOutputs = new Set(inscriptions.map((inscription) => inscription.output));
-        // Classify UTXOs
-        const cardinal = [];
-        const ordinal = [];
-        for (const utxo of utxos) {
-            const outputRef = `${utxo.txid}:${utxo.vout}`;
-            if (ordinalOutputs.has(outputRef)) {
-                ordinal.push(utxo);
-            }
-            else {
-                cardinal.push(utxo);
-            }
-        }
-        return { cardinal, ordinal };
-    }
-    /**
-     * Get cardinal UTXOs (safe to spend - no inscriptions)
-     *
-     * @param address - Bitcoin address
-     * @returns Cardinal UTXOs only
-     * @throws Error if API requests fail
-     */
-    async getCardinalUtxos(address) {
-        const classified = await this.classifyUtxos(address);
-        return classified.cardinal;
-    }
-    /**
-     * Get ordinal UTXOs (contain inscriptions - do not spend)
-     *
-     * @param address - Bitcoin address
-     * @returns Ordinal UTXOs only
-     * @throws Error if API requests fail
-     */
-    async getOrdinalUtxos(address) {
-        const classified = await this.classifyUtxos(address);
-        return classified.ordinal;
-    }
-}
-/**
- * Create an ordinal indexer for the given network
- */
-export function createOrdinalIndexer(network) {
-    return new OrdinalIndexer(network);
-}
-//# sourceMappingURL=ordinal-indexer.js.map

package/dist/services/ordinal-indexer.js.map

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