@algorandfoundation/algokit-utils 9.2.0 → 10.0.0-alpha.10

package/util.js

@@ -1,156 +1,82 @@
-'use strict';
-
-var algosdk = require('algosdk');
-var types_app = require('./types/app.js');
+const require_app = require('./types/app.js');
 
+//#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);
-};
-/** 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;
-}
-/**
- * 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;
-    }
+	return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / require_app.APP_PAGE_MAX_SIZE);
 };
 
-exports.UnsafeConversionError = UnsafeConversionError;
+//#endregion
 exports.asJson = asJson;
 exports.binaryStartsWith = binaryStartsWith;
 exports.calculateExtraProgramPages = calculateExtraProgramPages;
 exports.calculateFundAmount = calculateFundAmount;
 exports.chunkArray = chunkArray;
-exports.convertABIDecodedBigIntToNumber = convertABIDecodedBigIntToNumber;
-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"],"sources":["../src/util.ts"],"sourcesContent":["import { 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"],"mappings":";;;;;;;;;AAQA,MAAa,YAAY,UAA2B;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,QAAQ,OAAO,OAAO,iBAAiB,CACzC,OAAM,IAAI,sBACR,kBAAkB,MAAM,sFACzB;UACQ,QAAQ,OAAO,OAAO,iBAAiB,CAChD,OAAM,IAAI,sBACR,kBAAkB,MAAM,uFACzB;AAEH,QAAO,OAAO,MAAM;;AAGtB,IAAa,wBAAb,cAA2C,MAAM;;;;;;;;AASjD,MAAa,uBACX,oBACA,wBACA,wBACkB;AAClB,KAAI,qBAAqB,wBAAwB;EAC/C,MAAM,gBAAgB,qBAAqB;AAC3C,SAAO,OAAO,KAAK,IAAI,OAAO,cAAc,EAAE,OAAO,oBAAoB,CAAC,CAAC;OAE3E,QAAO;;;;;;;;AAmBX,UAAiB,WAAc,OAAY,WAAyC;AAClF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,UAAW,OAAM,MAAM,MAAM,GAAG,IAAI,UAAU;;;;;;;AAQvF,MAAa,WAAqC,OAAsB;CACtE,MAAM,wBAAQ,IAAI,KAAK;CACvB,MAAM,SAAS,SAAyB,KAAQ;AAC9C,SAAO,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;;AAE/F,QAAO,QAAQ;AACf,QAAO;;AAGT,MAAa,oBAAoB,MAAkB,eAAoC;AACrF,KAAI,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,KAAK,OAAO,WAAW,GAAI,QAAO;AAExC,QAAO;;AAGT,MAAa,4BAA4B,KAAa,UAAmB;AACvE,KAAI,OAAO,UAAU,SACnB,KAAI;AACF,SAAO,SAAS,MAAM;SAChB;AACN,SAAO,MAAM,UAAU;;AAG3B,QAAO;;AAET,MAAa,UACX,OACA,WAAqD,0BACrD,UACG;AACH,QAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;;AAI/C,MAAa,8BAA8B,iBAA6B,sBAA2C;AACjH,QAAO,KAAK,OAAO,gBAAgB,UAAU,mBAAmB,UAAU,KAAK,KAAKA,8BAAkB"}

package/util.mjs

@@ -1,144 +1,75 @@
-import { ABIArrayStaticType, ABIArrayDynamicType, ABIByteType, ABITupleType, ABIUintType } from 'algosdk';
-import { APP_PAGE_MAX_SIZE } from './types/app.mjs';
+import { APP_PAGE_MAX_SIZE } from "./types/app.mjs";
 
+//#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) / 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 ABIArrayStaticType || type instanceof ABIArrayDynamicType) &&
-        type.childType instanceof ABIByteType &&
-        Array.isArray(value)) {
-        return new Uint8Array(value);
-    }
-    // Handle other arrays (for nested structures)
-    if ((type instanceof ABIArrayStaticType || type instanceof 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 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;
-}
-/**
- * Convert bigint values to numbers for uint types with bit size < 53
- */
-const convertABIDecodedBigIntToNumber = (value, type) => {
-    if (typeof value === 'bigint') {
-        if (type instanceof ABIUintType) {
-            return type.bitSize < 53 ? Number(value) : value;
-        }
-        else {
-            return value;
-        }
-    }
-    else if (Array.isArray(value) && (type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType)) {
-        return value.map((v) => convertABIDecodedBigIntToNumber(v, type.childType));
-    }
-    else if (Array.isArray(value) && type instanceof ABITupleType) {
-        return value.map((v, i) => convertABIDecodedBigIntToNumber(v, type.childTypes[i]));
-    }
-    else {
-        return value;
-    }
+	return Math.floor((approvalProgram.length + (clearStateProgram?.length ?? 0) - 1) / APP_PAGE_MAX_SIZE);
 };
 
-export { UnsafeConversionError, asJson, binaryStartsWith, calculateExtraProgramPages, calculateFundAmount, chunkArray, convertABIDecodedBigIntToNumber, convertAbiByteArrays, defaultJsonValueReplacer, memoize, toNumber };
-//# sourceMappingURL=util.mjs.map
+//#endregion
+export { asJson, binaryStartsWith, calculateExtraProgramPages, calculateFundAmount, chunkArray, defaultJsonValueReplacer, memoize, toNumber };
+//# sourceMappingURL=util.mjs.map

package/util.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"util.mjs","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":[],"mappings":";;;AAGA;;;;;AAKG;AACU,MAAA,QAAQ,GAAG,CAAC,KAAsB,KAAI;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAE,QAAA,OAAO,KAAK;IAE3C,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;AAC3C,QAAA,MAAM,IAAI,qBAAqB,CAC7B,kBAAkB,KAAK,CAAA,oFAAA,CAAsF,CAC9G;;SACI,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;AAClD,QAAA,MAAM,IAAI,qBAAqB,CAC7B,kBAAkB,KAAK,CAAA,qFAAA,CAAuF,CAC/G;;AAEH,IAAA,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB;AAEM,MAAO,qBAAsB,SAAQ,KAAK,CAAA;AAAG;AAEnD;;;;;;AAMG;AACU,MAAA,mBAAmB,GAAG,CACjC,kBAA0B,EAC1B,sBAA8B,EAC9B,mBAA2B,KACV;AACjB,IAAA,IAAI,kBAAkB,GAAG,sBAAsB,EAAE;AAC/C,QAAA,MAAM,aAAa,GAAG,kBAAkB,GAAG,sBAAsB;AACjE,QAAA,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;;SACtE;AACL,QAAA,OAAO,IAAI;;AAEf;AAWA;;;;;AAKG;UACc,UAAU,CAAI,KAAU,EAAE,SAAiB,EAAA;AAC1D,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS;QAAE,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;AACvF;AAEA;;;;AAIG;AACU,MAAA,OAAO,GAAG,CAA2B,EAAiB,KAAI;AACrE,IAAA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE;IACvB,MAAM,MAAM,GAAG,UAAyB,GAAM,EAAA;AAC5C,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;AAC/F,KAAC;AACD,IAAA,MAAM,CAAC,KAAK,GAAG,KAAK;AACpB,IAAA,OAAO,MAAuB;AAChC;MAEa,gBAAgB,GAAG,CAAC,IAAgB,EAAE,UAAsB,KAAa;AACpF,IAAA,IAAI,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;AAAE,QAAA,OAAO,KAAK;AACjD,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC1C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC;AAAE,YAAA,OAAO,KAAK;;AAE7C,IAAA,OAAO,IAAI;AACb;MAEa,wBAAwB,GAAG,CAAC,GAAW,EAAE,KAAc,KAAI;AACtE,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,QAAA,IAAI;AACF,YAAA,OAAO,QAAQ,CAAC,KAAK,CAAC;;AACtB,QAAA,MAAM;AACN,YAAA,OAAO,KAAK,CAAC,QAAQ,EAAE;;;AAG3B,IAAA,OAAO,KAAK;AACd;AACO,MAAM,MAAM,GAAG,CACpB,KAAc,EACd,QAAA,GAAqD,wBAAwB,EAC7E,KAAuB,KACrB;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC;AAC/C;AAEA;MACa,0BAA0B,GAAG,CAAC,eAA2B,EAAE,iBAA8B,KAAY;IAChH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,MAAM,IAAI,iBAAiB,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC;AACxG;AAEA;AACgB,SAAA,oBAAoB,CAAC,KAAe,EAAE,IAAmB,EAAA;;AAEvE,IAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,UAAU,EAAE;AACpE,QAAA,OAAO,KAAK;;;IAId,IACE,CAAC,IAAI,YAAY,kBAAkB,IAAI,IAAI,YAAY,mBAAmB;QAC1E,IAAI,CAAC,SAAS,YAAY,WAAW;AACrC,QAAA,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpB;AACA,QAAA,OAAO,IAAI,UAAU,CAAC,KAAiB,CAAC;;;AAI1C,IAAA,IAAI,CAAC,IAAI,YAAY,kBAAkB,IAAI,IAAI,YAAY,mBAAmB,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACvG,MAAM,MAAM,GAAG,EAAE;AACjB,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACrC,YAAA,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;;AAE7D,QAAA,OAAO,MAAM;;;IAIf,IAAI,IAAI,YAAY,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxD,MAAM,MAAM,GAAG,EAAE;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;AACnE,YAAA,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;;AAEjE,QAAA,OAAO,MAAM;;;AAIf,IAAA,OAAO,KAAK;AACd;AAEA;;AAEG;MACU,+BAA+B,GAAG,CAAC,KAAe,EAAE,IAAa,KAAc;AAC1F,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,QAAA,IAAI,IAAI,YAAY,WAAW,EAAE;AAC/B,YAAA,OAAO,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK;;aAC3C;AACL,YAAA,OAAO,KAAK;;;AAET,SAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,YAAY,kBAAkB,IAAI,IAAI,YAAY,mBAAmB,CAAC,EAAE;AAC9G,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,+BAA+B,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;;SACtE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,YAAY,YAAY,EAAE;QAC/D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,+BAA+B,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;;SAC7E;AACL,QAAA,OAAO,KAAK;;AAEhB;;;;"}
+{"version":3,"file":"util.mjs","names":[],"sources":["../src/util.ts"],"sourcesContent":["import { 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"],"mappings":";;;;;;;;;AAQA,MAAa,YAAY,UAA2B;AAClD,KAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,KAAI,QAAQ,OAAO,OAAO,iBAAiB,CACzC,OAAM,IAAI,sBACR,kBAAkB,MAAM,sFACzB;UACQ,QAAQ,OAAO,OAAO,iBAAiB,CAChD,OAAM,IAAI,sBACR,kBAAkB,MAAM,uFACzB;AAEH,QAAO,OAAO,MAAM;;AAGtB,IAAa,wBAAb,cAA2C,MAAM;;;;;;;;AASjD,MAAa,uBACX,oBACA,wBACA,wBACkB;AAClB,KAAI,qBAAqB,wBAAwB;EAC/C,MAAM,gBAAgB,qBAAqB;AAC3C,SAAO,OAAO,KAAK,IAAI,OAAO,cAAc,EAAE,OAAO,oBAAoB,CAAC,CAAC;OAE3E,QAAO;;;;;;;;AAmBX,UAAiB,WAAc,OAAY,WAAyC;AAClF,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,UAAW,OAAM,MAAM,MAAM,GAAG,IAAI,UAAU;;;;;;;AAQvF,MAAa,WAAqC,OAAsB;CACtE,MAAM,wBAAQ,IAAI,KAAK;CACvB,MAAM,SAAS,SAAyB,KAAQ;AAC9C,SAAO,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,IAAI;;AAE/F,QAAO,QAAQ;AACf,QAAO;;AAGT,MAAa,oBAAoB,MAAkB,eAAoC;AACrF,KAAI,WAAW,SAAS,KAAK,OAAQ,QAAO;AAC5C,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,QAAQ,IACrC,KAAI,KAAK,OAAO,WAAW,GAAI,QAAO;AAExC,QAAO;;AAGT,MAAa,4BAA4B,KAAa,UAAmB;AACvE,KAAI,OAAO,UAAU,SACnB,KAAI;AACF,SAAO,SAAS,MAAM;SAChB;AACN,SAAO,MAAM,UAAU;;AAG3B,QAAO;;AAET,MAAa,UACX,OACA,WAAqD,0BACrD,UACG;AACH,QAAO,KAAK,UAAU,OAAO,UAAU,MAAM;;;AAI/C,MAAa,8BAA8B,iBAA6B,sBAA2C;AACjH,QAAO,KAAK,OAAO,gBAAgB,UAAU,mBAAmB,UAAU,KAAK,KAAK,kBAAkB"}

package/account/account.d.ts

@@ -1,144 +0,0 @@
-import algosdk from 'algosdk';
-import { AccountAssetInformation, MultisigAccount, SigningAccount, TransactionSignerAccount } from '../types/account';
-import { AlgoAmount } from '../types/amount';
-import { SendTransactionFrom } from '../types/transaction';
-import Account = algosdk.Account;
-import Algodv2 = algosdk.Algodv2;
-import Kmd = algosdk.Kmd;
-import MultisigMetadata = algosdk.MultisigMetadata;
-import TransactionSigner = algosdk.TransactionSigner;
-import AccountInformationModel = algosdk.modelsv2.Account;
-/**
- * @deprecated Use `algorand.account.multisig(multisigParams, signingAccounts)` or `new MultisigAccount(multisigParams, signingAccounts)` instead.
- *
- * Returns an account wrapper that supports partial or full multisig signing.
- * @param multisigParams The parameters that define the multisig account
- * @param signingAccounts The signers that are currently present
- * @returns A multisig account wrapper
- */
-export declare function multisigAccount(multisigParams: MultisigMetadata, signingAccounts: (Account | SigningAccount)[]): MultisigAccount;
-/**
- * @deprecated Use `algorand.account.rekeyed(sender, account)` or `new SigningAccount(account, sender)` instead.
- *
- * Returns an account wrapper that supports a rekeyed account.
- * @param signer The account, with private key loaded, that is signing
- * @param sender The address of the rekeyed account that will act as a sender
- * @returns The SigningAccount wrapper
- */
-export declare function rekeyedAccount(signer: Account, sender: string): SigningAccount;
-/**
- * @deprecated Use `algorand.account.getSigner(sender)` (after previously registering the signer with `setSigner`) or `{ addr: sender, signer }` instead.
- *
- * Returns an account wrapper that supports a transaction signer with associated sender address.
- * @param signer The transaction signer
- * @param sender The address of sender account
- * @returns The SigningAccount wrapper
- */
-export declare function transactionSignerAccount(signer: TransactionSigner, sender: string): TransactionSignerAccount;
-/**
- * @deprecated Use `algorand.account.random()` or `algosdk.generateAccount()` instead.
- *
- * Returns a new, random Algorand account with secret key loaded.
- *
- * This is a wrapper around algosdk.generateAccount to provide a more friendly/obvious name.
- *
- */
-export declare function randomAccount(): Account;
-/**
- * @deprecated Use `algorand.account.fromEnvironment(name, fundWith)` or `new AccountManager(clientManager).fromEnvironment()` instead.
- *
- * Returns an Algorand account with private key loaded by convention from environment variables based on the given name identifier.
- *
- * Note: This function expects to run in a Node.js environment.
- *
- * ## Convention:
- * * **Non-LocalNet:** will load process.env['\{NAME\}_MNEMONIC'] as a mnemonic secret; **Note: Be careful how the mnemonic is handled**,
- *  never commit it into source control and ideally load it via a secret storage service rather than the file system.
- *   If process.env['\{NAME\}_SENDER'] is defined then it will use that for the sender address (i.e. to support rekeyed accounts)
- * * **LocalNet:** will load the account from a KMD wallet called \{NAME\} and if that wallet doesn't exist it will create it and fund the account for you
- *
- * This allows you to write code that will work seamlessly in production and local development (LocalNet) without manual config locally (including when you reset the LocalNet).
- *
- * @example Default
- *
- * If you have a mnemonic secret loaded into `process.env.MY_ACCOUNT_MNEMONIC` then you can call the following to get that private key loaded into an account object:
- * ```typescript
- * const account = await mnemonicAccountFromEnvironment('MY_ACCOUNT', algod)
- * ```
- *
- * If that code runs against LocalNet then a wallet called `MY_ACCOUNT` will automatically be created with an account that is automatically funded with 1000 (default) ALGO from the default LocalNet dispenser.
- * If not running against LocalNet then it will use proces.env.MY_ACCOUNT_MNEMONIC as the private key and (if present) process.env.MY_ACCOUNT_SENDER as the sender address.
- *
- * @param account The details of the account to get, either the name identifier (string) or an object with:
- *   * `name`: string: The name identifier of the account
- *   * `fundWith`: The amount to fund the account with when it gets created (when targeting LocalNet), if not specified then 1000 ALGO will be funded from the dispenser account
- * @param algod An algod client
- * @param kmdClient An optional KMD client to use to create an account (when targeting LocalNet), if not specified then a default KMD client will be loaded from environment variables
- * @returns The requested account with private key loaded from the environment variables or when targeting LocalNet from KMD (idempotently creating and funding the account)
- */
-export declare function mnemonicAccountFromEnvironment(account: string | {
-    name: string;
-    fundWith?: AlgoAmount;
-}, algod: Algodv2, kmdClient?: Kmd): Promise<Account | SigningAccount>;
-/**
- * @deprecated Use `algosdk.decodeAddress` instead.
- *
- * Returns an account's address as a byte array
- *
- * @param account Either an account (with private key loaded) or the string address of an account
- */
-export declare function getAccountAddressAsUint8Array(account: SendTransactionFrom | string): Uint8Array;
-/**
- * @deprecated Use `algosdk.encodeAddress` instead.
- *
- * Returns the string address of an Algorand account from a base64 encoded version of the underlying byte array of the address public key
- *
- * @param addressEncodedInB64 The base64 encoded version of the underlying byte array of the address public key
- */
-export declare function getAccountAddressAsString(addressEncodedInB64: string): string;
-export type NumberConverter<T extends AccountInformationModel> = {
-    [key in keyof T]: ToNumberIfExtends<T[key], number | bigint>;
-};
-type ToNumberIfExtends<K, E> = K extends E ? number : K;
-/** @deprecated Account information at a given round. */
-export type AccountInformation = Omit<NumberConverter<AccountInformationModel>, 'getEncodingSchema' | 'toEncodingData' | 'authAddr'> & {
-    /** (spend) the address against which signing should be checked. If empty, the address of the current account is used. This field can be updated in any transaction by setting the RekeyTo field. */
-    authAddr?: string;
-};
-/**
- * @deprecated Use `algorand.account.getInformation(sender)` or `new AccountManager(clientManager).getInformation(sender)` instead.
- *
- * Returns the given sender account's current status, balance and spendable amounts.
- *
- * @example
- * ```typescript
- * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
- * const accountInfo = await account.getInformation(address, algod);
- * ```
- *
- * [Response data schema details](https://dev.algorand.co/reference/rest-apis/algod/#accountinformation)
- * @param sender The address of the sender/account to look up
- * @param algod The algod instance
- * @returns The account information
- */
-export declare function getAccountInformation(sender: string | SendTransactionFrom, algod: Algodv2): Promise<AccountInformation>;
-/**
- * @deprecated Use `algorand.asset.getAccountInformation(sender, assetId)` or `new AssetManager(...).getAccountInformation(sender, assetId)` instead.
- *
- * Returns the given sender account's asset holding for a given asset.
- *
- * @example
- * ```typescript
- * const address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA";
- * const assetId = 123345;
- * const accountInfo = await account.getAccountAssetInformation(address, assetId, algod);
- * ```
- *
- * [Response data schema details](https://dev.algorand.co/reference/rest-apis/algod/#accountassetinformation)
- * @param sender The address of the sender/account to look up
- * @param assetId The ID of the asset to return a holding for
- * @param algod The algod instance
- * @returns The account asset holding information
- */
-export declare function getAccountAssetInformation(sender: string | SendTransactionFrom, assetId: number | bigint, algod: Algodv2): Promise<AccountAssetInformation>;
-export {};