@aibtc/mcp-server 1.46.1 → 1.46.3

package/dist/utils/x402-payment-state.js

@@ -0,0 +1,275 @@
+import { HttpPaymentStatusResponseSchema, } from "@aibtc/tx-schemas/http";
+const IN_FLIGHT_STATUSES = new Set(["queued", "broadcasting", "mempool"]);
+const SENDER_NONCE_REASONS = new Set([
+    "sender_nonce_stale",
+    "sender_nonce_gap",
+    "sender_nonce_duplicate",
+]);
+const BOUNDED_RETRY_REASONS = new Set([
+    "queue_unavailable",
+    "sponsor_failure",
+    "internal_error",
+    "broadcast_failure",
+    "chain_abort",
+]);
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function extractCandidateRecord(value) {
+    const record = asRecord(value);
+    if (!record) {
+        return null;
+    }
+    if (typeof record.paymentId === "string" ||
+        typeof record.status === "string" ||
+        typeof record.paymentStatus === "string") {
+        return {
+            ...record,
+            ...(typeof record.status !== "string" && typeof record.paymentStatus === "string"
+                ? { status: record.paymentStatus }
+                : {}),
+        };
+    }
+    const inbox = asRecord(record.inbox);
+    if (inbox &&
+        (typeof inbox.paymentId === "string" ||
+            typeof inbox.paymentStatus === "string" ||
+            typeof inbox.checkStatusUrl === "string")) {
+        return {
+            paymentId: inbox.paymentId,
+            status: inbox.paymentStatus,
+            checkStatusUrl: (typeof inbox.checkStatusUrl === "string" ? inbox.checkStatusUrl : undefined) ??
+                (typeof record.checkStatusUrl === "string" ? record.checkStatusUrl : undefined),
+            txid: record.txid,
+        };
+    }
+    const x402 = asRecord(record.x402);
+    if (x402 && (typeof x402.paymentId === "string" || typeof x402.status === "string")) {
+        return x402;
+    }
+    return null;
+}
+function getHeaderValue(headers, name) {
+    if (!headers) {
+        return undefined;
+    }
+    const target = name.toLowerCase();
+    for (const [headerName, rawValue] of Object.entries(headers)) {
+        if (headerName.toLowerCase() !== target || rawValue === undefined || rawValue === null) {
+            continue;
+        }
+        if (Array.isArray(rawValue)) {
+            return rawValue.find((value) => typeof value === "string" && value.length > 0);
+        }
+        return String(rawValue);
+    }
+    return undefined;
+}
+export function normalizeCallerFacingStatus(status) {
+    if (typeof status !== "string") {
+        return undefined;
+    }
+    if (status === "pending" || status === "submitted" || status === "queued_with_warning") {
+        return "queued";
+    }
+    const parsed = HttpPaymentStatusResponseSchema.shape.status.safeParse(status);
+    return parsed.success ? parsed.data : undefined;
+}
+function normalizeCheckStatusUrl(checkStatusUrl, baseUrl) {
+    if (!checkStatusUrl) {
+        return undefined;
+    }
+    try {
+        if (baseUrl) {
+            return new URL(checkStatusUrl, baseUrl).toString();
+        }
+        return new URL(checkStatusUrl).toString();
+    }
+    catch {
+        return undefined;
+    }
+}
+export function extractCanonicalPaymentHints(options) {
+    const candidate = extractCandidateRecord(options.payload);
+    const headerPaymentId = getHeaderValue(options.responseHeaders, "x-payment-id");
+    const headerCheckStatusUrl = getHeaderValue(options.responseHeaders, "x-payment-check-url");
+    const headerStatus = getHeaderValue(options.responseHeaders, "x-payment-status");
+    return {
+        paymentId: (typeof candidate?.paymentId === "string" ? candidate.paymentId : undefined) ??
+            headerPaymentId ??
+            options.paymentId,
+        status: normalizeCallerFacingStatus(candidate?.status) ??
+            normalizeCallerFacingStatus(headerStatus),
+        checkStatusUrl: normalizeCheckStatusUrl((typeof candidate?.checkStatusUrl === "string" ? candidate.checkStatusUrl : undefined) ??
+            headerCheckStatusUrl, options.baseUrl),
+        txid: typeof candidate?.txid === "string" ? candidate.txid : undefined,
+    };
+}
+function tryParsePaymentStatus(candidate) {
+    const result = HttpPaymentStatusResponseSchema.safeParse(candidate);
+    return result.success ? result.data : null;
+}
+async function fetchPaymentStatus(checkStatusUrl, fetchImpl) {
+    try {
+        const response = await fetchImpl(checkStatusUrl, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+        });
+        const body = await response.json().catch(() => null);
+        const parsed = HttpPaymentStatusResponseSchema.safeParse(body);
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function resolveCanonicalPaymentStatus(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const directCandidate = extractCandidateRecord(options.payload);
+    if (directCandidate) {
+        const parsed = tryParsePaymentStatus({
+            ...directCandidate,
+            ...(typeof directCandidate.paymentId !== "string" && options.paymentId
+                ? { paymentId: options.paymentId }
+                : {}),
+            ...(typeof directCandidate.checkStatusUrl === "string"
+                ? {
+                    checkStatusUrl: normalizeCheckStatusUrl(directCandidate.checkStatusUrl, options.baseUrl) ??
+                        directCandidate.checkStatusUrl,
+                }
+                : {}),
+        });
+        if (parsed) {
+            return parsed;
+        }
+    }
+    const hints = extractCanonicalPaymentHints(options);
+    const canonicalCheckStatusUrl = hints.checkStatusUrl;
+    const compatFallbackCheckStatusUrl = canonicalCheckStatusUrl
+        ? undefined
+        : normalizeCheckStatusUrl(options.fallbackCheckStatusUrl, options.baseUrl);
+    const checkStatusUrl = canonicalCheckStatusUrl ?? compatFallbackCheckStatusUrl;
+    if (checkStatusUrl) {
+        options.onPoll?.({
+            paymentId: hints.paymentId,
+            checkStatusUrl,
+            source: canonicalCheckStatusUrl ? "canonical_hint" : "compat_fallback",
+        });
+        const polled = await fetchPaymentStatus(checkStatusUrl, fetchImpl);
+        if (polled) {
+            return polled;
+        }
+    }
+    if (hints.paymentId && hints.status) {
+        const parsed = tryParsePaymentStatus({
+            paymentId: hints.paymentId,
+            status: hints.status,
+            ...(hints.checkStatusUrl ? { checkStatusUrl: hints.checkStatusUrl } : {}),
+            ...(hints.txid ? { txid: hints.txid } : {}),
+        });
+        if (parsed) {
+            return parsed;
+        }
+    }
+    return null;
+}
+export function classifyCanonicalPaymentStatus(status) {
+    if (IN_FLIGHT_STATUSES.has(status.status)) {
+        return {
+            action: "poll_same_payment",
+            retryable: true,
+            shouldReusePaymentId: true,
+            shouldRebuild: false,
+            shouldStopPollingOldPaymentId: false,
+            summary: `Payment ${status.paymentId} is still ${status.status}. Keep polling the same paymentId; do not rebuild or sign a second payment.`,
+        };
+    }
+    if (status.status === "confirmed") {
+        return {
+            action: "success",
+            retryable: false,
+            shouldReusePaymentId: false,
+            shouldRebuild: false,
+            shouldStopPollingOldPaymentId: false,
+            summary: `Payment ${status.paymentId} is confirmed.`,
+        };
+    }
+    if (status.status === "failed" && status.terminalReason && SENDER_NONCE_REASONS.has(status.terminalReason)) {
+        return {
+            action: "rebuild_sender",
+            retryable: true,
+            shouldReusePaymentId: false,
+            shouldRebuild: true,
+            shouldStopPollingOldPaymentId: false,
+            summary: `Payment ${status.paymentId} failed with sender-owned nonce reason ${status.terminalReason}. Rebuild and re-sign with a fresh sender nonce.`,
+        };
+    }
+    if (status.status === "failed" && status.terminalReason && BOUNDED_RETRY_REASONS.has(status.terminalReason)) {
+        return {
+            action: "retry_bounded",
+            retryable: status.retryable === true,
+            shouldReusePaymentId: false,
+            shouldRebuild: false,
+            shouldStopPollingOldPaymentId: false,
+            summary: `Payment ${status.paymentId} failed with relay/settlement reason ${status.terminalReason}. Use only bounded retry if the route allows it; otherwise stop.`,
+        };
+    }
+    if (status.status === "replaced") {
+        return {
+            action: "stop_replaced",
+            retryable: false,
+            shouldReusePaymentId: false,
+            shouldRebuild: false,
+            shouldStopPollingOldPaymentId: true,
+            summary: `Payment ${status.paymentId} was replaced${status.terminalReason ? ` (${status.terminalReason})` : ""}. Stop polling the old paymentId.`,
+        };
+    }
+    if (status.status === "not_found") {
+        return {
+            action: "restart_payment",
+            retryable: false,
+            shouldReusePaymentId: false,
+            shouldRebuild: false,
+            shouldStopPollingOldPaymentId: true,
+            summary: `Payment ${status.paymentId} is not_found${status.terminalReason ? ` (${status.terminalReason})` : ""}. Treat the old identity as gone or expired and restart only if the higher-level operation still wants to pay.`,
+        };
+    }
+    const reason = status.terminalReason;
+    return {
+        action: "stop",
+        retryable: false,
+        shouldReusePaymentId: false,
+        shouldRebuild: false,
+        shouldStopPollingOldPaymentId: status.status === "failed",
+        summary: `Payment ${status.paymentId} reached terminal status ${status.status}${reason ? ` (${reason})` : ""}. Stop and decide next action explicitly.`,
+    };
+}
+export function formatCanonicalPaymentStatus(status) {
+    const lines = [
+        `paymentId: ${status.paymentId}`,
+        `status: ${status.status}`,
+    ];
+    if (status.terminalReason) {
+        lines.push(`terminalReason: ${status.terminalReason}`);
+    }
+    if (status.txid) {
+        lines.push(`txid: ${status.txid}`);
+    }
+    if (status.checkStatusUrl) {
+        lines.push(`checkStatusUrl: ${status.checkStatusUrl}`);
+    }
+    if (status.errorCode) {
+        lines.push(`errorCode: ${status.errorCode}`);
+    }
+    if (status.error) {
+        lines.push(`error: ${status.error}`);
+    }
+    if (status.retryable !== undefined) {
+        lines.push(`retryable: ${status.retryable}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=x402-payment-state.js.map

package/dist/utils/x402-payment-state.js.map

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

package/dist/utils/x402-recovery.d.ts

@@ -4,8 +4,8 @@
  * Helpers for extracting transaction IDs from payment-signature headers
  * and polling transaction confirmation status.
  *
- * Used by inbox.tools.ts and endpoint.tools.ts to provide txid recovery
- * info when settlement fails after payment was submitted.
+ * Used by inbox.tools.ts and endpoint.tools.ts as an operational fallback
+ * when canonical paymentId polling is unavailable or inconclusive.
  */
 import { type Network } from "../config/networks.js";
 /**
@@ -17,6 +17,13 @@ import { type Network } from "../config/networks.js";
  * Returns the txid string (64-char hex, no 0x prefix), or null if extraction fails.
  */
 export declare function extractTxidFromPaymentSignature(paymentSignatureHeader: string): string | null;
+/**
+ * Extract the relay-owned paymentId from a base64-encoded payment-signature header.
+ *
+ * This is useful when the caller needs to recover the stable payment identity
+ * from a previously signed request before canonical polling can begin.
+ */
+export declare function extractPaymentIdFromPaymentSignature(paymentSignatureHeader: string): string | null;
 export interface TransactionConfirmationResult {
     txid: string;
     status: string;

package/dist/utils/x402-recovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x402-recovery.d.ts","sourceRoot":"","sources":["../../src/utils/x402-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,KAAK,OAAO,EAAoB,MAAM,uBAAuB,CAAC;AAOvE;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,sBAAsB,EAAE,MAAM,GAC7B,MAAM,GAAG,IAAI,CAiBf;AAMD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,SAAS,SAAS,EAClB,UAAU,SAAQ,GACjB,OAAO,CAAC,6BAA6B,CAAC,CAiCxC"}
+{"version":3,"file":"x402-recovery.d.ts","sourceRoot":"","sources":["../../src/utils/x402-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,KAAK,OAAO,EAAoB,MAAM,uBAAuB,CAAC;AAOvE;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,sBAAsB,EAAE,MAAM,GAC7B,MAAM,GAAG,IAAI,CAiBf;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,sBAAsB,EAAE,MAAM,GAC7B,MAAM,GAAG,IAAI,CAgBf;AAMD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,SAAS,SAAS,EAClB,UAAU,SAAQ,GACjB,OAAO,CAAC,6BAA6B,CAAC,CAiCxC"}

package/dist/utils/x402-recovery.js

@@ -4,8 +4,8 @@
  * Helpers for extracting transaction IDs from payment-signature headers
  * and polling transaction confirmation status.
  *
- * Used by inbox.tools.ts and endpoint.tools.ts to provide txid recovery
- * info when settlement fails after payment was submitted.
+ * Used by inbox.tools.ts and endpoint.tools.ts as an operational fallback
+ * when canonical paymentId polling is unavailable or inconclusive.
  */
 import { deserializeTransaction } from "@stacks/transactions";
 import { getHiroApi } from "../services/hiro-api.js";
@@ -39,6 +39,30 @@ export function extractTxidFromPaymentSignature(paymentSignatureHeader) {
         return null;
     }
 }
+/**
+ * Extract the relay-owned paymentId from a base64-encoded payment-signature header.
+ *
+ * This is useful when the caller needs to recover the stable payment identity
+ * from a previously signed request before canonical polling can begin.
+ */
+export function extractPaymentIdFromPaymentSignature(paymentSignatureHeader) {
+    try {
+        const payload = decodePaymentPayload(paymentSignatureHeader);
+        const id = payload?.extensions?.["payment-identifier"];
+        if (!id || typeof id !== "object" || Array.isArray(id)) {
+            return null;
+        }
+        const info = id.info;
+        if (!info || typeof info !== "object" || Array.isArray(info)) {
+            return null;
+        }
+        const paymentId = info.id;
+        return typeof paymentId === "string" && paymentId.length > 0 ? paymentId : null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Poll transaction status until it leaves the pending/mempool state or timeout is reached.
  *

package/dist/utils/x402-recovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"x402-recovery.js","sourceRoot":"","sources":["../../src/utils/x402-recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAgB,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC7C,sBAA8B;IAE9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;QAC7D,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QAC1C,8BAA8B;QAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAEjD,MAAM,EAAE,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAcD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAY,EACZ,OAAgB,EAChB,SAAS,GAAG,MAAM,EAClB,UAAU,GAAG,KAAK;IAElB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;YAClE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO;oBACL,IAAI,EAAE,cAAc;oBACpB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,YAAY,EAAE,MAAM,CAAC,YAAY;oBACjC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,QAAQ,EAAE,WAAW;iBACtB,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,SAAS,IAAI,CAAC;YAAE,MAAM;QAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,WAAW;KACtB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"x402-recovery.js","sourceRoot":"","sources":["../../src/utils/x402-recovery.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.46.1",
+  "version": "1.46.3",
   "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",
@@ -43,6 +43,7 @@
   "homepage": "https://github.com/aibtcdev/aibtc-mcp-server#readme",
   "license": "MIT",
   "dependencies": {
+    "@aibtc/tx-schemas": "^0.3.0",
     "@bitflowlabs/core-sdk": "^3.0.0",
     "@faktoryfun/styx-sdk": "^1.3.5",
     "@modelcontextprotocol/sdk": "^1.27.1",

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.46.1 # x-release-please-version
+  version: 1.46.3 # x-release-please-version
   npm: "@aibtc/mcp-server"
   github: https://github.com/aibtcdev/aibtc-mcp-server
 ---