@algorandfoundation/algokit-utils 9.2.0 → 9.2.1-beta.2

package/types/transfer.d.ts

@@ -1,76 +1,80 @@
-import algosdk from 'algosdk';
-import { AlgoAmount } from './amount';
-import { TestNetDispenserApiClient } from './dispenser-client';
-import { SendTransactionFrom, SendTransactionParams, TransactionNote } from './transaction';
-import SuggestedParams = algosdk.SuggestedParams;
+import { AlgoAmount } from "./amount.js";
+import { SendTransactionFrom, SendTransactionParams, TransactionNote } from "./transaction.js";
+import { TestNetDispenserApiClient } from "./dispenser-client.js";
+import algosdk from "algosdk";
+
+//#region src/types/transfer.d.ts
 /** @deprecated Parameters for `transferAlgos` call. */
-export interface AlgoTransferParams extends SendTransactionParams {
-    /** The account that will send the Algo */
-    from: SendTransactionFrom;
-    /** The account / account address that will receive the Algo */
-    to: SendTransactionFrom | string;
-    /** The amount to send */
-    amount: AlgoAmount;
-    /** Optional transaction parameters */
-    transactionParams?: SuggestedParams;
-    /** The (optional) transaction note */
-    note?: TransactionNote;
-    /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
-    lease?: string | Uint8Array;
+interface AlgoTransferParams extends SendTransactionParams {
+  /** The account that will send the Algo */
+  from: SendTransactionFrom;
+  /** The account / account address that will receive the Algo */
+  to: SendTransactionFrom | string;
+  /** The amount to send */
+  amount: AlgoAmount;
+  /** Optional transaction parameters */
+  transactionParams?: SuggestedParams;
+  /** The (optional) transaction note */
+  note?: TransactionNote;
+  /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
+  lease?: string | Uint8Array;
 }
 /** @deprecated Parameters for `rekeyAccount` call. */
-export interface AlgoRekeyParams extends SendTransactionParams {
-    /** The account that will be rekeyed */
-    from: SendTransactionFrom;
-    /** The account / account address that will have the private key that is authorised to transact on behalf of the from account from now on */
-    rekeyTo: SendTransactionFrom | string;
-    /** Optional transaction parameters */
-    transactionParams?: SuggestedParams;
-    /** The (optional) transaction note */
-    note?: TransactionNote;
-    /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
-    lease?: string | Uint8Array;
+interface AlgoRekeyParams extends SendTransactionParams {
+  /** The account that will be rekeyed */
+  from: SendTransactionFrom;
+  /** The account / account address that will have the private key that is authorised to transact on behalf of the from account from now on */
+  rekeyTo: SendTransactionFrom | string;
+  /** Optional transaction parameters */
+  transactionParams?: SuggestedParams;
+  /** The (optional) transaction note */
+  note?: TransactionNote;
+  /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
+  lease?: string | Uint8Array;
 }
 /** @deprecated Parameters for `ensureFunded` call. */
-export interface EnsureFundedParams extends SendTransactionParams {
-    /** The account to fund */
-    accountToFund: SendTransactionFrom | string;
-    /** The account to use as a funding source, will default to using the dispenser account returned by `algokit.getDispenserAccount` */
-    fundingSource?: SendTransactionFrom | TestNetDispenserApiClient;
-    /** The minimum balance of Algo that the account should have available to spend (i.e. on top of minimum balance requirement) */
-    minSpendingBalance: AlgoAmount;
-    /** When issuing a funding amount, the minimum amount to transfer (avoids many small transfers if this gets called often on an active account) */
-    minFundingIncrement?: AlgoAmount;
-    /** Optional transaction parameters */
-    transactionParams?: SuggestedParams;
-    /** The (optional) transaction note, default: "Funding account to meet minimum requirement" */
-    note?: TransactionNote;
-    /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
-    lease?: string | Uint8Array;
+interface EnsureFundedParams extends SendTransactionParams {
+  /** The account to fund */
+  accountToFund: SendTransactionFrom | string;
+  /** The account to use as a funding source, will default to using the dispenser account returned by `algokit.getDispenserAccount` */
+  fundingSource?: SendTransactionFrom | TestNetDispenserApiClient;
+  /** The minimum balance of Algo that the account should have available to spend (i.e. on top of minimum balance requirement) */
+  minSpendingBalance: AlgoAmount;
+  /** When issuing a funding amount, the minimum amount to transfer (avoids many small transfers if this gets called often on an active account) */
+  minFundingIncrement?: AlgoAmount;
+  /** Optional transaction parameters */
+  transactionParams?: SuggestedParams;
+  /** The (optional) transaction note, default: "Funding account to meet minimum requirement" */
+  note?: TransactionNote;
+  /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
+  lease?: string | Uint8Array;
 }
 /** @deprecated Parameters for `transferAsset` call. */
-export interface TransferAssetParams extends SendTransactionParams {
-    /** The account that will send the asset */
-    from: SendTransactionFrom;
-    /** The account / account address that will receive the asset */
-    to: SendTransactionFrom | string;
-    /** The asset id that will be transfered */
-    assetId: number;
-    /** The amount to send as the smallest divisible unit value */
-    amount: number | bigint;
-    /** Optional transaction parameters */
-    transactionParams?: SuggestedParams;
-    /** An address of a target account from which to perform a clawback operation. Please note, in such cases senderAccount must be equal to clawback field on ASA metadata. */
-    clawbackFrom?: SendTransactionFrom | string;
-    /** The (optional) transaction note */
-    note?: TransactionNote;
-    /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
-    lease?: string | Uint8Array;
+interface TransferAssetParams extends SendTransactionParams {
+  /** The account that will send the asset */
+  from: SendTransactionFrom;
+  /** The account / account address that will receive the asset */
+  to: SendTransactionFrom | string;
+  /** The asset id that will be transfered */
+  assetId: number;
+  /** The amount to send as the smallest divisible unit value */
+  amount: number | bigint;
+  /** Optional transaction parameters */
+  transactionParams?: SuggestedParams;
+  /** An address of a target account from which to perform a clawback operation. Please note, in such cases senderAccount must be equal to clawback field on ASA metadata. */
+  clawbackFrom?: SendTransactionFrom | string;
+  /** The (optional) transaction note */
+  note?: TransactionNote;
+  /** An (optional) [transaction lease](https://dev.algorand.co/concepts/transactions/leases) to apply */
+  lease?: string | Uint8Array;
 }
 /** @deprecated */
-export interface EnsureFundedReturnType {
-    /** The transaction */
-    transactionId: string;
-    /** The response if the transaction was sent and waited for */
-    amount: number;
+interface EnsureFundedReturnType {
+  /** The transaction */
+  transactionId: string;
+  /** The response if the transaction was sent and waited for */
+  amount: number;
 }
+//#endregion
+export { AlgoRekeyParams, AlgoTransferParams, EnsureFundedParams, EnsureFundedReturnType, TransferAssetParams };
+//# sourceMappingURL=transfer.d.ts.map

package/types/transfer.js

@@ -1,3 +0,0 @@
-'use strict';
-
-//# sourceMappingURL=transfer.js.map

package/types/transfer.mjs

@@ -1,2 +0,0 @@
-
-//# sourceMappingURL=transfer.mjs.map

package/util.js

@@ -1,147 +1,101 @@
-'use strict';
-
-var algosdk = require('algosdk');
-var types_app = require('./types/app.js');
-
+const require_app = require("./types/app.js");
+let algosdk = require("algosdk");
+//#region src/util.ts
 /**
- * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.
- *
- * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type
- * @param value
- */
+* Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.
+*
+* Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type
+* @param value
+*/
 const toNumber = (value) => {
-    if (typeof value === 'number')
-        return value;
-    if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
-        throw new UnsafeConversionError(`Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`);
-    }
-    else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {
-        throw new UnsafeConversionError(`Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`);
-    }
-    return Number(value);
+	if (typeof value === "number") return value;
+	if (value > BigInt(Number.MAX_SAFE_INTEGER)) throw new UnsafeConversionError(`Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`);
+	else if (value < BigInt(Number.MIN_SAFE_INTEGER)) throw new UnsafeConversionError(`Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`);
+	return Number(value);
 };
-class UnsafeConversionError extends Error {
-}
+var UnsafeConversionError = class extends Error {};
 /**
- * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.
- * @param minSpendingBalance The minimum spending balance for the wallet
- * @param currentSpendingBalance The current spending balance for the wallet
- * @param minFundingIncrement The minimum amount of funds that can be added to the wallet
- * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance
- */
+* Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.
+* @param minSpendingBalance The minimum spending balance for the wallet
+* @param currentSpendingBalance The current spending balance for the wallet
+* @param minFundingIncrement The minimum amount of funds that can be added to the wallet
+* @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance
+*/
 const calculateFundAmount = (minSpendingBalance, currentSpendingBalance, minFundingIncrement) => {
-    if (minSpendingBalance > currentSpendingBalance) {
-        const minFundAmount = minSpendingBalance - currentSpendingBalance;
-        return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)));
-    }
-    else {
-        return null;
-    }
+	if (minSpendingBalance > currentSpendingBalance) {
+		const minFundAmount = minSpendingBalance - currentSpendingBalance;
+		return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)));
+	} else return null;
 };
 /**
- * Returns the given array split into chunks of `batchSize` batches.
- * @param array The array to chunk
- * @param batchSize The size of batches to split the array into
- * @returns A generator that yields the array split into chunks of `batchSize` batches
- */
+* Returns the given array split into chunks of `batchSize` batches.
+* @param array The array to chunk
+* @param batchSize The size of batches to split the array into
+* @returns A generator that yields the array split into chunks of `batchSize` batches
+*/
 function* chunkArray(array, batchSize) {
-    for (let i = 0; i < array.length; i += batchSize)
-        yield array.slice(i, i + batchSize);
+	for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize);
 }
 /**
- * Memoize calls to the given function in an in-memory map.
- * @param fn The function to memoize
- * @returns The memoized function
- */
+* Memoize calls to the given function in an in-memory map.
+* @param fn The function to memoize
+* @returns The memoized function
+*/
 const memoize = (fn) => {
-    const cache = new Map();
-    const cached = function (val) {
-        return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val);
-    };
-    cached.cache = cache;
-    return cached;
+	const cache = /* @__PURE__ */ new Map();
+	const cached = function(val) {
+		return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val);
+	};
+	cached.cache = cache;
+	return cached;
 };
 const binaryStartsWith = (base, startsWith) => {
-    if (startsWith.length > base.length)
-        return false;
-    for (let i = 0; i < startsWith.length; i++) {
-        if (base[i] !== startsWith[i])
-            return false;
-    }
-    return true;
+	if (startsWith.length > base.length) return false;
+	for (let i = 0; i < startsWith.length; i++) if (base[i] !== startsWith[i]) return false;
+	return true;
 };
 const defaultJsonValueReplacer = (key, value) => {
-    if (typeof value === 'bigint') {
-        try {
-            return toNumber(value);
-        }
-        catch {
-            return value.toString();
-        }
-    }
-    return value;
+	if (typeof value === "bigint") try {
+		return toNumber(value);
+	} catch {
+		return value.toString();
+	}
+	return value;
 };
 const asJson = (value, replacer = defaultJsonValueReplacer, space) => {
-    return JSON.stringify(value, replacer, space);
+	return JSON.stringify(value, replacer, space);
 };
 /** Calculate minimum number of extra program pages required for provided approval and clear state programs */
 const calculateExtraProgramPages = (approvalProgram, clearStateProgram) => {
-    return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / types_app.APP_PAGE_MAX_SIZE);
+	return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / require_app.APP_PAGE_MAX_SIZE);
 };
 /** Take a decoded ABI value and convert all byte arrays (including nested ones) from number[] to Uint8Arrays */
 function convertAbiByteArrays(value, type) {
-    // Return value as is if the type doesn't have any bytes or if it's already an Uint8Array
-    if (!type.toString().includes('byte') || value instanceof Uint8Array) {
-        return value;
-    }
-    // Handle byte arrays (byte[N] or byte[])
-    if ((type instanceof algosdk.ABIArrayStaticType || type instanceof algosdk.ABIArrayDynamicType) &&
-        type.childType instanceof algosdk.ABIByteType &&
-        Array.isArray(value)) {
-        return new Uint8Array(value);
-    }
-    // Handle other arrays (for nested structures)
-    if ((type instanceof algosdk.ABIArrayStaticType || type instanceof algosdk.ABIArrayDynamicType) && Array.isArray(value)) {
-        const result = [];
-        for (let i = 0; i < value.length; i++) {
-            result.push(convertAbiByteArrays(value[i], type.childType));
-        }
-        return result;
-    }
-    // Handle tuples (for nested structures)
-    if (type instanceof algosdk.ABITupleType && Array.isArray(value)) {
-        const result = [];
-        for (let i = 0; i < value.length && i < type.childTypes.length; i++) {
-            result.push(convertAbiByteArrays(value[i], type.childTypes[i]));
-        }
-        return result;
-    }
-    // For other types, return the value as is
-    return value;
+	if (!type.toString().includes("byte") || value instanceof Uint8Array) return value;
+	if ((type instanceof algosdk.ABIArrayStaticType || type instanceof algosdk.ABIArrayDynamicType) && type.childType instanceof algosdk.ABIByteType && Array.isArray(value)) return new Uint8Array(value);
+	if ((type instanceof algosdk.ABIArrayStaticType || type instanceof algosdk.ABIArrayDynamicType) && Array.isArray(value)) {
+		const result = [];
+		for (let i = 0; i < value.length; i++) result.push(convertAbiByteArrays(value[i], type.childType));
+		return result;
+	}
+	if (type instanceof algosdk.ABITupleType && Array.isArray(value)) {
+		const result = [];
+		for (let i = 0; i < value.length && i < type.childTypes.length; i++) result.push(convertAbiByteArrays(value[i], type.childTypes[i]));
+		return result;
+	}
+	return value;
 }
 /**
- * Convert bigint values to numbers for uint types with bit size < 53
- */
+* Convert bigint values to numbers for uint types with bit size < 53
+*/
 const convertABIDecodedBigIntToNumber = (value, type) => {
-    if (typeof value === 'bigint') {
-        if (type instanceof algosdk.ABIUintType) {
-            return type.bitSize < 53 ? Number(value) : value;
-        }
-        else {
-            return value;
-        }
-    }
-    else if (Array.isArray(value) && (type instanceof algosdk.ABIArrayStaticType || type instanceof algosdk.ABIArrayDynamicType)) {
-        return value.map((v) => convertABIDecodedBigIntToNumber(v, type.childType));
-    }
-    else if (Array.isArray(value) && type instanceof algosdk.ABITupleType) {
-        return value.map((v, i) => convertABIDecodedBigIntToNumber(v, type.childTypes[i]));
-    }
-    else {
-        return value;
-    }
+	if (typeof value === "bigint") if (type instanceof algosdk.ABIUintType) return type.bitSize < 53 ? Number(value) : value;
+	else return value;
+	else if (Array.isArray(value) && (type instanceof algosdk.ABIArrayStaticType || type instanceof algosdk.ABIArrayDynamicType)) return value.map((v) => convertABIDecodedBigIntToNumber(v, type.childType));
+	else if (Array.isArray(value) && type instanceof algosdk.ABITupleType) return value.map((v, i) => convertABIDecodedBigIntToNumber(v, type.childTypes[i]));
+	else return value;
 };
-
+//#endregion
 exports.UnsafeConversionError = UnsafeConversionError;
 exports.asJson = asJson;
 exports.binaryStartsWith = binaryStartsWith;
@@ -153,4 +107,5 @@ exports.convertAbiByteArrays = convertAbiByteArrays;
 exports.defaultJsonValueReplacer = defaultJsonValueReplacer;
 exports.memoize = memoize;
 exports.toNumber = toNumber;
-//# sourceMappingURL=util.js.map
+
+//# sourceMappingURL=util.js.map

package/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sources":["../src/util.ts"],"sourcesContent":["import { ABIArrayDynamicType, ABIArrayStaticType, ABIByteType, ABIReturnType, ABITupleType, ABIType, ABIUintType, ABIValue } from 'algosdk'\nimport { APP_PAGE_MAX_SIZE } from './types/app'\n\n/**\n * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.\n *\n * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type\n * @param value\n */\nexport const toNumber = (value: number | bigint) => {\n  if (typeof value === 'number') return value\n\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`,\n    )\n  } else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`,\n    )\n  }\n  return Number(value)\n}\n\nexport class UnsafeConversionError extends Error {}\n\n/**\n * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.\n * @param minSpendingBalance The minimum spending balance for the wallet\n * @param currentSpendingBalance The current spending balance for the wallet\n * @param minFundingIncrement The minimum amount of funds that can be added to the wallet\n * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance\n */\nexport const calculateFundAmount = (\n  minSpendingBalance: bigint,\n  currentSpendingBalance: bigint,\n  minFundingIncrement: bigint,\n): bigint | null => {\n  if (minSpendingBalance > currentSpendingBalance) {\n    const minFundAmount = minSpendingBalance - currentSpendingBalance\n    return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)))\n  } else {\n    return null\n  }\n}\n\n/**\n * Checks if the current environment is Node.js\n *\n * @returns A boolean indicating whether the current environment is Node.js\n */\nexport const isNode = () => {\n  return typeof process !== 'undefined' && process.versions != null && process.versions.node != null\n}\n\n/**\n * Returns the given array split into chunks of `batchSize` batches.\n * @param array The array to chunk\n * @param batchSize The size of batches to split the array into\n * @returns A generator that yields the array split into chunks of `batchSize` batches\n */\nexport function* chunkArray<T>(array: T[], batchSize: number): Generator<T[], void> {\n  for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize)\n}\n\n/**\n * Memoize calls to the given function in an in-memory map.\n * @param fn The function to memoize\n * @returns The memoized function\n */\nexport const memoize = <T = unknown, R = unknown>(fn: (val: T) => R) => {\n  const cache = new Map()\n  const cached = function (this: unknown, val: T) {\n    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val)\n  }\n  cached.cache = cache\n  return cached as (val: T) => R\n}\n\nexport const binaryStartsWith = (base: Uint8Array, startsWith: Uint8Array): boolean => {\n  if (startsWith.length > base.length) return false\n  for (let i = 0; i < startsWith.length; i++) {\n    if (base[i] !== startsWith[i]) return false\n  }\n  return true\n}\n\nexport const defaultJsonValueReplacer = (key: string, value: unknown) => {\n  if (typeof value === 'bigint') {\n    try {\n      return toNumber(value)\n    } catch {\n      return value.toString()\n    }\n  }\n  return value\n}\nexport const asJson = (\n  value: unknown,\n  replacer: (key: string, value: unknown) => unknown = defaultJsonValueReplacer,\n  space?: string | number,\n) => {\n  return JSON.stringify(value, replacer, space)\n}\n\n/** Calculate minimum number of extra program pages required for provided approval and clear state programs */\nexport const calculateExtraProgramPages = (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array): number => {\n  return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE)\n}\n\n/** Take a decoded ABI value and convert all byte arrays (including nested ones) from number[] to Uint8Arrays */\nexport function convertAbiByteArrays(value: ABIValue, type: ABIReturnType): ABIValue {\n  // Return value as is if the type doesn't have any bytes or if it's already an Uint8Array\n  if (!type.toString().includes('byte') || value instanceof Uint8Array) {\n    return value\n  }\n\n  // Handle byte arrays (byte[N] or byte[])\n  if (\n    (type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType) &&\n    type.childType instanceof ABIByteType &&\n    Array.isArray(value)\n  ) {\n    return new Uint8Array(value as number[])\n  }\n\n  // Handle other arrays (for nested structures)\n  if ((type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType) && Array.isArray(value)) {\n    const result = []\n    for (let i = 0; i < value.length; i++) {\n      result.push(convertAbiByteArrays(value[i], type.childType))\n    }\n    return result\n  }\n\n  // Handle tuples (for nested structures)\n  if (type instanceof ABITupleType && Array.isArray(value)) {\n    const result = []\n    for (let i = 0; i < value.length && i < type.childTypes.length; i++) {\n      result.push(convertAbiByteArrays(value[i], type.childTypes[i]))\n    }\n    return result\n  }\n\n  // For other types, return the value as is\n  return value\n}\n\n/**\n * Convert bigint values to numbers for uint types with bit size < 53\n */\nexport const convertABIDecodedBigIntToNumber = (value: ABIValue, type: ABIType): ABIValue => {\n  if (typeof value === 'bigint') {\n    if (type instanceof ABIUintType) {\n      return type.bitSize < 53 ? Number(value) : value\n    } else {\n      return value\n    }\n  } else if (Array.isArray(value) && (type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType)) {\n    return value.map((v) => convertABIDecodedBigIntToNumber(v, type.childType))\n  } else if (Array.isArray(value) && type instanceof ABITupleType) {\n    return value.map((v, i) => convertABIDecodedBigIntToNumber(v, type.childTypes[i]))\n  } else {\n    return value\n  }\n}\n"],"names":["APP_PAGE_MAX_SIZE","ABIArrayStaticType","ABIArrayDynamicType","ABIByteType","ABITupleType","ABIUintType"],"mappings":"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"}
+{"version":3,"file":"util.js","names":["APP_PAGE_MAX_SIZE","ABIArrayStaticType","ABIArrayDynamicType","ABIByteType","ABITupleType","ABIUintType"],"sources":["../src/util.ts"],"sourcesContent":["import { ABIArrayDynamicType, ABIArrayStaticType, ABIByteType, ABIReturnType, ABITupleType, ABIType, ABIUintType, ABIValue } from 'algosdk'\nimport { APP_PAGE_MAX_SIZE } from './types/app'\n\n/**\n * Converts a value which might be a number or a bigint into a number to be used with apis that don't support bigint.\n *\n * Throws an UnsafeConversionError if the conversion would result in an unsafe integer for the Number type\n * @param value\n */\nexport const toNumber = (value: number | bigint) => {\n  if (typeof value === 'number') return value\n\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is larger than the maximum safe integer the Number type can hold.`,\n    )\n  } else if (value < BigInt(Number.MIN_SAFE_INTEGER)) {\n    throw new UnsafeConversionError(\n      `Cannot convert ${value} to a Number as it is smaller than the minimum safe integer the Number type can hold.`,\n    )\n  }\n  return Number(value)\n}\n\nexport class UnsafeConversionError extends Error {}\n\n/**\n * Calculates the amount of funds to add to a wallet to bring it up to the minimum spending balance.\n * @param minSpendingBalance The minimum spending balance for the wallet\n * @param currentSpendingBalance The current spending balance for the wallet\n * @param minFundingIncrement The minimum amount of funds that can be added to the wallet\n * @returns The amount of funds to add to the wallet or null if the wallet is already above the minimum spending balance\n */\nexport const calculateFundAmount = (\n  minSpendingBalance: bigint,\n  currentSpendingBalance: bigint,\n  minFundingIncrement: bigint,\n): bigint | null => {\n  if (minSpendingBalance > currentSpendingBalance) {\n    const minFundAmount = minSpendingBalance - currentSpendingBalance\n    return BigInt(Math.max(Number(minFundAmount), Number(minFundingIncrement)))\n  } else {\n    return null\n  }\n}\n\n/**\n * Checks if the current environment is Node.js\n *\n * @returns A boolean indicating whether the current environment is Node.js\n */\nexport const isNode = () => {\n  return typeof process !== 'undefined' && process.versions != null && process.versions.node != null\n}\n\n/**\n * Returns the given array split into chunks of `batchSize` batches.\n * @param array The array to chunk\n * @param batchSize The size of batches to split the array into\n * @returns A generator that yields the array split into chunks of `batchSize` batches\n */\nexport function* chunkArray<T>(array: T[], batchSize: number): Generator<T[], void> {\n  for (let i = 0; i < array.length; i += batchSize) yield array.slice(i, i + batchSize)\n}\n\n/**\n * Memoize calls to the given function in an in-memory map.\n * @param fn The function to memoize\n * @returns The memoized function\n */\nexport const memoize = <T = unknown, R = unknown>(fn: (val: T) => R) => {\n  const cache = new Map()\n  const cached = function (this: unknown, val: T) {\n    return cache.has(val) ? cache.get(val) : cache.set(val, fn.call(this, val)) && cache.get(val)\n  }\n  cached.cache = cache\n  return cached as (val: T) => R\n}\n\nexport const binaryStartsWith = (base: Uint8Array, startsWith: Uint8Array): boolean => {\n  if (startsWith.length > base.length) return false\n  for (let i = 0; i < startsWith.length; i++) {\n    if (base[i] !== startsWith[i]) return false\n  }\n  return true\n}\n\nexport const defaultJsonValueReplacer = (key: string, value: unknown) => {\n  if (typeof value === 'bigint') {\n    try {\n      return toNumber(value)\n    } catch {\n      return value.toString()\n    }\n  }\n  return value\n}\nexport const asJson = (\n  value: unknown,\n  replacer: (key: string, value: unknown) => unknown = defaultJsonValueReplacer,\n  space?: string | number,\n) => {\n  return JSON.stringify(value, replacer, space)\n}\n\n/** Calculate minimum number of extra program pages required for provided approval and clear state programs */\nexport const calculateExtraProgramPages = (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array): number => {\n  return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE)\n}\n\n/** Take a decoded ABI value and convert all byte arrays (including nested ones) from number[] to Uint8Arrays */\nexport function convertAbiByteArrays(value: ABIValue, type: ABIReturnType): ABIValue {\n  // Return value as is if the type doesn't have any bytes or if it's already an Uint8Array\n  if (!type.toString().includes('byte') || value instanceof Uint8Array) {\n    return value\n  }\n\n  // Handle byte arrays (byte[N] or byte[])\n  if (\n    (type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType) &&\n    type.childType instanceof ABIByteType &&\n    Array.isArray(value)\n  ) {\n    return new Uint8Array(value as number[])\n  }\n\n  // Handle other arrays (for nested structures)\n  if ((type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType) && Array.isArray(value)) {\n    const result = []\n    for (let i = 0; i < value.length; i++) {\n      result.push(convertAbiByteArrays(value[i], type.childType))\n    }\n    return result\n  }\n\n  // Handle tuples (for nested structures)\n  if (type instanceof ABITupleType && Array.isArray(value)) {\n    const result = []\n    for (let i = 0; i < value.length && i < type.childTypes.length; i++) {\n      result.push(convertAbiByteArrays(value[i], type.childTypes[i]))\n    }\n    return result\n  }\n\n  // For other types, return the value as is\n  return value\n}\n\n/**\n * Convert bigint values to numbers for uint types with bit size < 53\n */\nexport const convertABIDecodedBigIntToNumber = (value: ABIValue, type: ABIType): ABIValue => {\n  if (typeof value === 'bigint') {\n    if (type instanceof ABIUintType) {\n      return type.bitSize < 53 ? Number(value) : value\n    } else {\n      return value\n    }\n  } else if (Array.isArray(value) && (type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType)) {\n    return value.map((v) => convertABIDecodedBigIntToNumber(v, type.childType))\n  } else if (Array.isArray(value) && type instanceof ABITupleType) {\n    return value.map((v, i) => convertABIDecodedBigIntToNumber(v, type.childTypes[i]))\n  } else {\n    return value\n  }\n}\n"],"mappings":"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"}