@aibtc/mcp-server 1.16.0 → 1.17.0

package/dist/services/mempool-api.d.ts

@@ -171,6 +171,20 @@ export declare class MempoolApi {
      * ```
      */
     broadcastTransaction(txHex: string): Promise<string>;
+    /**
+     * Get raw transaction hex by txid
+     *
+     * @param txid - Transaction ID
+     * @returns Transaction as hex string
+     * @throws Error if API request fails
+     *
+     * @example
+     * ```typescript
+     * const api = new MempoolApi('mainnet');
+     * const txHex = await api.getTxHex('abc123...');
+     * ```
+     */
+    getTxHex(txid: string): Promise<string>;
     /**
      * Get the network this client is configured for
      */

package/dist/services/mempool-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mempool-api.d.ts","sourceRoot":"","sources":["../../src/services/mempool-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,EAAE,OAAO;IAK5B;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAchD;;;;;;;;;;;;OAYG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAc9C;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAStC;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD;;;;;;OAMG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3D;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB1D;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE7D"}
+{"version":3,"file":"mempool-api.d.ts","sourceRoot":"","sources":["../../src/services/mempool-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIzD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,EAAE,OAAO;IAK5B;;;;;;;;;;;;;OAaG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAchD;;;;;;;;;;;;OAYG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAc9C;;;;;;;;;;OAUG;IACG,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC;IAStC;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD;;;;;;OAMG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3D;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB1D;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7C;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE7D"}

package/dist/services/mempool-api.js

@@ -163,6 +163,28 @@ export class MempoolApi {
         const txid = await response.text();
         return txid.trim();
     }
+    /**
+     * Get raw transaction hex by txid
+     *
+     * @param txid - Transaction ID
+     * @returns Transaction as hex string
+     * @throws Error if API request fails
+     *
+     * @example
+     * ```typescript
+     * const api = new MempoolApi('mainnet');
+     * const txHex = await api.getTxHex('abc123...');
+     * ```
+     */
+    async getTxHex(txid) {
+        const response = await fetch(`${this.baseUrl}/tx/${txid}/hex`);
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => "Unknown error");
+            throw new Error(`Failed to fetch transaction hex for ${txid}: ${response.status} ${response.statusText} - ${errorText}`);
+        }
+        const txHex = await response.text();
+        return txHex.trim();
+    }
     /**
      * Get the network this client is configured for
      */

package/dist/services/mempool-api.js.map

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

package/dist/services/sbtc-deposit.service.d.ts

@@ -0,0 +1,246 @@
+/**
+ * sBTC Deposit Service
+ *
+ * Handles Bitcoin → sBTC deposits using the sbtc library
+ *
+ * Flow:
+ * 1. Generate a deposit address (with reclaim script for recovery)
+ * 2. Build and sign a Bitcoin transaction to deposit BTC
+ * 3. Broadcast the transaction and notify the sBTC system
+ * 4. sBTC tokens are minted on Stacks L2 after confirmation
+ *
+ * @example
+ * ```typescript
+ * const service = getSbtcDepositService('mainnet');
+ *
+ * // Step 1: Get signers public key and build deposit address
+ * const signersPublicKey = await service.getSignersPublicKey();
+ * const depositAddressInfo = await service.buildDepositAddress(
+ *   'SP2XD7417HGPRTREMKF748VNEQPDRR0RMANB7X1NK', // Stacks address
+ *   'abc123...', // Reclaim public key (32-byte x-only)
+ *   80000, // Max signer fee
+ *   950 // Reclaim lock time (blocks)
+ * );
+ *
+ * // Step 2: Build deposit transaction
+ * const depositResult = await service.buildDepositTransaction(
+ *   100000, // Amount in sats
+ *   'SP2XD7417HGPRTREMKF748VNEQPDRR0RMANB7X1NK',
+ *   'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh',
+ *   'abc123...', // Reclaim public key (32-byte x-only)
+ *   10 // Fee rate sat/vB
+ * );
+ *
+ * // Step 3: Sign the transaction with user's private key
+ * // (signing logic handled by caller)
+ *
+ * // Step 4: Broadcast and notify
+ * const { txid, notification } = await service.broadcastAndNotify(
+ *   signedTxHex,
+ *   depositResult.depositScript,
+ *   depositResult.reclaimScript,
+ *   0 // vout
+ * );
+ *
+ * // Step 5: Poll for completion
+ * const finalStatus = await service.pollDepositStatus(txid, 0);
+ *
+ * // OR use the high-level helper that chains all steps:
+ * const result = await service.deposit(
+ *   100000,
+ *   'SP2XD7417HGPRTREMKF748VNEQPDRR0RMANB7X1NK',
+ *   'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh',
+ *   '03abc123...',
+ *   10,
+ *   async (txHex) => {
+ *     // Sign transaction and return signed hex
+ *     return signedTxHex;
+ *   }
+ * );
+ * ```
+ */
+import type { Network } from "../config/networks.js";
+/**
+ * Result from generating a deposit address
+ */
+export interface DepositAddressResult {
+    /**
+     * Bitcoin Taproot address to send BTC to
+     */
+    depositAddress: string;
+    /**
+     * Deposit script (hex) - proves deposit to sBTC system
+     */
+    depositScript: string;
+    /**
+     * Reclaim script (hex) - allows recovery if deposit fails
+     */
+    reclaimScript: string;
+    /**
+     * Max fee the sBTC system will charge (satoshis)
+     */
+    maxFee: number;
+    /**
+     * Lock time for the deposit (blocks)
+     */
+    lockTime: number;
+}
+/**
+ * Result from building a deposit transaction
+ */
+export interface DepositTransactionResult {
+    /**
+     * Signed transaction hex
+     */
+    txHex: string;
+    /**
+     * Transaction ID
+     */
+    txid: string;
+    /**
+     * Deposit amount in satoshis
+     */
+    amount: number;
+    /**
+     * Output index containing the deposit
+     */
+    vout: number;
+}
+/**
+ * Complete deposit result (transaction + scripts)
+ */
+export interface DepositResult extends DepositTransactionResult {
+    depositScript: string;
+    reclaimScript: string;
+}
+/**
+ * sBTC Deposit Service
+ */
+export declare class SbtcDepositService {
+    private readonly apiClient;
+    private readonly mempoolApi;
+    private readonly network;
+    constructor(network: Network);
+    /**
+     * Get Bitcoin network constants for the configured network
+     */
+    private getBitcoinNetwork;
+    /**
+     * Convert MempoolApi UTXOs to sbtc's UtxoWithTx format
+     *
+     * The sbtc package requires UTXOs with raw transaction hex attached.
+     * This method fetches the tx hex for each UTXO via mempool.space API.
+     */
+    private convertUtxos;
+    /**
+     * Get the signers aggregate public key from the sBTC registry contract
+     *
+     * The signers public key is used to build the deposit address script.
+     * This is fetched from the sbtc-registry contract on Stacks L2.
+     */
+    getSignersPublicKey(): Promise<string>;
+    /**
+     * Build a Taproot deposit address for sBTC deposits
+     *
+     * The deposit address contains two spending paths:
+     * 1. Deposit script - sBTC signers can spend to mint sBTC on Stacks
+     * 2. Reclaim script - User can reclaim BTC after lockTime if deposit fails
+     *
+     * @param stacksAddress - Stacks L2 address to receive sBTC (SP... or ST...)
+     * @param reclaimPublicKey - Public key for reclaim path (hex, 32-byte x-only Taproot internal public key)
+     * @param maxSignerFee - Max fee sBTC system can charge in satoshis (default: 80000)
+     * @param reclaimLockTime - Block height when reclaim becomes available (default: 950 blocks)
+     * @returns Deposit address and scripts
+     */
+    buildDepositAddress(stacksAddress: string, reclaimPublicKey: string, maxSignerFee?: number, reclaimLockTime?: number): Promise<DepositAddressResult>;
+    /**
+     * Build an sBTC deposit transaction, optionally signed
+     *
+     * This method:
+     * 1. Fetches UTXOs for the Bitcoin address
+     * 2. Builds a deposit address with deposit/reclaim scripts
+     * 3. Constructs a transaction that sends BTC to the deposit address
+     * 4. If `privateKey` is provided, signs and finalizes the transaction
+     * 5. Returns the transaction hex (signed or unsigned), txid, and deposit details
+     *
+     * @param amountSats - Amount to deposit in satoshis
+     * @param stacksAddress - Stacks L2 address to receive sBTC
+     * @param bitcoinAddress - Bitcoin L1 address to send from (for UTXOs and change)
+     * @param reclaimPublicKey - Public key for reclaim path (hex, 32-byte x-only Taproot internal public key)
+     * @param feeRate - Fee rate in sat/vB
+     * @param maxSignerFee - Max fee sBTC system can charge (default: 80000 sats)
+     * @param reclaimLockTime - Block height when reclaim becomes available (default: 950)
+     * @param privateKey - Optional BTC private key (Uint8Array) to sign the transaction.
+     *                     When provided, signs using the sbtc package's internal @scure/btc-signer
+     *                     to avoid version mismatch issues. The inputs are P2WPKH from the user's address.
+     * @param includeOrdinals - Include UTXOs with inscriptions (default: false for safety).
+     *                          WARNING: Setting this to true may destroy valuable inscriptions!
+     * @returns Transaction hex (signed if privateKey provided), txid, and deposit details
+     */
+    buildDepositTransaction(amountSats: number, stacksAddress: string, bitcoinAddress: string, reclaimPublicKey: string, feeRate: number, maxSignerFee?: number, reclaimLockTime?: number, privateKey?: Uint8Array, includeOrdinals?: boolean): Promise<DepositResult>;
+    /**
+     * Get deposit status from Emily API
+     *
+     * @param txid - Bitcoin transaction ID
+     * @param vout - Output index (optional, defaults to 0)
+     * @returns Deposit status and details
+     */
+    getDepositStatus(txid: string, vout?: number): Promise<unknown>;
+    /**
+     * Broadcast signed transaction and notify Emily API
+     *
+     * This method:
+     * 1. Broadcasts the signed Bitcoin transaction to the mempool
+     * 2. Notifies the Emily API about the deposit (required for sBTC minting)
+     *
+     * @param signedTxHex - Signed transaction hex string
+     * @param depositScript - Deposit script hex (from buildDepositTransaction)
+     * @param reclaimScript - Reclaim script hex (from buildDepositTransaction)
+     * @param vout - Output index containing the deposit (default: 0)
+     * @returns Transaction ID and notification response
+     */
+    broadcastAndNotify(signedTxHex: string, depositScript: string, reclaimScript: string, vout?: number): Promise<{
+        txid: string;
+        notification: unknown;
+    }>;
+    /**
+     * Poll Emily API for deposit status until completed or timeout
+     *
+     * Terminal states:
+     * - "completed" - Deposit successful, sBTC minted
+     * - "failed" - Deposit failed
+     *
+     * @param txid - Bitcoin transaction ID
+     * @param vout - Output index (default: 0)
+     * @param pollIntervalMs - Polling interval in milliseconds (default: 30000 / 30 seconds)
+     * @param timeoutMs - Max wait time in milliseconds (default: 7200000 / 2 hours)
+     * @returns Final deposit status
+     * @throws Error if deposit fails or polling times out
+     */
+    pollDepositStatus(txid: string, vout?: number, pollIntervalMs?: number, timeoutMs?: number): Promise<unknown>;
+    /**
+     * High-level deposit helper that chains all steps
+     *
+     * This method:
+     * 1. Builds the deposit transaction
+     * 2. Calls the provided signTransaction callback to sign it
+     * 3. Broadcasts the signed transaction and notifies Emily API
+     *
+     * @param amountSats - Amount to deposit in satoshis
+     * @param stacksAddress - Stacks L2 address to receive sBTC
+     * @param bitcoinAddress - Bitcoin L1 address to send from
+     * @param reclaimPublicKey - Public key for reclaim path (hex, 32-byte x-only Taproot internal public key)
+     * @param feeRate - Fee rate in sat/vB
+     * @param signTransaction - Callback function to sign the transaction hex
+     * @param maxSignerFee - Max fee sBTC system can charge (default: 80000 sats)
+     * @param reclaimLockTime - Block height when reclaim becomes available (default: 950)
+     * @param includeOrdinals - Include UTXOs with inscriptions (default: false for safety)
+     * @returns Broadcast result with txid and notification
+     */
+    deposit(amountSats: number, stacksAddress: string, bitcoinAddress: string, reclaimPublicKey: string, feeRate: number, signTransaction: (txHex: string) => Promise<string>, maxSignerFee?: number, reclaimLockTime?: number, includeOrdinals?: boolean): Promise<{
+        txid: string;
+        notification: unknown;
+    }>;
+}
+export declare function getSbtcDepositService(network: Network): SbtcDepositService;
+//# sourceMappingURL=sbtc-deposit.service.d.ts.map

package/dist/services/sbtc-deposit.service.d.ts.map

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