@secretkeylabs/stacks-tools 0.6.0 → 0.7.0-6184ecb

package/dist/index.js

@@ -1,20 +1,44 @@
 // src/utils/safe.ts
+import { backOff } from "exponential-backoff";
 function success(data) {
   return [null, data];
 }
-function error(error2) {
-  return [error2, null];
+function error(errorArg) {
+  return [errorArg, null];
 }
 async function safePromise(promise) {
   try {
     return success(await promise);
   } catch (e) {
+    return error({ name: "SafeError", message: "Promise rejected.", data: e });
+  }
+}
+var defaultStartingDelay = 15e3;
+var defaultNumOfAttempts = 5;
+async function safeBackOff(promise, options) {
+  const [backoffError, data] = await safePromise(
+    backOff(
+      async () => {
+        const [error2, data2] = await promise;
+        if (error2) {
+          throw error2;
+        }
+        return data2;
+      },
+      {
+        startingDelay: options?.startingDelay ?? defaultStartingDelay,
+        numOfAttempts: options?.numOfAttempts ?? defaultNumOfAttempts
+      }
+    )
+  );
+  if (backoffError) {
     return error({
-      name: "SafePromiseError",
-      message: "Safe promise rejected.",
-      data: e
+      name: "BackoffError",
+      message: "Retries exceeded.",
+      data: backoffError.data
     });
   }
+  return success(data);
 }
 function safeCall(fn) {
   try {
@@ -27,6 +51,29 @@ function safeCall(fn) {
     });
   }
 }
+function flatResults(results) {
+  const errors = results.map((r) => r[0]).filter((maybeError) => maybeError !== null);
+  if (errors.length !== 0)
+    return error({
+      name: "FlatResultsError",
+      message: `Found ${errors.length} errors in result array of length ${results.length}.`,
+      data: errors.slice(0, 10)
+      // Only show first 10 errors to avoid spamming logs
+    });
+  const values = results.map((r) => r[1]);
+  return [null, values];
+}
+async function safeExtractResponseBody(response) {
+  try {
+    return await response.json();
+  } catch {
+    try {
+      return await response.text();
+    } catch {
+      return void 0;
+    }
+  }
+}
 
 // src/stacks-api/accounts/balances.ts
 async function balances(opts) {
@@ -48,7 +95,7 @@ async function balances(opts) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -89,7 +136,7 @@ async function latestNonce(opts) {
         endpoint,
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -128,28 +175,6 @@ var baseListResponseSchema = v2.object({
 });
 
 // src/stacks-api/blocks/get-block.ts
-import * as v3 from "valibot";
-var responseSchema2 = v3.object({
-  canonical: v3.boolean(),
-  height: v3.number(),
-  hash: v3.string(),
-  block_time: v3.number(),
-  block_time_iso: v3.string(),
-  index_block_hash: v3.string(),
-  parent_block_hash: v3.string(),
-  parent_index_block_hash: v3.string(),
-  burn_block_time: v3.number(),
-  burn_block_time_iso: v3.string(),
-  burn_block_hash: v3.string(),
-  burn_block_height: v3.number(),
-  miner_txid: v3.string(),
-  tx_count: v3.number(),
-  execution_cost_read_count: v3.number(),
-  execution_cost_read_length: v3.number(),
-  execution_cost_runtime: v3.number(),
-  execution_cost_write_count: v3.number(),
-  execution_cost_write_length: v3.number()
-});
 async function getBlock(opts) {
   const init = {};
   if (opts.apiKeyConfig) {
@@ -157,10 +182,8 @@ async function getBlock(opts) {
       [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
     };
   }
-  const res = await fetch(
-    `${opts.baseUrl}/extended/v2/blocks/${opts.heightOrHash}`,
-    init
-  );
+  const endpoint = `${opts.baseUrl}/extended/v2/blocks/${opts.heightOrHash}`;
+  const res = await fetch(endpoint, init);
   if (!res.ok) {
     return error({
       name: "FetchBlockError",
@@ -168,7 +191,7 @@ async function getBlock(opts) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -180,15 +203,7 @@ async function getBlock(opts) {
       data: jsonError
     });
   }
-  const validationResult = v3.safeParse(responseSchema2, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      data: validationResult
-    });
-  }
-  return success(validationResult.output);
+  return success(data);
 }
 
 // src/stacks-api/blocks/index.ts
@@ -196,6 +211,44 @@ var blocks = {
   getBlock
 };
 
+// src/stacks-api/burn-blocks/get-burn-block.ts
+async function getBurnBlock(args) {
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${args.baseUrl}/extended/v2/burn-blocks/${args.heightOrHash}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "BurnBlockGetError",
+      message: "Failed to get burn block.",
+      data: {
+        heightOrHash: args.heightOrHash,
+        status: res.status,
+        statusText: res.statusText,
+        body: await safeExtractResponseBody(res)
+      }
+    });
+  }
+  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/burn-blocks/index.ts
+var burnBlocks = {
+  getBurnBlock
+};
+
 // src/stacks-api/faucets/stx.ts
 async function stx(opts) {
   const search = new URLSearchParams();
@@ -217,7 +270,7 @@ async function stx(opts) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -238,22 +291,22 @@ var faucets = {
 };
 
 // src/stacks-api/info/core-api.ts
-import * as v4 from "valibot";
-var CoreApiResponseSchema = v4.object({
-  peer_version: v4.number(),
-  pox_consensus: v4.string(),
-  burn_block_height: v4.number(),
-  stable_pox_consensus: v4.string(),
-  stable_burn_block_height: v4.number(),
-  server_version: v4.string(),
-  network_id: v4.number(),
-  parent_network_id: v4.number(),
-  stacks_tip_height: v4.number(),
-  stacks_tip: v4.string(),
-  stacks_tip_consensus_hash: v4.string(),
-  unanchored_tip: v4.nullable(v4.string()),
-  unanchored_seq: v4.nullable(v4.string()),
-  exit_at_block_height: v4.nullable(v4.number())
+import * as v3 from "valibot";
+var CoreApiResponseSchema = v3.object({
+  peer_version: v3.number(),
+  pox_consensus: v3.string(),
+  burn_block_height: v3.number(),
+  stable_pox_consensus: v3.string(),
+  stable_burn_block_height: v3.number(),
+  server_version: v3.string(),
+  network_id: v3.number(),
+  parent_network_id: v3.number(),
+  stacks_tip_height: v3.number(),
+  stacks_tip: v3.string(),
+  stacks_tip_consensus_hash: v3.string(),
+  unanchored_tip: v3.nullable(v3.string()),
+  unanchored_seq: v3.nullable(v3.string()),
+  exit_at_block_height: v3.nullable(v3.number())
 });
 async function coreApi(apiOpts) {
   const init = {};
@@ -270,7 +323,7 @@ async function coreApi(apiOpts) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -282,7 +335,7 @@ async function coreApi(apiOpts) {
       data: parseBodyError
     });
   }
-  const validationResult = v4.safeParse(CoreApiResponseSchema, data);
+  const validationResult = v3.safeParse(CoreApiResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -299,14 +352,14 @@ var info = {
 };
 
 // src/stacks-api/proof-of-transfer/cycle.ts
-import * as v5 from "valibot";
-var responseSchema3 = v5.object({
-  block_height: v5.number(),
-  index_block_hash: v5.string(),
-  cycle_number: v5.number(),
-  total_weight: v5.number(),
-  total_stacked_amount: v5.string(),
-  total_signers: v5.number()
+import * as v4 from "valibot";
+var responseSchema2 = v4.object({
+  block_height: v4.number(),
+  index_block_hash: v4.string(),
+  cycle_number: v4.number(),
+  total_weight: v4.number(),
+  total_stacked_amount: v4.string(),
+  total_signers: v4.number()
 });
 async function cycle(opts) {
   const init = {};
@@ -325,7 +378,7 @@ async function cycle(opts) {
         endpoint,
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -337,7 +390,7 @@ async function cycle(opts) {
       data: jsonError
     });
   }
-  const validationResult = v5.safeParse(responseSchema3, data);
+  const validationResult = v4.safeParse(responseSchema2, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -349,17 +402,17 @@ async function cycle(opts) {
 }
 
 // src/stacks-api/proof-of-transfer/cycles.ts
-import * as v6 from "valibot";
-var cycleInfoSchema = v6.object({
-  block_height: v6.number(),
-  index_block_hash: v6.string(),
-  cycle_number: v6.number(),
-  total_weight: v6.number(),
-  total_stacked_amount: v6.string(),
-  total_signers: v6.number()
+import * as v5 from "valibot";
+var cycleInfoSchema = v5.object({
+  block_height: v5.number(),
+  index_block_hash: v5.string(),
+  cycle_number: v5.number(),
+  total_weight: v5.number(),
+  total_stacked_amount: v5.string(),
+  total_signers: v5.number()
 });
-var resultsSchema = v6.array(cycleInfoSchema);
-var cyclesResponseSchema = v6.object({
+var resultsSchema = v5.array(cycleInfoSchema);
+var cyclesResponseSchema = v5.object({
   ...baseListResponseSchema.entries,
   results: resultsSchema
 });
@@ -383,7 +436,7 @@ async function cycles(args) {
         endpoint,
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -395,7 +448,7 @@ async function cycles(args) {
       data: jsonError
     });
   }
-  const validationResult = v6.safeParse(cyclesResponseSchema, data);
+  const validationResult = v5.safeParse(cyclesResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -407,16 +460,16 @@ async function cycles(args) {
 }
 
 // src/stacks-api/proof-of-transfer/signer-in-cycle.ts
-import * as v7 from "valibot";
-var signerInCycleResponseSchema = v7.object({
-  signing_key: v7.string(),
-  signer_address: v7.string(),
-  weight: v7.number(),
-  stacked_amount: v7.string(),
-  weight_percent: v7.number(),
-  stacked_amount_percent: v7.number(),
-  solo_stacker_count: v7.number(),
-  pooled_stacker_count: v7.number()
+import * as v6 from "valibot";
+var signerInCycleResponseSchema = v6.object({
+  signing_key: v6.string(),
+  signer_address: v6.string(),
+  weight: v6.number(),
+  stacked_amount: v6.string(),
+  weight_percent: v6.number(),
+  stacked_amount_percent: v6.number(),
+  solo_stacker_count: v6.number(),
+  pooled_stacker_count: v6.number()
 });
 async function signerInCycle(args) {
   const init = {};
@@ -452,7 +505,7 @@ async function signerInCycle(args) {
       }
     });
   }
-  const validationResult = v7.safeParse(signerInCycleResponseSchema, data);
+  const validationResult = v6.safeParse(signerInCycleResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -464,19 +517,19 @@ async function signerInCycle(args) {
 }
 
 // src/stacks-api/proof-of-transfer/signers-in-cycle.ts
-import * as v8 from "valibot";
-var signerSchema = v8.object({
-  signing_key: v8.string(),
-  signer_address: v8.string(),
-  weight: v8.number(),
-  stacked_amount: v8.string(),
-  weight_percent: v8.number(),
-  stacked_amount_percent: v8.number(),
-  pooled_stacker_count: v8.number(),
-  solo_stacker_count: v8.number()
+import * as v7 from "valibot";
+var signerSchema = v7.object({
+  signing_key: v7.string(),
+  signer_address: v7.string(),
+  weight: v7.number(),
+  stacked_amount: v7.string(),
+  weight_percent: v7.number(),
+  stacked_amount_percent: v7.number(),
+  pooled_stacker_count: v7.number(),
+  solo_stacker_count: v7.number()
 });
-var resultsSchema2 = v8.array(signerSchema);
-var signersResponseSchema = v8.object({
+var resultsSchema2 = v7.array(signerSchema);
+var signersResponseSchema = v7.object({
   ...baseListResponseSchema.entries,
   results: resultsSchema2
 });
@@ -500,7 +553,7 @@ async function signersInCycle(args) {
         endpoint,
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -511,11 +564,11 @@ async function signersInCycle(args) {
       message: "Failed to parse response body as JSON.",
       data: {
         endpoint,
-        bodyParseResult: data
+        body: data
       }
     });
   }
-  const validationResult = v8.safeParse(signersResponseSchema, data);
+  const validationResult = v7.safeParse(signersResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -527,18 +580,6 @@ async function signersInCycle(args) {
 }
 
 // src/stacks-api/proof-of-transfer/stackers-for-signer-in-cycle.ts
-import * as v9 from "valibot";
-var stackerInfoSchema = v9.object({
-  stacker_address: v9.string(),
-  stacked_amount: v9.string(),
-  pox_address: v9.string(),
-  stacker_type: v9.union([v9.literal("pooled"), v9.literal("solo")])
-});
-var resultsSchema3 = v9.array(stackerInfoSchema);
-var stackersForSignerInCycleResponseSchema = v9.object({
-  ...baseListResponseSchema.entries,
-  results: resultsSchema3
-});
 async function stackersForSignerInCycle(opts) {
   const search = new URLSearchParams();
   if (opts.limit) search.append("limit", opts.limit.toString());
@@ -560,7 +601,7 @@ async function stackersForSignerInCycle(opts) {
         endpoint,
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -572,18 +613,7 @@ async function stackersForSignerInCycle(opts) {
       data: jsonError
     });
   }
-  const validationResult = v9.safeParse(
-    stackersForSignerInCycleResponseSchema,
-    data
-  );
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate response data.",
-      data: validationResult
-    });
-  }
-  return success(validationResult.output);
+  return success(data);
 }
 
 // src/stacks-api/proof-of-transfer/index.ts
@@ -596,21 +626,6 @@ var proofOfTransfer = {
 };
 
 // src/stacks-api/stacking-pool/members.ts
-import * as v10 from "valibot";
-var memberSchema = v10.object({
-  stacker: v10.string(),
-  pox_addr: v10.optional(v10.string()),
-  amount_ustx: v10.string(),
-  burn_block_unlock_height: v10.optional(v10.number()),
-  block_height: v10.number(),
-  tx_id: v10.string()
-});
-var membersResponseSchema = v10.object({
-  limit: v10.number(),
-  offset: v10.number(),
-  total: v10.number(),
-  results: v10.array(memberSchema)
-});
 async function members(args) {
   const search = new URLSearchParams();
   if (args.afterBlock) search.append("after_block", args.afterBlock.toString());
@@ -632,7 +647,7 @@ async function members(args) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -644,15 +659,7 @@ async function members(args) {
       data: jsonParseError
     });
   }
-  const validationResult = v10.safeParse(membersResponseSchema, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      data: validationResult
-    });
-  }
-  return success(validationResult.output);
+  return success(data);
 }
 
 // src/stacks-api/stacking-pool/index.ts
@@ -660,124 +667,7 @@ var stackingPool = {
   members
 };
 
-// src/stacks-api/transactions/schemas.ts
-import * as v11 from "valibot";
-var baseTransactionSchema = v11.object({
-  tx_id: v11.string(),
-  nonce: v11.number(),
-  fee_rate: v11.string(),
-  sender_address: v11.string(),
-  sponsored: v11.boolean(),
-  post_condition_mode: v11.string(),
-  post_conditions: v11.array(v11.unknown()),
-  anchor_mode: v11.string(),
-  is_unanchored: v11.boolean(),
-  block_hash: v11.string(),
-  parent_block_hash: v11.string(),
-  block_height: v11.number(),
-  block_time: v11.number(),
-  block_time_iso: v11.string(),
-  burn_block_height: v11.number(),
-  burn_block_time: v11.number(),
-  burn_block_time_iso: v11.string(),
-  parent_burn_block_time: v11.number(),
-  parent_burn_block_time_iso: v11.string(),
-  canonical: v11.boolean(),
-  tx_index: v11.number(),
-  tx_status: v11.union([
-    v11.literal("success"),
-    v11.literal("abort_by_response"),
-    v11.literal("abort_by_post_condition")
-  ]),
-  tx_result: v11.object({
-    hex: v11.string(),
-    repr: v11.string()
-  }),
-  microblock_hash: v11.string(),
-  microblock_sequence: v11.number(),
-  microblock_canonical: v11.boolean(),
-  event_count: v11.number(),
-  events: v11.array(v11.unknown()),
-  execution_cost_read_count: v11.number(),
-  execution_cost_read_length: v11.number(),
-  execution_cost_runtime: v11.number(),
-  execution_cost_write_count: v11.number(),
-  execution_cost_write_length: v11.number()
-});
-var contractCallTransactionSchema = v11.object({
-  tx_type: v11.literal("contract_call"),
-  contract_call: v11.object({
-    contract_id: v11.string(),
-    function_name: v11.string(),
-    function_signature: v11.string(),
-    function_args: v11.array(
-      v11.object({
-        hex: v11.string(),
-        repr: v11.string(),
-        name: v11.string(),
-        type: v11.string()
-      })
-    )
-  }),
-  ...baseTransactionSchema.entries
-});
-var smartContractTransactionSchema = v11.object({
-  tx_type: v11.literal("smart_contract"),
-  smart_contract: v11.object({
-    /**
-     * NOTE: The types may be wrong, not sure what type of value is used when
-     * the version is not `null`.
-     */
-    clarity_version: v11.union([v11.null(), v11.number()]),
-    contract_id: v11.string(),
-    source_code: v11.string()
-  }),
-  ...baseTransactionSchema.entries
-});
-var tokenTransferSchema = v11.object({
-  tx_type: v11.literal("token_transfer"),
-  token_transfer: v11.object({
-    recipient_address: v11.string(),
-    amount: v11.string(),
-    memo: v11.string()
-  }),
-  ...baseTransactionSchema.entries
-});
-var transactionSchema = v11.variant("tx_type", [
-  contractCallTransactionSchema,
-  smartContractTransactionSchema,
-  tokenTransferSchema
-]);
-
 // src/stacks-api/transactions/address-transactions.ts
-import * as v12 from "valibot";
-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());
@@ -799,7 +689,7 @@ async function addressTransactions(args) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -811,19 +701,47 @@ async function addressTransactions(args) {
       data: jsonParseError
     });
   }
-  const validationResult = v12.safeParse(addressTransactionsResponseSchema, data);
-  if (!validationResult.success) {
+  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: "ValidateDataError",
-      message: "Failed to validate data.",
-      data: validationResult
+      name: "FetchEventsForAnAddressTransactionError",
+      message: `Failed to fetch address transaction events.`,
+      data: {
+        address: args.address,
+        transactionId: args.transactionId,
+        status: res.status,
+        statusText: res.statusText,
+        body: await safeExtractResponseBody(res)
+      }
     });
   }
-  return success(validationResult.output);
+  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/get-transaction.ts
-import * as v13 from "valibot";
 async function getTransaction(args) {
   const init = {};
   if (args.apiKeyConfig) {
@@ -836,11 +754,12 @@ 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())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -852,15 +771,7 @@ async function getTransaction(args) {
       error: jsonParseError
     });
   }
-  const validationResult = v13.safeParse(transactionSchema, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      error: validationResult
-    });
-  }
-  return success(validationResult.output);
+  return success(data);
 }
 
 // src/stacks-api/transactions/mempool-transactions.ts
@@ -891,7 +802,7 @@ async function mempoolTransactions(args) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -906,11 +817,46 @@ async function mempoolTransactions(args) {
   return success(data);
 }
 
+// src/stacks-api/transactions/get-raw-transaction.ts
+async function getRawTransaction(args) {
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${args.baseUrl}/extended/v1/tx/${args.transactionId}/raw`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "RawTransactionFetchError",
+      message: `Failed to fetch raw transaction.`,
+      data: {
+        transactionId: args.transactionId,
+        status: res.status,
+        statusText: res.statusText,
+        body: await safeExtractResponseBody(res)
+      }
+    });
+  }
+  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/index.ts
 var transactions = {
   addressTransactions,
+  eventsForAnAddressTransaction,
   getTransaction,
-  mempoolTransactions
+  mempoolTransactions,
+  getRawTransaction
 };
 
 // src/stacks-api/mempool/transaction-fee-priorities.ts
@@ -930,7 +876,7 @@ async function transactionFeePriorities(opts) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyParseResult: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -954,6 +900,7 @@ var mempool = {
 var stacksApi = {
   accounts,
   blocks,
+  burnBlocks,
   faucets,
   info,
   mempool,
@@ -963,16 +910,16 @@ var stacksApi = {
 };
 
 // src/stacks-rpc-api/smart-contracts/map-entry.ts
-import * as v14 from "valibot";
-var mapEntryResponseSchema = v14.object({
+import * as v8 from "valibot";
+var mapEntryResponseSchema = v8.object({
   /**
    * Hex-encoded string of clarity value. It is always an optional tuple.
    */
-  data: v14.string(),
+  data: v8.string(),
   /**
    * Hex-encoded string of the MARF proof for the data
    */
-  proof: v14.optional(v14.string())
+  proof: v8.optional(v8.string())
 });
 async function mapEntry(args) {
   const search = new URLSearchParams();
@@ -1000,7 +947,7 @@ async function mapEntry(args) {
         status: res.status,
         statusText: res.statusText,
         endpoint,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -1012,7 +959,7 @@ async function mapEntry(args) {
       data: jsonError
     });
   }
-  const validationResult = v14.safeParse(mapEntryResponseSchema, data);
+  const validationResult = v8.safeParse(mapEntryResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -1048,7 +995,7 @@ async function readOnly(args) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -1085,7 +1032,7 @@ async function contractInterface(args) {
         status: res.status,
         statusText: res.statusText,
         endpoint,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -1123,7 +1070,7 @@ async function poxDetails(args) {
       data: {
         status: res.status,
         statusText: res.statusText,
-        bodyText: await safePromise(res.text())
+        body: await safeExtractResponseBody(res)
       }
     });
   }
@@ -1150,18 +1097,18 @@ var stacksRpcApi = {
 };
 
 // src/utils/call-rate-limited-api.ts
-import { backOff } from "exponential-backoff";
-var defaultStartingDelay = 15e3;
-var defaultNumOfAttempts = 5;
+import { backOff as backOff2 } from "exponential-backoff";
+var defaultStartingDelay2 = 15e3;
+var defaultNumOfAttempts2 = 5;
 function callRateLimitedApi(fn, options) {
-  return backOff(fn, {
-    startingDelay: options?.startingDelay ?? defaultStartingDelay,
-    numOfAttempts: options?.numOfAttempts ?? defaultNumOfAttempts
+  return backOff2(fn, {
+    startingDelay: options?.startingDelay ?? defaultStartingDelay2,
+    numOfAttempts: options?.numOfAttempts ?? defaultNumOfAttempts2
   });
 }
 async function safeCallRateLimitedApi(fn, options) {
   try {
-    return await backOff(
+    return await backOff2(
       async () => {
         const [error2, data] = await fn();
         if (error2) {
@@ -1387,10 +1334,13 @@ var pox4Api = { maps, readOnly: readOnly2 };
 export {
   callRateLimitedApi,
   error,
+  flatResults,
   pox4Api,
   queries,
+  safeBackOff,
   safeCall,
   safeCallRateLimitedApi,
+  safeExtractResponseBody,
   safePromise,
   stacksApi,
   stacksRpcApi,