@secondlayer/stacks 0.2.2 → 1.0.0-alpha.0

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

@@ -0,0 +1,89 @@
+// 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().describe("Bitcoin address (legacy, segwit, or taproot)");
+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/${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/${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
+};
+
+//# debugId=F2DF8EAD15141CD864756E2164756E21
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/tools/btc/index.ts"],
+  "sourcesContent": [
+    "/**\n * Bitcoin read tools, callable from a Stacks workflow. Useful for sBTC\n * peg-in/peg-out flows, BTC-collateralized lending, and anywhere a Stacks\n * contract's behaviour depends on BTC state.\n *\n * Backed by mempool.space by default. Override per-tool call is not\n * supported today; swap endpoints by setting `BTC_MEMPOOL_URL` in the\n * workflow runtime env. Reads only — no BTC writes.\n *\n *   import { btcConfirmations, btcBalance } from \"@secondlayer/stacks/tools/btc\"\n *   await step.generateText(\"research\", { tools: { btcConfirmations, btcBalance }, … })\n */\n\nimport { type Tool, tool } from \"ai\";\nimport { z } from \"zod\";\n\n// biome-ignore lint/suspicious/noExplicitAny: Tool's input-schema generic is too\n// precise for isolated-declarations output — we pass tools through to AI SDK\n// which 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\");\nconst BTC_ADDRESS = z\n\t.string()\n\t.describe(\"Bitcoin address (legacy, segwit, or taproot)\");\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/${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/${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": "F2DF8EAD15141CD864756E2164756E21",
+  "names": []
+}