@secretkeylabs/stacks-tools 0.3.0 → 0.4.0-13a5f23

package/dist/index.cjs

@@ -30,8 +30,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  callRateLimitedApi: () => callRateLimitedApi,
+  error: () => error,
   queries: () => queries,
-  stacksApi: () => stacksApi
+  safeCall: () => safeCall,
+  safeCallRateLimitedApi: () => safeCallRateLimitedApi,
+  safePromise: () => safePromise,
+  stacksApi: () => stacksApi,
+  stacksRpcApi: () => stacksRpcApi,
+  success: () => success
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -53,6 +60,17 @@ async function safePromise(promise) {
     });
   }
 }
+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);
@@ -128,42 +146,92 @@ async function balances(opts) {
   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/accounts/index.ts
 var accounts = {
-  balances
+  balances,
+  latestNonce
 };
 
 // src/stacks-api/types.ts
-var v2 = __toESM(require("valibot"), 1);
-var baseListResponseSchema = v2.object({
-  limit: v2.number(),
-  offset: v2.number(),
-  total: v2.number(),
-  results: v2.array(v2.unknown())
+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 v3 = __toESM(require("valibot"), 1);
-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()
+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 = {};
@@ -195,7 +263,7 @@ async function getBlock(opts) {
       data: jsonError
     });
   }
-  const validationResult = v3.safeParse(responseSchema2, data);
+  const validationResult = v4.safeParse(responseSchema3, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -211,22 +279,64 @@ var blocks = {
   getBlock
 };
 
+// src/stacks-api/faucets/stx.ts
+async function stx(opts) {
+  const search = new URLSearchParams();
+  search.append("address", opts.address);
+  if (opts.stacking) search.append("stacking", "true");
+  const init = {};
+  if (opts.apiKeyConfig) {
+    init.headers = {
+      [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
+    };
+  }
+  init.method = "POST";
+  const endpoint = `${opts.baseUrl}/extended/v1/faucets/stx?${search}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchStxError",
+      message: "Failed to fetch STX.",
+      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
+    });
+  }
+  return success(data);
+}
+
+// src/stacks-api/faucets/index.ts
+var faucets = {
+  stx
+};
+
 // src/stacks-api/info/core-api.ts
-var v4 = __toESM(require("valibot"), 1);
-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.string(),
-  exit_at_block_height: v4.number()
+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 = {};
@@ -255,7 +365,7 @@ async function coreApi(apiOpts) {
       data: parseBodyError
     });
   }
-  const validationResult = v4.safeParse(CoreApiResponseSchema, data);
+  const validationResult = v5.safeParse(CoreApiResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -267,60 +377,60 @@ async function coreApi(apiOpts) {
 }
 
 // src/stacks-api/info/pox-details.ts
-var v5 = __toESM(require("valibot"), 1);
-var poxDetailsResponseSchema = v5.object({
-  contract_id: v5.string(),
-  pox_activation_threshold_ustx: v5.number(),
-  first_burnchain_block_height: v5.number(),
-  current_burnchain_block_height: v5.number(),
-  prepare_phase_block_length: v5.number(),
-  reward_phase_block_length: v5.number(),
-  reward_slots: v5.number(),
-  rejection_fraction: v5.null(),
-  total_liquid_supply_ustx: v5.number(),
-  current_cycle: v5.object({
-    id: v5.number(),
-    min_threshold_ustx: v5.number(),
-    stacked_ustx: v5.number(),
-    is_pox_active: v5.boolean()
+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: v5.object({
-    id: v5.number(),
-    min_threshold_ustx: v5.number(),
-    min_increment_ustx: v5.number(),
-    stacked_ustx: v5.number(),
-    prepare_phase_start_block_height: v5.number(),
-    blocks_until_prepare_phase: v5.number(),
-    reward_phase_start_block_height: v5.number(),
-    blocks_until_reward_phase: v5.number(),
-    ustx_until_pox_rejection: v5.null()
+  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: v5.array(
-    v5.object({
-      epoch_id: v5.string(),
-      start_height: v5.number(),
-      end_height: v5.number(),
-      block_limit: v5.object({
-        write_length: v5.number(),
-        write_count: v5.number(),
-        read_length: v5.number(),
-        read_count: v5.number(),
-        runtime: v5.number()
+  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: v5.number()
+      network_epoch: v6.number()
     })
   ),
-  min_amount_ustx: v5.number(),
-  prepare_cycle_length: v5.number(),
-  reward_cycle_id: v5.number(),
-  reward_cycle_length: v5.number(),
-  rejection_votes_left_required: v5.null(),
-  next_reward_cycle_in: v5.number(),
-  contract_versions: v5.array(
-    v5.object({
-      contract_id: v5.string(),
-      activation_burnchain_block_height: v5.number(),
-      first_reward_cycle_id: v5.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()
     })
   )
 });
@@ -351,7 +461,7 @@ async function poxDetails(args) {
       data: jsonParseError
     });
   }
-  const validationResult = v5.safeParse(poxDetailsResponseSchema, data);
+  const validationResult = v6.safeParse(poxDetailsResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -369,14 +479,14 @@ var info = {
 };
 
 // src/stacks-api/proof-of-transfer/cycle.ts
-var v6 = __toESM(require("valibot"), 1);
-var responseSchema3 = 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()
+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 = {};
@@ -407,7 +517,7 @@ async function cycle(opts) {
       data: jsonError
     });
   }
-  const validationResult = v6.safeParse(responseSchema3, data);
+  const validationResult = v7.safeParse(responseSchema4, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -419,17 +529,17 @@ async function cycle(opts) {
 }
 
 // src/stacks-api/proof-of-transfer/cycles.ts
-var v7 = __toESM(require("valibot"), 1);
-var cycleInfoSchema = 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()
+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 = v7.array(cycleInfoSchema);
-var cyclesResponseSchema = v7.object({
+var resultsSchema = v8.array(cycleInfoSchema);
+var cyclesResponseSchema = v8.object({
   ...baseListResponseSchema.entries,
   results: resultsSchema
 });
@@ -465,7 +575,7 @@ async function cycles(args) {
       data: jsonError
     });
   }
-  const validationResult = v7.safeParse(cyclesResponseSchema, data);
+  const validationResult = v8.safeParse(cyclesResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -477,16 +587,16 @@ async function cycles(args) {
 }
 
 // src/stacks-api/proof-of-transfer/signer-in-cycle.ts
-var v8 = __toESM(require("valibot"), 1);
-var signerInCycleResponseSchema = 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(),
-  solo_stacker_count: v8.number(),
-  pooled_stacker_count: v8.number()
+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 = {};
@@ -522,7 +632,7 @@ async function signerInCycle(args) {
       }
     });
   }
-  const validationResult = v8.safeParse(signerInCycleResponseSchema, data);
+  const validationResult = v9.safeParse(signerInCycleResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -534,19 +644,19 @@ async function signerInCycle(args) {
 }
 
 // src/stacks-api/proof-of-transfer/signers-in-cycle.ts
-var v9 = __toESM(require("valibot"), 1);
-var signerSchema = 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(),
-  pooled_stacker_count: v9.number(),
-  solo_stacker_count: v9.number()
+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 = v9.array(signerSchema);
-var signersResponseSchema = v9.object({
+var resultsSchema2 = v10.array(signerSchema);
+var signersResponseSchema = v10.object({
   ...baseListResponseSchema.entries,
   results: resultsSchema2
 });
@@ -585,7 +695,7 @@ async function signersInCycle(args) {
       }
     });
   }
-  const validationResult = v9.safeParse(signersResponseSchema, data);
+  const validationResult = v10.safeParse(signersResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -597,15 +707,15 @@ async function signersInCycle(args) {
 }
 
 // src/stacks-api/proof-of-transfer/stackers-for-signer-in-cycle.ts
-var v10 = __toESM(require("valibot"), 1);
-var stackerInfoSchema = v10.object({
-  stacker_address: v10.string(),
-  stacked_amount: v10.string(),
-  pox_address: v10.string(),
-  stacker_type: v10.union([v10.literal("pooled"), v10.literal("solo")])
+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 = v10.array(stackerInfoSchema);
-var stackersForSignerInCycleResponseSchema = v10.object({
+var resultsSchema3 = v11.array(stackerInfoSchema);
+var stackersForSignerInCycleResponseSchema = v11.object({
   ...baseListResponseSchema.entries,
   results: resultsSchema3
 });
@@ -619,7 +729,8 @@ async function stackersForSignerInCycle(opts) {
       [opts.apiKeyConfig.header]: opts.apiKeyConfig.key
     };
   }
-  const endpoint = `${opts.baseUrl}/extended/v2/pox/cycles/${opts.cycleNumber}/signers/${opts.signerPublicKey}/stackers?${search}`;
+  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({
@@ -641,7 +752,7 @@ async function stackersForSignerInCycle(opts) {
       data: jsonError
     });
   }
-  const validationResult = v10.safeParse(
+  const validationResult = v11.safeParse(
     stackersForSignerInCycleResponseSchema,
     data
   );
@@ -665,28 +776,37 @@ var proofOfTransfer = {
 };
 
 // src/stacks-api/smart-contracts/read-only.ts
-var v11 = __toESM(require("valibot"), 1);
-var readOnlyResponseSchema = v11.variant("okay", [
-  v11.object({
-    okay: v11.literal(true),
-    result: v11.string()
+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()
   }),
-  v11.object({
-    okay: v11.literal(false),
-    cause: v11.unknown()
+  v12.object({
+    okay: v12.literal(false),
+    cause: v12.unknown()
   })
 ]);
-async function readOnly(opts, apiOpts) {
-  const init = {};
-  if (apiOpts.apiKeyConfig) {
-    init.headers = {
-      [apiOpts.apiKeyConfig.header]: apiOpts.apiKeyConfig.key
-    };
+async function readOnly(args) {
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (args.apiKeyConfig) {
+    headers[args.apiKeyConfig.header] = args.apiKeyConfig.key;
   }
-  const res = await fetch(
-    `${apiOpts.baseUrl}/v2/contracts/call-read/${opts.contractAddress}/${opts.contractName}/${opts.functionName}`,
-    init
-  );
+  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",
@@ -706,7 +826,7 @@ async function readOnly(opts, apiOpts) {
       data: error
     });
   }
-  const validationResult = v11.safeParse(readOnlyResponseSchema, data);
+  const validationResult = v12.safeParse(readOnlyResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -723,37 +843,35 @@ var smartContracts = {
 };
 
 // src/stacks-api/stacking-pool/members.ts
-var v12 = __toESM(require("valibot"), 1);
-var memberSchema = v12.object({
-  stacker: v12.string(),
-  pox_addr: v12.optional(v12.string()),
-  amount_ustx: v12.string(),
-  burn_block_unlock_height: v12.optional(v12.number()),
-  block_height: v12.number(),
-  tx_id: v12.string()
+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 = v12.object({
-  limit: v12.number(),
-  offset: v12.number(),
-  total: v12.number(),
-  results: v12.array(memberSchema)
+var membersResponseSchema = v13.object({
+  limit: v13.number(),
+  offset: v13.number(),
+  total: v13.number(),
+  results: v13.array(memberSchema)
 });
-async function members(opts, apiOpts) {
+async function members(args) {
   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());
+  if (args.afterBlock) search.append("after_block", args.afterBlock.toString());
+  if (args.unanchored) search.append("unanchored", "true");
+  if (args.limit) search.append("limit", args.limit.toString());
+  if (args.offset) search.append("offset", args.offset.toString());
   const init = {};
-  if (apiOpts.apiKeyConfig) {
+  if (args.apiKeyConfig) {
     init.headers = {
-      [apiOpts.apiKeyConfig.header]: apiOpts.apiKeyConfig.key
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
     };
   }
-  const res = await fetch(
-    `${apiOpts.baseUrl}/extended/beta/stacking/${opts.poolPrincipal}/delegations?${search}`,
-    init
-  );
+  const endpoint = `${args.baseUrl}/extended/v1/pox4/${args.poolPrincipal}/delegations?${search}`;
+  const res = await fetch(endpoint, init);
   if (!res.ok) {
     return error({
       name: "FetchMembersError",
@@ -773,7 +891,7 @@ async function members(opts, apiOpts) {
       data: jsonParseError
     });
   }
-  const validationResult = v12.safeParse(membersResponseSchema, data);
+  const validationResult = v13.safeParse(membersResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -790,116 +908,120 @@ var stackingPool = {
 };
 
 // src/stacks-api/transactions/schemas.ts
-var v13 = __toESM(require("valibot"), 1);
-var baseTransactionSchema = v13.object({
-  tx_id: v13.string(),
-  nonce: v13.number(),
-  fee_rate: v13.string(),
-  sender_address: v13.string(),
-  sponsored: v13.boolean(),
-  post_condition_mode: v13.string(),
-  post_conditions: v13.array(v13.unknown()),
-  anchor_mode: v13.string(),
-  is_unanchored: v13.boolean(),
-  block_hash: v13.string(),
-  parent_block_hash: v13.string(),
-  block_height: v13.number(),
-  block_time: v13.number(),
-  block_time_iso: v13.string(),
-  burn_block_height: v13.number(),
-  burn_block_time: v13.number(),
-  burn_block_time_iso: v13.string(),
-  parent_burn_block_time: v13.number(),
-  parent_burn_block_time_iso: v13.string(),
-  canonical: v13.boolean(),
-  tx_index: v13.number(),
-  tx_status: v13.string(),
-  tx_result: v13.object({
-    hex: v13.string(),
-    repr: v13.string()
+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: v13.string(),
-  microblock_sequence: v13.number(),
-  microblock_canonical: v13.boolean(),
-  event_count: v13.number(),
-  events: v13.array(v13.unknown()),
-  execution_cost_read_count: v13.number(),
-  execution_cost_read_length: v13.number(),
-  execution_cost_runtime: v13.number(),
-  execution_cost_write_count: v13.number(),
-  execution_cost_write_length: v13.number()
+  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 = v13.object({
-  tx_type: v13.literal("contract_call"),
-  contract_call: v13.object({
-    contract_id: v13.string(),
-    function_name: v13.string(),
-    function_signature: v13.string(),
-    function_args: v13.array(
-      v13.object({
-        hex: v13.string(),
-        repr: v13.string(),
-        name: v13.string(),
-        type: v13.string()
+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 = v13.object({
-  tx_type: v13.literal("smart_contract"),
-  smart_contract: v13.object({
+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: v13.union([v13.null(), v13.number()]),
-    contract_id: v13.string(),
-    source_code: v13.string()
+    clarity_version: v14.union([v14.null(), v14.number()]),
+    contract_id: v14.string(),
+    source_code: v14.string()
   }),
   ...baseTransactionSchema.entries
 });
-var tokenTransferSchema = v13.object({
-  tx_type: v13.literal("token_transfer"),
-  token_transfer: v13.object({
-    recipient_address: v13.string(),
-    amount: v13.string(),
-    memo: v13.string()
+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 = v13.variant("tx_type", [
+var transactionSchema = v14.variant("tx_type", [
   contractCallTransactionSchema,
   smartContractTransactionSchema,
   tokenTransferSchema
 ]);
 
 // src/stacks-api/transactions/address-transactions.ts
-var v14 = __toESM(require("valibot"), 1);
-var resultSchema = v14.object({
+var v15 = __toESM(require("valibot"), 1);
+var resultSchema = v15.object({
   tx: transactionSchema,
-  stx_sent: v14.string(),
-  stx_received: v14.string(),
-  events: v14.object({
-    stx: v14.object({
-      transfer: v14.number(),
-      mint: v14.number(),
-      burn: v14.number()
+  stx_sent: v15.string(),
+  stx_received: v15.string(),
+  events: v15.object({
+    stx: v15.object({
+      transfer: v15.number(),
+      mint: v15.number(),
+      burn: v15.number()
     }),
-    ft: v14.object({
-      transfer: v14.number(),
-      mint: v14.number(),
-      burn: v14.number()
+    ft: v15.object({
+      transfer: v15.number(),
+      mint: v15.number(),
+      burn: v15.number()
     }),
-    nft: v14.object({
-      transfer: v14.number(),
-      mint: v14.number(),
-      burn: v14.number()
+    nft: v15.object({
+      transfer: v15.number(),
+      mint: v15.number(),
+      burn: v15.number()
     })
   })
 });
-var resultsSchema4 = v14.array(resultSchema);
-var addressTransactionsResponseSchema = v14.object({
+var resultsSchema4 = v15.array(resultSchema);
+var addressTransactionsResponseSchema = v15.object({
   ...baseListResponseSchema.entries,
   results: resultsSchema4
 });
@@ -936,7 +1058,7 @@ async function addressTransactions(args) {
       data: jsonParseError
     });
   }
-  const validationResult = v14.safeParse(addressTransactionsResponseSchema, data);
+  const validationResult = v15.safeParse(addressTransactionsResponseSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -948,7 +1070,7 @@ async function addressTransactions(args) {
 }
 
 // src/stacks-api/transactions/get-transaction.ts
-var v15 = __toESM(require("valibot"), 1);
+var v16 = __toESM(require("valibot"), 1);
 async function getTransaction(args) {
   const init = {};
   if (args.apiKeyConfig) {
@@ -977,7 +1099,7 @@ async function getTransaction(args) {
       error: jsonParseError
     });
   }
-  const validationResult = v15.safeParse(transactionSchema, data);
+  const validationResult = v16.safeParse(transactionSchema, data);
   if (!validationResult.success) {
     return error({
       name: "ValidateDataError",
@@ -998,6 +1120,7 @@ var transactions = {
 var stacksApi = {
   accounts,
   blocks,
+  faucets,
   info,
   proofOfTransfer,
   smartContracts,
@@ -1005,14 +1128,97 @@ var stacksApi = {
   transactions
 };
 
+// src/stacks-rpc-api/smart-contracts/map-entry.ts
+var v17 = __toESM(require("valibot"), 1);
+var mapEntryResponseSchema = v17.object({
+  /**
+   * Hex-encoded string of clarity value. It is always an optional tuple.
+   */
+  data: v17.string(),
+  /**
+   * Hex-encoded string of the MARF proof for the data
+   */
+  proof: v17.optional(v17.string())
+});
+async function mapEntry(args) {
+  const search = new URLSearchParams();
+  if (args.proof === 0) search.append("proof", "0");
+  if (args.tip) search.append("tip", args.tip);
+  const init = {};
+  if (args.apiKeyConfig) {
+    init.headers = {
+      [args.apiKeyConfig.header]: args.apiKeyConfig.key
+    };
+  }
+  init.method = "POST";
+  init.body = args.mapKey;
+  const endpoint = `${args.baseUrl}/v2/map_entry/${args.contractAddress}/${args.contractName}/${args.mapName}?${search}`;
+  const res = await fetch(endpoint, init);
+  if (!res.ok) {
+    return error({
+      name: "FetchMapEntryError",
+      message: "Failed to fetch map entry.",
+      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 = v17.safeParse(mapEntryResponseSchema, data);
+  if (!validationResult.success) {
+    return error({
+      name: "ValidateDataError",
+      message: "Failed to validate response data.",
+      data: validationResult
+    });
+  }
+  return success(validationResult.output);
+}
+
+// src/stacks-rpc-api/smart-contracts/index.ts
+var smartContracts2 = {
+  mapEntry
+};
+
+// src/stacks-rpc-api/index.ts
+var stacksRpcApi = {
+  smartContracts: smartContracts2
+};
+
 // 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)(() => fn(), {
-      startingDelay: options?.startingDelay ?? 15e3,
-      numOfAttempts: options?.numOfAttempts ?? 5
-    });
+    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",
@@ -1063,7 +1269,7 @@ async function getSignerStackedAmount(args) {
         }
       }
     }
-    offset += limit + data.results.length;
+    offset += data.results.length;
     hasMore = offset < data.total;
   }
   if (!found) {
@@ -1085,6 +1291,13 @@ var queries = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  callRateLimitedApi,
+  error,
   queries,
-  stacksApi
+  safeCall,
+  safeCallRateLimitedApi,
+  safePromise,
+  stacksApi,
+  stacksRpcApi,
+  success
 });