@secondlayer/stacks 2.13.0 → 2.14.1

package/dist/src/tools/index.cjs

@@ -43,12 +43,12 @@ __export(exports_tools, {
   readContract: () => readContract2,
   getTransaction: () => getTransaction2,
   getStxBalance: () => getStxBalance,
-  getNftHoldings: () => getNftHoldings,
-  getMempoolStats: () => getMempoolStats,
+  getNftHoldings: () => getNftHoldings2,
+  getMempoolStats: () => getMempoolStats2,
   getBlockHeight: () => getBlockHeight2,
   getBlock: () => getBlock2,
   getAccountInfo: () => getAccountInfo2,
-  getAccountHistory: () => getAccountHistory,
+  getAccountHistory: () => getAccountHistory2,
   estimateFee: () => estimateFee2,
   createStacksTools: () => createStacksTools,
   bnsReverse: () => bnsReverse,
@@ -672,11 +672,51 @@ async function estimateFee(client, params) {
   }));
 }
 
+// src/actions/public/getAccountHistory.ts
+async function getAccountHistory(client, params) {
+  const limit = Math.min(params.limit ?? 20, 50);
+  return client.request(`/extended/v2/addresses/${params.address}/transactions?limit=${limit}`, { method: "GET" });
+}
+
+// src/errors/base.ts
+class BaseError extends Error {
+  name = "StacksError";
+  shortMessage;
+  details;
+  constructor(shortMessage, options) {
+    const message = [
+      shortMessage,
+      options?.details ? `
+${options.details}` : ""
+    ].join("");
+    super(message, { cause: options?.cause });
+    this.shortMessage = shortMessage;
+    this.details = options?.details;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      shortMessage: this.shortMessage,
+      details: this.details,
+      cause: this.cause instanceof Error ? this.cause.message : undefined
+    };
+  }
+}
+
+// src/errors/response.ts
+class MalformedResponseError extends BaseError {
+  name = "MalformedResponseError";
+}
+
 // src/actions/public/getAccountInfo.ts
 async function getAccountInfo(client, params) {
   const data = await client.request(`/v2/accounts/${params.address}?proof=1`, {
     method: "GET"
   });
+  if (data?.balance === undefined || data?.nonce === undefined) {
+    throw new MalformedResponseError(`getAccountInfo: /v2/accounts/${params.address} response is missing "balance" or "nonce"`);
+  }
   return {
     balance: BigInt(data.balance),
     nonce: BigInt(data.nonce),
@@ -690,6 +730,9 @@ async function getBalance(client, params) {
   const data = await client.request(`/v2/accounts/${params.address}`, {
     method: "GET"
   });
+  if (data?.balance === undefined) {
+    throw new MalformedResponseError(`getBalance: /v2/accounts/${params.address} response is missing "balance"`);
+  }
   return BigInt(data.balance);
 }
 
@@ -711,9 +754,23 @@ async function getBlock(client, params) {
 // src/actions/public/getBlockHeight.ts
 async function getBlockHeight(client) {
   const data = await client.request("/v2/info", { method: "GET" });
+  if (typeof data?.stacks_tip_height !== "number") {
+    throw new MalformedResponseError('getBlockHeight: /v2/info response is missing "stacks_tip_height"');
+  }
   return data.stacks_tip_height;
 }
 
+// src/actions/public/getMempoolStats.ts
+async function getMempoolStats(client) {
+  return client.request("/extended/v1/tx/mempool/stats", { method: "GET" });
+}
+
+// src/actions/public/getNftHoldings.ts
+async function getNftHoldings(client, params) {
+  const limit = Math.min(params.limit ?? 20, 50);
+  return client.request(`/extended/v1/tokens/nft/holdings?principal=${encodeURIComponent(params.address)}&limit=${limit}`, { method: "GET" });
+}
+
 // src/utils/bytes-reader.ts
 class BytesReader {
   data;
@@ -978,6 +1035,82 @@ function deserializeCVBytes(input) {
   return readCV(new BytesReader(bytes));
 }
 
+// src/errors/http.ts
+class HttpRequestError extends BaseError {
+  name = "HttpRequestError";
+  status;
+  constructor(status, options) {
+    super(`HTTP request failed with status ${status}`, options);
+    this.status = status;
+  }
+}
+
+// src/actions/public/txSources.ts
+function normalizeTxid(txid) {
+  return txid.startsWith("0x") ? txid : `0x${txid}`;
+}
+function decodeResultHex(hex) {
+  if (!hex)
+    return {};
+  try {
+    return { result: deserializeCVBytes(hex), resultHex: hex };
+  } catch {
+    return { resultHex: hex };
+  }
+}
+function normalizeStatus(txStatus) {
+  switch (txStatus) {
+    case "pending":
+    case "success":
+    case "abort_by_response":
+    case "abort_by_post_condition":
+      return txStatus;
+    default:
+      return txStatus.startsWith("dropped") ? "dropped" : undefined;
+  }
+}
+function extendedApiSource() {
+  return {
+    async get({ client, txid }) {
+      let data;
+      try {
+        data = await client.request(`/extended/v1/tx/${normalizeTxid(txid)}`, {
+          method: "GET"
+        });
+      } catch (error) {
+        if (error instanceof HttpRequestError && error.status === 404) {
+          return { receipt: null };
+        }
+        throw error;
+      }
+      const txStatus = typeof data?.tx_status === "string" ? data.tx_status : undefined;
+      if (!txStatus)
+        return { receipt: null };
+      const status = normalizeStatus(txStatus);
+      if (!status)
+        return { receipt: null };
+      return {
+        receipt: {
+          txid: normalizeTxid(txid),
+          status,
+          blockHeight: typeof data.block_height === "number" && data.block_height > 0 ? data.block_height : undefined,
+          blockHash: data.block_hash ?? undefined,
+          ...decodeResultHex(data.tx_result?.hex),
+          events: Array.isArray(data.events) ? data.events : [],
+          raw: data
+        }
+      };
+    }
+  };
+}
+
+// src/actions/public/getTransaction.ts
+async function getTransaction(client, params) {
+  const source = params.source ?? extendedApiSource();
+  const { receipt } = await source.get({ client, txid: params.txid });
+  return receipt;
+}
+
 // src/actions/public/readContract.ts
 async function readContract(client, params) {
   const [address, name] = parseContractId(params.contract);
@@ -1423,6 +1556,9 @@ async function getMapEntry(client, params) {
     method: "POST",
     body: serializedKey
   });
+  if (typeof data?.data !== "string") {
+    throw new MalformedResponseError(`getMapEntry: /v2/map_entry/${address}/${name}/${params.mapName} response is missing "data"`);
+  }
   return deserializeCVBytes(data.data);
 }
 
@@ -1458,32 +1594,6 @@ function getTransactionId(tx) {
   return txid(tx);
 }
 
-// src/errors/base.ts
-class BaseError extends Error {
-  name = "StacksError";
-  shortMessage;
-  details;
-  constructor(shortMessage, options) {
-    const message = [
-      shortMessage,
-      options?.details ? `
-${options.details}` : ""
-    ].join("");
-    super(message, { cause: options?.cause });
-    this.shortMessage = shortMessage;
-    this.details = options?.details;
-  }
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message,
-      shortMessage: this.shortMessage,
-      details: this.details,
-      cause: this.cause instanceof Error ? this.cause.message : undefined
-    };
-  }
-}
-
 // src/errors/transaction.ts
 class BroadcastError extends BaseError {
   name = "BroadcastError";
@@ -1537,55 +1647,6 @@ async function getNonce(client, params) {
   return BigInt(nonce);
 }
 
-// src/actions/public/txSources.ts
-function normalizeTxid(txid2) {
-  return txid2.startsWith("0x") ? txid2 : `0x${txid2}`;
-}
-function decodeResultHex(hex) {
-  if (!hex)
-    return {};
-  try {
-    return { result: deserializeCVBytes(hex), resultHex: hex };
-  } catch {
-    return { resultHex: hex };
-  }
-}
-function normalizeStatus(txStatus) {
-  switch (txStatus) {
-    case "pending":
-    case "success":
-    case "abort_by_response":
-    case "abort_by_post_condition":
-      return txStatus;
-    default:
-      return txStatus.startsWith("dropped") ? "dropped" : undefined;
-  }
-}
-function extendedApiSource() {
-  return {
-    async get({ client, txid: txid2 }) {
-      const data = await client.request(`/extended/v1/tx/${normalizeTxid(txid2)}`, { method: "GET" });
-      const txStatus = typeof data?.tx_status === "string" ? data.tx_status : undefined;
-      if (!txStatus)
-        return { receipt: null };
-      const status = normalizeStatus(txStatus);
-      if (!status)
-        return { receipt: null };
-      return {
-        receipt: {
-          txid: normalizeTxid(txid2),
-          status,
-          blockHeight: typeof data.block_height === "number" && data.block_height > 0 ? data.block_height : undefined,
-          blockHash: data.block_hash ?? undefined,
-          ...decodeResultHex(data.tx_result?.hex),
-          events: Array.isArray(data.events) ? data.events : [],
-          raw: data
-        }
-      };
-    }
-  };
-}
-
 // src/actions/public/waitForTransactionReceipt.ts
 var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 async function waitForTransactionReceipt(client, params) {
@@ -1645,10 +1706,20 @@ async function sendTransaction(client, params) {
   if (params.attachment) {
     body.attachment = typeof params.attachment === "string" ? params.attachment : bytesToHex(params.attachment);
   }
-  const data = await client.request("/v2/transactions", {
-    method: "POST",
-    body
-  });
+  let data;
+  try {
+    data = await client.request("/v2/transactions", { method: "POST", body });
+  } catch (error) {
+    if (error instanceof HttpRequestError && error.details) {
+      try {
+        data = JSON.parse(error.details);
+      } catch {
+        throw error;
+      }
+    } else {
+      throw error;
+    }
+  }
   if (data.error) {
     throw new BroadcastError(data.reason ?? data.error, {
       reason: data.reason,
@@ -2583,11 +2654,31 @@ async function getContractAbi(client, params) {
   });
 }
 
-// src/actions/public/getTransaction.ts
-async function getTransaction(client, params) {
-  const source = params.source ?? extendedApiSource();
-  const { receipt } = await source.get({ client, txid: params.txid });
-  return receipt;
+// src/actions/public/getContractSource.ts
+async function getContractSource(client, params) {
+  const [address, name] = parseContractId(params.contract);
+  try {
+    const data = await client.request(`/v2/contracts/source/${address}/${name}`, { method: "GET" });
+    return data?.source ? data : null;
+  } catch (error) {
+    if (error instanceof HttpRequestError && error.status === 404)
+      return null;
+    throw error;
+  }
+}
+
+// src/actions/public/getRawBlock.ts
+async function getRawBlock(client, params) {
+  try {
+    const data = await client.request(`/v2/blocks/${params.height}`, {
+      method: "GET"
+    });
+    return data?.hash ? data : null;
+  } catch (error) {
+    if (error instanceof HttpRequestError && error.status === 404)
+      return null;
+    throw error;
+  }
 }
 
 // src/actions/public/multicall.ts
@@ -2732,15 +2823,20 @@ function publicActions(client) {
     getBalance: (params) => getBalance(client, params),
     getAccountInfo: (params) => getAccountInfo(client, params),
     getBlock: (params) => getBlock(client, params),
+    getRawBlock: (params) => getRawBlock(client, params),
     getBlockHeight: () => getBlockHeight(client),
     readContract: (params) => readContract(client, params),
     getContractAbi: (params) => getContractAbi(client, params),
+    getContractSource: (params) => getContractSource(client, params),
     getMapEntry: (params) => getMapEntry(client, params),
     estimateFee: (params) => estimateFee(client, params),
     multicall: (params) => multicall(client, params),
     simulateCall: (params) => simulateCall(client, params),
     simulateTransaction: (params) => simulateTransaction(client, params),
     getTransaction: (params) => getTransaction(client, params),
+    getAccountHistory: (params) => getAccountHistory(client, params),
+    getMempoolStats: () => getMempoolStats(client),
+    getNftHoldings: (params) => getNftHoldings(client, params),
     waitForTransactionReceipt: (params) => waitForTransactionReceipt(client, params),
     watchBlocks: (params) => watchBlocks(client, params),
     watchMempool: (params) => watchMempool(client, params),
@@ -2764,27 +2860,42 @@ function createTransport(type, config) {
     config
   };
 }
+function isRetryableStatus(status) {
+  return status === 429 || status >= 500;
+}
 async function fetchWithRetry(url, options, retryCount, retryDelay, timeout) {
   let lastError;
   for (let attempt = 0;attempt <= retryCount; attempt++) {
+    let response;
     try {
       const controller = new AbortController;
       const timeoutId = setTimeout(() => controller.abort(), timeout);
-      const response = await fetch(url, {
+      response = await fetch(url, {
         ...options,
         signal: controller.signal
       });
       clearTimeout(timeoutId);
-      if (response.ok || response.status < 500) {
-        return response;
-      }
-      lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
     } catch (error) {
       lastError = error instanceof Error ? error : new Error(String(error));
+      if (attempt < retryCount) {
+        await new Promise((r) => setTimeout(r, retryDelay * (attempt + 1)));
+        continue;
+      }
+      throw lastError;
     }
-    if (attempt < retryCount) {
-      await new Promise((r) => setTimeout(r, retryDelay * (attempt + 1)));
+    if (response.ok) {
+      return response;
     }
+    const retryable = isRetryableStatus(response.status);
+    if (!retryable || attempt === retryCount) {
+      throw new HttpRequestError(response.status, {
+        details: await response.text().catch(() => {
+          return;
+        })
+      });
+    }
+    lastError = new HttpRequestError(response.status);
+    await new Promise((r) => setTimeout(r, retryDelay * (attempt + 1)));
   }
   throw lastError ?? new Error("Request failed");
 }
@@ -2894,31 +3005,17 @@ async function bnsResolveImpl(client, name) {
 async function bnsReverseImpl(client, principal) {
   return { name: await getPrimaryName(client, principal) };
 }
-function hiroBase(client) {
-  const url = client.chain?.rpcUrls.default.http[0] ?? process.env.STACKS_RPC_URL ?? "https://api.hiro.so";
-  return url.replace(/\/$/, "");
-}
-async function hiroGet(client, path) {
-  const res = await fetch(`${hiroBase(client)}${path}`, {
-    headers: { Accept: "application/json" }
-  });
-  if (!res.ok) {
-    throw new Error(`Hiro API ${path} → ${res.status} ${res.statusText}`);
-  }
-  return res.json();
-}
 async function transactionByTxId(client, txId) {
-  const normalized = txId.startsWith("0x") ? txId : `0x${txId}`;
-  return hiroGet(client, `/extended/v1/tx/${normalized}`);
+  return getTransaction(client, { txid: txId });
 }
 async function accountHistory(client, principal, limit) {
-  return hiroGet(client, `/extended/v2/addresses/${principal}/transactions?limit=${Math.min(limit, 50)}`);
+  return getAccountHistory(client, { address: principal, limit });
 }
 async function mempoolStats(client) {
-  return hiroGet(client, "/extended/v1/tx/mempool/stats");
+  return getMempoolStats(client);
 }
 async function nftHoldings(client, principal, limit) {
-  return hiroGet(client, `/extended/v1/tokens/nft/holdings?principal=${encodeURIComponent(principal)}&limit=${Math.min(limit, 50)}`);
+  return getNftHoldings(client, { address: principal, limit });
 }
 function createStacksTools(client) {
   return {
@@ -3055,7 +3152,7 @@ var getTransaction2 = import_ai.tool({
   inputSchema: import_zod.z.object({ txId: import_zod.z.string() }),
   execute: ({ txId }) => transactionByTxId(getDefaultPublicClient(), txId)
 });
-var getAccountHistory = import_ai.tool({
+var getAccountHistory2 = import_ai.tool({
   description: "Paginated transaction history for a Stacks principal (Hiro extended API).",
   inputSchema: import_zod.z.object({
     principal: PRINCIPAL,
@@ -3063,12 +3160,12 @@ var getAccountHistory = import_ai.tool({
   }),
   execute: ({ principal, limit }) => accountHistory(getDefaultPublicClient(), principal, limit)
 });
-var getMempoolStats = import_ai.tool({
+var getMempoolStats2 = import_ai.tool({
   description: "Current mempool statistics: pending count, fee distribution, age buckets (Hiro extended API).",
   inputSchema: import_zod.z.object({}),
   execute: () => mempoolStats(getDefaultPublicClient())
 });
-var getNftHoldings = import_ai.tool({
+var getNftHoldings2 = import_ai.tool({
   description: "NFT holdings for a Stacks principal across all collections (Hiro extended API).",
   inputSchema: import_zod.z.object({
     principal: PRINCIPAL,
@@ -3077,5 +3174,5 @@ var getNftHoldings = import_ai.tool({
   execute: ({ principal, limit }) => nftHoldings(getDefaultPublicClient(), principal, limit)
 });
 
-//# debugId=E0CFA9E2C0C074CF64756E2164756E21
+//# debugId=726789478731037064756E2164756E21
 //# sourceMappingURL=index.cjs.map