@algorandfoundation/algokit-utils 1.0.0-beta.6 → 1.0.0-beta.8

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

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./account"), exports);
 __exportStar(require("./algo-amount"), exports);
 __exportStar(require("./app"), exports);
+__exportStar(require("./application-client"), exports);
 __exportStar(require("./config"), exports);
 __exportStar(require("./deploy-app"), exports);
 __exportStar(require("./indexer-lookup"), exports);

package/package.json

@@ -1,6 +1,8 @@
 {
+  "main": "index.js",
+  "types": "index.d.ts",
   "name": "@algorandfoundation/algokit-utils",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "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,104 +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",
-    "generate:code-docs": "typedoc"
-  },
   "dependencies": {
     "algosdk": "^2.1.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",
-    "typedoc": "^0.23.26",
-    "typedoc-plugin-markdown": "^3.14.0",
-    "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/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2022 Algorand Foundation
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,31 +0,0 @@
-# AlgoKit TypeScript Utilities
-
-A set of core Algorand utilities written in TypeScript and released via npm that make it easier to build solutions on Algorand. This project is part of [AlgoKit](https://github.com/algorandfoundation/algokit-cli).
-
-The goal of this library is to provide intuitive, productive utility functions that make it easier, quicker and safer to build applications on Algorand. Largely these functions wrap the underlying Algorand SDK, but provide a higher level interface with sensible defaults and capabilities for common tasks.
-
-Note: If you prefer Python there's an equivalent [Python utility library](https://github.com/algorandfoundation/algokit-utils-py).
-
-[Install](#install) | [Documentation](docs/README.md)
-
-## Install
-
-This library can be installed from NPM using your favourite npm client, e.g.:
-
-```
-npm install @algorandfoundation/algokit-utils
-```
-
-## Guiding principles
-
-This library follows the [Guiding Principles of AlgoKit](https://github.com/algorandfoundation/algokit-cli#guiding-principles).
-
-## Contributing
-
-This is an open source project managed by the Algorand Foundation. See the [AlgoKit contributing page](https://github.com/algorandfoundation/algokit-cli/blob/main/CONTRIBUTING.MD) to learn about making improvements.
-
-To successfully run the tests in this repository you need to be running LocalNet via [AlgoKit](https://github.com/algorandfoundation/algokit-cli):
-
-```
-algokit localnet start
-```

package/dist/account.d.ts

@@ -1,87 +0,0 @@
-import algosdk, { Account, Algodv2, Kmd } from 'algosdk';
-import { AlgoAmount } from './algo-amount';
-import { SigningAccount } from './transaction';
-/**
- * The account name identifier used for fund dispensing in test environments
- */
-export declare const DISPENSER_ACCOUNT = "DISPENSER";
-/** Returns an Algorand account with secret key loaded (i.e. that can sign transactions) by taking the mnemonic secret.
- *
- * This is a wrapper around algosdk.mnemonicToSecretKey to provide a more friendly/obvious name.
- *
- * @param mnemonicSecret The mnemonic secret representing the private key of an account; **Note: Be careful how the mnemonic is handled**,
- *  never commit it into source control and ideally load it from the environment (ideally via a secret storage service) rather than the file system.
- */
-export declare function getAccountFromMnemonic(mnemonicSecret: string): Account;
-/**
- * Returns an Algorand account with private key loaded by convention based on the given name identifier.
- *
- * Note: This function expects to run in a Node.js environment.
- *
- * ## Convention:
- * * **Non-LocalNet:** will load process.env['{NAME}_MNEMONIC'] as a mnemonic secret; **Note: Be careful how the mnemonic is handled**,
- *  never commit it into source control and ideally load it via a secret storage service rather than the file system.
- *   If process.env['{NAME}_SENDER'] is defined then it will use that for the sender address (i.e. to support rekeyed accounts)
- * * **LocalNet:** will load the account from a KMD wallet called {NAME} and if that wallet doesn't exist it will create it and fund the account for you
- *
- * This allows you to write code that will work seamlessly in production and local development (LocalNet) without manual config locally (including when you reset the LocalNet).
- *
- * @example Default
- *
- * If you have a mnemonic secret loaded into `process.env.ACCOUNT_MNEMONIC` then you can call the following to get that private key loaded into an account object:
- * ```
- * const account = await getAccount('ACCOUNT', algod)
- * ```
- *
- * If that code runs against LocalNet then a wallet called `ACCOUNT` will automatically be created with an account that is automatically funded with 1000 (default) ALGOs from the default LocalNet dispenser.
- *
- * @param account The details of the account to get, wither the name identifier (string) or an object with:
- *   * `name`: The name identifier of the account
- *   * `fundWith`: The amount to fund the account with it it gets created (when targeting LocalNet), if not specified then 1000 Algos will be funded from the dispenser account @see {getDispenserAccount}
- * @param algod An algod client
- * @param kmdClient An optional KMD client to use to create an account (when targeting LocalNet), if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
- * @returns The requested account with private key loaded from the environment variables or when targeting LocalNet from KMD (idempotently creating and funding the account)
- */
-export declare function getAccount(account: {
-    name: string;
-    fundWith?: AlgoAmount;
-} | string, algod: Algodv2, kmdClient?: Kmd): Promise<Account | SigningAccount>;
-/**
- * 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 supress the log) */
-    suppressLog?: boolean;
-}
-/**
- * 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
- * @returns The account, with private key loaded
- */
-export declare function getTestAccount({ suppressLog, initialFunds }: GetTestAccountParams, algod: Algodv2): Promise<Account>;
-/** Returns an account's address as a byte array
- *
- * @param account Either an account (with private key loaded) or the string address of an account
- */
-export declare function getAccountAddressAsUint8Array(account: Account | string): Uint8Array;
-/** Returns the string address of an Algorand account from a base64 encoded version of the underlying byte array of the address public key
- *
- * @param addressEncodedInB64 The base64 encoded version of the underlying byte array of the address public key
- */
-export declare function getAccountAddressAsString(addressEncodedInB64: string): string;
-/** Returns an account (with private key loaded) that can act as a dispenser
- *
- * If running on Sandbox then it will return the default dispenser account automatically,
- *  otherwise it will load the account mnemonic stored in process.env.DISPENSER_MNEMONIC @see {getAccount}
- *
- * @param algod An algod client
- */
-export declare function getDispenserAccount(algod: Algodv2): Promise<algosdk.Account | SigningAccount>;
-export {};
-//# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAI1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,cAAc,CAAA;AAE5C;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,MAAM,EACzD,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,GAAG,GACd,OAAO,CAAC,OAAO,GAAG,cAAc,CAAC,CAmCnC;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,8CAA8C;IAC9C,YAAY,EAAE,UAAU,CAAA;IACxB,uGAAuG;IACvG,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB1H;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,cAEtE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,OAAO,6CAIvD"}

package/dist/account.js

@@ -1,144 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDispenserAccount = exports.getAccountAddressAsString = exports.getAccountAddressAsUint8Array = exports.getTestAccount = exports.getAccount = exports.getAccountFromMnemonic = exports.DISPENSER_ACCOUNT = void 0;
-const algosdk_1 = __importDefault(require("algosdk"));
-const config_1 = require("./config");
-const localnet_1 = require("./localnet");
-const network_client_1 = require("./network-client");
-const transaction_1 = require("./transaction");
-const transfer_1 = require("./transfer");
-/**
- * The account name identifier used for fund dispensing in test environments
- */
-exports.DISPENSER_ACCOUNT = 'DISPENSER';
-/** Returns an Algorand account with secret key loaded (i.e. that can sign transactions) by taking the mnemonic secret.
- *
- * This is a wrapper around algosdk.mnemonicToSecretKey to provide a more friendly/obvious name.
- *
- * @param mnemonicSecret The mnemonic secret representing the private key of an account; **Note: Be careful how the mnemonic is handled**,
- *  never commit it into source control and ideally load it from the environment (ideally via a secret storage service) rather than the file system.
- */
-function getAccountFromMnemonic(mnemonicSecret) {
-    // This method is confusingly named, so this function provides a more dev friendly "wrapper" name
-    return algosdk_1.default.mnemonicToSecretKey(mnemonicSecret);
-}
-exports.getAccountFromMnemonic = getAccountFromMnemonic;
-/**
- * Returns an Algorand account with private key loaded by convention based on the given name identifier.
- *
- * Note: This function expects to run in a Node.js environment.
- *
- * ## Convention:
- * * **Non-LocalNet:** will load process.env['{NAME}_MNEMONIC'] as a mnemonic secret; **Note: Be careful how the mnemonic is handled**,
- *  never commit it into source control and ideally load it via a secret storage service rather than the file system.
- *   If process.env['{NAME}_SENDER'] is defined then it will use that for the sender address (i.e. to support rekeyed accounts)
- * * **LocalNet:** will load the account from a KMD wallet called {NAME} and if that wallet doesn't exist it will create it and fund the account for you
- *
- * This allows you to write code that will work seamlessly in production and local development (LocalNet) without manual config locally (including when you reset the LocalNet).
- *
- * @example Default
- *
- * If you have a mnemonic secret loaded into `process.env.ACCOUNT_MNEMONIC` then you can call the following to get that private key loaded into an account object:
- * ```
- * const account = await getAccount('ACCOUNT', algod)
- * ```
- *
- * If that code runs against LocalNet then a wallet called `ACCOUNT` will automatically be created with an account that is automatically funded with 1000 (default) ALGOs from the default LocalNet dispenser.
- *
- * @param account The details of the account to get, wither the name identifier (string) or an object with:
- *   * `name`: The name identifier of the account
- *   * `fundWith`: The amount to fund the account with it it gets created (when targeting LocalNet), if not specified then 1000 Algos will be funded from the dispenser account @see {getDispenserAccount}
- * @param algod An algod client
- * @param kmdClient An optional KMD client to use to create an account (when targeting LocalNet), if not specified then a default KMD client will be loaded from environment variables @see {getAlgoKmdClient}
- * @returns The requested account with private key loaded from the environment variables or when targeting LocalNet from KMD (idempotently creating and funding the account)
- */
-async function getAccount(account, algod, kmdClient) {
-    let name;
-    let fundWith = undefined;
-    if (typeof account === 'string') {
-        name = account;
-    }
-    else {
-        name = account.name;
-        fundWith = account.fundWith;
-    }
-    if (!process || !process.env) {
-        throw new Error('Attempt to get account with private key from a non Node.js context; not supported!');
-    }
-    const envKey = `${name.toUpperCase()}_MNEMONIC`;
-    if (process.env[envKey]) {
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        const signer = getAccountFromMnemonic(process.env[envKey]);
-        const senderKey = `${name.toUpperCase()}_SENDER`;
-        if (process.env[senderKey]) {
-            config_1.AlgoKitConfig.logger.debug(`Using rekeyed account ${signer.addr} for sender ${process.env[senderKey]} for ${name} account`);
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            return new transaction_1.SigningAccount(signer, process.env[senderKey]);
-        }
-        else {
-            return signer;
-        }
-    }
-    if (await (0, network_client_1.isLocalNet)(algod)) {
-        const account = await (0, localnet_1.getOrCreateKmdWalletAccount)({ name, fundWith }, algod, kmdClient);
-        process.env[envKey] = algosdk_1.default.secretKeyToMnemonic(account.sk);
-        return account;
-    }
-    throw `Missing environment variable ${envKey} when looking for account ${name}`;
-}
-exports.getAccount = getAccount;
-/**
- * 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
- * @returns The account, with private key loaded
- */
-async function getTestAccount({ suppressLog, initialFunds }, algod) {
-    const account = algosdk_1.default.generateAccount();
-    config_1.AlgoKitConfig.getLogger(suppressLog).info(`New test account created with address '${account.addr}' and mnemonic '${algosdk_1.default.secretKeyToMnemonic(account.sk)}'.`);
-    // If we are running against LocalNet we can use the default account within it
-    //   otherwise use an automation account specified via environment variables and ensure it's populated with ALGOs
-    const canFundFromDefaultAccount = await (0, network_client_1.isLocalNet)(algod);
-    const dispenser = canFundFromDefaultAccount ? await (0, localnet_1.getLocalNetDispenserAccount)(algod) : await getAccount(exports.DISPENSER_ACCOUNT, algod);
-    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();
-    config_1.AlgoKitConfig.getLogger(suppressLog).info('Test account funded; account balance: %d µAlgos', accountInfo.amount);
-    return account;
-}
-exports.getTestAccount = getTestAccount;
-/** Returns an account's address as a byte array
- *
- * @param account Either an account (with private key loaded) or the string address of an account
- */
-function getAccountAddressAsUint8Array(account) {
-    return algosdk_1.default.decodeAddress(typeof account === 'string' ? account : account.addr).publicKey;
-}
-exports.getAccountAddressAsUint8Array = getAccountAddressAsUint8Array;
-/** Returns the string address of an Algorand account from a base64 encoded version of the underlying byte array of the address public key
- *
- * @param addressEncodedInB64 The base64 encoded version of the underlying byte array of the address public key
- */
-function getAccountAddressAsString(addressEncodedInB64) {
-    return algosdk_1.default.encodeAddress(Buffer.from(addressEncodedInB64, 'base64'));
-}
-exports.getAccountAddressAsString = getAccountAddressAsString;
-/** Returns an account (with private key loaded) that can act as a dispenser
- *
- * If running on Sandbox then it will return the default dispenser account automatically,
- *  otherwise it will load the account mnemonic stored in process.env.DISPENSER_MNEMONIC @see {getAccount}
- *
- * @param algod An algod client
- */
-async function getDispenserAccount(algod) {
-    // If we are running against a sandbox we can use the default account within it, otherwise use an automation account specified via environment variables and ensure it's populated with ALGOs
-    const canFundFromDefaultAccount = await (0, network_client_1.isLocalNet)(algod);
-    return canFundFromDefaultAccount ? await (0, localnet_1.getLocalNetDispenserAccount)(algod) : await getAccount(exports.DISPENSER_ACCOUNT, algod);
-}
-exports.getDispenserAccount = getDispenserAccount;
-//# sourceMappingURL=account.js.map

package/dist/account.js.map

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

package/dist/algo-amount.d.ts

@@ -1,18 +0,0 @@
-/** Wrapper class to ensure safe, explicit conversion between µAlgos, Algos and numbers */
-export declare class AlgoAmount {
-    private amountInMicroAlgos;
-    /** Return the amount as a number in µAlgos */
-    get microAlgos(): number;
-    /** Return the amount as a number in Algos */
-    get algos(): number;
-    constructor(amount: {
-        algos: number;
-    } | {
-        microAlgos: number;
-    });
-    /** Create a @see {AlgoAmount} object representing the given number of Algos */
-    static Algos(amount: number): AlgoAmount;
-    /** Create a @see {AlgoAmount} object representing the given number of µAlgos */
-    static MicroAlgos(amount: number): AlgoAmount;
-}
-//# sourceMappingURL=algo-amount.d.ts.map

package/dist/algo-amount.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"algo-amount.d.ts","sourceRoot":"","sources":["../src/algo-amount.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,qBAAa,UAAU;IACrB,OAAO,CAAC,kBAAkB,CAAA;IAE1B,8CAA8C;IAC9C,IAAI,UAAU,WAEb;IAED,6CAA6C;IAC7C,IAAI,KAAK,WAER;gBAEW,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE;IAI9D,+EAA+E;IAC/E,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM;IAI3B,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM;CAGjC"}

package/dist/algo-amount.js

@@ -1,31 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AlgoAmount = void 0;
-const algosdk_1 = __importDefault(require("algosdk"));
-/** Wrapper class to ensure safe, explicit conversion between µAlgos, Algos and numbers */
-class AlgoAmount {
-    /** Return the amount as a number in µAlgos */
-    get microAlgos() {
-        return this.amountInMicroAlgos;
-    }
-    /** Return the amount as a number in Algos */
-    get algos() {
-        return algosdk_1.default.microalgosToAlgos(this.amountInMicroAlgos);
-    }
-    constructor(amount) {
-        this.amountInMicroAlgos = 'microAlgos' in amount ? amount.microAlgos : algosdk_1.default.algosToMicroalgos(amount.algos);
-    }
-    /** Create a @see {AlgoAmount} object representing the given number of Algos */
-    static Algos(amount) {
-        return new AlgoAmount({ algos: amount });
-    }
-    /** Create a @see {AlgoAmount} object representing the given number of µAlgos */
-    static MicroAlgos(amount) {
-        return new AlgoAmount({ microAlgos: amount });
-    }
-}
-exports.AlgoAmount = AlgoAmount;
-//# sourceMappingURL=algo-amount.js.map

package/dist/algo-amount.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"algo-amount.js","sourceRoot":"","sources":["../src/algo-amount.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA6B;AAE7B,0FAA0F;AAC1F,MAAa,UAAU;IAGrB,8CAA8C;IAC9C,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,kBAAkB,CAAA;IAChC,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK;QACP,OAAO,iBAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAC3D,CAAC;IAED,YAAY,MAAkD;QAC5D,IAAI,CAAC,kBAAkB,GAAG,YAAY,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAChH,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,KAAK,CAAC,MAAc;QACzB,OAAO,IAAI,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,UAAU,CAAC,MAAc;QAC9B,OAAO,IAAI,UAAU,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/C,CAAC;CACF;AA1BD,gCA0BC"}

package/dist/algo-http-client-with-retry.d.ts

@@ -1,14 +0,0 @@
-import { BaseHTTPClientResponse, Query } from 'algosdk/dist/types/client/baseHTTPClient';
-import { URLTokenBaseHTTPClient } from './urlTokenBaseHTTPClient';
-/** A HTTP Client that wraps the Algorand SDK HTTP Client with retries */
-export declare class AlgoHttpClientWithRetry extends URLTokenBaseHTTPClient {
-    private static readonly MAX_TRIES;
-    private static readonly MAX_BACKOFF_MS;
-    private static readonly RETRY_STATUS_CODES;
-    private static readonly RETRY_ERROR_CODES;
-    private callWithRetry;
-    get(relativePath: string, query?: Query<string>, requestHeaders?: Record<string, string>): Promise<BaseHTTPClientResponse>;
-    post(relativePath: string, data: Uint8Array, query?: Query<string>, requestHeaders?: Record<string, string>): Promise<BaseHTTPClientResponse>;
-    delete(relativePath: string, data: Uint8Array, query?: Query<string>, requestHeaders?: Record<string, string>): Promise<BaseHTTPClientResponse>;
-}
-//# sourceMappingURL=algo-http-client-with-retry.d.ts.map

package/dist/algo-http-client-with-retry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"algo-http-client-with-retry.d.ts","sourceRoot":"","sources":["../src/algo-http-client-with-retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAExF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAEjE,yEAAyE;AACzE,qBAAa,uBAAwB,SAAQ,sBAAsB;IACjE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAI;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAI9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAsC;IAChF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAUxC;YAEa,aAAa;IA6BrB,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI9H,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,UAAU,EAChB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EACrB,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC1C,OAAO,CAAC,sBAAsB,CAAC;IAI5B,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,UAAU,EAChB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EACrB,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC1C,OAAO,CAAC,sBAAsB,CAAC;CAGnC"}

package/dist/algo-http-client-with-retry.js

@@ -1,62 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AlgoHttpClientWithRetry = void 0;
-const config_1 = require("./config");
-const urlTokenBaseHTTPClient_1 = require("./urlTokenBaseHTTPClient");
-/** A HTTP Client that wraps the Algorand SDK HTTP Client with retries */
-class AlgoHttpClientWithRetry extends urlTokenBaseHTTPClient_1.URLTokenBaseHTTPClient {
-    async callWithRetry(func) {
-        let response;
-        let numTries = 1;
-        do {
-            try {
-                response = await func();
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            }
-            catch (err) {
-                if (numTries >= AlgoHttpClientWithRetry.MAX_TRIES) {
-                    throw err;
-                }
-                // Only retry for one of the hardcoded conditions
-                if (!(AlgoHttpClientWithRetry.RETRY_ERROR_CODES.includes(err.code) || AlgoHttpClientWithRetry.RETRY_STATUS_CODES.includes(err.status))) {
-                    throw err;
-                }
-                // Retry immediately the first time, then exponentially backoff.
-                const delayTimeMs = numTries == 1 ? 0 : Math.min(1000 * Math.pow(2, numTries - 1), AlgoHttpClientWithRetry.MAX_BACKOFF_MS);
-                if (delayTimeMs > 0) {
-                    await new Promise((r) => setTimeout(r, delayTimeMs));
-                }
-                config_1.AlgoKitConfig.logger.warn(`algosdk request failed ${numTries} times. Retrying in ${delayTimeMs}ms: ${err}`);
-            }
-        } while (!response && ++numTries <= AlgoHttpClientWithRetry.MAX_TRIES);
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return response;
-    }
-    async get(relativePath, query, requestHeaders = {}) {
-        return await this.callWithRetry(() => super.get(relativePath, query, requestHeaders));
-    }
-    async post(relativePath, data, query, requestHeaders = {}) {
-        return await this.callWithRetry(() => super.post(relativePath, data, query, requestHeaders));
-    }
-    async delete(relativePath, data, query, requestHeaders = {}) {
-        return await this.callWithRetry(() => super.delete(relativePath, data, query, requestHeaders));
-    }
-}
-exports.AlgoHttpClientWithRetry = AlgoHttpClientWithRetry;
-AlgoHttpClientWithRetry.MAX_TRIES = 5;
-AlgoHttpClientWithRetry.MAX_BACKOFF_MS = 10000;
-// These lists come from https://visionmedia.github.io/superagent/#retrying-requests
-// which is the underlying library used by algosdk - but the CloudFlare specific 52X status codes have been removed
-AlgoHttpClientWithRetry.RETRY_STATUS_CODES = [408, 413, 429, 500, 502, 503, 504];
-AlgoHttpClientWithRetry.RETRY_ERROR_CODES = [
-    'ETIMEDOUT',
-    'ECONNRESET',
-    'EADDRINUSE',
-    'ECONNREFUSED',
-    'EPIPE',
-    'ENOTFOUND',
-    'ENETUNREACH',
-    'EAI_AGAIN',
-    'EPROTO', // We get this intermittently with AlgoNode API
-];
-//# sourceMappingURL=algo-http-client-with-retry.js.map

package/dist/algo-http-client-with-retry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"algo-http-client-with-retry.js","sourceRoot":"","sources":["../src/algo-http-client-with-retry.ts"],"names":[],"mappings":";;;AACA,qCAAwC;AACxC,qEAAiE;AAEjE,yEAAyE;AACzE,MAAa,uBAAwB,SAAQ,+CAAsB;IAmBzD,KAAK,CAAC,aAAa,CAAC,IAA2C;QACrE,IAAI,QAA4C,CAAA;QAChD,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,GAAG;YACD,IAAI;gBACF,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAA;gBACvB,8DAA8D;aAC/D;YAAC,OAAO,GAAQ,EAAE;gBACjB,IAAI,QAAQ,IAAI,uBAAuB,CAAC,SAAS,EAAE;oBACjD,MAAM,GAAG,CAAA;iBACV;gBACD,iDAAiD;gBACjD,IACE,CAAC,CAAC,uBAAuB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,uBAAuB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAClI;oBACA,MAAM,GAAG,CAAA;iBACV;gBACD,gEAAgE;gBAChE,MAAM,WAAW,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC,cAAc,CAAC,CAAA;gBAC1H,IAAI,WAAW,GAAG,CAAC,EAAE;oBACnB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAA;iBACrD;gBACD,sBAAa,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,uBAAuB,WAAW,OAAO,GAAG,EAAE,CAAC,CAAA;aAC5G;SACF,QAAQ,CAAC,QAAQ,IAAI,EAAE,QAAQ,IAAI,uBAAuB,CAAC,SAAS,EAAC;QACtE,oEAAoE;QACpE,OAAO,QAAS,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,YAAoB,EAAE,KAAqB,EAAE,iBAAyC,EAAE;QAChG,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAA;IACvF,CAAC;IAED,KAAK,CAAC,IAAI,CACR,YAAoB,EACpB,IAAgB,EAChB,KAAqB,EACrB,iBAAyC,EAAE;QAE3C,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAA;IAC9F,CAAC;IAED,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,IAAgB,EAChB,KAAqB,EACrB,iBAAyC,EAAE;QAE3C,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAA;IAChG,CAAC;;AApEH,0DAqEC;AApEyB,iCAAS,GAAG,CAAC,CAAA;AACb,sCAAc,GAAG,KAAK,CAAA;AAE9C,oFAAoF;AACpF,mHAAmH;AAC3F,0CAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AACxD,yCAAiB,GAAG;IAC1C,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,OAAO;IACP,WAAW;IACX,aAAa;IACb,WAAW;IACX,QAAQ,EAAE,+CAA+C;CAC1D,CAAA"}