@algorandfoundation/algokit-utils 10.0.0-alpha.4 → 10.0.0-alpha.41

package/packages/transact/src/transactions/transaction.mjs

@@ -2,8 +2,8 @@ import { concatArrays } from "../../../common/src/array.mjs";
 import { MAX_TRANSACTION_GROUP_SIZE, SIGNATURE_ENCODING_INCR, TRANSACTION_DOMAIN_SEPARATOR, TRANSACTION_GROUP_DOMAIN_SEPARATOR, TRANSACTION_ID_LENGTH } from "../../../common/src/constants.mjs";
 import { Address } from "../../../common/src/address.mjs";
 import { Codec } from "../../../common/src/codecs/codec.mjs";
-import { hash } from "../../../common/src/crypto.mjs";
 import { decodeMsgpack, encodeMsgpack } from "../../../common/src/msgpack.mjs";
+import { hash } from "../../../crypto/src/hash.mjs";
 import { getValidationErrorMessage } from "./common.mjs";
 import { validateAppCallTransaction } from "./app-call.mjs";
 import { validateAssetConfigTransaction } from "./asset-config.mjs";
@@ -145,6 +145,7 @@ var Transaction = class {
 		this.stateProof = params.stateProof;
 	}
 	rawTxId() {
+		if (this.genesisHash === void 0) throw new Error("Cannot compute transaction id without genesis hash");
 		return hash(encodeTransaction(this));
 	}
 	/**
@@ -154,10 +155,11 @@ var Transaction = class {
 		const rawTxId = this.rawTxId();
 		return base32.encode(rawTxId).slice(0, TRANSACTION_ID_LENGTH);
 	}
-	static [Symbol.hasInstance](obj) {
-		return Boolean(obj && typeof obj === "object" && TXN_SYMBOL in obj && obj[TXN_SYMBOL]);
-	}
 };
+Object.defineProperty(Transaction, Symbol.hasInstance, { value: function(obj) {
+	if (obj instanceof Object && Object.getPrototypeOf(obj) === Transaction.prototype) return true;
+	return Boolean(obj && typeof obj === "object" && TXN_SYMBOL in obj && obj[TXN_SYMBOL]);
+} });
 /**
 * Codec for Transaction class.
 * Handles encoding/decoding between Transaction class instances and wire format.
@@ -250,7 +252,6 @@ function validateTransaction(transaction) {
 * This is useful for encoding the transaction for signing with tools that automatically add "TX" prefix to the transaction bytes.
 */
 function encodeTransactionRaw(transaction) {
-	validateTransaction(transaction);
 	return encodeMsgpack(transactionCodec.encode(transaction, "msgpack"));
 }
 /**

package/packages/transact/src/transactions/transaction.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/transaction.ts"],"sourcesContent":["import type { EncodingFormat, WireObject } from '@algorandfoundation/algokit-common'\nimport {\n  Address,\n  Codec,\n  MAX_TRANSACTION_GROUP_SIZE,\n  SIGNATURE_ENCODING_INCR,\n  TRANSACTION_DOMAIN_SEPARATOR,\n  TRANSACTION_GROUP_DOMAIN_SEPARATOR,\n  TRANSACTION_ID_LENGTH,\n  concatArrays,\n  decodeMsgpack,\n  encodeMsgpack,\n  hash,\n} from '@algorandfoundation/algokit-common'\nimport base32 from 'hi-base32'\nimport { AppCallTransactionFields, validateAppCallTransaction } from './app-call'\nimport { AssetConfigTransactionFields, validateAssetConfigTransaction } from './asset-config'\nimport { AssetFreezeTransactionFields, validateAssetFreezeTransaction } from './asset-freeze'\nimport { AssetTransferTransactionFields, validateAssetTransferTransaction } from './asset-transfer'\nimport { TransactionValidationError, getValidationErrorMessage } from './common'\nimport { HeartbeatTransactionFields } from './heartbeat'\nimport { KeyRegistrationTransactionFields, validateKeyRegistrationTransaction } from './key-registration'\nimport { PaymentTransactionFields } from './payment'\nimport { StateProofTransactionFields } from './state-proof'\nimport { transactionParamsCodec } from './transaction-meta'\nimport { TransactionType } from './transaction-type'\n\n/** Symbol used for instanceof checks across packages (CJS/ESM) */\nexport const TXN_SYMBOL = Symbol.for('algokit_transact:Transaction')\n\n/**\n * Represents the parameters for a complete Algorand transaction.\n *\n * This structure contains the fields that are present in every transaction,\n * regardless of transaction type, plus transaction-type-specific fields.\n */\nexport type TransactionParams = {\n  /**\n   * The type of transaction\n   */\n  type: TransactionType\n\n  /**\n   * The account that authorized the transaction.\n   *\n   * Fees are deducted from this account.\n   */\n  sender: Address\n\n  /**\n   * Optional transaction fee in microALGO.\n   *\n   * When not set, the fee will be interpreted as 0 by the network.\n   */\n  fee?: bigint\n\n  /**\n   * First round for when the transaction is valid.\n   */\n  firstValid: bigint\n\n  /**\n   * Last round for when the transaction is valid.\n   *\n   * After this round, the transaction will be expired.\n   */\n  lastValid: bigint\n\n  /**\n   * Hash of the genesis block of the network.\n   *\n   * Used to identify which network the transaction is for.\n   */\n  genesisHash?: Uint8Array\n\n  /**\n   * Genesis ID of the network.\n   *\n   * A human-readable string used alongside genesis hash to identify the network.\n   */\n  genesisId?: string\n\n  /**\n   * Optional user-defined note field.\n   *\n   * Can contain arbitrary data up to 1KB in size.\n   */\n  note?: Uint8Array\n\n  /**\n   * Optional authorized account for future transactions.\n   *\n   * If set, only this account will be used for transaction authorization going forward.\n   * Reverting back control to the original address must be done by setting this field to\n   * the original address.\n   */\n  rekeyTo?: Address\n\n  /**\n   * Optional lease value to enforce mutual transaction exclusion.\n   *\n   * When a transaction with a non-empty lease field is confirmed, the lease is acquired.\n   * A lease X is acquired by the sender, generating the (sender, X) lease.\n   * The lease is kept active until the last_valid round of the transaction has elapsed.\n   * No other transaction sent by the same sender can be confirmed until the lease expires.\n   */\n  lease?: Uint8Array\n\n  /**\n   * Optional group ID for atomic transaction grouping.\n   *\n   * Transactions with the same group ID must execute together or not at all.\n   */\n  group?: Uint8Array\n\n  /**\n   * Payment specific fields\n   */\n  payment?: PaymentTransactionFields\n\n  /**\n   * Asset transfer specific fields\n   */\n  assetTransfer?: AssetTransferTransactionFields\n\n  /**\n   * Asset config specific fields\n   */\n  assetConfig?: AssetConfigTransactionFields\n\n  /**\n   * App call specific fields\n   */\n  appCall?: AppCallTransactionFields\n\n  /**\n   * Key registration specific fields\n   */\n  keyRegistration?: KeyRegistrationTransactionFields\n\n  /**\n   * Asset freeze specific fields\n   */\n  assetFreeze?: AssetFreezeTransactionFields\n\n  /**\n   * Heartbeat specific fields\n   */\n  heartbeat?: HeartbeatTransactionFields\n\n  /**\n   * State proof specific fields\n   */\n  stateProof?: StateProofTransactionFields\n}\n\n/**\n * Represents a complete Algorand transaction.\n */\nexport class Transaction implements TransactionParams {\n  /** @internal */\n  [TXN_SYMBOL]: boolean\n\n  /**\n   * The type of transaction\n   */\n  type: TransactionType\n\n  /**\n   * The account that authorized the transaction.\n   *\n   * Fees are deducted from this account.\n   */\n  sender: Address\n\n  /**\n   * Optional transaction fee in microALGO.\n   *\n   * When not set, the fee will be interpreted as 0 by the network.\n   */\n  fee?: bigint\n\n  /**\n   * First round for when the transaction is valid.\n   */\n  firstValid: bigint\n\n  /**\n   * Last round for when the transaction is valid.\n   *\n   * After this round, the transaction will be expired.\n   */\n  lastValid: bigint\n\n  /**\n   * Hash of the genesis block of the network.\n   *\n   * Used to identify which network the transaction is for.\n   */\n  genesisHash?: Uint8Array\n\n  /**\n   * Genesis ID of the network.\n   *\n   * A human-readable string used alongside genesis hash to identify the network.\n   */\n  genesisId?: string\n\n  /**\n   * Optional user-defined note field.\n   *\n   * Can contain arbitrary data up to 1KB in size.\n   */\n  note?: Uint8Array\n\n  /**\n   * Optional authorized account for future transactions.\n   *\n   * If set, only this account will be used for transaction authorization going forward.\n   * Reverting back control to the original address must be done by setting this field to\n   * the original address.\n   */\n  rekeyTo?: Address\n\n  /**\n   * Optional lease value to enforce mutual transaction exclusion.\n   *\n   * When a transaction with a non-empty lease field is confirmed, the lease is acquired.\n   * A lease X is acquired by the sender, generating the (sender, X) lease.\n   * The lease is kept active until the last_valid round of the transaction has elapsed.\n   * No other transaction sent by the same sender can be confirmed until the lease expires.\n   */\n  lease?: Uint8Array\n\n  /**\n   * Optional group ID for atomic transaction grouping.\n   *\n   * Transactions with the same group ID must execute together or not at all.\n   */\n  group?: Uint8Array\n\n  /**\n   * Payment specific fields\n   */\n  payment?: PaymentTransactionFields\n\n  /**\n   * Asset transfer specific fields\n   */\n  assetTransfer?: AssetTransferTransactionFields\n\n  /**\n   * Asset config specific fields\n   */\n  assetConfig?: AssetConfigTransactionFields\n\n  /**\n   * App call specific fields\n   */\n  appCall?: AppCallTransactionFields\n\n  /**\n   * Key registration specific fields\n   */\n  keyRegistration?: KeyRegistrationTransactionFields\n\n  /**\n   * Asset freeze specific fields\n   */\n  assetFreeze?: AssetFreezeTransactionFields\n\n  /**\n   * Heartbeat specific fields\n   */\n  heartbeat?: HeartbeatTransactionFields\n\n  /**\n   * State proof specific fields\n   */\n  stateProof?: StateProofTransactionFields\n\n  constructor(params: TransactionParams) {\n    this[TXN_SYMBOL] = true\n    this.type = params.type\n    this.sender = params.sender\n    this.fee = params.fee\n    this.firstValid = params.firstValid\n    this.lastValid = params.lastValid\n    this.genesisHash = params.genesisHash\n    this.genesisId = params.genesisId\n    this.note = params.note\n    this.rekeyTo = params.rekeyTo\n    this.lease = params.lease\n    this.group = params.group\n    this.payment = params.payment\n    this.assetTransfer = params.assetTransfer\n    this.assetConfig = params.assetConfig\n    this.appCall = params.appCall\n    this.keyRegistration = params.keyRegistration\n    this.assetFreeze = params.assetFreeze\n    this.heartbeat = params.heartbeat\n    this.stateProof = params.stateProof\n  }\n\n  private rawTxId(): Uint8Array {\n    const encodedBytes = encodeTransaction(this)\n    return hash(encodedBytes)\n  }\n\n  /**\n   * Get the transaction ID as a base32-encoded string.\n   */\n  txId(): string {\n    const rawTxId = this.rawTxId()\n\n    return base32.encode(rawTxId).slice(0, TRANSACTION_ID_LENGTH)\n  }\n\n  static [Symbol.hasInstance](obj: unknown) {\n    return Boolean(obj && typeof obj === 'object' && TXN_SYMBOL in obj && obj[TXN_SYMBOL as keyof typeof obj])\n  }\n}\n\n/**\n * Codec for Transaction class.\n * Handles encoding/decoding between Transaction class instances and wire format.\n */\nclass TransactionCodec extends Codec<Transaction, Record<string, unknown>, WireObject> {\n  public defaultValue(): Transaction {\n    return new Transaction({\n      type: TransactionType.Unknown,\n      sender: Address.zeroAddress(),\n      firstValid: 0n,\n      lastValid: 0n,\n    })\n  }\n\n  protected toEncoded(value: Transaction, format: EncodingFormat): Record<string, unknown> {\n    return transactionParamsCodec.encode({ ...value }, format)\n  }\n\n  protected fromEncoded(value: WireObject, format: EncodingFormat): Transaction {\n    const params = transactionParamsCodec.decode(value, format)\n    return new Transaction(params)\n  }\n\n  public isDefaultValue(_: Transaction): boolean {\n    return false\n  }\n}\n\nexport const transactionCodec = new TransactionCodec()\n\nexport type FeeParams = {\n  feePerByte: bigint\n  minFee: bigint\n  extraFee?: bigint\n  maxFee?: bigint\n}\n\n/**\n * Get the transaction type from the encoded transaction.\n * This is particularly useful when decoding a transaction that has an unknown type\n */\nexport function getEncodedTransactionType(encoded_transaction: Uint8Array): TransactionType {\n  const decoded = decodeTransaction(encoded_transaction)\n  return decoded.type\n}\n\n/**\n * Encode the transaction with the domain separation (e.g. \"TX\") prefix\n *\n * @param transaction - The transaction to encode\n * @returns The MsgPack encoded bytes or an error if encoding fails.\n */\nexport function encodeTransaction(transaction: Transaction): Uint8Array {\n  const rawBytes = encodeTransactionRaw(transaction)\n\n  // Add domain separation prefix\n  const prefixBytes = new TextEncoder().encode(TRANSACTION_DOMAIN_SEPARATOR)\n  return concatArrays(prefixBytes, rawBytes)\n}\n\n/**\n * Encode transactions with the domain separation (e.g. \"TX\") prefix\n *\n * @param transactions - A collection of transactions to encode\n * @returns A collection of MsgPack encoded bytes or an error if encoding fails.\n */\nexport function encodeTransactions(transactions: Transaction[]): Uint8Array[] {\n  return transactions.map((tx) => encodeTransaction(tx))\n}\n\n/**\n * Validate a transaction\n */\nexport function validateTransaction(transaction: Transaction): void {\n  // Validate that only one transaction type specific field is set\n  const typeFields = [\n    transaction.payment,\n    transaction.assetTransfer,\n    transaction.assetConfig,\n    transaction.appCall,\n    transaction.keyRegistration,\n    transaction.assetFreeze,\n    transaction.heartbeat,\n    transaction.stateProof,\n  ]\n\n  const setFieldsCount = typeFields.filter((field) => field !== undefined).length\n\n  if (setFieldsCount > 1) {\n    throw new Error('Multiple transaction type specific fields set')\n  }\n\n  // Perform type-specific validation where applicable\n  let typeName = 'Transaction'\n  const errors = new Array<TransactionValidationError>()\n  if (transaction.assetTransfer) {\n    typeName = 'Asset transfer'\n    errors.push(...validateAssetTransferTransaction(transaction.assetTransfer))\n  } else if (transaction.assetConfig) {\n    typeName = 'Asset config'\n    errors.push(...validateAssetConfigTransaction(transaction.assetConfig))\n  } else if (transaction.appCall) {\n    typeName = 'App call'\n    errors.push(...validateAppCallTransaction(transaction.appCall))\n  } else if (transaction.keyRegistration) {\n    typeName = 'Key registration'\n    errors.push(...validateKeyRegistrationTransaction(transaction.keyRegistration))\n  } else if (transaction.assetFreeze) {\n    typeName = 'Asset freeze'\n    errors.push(...validateAssetFreezeTransaction(transaction.assetFreeze))\n  }\n\n  if (errors.length > 0) {\n    const errorMessages = errors.map((e) => getValidationErrorMessage(e))\n    throw new Error(`${typeName} validation failed: ${errorMessages.join('\\n')}`)\n  }\n}\n\n/**\n * Encode the transaction without the domain separation (e.g. \"TX\") prefix\n * This is useful for encoding the transaction for signing with tools that automatically add \"TX\" prefix to the transaction bytes.\n */\nexport function encodeTransactionRaw(transaction: Transaction): Uint8Array {\n  validateTransaction(transaction)\n  const encodingData = transactionCodec.encode(transaction, 'msgpack')\n  return encodeMsgpack(encodingData)\n}\n\n/**\n * Decodes MsgPack bytes into a transaction.\n *\n * # Parameters\n * * `encoded_transaction` - MsgPack encoded bytes representing a transaction.\n *\n * # Returns\n * A decoded transaction or an error if decoding fails.\n */\nexport function decodeTransaction(encoded_transaction: Uint8Array): Transaction {\n  if (encoded_transaction.length === 0) {\n    throw new Error('attempted to decode 0 bytes')\n  }\n\n  const prefixBytes = new TextEncoder().encode(TRANSACTION_DOMAIN_SEPARATOR)\n  // Check if the transaction has the domain separation prefix\n  let hasPrefix = true\n  if (encoded_transaction.length < prefixBytes.length) {\n    hasPrefix = false\n  } else {\n    for (let i = 0; i < prefixBytes.length; i++) {\n      if (encoded_transaction[i] !== prefixBytes[i]) {\n        hasPrefix = false\n        break\n      }\n    }\n  }\n\n  const decodedData = decodeMsgpack(hasPrefix ? encoded_transaction.slice(prefixBytes.length) : encoded_transaction)\n  return transactionCodec.decode(decodedData, 'msgpack')\n}\n\n/**\n * Decodes a collection of MsgPack bytes into a transaction collection.\n *\n * # Parameters\n * * `encoded_transaction` - A collection of MsgPack encoded bytes, each representing a transaction.\n *\n * # Returns\n * A collection of decoded transactions or an error if decoding fails.\n */\nexport function decodeTransactions(encoded_transactions: Uint8Array[]): Transaction[] {\n  return encoded_transactions.map((et) => decodeTransaction(et))\n}\n\n/**\n * Return the size of the transaction in bytes as if it was already signed and encoded.\n * This is useful for estimating the fee for the transaction.\n */\nexport function estimateTransactionSize(transaction: Transaction): bigint {\n  const encoded = encodeTransactionRaw(transaction)\n  return BigInt(encoded.length + SIGNATURE_ENCODING_INCR)\n}\n\n/**\n * Groups a collection of transactions by calculating and assigning the group to each transaction.\n */\nexport function groupTransactions(transactions: Transaction[]): Transaction[] {\n  const group = computeGroup(transactions)\n  return transactions.map(\n    (tx) =>\n      new Transaction({\n        ...tx,\n        group,\n      }),\n  )\n}\n\nexport function assignFee(transaction: Transaction, feeParams: FeeParams): Transaction {\n  const fee = calculateFee(transaction, feeParams)\n  return new Transaction({\n    ...transaction,\n    fee,\n  })\n}\n\nfunction computeGroup(transactions: Transaction[]): Uint8Array {\n  if (transactions.length === 0) {\n    throw new Error('Transaction group size cannot be 0')\n  }\n\n  if (transactions.length > MAX_TRANSACTION_GROUP_SIZE) {\n    throw new Error(`Transaction group size exceeds the max limit of ${MAX_TRANSACTION_GROUP_SIZE}`)\n  }\n\n  const txHashes = transactions.map((tx) => {\n    if (tx.group) {\n      throw new Error('Transactions must not already be grouped')\n    }\n\n    const encodedBytes = encodeTransaction(tx)\n    return hash(encodedBytes)\n  })\n\n  const prefixBytes = new TextEncoder().encode(TRANSACTION_GROUP_DOMAIN_SEPARATOR)\n  const encodedBytes = encodeMsgpack({\n    txlist: txHashes,\n  })\n\n  const prefixedBytes = concatArrays(prefixBytes, encodedBytes)\n  return hash(prefixedBytes)\n}\n\nexport function calculateFee(transaction: Transaction, feeParams: FeeParams): bigint {\n  let calculatedFee = 0n\n\n  if (feeParams.feePerByte > 0n) {\n    const estimatedSize = estimateTransactionSize(transaction)\n    calculatedFee = feeParams.feePerByte * BigInt(estimatedSize)\n  }\n\n  if (calculatedFee < feeParams.minFee) {\n    calculatedFee = feeParams.minFee\n  }\n\n  if (feeParams.extraFee) {\n    calculatedFee += feeParams.extraFee\n  }\n\n  if (feeParams.maxFee && calculatedFee > feeParams.maxFee) {\n    throw new Error(`Transaction fee ${calculatedFee} µALGO is greater than maxFee ${feeParams.maxFee} µALGO`)\n  }\n\n  return calculatedFee\n}\n"],"mappings":"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"}
+{"version":3,"file":"transaction.mjs","names":[],"sources":["../../../../../packages/transact/src/transactions/transaction.ts"],"sourcesContent":["import type { EncodingFormat, WireObject } from '@algorandfoundation/algokit-common'\nimport {\n  Address,\n  Codec,\n  MAX_TRANSACTION_GROUP_SIZE,\n  SIGNATURE_ENCODING_INCR,\n  TRANSACTION_DOMAIN_SEPARATOR,\n  TRANSACTION_GROUP_DOMAIN_SEPARATOR,\n  TRANSACTION_ID_LENGTH,\n  concatArrays,\n  decodeMsgpack,\n  encodeMsgpack,\n} from '@algorandfoundation/algokit-common'\nimport { hash } from '@algorandfoundation/algokit-crypto'\nimport base32 from 'hi-base32'\nimport { AppCallTransactionFields, validateAppCallTransaction } from './app-call'\nimport { AssetConfigTransactionFields, validateAssetConfigTransaction } from './asset-config'\nimport { AssetFreezeTransactionFields, validateAssetFreezeTransaction } from './asset-freeze'\nimport { AssetTransferTransactionFields, validateAssetTransferTransaction } from './asset-transfer'\nimport { TransactionValidationError, getValidationErrorMessage } from './common'\nimport { HeartbeatTransactionFields } from './heartbeat'\nimport { KeyRegistrationTransactionFields, validateKeyRegistrationTransaction } from './key-registration'\nimport { PaymentTransactionFields } from './payment'\nimport { StateProofTransactionFields } from './state-proof'\nimport { transactionParamsCodec } from './transaction-meta'\nimport { TransactionType } from './transaction-type'\n\n/** Symbol used for instanceof checks across packages (CJS/ESM) */\nexport const TXN_SYMBOL = Symbol.for('algokit_transact:Transaction')\n\n/**\n * Represents the parameters for a complete Algorand transaction.\n *\n * This structure contains the fields that are present in every transaction,\n * regardless of transaction type, plus transaction-type-specific fields.\n */\nexport type TransactionParams = {\n  /**\n   * The type of transaction\n   */\n  type: TransactionType\n\n  /**\n   * The account that authorized the transaction.\n   *\n   * Fees are deducted from this account.\n   */\n  sender: Address\n\n  /**\n   * Optional transaction fee in microALGO.\n   *\n   * When not set, the fee will be interpreted as 0 by the network.\n   */\n  fee?: bigint\n\n  /**\n   * First round for when the transaction is valid.\n   */\n  firstValid: bigint\n\n  /**\n   * Last round for when the transaction is valid.\n   *\n   * After this round, the transaction will be expired.\n   */\n  lastValid: bigint\n\n  /**\n   * Hash of the genesis block of the network.\n   *\n   * Used to identify which network the transaction is for.\n   */\n  genesisHash?: Uint8Array\n\n  /**\n   * Genesis ID of the network.\n   *\n   * A human-readable string used alongside genesis hash to identify the network.\n   */\n  genesisId?: string\n\n  /**\n   * Optional user-defined note field.\n   *\n   * Can contain arbitrary data up to 1KB in size.\n   */\n  note?: Uint8Array\n\n  /**\n   * Optional authorized account for future transactions.\n   *\n   * If set, only this account will be used for transaction authorization going forward.\n   * Reverting back control to the original address must be done by setting this field to\n   * the original address.\n   */\n  rekeyTo?: Address\n\n  /**\n   * Optional lease value to enforce mutual transaction exclusion.\n   *\n   * When a transaction with a non-empty lease field is confirmed, the lease is acquired.\n   * A lease X is acquired by the sender, generating the (sender, X) lease.\n   * The lease is kept active until the last_valid round of the transaction has elapsed.\n   * No other transaction sent by the same sender can be confirmed until the lease expires.\n   */\n  lease?: Uint8Array\n\n  /**\n   * Optional group ID for atomic transaction grouping.\n   *\n   * Transactions with the same group ID must execute together or not at all.\n   */\n  group?: Uint8Array\n\n  /**\n   * Payment specific fields\n   */\n  payment?: PaymentTransactionFields\n\n  /**\n   * Asset transfer specific fields\n   */\n  assetTransfer?: AssetTransferTransactionFields\n\n  /**\n   * Asset config specific fields\n   */\n  assetConfig?: AssetConfigTransactionFields\n\n  /**\n   * App call specific fields\n   */\n  appCall?: AppCallTransactionFields\n\n  /**\n   * Key registration specific fields\n   */\n  keyRegistration?: KeyRegistrationTransactionFields\n\n  /**\n   * Asset freeze specific fields\n   */\n  assetFreeze?: AssetFreezeTransactionFields\n\n  /**\n   * Heartbeat specific fields\n   */\n  heartbeat?: HeartbeatTransactionFields\n\n  /**\n   * State proof specific fields\n   */\n  stateProof?: StateProofTransactionFields\n}\n\n/**\n * Represents a complete Algorand transaction.\n */\nexport class Transaction implements TransactionParams {\n  /** @internal */\n  [TXN_SYMBOL]: boolean\n\n  /**\n   * The type of transaction\n   */\n  type: TransactionType\n\n  /**\n   * The account that authorized the transaction.\n   *\n   * Fees are deducted from this account.\n   */\n  sender: Address\n\n  /**\n   * Optional transaction fee in microALGO.\n   *\n   * When not set, the fee will be interpreted as 0 by the network.\n   */\n  fee?: bigint\n\n  /**\n   * First round for when the transaction is valid.\n   */\n  firstValid: bigint\n\n  /**\n   * Last round for when the transaction is valid.\n   *\n   * After this round, the transaction will be expired.\n   */\n  lastValid: bigint\n\n  /**\n   * Hash of the genesis block of the network.\n   *\n   * Used to identify which network the transaction is for.\n   */\n  genesisHash?: Uint8Array\n\n  /**\n   * Genesis ID of the network.\n   *\n   * A human-readable string used alongside genesis hash to identify the network.\n   */\n  genesisId?: string\n\n  /**\n   * Optional user-defined note field.\n   *\n   * Can contain arbitrary data up to 1KB in size.\n   */\n  note?: Uint8Array\n\n  /**\n   * Optional authorized account for future transactions.\n   *\n   * If set, only this account will be used for transaction authorization going forward.\n   * Reverting back control to the original address must be done by setting this field to\n   * the original address.\n   */\n  rekeyTo?: Address\n\n  /**\n   * Optional lease value to enforce mutual transaction exclusion.\n   *\n   * When a transaction with a non-empty lease field is confirmed, the lease is acquired.\n   * A lease X is acquired by the sender, generating the (sender, X) lease.\n   * The lease is kept active until the last_valid round of the transaction has elapsed.\n   * No other transaction sent by the same sender can be confirmed until the lease expires.\n   */\n  lease?: Uint8Array\n\n  /**\n   * Optional group ID for atomic transaction grouping.\n   *\n   * Transactions with the same group ID must execute together or not at all.\n   */\n  group?: Uint8Array\n\n  /**\n   * Payment specific fields\n   */\n  payment?: PaymentTransactionFields\n\n  /**\n   * Asset transfer specific fields\n   */\n  assetTransfer?: AssetTransferTransactionFields\n\n  /**\n   * Asset config specific fields\n   */\n  assetConfig?: AssetConfigTransactionFields\n\n  /**\n   * App call specific fields\n   */\n  appCall?: AppCallTransactionFields\n\n  /**\n   * Key registration specific fields\n   */\n  keyRegistration?: KeyRegistrationTransactionFields\n\n  /**\n   * Asset freeze specific fields\n   */\n  assetFreeze?: AssetFreezeTransactionFields\n\n  /**\n   * Heartbeat specific fields\n   */\n  heartbeat?: HeartbeatTransactionFields\n\n  /**\n   * State proof specific fields\n   */\n  stateProof?: StateProofTransactionFields\n\n  constructor(params: TransactionParams) {\n    this[TXN_SYMBOL] = true\n    this.type = params.type\n    this.sender = params.sender\n    this.fee = params.fee\n    this.firstValid = params.firstValid\n    this.lastValid = params.lastValid\n    this.genesisHash = params.genesisHash\n    this.genesisId = params.genesisId\n    this.note = params.note\n    this.rekeyTo = params.rekeyTo\n    this.lease = params.lease\n    this.group = params.group\n    this.payment = params.payment\n    this.assetTransfer = params.assetTransfer\n    this.assetConfig = params.assetConfig\n    this.appCall = params.appCall\n    this.keyRegistration = params.keyRegistration\n    this.assetFreeze = params.assetFreeze\n    this.heartbeat = params.heartbeat\n    this.stateProof = params.stateProof\n  }\n\n  private rawTxId(): Uint8Array {\n    if (this.genesisHash === undefined) {\n      throw new Error('Cannot compute transaction id without genesis hash')\n    }\n\n    const encodedBytes = encodeTransaction(this)\n    return hash(encodedBytes)\n  }\n\n  /**\n   * Get the transaction ID as a base32-encoded string.\n   */\n  txId(): string {\n    const rawTxId = this.rawTxId()\n\n    return base32.encode(rawTxId).slice(0, TRANSACTION_ID_LENGTH)\n  }\n}\n\n// Define Symbol.hasInstance outside the class to avoid Metro/Hermes parser issues\n// with static computed property names like `static [Symbol.hasInstance]()`\n// Also must handle Babel's _classCallCheck which uses instanceof before TXN_SYMBOL is set\nObject.defineProperty(Transaction, Symbol.hasInstance, {\n  value: function (obj: unknown): boolean {\n    // First check prototype chain (handles Babel's _classCallCheck and normal instances)\n    if (obj instanceof Object && Object.getPrototypeOf(obj) === Transaction.prototype) {\n      return true\n    }\n    // Then check for the brand symbol (handles cross-realm/serialized instances)\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return Boolean(obj && typeof obj === 'object' && TXN_SYMBOL in obj && (obj as any)[TXN_SYMBOL])\n  },\n})\n\n/**\n * Codec for Transaction class.\n * Handles encoding/decoding between Transaction class instances and wire format.\n */\nclass TransactionCodec extends Codec<Transaction, Record<string, unknown>, WireObject> {\n  public defaultValue(): Transaction {\n    return new Transaction({\n      type: TransactionType.Unknown,\n      sender: Address.zeroAddress(),\n      firstValid: 0n,\n      lastValid: 0n,\n    })\n  }\n\n  protected toEncoded(value: Transaction, format: EncodingFormat): Record<string, unknown> {\n    return transactionParamsCodec.encode({ ...value }, format)\n  }\n\n  protected fromEncoded(value: WireObject, format: EncodingFormat): Transaction {\n    const params = transactionParamsCodec.decode(value, format)\n    return new Transaction(params)\n  }\n\n  public isDefaultValue(_: Transaction): boolean {\n    return false\n  }\n}\n\nexport const transactionCodec = new TransactionCodec()\n\nexport type FeeParams = {\n  feePerByte: bigint\n  minFee: bigint\n  extraFee?: bigint\n  maxFee?: bigint\n}\n\n/**\n * Get the transaction type from the encoded transaction.\n * This is particularly useful when decoding a transaction that has an unknown type\n */\nexport function getEncodedTransactionType(encoded_transaction: Uint8Array): TransactionType {\n  const decoded = decodeTransaction(encoded_transaction)\n  return decoded.type\n}\n\n/**\n * Encode the transaction with the domain separation (e.g. \"TX\") prefix\n *\n * @param transaction - The transaction to encode\n * @returns The MsgPack encoded bytes or an error if encoding fails.\n */\nexport function encodeTransaction(transaction: Transaction): Uint8Array {\n  const rawBytes = encodeTransactionRaw(transaction)\n\n  // Add domain separation prefix\n  const prefixBytes = new TextEncoder().encode(TRANSACTION_DOMAIN_SEPARATOR)\n  return concatArrays(prefixBytes, rawBytes)\n}\n\n/**\n * Encode transactions with the domain separation (e.g. \"TX\") prefix\n *\n * @param transactions - A collection of transactions to encode\n * @returns A collection of MsgPack encoded bytes or an error if encoding fails.\n */\nexport function encodeTransactions(transactions: Transaction[]): Uint8Array[] {\n  return transactions.map((tx) => encodeTransaction(tx))\n}\n\n/**\n * Validate a transaction\n */\nexport function validateTransaction(transaction: Transaction): void {\n  // Validate that only one transaction type specific field is set\n  const typeFields = [\n    transaction.payment,\n    transaction.assetTransfer,\n    transaction.assetConfig,\n    transaction.appCall,\n    transaction.keyRegistration,\n    transaction.assetFreeze,\n    transaction.heartbeat,\n    transaction.stateProof,\n  ]\n\n  const setFieldsCount = typeFields.filter((field) => field !== undefined).length\n\n  if (setFieldsCount > 1) {\n    throw new Error('Multiple transaction type specific fields set')\n  }\n\n  // Perform type-specific validation where applicable\n  let typeName = 'Transaction'\n  const errors = new Array<TransactionValidationError>()\n  if (transaction.assetTransfer) {\n    typeName = 'Asset transfer'\n    errors.push(...validateAssetTransferTransaction(transaction.assetTransfer))\n  } else if (transaction.assetConfig) {\n    typeName = 'Asset config'\n    errors.push(...validateAssetConfigTransaction(transaction.assetConfig))\n  } else if (transaction.appCall) {\n    typeName = 'App call'\n    errors.push(...validateAppCallTransaction(transaction.appCall))\n  } else if (transaction.keyRegistration) {\n    typeName = 'Key registration'\n    errors.push(...validateKeyRegistrationTransaction(transaction.keyRegistration))\n  } else if (transaction.assetFreeze) {\n    typeName = 'Asset freeze'\n    errors.push(...validateAssetFreezeTransaction(transaction.assetFreeze))\n  }\n\n  if (errors.length > 0) {\n    const errorMessages = errors.map((e) => getValidationErrorMessage(e))\n    throw new Error(`${typeName} validation failed: ${errorMessages.join('\\n')}`)\n  }\n}\n\n/**\n * Encode the transaction without the domain separation (e.g. \"TX\") prefix\n * This is useful for encoding the transaction for signing with tools that automatically add \"TX\" prefix to the transaction bytes.\n */\nexport function encodeTransactionRaw(transaction: Transaction): Uint8Array {\n  const encodingData = transactionCodec.encode(transaction, 'msgpack')\n  return encodeMsgpack(encodingData)\n}\n\n/**\n * Decodes MsgPack bytes into a transaction.\n *\n * # Parameters\n * * `encoded_transaction` - MsgPack encoded bytes representing a transaction.\n *\n * # Returns\n * A decoded transaction or an error if decoding fails.\n */\nexport function decodeTransaction(encoded_transaction: Uint8Array): Transaction {\n  if (encoded_transaction.length === 0) {\n    throw new Error('attempted to decode 0 bytes')\n  }\n\n  const prefixBytes = new TextEncoder().encode(TRANSACTION_DOMAIN_SEPARATOR)\n  // Check if the transaction has the domain separation prefix\n  let hasPrefix = true\n  if (encoded_transaction.length < prefixBytes.length) {\n    hasPrefix = false\n  } else {\n    for (let i = 0; i < prefixBytes.length; i++) {\n      if (encoded_transaction[i] !== prefixBytes[i]) {\n        hasPrefix = false\n        break\n      }\n    }\n  }\n\n  const decodedData = decodeMsgpack(hasPrefix ? encoded_transaction.slice(prefixBytes.length) : encoded_transaction)\n  return transactionCodec.decode(decodedData, 'msgpack')\n}\n\n/**\n * Decodes a collection of MsgPack bytes into a transaction collection.\n *\n * # Parameters\n * * `encoded_transaction` - A collection of MsgPack encoded bytes, each representing a transaction.\n *\n * # Returns\n * A collection of decoded transactions or an error if decoding fails.\n */\nexport function decodeTransactions(encoded_transactions: Uint8Array[]): Transaction[] {\n  return encoded_transactions.map((et) => decodeTransaction(et))\n}\n\n/**\n * Return the size of the transaction in bytes as if it was already signed and encoded.\n * This is useful for estimating the fee for the transaction.\n */\nexport function estimateTransactionSize(transaction: Transaction): bigint {\n  const encoded = encodeTransactionRaw(transaction)\n  return BigInt(encoded.length + SIGNATURE_ENCODING_INCR)\n}\n\n/**\n * Groups a collection of transactions by calculating and assigning the group to each transaction.\n */\nexport function groupTransactions(transactions: Transaction[]): Transaction[] {\n  const group = computeGroup(transactions)\n  return transactions.map(\n    (tx) =>\n      new Transaction({\n        ...tx,\n        group,\n      }),\n  )\n}\n\nexport function assignFee(transaction: Transaction, feeParams: FeeParams): Transaction {\n  const fee = calculateFee(transaction, feeParams)\n  return new Transaction({\n    ...transaction,\n    fee,\n  })\n}\n\nfunction computeGroup(transactions: Transaction[]): Uint8Array {\n  if (transactions.length === 0) {\n    throw new Error('Transaction group size cannot be 0')\n  }\n\n  if (transactions.length > MAX_TRANSACTION_GROUP_SIZE) {\n    throw new Error(`Transaction group size exceeds the max limit of ${MAX_TRANSACTION_GROUP_SIZE}`)\n  }\n\n  const txHashes = transactions.map((tx) => {\n    if (tx.group) {\n      throw new Error('Transactions must not already be grouped')\n    }\n\n    const encodedBytes = encodeTransaction(tx)\n    return hash(encodedBytes)\n  })\n\n  const prefixBytes = new TextEncoder().encode(TRANSACTION_GROUP_DOMAIN_SEPARATOR)\n  const encodedBytes = encodeMsgpack({\n    txlist: txHashes,\n  })\n\n  const prefixedBytes = concatArrays(prefixBytes, encodedBytes)\n  return hash(prefixedBytes)\n}\n\nexport function calculateFee(transaction: Transaction, feeParams: FeeParams): bigint {\n  let calculatedFee = 0n\n\n  if (feeParams.feePerByte > 0n) {\n    const estimatedSize = estimateTransactionSize(transaction)\n    calculatedFee = feeParams.feePerByte * BigInt(estimatedSize)\n  }\n\n  if (calculatedFee < feeParams.minFee) {\n    calculatedFee = feeParams.minFee\n  }\n\n  if (feeParams.extraFee) {\n    calculatedFee += feeParams.extraFee\n  }\n\n  if (feeParams.maxFee && calculatedFee > feeParams.maxFee) {\n    throw new Error(`Transaction fee ${calculatedFee} µALGO is greater than maxFee ${feeParams.maxFee} µALGO`)\n  }\n\n  return calculatedFee\n}\n"],"mappings":"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"}

package/testing/account.d.ts

@@ -2,8 +2,8 @@ import { Address } from "../packages/common/src/address.js";
 import { AddressWithSigners, AddressWithTransactionSigner } from "../packages/transact/src/signer.js";
 import { AlgodClient } from "../packages/algod_client/src/client.js";
 import { KmdClient } from "../packages/kmd_client/src/client.js";
-import { AlgorandClient } from "../types/algorand-client.js";
-import { GetTestAccountParams } from "../types/testing.js";
+import { AlgorandClient } from "../algorand-client.js";
+import { GetTestAccountParams } from "./types.js";
 
 //#region src/testing/account.d.ts
 

package/testing/account.js

@@ -1,6 +1,6 @@
 const require_address = require('../packages/common/src/address.js');
 const require_config = require('../config.js');
-const require_algorand_client = require('../types/algorand-client.js');
+const require_algorand_client = require('../algorand-client.js');
 
 //#region src/testing/account.ts
 async function getTestAccount({ suppressLog, initialFunds, accountGetter }, algodOrAlgorandClient, kmd) {
@@ -22,8 +22,7 @@ async function getTestAccount({ suppressLog, initialFunds, accountGetter }, algo
 	require_config.Config.getLogger(suppressLog).info("Test account funded; account balance: %d µALGO", accountInfo.balance.microAlgo);
 	algorand.setSignerFromAccount(account);
 	const address = require_address.Address.fromString(account.addr.toString());
-	address.addr = account.addr;
-	address.signer = algorand.account.getSigner(address);
+	for (const key of Object.keys(account)) if (!(key in address)) address[key] = account[key];
 	return address;
 }
 

package/testing/account.js.map

@@ -1 +1 @@
-{"version":3,"file":"account.js","names":["AlgorandClient","Address"],"sources":["../../src/testing/account.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport { Address } from '@algorandfoundation/algokit-common'\nimport { AddressWithSigners, AddressWithTransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { KmdClient } from '@algorandfoundation/algokit-kmd-client'\nimport { AlgorandClient, Config } from '../'\nimport { GetTestAccountParams } from '../types/testing'\n\n/**\n * @deprecated Use `getTestAccount(params, algorandClient)` instead. The `algorandClient` object can be created using `AlgorandClient.fromClients({ algod, kmd })`.\n *\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algod An algod client\n * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables and if not found fallback to the default LocalNet KMD client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(\n  params: GetTestAccountParams,\n  algod: AlgodClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithTransactionSigner>\n/**\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algorand An AlgorandClient client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(params: GetTestAccountParams, algorand: AlgorandClient): Promise<Address & AddressWithSigners>\nexport async function getTestAccount(\n  { suppressLog, initialFunds, accountGetter }: GetTestAccountParams,\n  algodOrAlgorandClient: AlgodClient | AlgorandClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithTransactionSigner> {\n  const algorand =\n    algodOrAlgorandClient instanceof AlgorandClient\n      ? algodOrAlgorandClient\n      : AlgorandClient.fromClients({\n          algod: algodOrAlgorandClient,\n          kmd,\n        })\n\n  const account = accountGetter ? await accountGetter(algorand) : algorand.account.random()\n\n  Config.getLogger(suppressLog).info(`New test account created with address '${account.addr}'.`)\n\n  const dispenser = await algorand.account.dispenserFromEnvironment()\n\n  await algorand.send.payment({\n    sender: dispenser,\n    receiver: account.addr,\n    amount: initialFunds,\n    note: 'Funding test account',\n    suppressLog,\n  })\n\n  const accountInfo = await algorand.account.getInformation(account.addr)\n\n  Config.getLogger(suppressLog).info('Test account funded; account balance: %d µALGO', accountInfo.balance.microAlgo)\n\n  algorand.setSignerFromAccount(account)\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const address = Address.fromString(account.addr.toString()) as any\n  address.addr = account.addr\n  address.signer = algorand.account.getSigner(address)\n\n  return address\n}\n"],"mappings":";;;;;AAkCA,eAAsB,eACpB,EAAE,aAAa,cAAc,iBAC7B,uBACA,KACiD;CACjD,MAAM,WACJ,iCAAiCA,yCAC7B,wBACAA,uCAAe,YAAY;EACzB,OAAO;EACP;EACD,CAAC;CAER,MAAM,UAAU,gBAAgB,MAAM,cAAc,SAAS,GAAG,SAAS,QAAQ,QAAQ;AAEzF,uBAAO,UAAU,YAAY,CAAC,KAAK,0CAA0C,QAAQ,KAAK,IAAI;CAE9F,MAAM,YAAY,MAAM,SAAS,QAAQ,0BAA0B;AAEnE,OAAM,SAAS,KAAK,QAAQ;EAC1B,QAAQ;EACR,UAAU,QAAQ;EAClB,QAAQ;EACR,MAAM;EACN;EACD,CAAC;CAEF,MAAM,cAAc,MAAM,SAAS,QAAQ,eAAe,QAAQ,KAAK;AAEvE,uBAAO,UAAU,YAAY,CAAC,KAAK,kDAAkD,YAAY,QAAQ,UAAU;AAEnH,UAAS,qBAAqB,QAAQ;CAGtC,MAAM,UAAUC,wBAAQ,WAAW,QAAQ,KAAK,UAAU,CAAC;AAC3D,SAAQ,OAAO,QAAQ;AACvB,SAAQ,SAAS,SAAS,QAAQ,UAAU,QAAQ;AAEpD,QAAO"}
+{"version":3,"file":"account.js","names":["AlgorandClient","Address"],"sources":["../../src/testing/account.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport { Address } from '@algorandfoundation/algokit-common'\nimport { KmdClient } from '@algorandfoundation/algokit-kmd-client'\nimport { AddressWithSigners, AddressWithTransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { AlgorandClient, Config } from '../'\nimport { GetTestAccountParams } from './types'\n\n/**\n * @deprecated Use `getTestAccount(params, algorandClient)` instead. The `algorandClient` object can be created using `AlgorandClient.fromClients({ algod, kmd })`.\n *\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algod An algod client\n * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables and if not found fallback to the default LocalNet KMD client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(\n  params: GetTestAccountParams,\n  algod: AlgodClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithTransactionSigner>\n/**\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algorand An AlgorandClient client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(params: GetTestAccountParams, algorand: AlgorandClient): Promise<Address & AddressWithSigners>\nexport async function getTestAccount(\n  { suppressLog, initialFunds, accountGetter }: GetTestAccountParams,\n  algodOrAlgorandClient: AlgodClient | AlgorandClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithSigners> {\n  const algorand =\n    algodOrAlgorandClient instanceof AlgorandClient\n      ? algodOrAlgorandClient\n      : AlgorandClient.fromClients({\n          algod: algodOrAlgorandClient,\n          kmd,\n        })\n\n  const account = accountGetter ? await accountGetter(algorand) : algorand.account.random()\n\n  Config.getLogger(suppressLog).info(`New test account created with address '${account.addr}'.`)\n\n  const dispenser = await algorand.account.dispenserFromEnvironment()\n\n  await algorand.send.payment({\n    sender: dispenser,\n    receiver: account.addr,\n    amount: initialFunds,\n    note: 'Funding test account',\n    suppressLog,\n  })\n\n  const accountInfo = await algorand.account.getInformation(account.addr)\n\n  Config.getLogger(suppressLog).info('Test account funded; account balance: %d µALGO', accountInfo.balance.microAlgo)\n\n  algorand.setSignerFromAccount(account)\n\n  const address = Address.fromString(account.addr.toString()) as Address & AddressWithSigners\n  for (const key of Object.keys(account as AddressWithSigners)) {\n    if (!(key in address)) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(address as any)[key] = (account as any)[key]\n    }\n  }\n\n  return address\n}\n"],"mappings":";;;;;AAkCA,eAAsB,eACpB,EAAE,aAAa,cAAc,iBAC7B,uBACA,KACuC;CACvC,MAAM,WACJ,iCAAiCA,yCAC7B,wBACAA,uCAAe,YAAY;EACzB,OAAO;EACP;EACD,CAAC;CAER,MAAM,UAAU,gBAAgB,MAAM,cAAc,SAAS,GAAG,SAAS,QAAQ,QAAQ;AAEzF,uBAAO,UAAU,YAAY,CAAC,KAAK,0CAA0C,QAAQ,KAAK,IAAI;CAE9F,MAAM,YAAY,MAAM,SAAS,QAAQ,0BAA0B;AAEnE,OAAM,SAAS,KAAK,QAAQ;EAC1B,QAAQ;EACR,UAAU,QAAQ;EAClB,QAAQ;EACR,MAAM;EACN;EACD,CAAC;CAEF,MAAM,cAAc,MAAM,SAAS,QAAQ,eAAe,QAAQ,KAAK;AAEvE,uBAAO,UAAU,YAAY,CAAC,KAAK,kDAAkD,YAAY,QAAQ,UAAU;AAEnH,UAAS,qBAAqB,QAAQ;CAEtC,MAAM,UAAUC,wBAAQ,WAAW,QAAQ,KAAK,UAAU,CAAC;AAC3D,MAAK,MAAM,OAAO,OAAO,KAAK,QAA8B,CAC1D,KAAI,EAAE,OAAO,SAEV,CAAC,QAAgB,OAAQ,QAAgB;AAI9C,QAAO"}

package/testing/account.mjs

@@ -1,6 +1,6 @@
 import { Address } from "../packages/common/src/address.mjs";
 import { Config } from "../config.mjs";
-import { AlgorandClient } from "../types/algorand-client.mjs";
+import { AlgorandClient } from "../algorand-client.mjs";
 
 //#region src/testing/account.ts
 async function getTestAccount({ suppressLog, initialFunds, accountGetter }, algodOrAlgorandClient, kmd) {
@@ -22,8 +22,7 @@ async function getTestAccount({ suppressLog, initialFunds, accountGetter }, algo
 	Config.getLogger(suppressLog).info("Test account funded; account balance: %d µALGO", accountInfo.balance.microAlgo);
 	algorand.setSignerFromAccount(account);
 	const address = Address.fromString(account.addr.toString());
-	address.addr = account.addr;
-	address.signer = algorand.account.getSigner(address);
+	for (const key of Object.keys(account)) if (!(key in address)) address[key] = account[key];
 	return address;
 }
 

package/testing/account.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"account.mjs","names":[],"sources":["../../src/testing/account.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport { Address } from '@algorandfoundation/algokit-common'\nimport { AddressWithSigners, AddressWithTransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { KmdClient } from '@algorandfoundation/algokit-kmd-client'\nimport { AlgorandClient, Config } from '../'\nimport { GetTestAccountParams } from '../types/testing'\n\n/**\n * @deprecated Use `getTestAccount(params, algorandClient)` instead. The `algorandClient` object can be created using `AlgorandClient.fromClients({ algod, kmd })`.\n *\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algod An algod client\n * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables and if not found fallback to the default LocalNet KMD client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(\n  params: GetTestAccountParams,\n  algod: AlgodClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithTransactionSigner>\n/**\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algorand An AlgorandClient client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(params: GetTestAccountParams, algorand: AlgorandClient): Promise<Address & AddressWithSigners>\nexport async function getTestAccount(\n  { suppressLog, initialFunds, accountGetter }: GetTestAccountParams,\n  algodOrAlgorandClient: AlgodClient | AlgorandClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithTransactionSigner> {\n  const algorand =\n    algodOrAlgorandClient instanceof AlgorandClient\n      ? algodOrAlgorandClient\n      : AlgorandClient.fromClients({\n          algod: algodOrAlgorandClient,\n          kmd,\n        })\n\n  const account = accountGetter ? await accountGetter(algorand) : algorand.account.random()\n\n  Config.getLogger(suppressLog).info(`New test account created with address '${account.addr}'.`)\n\n  const dispenser = await algorand.account.dispenserFromEnvironment()\n\n  await algorand.send.payment({\n    sender: dispenser,\n    receiver: account.addr,\n    amount: initialFunds,\n    note: 'Funding test account',\n    suppressLog,\n  })\n\n  const accountInfo = await algorand.account.getInformation(account.addr)\n\n  Config.getLogger(suppressLog).info('Test account funded; account balance: %d µALGO', accountInfo.balance.microAlgo)\n\n  algorand.setSignerFromAccount(account)\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const address = Address.fromString(account.addr.toString()) as any\n  address.addr = account.addr\n  address.signer = algorand.account.getSigner(address)\n\n  return address\n}\n"],"mappings":";;;;;AAkCA,eAAsB,eACpB,EAAE,aAAa,cAAc,iBAC7B,uBACA,KACiD;CACjD,MAAM,WACJ,iCAAiC,iBAC7B,wBACA,eAAe,YAAY;EACzB,OAAO;EACP;EACD,CAAC;CAER,MAAM,UAAU,gBAAgB,MAAM,cAAc,SAAS,GAAG,SAAS,QAAQ,QAAQ;AAEzF,QAAO,UAAU,YAAY,CAAC,KAAK,0CAA0C,QAAQ,KAAK,IAAI;CAE9F,MAAM,YAAY,MAAM,SAAS,QAAQ,0BAA0B;AAEnE,OAAM,SAAS,KAAK,QAAQ;EAC1B,QAAQ;EACR,UAAU,QAAQ;EAClB,QAAQ;EACR,MAAM;EACN;EACD,CAAC;CAEF,MAAM,cAAc,MAAM,SAAS,QAAQ,eAAe,QAAQ,KAAK;AAEvE,QAAO,UAAU,YAAY,CAAC,KAAK,kDAAkD,YAAY,QAAQ,UAAU;AAEnH,UAAS,qBAAqB,QAAQ;CAGtC,MAAM,UAAU,QAAQ,WAAW,QAAQ,KAAK,UAAU,CAAC;AAC3D,SAAQ,OAAO,QAAQ;AACvB,SAAQ,SAAS,SAAS,QAAQ,UAAU,QAAQ;AAEpD,QAAO"}
+{"version":3,"file":"account.mjs","names":[],"sources":["../../src/testing/account.ts"],"sourcesContent":["import { AlgodClient } from '@algorandfoundation/algokit-algod-client'\nimport { Address } from '@algorandfoundation/algokit-common'\nimport { KmdClient } from '@algorandfoundation/algokit-kmd-client'\nimport { AddressWithSigners, AddressWithTransactionSigner } from '@algorandfoundation/algokit-transact'\nimport { AlgorandClient, Config } from '../'\nimport { GetTestAccountParams } from './types'\n\n/**\n * @deprecated Use `getTestAccount(params, algorandClient)` instead. The `algorandClient` object can be created using `AlgorandClient.fromClients({ algod, kmd })`.\n *\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algod An algod client\n * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables and if not found fallback to the default LocalNet KMD client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(\n  params: GetTestAccountParams,\n  algod: AlgodClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithTransactionSigner>\n/**\n * Creates an ephemeral Algorand account for the purposes of testing.\n * Returns a newly created random test account that is funded from the dispenser\n * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!\n * Note: By default this will log the mnemonic of the account.\n * @param params The config for the test account to generate\n * @param algorand An AlgorandClient client\n * @returns The account, with private key loaded\n */\nexport async function getTestAccount(params: GetTestAccountParams, algorand: AlgorandClient): Promise<Address & AddressWithSigners>\nexport async function getTestAccount(\n  { suppressLog, initialFunds, accountGetter }: GetTestAccountParams,\n  algodOrAlgorandClient: AlgodClient | AlgorandClient,\n  kmd?: KmdClient,\n): Promise<Address & AddressWithSigners> {\n  const algorand =\n    algodOrAlgorandClient instanceof AlgorandClient\n      ? algodOrAlgorandClient\n      : AlgorandClient.fromClients({\n          algod: algodOrAlgorandClient,\n          kmd,\n        })\n\n  const account = accountGetter ? await accountGetter(algorand) : algorand.account.random()\n\n  Config.getLogger(suppressLog).info(`New test account created with address '${account.addr}'.`)\n\n  const dispenser = await algorand.account.dispenserFromEnvironment()\n\n  await algorand.send.payment({\n    sender: dispenser,\n    receiver: account.addr,\n    amount: initialFunds,\n    note: 'Funding test account',\n    suppressLog,\n  })\n\n  const accountInfo = await algorand.account.getInformation(account.addr)\n\n  Config.getLogger(suppressLog).info('Test account funded; account balance: %d µALGO', accountInfo.balance.microAlgo)\n\n  algorand.setSignerFromAccount(account)\n\n  const address = Address.fromString(account.addr.toString()) as Address & AddressWithSigners\n  for (const key of Object.keys(account as AddressWithSigners)) {\n    if (!(key in address)) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ;(address as any)[key] = (account as any)[key]\n    }\n  }\n\n  return address\n}\n"],"mappings":";;;;;AAkCA,eAAsB,eACpB,EAAE,aAAa,cAAc,iBAC7B,uBACA,KACuC;CACvC,MAAM,WACJ,iCAAiC,iBAC7B,wBACA,eAAe,YAAY;EACzB,OAAO;EACP;EACD,CAAC;CAER,MAAM,UAAU,gBAAgB,MAAM,cAAc,SAAS,GAAG,SAAS,QAAQ,QAAQ;AAEzF,QAAO,UAAU,YAAY,CAAC,KAAK,0CAA0C,QAAQ,KAAK,IAAI;CAE9F,MAAM,YAAY,MAAM,SAAS,QAAQ,0BAA0B;AAEnE,OAAM,SAAS,KAAK,QAAQ;EAC1B,QAAQ;EACR,UAAU,QAAQ;EAClB,QAAQ;EACR,MAAM;EACN;EACD,CAAC;CAEF,MAAM,cAAc,MAAM,SAAS,QAAQ,eAAe,QAAQ,KAAK;AAEvE,QAAO,UAAU,YAAY,CAAC,KAAK,kDAAkD,YAAY,QAAQ,UAAU;AAEnH,UAAS,qBAAqB,QAAQ;CAEtC,MAAM,UAAU,QAAQ,WAAW,QAAQ,KAAK,UAAU,CAAC;AAC3D,MAAK,MAAM,OAAO,OAAO,KAAK,QAA8B,CAC1D,KAAI,EAAE,OAAO,SAEV,CAAC,QAAgB,OAAQ,QAAgB;AAI9C,QAAO"}

package/testing/fixtures/algokit-log-capture-fixture.d.ts

@@ -1,4 +1,4 @@
-import { AlgoKitLogCaptureFixture } from "../../types/testing.js";
+import { AlgoKitLogCaptureFixture } from "../types.js";
 
 //#region src/testing/fixtures/algokit-log-capture-fixture.d.ts
 

package/testing/fixtures/algokit-log-capture-fixture.js.map

@@ -1 +1 @@
-{"version":3,"file":"algokit-log-capture-fixture.js","names":["algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture","Config","hybridLogger: TestLogger","TestLogger"],"sources":["../../../src/testing/fixtures/algokit-log-capture-fixture.ts"],"sourcesContent":["import { Config } from '../../'\nimport { AlgoKitLogCaptureFixture } from '../../types/testing'\nimport { TestLogger } from '../test-logger'\n\n/**\n * Creates a test fixture for capturing AlgoKit logs.\n *\n * @example\n * ```typescript\n * const logs = algoKitLogCaptureFixture()\n *\n * beforeEach(logs.beforeEach)\n * afterEach(logs.afterEach)\n *\n * test('My test', () => {\n *     const capturedLogs = logs.testLogger.capturedLogs\n * })\n * ```\n *\n * @returns The fixture\n */\nexport const algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture = () => {\n  const originalLogger = Config.logger\n\n  let hybridLogger: TestLogger\n\n  return {\n    get testLogger() {\n      return hybridLogger\n    },\n    beforeEach: () => {\n      hybridLogger = new TestLogger(originalLogger)\n      Config.configure({\n        logger: hybridLogger,\n      })\n    },\n    afterEach: () => {\n      Config.configure({\n        logger: originalLogger,\n      })\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAaA,iCAAiE;CAC5E,MAAM,iBAAiBC,sBAAO;CAE9B,IAAIC;AAEJ,QAAO;EACL,IAAI,aAAa;AACf,UAAO;;EAET,kBAAkB;AAChB,kBAAe,IAAIC,+BAAW,eAAe;AAC7C,yBAAO,UAAU,EACf,QAAQ,cACT,CAAC;;EAEJ,iBAAiB;AACf,yBAAO,UAAU,EACf,QAAQ,gBACT,CAAC;;EAEL"}
+{"version":3,"file":"algokit-log-capture-fixture.js","names":["Config","TestLogger"],"sources":["../../../src/testing/fixtures/algokit-log-capture-fixture.ts"],"sourcesContent":["import { Config } from '../../'\nimport { TestLogger } from '../test-logger'\nimport { AlgoKitLogCaptureFixture } from '../types'\n\n/**\n * Creates a test fixture for capturing AlgoKit logs.\n *\n * @example\n * ```typescript\n * const logs = algoKitLogCaptureFixture()\n *\n * beforeEach(logs.beforeEach)\n * afterEach(logs.afterEach)\n *\n * test('My test', () => {\n *     const capturedLogs = logs.testLogger.capturedLogs\n * })\n * ```\n *\n * @returns The fixture\n */\nexport const algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture = () => {\n  const originalLogger = Config.logger\n\n  let hybridLogger: TestLogger\n\n  return {\n    get testLogger() {\n      return hybridLogger\n    },\n    beforeEach: () => {\n      hybridLogger = new TestLogger(originalLogger)\n      Config.configure({\n        logger: hybridLogger,\n      })\n    },\n    afterEach: () => {\n      Config.configure({\n        logger: originalLogger,\n      })\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,iCAAiE;CAC5E,MAAM,iBAAiBA,sBAAO;CAE9B,IAAI;AAEJ,QAAO;EACL,IAAI,aAAa;AACf,UAAO;;EAET,kBAAkB;AAChB,kBAAe,IAAIC,+BAAW,eAAe;AAC7C,yBAAO,UAAU,EACf,QAAQ,cACT,CAAC;;EAEJ,iBAAiB;AACf,yBAAO,UAAU,EACf,QAAQ,gBACT,CAAC;;EAEL"}

package/testing/fixtures/algokit-log-capture-fixture.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"algokit-log-capture-fixture.mjs","names":["algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture","hybridLogger: TestLogger"],"sources":["../../../src/testing/fixtures/algokit-log-capture-fixture.ts"],"sourcesContent":["import { Config } from '../../'\nimport { AlgoKitLogCaptureFixture } from '../../types/testing'\nimport { TestLogger } from '../test-logger'\n\n/**\n * Creates a test fixture for capturing AlgoKit logs.\n *\n * @example\n * ```typescript\n * const logs = algoKitLogCaptureFixture()\n *\n * beforeEach(logs.beforeEach)\n * afterEach(logs.afterEach)\n *\n * test('My test', () => {\n *     const capturedLogs = logs.testLogger.capturedLogs\n * })\n * ```\n *\n * @returns The fixture\n */\nexport const algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture = () => {\n  const originalLogger = Config.logger\n\n  let hybridLogger: TestLogger\n\n  return {\n    get testLogger() {\n      return hybridLogger\n    },\n    beforeEach: () => {\n      hybridLogger = new TestLogger(originalLogger)\n      Config.configure({\n        logger: hybridLogger,\n      })\n    },\n    afterEach: () => {\n      Config.configure({\n        logger: originalLogger,\n      })\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAaA,iCAAiE;CAC5E,MAAM,iBAAiB,OAAO;CAE9B,IAAIC;AAEJ,QAAO;EACL,IAAI,aAAa;AACf,UAAO;;EAET,kBAAkB;AAChB,kBAAe,IAAI,WAAW,eAAe;AAC7C,UAAO,UAAU,EACf,QAAQ,cACT,CAAC;;EAEJ,iBAAiB;AACf,UAAO,UAAU,EACf,QAAQ,gBACT,CAAC;;EAEL"}
+{"version":3,"file":"algokit-log-capture-fixture.mjs","names":[],"sources":["../../../src/testing/fixtures/algokit-log-capture-fixture.ts"],"sourcesContent":["import { Config } from '../../'\nimport { TestLogger } from '../test-logger'\nimport { AlgoKitLogCaptureFixture } from '../types'\n\n/**\n * Creates a test fixture for capturing AlgoKit logs.\n *\n * @example\n * ```typescript\n * const logs = algoKitLogCaptureFixture()\n *\n * beforeEach(logs.beforeEach)\n * afterEach(logs.afterEach)\n *\n * test('My test', () => {\n *     const capturedLogs = logs.testLogger.capturedLogs\n * })\n * ```\n *\n * @returns The fixture\n */\nexport const algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture = () => {\n  const originalLogger = Config.logger\n\n  let hybridLogger: TestLogger\n\n  return {\n    get testLogger() {\n      return hybridLogger\n    },\n    beforeEach: () => {\n      hybridLogger = new TestLogger(originalLogger)\n      Config.configure({\n        logger: hybridLogger,\n      })\n    },\n    afterEach: () => {\n      Config.configure({\n        logger: originalLogger,\n      })\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,iCAAiE;CAC5E,MAAM,iBAAiB,OAAO;CAE9B,IAAI;AAEJ,QAAO;EACL,IAAI,aAAa;AACf,UAAO;;EAET,kBAAkB;AAChB,kBAAe,IAAI,WAAW,eAAe;AAC7C,UAAO,UAAU,EACf,QAAQ,cACT,CAAC;;EAEJ,iBAAiB;AACf,UAAO,UAAU,EACf,QAAQ,gBACT,CAAC;;EAEL"}

package/testing/fixtures/algorand-fixture.d.ts

@@ -1,5 +1,5 @@
-import { AlgoConfig } from "../../types/network-client.js";
-import { AlgorandFixture, AlgorandFixtureConfig } from "../../types/testing.js";
+import { AlgoConfig } from "../../network-client.js";
+import { AlgorandFixture, AlgorandFixtureConfig } from "../types.js";
 
 //#region src/testing/fixtures/algorand-fixture.d.ts
 
@@ -15,7 +15,7 @@ import { AlgorandFixture, AlgorandFixtureConfig } from "../../types/testing.js";
  * ```typescript
  * const fixture = algorandFixture()
  *
- * beforeEach(fixture.newScope, 10_000)
+ * beforeEach(fixture.newScope)
  *
  * test('My test', async () => {
  *     const {algod, indexer, testAccount, ...} = fixture.context
@@ -27,7 +27,7 @@ import { AlgorandFixture, AlgorandFixtureConfig } from "../../types/testing.js";
  * ```typescript
  * const fixture = algorandFixture()
  *
- * beforeAll(fixture.newScope, 10_000)
+ * beforeAll(fixture.newScope)
  *
  * test('My test', async () => {
  *     const {algod, indexer, testAccount, ...} = fixture.context
@@ -42,7 +42,7 @@ import { AlgorandFixture, AlgorandFixtureConfig } from "../../types/testing.js";
  *  // ...
  * })
  *
- * beforeEach(fixture.newScope, 10_000)
+ * beforeEach(fixture.newScope)
  *
  * test('My test', async () => {
  *     const {algod, indexer, testAccount, ...} = fixture.context

package/testing/fixtures/algorand-fixture.js

@@ -1,7 +1,7 @@
 const require_amount = require('../../amount.js');
 const require_config = require('../../config.js');
-const require_client_manager = require('../../types/client-manager.js');
-const require_algorand_client = require('../../types/algorand-client.js');
+const require_client_manager = require('../../client-manager.js');
+const require_algorand_client = require('../../algorand-client.js');
 const require_account = require('../account.js');
 const require_indexer = require('../indexer.js');
 const require_transaction_logger = require('../transaction-logger.js');

package/testing/fixtures/algorand-fixture.js.map

@@ -1 +1 @@
-{"version":3,"file":"algorand-fixture.js","names":["ClientManager","context: AlgorandTestAutomationContext","algorand: AlgorandClient","TransactionLogger","AlgorandClient","getTestAccount","algos","runWhenIndexerCaughtUp"],"sources":["../../../src/testing/fixtures/algorand-fixture.ts"],"sourcesContent":["import { algos, Config } from '../../'\nimport { AlgorandClient } from '../../types/algorand-client'\nimport { ClientManager } from '../../types/client-manager'\nimport { AlgoConfig } from '../../types/network-client'\nimport { AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams } from '../../types/testing'\nimport { getTestAccount } from '../account'\nimport { runWhenIndexerCaughtUp } from '../indexer'\nimport { TransactionLogger } from '../transaction-logger'\n\n/**\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd (or their respective config) if you want to test against\n * an explicitly defined network.\n *\n * @example No config (per-test isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeEach(fixture.newScope, 10_000)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example No config (test suite isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeAll(fixture.newScope, 10_000)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example With config\n * ```typescript\n * const fixture = algorandFixture({\n *  algod: new AlgodClient({ baseUrl: 'http://localhost:12345', headers: { 'X-Algo-API-Token': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' } }),\n *  // ...\n * })\n *\n * beforeEach(fixture.newScope, 10_000)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @param fixtureConfig The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig): AlgorandFixture\n\n/**\n * @deprecated Config can be passed in directly to fixture config now.\n *\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd if you want to test against an explicitly defined network.\n *\n * @param fixtureConfig The fixture configuration\n * @param config The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig: AlgorandFixtureConfig | undefined, config: AlgoConfig): AlgorandFixture\n\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig, config?: AlgoConfig): AlgorandFixture {\n  fixtureConfig = { ...fixtureConfig, ...config }\n  if (!fixtureConfig.algod || !fixtureConfig.indexer || !fixtureConfig.kmd) {\n    fixtureConfig = { ...ClientManager.getConfigFromEnvironmentOrLocalNet(), ...fixtureConfig }\n  }\n\n  const algod = fixtureConfig.algod ?? ClientManager.getAlgodClient(fixtureConfig.algodConfig!)\n  const indexer = fixtureConfig.indexer ?? ClientManager.getIndexerClient(fixtureConfig.indexerConfig!)\n  const kmd = fixtureConfig.kmd ?? ClientManager.getKmdClient(fixtureConfig.kmdConfig!)\n  let context: AlgorandTestAutomationContext\n  let algorand: AlgorandClient\n\n  const newScope = async () => {\n    Config.configure({ debug: true })\n    const transactionLogger = new TransactionLogger()\n    const transactionLoggerAlgod = transactionLogger.capture(algod)\n\n    algorand = AlgorandClient.fromClients({ algod: transactionLoggerAlgod, indexer, kmd }).setSuggestedParamsCacheTimeout(0)\n\n    const testAccount = await getTestAccount({ initialFunds: fixtureConfig?.testAccountFunding ?? algos(10), suppressLog: true }, algorand)\n    algorand.setSignerFromAccount(testAccount)\n\n    // If running against LocalNet we are likely in dev mode and we need to set a much higher validity window\n    //  otherwise we are more likely to get invalid transactions.\n    if (await algorand.client.isLocalNet()) {\n      algorand.setDefaultValidityWindow(1000)\n    }\n    context = {\n      algorand,\n      algod: transactionLoggerAlgod,\n      indexer: indexer,\n      kmd: kmd,\n      testAccount,\n      generateAccount: async (params: GetTestAccountParams) => {\n        const account = await getTestAccount(params, algorand)\n        algorand.setSignerFromAccount(account)\n        return account\n      },\n      transactionLogger: transactionLogger,\n      waitForIndexer: () => transactionLogger.waitForIndexer(indexer),\n      waitForIndexerTransaction: (transactionId: string) => runWhenIndexerCaughtUp(() => indexer.lookupTransactionById(transactionId)),\n    }\n  }\n\n  return {\n    get context() {\n      if (!context) throw new Error('Context not initialised; make sure to call fixture.newScope() before accessing context.')\n      return context\n    },\n    get algorand() {\n      return algorand\n    },\n    beforeEach: newScope,\n    newScope,\n  }\n}\n"],"mappings":";;;;;;;;;AA4EA,SAAgB,gBAAgB,eAAuC,QAAsC;AAC3G,iBAAgB;EAAE,GAAG;EAAe,GAAG;EAAQ;AAC/C,KAAI,CAAC,cAAc,SAAS,CAAC,cAAc,WAAW,CAAC,cAAc,IACnE,iBAAgB;EAAE,GAAGA,qCAAc,oCAAoC;EAAE,GAAG;EAAe;CAG7F,MAAM,QAAQ,cAAc,SAASA,qCAAc,eAAe,cAAc,YAAa;CAC7F,MAAM,UAAU,cAAc,WAAWA,qCAAc,iBAAiB,cAAc,cAAe;CACrG,MAAM,MAAM,cAAc,OAAOA,qCAAc,aAAa,cAAc,UAAW;CACrF,IAAIC;CACJ,IAAIC;CAEJ,MAAM,WAAW,YAAY;AAC3B,wBAAO,UAAU,EAAE,OAAO,MAAM,CAAC;EACjC,MAAM,oBAAoB,IAAIC,8CAAmB;EACjD,MAAM,yBAAyB,kBAAkB,QAAQ,MAAM;AAE/D,aAAWC,uCAAe,YAAY;GAAE,OAAO;GAAwB;GAAS;GAAK,CAAC,CAAC,+BAA+B,EAAE;EAExH,MAAM,cAAc,MAAMC,+BAAe;GAAE,cAAc,eAAe,sBAAsBC,qBAAM,GAAG;GAAE,aAAa;GAAM,EAAE,SAAS;AACvI,WAAS,qBAAqB,YAAY;AAI1C,MAAI,MAAM,SAAS,OAAO,YAAY,CACpC,UAAS,yBAAyB,IAAK;AAEzC,YAAU;GACR;GACA,OAAO;GACE;GACJ;GACL;GACA,iBAAiB,OAAO,WAAiC;IACvD,MAAM,UAAU,MAAMD,+BAAe,QAAQ,SAAS;AACtD,aAAS,qBAAqB,QAAQ;AACtC,WAAO;;GAEU;GACnB,sBAAsB,kBAAkB,eAAe,QAAQ;GAC/D,4BAA4B,kBAA0BE,6CAA6B,QAAQ,sBAAsB,cAAc,CAAC;GACjI;;AAGH,QAAO;EACL,IAAI,UAAU;AACZ,OAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0FAA0F;AACxH,UAAO;;EAET,IAAI,WAAW;AACb,UAAO;;EAET,YAAY;EACZ;EACD"}
+{"version":3,"file":"algorand-fixture.js","names":["ClientManager","TransactionLogger","AlgorandClient","getTestAccount","algos","runWhenIndexerCaughtUp"],"sources":["../../../src/testing/fixtures/algorand-fixture.ts"],"sourcesContent":["import { algos, Config } from '../../'\nimport { AlgorandClient } from '../../algorand-client'\nimport { ClientManager } from '../../client-manager'\nimport { AlgoConfig } from '../../network-client'\nimport { getTestAccount } from '../account'\nimport { runWhenIndexerCaughtUp } from '../indexer'\nimport { TransactionLogger } from '../transaction-logger'\nimport { AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams } from '../types'\n\n/**\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd (or their respective config) if you want to test against\n * an explicitly defined network.\n *\n * @example No config (per-test isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeEach(fixture.newScope)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example No config (test suite isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeAll(fixture.newScope)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example With config\n * ```typescript\n * const fixture = algorandFixture({\n *  algod: new AlgodClient({ baseUrl: 'http://localhost:12345', headers: { 'X-Algo-API-Token': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' } }),\n *  // ...\n * })\n *\n * beforeEach(fixture.newScope)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @param fixtureConfig The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig): AlgorandFixture\n\n/**\n * @deprecated Config can be passed in directly to fixture config now.\n *\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd if you want to test against an explicitly defined network.\n *\n * @param fixtureConfig The fixture configuration\n * @param config The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig: AlgorandFixtureConfig | undefined, config: AlgoConfig): AlgorandFixture\n\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig, config?: AlgoConfig): AlgorandFixture {\n  fixtureConfig = { ...fixtureConfig, ...config }\n  if (!fixtureConfig.algod || !fixtureConfig.indexer || !fixtureConfig.kmd) {\n    fixtureConfig = { ...ClientManager.getConfigFromEnvironmentOrLocalNet(), ...fixtureConfig }\n  }\n\n  const algod = fixtureConfig.algod ?? ClientManager.getAlgodClient(fixtureConfig.algodConfig!)\n  const indexer = fixtureConfig.indexer ?? ClientManager.getIndexerClient(fixtureConfig.indexerConfig!)\n  const kmd = fixtureConfig.kmd ?? ClientManager.getKmdClient(fixtureConfig.kmdConfig!)\n  let context: AlgorandTestAutomationContext\n  let algorand: AlgorandClient\n\n  const newScope = async () => {\n    Config.configure({ debug: true })\n    const transactionLogger = new TransactionLogger()\n    const transactionLoggerAlgod = transactionLogger.capture(algod)\n\n    algorand = AlgorandClient.fromClients({ algod: transactionLoggerAlgod, indexer, kmd }).setSuggestedParamsCacheTimeout(0)\n\n    const testAccount = await getTestAccount({ initialFunds: fixtureConfig?.testAccountFunding ?? algos(10), suppressLog: true }, algorand)\n    algorand.setSignerFromAccount(testAccount)\n\n    // If running against LocalNet we are likely in dev mode and we need to set a much higher validity window\n    //  otherwise we are more likely to get invalid transactions.\n    if (await algorand.client.isLocalNet()) {\n      algorand.setDefaultValidityWindow(1000)\n    }\n    context = {\n      algorand,\n      algod: transactionLoggerAlgod,\n      indexer: indexer,\n      kmd: kmd,\n      testAccount,\n      generateAccount: async (params: GetTestAccountParams) => {\n        const account = await getTestAccount(params, algorand)\n        algorand.setSignerFromAccount(account)\n        return account\n      },\n      transactionLogger: transactionLogger,\n      waitForIndexer: () => transactionLogger.waitForIndexer(indexer),\n      waitForIndexerTransaction: (transactionId: string) => runWhenIndexerCaughtUp(() => indexer.lookupTransactionById(transactionId)),\n    }\n  }\n\n  return {\n    get context() {\n      if (!context) throw new Error('Context not initialised; make sure to call fixture.newScope() before accessing context.')\n      return context\n    },\n    get algorand() {\n      return algorand\n    },\n    beforeEach: newScope,\n    newScope,\n  }\n}\n"],"mappings":";;;;;;;;;AA4EA,SAAgB,gBAAgB,eAAuC,QAAsC;AAC3G,iBAAgB;EAAE,GAAG;EAAe,GAAG;EAAQ;AAC/C,KAAI,CAAC,cAAc,SAAS,CAAC,cAAc,WAAW,CAAC,cAAc,IACnE,iBAAgB;EAAE,GAAGA,qCAAc,oCAAoC;EAAE,GAAG;EAAe;CAG7F,MAAM,QAAQ,cAAc,SAASA,qCAAc,eAAe,cAAc,YAAa;CAC7F,MAAM,UAAU,cAAc,WAAWA,qCAAc,iBAAiB,cAAc,cAAe;CACrG,MAAM,MAAM,cAAc,OAAOA,qCAAc,aAAa,cAAc,UAAW;CACrF,IAAI;CACJ,IAAI;CAEJ,MAAM,WAAW,YAAY;AAC3B,wBAAO,UAAU,EAAE,OAAO,MAAM,CAAC;EACjC,MAAM,oBAAoB,IAAIC,8CAAmB;EACjD,MAAM,yBAAyB,kBAAkB,QAAQ,MAAM;AAE/D,aAAWC,uCAAe,YAAY;GAAE,OAAO;GAAwB;GAAS;GAAK,CAAC,CAAC,+BAA+B,EAAE;EAExH,MAAM,cAAc,MAAMC,+BAAe;GAAE,cAAc,eAAe,sBAAsBC,qBAAM,GAAG;GAAE,aAAa;GAAM,EAAE,SAAS;AACvI,WAAS,qBAAqB,YAAY;AAI1C,MAAI,MAAM,SAAS,OAAO,YAAY,CACpC,UAAS,yBAAyB,IAAK;AAEzC,YAAU;GACR;GACA,OAAO;GACE;GACJ;GACL;GACA,iBAAiB,OAAO,WAAiC;IACvD,MAAM,UAAU,MAAMD,+BAAe,QAAQ,SAAS;AACtD,aAAS,qBAAqB,QAAQ;AACtC,WAAO;;GAEU;GACnB,sBAAsB,kBAAkB,eAAe,QAAQ;GAC/D,4BAA4B,kBAA0BE,6CAA6B,QAAQ,sBAAsB,cAAc,CAAC;GACjI;;AAGH,QAAO;EACL,IAAI,UAAU;AACZ,OAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0FAA0F;AACxH,UAAO;;EAET,IAAI,WAAW;AACb,UAAO;;EAET,YAAY;EACZ;EACD"}

package/testing/fixtures/algorand-fixture.mjs

@@ -1,7 +1,7 @@
 import { algos } from "../../amount.mjs";
 import { Config } from "../../config.mjs";
-import { ClientManager } from "../../types/client-manager.mjs";
-import { AlgorandClient } from "../../types/algorand-client.mjs";
+import { ClientManager } from "../../client-manager.mjs";
+import { AlgorandClient } from "../../algorand-client.mjs";
 import { getTestAccount } from "../account.mjs";
 import { runWhenIndexerCaughtUp } from "../indexer.mjs";
 import { TransactionLogger } from "../transaction-logger.mjs";

package/testing/fixtures/algorand-fixture.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"algorand-fixture.mjs","names":["context: AlgorandTestAutomationContext","algorand: AlgorandClient"],"sources":["../../../src/testing/fixtures/algorand-fixture.ts"],"sourcesContent":["import { algos, Config } from '../../'\nimport { AlgorandClient } from '../../types/algorand-client'\nimport { ClientManager } from '../../types/client-manager'\nimport { AlgoConfig } from '../../types/network-client'\nimport { AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams } from '../../types/testing'\nimport { getTestAccount } from '../account'\nimport { runWhenIndexerCaughtUp } from '../indexer'\nimport { TransactionLogger } from '../transaction-logger'\n\n/**\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd (or their respective config) if you want to test against\n * an explicitly defined network.\n *\n * @example No config (per-test isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeEach(fixture.newScope, 10_000)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example No config (test suite isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeAll(fixture.newScope, 10_000)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example With config\n * ```typescript\n * const fixture = algorandFixture({\n *  algod: new AlgodClient({ baseUrl: 'http://localhost:12345', headers: { 'X-Algo-API-Token': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' } }),\n *  // ...\n * })\n *\n * beforeEach(fixture.newScope, 10_000)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @param fixtureConfig The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig): AlgorandFixture\n\n/**\n * @deprecated Config can be passed in directly to fixture config now.\n *\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd if you want to test against an explicitly defined network.\n *\n * @param fixtureConfig The fixture configuration\n * @param config The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig: AlgorandFixtureConfig | undefined, config: AlgoConfig): AlgorandFixture\n\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig, config?: AlgoConfig): AlgorandFixture {\n  fixtureConfig = { ...fixtureConfig, ...config }\n  if (!fixtureConfig.algod || !fixtureConfig.indexer || !fixtureConfig.kmd) {\n    fixtureConfig = { ...ClientManager.getConfigFromEnvironmentOrLocalNet(), ...fixtureConfig }\n  }\n\n  const algod = fixtureConfig.algod ?? ClientManager.getAlgodClient(fixtureConfig.algodConfig!)\n  const indexer = fixtureConfig.indexer ?? ClientManager.getIndexerClient(fixtureConfig.indexerConfig!)\n  const kmd = fixtureConfig.kmd ?? ClientManager.getKmdClient(fixtureConfig.kmdConfig!)\n  let context: AlgorandTestAutomationContext\n  let algorand: AlgorandClient\n\n  const newScope = async () => {\n    Config.configure({ debug: true })\n    const transactionLogger = new TransactionLogger()\n    const transactionLoggerAlgod = transactionLogger.capture(algod)\n\n    algorand = AlgorandClient.fromClients({ algod: transactionLoggerAlgod, indexer, kmd }).setSuggestedParamsCacheTimeout(0)\n\n    const testAccount = await getTestAccount({ initialFunds: fixtureConfig?.testAccountFunding ?? algos(10), suppressLog: true }, algorand)\n    algorand.setSignerFromAccount(testAccount)\n\n    // If running against LocalNet we are likely in dev mode and we need to set a much higher validity window\n    //  otherwise we are more likely to get invalid transactions.\n    if (await algorand.client.isLocalNet()) {\n      algorand.setDefaultValidityWindow(1000)\n    }\n    context = {\n      algorand,\n      algod: transactionLoggerAlgod,\n      indexer: indexer,\n      kmd: kmd,\n      testAccount,\n      generateAccount: async (params: GetTestAccountParams) => {\n        const account = await getTestAccount(params, algorand)\n        algorand.setSignerFromAccount(account)\n        return account\n      },\n      transactionLogger: transactionLogger,\n      waitForIndexer: () => transactionLogger.waitForIndexer(indexer),\n      waitForIndexerTransaction: (transactionId: string) => runWhenIndexerCaughtUp(() => indexer.lookupTransactionById(transactionId)),\n    }\n  }\n\n  return {\n    get context() {\n      if (!context) throw new Error('Context not initialised; make sure to call fixture.newScope() before accessing context.')\n      return context\n    },\n    get algorand() {\n      return algorand\n    },\n    beforeEach: newScope,\n    newScope,\n  }\n}\n"],"mappings":";;;;;;;;;AA4EA,SAAgB,gBAAgB,eAAuC,QAAsC;AAC3G,iBAAgB;EAAE,GAAG;EAAe,GAAG;EAAQ;AAC/C,KAAI,CAAC,cAAc,SAAS,CAAC,cAAc,WAAW,CAAC,cAAc,IACnE,iBAAgB;EAAE,GAAG,cAAc,oCAAoC;EAAE,GAAG;EAAe;CAG7F,MAAM,QAAQ,cAAc,SAAS,cAAc,eAAe,cAAc,YAAa;CAC7F,MAAM,UAAU,cAAc,WAAW,cAAc,iBAAiB,cAAc,cAAe;CACrG,MAAM,MAAM,cAAc,OAAO,cAAc,aAAa,cAAc,UAAW;CACrF,IAAIA;CACJ,IAAIC;CAEJ,MAAM,WAAW,YAAY;AAC3B,SAAO,UAAU,EAAE,OAAO,MAAM,CAAC;EACjC,MAAM,oBAAoB,IAAI,mBAAmB;EACjD,MAAM,yBAAyB,kBAAkB,QAAQ,MAAM;AAE/D,aAAW,eAAe,YAAY;GAAE,OAAO;GAAwB;GAAS;GAAK,CAAC,CAAC,+BAA+B,EAAE;EAExH,MAAM,cAAc,MAAM,eAAe;GAAE,cAAc,eAAe,sBAAsB,MAAM,GAAG;GAAE,aAAa;GAAM,EAAE,SAAS;AACvI,WAAS,qBAAqB,YAAY;AAI1C,MAAI,MAAM,SAAS,OAAO,YAAY,CACpC,UAAS,yBAAyB,IAAK;AAEzC,YAAU;GACR;GACA,OAAO;GACE;GACJ;GACL;GACA,iBAAiB,OAAO,WAAiC;IACvD,MAAM,UAAU,MAAM,eAAe,QAAQ,SAAS;AACtD,aAAS,qBAAqB,QAAQ;AACtC,WAAO;;GAEU;GACnB,sBAAsB,kBAAkB,eAAe,QAAQ;GAC/D,4BAA4B,kBAA0B,6BAA6B,QAAQ,sBAAsB,cAAc,CAAC;GACjI;;AAGH,QAAO;EACL,IAAI,UAAU;AACZ,OAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0FAA0F;AACxH,UAAO;;EAET,IAAI,WAAW;AACb,UAAO;;EAET,YAAY;EACZ;EACD"}
+{"version":3,"file":"algorand-fixture.mjs","names":[],"sources":["../../../src/testing/fixtures/algorand-fixture.ts"],"sourcesContent":["import { algos, Config } from '../../'\nimport { AlgorandClient } from '../../algorand-client'\nimport { ClientManager } from '../../client-manager'\nimport { AlgoConfig } from '../../network-client'\nimport { getTestAccount } from '../account'\nimport { runWhenIndexerCaughtUp } from '../indexer'\nimport { TransactionLogger } from '../transaction-logger'\nimport { AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams } from '../types'\n\n/**\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd (or their respective config) if you want to test against\n * an explicitly defined network.\n *\n * @example No config (per-test isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeEach(fixture.newScope)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example No config (test suite isolation)\n * ```typescript\n * const fixture = algorandFixture()\n *\n * beforeAll(fixture.newScope)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @example With config\n * ```typescript\n * const fixture = algorandFixture({\n *  algod: new AlgodClient({ baseUrl: 'http://localhost:12345', headers: { 'X-Algo-API-Token': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' } }),\n *  // ...\n * })\n *\n * beforeEach(fixture.newScope)\n *\n * test('My test', async () => {\n *     const {algod, indexer, testAccount, ...} = fixture.context\n *     // test things...\n * })\n * ```\n *\n * @param fixtureConfig The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig): AlgorandFixture\n\n/**\n * @deprecated Config can be passed in directly to fixture config now.\n *\n * Creates a test fixture for automated testing against Algorand.\n * By default it tests against an environment variable specified client\n *  if the standard environment variables are specified, otherwise against\n *  a default LocalNet instance, but you can pass in an algod, indexer\n *  and/or kmd if you want to test against an explicitly defined network.\n *\n * @param fixtureConfig The fixture configuration\n * @param config The fixture configuration\n * @returns The fixture\n */\nexport function algorandFixture(fixtureConfig: AlgorandFixtureConfig | undefined, config: AlgoConfig): AlgorandFixture\n\nexport function algorandFixture(fixtureConfig?: AlgorandFixtureConfig, config?: AlgoConfig): AlgorandFixture {\n  fixtureConfig = { ...fixtureConfig, ...config }\n  if (!fixtureConfig.algod || !fixtureConfig.indexer || !fixtureConfig.kmd) {\n    fixtureConfig = { ...ClientManager.getConfigFromEnvironmentOrLocalNet(), ...fixtureConfig }\n  }\n\n  const algod = fixtureConfig.algod ?? ClientManager.getAlgodClient(fixtureConfig.algodConfig!)\n  const indexer = fixtureConfig.indexer ?? ClientManager.getIndexerClient(fixtureConfig.indexerConfig!)\n  const kmd = fixtureConfig.kmd ?? ClientManager.getKmdClient(fixtureConfig.kmdConfig!)\n  let context: AlgorandTestAutomationContext\n  let algorand: AlgorandClient\n\n  const newScope = async () => {\n    Config.configure({ debug: true })\n    const transactionLogger = new TransactionLogger()\n    const transactionLoggerAlgod = transactionLogger.capture(algod)\n\n    algorand = AlgorandClient.fromClients({ algod: transactionLoggerAlgod, indexer, kmd }).setSuggestedParamsCacheTimeout(0)\n\n    const testAccount = await getTestAccount({ initialFunds: fixtureConfig?.testAccountFunding ?? algos(10), suppressLog: true }, algorand)\n    algorand.setSignerFromAccount(testAccount)\n\n    // If running against LocalNet we are likely in dev mode and we need to set a much higher validity window\n    //  otherwise we are more likely to get invalid transactions.\n    if (await algorand.client.isLocalNet()) {\n      algorand.setDefaultValidityWindow(1000)\n    }\n    context = {\n      algorand,\n      algod: transactionLoggerAlgod,\n      indexer: indexer,\n      kmd: kmd,\n      testAccount,\n      generateAccount: async (params: GetTestAccountParams) => {\n        const account = await getTestAccount(params, algorand)\n        algorand.setSignerFromAccount(account)\n        return account\n      },\n      transactionLogger: transactionLogger,\n      waitForIndexer: () => transactionLogger.waitForIndexer(indexer),\n      waitForIndexerTransaction: (transactionId: string) => runWhenIndexerCaughtUp(() => indexer.lookupTransactionById(transactionId)),\n    }\n  }\n\n  return {\n    get context() {\n      if (!context) throw new Error('Context not initialised; make sure to call fixture.newScope() before accessing context.')\n      return context\n    },\n    get algorand() {\n      return algorand\n    },\n    beforeEach: newScope,\n    newScope,\n  }\n}\n"],"mappings":";;;;;;;;;AA4EA,SAAgB,gBAAgB,eAAuC,QAAsC;AAC3G,iBAAgB;EAAE,GAAG;EAAe,GAAG;EAAQ;AAC/C,KAAI,CAAC,cAAc,SAAS,CAAC,cAAc,WAAW,CAAC,cAAc,IACnE,iBAAgB;EAAE,GAAG,cAAc,oCAAoC;EAAE,GAAG;EAAe;CAG7F,MAAM,QAAQ,cAAc,SAAS,cAAc,eAAe,cAAc,YAAa;CAC7F,MAAM,UAAU,cAAc,WAAW,cAAc,iBAAiB,cAAc,cAAe;CACrG,MAAM,MAAM,cAAc,OAAO,cAAc,aAAa,cAAc,UAAW;CACrF,IAAI;CACJ,IAAI;CAEJ,MAAM,WAAW,YAAY;AAC3B,SAAO,UAAU,EAAE,OAAO,MAAM,CAAC;EACjC,MAAM,oBAAoB,IAAI,mBAAmB;EACjD,MAAM,yBAAyB,kBAAkB,QAAQ,MAAM;AAE/D,aAAW,eAAe,YAAY;GAAE,OAAO;GAAwB;GAAS;GAAK,CAAC,CAAC,+BAA+B,EAAE;EAExH,MAAM,cAAc,MAAM,eAAe;GAAE,cAAc,eAAe,sBAAsB,MAAM,GAAG;GAAE,aAAa;GAAM,EAAE,SAAS;AACvI,WAAS,qBAAqB,YAAY;AAI1C,MAAI,MAAM,SAAS,OAAO,YAAY,CACpC,UAAS,yBAAyB,IAAK;AAEzC,YAAU;GACR;GACA,OAAO;GACE;GACJ;GACL;GACA,iBAAiB,OAAO,WAAiC;IACvD,MAAM,UAAU,MAAM,eAAe,QAAQ,SAAS;AACtD,aAAS,qBAAqB,QAAQ;AACtC,WAAO;;GAEU;GACnB,sBAAsB,kBAAkB,eAAe,QAAQ;GAC/D,4BAA4B,kBAA0B,6BAA6B,QAAQ,sBAAsB,cAAc,CAAC;GACjI;;AAGH,QAAO;EACL,IAAI,UAAU;AACZ,OAAI,CAAC,QAAS,OAAM,IAAI,MAAM,0FAA0F;AACxH,UAAO;;EAET,IAAI,WAAW;AACb,UAAO;;EAET,YAAY;EACZ;EACD"}

package/testing/index.d.ts

@@ -1,7 +1,8 @@
 import { TestLogger } from "./test-logger.js";
+import { AlgoKitLogCaptureFixture, AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams, LogSnapshotConfig } from "./types.js";
 import { getTestAccount } from "./account.js";
 import { algoKitLogCaptureFixture } from "./fixtures/algokit-log-capture-fixture.js";
 import { algorandFixture } from "./fixtures/algorand-fixture.js";
 import { runWhenIndexerCaughtUp } from "./indexer.js";
 import { TransactionLogger } from "./transaction-logger.js";
-export { TestLogger, TransactionLogger, algoKitLogCaptureFixture, algorandFixture, getTestAccount, runWhenIndexerCaughtUp };
+export { AlgoKitLogCaptureFixture, AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams, LogSnapshotConfig, TestLogger, TransactionLogger, algoKitLogCaptureFixture, algorandFixture, getTestAccount, runWhenIndexerCaughtUp };

package/testing/index.js

@@ -1,3 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_mockServer = require('../packages/testing/src/mockServer.js');
+const require_globalSetup = require('../packages/testing/src/globalSetup.js');
 const require_account = require('./account.js');
 const require_test_logger = require('./test-logger.js');
 const require_algokit_log_capture_fixture = require('./fixtures/algokit-log-capture-fixture.js');
@@ -5,9 +8,25 @@ const require_indexer = require('./indexer.js');
 const require_transaction_logger = require('./transaction-logger.js');
 const require_algorand_fixture = require('./fixtures/algorand-fixture.js');
 
+exports.DEFAULT_TOKEN = require_mockServer.DEFAULT_TOKEN;
+exports.EXTERNAL_URL_ENV_VARS = require_mockServer.EXTERNAL_URL_ENV_VARS;
+exports.MOCK_PORTS = require_mockServer.MOCK_PORTS;
+exports.TEST_ADDRESS = require_mockServer.TEST_ADDRESS;
+exports.TEST_APP_ID = require_mockServer.TEST_APP_ID;
+exports.TEST_APP_ID_WITH_BOXES = require_mockServer.TEST_APP_ID_WITH_BOXES;
+exports.TEST_ASSET_ID = require_mockServer.TEST_ASSET_ID;
+exports.TEST_BOX_NAME = require_mockServer.TEST_BOX_NAME;
+exports.TEST_ROUND = require_mockServer.TEST_ROUND;
+exports.TEST_TXID = require_mockServer.TEST_TXID;
 exports.TestLogger = require_test_logger.TestLogger;
 exports.TransactionLogger = require_transaction_logger.TransactionLogger;
 exports.algoKitLogCaptureFixture = require_algokit_log_capture_fixture.algoKitLogCaptureFixture;
+exports.algodGlobalSetup = require_globalSetup.algodGlobalSetup;
 exports.algorandFixture = require_algorand_fixture.algorandFixture;
+exports.checkServerHealth = require_mockServer.checkServerHealth;
+exports.createGlobalSetup = require_globalSetup.createGlobalSetup;
+exports.getMockServer = require_mockServer.getMockServer;
 exports.getTestAccount = require_account.getTestAccount;
+exports.indexerGlobalSetup = require_globalSetup.indexerGlobalSetup;
+exports.kmdGlobalSetup = require_globalSetup.kmdGlobalSetup;
 exports.runWhenIndexerCaughtUp = require_indexer.runWhenIndexerCaughtUp;

package/testing/index.mjs

@@ -1,3 +1,5 @@
+import { DEFAULT_TOKEN, EXTERNAL_URL_ENV_VARS, MOCK_PORTS, TEST_ADDRESS, TEST_APP_ID, TEST_APP_ID_WITH_BOXES, TEST_ASSET_ID, TEST_BOX_NAME, TEST_ROUND, TEST_TXID, checkServerHealth, getMockServer } from "../packages/testing/src/mockServer.mjs";
+import { algodGlobalSetup, createGlobalSetup, indexerGlobalSetup, kmdGlobalSetup } from "../packages/testing/src/globalSetup.mjs";
 import { getTestAccount } from "./account.mjs";
 import { TestLogger } from "./test-logger.mjs";
 import { algoKitLogCaptureFixture } from "./fixtures/algokit-log-capture-fixture.mjs";
@@ -5,4 +7,4 @@ import { runWhenIndexerCaughtUp } from "./indexer.mjs";
 import { TransactionLogger } from "./transaction-logger.mjs";
 import { algorandFixture } from "./fixtures/algorand-fixture.mjs";
 
-export { TestLogger, TransactionLogger, algoKitLogCaptureFixture, algorandFixture, getTestAccount, runWhenIndexerCaughtUp };
+export { DEFAULT_TOKEN, EXTERNAL_URL_ENV_VARS, MOCK_PORTS, TEST_ADDRESS, TEST_APP_ID, TEST_APP_ID_WITH_BOXES, TEST_ASSET_ID, TEST_BOX_NAME, TEST_ROUND, TEST_TXID, TestLogger, TransactionLogger, algoKitLogCaptureFixture, algodGlobalSetup, algorandFixture, checkServerHealth, createGlobalSetup, getMockServer, getTestAccount, indexerGlobalSetup, kmdGlobalSetup, runWhenIndexerCaughtUp };

package/testing/indexer.js.map

@@ -1 +1 @@
-{"version":3,"file":"indexer.js","names":["result: T | null","e: any"],"sources":["../../src/testing/indexer.ts"],"sourcesContent":["/**\n * Runs the given indexer call until a 404 error is no longer returned.\n * Tried every 200ms up to 100 times.\n * Very rudimentary implementation designed for automated testing.\n * @example\n * ```typescript\n * const transaction = await runWhenIndexerCaughtUp(() => indexer.lookupTransactionByID(txnId).do())\n * ```\n * @param run The code to run\n * @returns The result (as a promise), or throws if the indexer didn't catch up in time\n */\nexport async function runWhenIndexerCaughtUp<T>(run: () => Promise<T>): Promise<T> {\n  let result: T | null = null\n  let ok = false\n  let tries = 0\n  while (!ok) {\n    try {\n      result = await run()\n      ok = true\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if (e?.status === 404) {\n        tries++\n        if (tries > 100) {\n          throw e\n        }\n        await new Promise<void>((resolve) => setTimeout(resolve, 200))\n      } else {\n        throw e\n      }\n    }\n  }\n\n  return result as T\n}\n"],"mappings":";;;;;;;;;;;;;AAWA,eAAsB,uBAA0B,KAAmC;CACjF,IAAIA,SAAmB;CACvB,IAAI,KAAK;CACT,IAAI,QAAQ;AACZ,QAAO,CAAC,GACN,KAAI;AACF,WAAS,MAAM,KAAK;AACpB,OAAK;UAEEC,GAAQ;AACf,MAAI,GAAG,WAAW,KAAK;AACrB;AACA,OAAI,QAAQ,IACV,OAAM;AAER,SAAM,IAAI,SAAe,YAAY,WAAW,SAAS,IAAI,CAAC;QAE9D,OAAM;;AAKZ,QAAO"}
+{"version":3,"file":"indexer.js","names":[],"sources":["../../src/testing/indexer.ts"],"sourcesContent":["/**\n * Runs the given indexer call until a 404 error is no longer returned.\n * Tried every 200ms up to 100 times.\n * Very rudimentary implementation designed for automated testing.\n * @example\n * ```typescript\n * const transaction = await runWhenIndexerCaughtUp(() => indexer.lookupTransactionByID(txnId).do())\n * ```\n * @param run The code to run\n * @returns The result (as a promise), or throws if the indexer didn't catch up in time\n */\nexport async function runWhenIndexerCaughtUp<T>(run: () => Promise<T>): Promise<T> {\n  let result: T | null = null\n  let ok = false\n  let tries = 0\n  while (!ok) {\n    try {\n      result = await run()\n      ok = true\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if (e?.status === 404) {\n        tries++\n        if (tries > 100) {\n          throw e\n        }\n        await new Promise<void>((resolve) => setTimeout(resolve, 200))\n      } else {\n        throw e\n      }\n    }\n  }\n\n  return result as T\n}\n"],"mappings":";;;;;;;;;;;;;AAWA,eAAsB,uBAA0B,KAAmC;CACjF,IAAI,SAAmB;CACvB,IAAI,KAAK;CACT,IAAI,QAAQ;AACZ,QAAO,CAAC,GACN,KAAI;AACF,WAAS,MAAM,KAAK;AACpB,OAAK;UAEE,GAAQ;AACf,MAAI,GAAG,WAAW,KAAK;AACrB;AACA,OAAI,QAAQ,IACV,OAAM;AAER,SAAM,IAAI,SAAe,YAAY,WAAW,SAAS,IAAI,CAAC;QAE9D,OAAM;;AAKZ,QAAO"}

package/testing/indexer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"indexer.mjs","names":["result: T | null","e: any"],"sources":["../../src/testing/indexer.ts"],"sourcesContent":["/**\n * Runs the given indexer call until a 404 error is no longer returned.\n * Tried every 200ms up to 100 times.\n * Very rudimentary implementation designed for automated testing.\n * @example\n * ```typescript\n * const transaction = await runWhenIndexerCaughtUp(() => indexer.lookupTransactionByID(txnId).do())\n * ```\n * @param run The code to run\n * @returns The result (as a promise), or throws if the indexer didn't catch up in time\n */\nexport async function runWhenIndexerCaughtUp<T>(run: () => Promise<T>): Promise<T> {\n  let result: T | null = null\n  let ok = false\n  let tries = 0\n  while (!ok) {\n    try {\n      result = await run()\n      ok = true\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if (e?.status === 404) {\n        tries++\n        if (tries > 100) {\n          throw e\n        }\n        await new Promise<void>((resolve) => setTimeout(resolve, 200))\n      } else {\n        throw e\n      }\n    }\n  }\n\n  return result as T\n}\n"],"mappings":";;;;;;;;;;;;AAWA,eAAsB,uBAA0B,KAAmC;CACjF,IAAIA,SAAmB;CACvB,IAAI,KAAK;CACT,IAAI,QAAQ;AACZ,QAAO,CAAC,GACN,KAAI;AACF,WAAS,MAAM,KAAK;AACpB,OAAK;UAEEC,GAAQ;AACf,MAAI,GAAG,WAAW,KAAK;AACrB;AACA,OAAI,QAAQ,IACV,OAAM;AAER,SAAM,IAAI,SAAe,YAAY,WAAW,SAAS,IAAI,CAAC;QAE9D,OAAM;;AAKZ,QAAO"}
+{"version":3,"file":"indexer.mjs","names":[],"sources":["../../src/testing/indexer.ts"],"sourcesContent":["/**\n * Runs the given indexer call until a 404 error is no longer returned.\n * Tried every 200ms up to 100 times.\n * Very rudimentary implementation designed for automated testing.\n * @example\n * ```typescript\n * const transaction = await runWhenIndexerCaughtUp(() => indexer.lookupTransactionByID(txnId).do())\n * ```\n * @param run The code to run\n * @returns The result (as a promise), or throws if the indexer didn't catch up in time\n */\nexport async function runWhenIndexerCaughtUp<T>(run: () => Promise<T>): Promise<T> {\n  let result: T | null = null\n  let ok = false\n  let tries = 0\n  while (!ok) {\n    try {\n      result = await run()\n      ok = true\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } catch (e: any) {\n      if (e?.status === 404) {\n        tries++\n        if (tries > 100) {\n          throw e\n        }\n        await new Promise<void>((resolve) => setTimeout(resolve, 200))\n      } else {\n        throw e\n      }\n    }\n  }\n\n  return result as T\n}\n"],"mappings":";;;;;;;;;;;;AAWA,eAAsB,uBAA0B,KAAmC;CACjF,IAAI,SAAmB;CACvB,IAAI,KAAK;CACT,IAAI,QAAQ;AACZ,QAAO,CAAC,GACN,KAAI;AACF,WAAS,MAAM,KAAK;AACpB,OAAK;UAEE,GAAQ;AACf,MAAI,GAAG,WAAW,KAAK;AACrB;AACA,OAAI,QAAQ,IACV,OAAM;AAER,SAAM,IAAI,SAAe,YAAY,WAAW,SAAS,IAAI,CAAC;QAE9D,OAAM;;AAKZ,QAAO"}

package/testing/test-logger.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from "../packages/common/src/logger.js";
-import { LogSnapshotConfig } from "../types/testing.js";
+import { LogSnapshotConfig } from "./types.js";
 
 //#region src/testing/test-logger.d.ts
 

package/testing/test-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-logger.js","names":["asJson"],"sources":["../../src/testing/test-logger.ts"],"sourcesContent":["import { Logger } from '../types/logging'\nimport { LogSnapshotConfig } from '../types/testing'\nimport { asJson } from '../util'\n\n/** Exposes an AlgoKit logger which captures log messages, while wrapping an original logger.\n * This is useful for automated testing.\n */\nexport class TestLogger implements Logger {\n  private originalLogger: Logger | undefined\n  private logs: string[]\n\n  /**\n   * Create a new test logger that wraps the given logger if provided.\n   * @param originalLogger The optional original logger to wrap.\n   */\n  constructor(originalLogger?: Logger) {\n    this.originalLogger = originalLogger\n    this.logs = []\n  }\n\n  /** Returns all logs captured thus far. */\n  get capturedLogs(): string[] {\n    return this.logs\n  }\n\n  /** Clears all logs captured so far. */\n  clear() {\n    this.logs = []\n  }\n\n  /**\n   * Returns a captured log snapshot.\n   * This helps ensure that the provided configuration items won't appear\n   *  with random values in the log snapshot, but rather will get substituted with predictable ids.\n   *\n   * https://jestjs.io/docs/snapshot-testing#2-tests-should-be-deterministic\n   *\n   * @example Jest Example\n   * ```typescript\n   * const logger = new TestLogger()\n   * ...\n   * expect(logger.getLogSnapshot()).toMatchSnapshot()\n   * ```\n   * @param config The snapshot configuration\n   * @returns The snapshotted logs.\n   */\n  getLogSnapshot(config?: LogSnapshotConfig) {\n    const { transactions: transactionIds, accounts, apps } = config ?? {}\n    let snapshot = this.capturedLogs.filter(config?.filterPredicate ?? (() => true)).join('\\n')\n    transactionIds?.forEach(\n      (txn, id) => (snapshot = snapshot.replace(new RegExp(typeof txn === 'string' ? txn : txn.txId(), 'g'), `TXID_${id + 1}`)),\n    )\n    accounts?.forEach(\n      (sender, id) =>\n        (snapshot = snapshot.replace(\n          new RegExp(typeof sender === 'string' ? sender : 'addr' in sender ? sender.addr.toString() : sender.toString(), 'g'),\n          `ACCOUNT_${id + 1}`,\n        )),\n    )\n    apps?.forEach((app, id) => (snapshot = snapshot.replace(new RegExp(`\\\\b${app.toString()}\\\\b(?! bytes)`, 'g'), `APP_${id + 1}`)))\n    return snapshot\n  }\n\n  error(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.error(message, ...optionalParams)\n    this.logs.push(`ERROR: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  warn(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.warn(message, ...optionalParams)\n    this.logs.push(`WARN: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  info(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.info(message, ...optionalParams)\n    this.logs.push(`INFO: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  verbose(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.verbose(message, ...optionalParams)\n    this.logs.push(`VERBOSE: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  debug(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.debug(message, ...optionalParams)\n    this.logs.push(`DEBUG: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n}\n"],"mappings":";;;;;;AAOA,IAAa,aAAb,MAA0C;CACxC,AAAQ;CACR,AAAQ;;;;;CAMR,YAAY,gBAAyB;AACnC,OAAK,iBAAiB;AACtB,OAAK,OAAO,EAAE;;;CAIhB,IAAI,eAAyB;AAC3B,SAAO,KAAK;;;CAId,QAAQ;AACN,OAAK,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAmBhB,eAAe,QAA4B;EACzC,MAAM,EAAE,cAAc,gBAAgB,UAAU,SAAS,UAAU,EAAE;EACrE,IAAI,WAAW,KAAK,aAAa,OAAO,QAAQ,0BAA0B,MAAM,CAAC,KAAK,KAAK;AAC3F,kBAAgB,SACb,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CACzH;AACD,YAAU,SACP,QAAQ,OACN,WAAW,SAAS,QACnB,IAAI,OAAO,OAAO,WAAW,WAAW,SAAS,UAAU,SAAS,OAAO,KAAK,UAAU,GAAG,OAAO,UAAU,EAAE,IAAI,EACpH,WAAW,KAAK,IACjB,CACJ;AACD,QAAM,SAAS,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,MAAM,IAAI,UAAU,CAAC,gBAAgB,IAAI,EAAE,OAAO,KAAK,IAAI,CAAE;AAChI,SAAO;;CAGT,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAEnG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAElG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAElG,QAAQ,SAAiB,GAAG,gBAAiC;AAC3D,OAAK,gBAAgB,QAAQ,SAAS,GAAG,eAAe;AACxD,OAAK,KAAK,KAAK,YAAY,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAErG,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK"}
+{"version":3,"file":"test-logger.js","names":["asJson"],"sources":["../../src/testing/test-logger.ts"],"sourcesContent":["import { Logger } from '../logging'\nimport { asJson } from '../util'\nimport { LogSnapshotConfig } from './types'\n\n/** Exposes an AlgoKit logger which captures log messages, while wrapping an original logger.\n * This is useful for automated testing.\n */\nexport class TestLogger implements Logger {\n  private originalLogger: Logger | undefined\n  private logs: string[]\n\n  /**\n   * Create a new test logger that wraps the given logger if provided.\n   * @param originalLogger The optional original logger to wrap.\n   */\n  constructor(originalLogger?: Logger) {\n    this.originalLogger = originalLogger\n    this.logs = []\n  }\n\n  /** Returns all logs captured thus far. */\n  get capturedLogs(): string[] {\n    return this.logs\n  }\n\n  /** Clears all logs captured so far. */\n  clear() {\n    this.logs = []\n  }\n\n  /**\n   * Returns a captured log snapshot.\n   * This helps ensure that the provided configuration items won't appear\n   *  with random values in the log snapshot, but rather will get substituted with predictable ids.\n   *\n   * https://jestjs.io/docs/snapshot-testing#2-tests-should-be-deterministic\n   *\n   * @example Jest Example\n   * ```typescript\n   * const logger = new TestLogger()\n   * ...\n   * expect(logger.getLogSnapshot()).toMatchSnapshot()\n   * ```\n   * @param config The snapshot configuration\n   * @returns The snapshotted logs.\n   */\n  getLogSnapshot(config?: LogSnapshotConfig) {\n    const { transactions: transactionIds, accounts, apps } = config ?? {}\n    let snapshot = this.capturedLogs.filter(config?.filterPredicate ?? (() => true)).join('\\n')\n    transactionIds?.forEach(\n      (txn, id) => (snapshot = snapshot.replace(new RegExp(typeof txn === 'string' ? txn : txn.txId(), 'g'), `TXID_${id + 1}`)),\n    )\n    accounts?.forEach(\n      (sender, id) =>\n        (snapshot = snapshot.replace(\n          new RegExp(typeof sender === 'string' ? sender : 'addr' in sender ? sender.addr.toString() : sender.toString(), 'g'),\n          `ACCOUNT_${id + 1}`,\n        )),\n    )\n    apps?.forEach((app, id) => (snapshot = snapshot.replace(new RegExp(`\\\\b${app.toString()}\\\\b(?! bytes)`, 'g'), `APP_${id + 1}`)))\n    return snapshot\n  }\n\n  error(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.error(message, ...optionalParams)\n    this.logs.push(`ERROR: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  warn(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.warn(message, ...optionalParams)\n    this.logs.push(`WARN: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  info(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.info(message, ...optionalParams)\n    this.logs.push(`INFO: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  verbose(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.verbose(message, ...optionalParams)\n    this.logs.push(`VERBOSE: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  debug(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.debug(message, ...optionalParams)\n    this.logs.push(`DEBUG: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n}\n"],"mappings":";;;;;;AAOA,IAAa,aAAb,MAA0C;CACxC,AAAQ;CACR,AAAQ;;;;;CAMR,YAAY,gBAAyB;AACnC,OAAK,iBAAiB;AACtB,OAAK,OAAO,EAAE;;;CAIhB,IAAI,eAAyB;AAC3B,SAAO,KAAK;;;CAId,QAAQ;AACN,OAAK,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAmBhB,eAAe,QAA4B;EACzC,MAAM,EAAE,cAAc,gBAAgB,UAAU,SAAS,UAAU,EAAE;EACrE,IAAI,WAAW,KAAK,aAAa,OAAO,QAAQ,0BAA0B,MAAM,CAAC,KAAK,KAAK;AAC3F,kBAAgB,SACb,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CACzH;AACD,YAAU,SACP,QAAQ,OACN,WAAW,SAAS,QACnB,IAAI,OAAO,OAAO,WAAW,WAAW,SAAS,UAAU,SAAS,OAAO,KAAK,UAAU,GAAG,OAAO,UAAU,EAAE,IAAI,EACpH,WAAW,KAAK,IACjB,CACJ;AACD,QAAM,SAAS,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,MAAM,IAAI,UAAU,CAAC,gBAAgB,IAAI,EAAE,OAAO,KAAK,IAAI,CAAE;AAChI,SAAO;;CAGT,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAEnG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAElG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAElG,QAAQ,SAAiB,GAAG,gBAAiC;AAC3D,OAAK,gBAAgB,QAAQ,SAAS,GAAG,eAAe;AACxD,OAAK,KAAK,KAAK,YAAY,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK;;CAErG,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAMA,oBAAO,eAAe,KAAK,KAAK"}

package/testing/test-logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"test-logger.mjs","names":[],"sources":["../../src/testing/test-logger.ts"],"sourcesContent":["import { Logger } from '../types/logging'\nimport { LogSnapshotConfig } from '../types/testing'\nimport { asJson } from '../util'\n\n/** Exposes an AlgoKit logger which captures log messages, while wrapping an original logger.\n * This is useful for automated testing.\n */\nexport class TestLogger implements Logger {\n  private originalLogger: Logger | undefined\n  private logs: string[]\n\n  /**\n   * Create a new test logger that wraps the given logger if provided.\n   * @param originalLogger The optional original logger to wrap.\n   */\n  constructor(originalLogger?: Logger) {\n    this.originalLogger = originalLogger\n    this.logs = []\n  }\n\n  /** Returns all logs captured thus far. */\n  get capturedLogs(): string[] {\n    return this.logs\n  }\n\n  /** Clears all logs captured so far. */\n  clear() {\n    this.logs = []\n  }\n\n  /**\n   * Returns a captured log snapshot.\n   * This helps ensure that the provided configuration items won't appear\n   *  with random values in the log snapshot, but rather will get substituted with predictable ids.\n   *\n   * https://jestjs.io/docs/snapshot-testing#2-tests-should-be-deterministic\n   *\n   * @example Jest Example\n   * ```typescript\n   * const logger = new TestLogger()\n   * ...\n   * expect(logger.getLogSnapshot()).toMatchSnapshot()\n   * ```\n   * @param config The snapshot configuration\n   * @returns The snapshotted logs.\n   */\n  getLogSnapshot(config?: LogSnapshotConfig) {\n    const { transactions: transactionIds, accounts, apps } = config ?? {}\n    let snapshot = this.capturedLogs.filter(config?.filterPredicate ?? (() => true)).join('\\n')\n    transactionIds?.forEach(\n      (txn, id) => (snapshot = snapshot.replace(new RegExp(typeof txn === 'string' ? txn : txn.txId(), 'g'), `TXID_${id + 1}`)),\n    )\n    accounts?.forEach(\n      (sender, id) =>\n        (snapshot = snapshot.replace(\n          new RegExp(typeof sender === 'string' ? sender : 'addr' in sender ? sender.addr.toString() : sender.toString(), 'g'),\n          `ACCOUNT_${id + 1}`,\n        )),\n    )\n    apps?.forEach((app, id) => (snapshot = snapshot.replace(new RegExp(`\\\\b${app.toString()}\\\\b(?! bytes)`, 'g'), `APP_${id + 1}`)))\n    return snapshot\n  }\n\n  error(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.error(message, ...optionalParams)\n    this.logs.push(`ERROR: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  warn(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.warn(message, ...optionalParams)\n    this.logs.push(`WARN: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  info(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.info(message, ...optionalParams)\n    this.logs.push(`INFO: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  verbose(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.verbose(message, ...optionalParams)\n    this.logs.push(`VERBOSE: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  debug(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.debug(message, ...optionalParams)\n    this.logs.push(`DEBUG: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n}\n"],"mappings":";;;;;;AAOA,IAAa,aAAb,MAA0C;CACxC,AAAQ;CACR,AAAQ;;;;;CAMR,YAAY,gBAAyB;AACnC,OAAK,iBAAiB;AACtB,OAAK,OAAO,EAAE;;;CAIhB,IAAI,eAAyB;AAC3B,SAAO,KAAK;;;CAId,QAAQ;AACN,OAAK,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAmBhB,eAAe,QAA4B;EACzC,MAAM,EAAE,cAAc,gBAAgB,UAAU,SAAS,UAAU,EAAE;EACrE,IAAI,WAAW,KAAK,aAAa,OAAO,QAAQ,0BAA0B,MAAM,CAAC,KAAK,KAAK;AAC3F,kBAAgB,SACb,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CACzH;AACD,YAAU,SACP,QAAQ,OACN,WAAW,SAAS,QACnB,IAAI,OAAO,OAAO,WAAW,WAAW,SAAS,UAAU,SAAS,OAAO,KAAK,UAAU,GAAG,OAAO,UAAU,EAAE,IAAI,EACpH,WAAW,KAAK,IACjB,CACJ;AACD,QAAM,SAAS,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,MAAM,IAAI,UAAU,CAAC,gBAAgB,IAAI,EAAE,OAAO,KAAK,IAAI,CAAE;AAChI,SAAO;;CAGT,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAEnG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAElG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAElG,QAAQ,SAAiB,GAAG,gBAAiC;AAC3D,OAAK,gBAAgB,QAAQ,SAAS,GAAG,eAAe;AACxD,OAAK,KAAK,KAAK,YAAY,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAErG,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK"}
+{"version":3,"file":"test-logger.mjs","names":[],"sources":["../../src/testing/test-logger.ts"],"sourcesContent":["import { Logger } from '../logging'\nimport { asJson } from '../util'\nimport { LogSnapshotConfig } from './types'\n\n/** Exposes an AlgoKit logger which captures log messages, while wrapping an original logger.\n * This is useful for automated testing.\n */\nexport class TestLogger implements Logger {\n  private originalLogger: Logger | undefined\n  private logs: string[]\n\n  /**\n   * Create a new test logger that wraps the given logger if provided.\n   * @param originalLogger The optional original logger to wrap.\n   */\n  constructor(originalLogger?: Logger) {\n    this.originalLogger = originalLogger\n    this.logs = []\n  }\n\n  /** Returns all logs captured thus far. */\n  get capturedLogs(): string[] {\n    return this.logs\n  }\n\n  /** Clears all logs captured so far. */\n  clear() {\n    this.logs = []\n  }\n\n  /**\n   * Returns a captured log snapshot.\n   * This helps ensure that the provided configuration items won't appear\n   *  with random values in the log snapshot, but rather will get substituted with predictable ids.\n   *\n   * https://jestjs.io/docs/snapshot-testing#2-tests-should-be-deterministic\n   *\n   * @example Jest Example\n   * ```typescript\n   * const logger = new TestLogger()\n   * ...\n   * expect(logger.getLogSnapshot()).toMatchSnapshot()\n   * ```\n   * @param config The snapshot configuration\n   * @returns The snapshotted logs.\n   */\n  getLogSnapshot(config?: LogSnapshotConfig) {\n    const { transactions: transactionIds, accounts, apps } = config ?? {}\n    let snapshot = this.capturedLogs.filter(config?.filterPredicate ?? (() => true)).join('\\n')\n    transactionIds?.forEach(\n      (txn, id) => (snapshot = snapshot.replace(new RegExp(typeof txn === 'string' ? txn : txn.txId(), 'g'), `TXID_${id + 1}`)),\n    )\n    accounts?.forEach(\n      (sender, id) =>\n        (snapshot = snapshot.replace(\n          new RegExp(typeof sender === 'string' ? sender : 'addr' in sender ? sender.addr.toString() : sender.toString(), 'g'),\n          `ACCOUNT_${id + 1}`,\n        )),\n    )\n    apps?.forEach((app, id) => (snapshot = snapshot.replace(new RegExp(`\\\\b${app.toString()}\\\\b(?! bytes)`, 'g'), `APP_${id + 1}`)))\n    return snapshot\n  }\n\n  error(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.error(message, ...optionalParams)\n    this.logs.push(`ERROR: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  warn(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.warn(message, ...optionalParams)\n    this.logs.push(`WARN: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  info(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.info(message, ...optionalParams)\n    this.logs.push(`INFO: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  verbose(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.verbose(message, ...optionalParams)\n    this.logs.push(`VERBOSE: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n  debug(message: string, ...optionalParams: unknown[]): void {\n    this.originalLogger?.debug(message, ...optionalParams)\n    this.logs.push(`DEBUG: ${message}${optionalParams.length ? ` | ${asJson(optionalParams)}` : ''}`)\n  }\n}\n"],"mappings":";;;;;;AAOA,IAAa,aAAb,MAA0C;CACxC,AAAQ;CACR,AAAQ;;;;;CAMR,YAAY,gBAAyB;AACnC,OAAK,iBAAiB;AACtB,OAAK,OAAO,EAAE;;;CAIhB,IAAI,eAAyB;AAC3B,SAAO,KAAK;;;CAId,QAAQ;AACN,OAAK,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAmBhB,eAAe,QAA4B;EACzC,MAAM,EAAE,cAAc,gBAAgB,UAAU,SAAS,UAAU,EAAE;EACrE,IAAI,WAAW,KAAK,aAAa,OAAO,QAAQ,0BAA0B,MAAM,CAAC,KAAK,KAAK;AAC3F,kBAAgB,SACb,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,OAAO,QAAQ,WAAW,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CACzH;AACD,YAAU,SACP,QAAQ,OACN,WAAW,SAAS,QACnB,IAAI,OAAO,OAAO,WAAW,WAAW,SAAS,UAAU,SAAS,OAAO,KAAK,UAAU,GAAG,OAAO,UAAU,EAAE,IAAI,EACpH,WAAW,KAAK,IACjB,CACJ;AACD,QAAM,SAAS,KAAK,OAAQ,WAAW,SAAS,QAAQ,IAAI,OAAO,MAAM,IAAI,UAAU,CAAC,gBAAgB,IAAI,EAAE,OAAO,KAAK,IAAI,CAAE;AAChI,SAAO;;CAGT,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAEnG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAElG,KAAK,SAAiB,GAAG,gBAAiC;AACxD,OAAK,gBAAgB,KAAK,SAAS,GAAG,eAAe;AACrD,OAAK,KAAK,KAAK,SAAS,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAElG,QAAQ,SAAiB,GAAG,gBAAiC;AAC3D,OAAK,gBAAgB,QAAQ,SAAS,GAAG,eAAe;AACxD,OAAK,KAAK,KAAK,YAAY,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK;;CAErG,MAAM,SAAiB,GAAG,gBAAiC;AACzD,OAAK,gBAAgB,MAAM,SAAS,GAAG,eAAe;AACtD,OAAK,KAAK,KAAK,UAAU,UAAU,eAAe,SAAS,MAAM,OAAO,eAAe,KAAK,KAAK"}