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

package/{types → cjs/types}/urlTokenBaseHTTPClient.js

@@ -4,6 +4,7 @@ exports.URLTokenBaseHTTPClient = void 0;
 const buffer_1 = require("buffer");
 const cross_fetch_1 = require("cross-fetch");
 class URLTokenBaseHTTPError extends Error {
+    response;
     constructor(message, response) {
         super(message);
         this.response = response;
@@ -17,6 +18,9 @@ class URLTokenBaseHTTPError extends Error {
  * This is the default implementation of BaseHTTPClient.
  */
 class URLTokenBaseHTTPClient {
+    defaultHeaders;
+    baseURL;
+    tokenHeader;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     constructor(tokenHeader, baseServer, port, defaultHeaders = {}) {
         this.defaultHeaders = defaultHeaders;

package/cjs/types/urlTokenBaseHTTPClient.js.map

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

package/cjs/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,UAAW,MAAM,GAAG,MAAM,WAa9C,CAAA;AAED,qBAAa,qBAAsB,SAAQ,KAAK;CAAG"}

package/cjs/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/util.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAE,EAAE;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3C,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;QAC3C,MAAM,IAAI,qBAAqB,CAC7B,kBAAkB,KAAK,sFAAsF,CAC9G,CAAA;KACF;SAAM,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;QAClD,MAAM,IAAI,qBAAqB,CAC7B,kBAAkB,KAAK,uFAAuF,CAC/G,CAAA;KACF;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC,CAAA;AAbY,QAAA,QAAQ,YAapB;AAED,MAAa,qBAAsB,SAAQ,KAAK;CAAG;AAAnD,sDAAmD"}

package/esm/account.js

@@ -0,0 +1,170 @@
+import algosdk from 'algosdk';
+import { Config } from './';
+import { getLocalNetDispenserAccount, getOrCreateKmdWalletAccount } from './localnet';
+import { isLocalNet } from './network-client';
+import { getSenderAddress } from './transaction';
+import { DISPENSER_ACCOUNT, MultisigAccount, SigningAccount } from './types/account';
+/**
+ * Returns an account wrapper that supports partial or full multisig signing.
+ * @param multisigParams The parameters that define the multisig account
+ * @param signingAccounts The signers that are currently present
+ * @returns A multisig account wrapper
+ */
+export function multisigAccount(multisigParams, signingAccounts) {
+    return new MultisigAccount(multisigParams, signingAccounts);
+}
+/**
+ * Returns an account wrapper that supports a rekeyed account.
+ * @param signer The account, with private key loaded, that is signing
+ * @param sender The address of the rekeyed account that will act as a sender
+ * @returns The SigningAccount wrapper
+ */
+export function rekeyedAccount(signer, sender) {
+    return new SigningAccount(signer, sender);
+}
+/**
+ * Returns an account wrapper that supports a transaction signer with associated sender address.
+ * @param signer The transaction signer
+ * @param sender The address of sender account
+ * @returns The SigningAccount wrapper
+ */
+export function transactionSignerAccount(signer, sender) {
+    return { addr: sender, signer };
+}
+/** 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 function mnemonicAccount(mnemonicSecret) {
+    // This method is confusingly named, so this function provides a more dev friendly "wrapper" name
+    return algosdk.mnemonicToSecretKey(mnemonicSecret);
+}
+/** Returns a new, random Algorand account with secret key loaded.
+ *
+ * This is a wrapper around algosdk.generateAccount to provide a more friendly/obvious name.
+ *
+ */
+export function randomAccount() {
+    // This method is confusingly named, so this function provides a more dev friendly "wrapper" name
+    return algosdk.generateAccount();
+}
+/**
+ * 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:
+ * ```typescript
+ * const account = await getAccount({config: getAccountConfigFromEnvironment('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, either the name identifier (string) or an object with:
+ *   * `config`: Account configuration. To get from environment use getAccountConfigFromEnvironment(accountName) OR
+ *   * `name`: string: The name identifier of the account (deprecated)
+ *   And optionally
+ *   * `fundWith`: The amount to fund the account with when it gets created (when targeting LocalNet), if not specified then 1000 Algos will be funded from the dispenser account
+ * @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
+ * @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 async function getAccount(account, algod, kmdClient) {
+    let name;
+    let fundWith = undefined;
+    let config;
+    if (typeof account === 'string') {
+        name = account;
+        config = getAccountConfigFromEnvironment(name);
+    }
+    else if ('name' in account) {
+        name = account.name;
+        config = getAccountConfigFromEnvironment(name);
+        fundWith = account.fundWith;
+    }
+    else if ('config' in account) {
+        config = account.config;
+        name = config.accountName;
+        fundWith = account.fundWith;
+    }
+    else {
+        throw new Error('Missing name or account config');
+    }
+    if (config.accountMnemonic) {
+        const signer = mnemonicAccount(config.accountMnemonic);
+        const sender = config.senderAddress || config.senderMnemonic;
+        if (sender) {
+            Config.logger.debug(`Using rekeyed account ${signer.addr} for sender ${sender} for ${name} account`);
+            return new SigningAccount(signer, sender);
+        }
+        else {
+            return signer;
+        }
+    }
+    if (await isLocalNet(algod)) {
+        const account = await getOrCreateKmdWalletAccount({ name, fundWith }, algod, kmdClient);
+        config.accountMnemonic = algosdk.secretKeyToMnemonic(account.sk);
+        return account;
+    }
+    throw new Error(`Missing environment variable ${name.toUpperCase()}_MNEMONIC when looking for account ${name}`);
+}
+/** 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 function getAccountAddressAsUint8Array(account) {
+    return algosdk.decodeAddress(typeof account === 'string' ? account : getSenderAddress(account)).publicKey;
+}
+/** 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 function getAccountAddressAsString(addressEncodedInB64) {
+    return algosdk.encodeAddress(Buffer.from(addressEncodedInB64, 'base64'));
+}
+/** Returns an account (with private key loaded) that can act as a dispenser
+ *
+ * If running on LocalNet then it will return the default dispenser account automatically,
+ *  otherwise it will load the account mnemonic stored in process.env.DISPENSER_MNEMONIC
+ *
+ * @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 getDispenserAccount(algod, kmd) {
+    // 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 isLocalNet(algod);
+    return canFundFromDefaultAccount ? await getLocalNetDispenserAccount(algod, kmd) : await getAccount(DISPENSER_ACCOUNT, algod);
+}
+/** Returns the Account configuration from environment variables
+ *
+ * @param accountName account name
+ *
+ * @example environment variables
+ * {accountName}_MNEMONIC
+ * {accountName}_SENDER
+ *
+ */
+export function getAccountConfigFromEnvironment(accountName) {
+    if (!process || !process.env) {
+        throw new Error('Attempt to get account with private key from a non Node.js context; not supported!');
+    }
+    return {
+        accountMnemonic: process.env[`${accountName.toUpperCase()}_MNEMONIC`] || '',
+        senderAddress: process.env[`${accountName.toUpperCase()}_SENDER`],
+        accountName,
+    };
+}
+//# sourceMappingURL=account.js.map

package/esm/account.js.map

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

package/esm/amount.js

@@ -0,0 +1,27 @@
+import algosdk from 'algosdk';
+import { AlgoAmount } from './types/amount';
+Number.prototype.microAlgos = function () {
+    return AlgoAmount.MicroAlgos(this);
+};
+Number.prototype.algos = function () {
+    return AlgoAmount.Algos(this);
+};
+/** Returns an amount of Algos using AlgoAmount
+ * @param algos The amount in Algos
+ */
+export const algos = (algos) => {
+    return AlgoAmount.Algos(algos);
+};
+/** Returns an amount of µAlgos using AlgoAmount
+ * @param microAlgos The amount in µAlgos
+ */
+export const microAlgos = (microAlgos) => {
+    return AlgoAmount.MicroAlgos(microAlgos);
+};
+/** Returns an amount of µAlgos to cover standard fees for the given number of transactions using AlgoAmount
+ * @param numberOfTransactions The of standard transaction fees to return the amount of ALGOs
+ */
+export const transactionFees = (numberOfTransactions) => {
+    return AlgoAmount.MicroAlgos(numberOfTransactions * algosdk.ALGORAND_MIN_TX_FEE);
+};
+//# sourceMappingURL=amount.js.map

package/esm/amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.js","sourceRoot":"","sources":["../../src/amount.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAS3C,MAAM,CAAC,SAAS,CAAC,UAAU,GAAG;IAC5B,OAAO,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC,CAAA;AAED,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG;IACvB,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;IACrC,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAkB,EAAE,EAAE;IAC/C,OAAO,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAC1C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,oBAA4B,EAAE,EAAE;IAC9D,OAAO,UAAU,CAAC,UAAU,CAAC,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAClF,CAAC,CAAA"}

package/esm/app-client.js

@@ -0,0 +1,76 @@
+import { ApplicationClient } from './types/app-client';
+/**
+ * Create a new ApplicationClient instance
+ * @param appDetails The details of the app
+ * @param algod An algod instance
+ *
+ * @example Resolve by creator and name
+ * const client = algokit.getAppClient(
+ *     {
+ *       resolveBy: 'creatorAndName',
+ *       app: {appSpec},
+ *       sender: {account},
+ *       creatorAddress: {creator},
+ *       findExistingUsing: indexerClient,
+ *     },
+ *     algodClient,
+ *   )
+ *
+ * @example Resolve by id:
+ * const client = algokit.getAppClient(
+ *     {
+ *       resolveBy: 'id',
+ *       app: {appSpec},
+ *       sender: {account},
+ *       id: {id},
+ *     },
+ *    algodClient,
+ * )
+ *
+ * @returns The application client
+ */
+export function getAppClient(appDetails, algod) {
+    return new ApplicationClient(appDetails, algod);
+}
+/**
+ * Create a new ApplicationClient instance by id
+ * @param appDetails The details of the app
+ * @param algod An algod instance
+ *
+ * @example
+ * const client = algokit.getAppClientById(
+ *     {
+ *       app: {appSpec},
+ *       sender: {account},
+ *       id: {id},
+ *     },
+ *     algodClient,
+ *   )
+ *
+ * @returns The application client
+ */
+export function getAppClientById(appDetails, algod) {
+    return new ApplicationClient({ ...appDetails, resolveBy: 'id' }, algod);
+}
+/**
+ * Create a new ApplicationClient instance by creator and name
+ * @param appDetails The details of the app by creator and name
+ * @param algod An algod instance
+ *
+ * @example
+ * const client = algokit.getAppClientByCreatorAndName(
+ *     {
+ *       app: {appSpec},
+ *       sender: {account},
+ *       creatorAddress: {account.addr},
+ *       findExistingUsing: {indexerClient},
+ *     },
+ *     algodClient,
+ *   )
+ *
+ * @returns The application client
+ */
+export function getAppClientByCreatorAndName(appDetails, algod) {
+    return new ApplicationClient({ ...appDetails, resolveBy: 'creatorAndName' }, algod);
+}
+//# sourceMappingURL=app-client.js.map

package/esm/app-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-client.js","sourceRoot":"","sources":["../../src/app-client.ts"],"names":[],"mappings":"AACA,OAAO,EAA+E,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEnI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,YAAY,CAAC,UAA6B,EAAE,KAAc;IACxE,OAAO,IAAI,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAiC,EAAE,KAAc;IAChF,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAA;AACzE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAA6C,EAAE,KAAc;IACxG,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,KAAK,CAAC,CAAA;AACrF,CAAC"}