@aibtc/mcp-server 1.30.0 → 1.30.2

package/dist/tools/psbt.tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPsbtTools(server: McpServer): void;
+//# sourceMappingURL=psbt.tools.d.ts.map

package/dist/tools/psbt.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psbt.tools.d.ts","sourceRoot":"","sources":["../../src/tools/psbt.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuFpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgYzD"}

package/dist/tools/psbt.tools.js

@@ -0,0 +1,384 @@
+import * as btc from "@scure/btc-signer";
+import { z } from "zod";
+import { NETWORK } from "../config/networks.js";
+import { DUST_THRESHOLD, P2TR_INPUT_BASE_VBYTES, P2WPKH_INPUT_VBYTES, } from "../config/bitcoin-constants.js";
+import { MempoolApi, getMempoolTxUrl } from "../services/mempool-api.js";
+import { getWalletManager } from "../services/wallet-manager.js";
+import { getBtcNetwork } from "../transactions/bitcoin-builder.js";
+import { createErrorResponse, createJsonResponse } from "../utils/index.js";
+import { estimateBuyPsbtFeeSats, parseOutpoint } from "./psbt.helpers.js";
+function decodePsbtBase64(psbtBase64) {
+    const bytes = Buffer.from(psbtBase64, "base64");
+    if (bytes.length === 0) {
+        throw new Error("Invalid PSBT: empty base64 payload");
+    }
+    return btc.Transaction.fromPSBT(bytes, {
+        allowUnknownInputs: true,
+        allowUnknownOutputs: true,
+        disableScriptCheck: true,
+    });
+}
+function encodePsbtBase64(tx) {
+    return Buffer.from(tx.toPSBT()).toString("base64");
+}
+function decodeScriptType(script) {
+    try {
+        return btc.OutScript.decode(script).type;
+    }
+    catch {
+        return "unknown";
+    }
+}
+function detectInputScriptType(input) {
+    if (!input.witnessUtxo?.script) {
+        return "unknown";
+    }
+    return decodeScriptType(input.witnessUtxo.script);
+}
+function getInputSigningStatus(input) {
+    if (input.finalScriptSig || input.finalScriptWitness) {
+        return "finalized";
+    }
+    if (input.partialSig?.length || input.tapKeySig) {
+        return "partially_signed";
+    }
+    return "unsigned";
+}
+function chooseSellerInputVbytes(scriptType) {
+    if (scriptType === "tr" || scriptType === "tr_ms" || scriptType === "tr_ns") {
+        return Math.ceil(P2TR_INPUT_BASE_VBYTES + 16);
+    }
+    if (scriptType === "wpkh") {
+        return P2WPKH_INPUT_VBYTES;
+    }
+    return 90;
+}
+function resolveFeeRateWithTiers(feeRate, tiers) {
+    if (typeof feeRate === "number") {
+        return feeRate;
+    }
+    switch (feeRate) {
+        case "fast":
+            return tiers.fast;
+        case "slow":
+            return tiers.slow;
+        case "medium":
+        default:
+            return tiers.medium;
+    }
+}
+export function registerPsbtTools(server) {
+    server.registerTool("psbt_create_ordinal_buy", {
+        description: "Create a PSBT for buying an ordinal: buyer pays seller in BTC, seller's inscription UTXO is transferred to buyer. " +
+            "This prepares the PSBT for both parties to sign.",
+        inputSchema: {
+            inscriptionUtxo: z
+                .string()
+                .describe("Seller inscription outpoint in txid:vout format"),
+            sellerAddress: z.string().describe("Seller BTC address to receive payment"),
+            priceSats: z
+                .number()
+                .int()
+                .positive()
+                .describe("Purchase price in satoshis paid to seller"),
+            buyerReceiveAddress: z
+                .string()
+                .describe("Buyer BTC address that will receive the inscription UTXO"),
+            feeRate: z
+                .union([z.enum(["fast", "medium", "slow"]), z.number().positive()])
+                .optional()
+                .default("medium")
+                .describe("Fee rate: 'fast' (~10 min), 'medium' (~30 min), 'slow' (~1 hr), or explicit sat/vB"),
+        },
+    }, async ({ inscriptionUtxo, sellerAddress, priceSats, buyerReceiveAddress, feeRate }) => {
+        try {
+            const walletManager = getWalletManager();
+            const account = walletManager.getActiveAccount();
+            if (!account?.btcAddress || !account.btcPublicKey) {
+                throw new Error("Wallet must be unlocked with Bitcoin keys. Use wallet_unlock first.");
+            }
+            const outpoint = parseOutpoint(inscriptionUtxo);
+            const mempool = new MempoolApi(NETWORK);
+            const btcNetwork = getBtcNetwork(NETWORK);
+            const sellerTxHex = await mempool.getTxHex(outpoint.txid);
+            const sellerTx = btc.Transaction.fromRaw(Buffer.from(sellerTxHex, "hex"), {
+                allowUnknownInputs: true,
+                allowUnknownOutputs: true,
+                disableScriptCheck: true,
+            });
+            if (outpoint.vout >= sellerTx.outputsLength) {
+                throw new Error(`Invalid outpoint: vout ${outpoint.vout} out of range (outputs=${sellerTx.outputsLength})`);
+            }
+            const inscriptionOutput = sellerTx.getOutput(outpoint.vout);
+            if (inscriptionOutput.amount === undefined || inscriptionOutput.script === undefined) {
+                throw new Error("Inscription outpoint is missing amount/script in source transaction.");
+            }
+            const inscriptionAmount = inscriptionOutput.amount;
+            const inscriptionScript = inscriptionOutput.script;
+            const inscriptionValueSats = Number(inscriptionAmount);
+            if (!Number.isSafeInteger(inscriptionValueSats) || inscriptionValueSats <= 0) {
+                throw new Error("Inscription output amount is invalid or too large.");
+            }
+            const sellerScriptType = decodeScriptType(inscriptionScript);
+            const sellerInputVbytes = chooseSellerInputVbytes(sellerScriptType);
+            const feeTiers = await mempool.getFeeTiers();
+            const resolvedFeeRate = resolveFeeRateWithTiers(feeRate, feeTiers);
+            const utxos = (await mempool.getUtxos(account.btcAddress))
+                .filter((u) => u.status.confirmed)
+                .filter((u) => !(u.txid.toLowerCase() === outpoint.txid && u.vout === outpoint.vout))
+                .sort((a, b) => b.value - a.value);
+            if (utxos.length === 0) {
+                throw new Error(`No confirmed buyer UTXOs available at ${account.btcAddress}. Fund the wallet first.`);
+            }
+            const selectedUtxos = [];
+            let selectedTotal = 0;
+            let estimatedFee = 0;
+            for (const utxo of utxos) {
+                selectedUtxos.push(utxo);
+                selectedTotal += utxo.value;
+                estimatedFee = estimateBuyPsbtFeeSats({
+                    feeRate: resolvedFeeRate,
+                    buyerInputCount: selectedUtxos.length,
+                    sellerInputVbytes,
+                    outputCount: 3,
+                });
+                if (selectedTotal >= priceSats + estimatedFee) {
+                    break;
+                }
+            }
+            if (selectedTotal < priceSats + estimatedFee) {
+                throw new Error(`Insufficient buyer funds: have ${selectedTotal} sats, need at least ${priceSats + estimatedFee} sats.`);
+            }
+            const changeSats = selectedTotal - priceSats - estimatedFee;
+            const includeChange = changeSats >= DUST_THRESHOLD;
+            const tx = new btc.Transaction({
+                allowUnknownInputs: true,
+                allowUnknownOutputs: true,
+                disableScriptCheck: true,
+            });
+            tx.addInput({
+                txid: outpoint.txid,
+                index: outpoint.vout,
+                witnessUtxo: {
+                    amount: inscriptionAmount,
+                    script: inscriptionScript,
+                },
+            });
+            const buyerP2wpkh = btc.p2wpkh(account.btcPublicKey, btcNetwork);
+            for (const utxo of selectedUtxos) {
+                tx.addInput({
+                    txid: utxo.txid,
+                    index: utxo.vout,
+                    witnessUtxo: {
+                        amount: BigInt(utxo.value),
+                        script: buyerP2wpkh.script,
+                    },
+                });
+            }
+            tx.addOutputAddress(buyerReceiveAddress, inscriptionAmount, btcNetwork);
+            tx.addOutputAddress(sellerAddress, BigInt(priceSats), btcNetwork);
+            if (includeChange) {
+                tx.addOutputAddress(account.btcAddress, BigInt(changeSats), btcNetwork);
+            }
+            const psbtBase64 = encodePsbtBase64(tx);
+            return createJsonResponse({
+                success: true,
+                network: NETWORK,
+                psbtBase64,
+                summary: {
+                    inscriptionUtxo: `${outpoint.txid}:${outpoint.vout}`,
+                    inscriptionValueSats,
+                    sellerAddress,
+                    buyerFundingAddress: account.btcAddress,
+                    buyerReceiveAddress,
+                    priceSats,
+                    feeRate: resolvedFeeRate,
+                    estimatedFeeSats: estimatedFee,
+                    buyerInputCount: selectedUtxos.length,
+                    includesChange: includeChange,
+                    changeSats: includeChange ? changeSats : 0,
+                    sellerInputScriptType: sellerScriptType,
+                    sellerInputIndex: 0,
+                    buyerInputIndexes: selectedUtxos.map((_, idx) => idx + 1),
+                },
+                nextSteps: [
+                    "1. Share PSBT with seller to sign seller input (index 0)",
+                    "2. Sign buyer inputs with psbt_sign",
+                    "3. Finalize and broadcast with psbt_broadcast",
+                ],
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    server.registerTool("psbt_sign", {
+        description: "Sign one or more PSBT inputs with the active wallet. Supports buyer (P2WPKH) and taproot keys.",
+        inputSchema: {
+            psbtBase64: z.string().describe("PSBT in base64 format"),
+            signInputs: z
+                .array(z.number().int().nonnegative())
+                .optional()
+                .describe("Optional input indexes to sign. Signs all signable inputs if omitted."),
+            finalizeSignedInputs: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Finalize only the inputs signed in this call"),
+        },
+    }, async ({ psbtBase64, signInputs, finalizeSignedInputs }) => {
+        try {
+            const walletManager = getWalletManager();
+            const account = walletManager.getActiveAccount();
+            if (!account?.btcPrivateKey && !account?.taprootPrivateKey) {
+                throw new Error("No BTC signing keys available. Unlock wallet first with wallet_unlock.");
+            }
+            const tx = decodePsbtBase64(psbtBase64);
+            const indexes = signInputs && signInputs.length > 0
+                ? Array.from(new Set(signInputs))
+                : Array.from({ length: tx.inputsLength }, (_, i) => i);
+            const signedInputs = [];
+            const skippedInputs = [];
+            const finalizedInputs = [];
+            for (const idx of indexes) {
+                if (idx < 0 || idx >= tx.inputsLength) {
+                    skippedInputs.push({ index: idx, reason: "input index out of range" });
+                    continue;
+                }
+                let signed = false;
+                const errors = [];
+                if (account.btcPrivateKey) {
+                    try {
+                        signed = tx.signIdx(account.btcPrivateKey, idx) || signed;
+                    }
+                    catch (e) {
+                        errors.push(`btc key: ${String(e)}`);
+                    }
+                }
+                if (!signed && account.taprootPrivateKey) {
+                    try {
+                        signed = tx.signIdx(account.taprootPrivateKey, idx) || signed;
+                    }
+                    catch (e) {
+                        errors.push(`taproot key: ${String(e)}`);
+                    }
+                }
+                if (!signed) {
+                    skippedInputs.push({
+                        index: idx,
+                        reason: errors.length > 0 ? errors.join(" | ") : "no matching key for this input",
+                    });
+                    continue;
+                }
+                signedInputs.push(idx);
+                if (finalizeSignedInputs) {
+                    try {
+                        tx.finalizeIdx(idx);
+                        finalizedInputs.push(idx);
+                    }
+                    catch (e) {
+                        skippedInputs.push({
+                            index: idx,
+                            reason: `signed but not finalizable yet: ${String(e)}`,
+                        });
+                    }
+                }
+            }
+            return createJsonResponse({
+                success: signedInputs.length > 0,
+                network: NETWORK,
+                signedInputs,
+                finalizedInputs,
+                skippedInputs,
+                psbtBase64: encodePsbtBase64(tx),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    server.registerTool("psbt_broadcast", {
+        description: "Finalize a fully signed PSBT and broadcast it to the Bitcoin network via mempool.space.",
+        inputSchema: {
+            psbtBase64: z.string().describe("Fully signed PSBT in base64 format"),
+        },
+    }, async ({ psbtBase64 }) => {
+        try {
+            const tx = decodePsbtBase64(psbtBase64);
+            tx.finalize();
+            const rawTx = tx.extract();
+            const txHex = Buffer.from(rawTx).toString("hex");
+            const mempool = new MempoolApi(NETWORK);
+            const txid = await mempool.broadcastTransaction(txHex);
+            return createJsonResponse({
+                success: true,
+                network: NETWORK,
+                txid,
+                explorerUrl: getMempoolTxUrl(txid, NETWORK),
+                txHex,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    server.registerTool("psbt_decode", {
+        description: "Decode a PSBT to inspect inputs, outputs, signatures, and signing status before broadcast.",
+        inputSchema: {
+            psbtBase64: z.string().describe("PSBT in base64 format"),
+        },
+    }, async ({ psbtBase64 }) => {
+        try {
+            const tx = decodePsbtBase64(psbtBase64);
+            const btcNetwork = getBtcNetwork(NETWORK);
+            const inputs = Array.from({ length: tx.inputsLength }, (_, idx) => {
+                const input = tx.getInput(idx);
+                const txidHex = input.txid
+                    ? Buffer.from(input.txid).toString("hex")
+                    : undefined;
+                return {
+                    index: idx,
+                    outpoint: txidHex !== undefined ? `${txidHex}:${input.index}` : undefined,
+                    scriptType: detectInputScriptType(input),
+                    amountSats: input.witnessUtxo?.amount?.toString(),
+                    hasWitnessUtxo: !!input.witnessUtxo,
+                    hasNonWitnessUtxo: !!input.nonWitnessUtxo,
+                    partialSigCount: input.partialSig?.length ?? 0,
+                    hasTapKeySig: !!input.tapKeySig,
+                    status: getInputSigningStatus(input),
+                };
+            });
+            const outputs = Array.from({ length: tx.outputsLength }, (_, idx) => {
+                const output = tx.getOutput(idx);
+                return {
+                    index: idx,
+                    amountSats: output.amount?.toString(),
+                    address: tx.getOutputAddress(idx, btcNetwork),
+                    scriptHex: output.script ? Buffer.from(output.script).toString("hex") : undefined,
+                };
+            });
+            let feeSats;
+            try {
+                feeSats = tx.fee.toString();
+            }
+            catch {
+                feeSats = undefined;
+            }
+            return createJsonResponse({
+                network: NETWORK,
+                txidIfFinalized: tx.isFinal ? tx.id : undefined,
+                isFinal: tx.isFinal,
+                inputsLength: tx.inputsLength,
+                outputsLength: tx.outputsLength,
+                vsize: tx.vsize,
+                feeSats,
+                inputs,
+                outputs,
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=psbt.tools.js.map

package/dist/tools/psbt.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psbt.tools.js","sourceRoot":"","sources":["../../src/tools/psbt.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE1E,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE;QACrC,kBAAkB,EAAE,IAAI;QACxB,mBAAmB,EAAE,IAAI;QACzB,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAmB;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAkB;IAC1C,IAAI,CAAC;QACH,OAAO,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAA8C;IAC3E,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAA8C;IAE9C,IAAI,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QACrD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAChD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,uBAAuB,CAAC,UAAkB;IACjD,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAA4C,EAC5C,KAAqD;IAErD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,KAAK,CAAC,MAAM,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,oHAAoH;YACpH,kDAAkD;QACpD,WAAW,EAAE;YACX,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YAC3E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;YACxD,mBAAmB,EAAE,CAAC;iBACnB,MAAM,EAAE;iBACR,QAAQ,CAAC,0DAA0D,CAAC;YACvE,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;iBAClE,QAAQ,EAAE;iBACV,OAAO,CAAC,QAAQ,CAAC;iBACjB,QAAQ,CACP,oFAAoF,CACrF;SACJ;KACF,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,EAAE;QACpF,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,EAAE,CAAC;YAEjD,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CACb,qEAAqE,CACtE,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAE1C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;gBACxE,kBAAkB,EAAE,IAAI;gBACxB,mBAAmB,EAAE,IAAI;gBACzB,kBAAkB,EAAE,IAAI;aACzB,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CACb,0BAA0B,QAAQ,CAAC,IAAI,0BAA0B,QAAQ,CAAC,aAAa,GAAG,CAC3F,CAAC;YACJ,CAAC;YAED,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,iBAAiB,CAAC,MAAM,KAAK,SAAS,IAAI,iBAAiB,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACrF,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;YAC1F,CAAC;YAED,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM,CAAC;YACnD,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,MAAM,CAAC;YACnD,MAAM,oBAAoB,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,IAAI,CAAC,EAAE,CAAC;gBAC7E,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAE7D,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,eAAe,GAAG,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEnE,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;iBACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;iBACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;iBACpF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;YAErC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,yCAAyC,OAAO,CAAC,UAAU,0BAA0B,CACtF,CAAC;YACJ,CAAC;YAED,MAAM,aAAa,GAAiB,EAAE,CAAC;YACvC,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC;gBAE5B,YAAY,GAAG,sBAAsB,CAAC;oBACpC,OAAO,EAAE,eAAe;oBACxB,eAAe,EAAE,aAAa,CAAC,MAAM;oBACrC,iBAAiB;oBACjB,WAAW,EAAE,CAAC;iBACf,CAAC,CAAC;gBAEH,IAAI,aAAa,IAAI,SAAS,GAAG,YAAY,EAAE,CAAC;oBAC9C,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,aAAa,GAAG,SAAS,GAAG,YAAY,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CACb,kCAAkC,aAAa,wBAAwB,SAAS,GAAG,YAAY,QAAQ,CACxG,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;YAC5D,MAAM,aAAa,GAAG,UAAU,IAAI,cAAc,CAAC;YAEnD,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC;gBAC7B,kBAAkB,EAAE,IAAI;gBACxB,mBAAmB,EAAE,IAAI;gBACzB,kBAAkB,EAAE,IAAI;aACzB,CAAC,CAAC;YAEH,EAAE,CAAC,QAAQ,CAAC;gBACV,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,WAAW,EAAE;oBACX,MAAM,EAAE,iBAAiB;oBACzB,MAAM,EAAE,iBAAiB;iBAC1B;aACF,CAAC,CAAC;YAEH,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAEjE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;gBACjC,EAAE,CAAC,QAAQ,CAAC;oBACV,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,WAAW,EAAE;wBACX,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;wBAC1B,MAAM,EAAE,WAAW,CAAC,MAAM;qBAC3B;iBACF,CAAC,CAAC;YACL,CAAC;YAED,EAAE,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;YACxE,EAAE,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,CAAC;YAElE,IAAI,aAAa,EAAE,CAAC;gBAClB,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;YAC1E,CAAC;YAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAExC,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,UAAU;gBACV,OAAO,EAAE;oBACP,eAAe,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE;oBACpD,oBAAoB;oBACpB,aAAa;oBACb,mBAAmB,EAAE,OAAO,CAAC,UAAU;oBACvC,mBAAmB;oBACnB,SAAS;oBACT,OAAO,EAAE,eAAe;oBACxB,gBAAgB,EAAE,YAAY;oBAC9B,eAAe,EAAE,aAAa,CAAC,MAAM;oBACrC,cAAc,EAAE,aAAa;oBAC7B,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC1C,qBAAqB,EAAE,gBAAgB;oBACvC,gBAAgB,EAAE,CAAC;oBACnB,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;iBAC1D;gBACD,SAAS,EAAE;oBACT,0DAA0D;oBAC1D,qCAAqC;oBACrC,+CAA+C;iBAChD;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EACT,gGAAgG;QAClG,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACxD,UAAU,EAAE,CAAC;iBACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;iBACrC,QAAQ,EAAE;iBACV,QAAQ,CAAC,uEAAuE,CAAC;YACpF,oBAAoB,EAAE,CAAC;iBACpB,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,KAAK,CAAC;iBACd,QAAQ,CAAC,8CAA8C,CAAC;SAC5D;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,EAAE,EAAE;QACzD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,EAAE,CAAC;YAEjD,IAAI,CAAC,OAAO,EAAE,aAAa,IAAI,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;gBAC3D,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACxC,MAAM,OAAO,GACX,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBACjC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;gBACjC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAE3D,MAAM,YAAY,GAAa,EAAE,CAAC;YAClC,MAAM,aAAa,GAA6C,EAAE,CAAC;YACnE,MAAM,eAAe,GAAa,EAAE,CAAC;YAErC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;gBAC1B,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;oBACtC,aAAa,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC,CAAC;oBACvE,SAAS;gBACX,CAAC;gBAED,IAAI,MAAM,GAAG,KAAK,CAAC;gBACnB,MAAM,MAAM,GAAa,EAAE,CAAC;gBAE5B,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC;oBAC5D,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACvC,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;oBACzC,IAAI,CAAC;wBACH,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC;oBAChE,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,MAAM,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,aAAa,CAAC,IAAI,CAAC;wBACjB,KAAK,EAAE,GAAG;wBACV,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,gCAAgC;qBAClF,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBAED,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEvB,IAAI,oBAAoB,EAAE,CAAC;oBACzB,IAAI,CAAC;wBACH,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;wBACpB,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC5B,CAAC;oBAAC,OAAO,CAAC,EAAE,CAAC;wBACX,aAAa,CAAC,IAAI,CAAC;4BACjB,KAAK,EAAE,GAAG;4BACV,MAAM,EAAE,mCAAmC,MAAM,CAAC,CAAC,CAAC,EAAE;yBACvD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC;gBAChC,OAAO,EAAE,OAAO;gBAChB,YAAY;gBACZ,eAAe;gBACf,aAAa;gBACb,UAAU,EAAE,gBAAgB,CAAC,EAAE,CAAC;aACjC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EACT,yFAAyF;QAC3F,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SACtE;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACxC,EAAE,CAAC,QAAQ,EAAE,CAAC;YAEd,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEjD,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAEvD,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,OAAO;gBAChB,IAAI;gBACJ,WAAW,EAAE,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC;gBAC3C,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,4FAA4F;QAC9F,WAAW,EAAE;YACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;SACzD;KACF,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;YACxC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAE1C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;gBAChE,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI;oBACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACzC,CAAC,CAAC,SAAS,CAAC;gBAEd,OAAO;oBACL,KAAK,EAAE,GAAG;oBACV,QAAQ,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;oBACzE,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC;oBACxC,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE;oBACjD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW;oBACnC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc;oBACzC,eAAe,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;oBAC9C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS;oBAC/B,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC;iBACrC,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;gBAClE,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACjC,OAAO;oBACL,KAAK,EAAE,GAAG;oBACV,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE;oBACrC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC;oBAC7C,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;iBAClF,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,IAAI,OAA2B,CAAC;YAChC,IAAI,CAAC;gBACH,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,SAAS,CAAC;YACtB,CAAC;YAED,OAAO,kBAAkB,CAAC;gBACxB,OAAO,EAAE,OAAO;gBAChB,eAAe,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC/C,OAAO,EAAE,EAAE,CAAC,OAAO;gBACnB,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,aAAa,EAAE,EAAE,CAAC,aAAa;gBAC/B,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,OAAO;gBACP,MAAM;gBACN,OAAO;aACR,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/sbtc.tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sbtc.tools.d.ts","sourceRoot":"","sources":["../../src/tools/sbtc.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuWzD"}
+{"version":3,"file":"sbtc.tools.d.ts","sourceRoot":"","sources":["../../src/tools/sbtc.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6CpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyjBzD"}

package/dist/tools/sbtc.tools.js

@@ -1,12 +1,37 @@
+import * as btc from "@scure/btc-signer";
 import { z } from "zod";
 import { getAccount, getWalletAddress, NETWORK } from "../services/x402.service.js";
 import { getSbtcService } from "../services/sbtc.service.js";
 import { getSbtcDepositService } from "../services/sbtc-deposit.service.js";
 import { getExplorerTxUrl } from "../config/networks.js";
+import { getContracts, parseContractId } from "../config/contracts.js";
 import { createJsonResponse, createErrorResponse, resolveFee } from "../utils/index.js";
 import { getWalletManager } from "../services/wallet-manager.js";
 import { MempoolApi, getMempoolTxUrl } from "../services/mempool-api.js";
+import { getBtcNetwork } from "../transactions/bitcoin-builder.js";
 import { sponsoredSchema } from "./schemas.js";
+function parseBtcRecipientTuple(btcRecipientAddress) {
+    const decoded = btc.Address(getBtcNetwork(NETWORK)).decode(btcRecipientAddress);
+    if (decoded.type === "tr" && decoded.pubkey) {
+        return { version: 0x06, hashbytesHex: Buffer.from(decoded.pubkey).toString("hex") };
+    }
+    switch (decoded.type) {
+        case "pkh":
+            return { version: 0x00, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        case "sh":
+            return { version: 0x01, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        case "wpkh":
+            return { version: 0x04, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        case "wsh":
+            return { version: 0x05, hashbytesHex: Buffer.from(decoded.hash).toString("hex") };
+        default:
+            throw new Error("Unsupported BTC recipient address type. Supported: P2PKH, P2SH, P2WPKH, P2WSH, P2TR.");
+    }
+}
+function getReadonlySenderAddress() {
+    const contracts = getContracts(NETWORK);
+    return parseContractId(contracts.SBTC_REGISTRY).address;
+}
 export function registerSbtcTools(server) {
     // Get sBTC balance
     server.registerTool("sbtc_get_balance", {
@@ -73,6 +98,168 @@ Example: To send 0.001 sBTC, use amount "100000" (satoshis).`,
             return createErrorResponse(error);
         }
     });
+    // Shared withdrawal logic used by both sbtc_initiate_withdrawal and sbtc_withdraw
+    async function executeWithdrawal(params) {
+        const { amount, btcRecipientAddress, maxFee, fee, sponsored } = params;
+        if (amount <= maxFee) {
+            throw new Error(`Withdrawal amount must exceed maxFee. amount=${amount}, maxFee=${maxFee}`);
+        }
+        const sbtcService = getSbtcService(NETWORK);
+        const account = await getAccount();
+        const resolvedFee = await resolveFee(fee, NETWORK, "contract_call");
+        const recipientTuple = parseBtcRecipientTuple(btcRecipientAddress);
+        const result = await sbtcService.initiateWithdrawal(account, BigInt(amount), BigInt(maxFee), recipientTuple, resolvedFee, sponsored);
+        let requestId = null;
+        try {
+            requestId = await sbtcService.getWithdrawalRequestIdFromTx(result.txid);
+        }
+        catch {
+            requestId = null;
+        }
+        return { result, recipientTuple, requestId };
+    }
+    const withdrawalInputSchema = {
+        amount: z
+            .number()
+            .int()
+            .positive()
+            .describe("Amount to withdraw in satoshis"),
+        btcRecipientAddress: z
+            .string()
+            .describe("Bitcoin recipient address (P2PKH/P2SH/P2WPKH/P2WSH/P2TR)"),
+        maxFee: z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .default(2000)
+            .describe("Maximum signer fee in satoshis"),
+        fee: z
+            .string()
+            .optional()
+            .describe("Optional fee: 'low' | 'medium' | 'high' preset or micro-STX amount."),
+        sponsored: sponsoredSchema,
+    };
+    // Initiate sBTC withdrawal (peg-out to BTC L1)
+    server.registerTool("sbtc_initiate_withdrawal", {
+        description: `Initiate an sBTC peg-out to a Bitcoin L1 address.
+
+Locks (amount + maxFee) of sBTC in the sBTC protocol and creates a withdrawal request.
+Signers later process the request and send BTC on L1.`,
+        inputSchema: withdrawalInputSchema,
+    }, async ({ amount, btcRecipientAddress, maxFee, fee, sponsored }) => {
+        try {
+            const { result, recipientTuple, requestId } = await executeWithdrawal({
+                amount, btcRecipientAddress, maxFee, fee, sponsored,
+            });
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                requestId,
+                network: NETWORK,
+                recipient: {
+                    address: btcRecipientAddress,
+                    version: recipientTuple.version,
+                    hashbytesHex: recipientTuple.hashbytesHex,
+                },
+                withdrawal: {
+                    amountSats: amount,
+                    maxFeeSats: maxFee,
+                    lockedSats: amount + maxFee,
+                },
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+                nextStep: requestId !== null
+                    ? `Track with sbtc_withdrawal_status using requestId=${requestId}`
+                    : "Track with sbtc_withdrawal_status using this txid once it confirms.",
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Compatibility alias for sbtc_initiate_withdrawal
+    server.registerTool("sbtc_withdraw", {
+        description: "Alias for sbtc_initiate_withdrawal. Initiates an sBTC peg-out request to BTC L1.",
+        inputSchema: withdrawalInputSchema,
+    }, async ({ amount, btcRecipientAddress, maxFee, fee, sponsored }) => {
+        try {
+            const { result } = await executeWithdrawal({
+                amount, btcRecipientAddress, maxFee, fee, sponsored,
+            });
+            return createJsonResponse({
+                success: true,
+                txid: result.txid,
+                network: NETWORK,
+                explorerUrl: getExplorerTxUrl(result.txid, NETWORK),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+    // Check withdrawal request status
+    server.registerTool("sbtc_withdrawal_status", {
+        description: "Check status of an sBTC withdrawal request by requestId or initiating txid.",
+        inputSchema: {
+            requestId: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Withdrawal request ID"),
+            txid: z
+                .string()
+                .optional()
+                .describe("Initiate-withdrawal transaction ID (used to resolve requestId)"),
+        },
+    }, async ({ requestId, txid }) => {
+        try {
+            if (requestId === undefined && !txid) {
+                throw new Error("Provide either requestId or txid.");
+            }
+            const sbtcService = getSbtcService(NETWORK);
+            let resolvedRequestId = requestId;
+            if (resolvedRequestId === undefined && txid) {
+                resolvedRequestId = await sbtcService.getWithdrawalRequestIdFromTx(txid);
+                if (resolvedRequestId === null) {
+                    return createJsonResponse({
+                        txid,
+                        requestId: null,
+                        status: "pending_tx",
+                        message: "Could not resolve requestId from tx yet. The transaction may still be pending or unindexed.",
+                        network: NETWORK,
+                        explorerUrl: getExplorerTxUrl(txid, NETWORK),
+                    });
+                }
+            }
+            if (resolvedRequestId == null) {
+                throw new Error("Unable to resolve withdrawal request ID.");
+            }
+            const request = await sbtcService.getWithdrawalRequest(resolvedRequestId, getReadonlySenderAddress());
+            if (!request) {
+                return createJsonResponse({
+                    requestId: resolvedRequestId,
+                    status: "not_found",
+                    network: NETWORK,
+                });
+            }
+            return createJsonResponse({
+                requestId: request.id,
+                status: request.status,
+                network: NETWORK,
+                amountSats: request.amountSats,
+                maxFeeSats: request.maxFeeSats,
+                sender: request.sender,
+                blockHeight: request.blockHeight,
+                recipient: request.recipient,
+                txid,
+                ...(txid ? { explorerUrl: getExplorerTxUrl(txid, NETWORK) } : {}),
+            });
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
     // Get sBTC deposit info
     server.registerTool("sbtc_get_deposit_info", {
         description: "Get information about how to deposit BTC to receive sBTC.",