@secretkeylabs/stacks-tools 0.6.0-6e4e19c → 0.6.0-9c72bfd

package/README.md

@@ -4,13 +4,13 @@ A collection of methods for calling the Stacks API and managing Stacks pools.
 
 ## Quickstart
 
-Install dependencies with
+Install dependencies with:
 
 ```shell
 bun install
 ```
 
-and build the package with
+and build the package with:
 
 ```shell
 bun run build

package/dist/index.cjs

@@ -28,8 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   callRateLimitedApi: () => callRateLimitedApi,
   error: () => error,
   pox4Api: () => pox4Api,
@@ -41,7 +41,7 @@ __export(src_exports, {
   stacksRpcApi: () => stacksRpcApi,
   success: () => success
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/utils/safe.ts
 function success(data) {
@@ -705,6 +705,80 @@ var stackingPool = {
   members
 };
 
+// src/stacks-api/transactions/address-transactions.ts
+async function addressTransactions(args) {
+  const search = new URLSearchParams();
+  if (args.limit) search.append("limit", args.limit.toString());
+  if (args.offset) search.append("offset", args.offset.toString());
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const res = await fetch(
+    `${args.baseUrl}/extended/v2/addresses/${args.address}/transactions?${search}`,
+    init
+  );
+  if (!res.ok) {
+    return error({
+      name: "FetchAddressTransactionsError",
+      message: "Failed to fetch address transactions.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyText: await safePromise(res.text())
+      }
+    });
+  }
+  const [jsonParseError, data] = await safePromise(res.json());
+  if (jsonParseError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: jsonParseError
+    });
+  }
+  return success(data);
+}
+
+// src/stacks-api/transactions/events-for-an-address-transaction.ts
+async function eventsForAnAddressTransaction(args) {
+  const search = new URLSearchParams();
+  if (args.limit) search.append("limit", args.limit.toString());
+  if (args.offset) search.append("offset", args.offset.toString());
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${args.baseUrl}/extended/v2/addresses/${args.address}/transactions/${args.transactionId}/events?${search}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchEventsForAnAddressTransactionError",
+      message: `Failed to fetch address transaction events.`,
+      data: {
+        address: args.address,
+        transactionId: args.transactionId,
+        status: res.status,
+        statusText: res.statusText,
+        bodyText: await safePromise(res.text())
+      }
+    });
+  }
+  const [jsonParseError, data] = await safePromise(res.json());
+  if (jsonParseError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      error: jsonParseError
+    });
+  }
+  return success(data);
+}
+
 // src/stacks-api/transactions/schemas.ts
 var v11 = __toESM(require("valibot"), 1);
 var baseTransactionSchema = v11.object({
@@ -794,81 +868,8 @@ var transactionSchema = v11.variant("tx_type", [
   tokenTransferSchema
 ]);
 
-// src/stacks-api/transactions/address-transactions.ts
-var v12 = __toESM(require("valibot"), 1);
-var resultSchema = v12.object({
-  tx: transactionSchema,
-  stx_sent: v12.string(),
-  stx_received: v12.string(),
-  events: v12.object({
-    stx: v12.object({
-      transfer: v12.number(),
-      mint: v12.number(),
-      burn: v12.number()
-    }),
-    ft: v12.object({
-      transfer: v12.number(),
-      mint: v12.number(),
-      burn: v12.number()
-    }),
-    nft: v12.object({
-      transfer: v12.number(),
-      mint: v12.number(),
-      burn: v12.number()
-    })
-  })
-});
-var resultsSchema4 = v12.array(resultSchema);
-var addressTransactionsResponseSchema = v12.object({
-  ...baseListResponseSchema.entries,
-  results: resultsSchema4
-});
-async function addressTransactions(args) {
-  const search = new URLSearchParams();
-  if (args.limit) search.append("limit", args.limit.toString());
-  if (args.offset) search.append("offset", args.offset.toString());
-  const init = {};
-  if (args.apiKeyConfig) {
-    init.headers = {
-      [args.apiKeyConfig.header]: args.apiKeyConfig.key
-    };
-  }
-  const res = await fetch(
-    `${args.baseUrl}/extended/v2/addresses/${args.address}/transactions?${search}`,
-    init
-  );
-  if (!res.ok) {
-    return error({
-      name: "FetchAddressTransactionsError",
-      message: "Failed to fetch address transactions.",
-      data: {
-        status: res.status,
-        statusText: res.statusText,
-        bodyText: await safePromise(res.text())
-      }
-    });
-  }
-  const [jsonParseError, data] = await safePromise(res.json());
-  if (jsonParseError) {
-    return error({
-      name: "ParseBodyError",
-      message: "Failed to parse response body as JSON.",
-      data: jsonParseError
-    });
-  }
-  const validationResult = v12.safeParse(addressTransactionsResponseSchema, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      data: validationResult
-    });
-  }
-  return success(validationResult.output);
-}
-
 // src/stacks-api/transactions/get-transaction.ts
-var v13 = __toESM(require("valibot"), 1);
+var v12 = __toESM(require("valibot"), 1);
 async function getTransaction(args) {
   const init = {};
   if (args.apiKeyConfig) {
@@ -881,8 +882,9 @@ async function getTransaction(args) {
   if (!res.ok) {
     return error({
       name: "FetchTransactionError",
-      message: `Failed to fetch transaction ${args.transactionId}`,
-      response: {
+      message: `Failed to fetch transaction.`,
+      data: {
+        transactionId: args.transactionId,
         status: res.status,
         statusText: res.statusText,
         bodyText: await safePromise(res.text())
@@ -897,7 +899,7 @@ async function getTransaction(args) {
       error: jsonParseError
     });
   }
-  const validationResult = v13.safeParse(transactionSchema, data);
+  const validationResult = v12.safeParse(transactionSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -954,6 +956,7 @@ async function mempoolTransactions(args) {
 // src/stacks-api/transactions/index.ts
 var transactions = {
   addressTransactions,
+  eventsForAnAddressTransaction,
   getTransaction,
   mempoolTransactions
 };
@@ -1008,16 +1011,16 @@ var stacksApi = {
 };
 
 // src/stacks-rpc-api/smart-contracts/map-entry.ts
-var v14 = __toESM(require("valibot"), 1);
-var mapEntryResponseSchema = v14.object({
+var v13 = __toESM(require("valibot"), 1);
+var mapEntryResponseSchema = v13.object({
   /**
    * Hex-encoded string of clarity value. It is always an optional tuple.
    */
-  data: v14.string(),
+  data: v13.string(),
   /**
    * Hex-encoded string of the MARF proof for the data
    */
-  proof: v14.optional(v14.string())
+  proof: v13.optional(v13.string())
 });
 async function mapEntry(args) {
   const search = new URLSearchParams();
@@ -1057,7 +1060,7 @@ async function mapEntry(args) {
       data: jsonError
     });
   }
-  const validationResult = v14.safeParse(mapEntryResponseSchema, data);
+  const validationResult = v13.safeParse(mapEntryResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",