@aibtc/mcp-server 1.72.1 → 1.73.1

package/dist/utils/fee.d.ts

@@ -6,6 +6,44 @@
  * fee estimates from the Stacks mempool.
  */
 import type { Network } from "../config/networks.js";
+/**
+ * Fee floor and ceiling clamps by transaction type (in micro-STX).
+ * Prevents absurd fees during mempool spikes while allowing reasonable variation.
+ *
+ * Ceilings are set conservatively:
+ *   token_transfer: 3,000 uSTX (0.003 STX) — simple transfer
+ *   contract_call:  50,000 uSTX (0.05 STX)  — complex contract call
+ *   smart_contract: 50,000 uSTX (0.05 STX)  — deployment
+ * These match the x402-sponsor-relay reference implementation.
+ *
+ * sbtc_transfer is a plain sBTC `transfer` call. It is priced from Hiro's
+ * contract_call tier, whose medium estimate is skewed by heavy calls and sat
+ * at 2.5 STX, so every x402 sBTC payment paid the 0.05 STX ceiling. Mainnet
+ * sBTC transfers confirm at 500-3,000 uSTX.
+ */
+declare const FEE_CLAMPS: {
+    readonly token_transfer: {
+        readonly floor: 180n;
+        readonly ceiling: 3000n;
+    };
+    readonly contract_call: {
+        readonly floor: 3000n;
+        readonly ceiling: 50000n;
+    };
+    readonly sbtc_transfer: {
+        readonly floor: 500n;
+        readonly ceiling: 3000n;
+    };
+    readonly smart_contract: {
+        readonly floor: 10000n;
+        readonly ceiling: 50000n;
+    };
+    readonly all: {
+        readonly floor: 180n;
+        readonly ceiling: 50000n;
+    };
+};
+type FeeTxType = keyof typeof FEE_CLAMPS;
 /**
  * Valid fee preset strings.
  * These map to the mempool fee priorities:
@@ -37,7 +75,7 @@ export declare function isFeePreset(value: string): value is FeePreset;
  * // Undefined - returns undefined (auto-estimate)
  * await resolveFee(undefined, "mainnet") // -> undefined
  */
-export declare function resolveFee(fee: string | undefined, network: Network, txType?: "all" | "token_transfer" | "contract_call" | "smart_contract"): Promise<bigint | undefined>;
+export declare function resolveFee(fee: string | undefined, network: Network, txType?: FeeTxType): Promise<bigint | undefined>;
 /**
  * Resolve a default medium-priority fee for a given transaction type.
  *
@@ -52,5 +90,6 @@ export declare function resolveFee(fee: string | undefined, network: Network, tx
  * @param txType - The transaction type for ceiling/floor selection
  * @returns Fee in micro-STX as bigint
  */
-export declare function resolveDefaultFee(network: Network, txType?: "token_transfer" | "contract_call" | "smart_contract"): Promise<bigint>;
+export declare function resolveDefaultFee(network: Network, txType?: Exclude<FeeTxType, "all">): Promise<bigint>;
+export {};
 //# sourceMappingURL=fee.d.ts.map

package/dist/utils/fee.js

@@ -15,13 +15,27 @@ import { getHiroApi } from "../services/hiro-api.js";
  *   contract_call:  50,000 uSTX (0.05 STX)  — complex contract call
  *   smart_contract: 50,000 uSTX (0.05 STX)  — deployment
  * These match the x402-sponsor-relay reference implementation.
+ *
+ * sbtc_transfer is a plain sBTC `transfer` call. It is priced from Hiro's
+ * contract_call tier, whose medium estimate is skewed by heavy calls and sat
+ * at 2.5 STX, so every x402 sBTC payment paid the 0.05 STX ceiling. Mainnet
+ * sBTC transfers confirm at 500-3,000 uSTX.
  */
 const FEE_CLAMPS = {
     token_transfer: { floor: 180n, ceiling: 3000n },
     contract_call: { floor: 3000n, ceiling: 50000n },
+    sbtc_transfer: { floor: 500n, ceiling: 3000n },
     smart_contract: { floor: 10000n, ceiling: 50000n },
     all: { floor: 180n, ceiling: 50000n }, // Widest range for aggregate fees
 };
+/** Hiro mempool fee tier each clamp type is estimated from. */
+const FEE_TIER = {
+    token_transfer: "token_transfer",
+    contract_call: "contract_call",
+    sbtc_transfer: "contract_call",
+    smart_contract: "smart_contract",
+    all: "all",
+};
 /**
  * Check if a string is a valid fee preset.
  */
@@ -77,7 +91,7 @@ export async function resolveFee(fee, network, txType = "all") {
         const hiroApi = getHiroApi(network);
         try {
             const mempoolFees = await hiroApi.getMempoolFees();
-            const feeTier = mempoolFees[txType];
+            const feeTier = mempoolFees[FEE_TIER[txType]];
             const priorityKey = presetToPriorityKey(fee);
             const rawFee = BigInt(Math.ceil(feeTier[priorityKey]));
             const clamps = FEE_CLAMPS[txType];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.72.1",
+  "version": "1.73.1",
   "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",

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.72.1 # x-release-please-version
+  version: 1.73.1 # x-release-please-version
   npm: "@aibtc/mcp-server"
   github: https://github.com/aibtcdev/aibtc-mcp-server
 ---
@@ -121,7 +121,7 @@ Wallets are stored encrypted at `~/.aibtc/`.
 | `btc_sign_message` | Sign plain text with Bitcoin key (BIP-137/BIP-322) | `message`, `addressType` (optional) |
 | `btc_verify_message` | Verify Bitcoin message signature (auto-detects BIP-137/BIP-322) | `message`, `signature`, `address` (optional) |
 | `nostr_sign_event` | Sign a Nostr event (NIP-01) with BIP-340 Schnorr using NIP-06 derived key by default (m/44'/1237'/0'/0/0) | `kind`, `content`, `tags` (optional), `created_at` (optional), `keySource` (`"nostr"` default via NIP-06 path, `"taproot"` for P2TR key, `"segwit"` for P2WPKH key) |
-| `schnorr_sign_digest` | Sign a raw 32-byte digest with Schnorr/BIP-340 | `digest`, `confirmBlindSign`, `auxRand` (optional) |
+| `schnorr_sign_digest` | Sign a raw 32-byte digest with Schnorr/BIP-340 (off unless the user sets `AIBTC_ALLOW_BLIND_SIGN=true`) | `digest`, `confirmBlindSign`, `auxRand` (optional) |
 | `schnorr_verify_digest` | Verify a BIP-340 Schnorr signature over a digest | `digest`, `signature`, `publicKey` |
 
 ## Units and Addresses