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

package/util.mjs

@@ -1,144 +1,101 @@
-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";
+import { ABIArrayDynamicType, ABIArrayStaticType, ABIByteType, ABITupleType, ABIUintType } from "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) / APP_PAGE_MAX_SIZE);
+	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;
+	if (!type.toString().includes("byte") || value instanceof Uint8Array) return value;
+	if ((type instanceof ABIArrayStaticType || type instanceof ABIArrayDynamicType) && type.childType instanceof ABIByteType && Array.isArray(value)) return new Uint8Array(value);
+	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;
+	}
+	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;
+	}
+	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 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;
-    }
+	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;
 };
-
+//#endregion
 export { UnsafeConversionError, asJson, binaryStartsWith, calculateExtraProgramPages, calculateFundAmount, chunkArray, convertABIDecodedBigIntToNumber, convertAbiByteArrays, defaultJsonValueReplacer, memoize, toNumber };
-//# sourceMappingURL=util.mjs.map
+
+//# 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":"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"}
+{"version":3,"file":"util.mjs","names":[],"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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"}

package/account/index.d.ts

@@ -1,5 +0,0 @@
-export * from './account';
-export * from './get-account';
-export * from './get-account-config-from-environment';
-export * from './get-dispenser-account';
-export * from './mnemonic-account';

package/debugging/index.d.ts

@@ -1 +0,0 @@
-export * from './debugging';

package/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/localnet/index.d.ts

@@ -1,4 +0,0 @@
-export * from './get-kmd-wallet-account';
-export * from './get-localnet-dispenser-account';
-export * from './get-or-create-kmd-wallet-account';
-export * from './is-localnet';

package/testing/_asset.d.ts

@@ -1,3 +0,0 @@
-import { Address } from 'algosdk';
-import { AlgorandClient } from '../types/algorand-client';
-export declare function generateTestAsset(algorand: AlgorandClient, sender: Address | string, total?: number): Promise<bigint>;

package/testing/fixtures/index.d.ts

@@ -1,2 +0,0 @@
-export * from './algokit-log-capture-fixture';
-export * from './algorand-fixture';

package/testing/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/testing/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/transaction/index.d.ts

@@ -1,2 +0,0 @@
-export * from './perform-atomic-transaction-composer-simulate';
-export * from './transaction';

package/transaction/legacy-bridge.d.ts

@@ -1,35 +0,0 @@
-import algosdk from 'algosdk';
-import { AlgorandClientTransactionCreator } from '../types/algorand-client-transaction-creator';
-import { AlgorandClientTransactionSender } from '../types/algorand-client-transaction-sender';
-import { ABIAppCallArgs, BoxIdentifier as LegacyBoxIdentifier, BoxReference as LegacyBoxReference, RawAppCallArgs } from '../types/app';
-import { AppCallMethodCall, AppCallParams, AppCreateMethodCall, AppCreateParams, AppDeleteMethodCall, AppDeleteParams, AppUpdateMethodCall, AppUpdateParams, BuiltTransactions, CommonTransactionParams } from '../types/composer';
-import { SendParams, SendSingleTransactionResult, SendTransactionFrom, SendTransactionParams, SendTransactionResult, TransactionNote } from '../types/transaction';
-import Algodv2 = algosdk.Algodv2;
-import Transaction = algosdk.Transaction;
-/** @deprecated Bridges between legacy `sendTransaction` behaviour and new `AlgorandClient` behaviour. */
-export declare function legacySendTransactionBridge<T extends CommonTransactionParams, TResult extends SendSingleTransactionResult>(algod: Algodv2, from: SendTransactionFrom, sendParams: SendTransactionParams, params: T, txn: ((c: AlgorandClientTransactionCreator) => (params: T) => Promise<Transaction>) | ((c: AlgorandClientTransactionCreator) => (params: T) => Promise<BuiltTransactions>), send: (c: AlgorandClientTransactionSender) => (params: T & SendParams) => Promise<TResult>, suggestedParams?: algosdk.SuggestedParams): Promise<(SendTransactionResult | TResult) & {
-    transactions: Transaction[];
-}>;
-/** @deprecated Bridges between legacy `sendTransaction` behaviour for app transactions and new `AlgorandClient` behaviour. */
-export declare function legacySendAppTransactionBridge<T extends AppCreateParams | AppUpdateParams | AppDeleteParams | AppCallParams | AppCreateMethodCall | AppUpdateMethodCall | AppDeleteMethodCall | AppCallMethodCall, TResult extends SendSingleTransactionResult>(algod: Algodv2, from: SendTransactionFrom, appArgs: RawAppCallArgs | ABIAppCallArgs | undefined, sendParams: SendTransactionParams & {
-    note?: TransactionNote;
-}, params: Omit<T, 'accountReferences' | 'appReferences' | 'assetReferences' | 'boxReferences' | 'args' | 'lease' | 'rekeyTo' | 'note'>, txn: ((c: AlgorandClientTransactionCreator) => (params: T) => Promise<Transaction>) | ((c: AlgorandClientTransactionCreator) => (params: T) => Promise<BuiltTransactions>), send: (c: AlgorandClientTransactionSender) => (params: T & SendParams) => Promise<TResult>, suggestedParams?: algosdk.SuggestedParams): Promise<(SendTransactionResult | TResult) & {
-    transactions: Transaction[];
-}>;
-/**
- * @deprecated
- */
-export declare function _getAppArgsForABICall(args: ABIAppCallArgs, from: SendTransactionFrom): Promise<{
-    method: algosdk.ABIMethod;
-    sender: string;
-    signer: algosdk.TransactionSigner;
-    boxes: algosdk.BoxReference[] | undefined;
-    lease: Uint8Array | undefined;
-    appForeignApps: number[] | undefined;
-    appForeignAssets: number[] | undefined;
-    appAccounts: string[] | undefined;
-    methodArgs: (string | number | bigint | boolean | algosdk.Address | Uint8Array | algosdk.ABIValue[] | algosdk.TransactionWithSigner)[];
-    rekeyTo: string | undefined;
-}>;
-/** @deprecated */
-export declare function _getBoxReference(box: LegacyBoxIdentifier | LegacyBoxReference | algosdk.BoxReference): algosdk.BoxReference;

package/transfer/index.d.ts

@@ -1,2 +0,0 @@
-export * from './transfer';
-export * from './transfer-algos';

package/types/asset.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/types/asset.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"asset.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/types/expand.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"expand.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/types/expand.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"expand.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/types/instance-of.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"instance-of.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/types/instance-of.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"instance-of.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/types/testing.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/types/testing.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"testing.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/types/transaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/types/transaction.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"transaction.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/types/transfer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transfer.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/types/transfer.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"transfer.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/util.d.ts

@@ -1,48 +0,0 @@
-import { ABIReturnType, ABIType, ABIValue } from 'algosdk';
-/**
- * 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
- */
-export declare const toNumber: (value: number | bigint) => number;
-export declare class UnsafeConversionError 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
- */
-export declare const calculateFundAmount: (minSpendingBalance: bigint, currentSpendingBalance: bigint, minFundingIncrement: bigint) => bigint | null;
-/**
- * Checks if the current environment is Node.js
- *
- * @returns A boolean indicating whether the current environment is Node.js
- */
-export declare const isNode: () => boolean;
-/**
- * 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
- */
-export declare function chunkArray<T>(array: T[], batchSize: number): Generator<T[], void>;
-/**
- * Memoize calls to the given function in an in-memory map.
- * @param fn The function to memoize
- * @returns The memoized function
- */
-export declare const memoize: <T = unknown, R = unknown>(fn: (val: T) => R) => (val: T) => R;
-export declare const binaryStartsWith: (base: Uint8Array, startsWith: Uint8Array) => boolean;
-export declare const defaultJsonValueReplacer: (key: string, value: unknown) => unknown;
-export declare const asJson: (value: unknown, replacer?: (key: string, value: unknown) => unknown, space?: string | number) => string;
-/** Calculate minimum number of extra program pages required for provided approval and clear state programs */
-export declare const calculateExtraProgramPages: (approvalProgram: Uint8Array, clearStateProgram?: Uint8Array) => number;
-/** Take a decoded ABI value and convert all byte arrays (including nested ones) from number[] to Uint8Arrays */
-export declare function convertAbiByteArrays(value: ABIValue, type: ABIReturnType): ABIValue;
-/**
- * Convert bigint values to numbers for uint types with bit size < 53
- */
-export declare const convertABIDecodedBigIntToNumber: (value: ABIValue, type: ABIType) => ABIValue;