@secretkeylabs/stacks-tools 0.3.0-05c5288 → 0.3.0-6a691d3

package/dist/index.cjs

@@ -30,11 +30,25 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  queries: () => queries,
-  stacksApi: () => stacksApi
+  stacksApi: () => stacks_api_exports
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/stacks-api/index.ts
+var stacks_api_exports = {};
+__export(stacks_api_exports, {
+  accounts: () => accounts_exports,
+  blocks: () => blocks_exports,
+  info: () => info_exports,
+  proofOfTransfer: () => proof_of_transfer_exports
+});
+
+// src/stacks-api/accounts/index.ts
+var accounts_exports = {};
+__export(accounts_exports, {
+  balances: () => balances
+});
+
 // src/utils/safe.ts
 function success(data) {
   return [null, data];
@@ -128,10 +142,11 @@ async function balances(opts) {
   return success(validationResult.output);
 }
 
-// src/stacks-api/accounts/index.ts
-var accounts = {
-  balances
-};
+// src/stacks-api/blocks/index.ts
+var blocks_exports = {};
+__export(blocks_exports, {
+  getBlock: () => getBlock
+});
 
 // src/stacks-api/types.ts
 var v2 = __toESM(require("valibot"), 1);
@@ -206,10 +221,12 @@ async function getBlock(opts) {
   return success(validationResult.output);
 }
 
-// src/stacks-api/blocks/index.ts
-var blocks = {
-  getBlock
-};
+// src/stacks-api/info/index.ts
+var info_exports = {};
+__export(info_exports, {
+  coreApi: () => coreApi,
+  poxDetails: () => poxDetails
+});
 
 // src/stacks-api/info/core-api.ts
 var v4 = __toESM(require("valibot"), 1);
@@ -362,11 +379,15 @@ async function poxDetails(args) {
   return success(validationResult.output);
 }
 
-// src/stacks-api/info/index.ts
-var info = {
-  coreApi,
-  poxDetails
-};
+// src/stacks-api/proof-of-transfer/index.ts
+var proof_of_transfer_exports = {};
+__export(proof_of_transfer_exports, {
+  cycle: () => cycle,
+  cycles: () => cycles,
+  signerInCycle: () => signerInCycle,
+  signersInCycle: () => signersInCycle,
+  stackersForSignerInCycle: () => stackersForSignerInCycle
+});
 
 // src/stacks-api/proof-of-transfer/cycle.ts
 var v6 = __toESM(require("valibot"), 1);
@@ -654,437 +675,7 @@ async function stackersForSignerInCycle(opts) {
   }
   return success(validationResult.output);
 }
-
-// src/stacks-api/proof-of-transfer/index.ts
-var proofOfTransfer = {
-  cycle,
-  cycles,
-  signerInCycle,
-  signersInCycle,
-  stackersForSignerInCycle
-};
-
-// 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()
-  }),
-  v11.object({
-    okay: v11.literal(false),
-    cause: v11.unknown()
-  })
-]);
-async function readOnly(opts, apiOpts) {
-  const init = {};
-  if (apiOpts.apiKeyConfig) {
-    init.headers = {
-      [apiOpts.apiKeyConfig.header]: apiOpts.apiKeyConfig.key
-    };
-  }
-  const res = await fetch(
-    `${apiOpts.baseUrl}/v2/contracts/call-read/${opts.contractAddress}/${opts.contractName}/${opts.functionName}`,
-    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 = v11.safeParse(readOnlyResponseSchema, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      data: validationResult
-    });
-  }
-  return success(validationResult.output);
-}
-
-// src/stacks-api/smart-contracts/index.ts
-var smartContracts = {
-  readOnly
-};
-
-// 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 membersResponseSchema = v12.object({
-  limit: v12.number(),
-  offset: v12.number(),
-  total: v12.number(),
-  results: v12.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 = v12.safeParse(membersResponseSchema, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      data: validationResult
-    });
-  }
-  return success(validationResult.output);
-}
-
-// src/stacks-api/stacking-pool/index.ts
-var stackingPool = {
-  members
-};
-
-// 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()
-  }),
-  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()
-});
-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()
-      })
-    )
-  }),
-  ...baseTransactionSchema.entries
-});
-var smartContractTransactionSchema = v13.object({
-  tx_type: v13.literal("smart_contract"),
-  smart_contract: v13.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()
-  }),
-  ...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()
-  }),
-  ...baseTransactionSchema.entries
-});
-var transactionSchema = v13.variant("tx_type", [
-  contractCallTransactionSchema,
-  smartContractTransactionSchema,
-  tokenTransferSchema
-]);
-
-// src/stacks-api/transactions/address-transactions.ts
-var v14 = __toESM(require("valibot"), 1);
-var resultSchema = v14.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()
-    }),
-    ft: v14.object({
-      transfer: v14.number(),
-      mint: v14.number(),
-      burn: v14.number()
-    }),
-    nft: v14.object({
-      transfer: v14.number(),
-      mint: v14.number(),
-      burn: v14.number()
-    })
-  })
-});
-var resultsSchema4 = v14.array(resultSchema);
-var addressTransactionsResponseSchema = v14.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 = v14.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 v15 = __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 = v15.safeParse(transactionSchema, data);
-  if (!validationResult.success) {
-    return error({
-      name: "ValidateDataError",
-      message: "Failed to validate data.",
-      error: validationResult
-    });
-  }
-  return success(validationResult.output);
-}
-
-// src/stacks-api/transactions/index.ts
-var transactions = {
-  addressTransactions,
-  getTransaction
-};
-
-// src/stacks-api/index.ts
-var stacksApi = {
-  accounts,
-  blocks,
-  info,
-  proofOfTransfer,
-  smartContracts,
-  stackingPool,
-  transactions
-};
-
-// src/utils/call-rate-limited-api.ts
-var import_exponential_backoff = require("exponential-backoff");
-async function safeCallRateLimitedApi(fn, options) {
-  try {
-    return await (0, import_exponential_backoff.backOff)(() => fn(), {
-      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/queries/get-signer-stacked-amount.ts
-async function getSignerStackedAmount(args) {
-  let totalLocked = 0n;
-  const { identifier, ...rest } = args;
-  let hasMore = true;
-  let offset = 0;
-  let found = false;
-  const limit = 200;
-  while (hasMore && !found) {
-    const [error2, data] = await safeCallRateLimitedApi(
-      () => signersInCycle({
-        ...rest,
-        limit
-      })
-    );
-    if (error2) {
-      return error({
-        name: "GetSignerTotalLockedError",
-        message: "Failed to get signer total locked.",
-        data: {
-          error: error2
-        }
-      });
-    }
-    for (const signer of data.results) {
-      if (identifier.type === "address") {
-        if (signer.signer_address === identifier.signerAddress) {
-          totalLocked = BigInt(signer.stacked_amount);
-          found = true;
-          break;
-        }
-      } else {
-        if (signer.signing_key === identifier.signerPublicKey) {
-          totalLocked = BigInt(signer.stacked_amount);
-          found = true;
-          break;
-        }
-      }
-    }
-    offset += limit + data.results.length;
-    hasMore = offset < data.total;
-  }
-  if (!found) {
-    return error({
-      name: "SignerNotFound",
-      message: "Signer not found.",
-      data: {
-        identifier,
-        cycle: args.cycleNumber
-      }
-    });
-  }
-  return success(totalLocked);
-}
-
-// src/queries/index.ts
-var queries = {
-  getSignerStackedAmount
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  queries,
   stacksApi
 });