@algorandfoundation/algokit-utils 2.3.3-beta.3 → 2.3.3-beta.5

package/esm/indexer-lookup.js

@@ -0,0 +1,98 @@
+const DEFAULT_INDEXER_MAX_API_RESOURCES_PER_ACCOUNT = 1000; //MaxAPIResourcesPerAccount: This is the default maximum, though may be provider specific
+/**
+ * Looks up a transaction by ID using Indexer.
+ * @param transactionId The ID of the transaction to look up
+ * @param indexer An indexer client
+ * @returns The result of the look-up
+ */
+export async function lookupTransactionById(transactionId, indexer) {
+    return (await indexer.lookupTransactionByID(transactionId).do());
+}
+/**
+ * Looks up an account by address using Indexer.
+ * @param transactionId The address of the account to look up
+ * @param indexer An indexer client
+ * @returns The result of the look-up
+ */
+export async function lookupAccountByAddress(accountAddress, indexer) {
+    return (await indexer.lookupAccountByID(accountAddress).do());
+}
+/**
+ * Looks up applications that were created by the given address.
+ * @param indexer An indexer instance
+ * @param address The address of the creator to look up
+ * @param getAll Whether or not to include deleted applications
+ * @param paginationLimit The number of records to return per paginated request, default 1000
+ * @returns The list of application results
+ */
+export async function lookupAccountCreatedApplicationByAddress(indexer, address, getAll = undefined, paginationLimit) {
+    return await executePaginatedRequest((response) => {
+        if ('message' in response) {
+            throw { status: 404, ...response };
+        }
+        return response.applications;
+    }, (nextToken) => {
+        let s = indexer
+            .lookupAccountCreatedApplications(address)
+            .includeAll(getAll)
+            .limit(paginationLimit ?? DEFAULT_INDEXER_MAX_API_RESOURCES_PER_ACCOUNT);
+        if (nextToken) {
+            s = s.nextToken(nextToken);
+        }
+        return s;
+    });
+}
+/**
+ * Allows transactions to be searched for the given criteria.
+ * @param indexer An indexer client
+ * @param searchCriteria The criteria to search for
+ * @param paginationLimit The number of records to return per paginated request, default 1000
+ * @returns The search results
+ */
+export async function searchTransactions(indexer, searchCriteria, paginationLimit) {
+    let currentRound = 0;
+    const transactions = await executePaginatedRequest((response) => {
+        if ('message' in response) {
+            throw { status: 404, ...response };
+        }
+        if (response['current-round'] > currentRound) {
+            currentRound = response['current-round'];
+        }
+        return response.transactions;
+    }, (nextToken) => {
+        let s = searchCriteria(indexer.searchForTransactions()).limit(paginationLimit ?? DEFAULT_INDEXER_MAX_API_RESOURCES_PER_ACCOUNT);
+        if (nextToken) {
+            s = s.nextToken(nextToken);
+        }
+        return s;
+    });
+    return {
+        'current-round': currentRound,
+        'next-token': '',
+        transactions: transactions,
+    };
+}
+// https://developer.algorand.org/docs/get-details/indexer/#paginated-results
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export async function executePaginatedRequest(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+extractItems, buildRequest) {
+    const results = [];
+    let nextToken = undefined;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const request = buildRequest(nextToken);
+        const response = await request.do();
+        const items = extractItems(response);
+        if (items == null || items.length === 0) {
+            break;
+        }
+        results.push(...items);
+        nextToken = response['next-token'];
+        if (!nextToken) {
+            break;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=indexer-lookup.js.map

package/esm/indexer-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer-lookup.js","sourceRoot":"","sources":["../../src/indexer-lookup.ts"],"names":[],"mappings":"AAUA,MAAM,6CAA6C,GAAG,IAAI,CAAA,CAAC,yFAAyF;AAEpJ;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,aAAqB,EAAE,OAAgB;IACjF,OAAO,CAAC,MAAM,OAAO,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC,EAAE,EAAE,CAA4B,CAAA;AAC7F,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,cAAsB,EAAE,OAAgB;IACnF,OAAO,CAAC,MAAM,OAAO,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,CAAwB,CAAA;AACtF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAC5D,OAAgB,EAChB,OAAe,EACf,SAA8B,SAAS,EACvC,eAAwB;IAExB,OAAO,MAAM,uBAAuB,CAClC,CAAC,QAA8D,EAAE,EAAE;QACjE,IAAI,SAAS,IAAI,QAAQ,EAAE;YACzB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAA;SACnC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAA;IAC9B,CAAC,EACD,CAAC,SAAS,EAAE,EAAE;QACZ,IAAI,CAAC,GAAG,OAAO;aACZ,gCAAgC,CAAC,OAAO,CAAC;aACzC,UAAU,CAAC,MAAM,CAAC;aAClB,KAAK,CAAC,eAAe,IAAI,6CAA6C,CAAC,CAAA;QAC1E,IAAI,SAAS,EAAE;YACb,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;SAC3B;QACD,OAAO,CAAC,CAAA;IACV,CAAC,CACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,cAAmE,EACnE,eAAwB;IAExB,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,MAAM,YAAY,GAAG,MAAM,uBAAuB,CAChD,CAAC,QAAwD,EAAE,EAAE;QAC3D,IAAI,SAAS,IAAI,QAAQ,EAAE;YACzB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAA;SACnC;QACD,IAAI,QAAQ,CAAC,eAAe,CAAC,GAAG,YAAY,EAAE;YAC5C,YAAY,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAA;SACzC;QACD,OAAO,QAAQ,CAAC,YAAY,CAAA;IAC9B,CAAC,EACD,CAAC,SAAS,EAAE,EAAE;QACZ,IAAI,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,IAAI,6CAA6C,CAAC,CAAA;QAC/H,IAAI,SAAS,EAAE;YACb,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;SAC3B;QACD,OAAO,CAAC,CAAA;IACV,CAAC,CACF,CAAA;IAED,OAAO;QACL,eAAe,EAAE,YAAY;QAC7B,YAAY,EAAE,EAAE;QAChB,YAAY,EAAE,YAAY;KAC3B,CAAA;AACH,CAAC;AAED,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,uBAAuB;AAC3C,8DAA8D;AAC9D,YAA0C,EAC1C,YAA8C;IAE9C,MAAM,OAAO,GAAG,EAAE,CAAA;IAElB,IAAI,SAAS,GAAuB,SAAS,CAAA;IAC7C,iDAAiD;IACjD,OAAO,IAAI,EAAE;QACX,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,CAAA;QACnC,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;YACvC,MAAK;SACN;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;QACtB,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAA;QAClC,IAAI,CAAC,SAAS,EAAE;YACd,MAAK;SACN;KACF;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/esm/localnet.js

@@ -0,0 +1,111 @@
+import algosdk from 'algosdk';
+import { Config } from './';
+import { getDispenserAccount, mnemonicAccount } from './account';
+import { getAlgoKmdClient } from './network-client';
+import { transferAlgos } from './transfer';
+import { AlgoAmount } from './types/amount';
+/** Returns true if the algod client is pointing to a LocalNet Algorand network */
+export async function isLocalNet(algod) {
+    const params = await algod.getTransactionParams().do();
+    return params.genesisID === 'devnet-v1' || params.genesisID === 'sandnet-v1' || params.genesisID === 'dockernet-v1';
+}
+/**
+ * Gets an account with private key loaded from a KMD wallet of the given name, or alternatively creates one with funds in it via a KMD wallet of the given name.
+ *
+ * This is useful to get idempotent accounts from LocalNet without having to specify the private key (which will change when resetting the LocalNet).
+ *
+ * This significantly speeds up local dev time and improves experience since you can write code that *just works* first go without manual config in a fresh LocalNet.
+ *
+ * If this is used via `getAccount`, then you can even use the same code that runs on production without changes for local development!
+ *
+ * @param walletAccount The wallet details with:
+ *   * `name`: The name of the wallet to retrieve / create
+ *   * `fundWith`: The number of Algos to fund the account with when it gets created, if not specified then 1000 Algos will be funded from the dispenser account
+ * @param algod An algod client
+ * @param kmdClient A KMD client, if not specified then a default KMD client will be loaded from environment variables
+ *
+ * @returns An Algorand account with private key loaded - either one that already existed in the given KMD wallet, or a new one that is funded for you
+ */
+export async function getOrCreateKmdWalletAccount(walletAccount, algod, kmdClient) {
+    const kmd = kmdClient ?? getAlgoKmdClient();
+    // Get an existing account from the KMD wallet
+    const existing = await getKmdWalletAccount(walletAccount, algod, kmd);
+    if (existing) {
+        return existing;
+    }
+    // None existed: create the KMD wallet instead
+    const walletId = (await kmd.createWallet(walletAccount.name, '')).wallet.id;
+    const walletHandle = (await kmd.initWalletHandle(walletId, '')).wallet_handle_token;
+    await kmd.generateKey(walletHandle);
+    // Get the account from the new KMD wallet
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const account = (await getKmdWalletAccount(walletAccount, algod, kmd));
+    Config.logger.info(`LocalNet account '${walletAccount.name}' doesn't yet exist; created account ${account.addr} with keys stored in KMD and funding with ${walletAccount.fundWith?.algos ?? 1000} ALGOs`);
+    // Fund the account from the dispenser
+    await transferAlgos({
+        amount: walletAccount.fundWith ?? AlgoAmount.Algos(1000),
+        from: await getDispenserAccount(algod, kmd),
+        to: account.addr,
+    }, algod);
+    return account;
+}
+/**
+ * Returns an Algorand account with private key loaded from the given KMD wallet (identified by name).
+ *
+ * @param walletAccount The details of the wallet, with:
+ *   * `name`: The name of the wallet to retrieve an account from
+ *   * `predicate`: An optional filter to use to find the account (otherwise it will return a random account from the wallet)
+ * @param algod An algod client
+ * @param kmdClient A KMD client, if not specified then a default KMD client will be loaded from environment variables
+ * @example Get default funded account in a LocalNet
+ *
+ * ```typescript
+ * const defaultDispenserAccount = await getKmdWalletAccount(algod,
+ *   'unencrypted-default-wallet',
+ *   a => a.status !== 'Offline' && a.amount > 1_000_000_000
+ * )
+ * ```
+ */
+export async function getKmdWalletAccount(walletAccount, algod, kmdClient) {
+    const { name, predicate } = walletAccount;
+    const kmd = kmdClient ?? getAlgoKmdClient();
+    const wallets = await kmd.listWallets();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const wallet = wallets.wallets.filter((w) => w.name === name);
+    if (wallet.length === 0) {
+        return undefined;
+    }
+    const walletId = wallet[0].id;
+    const walletHandle = (await kmd.initWalletHandle(walletId, '')).wallet_handle_token;
+    const keyIds = (await kmd.listKeys(walletHandle)).addresses;
+    let i = 0;
+    if (predicate) {
+        for (i = 0; i < keyIds.length; i++) {
+            const key = keyIds[i];
+            const account = await algod.accountInformation(key).do();
+            if (predicate(account)) {
+                break;
+            }
+        }
+    }
+    if (i >= keyIds.length) {
+        return undefined;
+    }
+    const accountKey = (await kmd.exportKey(walletHandle, '', keyIds[i])).private_key;
+    const accountMnemonic = algosdk.secretKeyToMnemonic(accountKey);
+    return mnemonicAccount(accountMnemonic);
+}
+/**
+ * Returns an Algorand account with private key loaded for the default LocalNet dispenser account (that can be used to fund other accounts)
+ *
+ * @param algod An algod client
+ * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables
+ */
+export async function getLocalNetDispenserAccount(algod, kmd) {
+    if (!(await isLocalNet(algod))) {
+        throw "Can't get default account from non LocalNet network";
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    return (await getKmdWalletAccount({ name: 'unencrypted-default-wallet', predicate: (a) => a.status !== 'Offline' && a.amount > 1_000_000_000 }, algod, kmd));
+}
+//# sourceMappingURL=localnet.js.map

package/esm/localnet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localnet.js","sourceRoot":"","sources":["../../src/localnet.ts"],"names":[],"mappings":"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"}

package/esm/network-client.js

@@ -0,0 +1,179 @@
+import algosdk, { Indexer, Kmd } from 'algosdk';
+import { AlgoHttpClientWithRetry } from './types/algo-http-client-with-retry';
+/** Retrieve configurations from environment variables when defined or get defaults (expects to be called from a Node.js environment not algod-side) */
+export function getConfigFromEnvOrDefaults() {
+    if (!process || !process.env) {
+        throw new Error('Attempt to get default algod configuration from a non Node.js context; supply the config instead');
+    }
+    const algodConfig = !process.env.ALGOD_SERVER
+        ? getDefaultLocalNetConfig('algod')
+        : { server: process.env.ALGOD_SERVER, port: process.env.ALGOD_PORT, token: process.env.ALGOD_TOKEN };
+    const indexerConfig = !process.env.INDEXER_SERVER
+        ? getDefaultLocalNetConfig('indexer')
+        : {
+            server: process.env.INDEXER_SERVER,
+            port: process.env.INDEXER_PORT,
+            token: process.env.INDEXER_TOKEN,
+        };
+    return {
+        algodConfig,
+        indexerConfig,
+        kmdConfig: process && process.env && process.env.ALGOD_SERVER
+            ? { ...algodConfig, port: process?.env?.KMD_PORT ?? '4002' }
+            : getDefaultLocalNetConfig('kmd'),
+    };
+}
+/** Retrieve the algod configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
+export function getAlgodConfigFromEnvironment() {
+    if (!process || !process.env) {
+        throw new Error('Attempt to get default algod configuration from a non Node.js context; supply the config instead');
+    }
+    if (!process.env.ALGOD_SERVER) {
+        throw new Error('Attempt to get default algod configuration without specifying ALGOD_SERVER in the environment variables');
+    }
+    return {
+        server: process.env.ALGOD_SERVER,
+        port: process.env.ALGOD_PORT,
+        token: process.env.ALGOD_TOKEN,
+    };
+}
+/** Retrieve the indexer configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
+export function getIndexerConfigFromEnvironment() {
+    if (!process || !process.env) {
+        throw new Error('Attempt to get default indexer configuration from a non Node.js context; supply the config instead');
+    }
+    if (!process.env.INDEXER_SERVER) {
+        throw new Error('Attempt to get default indexer configuration without specifying INDEXER_SERVER in the environment variables');
+    }
+    return {
+        server: process.env.INDEXER_SERVER,
+        port: process.env.INDEXER_PORT,
+        token: process.env.INDEXER_TOKEN,
+    };
+}
+/** Returns the Algorand configuration to point to the AlgoNode service
+ *
+ * @param network Which network to connect to - TestNet or MainNet
+ * @param config Which algod config to return - Algod or Indexer
+ */
+export function getAlgoNodeConfig(network, config) {
+    return {
+        server: `https://${network}-${config === 'algod' ? 'api' : 'idx'}.algonode.cloud/`,
+        port: 443,
+    };
+}
+/** Returns the Algorand configuration to point to the default LocalNet
+ *
+ * @param configOrPort Which algod config to return - algod, kmd, or indexer OR a port number
+ */
+export function getDefaultLocalNetConfig(configOrPort) {
+    return {
+        server: `http://localhost`,
+        port: configOrPort === 'algod' ? 4001 : configOrPort === 'indexer' ? 8980 : configOrPort === 'kmd' ? 4002 : configOrPort,
+        token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+    };
+}
+function getAlgoTokenHeader(server, token, defaultHeader) {
+    // Purestake uses a slightly different API key header than the default
+    if (server.includes('purestake.io') && typeof token === 'string')
+        return { 'X-API-Key': token };
+    // Because we override the default HTTP Client construction (to get retries) we need to put a string token into the standard header ourselves
+    return typeof token === 'string' ? { [defaultHeader ?? 'X-Algo-API-Token']: token } : token ?? {};
+}
+/** Returns an algod SDK client that automatically retries on idempotent calls
+ *
+ * @param config The config if you want to override the default (getting config from process.env)
+ * @example Default (load from environment variables)
+ *
+ *  ```typescript
+ *  // Uses process.env.ALGOD_SERVER, process.env.ALGOD_PORT and process.env.ALGOD_TOKEN
+ *  // Automatically detects if you are using PureStake to switch in the right header name for ALGOD_TOKEN
+ *  const algod = getAlgoClient()
+ *  await algod.healthCheck().do()
+ *  ```
+ * @example AlgoNode (testnet)
+ * ```typescript
+ *  const algod = getAlgoClient(getAlgoNodeConfig('testnet', 'algod'))
+ *  await algod.healthCheck().do()
+ * ```
+ * @example AlgoNode (mainnet)
+ * ```typescript
+ *  const algod = getAlgoClient(getAlgoNodeConfig('mainnet', 'algod'))
+ *  await algod.healthCheck().do()
+ * ```
+ * @example Custom (e.g. default LocalNet, although we recommend loading this into a .env and using the Default option instead)
+ * ```typescript
+ *  const algod = getAlgoClient({server: 'http://localhost', port: '4001', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+ *  await algod.healthCheck().do()
+ * ```
+ */
+export function getAlgoClient(config) {
+    const { token, server, port } = config ?? getAlgodConfigFromEnvironment();
+    const httpClientWithRetry = new AlgoHttpClientWithRetry(getAlgoTokenHeader(server, token), server, port);
+    return new algosdk.Algodv2(httpClientWithRetry, server);
+}
+/** Returns an indexer SDK client that automatically retries on idempotent calls
+ *
+ * @param config The config if you want to override the default (getting config from process.env)
+ * @example Default (load from environment variables)
+ *
+ *  ```typescript
+ *  // Uses process.env.INDEXER_SERVER, process.env.INDEXER_PORT and process.env.INDEXER_TOKEN
+ *  // Automatically detects if you are using PureStake to switch in the right header name for INDEXER_TOKEN
+ *  const indexer = getAlgoIndexerClient()
+ *  await indexer.makeHealthCheck().do()
+ *  ```
+ * @example AlgoNode (testnet)
+ * ```typescript
+ *  const indexer = getAlgoIndexerClient(getAlgoNodeConfig('testnet', 'indexer'))
+ *  await indexer.makeHealthCheck().do()
+ * ```
+ * @example AlgoNode (mainnet)
+ * ```typescript
+ *  const indexer = getAlgoIndexerClient(getAlgoNodeConfig('mainnet', 'indexer'))
+ *  await indexer.makeHealthCheck().do()
+ * ```
+ * @example Custom (e.g. default LocalNet, although we recommend loading this into a .env and using the Default option instead)
+ * ```typescript
+ *  const indexer = getAlgoIndexerClient({server: 'http://localhost', port: '8980', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+ *  await indexer.makeHealthCheck().do()
+ * ```
+ */
+export function getAlgoIndexerClient(config) {
+    const { token, server, port } = config ?? getIndexerConfigFromEnvironment();
+    const httpClientWithRetry = new AlgoHttpClientWithRetry(getAlgoTokenHeader(server, token, 'X-Indexer-API-Token'), server, port);
+    return new Indexer(httpClientWithRetry);
+}
+/**
+ * Returns a KMD SDK client that automatically retries on idempotent calls
+ *
+ * KMD client allows you to export private keys, which is useful to get the default account in a LocalNet network.
+ *
+ * @param config The config if you want to override the default (getting config from process.env)
+ * @example Default (load from environment variables)
+ *
+ *  ```typescript
+ *  // Uses process.env.ALGOD_SERVER, process.env.KMD_PORT (or if not specified: port 4002) and process.env.ALGOD_TOKEN
+ *  const kmd = getAlgoKmdClient()
+ *  ```
+ * @example Custom (e.g. default LocalNet, although we recommend loading this into a .env and using the Default option instead)
+ * ```typescript
+ *  const kmd = getAlgoKmdClient({server: 'http://localhost', port: '4002', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
+ * ```
+ */
+export function getAlgoKmdClient(config) {
+    const { token, server } = config ?? getAlgodConfigFromEnvironment();
+    // We can only use Kmd on the LocalNet otherwise it's not exposed so this makes some assumptions
+    // (e.g. same token and server as algod and port 4002 by default)
+    return new Kmd(token, server, process?.env?.KMD_PORT ?? '4002');
+}
+export async function isTestNet(algod) {
+    const params = await algod.getTransactionParams().do();
+    return params.genesisID === 'testnet-v1';
+}
+export async function isMainNet(algod) {
+    const params = await algod.getTransactionParams().do();
+    return params.genesisID === 'mainnet-v1';
+}
+export { isLocalNet } from './localnet';
+//# sourceMappingURL=network-client.js.map

package/esm/network-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-client.js","sourceRoot":"","sources":["../../src/network-client.ts"],"names":[],"mappings":"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"}

package/esm/testing/account.js

@@ -0,0 +1,24 @@
+import algosdk from 'algosdk';
+import { Config } from '../';
+import { getDispenserAccount } from '../account';
+import { transferAlgos } from '../transfer';
+/**
+ * Creates an ephemeral Algorand account for the purposes of testing.
+ * Returns a newly created random test account that is funded from the dispenser
+ * DO NOT USE THIS TO CREATE A MAINNET ACCOUNT!
+ * Note: By default this will log the mnemonic of the account.
+ * @param param0 The config for the test account to generate
+ * @param algod An algod client
+ * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables
+ * @returns The account, with private key loaded
+ */
+export async function getTestAccount({ suppressLog, initialFunds }, algod, kmd) {
+    const account = algosdk.generateAccount();
+    Config.getLogger(suppressLog).info(`New test account created with address '${account.addr}' and mnemonic '${algosdk.secretKeyToMnemonic(account.sk)}'.`);
+    const dispenser = await getDispenserAccount(algod, kmd);
+    await transferAlgos({ from: dispenser, to: account.addr, amount: initialFunds, note: 'Funding test account', suppressLog }, algod);
+    const accountInfo = await algod.accountInformation(account.addr).do();
+    Config.getLogger(suppressLog).info('Test account funded; account balance: %d µAlgos', accountInfo.amount);
+    return account;
+}
+//# sourceMappingURL=account.js.map

package/esm/testing/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../../src/testing/account.ts"],"names":[],"mappings":"AAAA,OAAO,OAAkC,MAAM,SAAS,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,EAAE,WAAW,EAAE,YAAY,EAAwB,EAAE,KAAc,EAAE,GAAS;IACjH,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAA;IAEzC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAChC,0CAA0C,OAAO,CAAC,IAAI,mBAAmB,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CACrH,CAAA;IAED,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAEvD,MAAM,aAAa,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,sBAAsB,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,CAAA;IAElI,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAA;IAErE,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,iDAAiD,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAEzG,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -0,0 +1,39 @@
+import { Config } from '../../';
+import { TestLogger } from '../test-logger';
+/**
+ * Creates a test fixture for capturing AlgoKit logs.
+ *
+ * @example ```typescript
+ * const logs = algoKitLogCaptureFixture()
+ *
+ * beforeEach(logs.beforeEach)
+ * afterEach(logs.afterEach)
+ *
+ * test('My test', () => {
+ *     const capturedLogs = logs.testLogger.capturedLogs
+ * })
+ * ```
+ *
+ * @returns The fixture
+ */
+export const algoKitLogCaptureFixture = () => {
+    const originalLogger = Config.logger;
+    let hybridLogger;
+    return {
+        get testLogger() {
+            return hybridLogger;
+        },
+        beforeEach: () => {
+            hybridLogger = new TestLogger(originalLogger);
+            Config.configure({
+                logger: hybridLogger,
+            });
+        },
+        afterEach: () => {
+            Config.configure({
+                logger: originalLogger,
+            });
+        },
+    };
+};
+//# sourceMappingURL=algokit-log-capture-fixture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"algokit-log-capture-fixture.js","sourceRoot":"","sources":["../../../../src/testing/fixtures/algokit-log-capture-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAmC,GAAG,EAAE;IAC3E,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAA;IAEpC,IAAI,YAAwB,CAAA;IAE5B,OAAO;QACL,IAAI,UAAU;YACZ,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,UAAU,EAAE,GAAG,EAAE;YACf,YAAY,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA;YAC7C,MAAM,CAAC,SAAS,CAAC;gBACf,MAAM,EAAE,YAAY;aACrB,CAAC,CAAA;QACJ,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,MAAM,CAAC,SAAS,CAAC;gBACf,MAAM,EAAE,cAAc;aACvB,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,53 @@
+import { getTestAccount, runWhenIndexerCaughtUp, TransactionLogger } from '../';
+import { algos, Config, getAlgoClient, getAlgoIndexerClient, getAlgoKmdClient, getConfigFromEnvOrDefaults, lookupTransactionById, } from '../../';
+/**
+ * Creates a test fixture for automated testing against Algorand.
+ * By default it tests against an environment variable specified client
+ *  if the standard environment variables are specified, otherwise against
+ *  a default LocalNet instance, but you can pass in an algod, indexer
+ *  and/or kmd if you want to test against an explicitly defined network.
+ *
+ * @example ```typescript
+ * const algorand = algorandFixture(undefined, getConfigFromEnvOrDefaults())
+ *
+ * beforeEach(algorand.beforeEach, 10_000)
+ *
+ * test('My test', async () => {
+ *     const {algod, indexer, testAccount, ...} = algorand.context
+ *     // test things...
+ * })
+ * ```
+ *
+ * @param fixtureConfig The fixture configuration
+ * @param config The algo configuration
+ * @returns The fixture
+ */
+export function algorandFixture(fixtureConfig, config) {
+    config = config || getConfigFromEnvOrDefaults();
+    const algod = fixtureConfig?.algod ?? getAlgoClient(config.algodConfig);
+    const indexer = fixtureConfig?.indexer ?? getAlgoIndexerClient(config.indexerConfig);
+    const kmd = fixtureConfig?.kmd ?? getAlgoKmdClient(config.kmdConfig);
+    let context;
+    const beforeEach = async () => {
+        Config.configure({ debug: true });
+        const transactionLogger = new TransactionLogger();
+        const transactionLoggerAlgod = transactionLogger.capture(algod);
+        context = {
+            algod: transactionLoggerAlgod,
+            indexer: indexer,
+            kmd: kmd,
+            testAccount: await getTestAccount({ initialFunds: fixtureConfig?.testAccountFunding ?? algos(10), suppressLog: true }, transactionLoggerAlgod, kmd),
+            generateAccount: (params) => getTestAccount(params, transactionLoggerAlgod, kmd),
+            transactionLogger: transactionLogger,
+            waitForIndexer: () => transactionLogger.waitForIndexer(indexer),
+            waitForIndexerTransaction: (transactionId) => runWhenIndexerCaughtUp(() => lookupTransactionById(transactionId, indexer)),
+        };
+    };
+    return {
+        get context() {
+            return context;
+        },
+        beforeEach,
+    };
+}
+//# sourceMappingURL=algorand-fixture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"algorand-fixture.js","sourceRoot":"","sources":["../../../../src/testing/fixtures/algorand-fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,KAAK,CAAA;AAC/E,OAAO,EACL,KAAK,EACL,MAAM,EACN,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,QAAQ,CAAA;AAmDf;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqC,EAAE,MAAmB;IACxF,MAAM,GAAG,MAAM,IAAI,0BAA0B,EAAE,CAAA;IAE/C,MAAM,KAAK,GAAG,aAAa,EAAE,KAAK,IAAI,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IACvE,MAAM,OAAO,GAAG,aAAa,EAAE,OAAO,IAAI,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;IACpF,MAAM,GAAG,GAAG,aAAa,EAAE,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACpE,IAAI,OAAsC,CAAA;IAE1C,MAAM,UAAU,GAAG,KAAK,IAAI,EAAE;QAC5B,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACjC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAA;QACjD,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC/D,OAAO,GAAG;YACR,KAAK,EAAE,sBAAsB;YAC7B,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,GAAG;YACR,WAAW,EAAE,MAAM,cAAc,CAC/B,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,IAAI,KAAK,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,EACnF,sBAAsB,EACtB,GAAG,CACJ;YACD,eAAe,EAAE,CAAC,MAA4B,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,CAAC;YACtG,iBAAiB,EAAE,iBAAiB;YACpC,cAAc,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC,OAAO,CAAC;YAC/D,yBAAyB,EAAE,CAAC,aAAqB,EAAE,EAAE,CAAC,sBAAsB,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;SAClI,CAAA;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,UAAU;KACX,CAAA;AACH,CAAC"}

package/esm/testing/fixtures/index.js

@@ -0,0 +1,3 @@
+export * from './algokit-log-capture-fixture';
+export * from './algorand-fixture';
+//# sourceMappingURL=index.js.map

package/esm/testing/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/fixtures/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,oBAAoB,CAAA"}

package/esm/testing/index.js

@@ -0,0 +1,6 @@
+export * from './account';
+export * from './fixtures';
+export * from './indexer';
+export * from './test-logger';
+export * from './transaction-logger';
+//# sourceMappingURL=index.js.map

package/esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,sBAAsB,CAAA"}

package/esm/testing/indexer.js

@@ -0,0 +1,36 @@
+/**
+ * Runs the given indexer call until a 404 error is no longer returned.
+ * Tried every 200ms up to 20 times.
+ * Very rudimentary implementation designed for automated testing.
+ * @example ```typescript
+ * const transaction = await runWhenIndexerCaughtUp(() => indexer.lookupTransactionByID(txnId).do())
+ * ```
+ * @param run The code to run
+ * @returns The result (as a promise), or throws if the indexer didn't catch up in time
+ */
+export async function runWhenIndexerCaughtUp(run) {
+    let result = null;
+    let ok = false;
+    let tries = 0;
+    while (!ok) {
+        try {
+            result = await run();
+            ok = true;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }
+        catch (e) {
+            if (e?.status === 404) {
+                tries++;
+                if (tries > 20) {
+                    throw e;
+                }
+                await new Promise((resolve) => setTimeout(resolve, 200));
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=indexer.js.map

package/esm/testing/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../../src/testing/indexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAI,GAAqB;IACnE,IAAI,MAAM,GAAa,IAAI,CAAA;IAC3B,IAAI,EAAE,GAAG,KAAK,CAAA;IACd,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,OAAO,CAAC,EAAE,EAAE;QACV,IAAI;YACF,MAAM,GAAG,MAAM,GAAG,EAAE,CAAA;YACpB,EAAE,GAAG,IAAI,CAAA;YACT,8DAA8D;SAC/D;QAAC,OAAO,CAAM,EAAE;YACf,IAAI,CAAC,EAAE,MAAM,KAAK,GAAG,EAAE;gBACrB,KAAK,EAAE,CAAA;gBACP,IAAI,KAAK,GAAG,EAAE,EAAE;oBACd,MAAM,CAAC,CAAA;iBACR;gBACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;aAC/D;iBAAM;gBACL,MAAM,CAAC,CAAA;aACR;SACF;KACF;IAED,OAAO,MAAW,CAAA;AACpB,CAAC"}