@secondlayer/stacks 5.1.3 → 6.0.0

package/README.md

@@ -64,14 +64,7 @@ multi-broadcast gap, which is why it lives here rather than being deferred to
 | `@secondlayer/stacks/pox` | PoX stacking — solo and delegated |
 | `@secondlayer/stacks/stackingdao` | StackingDAO liquid staking (STX/stSTX) |
 
-### Deprecated: `/tools` and `/tools/btc`
-
-Give your agent Stacks reads through [`@secondlayer/mcp`](https://www.npmjs.com/package/@secondlayer/mcp) instead. The two AI SDK tool entries below still import, and stay until the next major, but they get no new tools. The tradeoff of keeping them: `ai` and `zod` are now optional peer dependencies, so a project that imports either entry installs both itself; a project that only reads contracts installs neither.
-
-| Module | Description |
-|---|---|
-| `@secondlayer/stacks/tools` | **Deprecated.** AI SDK `tool()` set for Stacks reads. Bare exports read `STACKS_NETWORK` (or `STACKS_CHAIN`) and `STACKS_NODE_RPC_URL`, `SL_API_URL` or `STACKS_RPC_URL`; `createStacksTools(client)` binds your own client |
-| `@secondlayer/stacks/tools/btc` | **Deprecated.** AI SDK `tool()` set for Bitcoin reads via mempool.space (`BTC_MEMPOOL_URL` overrides the host) |
+Agent Stacks reads go through [`@secondlayer/mcp`](https://www.npmjs.com/package/@secondlayer/mcp).
 
 ## Guides
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/stacks",
-	"version": "5.1.3",
+	"version": "6.0.0",
 	"description": "Typed Stacks client for TypeScript: read contracts, decode Clarity, build and send transactions.",
 	"license": "MIT",
 	"repository": {
@@ -99,16 +99,6 @@
 			"import": "./dist/src/connect/walletconnect/index.js",
 			"require": "./dist/src/connect/walletconnect/index.cjs"
 		},
-		"./tools": {
-			"types": "./dist/src/tools/index.d.ts",
-			"import": "./dist/src/tools/index.js",
-			"require": "./dist/src/tools/index.cjs"
-		},
-		"./tools/btc": {
-			"types": "./dist/src/tools/btc/index.d.ts",
-			"import": "./dist/src/tools/btc/index.js",
-			"require": "./dist/src/tools/btc/index.cjs"
-		},
 		"./filters": {
 			"types": "./dist/src/filters/index.d.ts",
 			"import": "./dist/src/filters/index.js",
@@ -133,16 +123,12 @@
 	"devDependencies": {
 		"@stacks/clarinet-sdk": "3.21.1",
 		"@stacks/transactions": "7.0.6",
-		"@types/bun": "latest",
-		"ai": "6.0.167",
-		"zod": "^4.3.6"
+		"@types/bun": "latest"
 	},
 	"peerDependencies": {
 		"@stacks/clarinet-sdk": "^3",
 		"@stacks/transactions": "^7",
-		"ai": "^6",
-		"typescript": "^5",
-		"zod": "^4"
+		"typescript": "^5"
 	},
 	"peerDependenciesMeta": {
 		"@stacks/clarinet-sdk": {
@@ -150,12 +136,6 @@
 		},
 		"@stacks/transactions": {
 			"optional": true
-		},
-		"ai": {
-			"optional": true
-		},
-		"zod": {
-			"optional": true
 		}
 	},
 	"dependencies": {

package/dist/src/tools/btc/index.cjs

@@ -1,131 +0,0 @@
-var import_node_module = require("node:module");
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toCommonJS = (from) => {
-  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (var key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(entry, key))
-        __defProp(entry, key, {
-          get: __accessProp.bind(from, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
-  }
-  __moduleCache.set(from, entry);
-  return entry;
-};
-var __moduleCache;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-
-// src/tools/btc/index.ts
-var exports_btc = {};
-__export(exports_btc, {
-  btcUtxos: () => btcUtxos,
-  btcFeeEstimate: () => btcFeeEstimate,
-  btcConfirmations: () => btcConfirmations,
-  btcBlockHeight: () => btcBlockHeight,
-  btcBalance: () => btcBalance,
-  BTC_ADDRESS: () => BTC_ADDRESS
-});
-module.exports = __toCommonJS(exports_btc);
-var import_ai = require("ai");
-var import_zod = require("zod");
-function baseUrl() {
-  return (process.env.BTC_MEMPOOL_URL ?? "https://mempool.space").replace(/\/$/, "");
-}
-async function get(path) {
-  const res = await fetch(`${baseUrl()}${path}`, {
-    headers: { Accept: "application/json" }
-  });
-  if (!res.ok) {
-    throw new Error(`BTC mempool.space ${path} → ${res.status} ${res.statusText}`);
-  }
-  const contentType = res.headers.get("content-type") ?? "";
-  if (contentType.includes("application/json"))
-    return res.json();
-  return res.text();
-}
-var BTC_TXID = import_zod.z.string().regex(/^[0-9a-fA-F]{64}$/, "64-character hex BTC txid");
-var BTC_ADDRESS = import_zod.z.string().regex(/^(1[a-zA-HJ-NP-Z0-9]{25,34}|3[a-zA-HJ-NP-Z0-9]{25,34}|bc1[a-zA-HJ-NP-Z0-9]{11,71}|tb1[a-zA-HJ-NP-Z0-9]{11,71})$/, { message: "Invalid Bitcoin address" });
-var btcConfirmations = import_ai.tool({
-  description: "Number of confirmations for a Bitcoin transaction. Returns { confirmations, confirmed }.",
-  inputSchema: import_zod.z.object({ txid: BTC_TXID }),
-  execute: async ({ txid }) => {
-    const tx = await get(`/api/tx/${txid}`);
-    if (!tx.status.confirmed || tx.status.block_height == null) {
-      return { confirmed: false, confirmations: 0 };
-    }
-    const tip = await get("/api/blocks/tip/height");
-    return {
-      confirmed: true,
-      confirmations: Math.max(0, tip - tx.status.block_height + 1),
-      blockHeight: tx.status.block_height
-    };
-  }
-});
-var btcBalance = import_ai.tool({
-  description: "Bitcoin balance for an address, in satoshis. Returns { confirmedSat, unconfirmedSat }.",
-  inputSchema: import_zod.z.object({ address: BTC_ADDRESS }),
-  execute: async ({ address }) => {
-    const info = await get(`/api/address/${encodeURIComponent(address)}`);
-    return {
-      confirmedSat: info.chain_stats.funded_txo_sum - info.chain_stats.spent_txo_sum,
-      unconfirmedSat: info.mempool_stats.funded_txo_sum - info.mempool_stats.spent_txo_sum
-    };
-  }
-});
-var btcUtxos = import_ai.tool({
-  description: "List of unspent outputs for a Bitcoin address (truncated to `limit`).",
-  inputSchema: import_zod.z.object({
-    address: BTC_ADDRESS,
-    limit: import_zod.z.number().int().min(1).max(50).default(25)
-  }),
-  execute: async ({ address, limit }) => {
-    const utxos = await get(`/api/address/${encodeURIComponent(address)}/utxo`);
-    return { utxos: utxos.slice(0, limit) };
-  }
-});
-var btcFeeEstimate = import_ai.tool({
-  description: "Current Bitcoin fee estimates in sat/vB across priority tiers (fastest, 30-min, hour, economy).",
-  inputSchema: import_zod.z.object({}),
-  execute: async () => {
-    const fees = await get("/api/v1/fees/recommended");
-    return {
-      fastestSatVb: fees.fastestFee ?? 0,
-      halfHourSatVb: fees.halfHourFee ?? 0,
-      hourSatVb: fees.hourFee ?? 0,
-      economySatVb: fees.economyFee ?? 0,
-      minimumSatVb: fees.minimumFee ?? 0
-    };
-  }
-});
-var btcBlockHeight = import_ai.tool({
-  description: "Current Bitcoin chain tip height.",
-  inputSchema: import_zod.z.object({}),
-  execute: async () => ({
-    height: await get("/api/blocks/tip/height")
-  })
-});
-
-//# debugId=A9918581E436E21F64756E2164756E21
-//# sourceMappingURL=index.cjs.map

package/dist/src/tools/btc/index.cjs.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/tools/btc/index.ts"],
-  "sourcesContent": [
-    "/**\n * Bitcoin read tools for AI SDK tool calls. Useful for sBTC peg-in/peg-out\n * flows, BTC-collateralized lending, and anywhere a Stacks contract's\n * behaviour depends on BTC state.\n *\n * @deprecated Point your agent at `@secondlayer/mcp` instead; this entry\n * stays importable until the next major but gets no new tools. Installing\n * it means installing `ai` and `zod` yourself: both are optional peers of\n * the package, not dependencies.\n *\n * Backed by mempool.space by default. Swap endpoints by setting\n * `BTC_MEMPOOL_URL` in the caller's env. Reads only, no BTC writes.\n *\n *   import { generateText } from \"ai\"\n *   import { btcConfirmations, btcBalance } from \"@secondlayer/stacks/tools/btc\"\n *   await generateText({\n *     model: anthropic(\"claude-sonnet-4-6\"),\n *     tools: { btcConfirmations, btcBalance },\n *     prompt: \"…\",\n *   })\n */\n\nimport { type Tool, tool } from \"ai\";\nimport { z } from \"zod\";\n\n// biome-ignore lint/suspicious/noExplicitAny: Tool's input-schema generic too precise for isolated-declarations; AI SDK validates at runtime\ntype LooseTool = Tool<any, any>;\n\nfunction baseUrl(): string {\n\treturn (process.env.BTC_MEMPOOL_URL ?? \"https://mempool.space\").replace(\n\t\t/\\/$/,\n\t\t\"\",\n\t);\n}\n\nasync function get<T>(path: string): Promise<T> {\n\tconst res = await fetch(`${baseUrl()}${path}`, {\n\t\theaders: { Accept: \"application/json\" },\n\t});\n\tif (!res.ok) {\n\t\tthrow new Error(\n\t\t\t`BTC mempool.space ${path} → ${res.status} ${res.statusText}`,\n\t\t);\n\t}\n\tconst contentType = res.headers.get(\"content-type\") ?? \"\";\n\tif (contentType.includes(\"application/json\")) return res.json() as Promise<T>;\n\treturn res.text() as unknown as Promise<T>;\n}\n\nconst BTC_TXID = z\n\t.string()\n\t.regex(/^[0-9a-fA-F]{64}$/, \"64-character hex BTC txid\");\nexport const BTC_ADDRESS: z.ZodString = z\n\t.string()\n\t.regex(\n\t\t/^(1[a-zA-HJ-NP-Z0-9]{25,34}|3[a-zA-HJ-NP-Z0-9]{25,34}|bc1[a-zA-HJ-NP-Z0-9]{11,71}|tb1[a-zA-HJ-NP-Z0-9]{11,71})$/,\n\t\t{ message: \"Invalid Bitcoin address\" },\n\t);\n\nexport const btcConfirmations: LooseTool = tool({\n\tdescription:\n\t\t\"Number of confirmations for a Bitcoin transaction. Returns { confirmations, confirmed }.\",\n\tinputSchema: z.object({ txid: BTC_TXID }),\n\texecute: async ({ txid }) => {\n\t\tconst tx = await get<{\n\t\t\tstatus: { confirmed: boolean; block_height?: number };\n\t\t}>(`/api/tx/${txid}`);\n\t\tif (!tx.status.confirmed || tx.status.block_height == null) {\n\t\t\treturn { confirmed: false, confirmations: 0 };\n\t\t}\n\t\tconst tip = await get<number>(\"/api/blocks/tip/height\");\n\t\treturn {\n\t\t\tconfirmed: true,\n\t\t\tconfirmations: Math.max(0, tip - tx.status.block_height + 1),\n\t\t\tblockHeight: tx.status.block_height,\n\t\t};\n\t},\n});\n\nexport const btcBalance: LooseTool = tool({\n\tdescription:\n\t\t\"Bitcoin balance for an address, in satoshis. Returns { confirmedSat, unconfirmedSat }.\",\n\tinputSchema: z.object({ address: BTC_ADDRESS }),\n\texecute: async ({ address }) => {\n\t\tconst info = await get<{\n\t\t\tchain_stats: { funded_txo_sum: number; spent_txo_sum: number };\n\t\t\tmempool_stats: { funded_txo_sum: number; spent_txo_sum: number };\n\t\t}>(`/api/address/${encodeURIComponent(address)}`);\n\t\treturn {\n\t\t\tconfirmedSat:\n\t\t\t\tinfo.chain_stats.funded_txo_sum - info.chain_stats.spent_txo_sum,\n\t\t\tunconfirmedSat:\n\t\t\t\tinfo.mempool_stats.funded_txo_sum - info.mempool_stats.spent_txo_sum,\n\t\t};\n\t},\n});\n\nexport const btcUtxos: LooseTool = tool({\n\tdescription:\n\t\t\"List of unspent outputs for a Bitcoin address (truncated to `limit`).\",\n\tinputSchema: z.object({\n\t\taddress: BTC_ADDRESS,\n\t\tlimit: z.number().int().min(1).max(50).default(25),\n\t}),\n\texecute: async ({ address, limit }) => {\n\t\tconst utxos = await get<\n\t\t\tArray<{\n\t\t\t\ttxid: string;\n\t\t\t\tvout: number;\n\t\t\t\tvalue: number;\n\t\t\t\tstatus: { confirmed: boolean; block_height?: number };\n\t\t\t}>\n\t\t>(`/api/address/${encodeURIComponent(address)}/utxo`);\n\t\treturn { utxos: utxos.slice(0, limit) };\n\t},\n});\n\nexport const btcFeeEstimate: LooseTool = tool({\n\tdescription:\n\t\t\"Current Bitcoin fee estimates in sat/vB across priority tiers (fastest, 30-min, hour, economy).\",\n\tinputSchema: z.object({}),\n\texecute: async () => {\n\t\tconst fees = await get<Record<string, number>>(\"/api/v1/fees/recommended\");\n\t\treturn {\n\t\t\tfastestSatVb: fees.fastestFee ?? 0,\n\t\t\thalfHourSatVb: fees.halfHourFee ?? 0,\n\t\t\thourSatVb: fees.hourFee ?? 0,\n\t\t\teconomySatVb: fees.economyFee ?? 0,\n\t\t\tminimumSatVb: fees.minimumFee ?? 0,\n\t\t};\n\t},\n});\n\nexport const btcBlockHeight: LooseTool = tool({\n\tdescription: \"Current Bitcoin chain tip height.\",\n\tinputSchema: z.object({}),\n\texecute: async () => ({\n\t\theight: await get<number>(\"/api/blocks/tip/height\"),\n\t}),\n});\n"
-  ],
-  "mappings": "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",
-  "debugId": "A9918581E436E21F64756E2164756E21",
-  "names": []
-}

package/dist/src/tools/btc/index.d.cts

@@ -1,10 +0,0 @@
-import { Tool } from "ai";
-import { z } from "zod";
-type LooseTool = Tool<any, any>;
-declare const BTC_ADDRESS: z.ZodString;
-declare const btcConfirmations: LooseTool;
-declare const btcBalance: LooseTool;
-declare const btcUtxos: LooseTool;
-declare const btcFeeEstimate: LooseTool;
-declare const btcBlockHeight: LooseTool;
-export { btcUtxos, btcFeeEstimate, btcConfirmations, btcBlockHeight, btcBalance, BTC_ADDRESS };

package/dist/src/tools/btc/index.d.ts

@@ -1,10 +0,0 @@
-import { Tool } from "ai";
-import { z } from "zod";
-type LooseTool = Tool<any, any>;
-declare const BTC_ADDRESS: z.ZodString;
-declare const btcConfirmations: LooseTool;
-declare const btcBalance: LooseTool;
-declare const btcUtxos: LooseTool;
-declare const btcFeeEstimate: LooseTool;
-declare const btcBlockHeight: LooseTool;
-export { btcUtxos, btcFeeEstimate, btcConfirmations, btcBlockHeight, btcBalance, BTC_ADDRESS };

package/dist/src/tools/btc/index.js

@@ -1,90 +0,0 @@
-// src/tools/btc/index.ts
-import { tool } from "ai";
-import { z } from "zod";
-function baseUrl() {
-  return (process.env.BTC_MEMPOOL_URL ?? "https://mempool.space").replace(/\/$/, "");
-}
-async function get(path) {
-  const res = await fetch(`${baseUrl()}${path}`, {
-    headers: { Accept: "application/json" }
-  });
-  if (!res.ok) {
-    throw new Error(`BTC mempool.space ${path} → ${res.status} ${res.statusText}`);
-  }
-  const contentType = res.headers.get("content-type") ?? "";
-  if (contentType.includes("application/json"))
-    return res.json();
-  return res.text();
-}
-var BTC_TXID = z.string().regex(/^[0-9a-fA-F]{64}$/, "64-character hex BTC txid");
-var BTC_ADDRESS = z.string().regex(/^(1[a-zA-HJ-NP-Z0-9]{25,34}|3[a-zA-HJ-NP-Z0-9]{25,34}|bc1[a-zA-HJ-NP-Z0-9]{11,71}|tb1[a-zA-HJ-NP-Z0-9]{11,71})$/, { message: "Invalid Bitcoin address" });
-var btcConfirmations = tool({
-  description: "Number of confirmations for a Bitcoin transaction. Returns { confirmations, confirmed }.",
-  inputSchema: z.object({ txid: BTC_TXID }),
-  execute: async ({ txid }) => {
-    const tx = await get(`/api/tx/${txid}`);
-    if (!tx.status.confirmed || tx.status.block_height == null) {
-      return { confirmed: false, confirmations: 0 };
-    }
-    const tip = await get("/api/blocks/tip/height");
-    return {
-      confirmed: true,
-      confirmations: Math.max(0, tip - tx.status.block_height + 1),
-      blockHeight: tx.status.block_height
-    };
-  }
-});
-var btcBalance = tool({
-  description: "Bitcoin balance for an address, in satoshis. Returns { confirmedSat, unconfirmedSat }.",
-  inputSchema: z.object({ address: BTC_ADDRESS }),
-  execute: async ({ address }) => {
-    const info = await get(`/api/address/${encodeURIComponent(address)}`);
-    return {
-      confirmedSat: info.chain_stats.funded_txo_sum - info.chain_stats.spent_txo_sum,
-      unconfirmedSat: info.mempool_stats.funded_txo_sum - info.mempool_stats.spent_txo_sum
-    };
-  }
-});
-var btcUtxos = tool({
-  description: "List of unspent outputs for a Bitcoin address (truncated to `limit`).",
-  inputSchema: z.object({
-    address: BTC_ADDRESS,
-    limit: z.number().int().min(1).max(50).default(25)
-  }),
-  execute: async ({ address, limit }) => {
-    const utxos = await get(`/api/address/${encodeURIComponent(address)}/utxo`);
-    return { utxos: utxos.slice(0, limit) };
-  }
-});
-var btcFeeEstimate = tool({
-  description: "Current Bitcoin fee estimates in sat/vB across priority tiers (fastest, 30-min, hour, economy).",
-  inputSchema: z.object({}),
-  execute: async () => {
-    const fees = await get("/api/v1/fees/recommended");
-    return {
-      fastestSatVb: fees.fastestFee ?? 0,
-      halfHourSatVb: fees.halfHourFee ?? 0,
-      hourSatVb: fees.hourFee ?? 0,
-      economySatVb: fees.economyFee ?? 0,
-      minimumSatVb: fees.minimumFee ?? 0
-    };
-  }
-});
-var btcBlockHeight = tool({
-  description: "Current Bitcoin chain tip height.",
-  inputSchema: z.object({}),
-  execute: async () => ({
-    height: await get("/api/blocks/tip/height")
-  })
-});
-export {
-  btcUtxos,
-  btcFeeEstimate,
-  btcConfirmations,
-  btcBlockHeight,
-  btcBalance,
-  BTC_ADDRESS
-};
-
-//# debugId=E811F99F534F2FE364756E2164756E21
-//# sourceMappingURL=index.js.map

package/dist/src/tools/btc/index.js.map

@@ -1,10 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../src/tools/btc/index.ts"],
-  "sourcesContent": [
-    "/**\n * Bitcoin read tools for AI SDK tool calls. Useful for sBTC peg-in/peg-out\n * flows, BTC-collateralized lending, and anywhere a Stacks contract's\n * behaviour depends on BTC state.\n *\n * @deprecated Point your agent at `@secondlayer/mcp` instead; this entry\n * stays importable until the next major but gets no new tools. Installing\n * it means installing `ai` and `zod` yourself: both are optional peers of\n * the package, not dependencies.\n *\n * Backed by mempool.space by default. Swap endpoints by setting\n * `BTC_MEMPOOL_URL` in the caller's env. Reads only, no BTC writes.\n *\n *   import { generateText } from \"ai\"\n *   import { btcConfirmations, btcBalance } from \"@secondlayer/stacks/tools/btc\"\n *   await generateText({\n *     model: anthropic(\"claude-sonnet-4-6\"),\n *     tools: { btcConfirmations, btcBalance },\n *     prompt: \"…\",\n *   })\n */\n\nimport { type Tool, tool } from \"ai\";\nimport { z } from \"zod\";\n\n// biome-ignore lint/suspicious/noExplicitAny: Tool's input-schema generic too precise for isolated-declarations; AI SDK validates at runtime\ntype LooseTool = Tool<any, any>;\n\nfunction baseUrl(): string {\n\treturn (process.env.BTC_MEMPOOL_URL ?? \"https://mempool.space\").replace(\n\t\t/\\/$/,\n\t\t\"\",\n\t);\n}\n\nasync function get<T>(path: string): Promise<T> {\n\tconst res = await fetch(`${baseUrl()}${path}`, {\n\t\theaders: { Accept: \"application/json\" },\n\t});\n\tif (!res.ok) {\n\t\tthrow new Error(\n\t\t\t`BTC mempool.space ${path} → ${res.status} ${res.statusText}`,\n\t\t);\n\t}\n\tconst contentType = res.headers.get(\"content-type\") ?? \"\";\n\tif (contentType.includes(\"application/json\")) return res.json() as Promise<T>;\n\treturn res.text() as unknown as Promise<T>;\n}\n\nconst BTC_TXID = z\n\t.string()\n\t.regex(/^[0-9a-fA-F]{64}$/, \"64-character hex BTC txid\");\nexport const BTC_ADDRESS: z.ZodString = z\n\t.string()\n\t.regex(\n\t\t/^(1[a-zA-HJ-NP-Z0-9]{25,34}|3[a-zA-HJ-NP-Z0-9]{25,34}|bc1[a-zA-HJ-NP-Z0-9]{11,71}|tb1[a-zA-HJ-NP-Z0-9]{11,71})$/,\n\t\t{ message: \"Invalid Bitcoin address\" },\n\t);\n\nexport const btcConfirmations: LooseTool = tool({\n\tdescription:\n\t\t\"Number of confirmations for a Bitcoin transaction. Returns { confirmations, confirmed }.\",\n\tinputSchema: z.object({ txid: BTC_TXID }),\n\texecute: async ({ txid }) => {\n\t\tconst tx = await get<{\n\t\t\tstatus: { confirmed: boolean; block_height?: number };\n\t\t}>(`/api/tx/${txid}`);\n\t\tif (!tx.status.confirmed || tx.status.block_height == null) {\n\t\t\treturn { confirmed: false, confirmations: 0 };\n\t\t}\n\t\tconst tip = await get<number>(\"/api/blocks/tip/height\");\n\t\treturn {\n\t\t\tconfirmed: true,\n\t\t\tconfirmations: Math.max(0, tip - tx.status.block_height + 1),\n\t\t\tblockHeight: tx.status.block_height,\n\t\t};\n\t},\n});\n\nexport const btcBalance: LooseTool = tool({\n\tdescription:\n\t\t\"Bitcoin balance for an address, in satoshis. Returns { confirmedSat, unconfirmedSat }.\",\n\tinputSchema: z.object({ address: BTC_ADDRESS }),\n\texecute: async ({ address }) => {\n\t\tconst info = await get<{\n\t\t\tchain_stats: { funded_txo_sum: number; spent_txo_sum: number };\n\t\t\tmempool_stats: { funded_txo_sum: number; spent_txo_sum: number };\n\t\t}>(`/api/address/${encodeURIComponent(address)}`);\n\t\treturn {\n\t\t\tconfirmedSat:\n\t\t\t\tinfo.chain_stats.funded_txo_sum - info.chain_stats.spent_txo_sum,\n\t\t\tunconfirmedSat:\n\t\t\t\tinfo.mempool_stats.funded_txo_sum - info.mempool_stats.spent_txo_sum,\n\t\t};\n\t},\n});\n\nexport const btcUtxos: LooseTool = tool({\n\tdescription:\n\t\t\"List of unspent outputs for a Bitcoin address (truncated to `limit`).\",\n\tinputSchema: z.object({\n\t\taddress: BTC_ADDRESS,\n\t\tlimit: z.number().int().min(1).max(50).default(25),\n\t}),\n\texecute: async ({ address, limit }) => {\n\t\tconst utxos = await get<\n\t\t\tArray<{\n\t\t\t\ttxid: string;\n\t\t\t\tvout: number;\n\t\t\t\tvalue: number;\n\t\t\t\tstatus: { confirmed: boolean; block_height?: number };\n\t\t\t}>\n\t\t>(`/api/address/${encodeURIComponent(address)}/utxo`);\n\t\treturn { utxos: utxos.slice(0, limit) };\n\t},\n});\n\nexport const btcFeeEstimate: LooseTool = tool({\n\tdescription:\n\t\t\"Current Bitcoin fee estimates in sat/vB across priority tiers (fastest, 30-min, hour, economy).\",\n\tinputSchema: z.object({}),\n\texecute: async () => {\n\t\tconst fees = await get<Record<string, number>>(\"/api/v1/fees/recommended\");\n\t\treturn {\n\t\t\tfastestSatVb: fees.fastestFee ?? 0,\n\t\t\thalfHourSatVb: fees.halfHourFee ?? 0,\n\t\t\thourSatVb: fees.hourFee ?? 0,\n\t\t\teconomySatVb: fees.economyFee ?? 0,\n\t\t\tminimumSatVb: fees.minimumFee ?? 0,\n\t\t};\n\t},\n});\n\nexport const btcBlockHeight: LooseTool = tool({\n\tdescription: \"Current Bitcoin chain tip height.\",\n\tinputSchema: z.object({}),\n\texecute: async () => ({\n\t\theight: await get<number>(\"/api/blocks/tip/height\"),\n\t}),\n});\n"
-  ],
-  "mappings": "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",
-  "debugId": "E811F99F534F2FE364756E2164756E21",
-  "names": []
-}