@secretkeylabs/stacks-tools 0.3.0-9b21b7a → 0.4.0-0fe567d

package/dist/index.cjs

@@ -0,0 +1,1106 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  callRateLimitedApi: () => callRateLimitedApi,
+  error: () => error,
+  safeCall: () => safeCall,
+  safeCallRateLimitedApi: () => safeCallRateLimitedApi,
+  safePromise: () => safePromise,
+  stacksApi: () => stacksApi,
+  success: () => success
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/utils/safe.ts
+function success(data) {
+  return [null, data];
+}
+function error(error2) {
+  return [error2, null];
+}
+async function safePromise(promise) {
+  try {
+    return success(await promise);
+  } catch (e) {
+    return error({
+      name: "SafePromiseError",
+      message: "Safe promise rejected.",
+      data: e
+    });
+  }
+}
+function safeCall(fn) {
+  try {
+    return success(fn());
+  } catch (e) {
+    return error({
+      name: "SafeCallError",
+      message: "Safe call failed.",
+      data: e
+    });
+  }
+}
+
+// src/stacks-api/accounts/balances.ts
+var v = __toESM(require("valibot"), 1);
+var responseSchema = v.object({
+  stx: v.object({
+    balance: v.string(),
+    total_sent: v.string(),
+    total_received: v.string(),
+    total_fees_sent: v.string(),
+    total_miner_rewards_received: v.string(),
+    lock_tx_id: v.string(),
+    locked: v.string(),
+    lock_height: v.number(),
+    burnchain_lock_height: v.number(),
+    burnchain_unlock_height: v.number()
+  }),
+  fungible_tokens: v.record(
+    v.string(),
+    v.object({
+      balance: v.string(),
+      total_sent: v.string(),
+      total_received: v.string()
+    })
+  ),
+  non_fungible_tokens: v.record(
+    v.string(),
+    v.object({
+      count: v.string(),
+      total_sent: v.string(),
+      total_received: v.string()
+    })
+  )
+});
+async function balances(opts) {
+  const search = new URLSearchParams();
+  if (opts.unanchored) search.append("unanchored", "true");
+  if (opts.untilBlock) search.append("until_block", opts.untilBlock.toString());
+  const init = {};
+  if (opts.apiKeyConfig) {
+    init.headers = {
+      [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${opts.baseUrl}/extended/v1/address/${opts.principal}/balances?${search}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchBalancesError",
+      message: "Failed to fetch balances.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: jsonError
+    });
+  }
+  const validationResult = v.safeParse(responseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/accounts/latest-nonce.ts
+var v2 = __toESM(require("valibot"), 1);
+var responseSchema2 = v2.object({
+  last_mempool_tx_nonce: v2.nullable(v2.number()),
+  last_executed_tx_nonce: v2.nullable(v2.number()),
+  possible_next_nonce: v2.number(),
+  detected_missing_nonces: v2.array(v2.number()),
+  detected_mempool_nonces: v2.array(v2.number())
+});
+async function latestNonce(opts) {
+  const init = {};
+  if (opts.apiKeyConfig) {
+    init.headers = {
+      [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${opts.baseUrl}/extended/v1/address/${opts.principal}/nonces`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchLatestNonceError",
+      message: "Failed to fetch latest nonce.",
+      data: {
+        endpoint,
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: jsonError
+    });
+  }
+  const validationResult = v2.safeParse(responseSchema2, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/types.ts
+var v3 = __toESM(require("valibot"), 1);
+var baseListResponseSchema = v3.object({
+  limit: v3.number(),
+  offset: v3.number(),
+  total: v3.number(),
+  results: v3.array(v3.unknown())
+});
+
+// src/stacks-api/blocks/get-block.ts
+var v4 = __toESM(require("valibot"), 1);
+var responseSchema3 = v4.object({
+  canonical: v4.boolean(),
+  height: v4.number(),
+  hash: v4.string(),
+  block_time: v4.number(),
+  block_time_iso: v4.string(),
+  index_block_hash: v4.string(),
+  parent_block_hash: v4.string(),
+  parent_index_block_hash: v4.string(),
+  burn_block_time: v4.number(),
+  burn_block_time_iso: v4.string(),
+  burn_block_hash: v4.string(),
+  burn_block_height: v4.number(),
+  miner_txid: v4.string(),
+  tx_count: v4.number(),
+  execution_cost_read_count: v4.number(),
+  execution_cost_read_length: v4.number(),
+  execution_cost_runtime: v4.number(),
+  execution_cost_write_count: v4.number(),
+  execution_cost_write_length: v4.number()
+});
+async function getBlock(opts) {
+  const init = {};
+  if (opts.apiKeyConfig) {
+    init.headers = {
+      [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
+    };
+  }
+  const res = await fetch(
+    `${opts.baseUrl}/extended/v2/blocks/${opts.heightOrHash}`,
+    init
+  );
+  if (!res.ok) {
+    return error({
+      name: "FetchBlockError",
+      message: "Failed to fetch block.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse body.",
+      data: jsonError
+    });
+  }
+  const validationResult = v4.safeParse(responseSchema3, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/info/core-api.ts
+var v5 = __toESM(require("valibot"), 1);
+var CoreApiResponseSchema = v5.object({
+  peer_version: v5.number(),
+  pox_consensus: v5.string(),
+  burn_block_height: v5.number(),
+  stable_pox_consensus: v5.string(),
+  stable_burn_block_height: v5.number(),
+  server_version: v5.string(),
+  network_id: v5.number(),
+  parent_network_id: v5.number(),
+  stacks_tip_height: v5.number(),
+  stacks_tip: v5.string(),
+  stacks_tip_consensus_hash: v5.string(),
+  unanchored_tip: v5.nullable(v5.string()),
+  unanchored_seq: v5.nullable(v5.string()),
+  exit_at_block_height: v5.nullable(v5.number())
+});
+async function coreApi(apiOpts) {
+  const init = {};
+  if (apiOpts.apiKeyConfig) {
+    init.headers = {
+      [apiOpts.apiKeyConfig.header]: apiOpts.apiKeyConfig.key
+    };
+  }
+  const res = await fetch(`${apiOpts.baseUrl}/v2/info`, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchCoreApiError",
+      message: "Failed to fetch.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [parseBodyError, data] = await safePromise(res.json());
+  if (parseBodyError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: parseBodyError
+    });
+  }
+  const validationResult = v5.safeParse(CoreApiResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/info/pox-details.ts
+var v6 = __toESM(require("valibot"), 1);
+var poxDetailsResponseSchema = v6.object({
+  contract_id: v6.string(),
+  pox_activation_threshold_ustx: v6.number(),
+  first_burnchain_block_height: v6.number(),
+  current_burnchain_block_height: v6.number(),
+  prepare_phase_block_length: v6.number(),
+  reward_phase_block_length: v6.number(),
+  reward_slots: v6.number(),
+  rejection_fraction: v6.null(),
+  total_liquid_supply_ustx: v6.number(),
+  current_cycle: v6.object({
+    id: v6.number(),
+    min_threshold_ustx: v6.number(),
+    stacked_ustx: v6.number(),
+    is_pox_active: v6.boolean()
+  }),
+  next_cycle: v6.object({
+    id: v6.number(),
+    min_threshold_ustx: v6.number(),
+    min_increment_ustx: v6.number(),
+    stacked_ustx: v6.number(),
+    prepare_phase_start_block_height: v6.number(),
+    blocks_until_prepare_phase: v6.number(),
+    reward_phase_start_block_height: v6.number(),
+    blocks_until_reward_phase: v6.number(),
+    ustx_until_pox_rejection: v6.null()
+  }),
+  epochs: v6.array(
+    v6.object({
+      epoch_id: v6.string(),
+      start_height: v6.number(),
+      end_height: v6.number(),
+      block_limit: v6.object({
+        write_length: v6.number(),
+        write_count: v6.number(),
+        read_length: v6.number(),
+        read_count: v6.number(),
+        runtime: v6.number()
+      }),
+      network_epoch: v6.number()
+    })
+  ),
+  min_amount_ustx: v6.number(),
+  prepare_cycle_length: v6.number(),
+  reward_cycle_id: v6.number(),
+  reward_cycle_length: v6.number(),
+  rejection_votes_left_required: v6.null(),
+  next_reward_cycle_in: v6.number(),
+  contract_versions: v6.array(
+    v6.object({
+      contract_id: v6.string(),
+      activation_burnchain_block_height: v6.number(),
+      first_reward_cycle_id: v6.number()
+    })
+  )
+});
+async function poxDetails(args) {
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const res = await fetch(`${args.baseUrl}/v2/pox`, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchPoxDetailsError",
+      message: "Failed to fetch pox details.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonParseError, data] = await safePromise(res.json());
+  if (jsonParseError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse pox details response.",
+      data: jsonParseError
+    });
+  }
+  const validationResult = v6.safeParse(poxDetailsResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to parse pox details response.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/proof-of-transfer/cycle.ts
+var v7 = __toESM(require("valibot"), 1);
+var responseSchema4 = v7.object({
+  block_height: v7.number(),
+  index_block_hash: v7.string(),
+  cycle_number: v7.number(),
+  total_weight: v7.number(),
+  total_stacked_amount: v7.string(),
+  total_signers: v7.number()
+});
+async function cycle(opts) {
+  const init = {};
+  if (opts.apiKeyConfig) {
+    init.headers = {
+      [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${opts.baseUrl}/extended/v2/pox/cycles/${opts.cycleNumber}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchCycleError",
+      message: "Failed to fetch cycle.",
+      data: {
+        endpoint,
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: jsonError
+    });
+  }
+  const validationResult = v7.safeParse(responseSchema4, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/proof-of-transfer/cycles.ts
+var v8 = __toESM(require("valibot"), 1);
+var cycleInfoSchema = v8.object({
+  block_height: v8.number(),
+  index_block_hash: v8.string(),
+  cycle_number: v8.number(),
+  total_weight: v8.number(),
+  total_stacked_amount: v8.string(),
+  total_signers: v8.number()
+});
+var resultsSchema = v8.array(cycleInfoSchema);
+var cyclesResponseSchema = v8.object({
+  ...baseListResponseSchema.entries,
+  results: resultsSchema
+});
+async function cycles(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/pox/cycles`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchCyclesError",
+      message: "Failed to fetch cycles.",
+      data: {
+        endpoint,
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: jsonError
+    });
+  }
+  const validationResult = v8.safeParse(cyclesResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate response data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/proof-of-transfer/signer-in-cycle.ts
+var v9 = __toESM(require("valibot"), 1);
+var signerInCycleResponseSchema = v9.object({
+  signing_key: v9.string(),
+  signer_address: v9.string(),
+  weight: v9.number(),
+  stacked_amount: v9.string(),
+  weight_percent: v9.number(),
+  stacked_amount_percent: v9.number(),
+  solo_stacker_count: v9.number(),
+  pooled_stacker_count: v9.number()
+});
+async function signerInCycle(args) {
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const signerPublicKey = args.signerPublicKey.startsWith("0x") ? args.signerPublicKey : `0x${args.signerPublicKey}`;
+  const endpoint = `${args.baseUrl}/extended/v2/pox/cycles/${args.cycleId}/signers/${signerPublicKey}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchSignerInCycleError",
+      message: "Failed to fetch signer in cycle.",
+      data: {
+        ...args,
+        endpoint,
+        status: res.status,
+        statusText: res.statusText
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body.",
+      data: {
+        signerPublicKey: args.signerPublicKey,
+        cycleId: args.cycleId,
+        jsonError
+      }
+    });
+  }
+  const validationResult = v9.safeParse(signerInCycleResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate response data.",
+      data: validationResult.issues
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/proof-of-transfer/signers-in-cycle.ts
+var v10 = __toESM(require("valibot"), 1);
+var signerSchema = v10.object({
+  signing_key: v10.string(),
+  signer_address: v10.string(),
+  weight: v10.number(),
+  stacked_amount: v10.string(),
+  weight_percent: v10.number(),
+  stacked_amount_percent: v10.number(),
+  pooled_stacker_count: v10.number(),
+  solo_stacker_count: v10.number()
+});
+var resultsSchema2 = v10.array(signerSchema);
+var signersResponseSchema = v10.object({
+  ...baseListResponseSchema.entries,
+  results: resultsSchema2
+});
+async function signersInCycle(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/pox/cycles/${args.cycleNumber}/signers`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchSignersError",
+      message: "Failed to fetch signers.",
+      data: {
+        endpoint,
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: {
+        endpoint,
+        bodyParseResult: data
+      }
+    });
+  }
+  const validationResult = v10.safeParse(signersResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate response data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/proof-of-transfer/stackers-for-signer-in-cycle.ts
+var v11 = __toESM(require("valibot"), 1);
+var stackerInfoSchema = v11.object({
+  stacker_address: v11.string(),
+  stacked_amount: v11.string(),
+  pox_address: v11.string(),
+  stacker_type: v11.union([v11.literal("pooled"), v11.literal("solo")])
+});
+var resultsSchema3 = v11.array(stackerInfoSchema);
+var stackersForSignerInCycleResponseSchema = v11.object({
+  ...baseListResponseSchema.entries,
+  results: resultsSchema3
+});
+async function stackersForSignerInCycle(opts) {
+  const search = new URLSearchParams();
+  if (opts.limit) search.append("limit", opts.limit.toString());
+  if (opts.offset) search.append("offset", opts.offset.toString());
+  const init = {};
+  if (opts.apiKeyConfig) {
+    init.headers = {
+      [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
+    };
+  }
+  const signerPublicKeyPathParam = opts.signerPublicKey.startsWith("0x") ? opts.signerPublicKey : `0x${opts.signerPublicKey}`;
+  const endpoint = `${opts.baseUrl}/extended/v2/pox/cycles/${opts.cycleNumber}/signers/${signerPublicKeyPathParam}/stackers?${search}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchStackersForSignerInCycleError",
+      message: "Failed to fetch stackers for signer in cycle.",
+      data: {
+        endpoint,
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: jsonError
+    });
+  }
+  const validationResult = v11.safeParse(
+    stackersForSignerInCycleResponseSchema,
+    data
+  );
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate response data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/smart-contracts/read-only.ts
+var v12 = __toESM(require("valibot"), 1);
+var readOnlyResponseSchema = v12.variant("okay", [
+  v12.object({
+    okay: v12.literal(true),
+    /**
+     * A Clarity value as a hex-encoded string.
+     */
+    result: v12.string()
+  }),
+  v12.object({
+    okay: v12.literal(false),
+    cause: v12.unknown()
+  })
+]);
+async function readOnly(args) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (args.apiKeyConfig) {
+    headers[args.apiKeyConfig.header] = args.apiKeyConfig.key;
+  }
+  const init = {
+    method: "POST",
+    body: JSON.stringify({
+      sender: args.sender,
+      arguments: args.arguments
+    }),
+    headers
+  };
+  const endpoint = `${args.baseUrl}/v2/contracts/call-read/${args.contractAddress}/${args.contractName}/${args.functionName}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchReadOnlyError",
+      message: "Failed to fetch.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonError, data] = await safePromise(res.json());
+  if (jsonError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      data: error
+    });
+  }
+  const validationResult = v12.safeParse(readOnlyResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/stacking-pool/members.ts
+var v13 = __toESM(require("valibot"), 1);
+var memberSchema = v13.object({
+  stacker: v13.string(),
+  pox_addr: v13.optional(v13.string()),
+  amount_ustx: v13.string(),
+  burn_block_unlock_height: v13.optional(v13.number()),
+  block_height: v13.number(),
+  tx_id: v13.string()
+});
+var membersResponseSchema = v13.object({
+  limit: v13.number(),
+  offset: v13.number(),
+  total: v13.number(),
+  results: v13.array(memberSchema)
+});
+async function members(opts, apiOpts) {
+  const search = new URLSearchParams();
+  if (opts.afterBlock) search.append("after_block", opts.afterBlock.toString());
+  if (opts.unanchored) search.append("unanchored", "true");
+  if (opts.limit) search.append("limit", opts.limit.toString());
+  if (opts.offset) search.append("offset", opts.offset.toString());
+  const init = {};
+  if (apiOpts.apiKeyConfig) {
+    init.headers = {
+      [apiOpts.apiKeyConfig.header]: apiOpts.apiKeyConfig.key
+    };
+  }
+  const res = await fetch(
+    `${apiOpts.baseUrl}/extended/beta/stacking/${opts.poolPrincipal}/delegations?${search}`,
+    init
+  );
+  if (!res.ok) {
+    return error({
+      name: "FetchMembersError",
+      message: "Failed to fetch members.",
+      data: {
+        status: res.status,
+        statusText: res.statusText,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  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 = v13.safeParse(membersResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/transactions/schemas.ts
+var v14 = __toESM(require("valibot"), 1);
+var baseTransactionSchema = v14.object({
+  tx_id: v14.string(),
+  nonce: v14.number(),
+  fee_rate: v14.string(),
+  sender_address: v14.string(),
+  sponsored: v14.boolean(),
+  post_condition_mode: v14.string(),
+  post_conditions: v14.array(v14.unknown()),
+  anchor_mode: v14.string(),
+  is_unanchored: v14.boolean(),
+  block_hash: v14.string(),
+  parent_block_hash: v14.string(),
+  block_height: v14.number(),
+  block_time: v14.number(),
+  block_time_iso: v14.string(),
+  burn_block_height: v14.number(),
+  burn_block_time: v14.number(),
+  burn_block_time_iso: v14.string(),
+  parent_burn_block_time: v14.number(),
+  parent_burn_block_time_iso: v14.string(),
+  canonical: v14.boolean(),
+  tx_index: v14.number(),
+  tx_status: v14.union([
+    v14.literal("success"),
+    v14.literal("abort_by_response"),
+    v14.literal("abort_by_post_condition")
+  ]),
+  tx_result: v14.object({
+    hex: v14.string(),
+    repr: v14.string()
+  }),
+  microblock_hash: v14.string(),
+  microblock_sequence: v14.number(),
+  microblock_canonical: v14.boolean(),
+  event_count: v14.number(),
+  events: v14.array(v14.unknown()),
+  execution_cost_read_count: v14.number(),
+  execution_cost_read_length: v14.number(),
+  execution_cost_runtime: v14.number(),
+  execution_cost_write_count: v14.number(),
+  execution_cost_write_length: v14.number()
+});
+var contractCallTransactionSchema = v14.object({
+  tx_type: v14.literal("contract_call"),
+  contract_call: v14.object({
+    contract_id: v14.string(),
+    function_name: v14.string(),
+    function_signature: v14.string(),
+    function_args: v14.array(
+      v14.object({
+        hex: v14.string(),
+        repr: v14.string(),
+        name: v14.string(),
+        type: v14.string()
+      })
+    )
+  }),
+  ...baseTransactionSchema.entries
+});
+var smartContractTransactionSchema = v14.object({
+  tx_type: v14.literal("smart_contract"),
+  smart_contract: v14.object({
+    /**
+     * NOTE: The types may be wrong, not sure what type of value is used when
+     * the version is not `null`.
+     */
+    clarity_version: v14.union([v14.null(), v14.number()]),
+    contract_id: v14.string(),
+    source_code: v14.string()
+  }),
+  ...baseTransactionSchema.entries
+});
+var tokenTransferSchema = v14.object({
+  tx_type: v14.literal("token_transfer"),
+  token_transfer: v14.object({
+    recipient_address: v14.string(),
+    amount: v14.string(),
+    memo: v14.string()
+  }),
+  ...baseTransactionSchema.entries
+});
+var transactionSchema = v14.variant("tx_type", [
+  contractCallTransactionSchema,
+  smartContractTransactionSchema,
+  tokenTransferSchema
+]);
+
+// src/stacks-api/transactions/address-transactions.ts
+var v15 = __toESM(require("valibot"), 1);
+var resultSchema = v15.object({
+  tx: transactionSchema,
+  stx_sent: v15.string(),
+  stx_received: v15.string(),
+  events: v15.object({
+    stx: v15.object({
+      transfer: v15.number(),
+      mint: v15.number(),
+      burn: v15.number()
+    }),
+    ft: v15.object({
+      transfer: v15.number(),
+      mint: v15.number(),
+      burn: v15.number()
+    }),
+    nft: v15.object({
+      transfer: v15.number(),
+      mint: v15.number(),
+      burn: v15.number()
+    })
+  })
+});
+var resultsSchema4 = v15.array(resultSchema);
+var addressTransactionsResponseSchema = v15.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,
+        bodyParseResult: await safePromise(res.json())
+      }
+    });
+  }
+  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 = v15.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 v16 = __toESM(require("valibot"), 1);
+async function getTransaction(args) {
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  const endpoint = `${args.baseUrl}/extended/v1/tx/${args.transactionId}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchTransactionError",
+      message: `Failed to fetch transaction ${args.transactionId}`,
+      response: {
+        status: res.status,
+        statusText: res.statusText,
+        body: await safePromise(res.json())
+      }
+    });
+  }
+  const [jsonParseError, data] = await safePromise(res.json());
+  if (jsonParseError) {
+    return error({
+      name: "ParseBodyError",
+      message: "Failed to parse response body as JSON.",
+      error: jsonParseError
+    });
+  }
+  const validationResult = v16.safeParse(transactionSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate data.",
+      error: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-api/index.ts
+var accounts = { balances, latestNonce };
+var blocks = { getBlock };
+var info = { coreApi, poxDetails };
+var proofOfTransfer = {
+  cycle,
+  cycles,
+  signerInCycle,
+  signersInCycle,
+  stackersForSignerInCycle
+};
+var smartContracts = { readOnly };
+var stackingPool = { members };
+var transactions = { addressTransactions, getTransaction };
+
+// src/utils/call-rate-limited-api.ts
+var import_exponential_backoff = require("exponential-backoff");
+var defaultStartingDelay = 15e3;
+var defaultNumOfAttempts = 5;
+function callRateLimitedApi(fn, options) {
+  return (0, import_exponential_backoff.backOff)(fn, {
+    startingDelay: options?.startingDelay ?? defaultStartingDelay,
+    numOfAttempts: options?.numOfAttempts ?? defaultNumOfAttempts
+  });
+}
+async function safeCallRateLimitedApi(fn, options) {
+  try {
+    return await (0, import_exponential_backoff.backOff)(
+      async () => {
+        const [error2, data] = await fn();
+        if (error2) {
+          throw error2;
+        }
+        return success(data);
+      },
+      {
+        startingDelay: options?.startingDelay ?? 15e3,
+        numOfAttempts: options?.numOfAttempts ?? 5
+      }
+    );
+  } catch (error2) {
+    return error({
+      name: "MaxRetriesExceeded",
+      message: "Failed to call rate limited API.",
+      data: {
+        error: error2
+      }
+    });
+  }
+}
+
+// src/index.ts
+var stacksApi = {
+  accounts,
+  blocks,
+  info,
+  proofOfTransfer,
+  smartContracts,
+  stackingPool,
+  transactions
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  callRateLimitedApi,
+  error,
+  safeCall,
+  safeCallRateLimitedApi,
+  safePromise,
+  stacksApi,
+  success
+});