@aibtc/mcp-server 1.36.0 → 1.37.0

package/dist/utils/fee.js

@@ -9,12 +9,18 @@ import { getHiroApi } from "../services/hiro-api.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.
  */
 const FEE_CLAMPS = {
     token_transfer: { floor: 180n, ceiling: 3000n },
-    contract_call: { floor: 3000n, ceiling: 100000n },
-    smart_contract: { floor: 10000n, ceiling: 100000n },
-    all: { floor: 180n, ceiling: 100000n }, // Widest range for aggregate fees
+    contract_call: { floor: 3000n, ceiling: 50000n },
+    smart_contract: { floor: 10000n, ceiling: 50000n },
+    all: { floor: 180n, ceiling: 50000n }, // Widest range for aggregate fees
 };
 /**
  * Check if a string is a valid fee preset.
@@ -90,6 +96,32 @@ export async function resolveFee(fee, network, txType = "all") {
     if (!/^\d+$/.test(normalizedFee)) {
         throw new Error(`Invalid fee value "${fee}" – expected a non-negative integer string in micro-STX or preset ("low", "medium", "high").`);
     }
-    return BigInt(normalizedFee);
+    // Clamp numeric overrides to the txType ceiling so user-specified fees
+    // can't accidentally produce NotEnoughFunds on complex calls.
+    const numericFee = BigInt(normalizedFee);
+    const clamps = FEE_CLAMPS[txType];
+    return clampFee(numericFee, clamps.floor, clamps.ceiling);
+}
+/**
+ * Resolve a default medium-priority fee for a given transaction type.
+ *
+ * Used by builder functions when the caller does not supply an explicit fee,
+ * so that ALL write paths receive a clamped fee rather than relying on the
+ * unclamped @stacks/transactions auto-estimation which can over-shoot.
+ *
+ * Falls back gracefully: if the Hiro mempool API is unreachable, returns the
+ * floor × 2 (medium multiplier) for the tx type.
+ *
+ * @param network - The Stacks network to fetch fee estimates from
+ * @param txType - The transaction type for ceiling/floor selection
+ * @returns Fee in micro-STX as bigint
+ */
+export async function resolveDefaultFee(network, txType = "contract_call") {
+    const resolved = await resolveFee("medium", network, txType);
+    // resolveFee("medium", ...) always returns a value (never undefined) because
+    // "medium" is a valid preset — the cast is safe.
+    // Fallback path (when Hiro is unreachable): returns floor × 2 for the txType.
+    // This risks slow inclusion during congestion but prevents hard failures.
+    return resolved;
 }
 //# sourceMappingURL=fee.js.map

package/dist/utils/fee.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibtc/mcp-server",
-  "version": "1.36.0",
+  "version": "1.37.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",
@@ -60,12 +60,15 @@
     "axios": "^1.13.6",
     "dotenv": "^17.3.1",
     "micro-ordinals": "^0.3.0",
+    "nostr-tools": "^2.23.3",
     "sbtc": "^0.3.2",
     "tslib": "^2.8.1",
+    "ws": "^8.19.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^22.19.13",
+    "@types/ws": "^8.18.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"

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