@algorandfoundation/algokit-utils 1.0.0-beta.3 → 1.0.0-beta.31

package/{dist/index.js → index.js}

@@ -14,14 +14,18 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+const config_1 = require("./types/config");
 __exportStar(require("./account"), exports);
-__exportStar(require("./algo-amount"), exports);
+__exportStar(require("./amount"), exports);
 __exportStar(require("./app"), exports);
-__exportStar(require("./config"), exports);
+__exportStar(require("./application-client"), exports);
 __exportStar(require("./deploy-app"), exports);
 __exportStar(require("./indexer-lookup"), exports);
 __exportStar(require("./localnet"), exports);
 __exportStar(require("./network-client"), exports);
 __exportStar(require("./transaction"), exports);
 __exportStar(require("./transfer"), exports);
+/** The AlgoKit config. To update it use the configure method. */
+exports.Config = new config_1.UpdatableConfig();
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAgD;AAEhD,4CAAyB;AACzB,2CAAwB;AACxB,wCAAqB;AACrB,uDAAoC;AACpC,+CAA4B;AAC5B,mDAAgC;AAChC,6CAA0B;AAC1B,mDAAgC;AAChC,gDAA6B;AAC7B,6CAA0B;AAE1B,iEAAiE;AACpD,QAAA,MAAM,GAAG,IAAI,wBAAe,EAAE,CAAA"}

package/{dist/localnet.d.ts → localnet.d.ts}

@@ -1,13 +1,13 @@
 import { Account, Algodv2, Kmd } from 'algosdk';
-import { AlgoAmount } from './algo-amount';
+import { AlgoAmount } from './types/amount';
 /** Returns true if the algod client is pointing to a LocalNet Algorand network */
 export declare function isLocalNet(algod: Algodv2): Promise<boolean>;
 /**
  * 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 a local sandbox without having to specify the private key (which will change when resetting the sandbox).
+ * 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 sandbox.
+ * 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 @see {getAccount}, then you can even use the same code that runs on production without changes for local development!
  *
@@ -33,7 +33,7 @@ export declare function getOrCreateKmdWalletAccount(walletAccount: {
  * @param kmdClient A KMD client, if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
  * @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
@@ -48,7 +48,7 @@ export declare function getKmdWalletAccount(walletAccount: {
  * 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 kmdClient A KMD client, if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
+ * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
  */
-export declare function getLocalNetDispenserAccount(algod: Algodv2, kmdClient?: Kmd): Promise<Account>;
+export declare function getLocalNetDispenserAccount(algod: Algodv2, kmd?: Kmd): Promise<Account>;
 //# sourceMappingURL=localnet.d.ts.map

package/localnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localnet.d.ts","sourceRoot":"","sources":["../src/localnet.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAKxD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,kFAAkF;AAClF,wBAAsB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,EACtD,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,GAAG,GACd,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE;IACb,IAAI,EAAE,MAAM,CAAA;IAEZ,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAA;CACtD,EACD,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,GAAG,GACd,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAmC9B;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAW7F"}

package/{dist/localnet.js → localnet.js}

@@ -5,11 +5,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLocalNetDispenserAccount = exports.getKmdWalletAccount = exports.getOrCreateKmdWalletAccount = exports.isLocalNet = void 0;
 const algosdk_1 = __importDefault(require("algosdk"));
+const _1 = require("./");
 const account_1 = require("./account");
-const algo_amount_1 = require("./algo-amount");
-const config_1 = require("./config");
 const network_client_1 = require("./network-client");
 const transfer_1 = require("./transfer");
+const amount_1 = require("./types/amount");
 /** Returns true if the algod client is pointing to a LocalNet Algorand network */
 async function isLocalNet(algod) {
     const params = await algod.getTransactionParams().do();
@@ -19,9 +19,9 @@ exports.isLocalNet = isLocalNet;
 /**
  * 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 a local sandbox without having to specify the private key (which will change when resetting the sandbox).
+ * 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 sandbox.
+ * 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 @see {getAccount}, then you can even use the same code that runs on production without changes for local development!
  *
@@ -47,11 +47,11 @@ async function getOrCreateKmdWalletAccount(walletAccount, algod, kmdClient) {
     // 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_1.AlgoKitConfig.logger.info(`Couldn't find existing account in Sandbox under name '${walletAccount.name}'; created account ${account.addr} with keys stored in KMD and funding with ${walletAccount.fundWith?.algos ?? 1000} ALGOs`);
+    _1.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 (0, transfer_1.transferAlgos)({
-        amount: walletAccount.fundWith ?? algo_amount_1.AlgoAmount.Algos(1000),
-        from: await (0, account_1.getDispenserAccount)(algod),
+        amount: walletAccount.fundWith ?? amount_1.AlgoAmount.Algos(1000),
+        from: await (0, account_1.getDispenserAccount)(algod, kmd),
         to: account.addr,
     }, algod);
     return account;
@@ -67,7 +67,7 @@ exports.getOrCreateKmdWalletAccount = getOrCreateKmdWalletAccount;
  * @param kmdClient A KMD client, if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
  * @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
@@ -101,21 +101,21 @@ async function getKmdWalletAccount(walletAccount, algod, kmdClient) {
     }
     const accountKey = (await kmd.exportKey(walletHandle, '', keyIds[i])).private_key;
     const accountMnemonic = algosdk_1.default.secretKeyToMnemonic(accountKey);
-    return (0, account_1.getAccountFromMnemonic)(accountMnemonic);
+    return (0, account_1.mnemonicAccount)(accountMnemonic);
 }
 exports.getKmdWalletAccount = getKmdWalletAccount;
 /**
  * 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 kmdClient A KMD client, if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
+ * @param kmd A KMD client, if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
  */
-async function getLocalNetDispenserAccount(algod, kmdClient) {
+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 > 1000000000 }, algod, kmdClient));
+    return (await getKmdWalletAccount({ name: 'unencrypted-default-wallet', predicate: (a) => a.status !== 'Offline' && a.amount > 1000000000 }, algod, kmd));
 }
 exports.getLocalNetDispenserAccount = getLocalNetDispenserAccount;
 //# sourceMappingURL=localnet.js.map

package/localnet.js.map

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

package/{dist/network-client.d.ts → network-client.d.ts}

@@ -1,14 +1,5 @@
 import { Algodv2, Indexer, Kmd } from 'algosdk';
-import { TokenHeader } from 'algosdk/dist/types/client/urlTokenBaseHTTPClient';
-/** Config for an Algorand SDK client */
-export interface AlgoClientConfig {
-    /** Base URL of the server e.g. http://localhost, https://testnet-api.algonode.cloud/, etc. */
-    server: string;
-    /** The port to use e.g. 4001, 443, etc. */
-    port?: string | number;
-    /** The token to use for API authentication (or undefined if none needed) - can be a string, or an object with the header key => value */
-    token?: string | TokenHeader;
-}
+import { AlgoClientConfig } from './types/network-client';
 /** Retrieve the algod configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
 export declare function getAlgodConfigFromEnvironment(): AlgoClientConfig;
 /** Retrieve the indexer configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
@@ -29,24 +20,24 @@ export declare function getDefaultLocalNetConfig(configOrPort: 'algod' | 'indexe
  * @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 local sandbox, although we recommend loading this into a .env and using the Default option instead)
- * ```
+ * @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()
  * ```
@@ -57,24 +48,24 @@ export declare function getAlgoClient(config?: AlgoClientConfig): Algodv2;
  * @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 local sandbox, although we recommend loading this into a .env and using the Default option instead)
- * ```
+ * @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()
  * ```
@@ -83,17 +74,17 @@ export declare function getAlgoIndexerClient(config?: AlgoClientConfig): Indexer
 /**
  * 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 sandbox network.
+ * 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 local sandbox, although we recommend loading this into a .env and using the Default option instead)
- * ```
+ * @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'})
  * ```
  */

package/network-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-client.d.ts","sourceRoot":"","sources":["../src/network-client.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,mIAAmI;AACnI,wBAAgB,6BAA6B,IAAI,gBAAgB,CAchE;AAED,qIAAqI;AACrI,wBAAgB,+BAA+B,IAAI,gBAAgB,CAclE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,gBAAgB,CAK/G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,gBAAgB,CAM7G;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAIhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAIvE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,GAAG,CAK/D;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/{dist/network-client.js → network-client.js}

@@ -25,7 +25,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalNet = exports.getAlgoKmdClient = exports.getAlgoIndexerClient = exports.getAlgoClient = exports.getDefaultLocalNetConfig = exports.getAlgoNodeConfig = exports.getIndexerConfigFromEnvironment = exports.getAlgodConfigFromEnvironment = void 0;
 const algosdk_1 = __importStar(require("algosdk"));
-const algo_http_client_with_retry_1 = require("./algo-http-client-with-retry");
+const algo_http_client_with_retry_1 = require("./types/algo-http-client-with-retry");
 /** Retrieve the algod configuration from environment variables (expects to be called from a Node.js environment not algod-side) */
 function getAlgodConfigFromEnvironment() {
     if (!process || !process.env) {
@@ -92,24 +92,24 @@ function getAlgoTokenHeader(server, token, defaultHeader) {
  * @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 local sandbox, although we recommend loading this into a .env and using the Default option instead)
- * ```
+ * @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()
  * ```
@@ -125,24 +125,24 @@ exports.getAlgoClient = getAlgoClient;
  * @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 local sandbox, although we recommend loading this into a .env and using the Default option instead)
- * ```
+ * @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()
  * ```
@@ -156,23 +156,23 @@ exports.getAlgoIndexerClient = getAlgoIndexerClient;
 /**
  * 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 sandbox network.
+ * 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 local sandbox, although we recommend loading this into a .env and using the Default option instead)
- * ```
+ * @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'})
  * ```
  */
 function getAlgoKmdClient(config) {
     const { token, server } = config ?? getAlgodConfigFromEnvironment();
-    // We can only use Kmd on the Sandbox otherwise it's not exposed so this makes some assumptions
+    // 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 algosdk_1.Kmd(token, server, process?.env?.KMD_PORT ?? '4002');
 }

package/{dist/network-client.js.map → network-client.js.map}

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

package/package.json

@@ -1,6 +1,8 @@
 {
+  "main": "index.js",
+  "types": "index.d.ts",
   "name": "@algorandfoundation/algokit-utils",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.31",
   "private": false,
   "description": "A set of core Algorand utilities written in TypeScript and released via npm that make it easier to build solutions on Algorand.",
   "author": "Algorand Foundation",
@@ -8,101 +10,11 @@
   "engines": {
     "node": ">=16.0"
   },
-  "main": "./dist/index.js",
   "files": [
-    "dist/**/*"
+    "**/*"
   ],
-  "scripts": {
-    "build": "run-s build:*",
-    "build:0-clean": "rimraf dist coverage",
-    "build:1-compile": "tsc -p tsconfig.build.json",
-    "build:2-copy-pkg-json": "npx --yes @makerx/ts-toolkit@latest copy-package-json",
-    "test": "jest --coverage --passWithNoTests",
-    "lint": "eslint ./src/ --ext .ts",
-    "lint:fix": "eslint ./src/ --ext .ts --fix",
-    "check-types": "tsc --noEmit",
-    "audit": "npm audit",
-    "format": "prettier --write .",
-    "commit-lint": "commitlint --edit -o",
-    "semantic-release": "semantic-release"
-  },
   "dependencies": {
-    "algosdk": "^2.1.0",
+    "algosdk": "^2.2.0",
     "buffer": "^6.0.3"
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^17.4.3",
-    "@commitlint/config-conventional": "^17.4.3",
-    "@makerx/eslint-config": "3.0.0",
-    "@makerx/prettier-config": "2.0.0",
-    "@makerx/ts-config": "1.0.1",
-    "@tsconfig/node16": "^1.0.3",
-    "@types/jest": "^29.2.3",
-    "@types/uuid": "^9.0.1",
-    "conventional-changelog-conventionalcommits": "^5.0.0",
-    "eslint": "8.36.0",
-    "npm-run-all": "^4.1.5",
-    "prettier": "2.8.4",
-    "rimraf": "^4.4.0",
-    "semantic-release": "^20.1.0",
-    "tiny-invariant": "^1.3.1",
-    "ts-jest": "^29.0.3",
-    "ts-node": "^10.9.1",
-    "typescript": "^4.9.3",
-    "uuid": "^9.0.0"
-  },
-  "release": {
-    "branches": [
-      {
-        "name": "main",
-        "prerelease": "beta"
-      },
-      {
-        "name": "release"
-      }
-    ],
-    "plugins": [
-      [
-        "@semantic-release/commit-analyzer",
-        {
-          "preset": "conventionalcommits",
-          "releaseRules": [
-            {
-              "type": "build",
-              "release": "patch"
-            },
-            {
-              "type": "chore",
-              "release": "patch"
-            }
-          ]
-        }
-      ],
-      [
-        "@semantic-release/release-notes-generator",
-        {
-          "preset": "conventionalcommits",
-          "presetConfig": {
-            "types": [
-              {
-                "type": "feat",
-                "section": "Features"
-              },
-              {
-                "type": "fix",
-                "section": "Bug Fixes"
-              },
-              {
-                "type": "build",
-                "section": "Dependencies and Other Build Updates",
-                "hidden": false
-              }
-            ]
-          }
-        }
-      ],
-      "@semantic-release/npm",
-      "@semantic-release/github"
-    ]
   }
 }

package/testing/account.d.ts

@@ -0,0 +1,14 @@
+import { Account, Algodv2, Kmd } from 'algosdk';
+import { GetTestAccountParams } from '../types/testing';
+/**
+ * Creates an ephemeral Algorand account for the purposes of testing.
+ * Returns a newly created random test account that is funded from the dispenser @see {getDispenserAccount}
+ * 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 @see {getAlgoKmdClient}
+ * @returns The account, with private key loaded
+ */
+export declare function getTestAccount({ suppressLog, initialFunds }: GetTestAccountParams, algod: Algodv2, kmd?: Kmd): Promise<Account>;
+//# sourceMappingURL=account.d.ts.map

package/testing/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/testing/account.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAIxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAEvD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBrI"}

package/testing/account.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTestAccount = void 0;
+const algosdk_1 = __importDefault(require("algosdk"));
+const __1 = require("../");
+const account_1 = require("../account");
+const transfer_1 = require("../transfer");
+/**
+ * Creates an ephemeral Algorand account for the purposes of testing.
+ * Returns a newly created random test account that is funded from the dispenser @see {getDispenserAccount}
+ * 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 @see {getAlgoKmdClient}
+ * @returns The account, with private key loaded
+ */
+async function getTestAccount({ suppressLog, initialFunds }, algod, kmd) {
+    const account = algosdk_1.default.generateAccount();
+    __1.Config.getLogger(suppressLog).info(`New test account created with address '${account.addr}' and mnemonic '${algosdk_1.default.secretKeyToMnemonic(account.sk)}'.`);
+    const dispenser = await (0, account_1.getDispenserAccount)(algod, kmd);
+    await (0, transfer_1.transferAlgos)({ from: dispenser, to: account.addr, amount: initialFunds, note: 'Funding test account', suppressLog }, algod);
+    const accountInfo = await algod.accountInformation(account.addr).do();
+    __1.Config.getLogger(suppressLog).info('Test account funded; account balance: %d µAlgos', accountInfo.amount);
+    return account;
+}
+exports.getTestAccount = getTestAccount;
+//# sourceMappingURL=account.js.map

package/testing/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/testing/account.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAwD;AACxD,2BAA4B;AAC5B,wCAAgD;AAChD,0CAA2C;AAG3C;;;;;;;;;GASG;AACI,KAAK,UAAU,cAAc,CAAC,EAAE,WAAW,EAAE,YAAY,EAAwB,EAAE,KAAc,EAAE,GAAS;IACjH,MAAM,OAAO,GAAG,iBAAO,CAAC,eAAe,EAAE,CAAA;IAEzC,UAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAChC,0CAA0C,OAAO,CAAC,IAAI,mBAAmB,iBAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CACrH,CAAA;IAED,MAAM,SAAS,GAAG,MAAM,IAAA,6BAAmB,EAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAEvD,MAAM,IAAA,wBAAa,EAAC,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,UAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,iDAAiD,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAEzG,OAAO,OAAO,CAAA;AAChB,CAAC;AAhBD,wCAgBC"}

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

@@ -0,0 +1,19 @@
+import { AlgoKitLogCaptureFixture } from '../../types/testing';
+/**
+ * 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 declare const algoKitLogCaptureFixture: () => AlgoKitLogCaptureFixture;
+//# sourceMappingURL=algokit-log-capture-fixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"algokit-log-capture-fixture.d.ts","sourceRoot":"","sources":["../../../src/testing/fixtures/algokit-log-capture-fixture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAG9D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,wBAqB5C,CAAA"}

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.algoKitLogCaptureFixture = void 0;
+const __1 = require("../../");
+const test_logger_1 = require("../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
+ */
+const algoKitLogCaptureFixture = () => {
+    const originalLogger = __1.Config.logger;
+    let hybridLogger;
+    return {
+        get testLogger() {
+            return hybridLogger;
+        },
+        beforeEach: () => {
+            hybridLogger = new test_logger_1.TestLogger(originalLogger);
+            __1.Config.configure({
+                logger: hybridLogger,
+            });
+        },
+        afterEach: () => {
+            __1.Config.configure({
+                logger: originalLogger,
+            });
+        },
+    };
+};
+exports.algoKitLogCaptureFixture = algoKitLogCaptureFixture;
+//# sourceMappingURL=algokit-log-capture-fixture.js.map

package/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,8BAA+B;AAE/B,gDAA2C;AAE3C;;;;;;;;;;;;;;;GAeG;AACI,MAAM,wBAAwB,GAAmC,GAAG,EAAE;IAC3E,MAAM,cAAc,GAAG,UAAM,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,wBAAU,CAAC,cAAc,CAAC,CAAA;YAC7C,UAAM,CAAC,SAAS,CAAC;gBACf,MAAM,EAAE,YAAY;aACrB,CAAC,CAAA;QACJ,CAAC;QACD,SAAS,EAAE,GAAG,EAAE;YACd,UAAM,CAAC,SAAS,CAAC;gBACf,MAAM,EAAE,cAAc;aACvB,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC,CAAA;AArBY,QAAA,wBAAwB,4BAqBpC"}

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

@@ -0,0 +1,20 @@
+import { AlgorandFixture, AlgorandFixtureConfig } from '../../types/testing';
+/**
+ * Creates a test fixture for automated testing against Algorand.
+ * By default it tests against a default LocalNet instance, but you can pass in an algod and indexer if you want to test against, say, TestNet.
+ *
+ * @example ```typescript
+ * const algorand = algorandFixture()
+ *
+ * beforeEach(algorand.beforeEach, 10_000)
+ *
+ * test('My test', () => {
+ *     const {algod, indexer, testAccount, ...} = algorand.context
+ * })
+ * ```
+ *
+ * @param fixtureConfig The fixture configuration
+ * @returns The fixture
+ */
+export declare const algorandFixture: (fixtureConfig?: AlgorandFixtureConfig) => AlgorandFixture;
+//# sourceMappingURL=algorand-fixture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"algorand-fixture.d.ts","sourceRoot":"","sources":["../../../src/testing/fixtures/algorand-fixture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAuD,MAAM,qBAAqB,CAAA;AAEjI;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,mBAAoB,qBAAqB,KAAG,eA0BvE,CAAA"}