@algorandfoundation/algokit-utils 10.0.0-alpha.3 → 10.0.0-alpha.32

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":["algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture","Config","hybridLogger: TestLogger","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,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"}

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":["algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture","hybridLogger: 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,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"}

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","context: AlgorandTestAutomationContext","algorand: AlgorandClient","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,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"}

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":["context: AlgorandTestAutomationContext","algorand: AlgorandClient"],"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,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"}

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/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"}

package/testing/transaction-logger.js

@@ -1,5 +1,5 @@
-const require_signed_transaction = require('../packages/transact/src/transactions/signed-transaction.js');
 const require_config = require('../config.js');
+const require_signed_transaction = require('../packages/transact/src/transactions/signed-transaction.js');
 const require_indexer = require('./indexer.js');
 
 //#region src/testing/transaction-logger.ts

package/testing/transaction-logger.mjs

@@ -1,5 +1,5 @@
-import { decodeSignedTransaction } from "../packages/transact/src/transactions/signed-transaction.mjs";
 import { Config } from "../config.mjs";
+import { decodeSignedTransaction } from "../packages/transact/src/transactions/signed-transaction.mjs";
 import { runWhenIndexerCaughtUp } from "./indexer.mjs";
 
 //#region src/testing/transaction-logger.ts

package/testing/types.d.ts

@@ -0,0 +1,156 @@
+import { Address } from "../packages/common/src/address.js";
+import { Transaction } from "../packages/transact/src/transactions/transaction.js";
+import { MultisigAccount } from "../packages/transact/src/multisig.js";
+import { LogicSigAccount } from "../packages/transact/src/logicsig.js";
+import { AddressWithSigners, AddressWithTransactionSigner } from "../packages/transact/src/signer.js";
+import { AlgodClient } from "../packages/algod_client/src/client.js";
+import { AlgoAmount } from "../amount.js";
+import { TransactionResponse } from "../packages/indexer_client/src/models/transaction-response.js";
+import { IndexerClient } from "../packages/indexer_client/src/client.js";
+import { KmdClient } from "../packages/kmd_client/src/client.js";
+import { AlgoConfig } from "../network-client.js";
+import { AlgorandClient } from "../algorand-client.js";
+import { TestLogger } from "./test-logger.js";
+import { TransactionLogger } from "./transaction-logger.js";
+
+//#region src/testing/types.d.ts
+/**
+ * Test automation context.
+ */
+interface AlgorandTestAutomationContext {
+  /** An AlgorandClient instance loaded with the current context, including testAccount and any generated accounts loaded as signers */
+  algorand: AlgorandClient;
+  /** Algod client instance that will log transactions in `transactionLogger` */
+  algod: AlgodClient;
+  /** Indexer client instance */
+  indexer: IndexerClient;
+  /** KMD client instance */
+  kmd: KmdClient;
+  /** Transaction logger that will log transaction IDs for all transactions issued by `algod` */
+  transactionLogger: TransactionLogger;
+  /** Default, funded test account that is ephemerally created */
+  testAccount: Address & AddressWithSigners;
+  /** Generate and fund an additional ephemerally created account */
+  generateAccount: (params: GetTestAccountParams) => Promise<Address & AddressWithSigners>;
+  /** Wait for the indexer to catch up with all transactions logged by `transactionLogger` */
+  waitForIndexer: () => Promise<void>;
+  /** Wait for the indexer to catch up with the given transaction ID */
+  waitForIndexerTransaction: (transactionId: string) => Promise<TransactionResponse>;
+}
+/**
+ * Parameters for the `getTestAccount` function.
+ */
+interface GetTestAccountParams {
+  /** Initial funds to ensure the account has */
+  initialFunds: AlgoAmount;
+  /** Whether to suppress the log (which includes a mnemonic) or not (default: do not suppress the log) */
+  suppressLog?: boolean;
+  /** Optional override for how to get a test account; this allows you to retrieve accounts from a known or cached list of accounts. */
+  accountGetter?: (algorand: AlgorandClient) => Promise<Address & AddressWithSigners>;
+}
+/** Configuration for creating an Algorand testing fixture. */
+interface AlgorandFixtureConfig extends Partial<AlgoConfig> {
+  /** An optional algod client, if not specified then it will create one against `algodConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
+  algod?: AlgodClient;
+  /** An optional indexer client, if not specified then it will create one against `indexerConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
+  indexer?: IndexerClient;
+  /** An optional kmd client, if not specified then it will create one against `kmdConfig` (if present) then environment variables defined network (if present) or default LocalNet. */
+  kmd?: KmdClient;
+  /** The amount of funds to allocate to the default testing account, if not specified then it will get 10 ALGO. */
+  testAccountFunding?: AlgoAmount;
+  /** Optional override for how to get an account; this allows you to retrieve accounts from a known or cached list of accounts. */
+  accountGetter?: (algorand: AlgorandClient) => Promise<Address & AddressWithSigners>;
+}
+/** An Algorand automated testing fixture */
+interface AlgorandFixture {
+  /**
+   * Retrieve the current context.
+   * Useful with destructuring.
+   *
+   * If you haven't called `newScope` then this will throw an error.
+   * @example
+   * ```typescript
+   * test('My test', () => {
+   *     const {algod, indexer, testAccount, ...} = fixture.context
+   * })
+   * ```
+   */
+  get context(): AlgorandTestAutomationContext;
+  /**
+   * Retrieve an `AlgorandClient` loaded with the current context, including testAccount and any generated accounts loaded as signers.
+   */
+  get algorand(): AlgorandClient;
+  /**
+   * @deprecated Use newScope instead.
+   * Testing framework agnostic handler method to run before each test to prepare the `context` for that test with per test isolation.
+   */
+  beforeEach: () => Promise<void>;
+  /**
+   * Creates a new isolated fixture scope (clean transaction logger, AlgorandClient, testAccount, etc.).
+   *
+   * You can call this from any testing framework specific hook method to control when you want a new scope.
+   *
+   * @example Jest / vitest - per test isolation (beforeEach)
+   * ```typescript
+   * describe('MY MODULE', () => {
+   *   const fixture = algorandFixture()
+   *   beforeEach(fixture.newScope)
+   *
+   *   test('MY TEST', async () => {
+   *     const { algorand, testAccount } = fixture.context
+   *
+   *     // Test stuff!
+   *   })
+   * })
+   * ```
+   *
+   * @example Jest / vitest - test suite isolation (beforeAll)
+   * ```typescript
+   * describe('MY MODULE', () => {
+   *   const fixture = algorandFixture()
+   *   beforeAll(fixture.newScope)
+   *
+   *   test('test1', async () => {
+   *     const { algorand, testAccount } = fixture.context
+   *
+   *     // Test stuff!
+   *   })
+   *   test('test2', async () => {
+   *     const { algorand, testAccount } = fixture.context
+   *     // algorand and testAccount are the same as in test1
+   *   })
+   * })
+   * ```
+   *
+   */
+  newScope: () => Promise<void>;
+}
+/** Configuration for preparing a captured log snapshot.
+ * This helps ensure that the provided configuration items won't appear
+ *  with random values in the log snapshot, but rather will get substituted with predictable ids.
+ */
+interface LogSnapshotConfig {
+  /** Any transaction IDs or transactions to replace the ID for predictably */
+  transactions?: (string | Transaction)[];
+  /** Any accounts/addresses to replace the address for predictably */
+  accounts?: (string | Address | LogicSigAccount | MultisigAccount | AddressWithTransactionSigner)[];
+  /** Any app IDs to replace predictably */
+  apps?: (string | number | bigint)[];
+  /** Optional filter predicate to filter out logs */
+  filterPredicate?: (log: string) => boolean;
+}
+interface AlgoKitLogCaptureFixture {
+  /** The test logger instance for the current test */
+  get testLogger(): TestLogger;
+  /**
+   * Testing framework agnostic handler method to run before each test to prepare the `testLogger` for that test.
+   */
+  beforeEach: () => void;
+  /**
+   * Testing framework agnostic handler method to run after each test to reset the logger.
+   */
+  afterEach: () => void;
+}
+//#endregion
+export { AlgoKitLogCaptureFixture, AlgorandFixture, AlgorandFixtureConfig, AlgorandTestAutomationContext, GetTestAccountParams, LogSnapshotConfig };
+//# sourceMappingURL=types.d.ts.map

package/transact/index.d.ts

@@ -1,17 +1,18 @@
-import { AccessReference, AppCallTransactionFields, BoxReference, HoldingReference, LocalsReference, OnApplicationComplete, StateSchema, validateAppCallTransaction } from "../packages/transact/src/transactions/app-call.js";
-import { AssetConfigTransactionFields, validateAssetConfigTransaction } from "../packages/transact/src/transactions/asset-config.js";
-import { AssetFreezeTransactionFields, validateAssetFreezeTransaction } from "../packages/transact/src/transactions/asset-freeze.js";
-import { AssetTransferTransactionFields, validateAssetTransferTransaction } from "../packages/transact/src/transactions/asset-transfer.js";
+import { AppCallTransactionFields, BoxReference, HoldingReference, LocalsReference, OnApplicationComplete, ResourceReference, StateSchema } from "../packages/transact/src/transactions/app-call.js";
+import { AssetConfigTransactionFields } from "../packages/transact/src/transactions/asset-config.js";
+import { AssetFreezeTransactionFields } from "../packages/transact/src/transactions/asset-freeze.js";
+import { AssetTransferTransactionFields } from "../packages/transact/src/transactions/asset-transfer.js";
 import { HeartbeatProof, HeartbeatTransactionFields } from "../packages/transact/src/transactions/heartbeat.js";
-import { KeyRegistrationTransactionFields, validateKeyRegistrationTransaction } from "../packages/transact/src/transactions/key-registration.js";
+import { KeyRegistrationTransactionFields } from "../packages/transact/src/transactions/key-registration.js";
 import { PaymentTransactionFields } from "../packages/transact/src/transactions/payment.js";
 import { FalconSignatureStruct, FalconVerifier, HashFactory, MerkleArrayProof, MerkleSignatureVerifier, Participant, Reveal, SigslotCommit, StateProof, StateProofMessage, StateProofTransactionFields } from "../packages/transact/src/transactions/state-proof.js";
 import { TransactionType } from "../packages/transact/src/transactions/transaction-type.js";
-import { Transaction, TransactionParams, assignFee, calculateFee, decodeTransaction, decodeTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, getEncodedTransactionType, groupTransactions, transactionCodec } from "../packages/transact/src/transactions/transaction.js";
-import { LogicSignature, MultisigSignature, MultisigSubsignature, SignedTransaction, decodeSignedTransaction, decodeSignedTransactions, encodeSignedTransaction, encodeSignedTransactions } from "../packages/transact/src/transactions/signed-transaction.js";
+import { Transaction, TransactionParams, assignFee, calculateFee, decodeTransaction, decodeTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, getEncodedTransactionType, groupTransactions, transactionCodec, validateTransaction } from "../packages/transact/src/transactions/transaction.js";
+import { LogicSigSignature, MultisigSignature, MultisigSubsignature, SignedTransaction, decodeSignedTransaction, decodeSignedTransactions, encodeSignedTransaction, encodeSignedTransactions, validateSignedTransaction } from "../packages/transact/src/transactions/signed-transaction.js";
+import { BoxReferenceMeta, HoldingReferenceMeta, LocalsReferenceMeta } from "../packages/transact/src/transactions/reference-types-meta.js";
 import { SignedTransactionMeta } from "../packages/transact/src/transactions/signed-transaction-meta.js";
 import { TransactionParamsMeta, transactionParamsCodec } from "../packages/transact/src/transactions/transaction-meta.js";
-import { MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG, MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG, MULTISIG_MERGE_MISMATCH_ERROR_MSG, MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG, MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG, MULTISIG_NO_MUTATE_ERROR_MSG, MULTISIG_SIGNATURE_LENGTH_ERROR_MSG, MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG, MultisigAccount, MultisigMetadata, addressFromMultisigPreImg, addressFromMultisigPreImgAddrs, addressFromMultisigSignature, appendSignRawMultisigSignature, applyMultisigSubsignature, createMultisigTransaction, decodeMultiSignature, mergeMultisigTransactions, mergeMultisignatures, multisigAddress, newMultisigSignature, participantsFromMultisigSignature } from "../packages/transact/src/multisig.js";
-import { DelegatedLsigSigner, LogicSigAccount, ProgramDataSigner, decodeLogicSignature, sanityCheckProgram } from "../packages/transact/src/logicsig.js";
+import { MultisigAccount, MultisigMetadata } from "../packages/transact/src/multisig.js";
+import { DelegatedLsigSigner, LogicSig, LogicSigAccount, ProgramDataSigner } from "../packages/transact/src/logicsig.js";
 import { AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, MxBytesSigner, SendingAddress, TransactionSigner, generateAddressWithSigners, makeEmptyTransactionSigner } from "../packages/transact/src/signer.js";
-export { AccessReference, AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, AppCallTransactionFields, AssetConfigTransactionFields, AssetFreezeTransactionFields, AssetTransferTransactionFields, BoxReference, DelegatedLsigSigner, FalconSignatureStruct, FalconVerifier, HashFactory, HeartbeatProof, HeartbeatTransactionFields, HoldingReference, KeyRegistrationTransactionFields, LocalsReference, LogicSigAccount, LogicSignature, MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG, MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG, MULTISIG_MERGE_MISMATCH_ERROR_MSG, MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG, MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG, MULTISIG_NO_MUTATE_ERROR_MSG, MULTISIG_SIGNATURE_LENGTH_ERROR_MSG, MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG, MerkleArrayProof, MerkleSignatureVerifier, MultisigAccount, MultisigMetadata, MultisigSignature, MultisigSubsignature, MxBytesSigner, OnApplicationComplete, Participant, PaymentTransactionFields, ProgramDataSigner, Reveal, SendingAddress, SignedTransaction, SignedTransactionMeta, SigslotCommit, StateProof, StateProofMessage, StateProofTransactionFields, StateSchema, Transaction, TransactionParams, TransactionParamsMeta, TransactionSigner, TransactionType, addressFromMultisigPreImg, addressFromMultisigPreImgAddrs, addressFromMultisigSignature, appendSignRawMultisigSignature, applyMultisigSubsignature, assignFee, calculateFee, createMultisigTransaction, decodeLogicSignature, decodeMultiSignature, decodeSignedTransaction, decodeSignedTransactions, decodeTransaction, decodeTransactions, encodeSignedTransaction, encodeSignedTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, generateAddressWithSigners, getEncodedTransactionType, groupTransactions, makeEmptyTransactionSigner, mergeMultisigTransactions, mergeMultisignatures, multisigAddress, newMultisigSignature, participantsFromMultisigSignature, sanityCheckProgram, transactionCodec, transactionParamsCodec, validateAppCallTransaction, validateAssetConfigTransaction, validateAssetFreezeTransaction, validateAssetTransferTransaction, validateKeyRegistrationTransaction };
+export { AddressWithDelegatedLsigSigner, AddressWithMxBytesSigner, AddressWithProgramDataSigner, AddressWithSigners, AddressWithTransactionSigner, AppCallTransactionFields, AssetConfigTransactionFields, AssetFreezeTransactionFields, AssetTransferTransactionFields, BoxReference, BoxReferenceMeta, DelegatedLsigSigner, FalconSignatureStruct, FalconVerifier, HashFactory, HeartbeatProof, HeartbeatTransactionFields, HoldingReference, HoldingReferenceMeta, KeyRegistrationTransactionFields, LocalsReference, LocalsReferenceMeta, LogicSig, LogicSigAccount, LogicSigSignature, MerkleArrayProof, MerkleSignatureVerifier, MultisigAccount, MultisigMetadata, MultisigSignature, MultisigSubsignature, MxBytesSigner, OnApplicationComplete, Participant, PaymentTransactionFields, ProgramDataSigner, ResourceReference, Reveal, SendingAddress, SignedTransaction, SignedTransactionMeta, SigslotCommit, StateProof, StateProofMessage, StateProofTransactionFields, StateSchema, Transaction, TransactionParams, TransactionParamsMeta, TransactionSigner, TransactionType, assignFee, calculateFee, decodeSignedTransaction, decodeSignedTransactions, decodeTransaction, decodeTransactions, encodeSignedTransaction, encodeSignedTransactions, encodeTransaction, encodeTransactionRaw, encodeTransactions, estimateTransactionSize, generateAddressWithSigners, getEncodedTransactionType, groupTransactions, makeEmptyTransactionSigner, transactionCodec, transactionParamsCodec, validateSignedTransaction, validateTransaction };

package/transact/index.js

@@ -1,42 +1,27 @@
 const require_app_call = require('../packages/transact/src/transactions/app-call.js');
-const require_asset_config = require('../packages/transact/src/transactions/asset-config.js');
-const require_asset_freeze = require('../packages/transact/src/transactions/asset-freeze.js');
-const require_asset_transfer = require('../packages/transact/src/transactions/asset-transfer.js');
-const require_key_registration = require('../packages/transact/src/transactions/key-registration.js');
 const require_transaction_type = require('../packages/transact/src/transactions/transaction-type.js');
 const require_transaction_meta = require('../packages/transact/src/transactions/transaction-meta.js');
 const require_transaction = require('../packages/transact/src/transactions/transaction.js');
 const require_signed_transaction_meta = require('../packages/transact/src/transactions/signed-transaction-meta.js');
 const require_signed_transaction = require('../packages/transact/src/transactions/signed-transaction.js');
+const require_reference_types_meta = require('../packages/transact/src/transactions/reference-types-meta.js');
 const require_signer = require('../packages/transact/src/signer.js');
 const require_multisig = require('../packages/transact/src/multisig.js');
 const require_logicsig = require('../packages/transact/src/logicsig.js');
 
+exports.BoxReferenceMeta = require_reference_types_meta.BoxReferenceMeta;
+exports.HoldingReferenceMeta = require_reference_types_meta.HoldingReferenceMeta;
+exports.LocalsReferenceMeta = require_reference_types_meta.LocalsReferenceMeta;
+exports.LogicSig = require_logicsig.LogicSig;
 exports.LogicSigAccount = require_logicsig.LogicSigAccount;
-exports.MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG = require_multisig.MULTISIG_MERGE_LESSTHANTWO_ERROR_MSG;
-exports.MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG = require_multisig.MULTISIG_MERGE_MISMATCH_AUTH_ADDR_MSG;
-exports.MULTISIG_MERGE_MISMATCH_ERROR_MSG = require_multisig.MULTISIG_MERGE_MISMATCH_ERROR_MSG;
-exports.MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG = require_multisig.MULTISIG_MERGE_SIG_MISMATCH_ERROR_MSG;
-exports.MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG = require_multisig.MULTISIG_MERGE_WRONG_PREIMAGE_ERROR_MSG;
-exports.MULTISIG_NO_MUTATE_ERROR_MSG = require_multisig.MULTISIG_NO_MUTATE_ERROR_MSG;
-exports.MULTISIG_SIGNATURE_LENGTH_ERROR_MSG = require_multisig.MULTISIG_SIGNATURE_LENGTH_ERROR_MSG;
-exports.MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG = require_multisig.MULTISIG_USE_PARTIAL_SIGN_ERROR_MSG;
 exports.MultisigAccount = require_multisig.MultisigAccount;
 exports.OnApplicationComplete = require_app_call.OnApplicationComplete;
 exports.SignedTransactionMeta = require_signed_transaction_meta.SignedTransactionMeta;
 exports.Transaction = require_transaction.Transaction;
 exports.TransactionParamsMeta = require_transaction_meta.TransactionParamsMeta;
 exports.TransactionType = require_transaction_type.TransactionType;
-exports.addressFromMultisigPreImg = require_multisig.addressFromMultisigPreImg;
-exports.addressFromMultisigPreImgAddrs = require_multisig.addressFromMultisigPreImgAddrs;
-exports.addressFromMultisigSignature = require_multisig.addressFromMultisigSignature;
-exports.appendSignRawMultisigSignature = require_multisig.appendSignRawMultisigSignature;
-exports.applyMultisigSubsignature = require_multisig.applyMultisigSubsignature;
 exports.assignFee = require_transaction.assignFee;
 exports.calculateFee = require_transaction.calculateFee;
-exports.createMultisigTransaction = require_multisig.createMultisigTransaction;
-exports.decodeLogicSignature = require_logicsig.decodeLogicSignature;
-exports.decodeMultiSignature = require_multisig.decodeMultiSignature;
 exports.decodeSignedTransaction = require_signed_transaction.decodeSignedTransaction;
 exports.decodeSignedTransactions = require_signed_transaction.decodeSignedTransactions;
 exports.decodeTransaction = require_transaction.decodeTransaction;
@@ -51,16 +36,7 @@ exports.generateAddressWithSigners = require_signer.generateAddressWithSigners;
 exports.getEncodedTransactionType = require_transaction.getEncodedTransactionType;
 exports.groupTransactions = require_transaction.groupTransactions;
 exports.makeEmptyTransactionSigner = require_signer.makeEmptyTransactionSigner;
-exports.mergeMultisigTransactions = require_multisig.mergeMultisigTransactions;
-exports.mergeMultisignatures = require_multisig.mergeMultisignatures;
-exports.multisigAddress = require_multisig.multisigAddress;
-exports.newMultisigSignature = require_multisig.newMultisigSignature;
-exports.participantsFromMultisigSignature = require_multisig.participantsFromMultisigSignature;
-exports.sanityCheckProgram = require_logicsig.sanityCheckProgram;
 exports.transactionCodec = require_transaction.transactionCodec;
 exports.transactionParamsCodec = require_transaction_meta.transactionParamsCodec;
-exports.validateAppCallTransaction = require_app_call.validateAppCallTransaction;
-exports.validateAssetConfigTransaction = require_asset_config.validateAssetConfigTransaction;
-exports.validateAssetFreezeTransaction = require_asset_freeze.validateAssetFreezeTransaction;
-exports.validateAssetTransferTransaction = require_asset_transfer.validateAssetTransferTransaction;
-exports.validateKeyRegistrationTransaction = require_key_registration.validateKeyRegistrationTransaction;
+exports.validateSignedTransaction = require_signed_transaction.validateSignedTransaction;
+exports.validateTransaction = require_transaction.validateTransaction;