@algorandfoundation/algokit-utils 1.0.0-beta.2 → 1.0.0-beta.20

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

@@ -1,10 +1,27 @@
-import algosdk, { Account, Algodv2, Kmd } from 'algosdk';
-import { AlgoAmount } from './algo-amount';
-import { SigningAccount } from './transaction';
+import algosdk, { Account, Algodv2, Kmd, MultisigMetadata, TransactionSigner } from 'algosdk';
+import { MultisigAccount, SigningAccount, TransactionSignerAccount } from './types/account';
+import { AlgoAmount } from './types/amount';
 /**
- * The account name identifier used for fund dispensing in test environments
+ * 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 declare const DISPENSER_ACCOUNT = "DISPENSER";
+export declare function multisigAccount(multisigParams: MultisigMetadata, signingAccounts: (Account | SigningAccount)[]): MultisigAccount;
+/**
+ * Returns an account wrapper that supports a rekeyed account.
+ * @param account 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 @see SigningAccount wrapper
+ */
+export declare function rekeyedAccount(account: Account, sender: string): SigningAccount;
+/**
+ * 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 @see SigningAccount wrapper
+ */
+export declare function transactionSignerAccount(signer: TransactionSigner, sender: string): TransactionSignerAccount;
 /** 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.
@@ -12,24 +29,24 @@ export declare const DISPENSER_ACCOUNT = "DISPENSER";
  * @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;
+export declare function mnemonicAccount(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**,
+ * * **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
+ *   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('ACCOUNT', algod)
  * ```
  *
@@ -46,25 +63,6 @@ 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
@@ -81,7 +79,7 @@ export declare function getAccountAddressAsString(addressEncodedInB64: string):
  *  otherwise it will load the account mnemonic stored in process.env.DISPENSER_MNEMONIC @see {getAccount}
  *
  * @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}
  */
-export declare function getDispenserAccount(algod: Algodv2): Promise<algosdk.Account | SigningAccount>;
-export {};
+export declare function getDispenserAccount(algod: Algodv2, kmd?: Kmd): Promise<algosdk.Account | SigningAccount>;
 //# sourceMappingURL=account.d.ts.map

package/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAI7F,OAAO,EAAqB,eAAe,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAC9G,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC,OAAO,GAAG,cAAc,CAAC,EAAE,mBAE9G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAE9D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAE5G;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAG/D;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;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,cAEtE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,GAAG,6CAIlE"}

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

@@ -3,17 +3,42 @@ 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;
+exports.getDispenserAccount = exports.getAccountAddressAsString = exports.getAccountAddressAsUint8Array = exports.getAccount = exports.mnemonicAccount = exports.transactionSignerAccount = exports.rekeyedAccount = exports.multisigAccount = void 0;
 const algosdk_1 = __importDefault(require("algosdk"));
-const config_1 = require("./config");
+const _1 = require("./");
 const localnet_1 = require("./localnet");
 const network_client_1 = require("./network-client");
-const transaction_1 = require("./transaction");
-const transfer_1 = require("./transfer");
+const account_1 = require("./types/account");
 /**
- * The account name identifier used for fund dispensing in test environments
+ * 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
  */
-exports.DISPENSER_ACCOUNT = 'DISPENSER';
+function multisigAccount(multisigParams, signingAccounts) {
+    return new account_1.MultisigAccount(multisigParams, signingAccounts);
+}
+exports.multisigAccount = multisigAccount;
+/**
+ * Returns an account wrapper that supports a rekeyed account.
+ * @param account 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 @see SigningAccount wrapper
+ */
+function rekeyedAccount(account, sender) {
+    return new account_1.SigningAccount(account, sender);
+}
+exports.rekeyedAccount = rekeyedAccount;
+/**
+ * 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 @see SigningAccount wrapper
+ */
+function transactionSignerAccount(signer, sender) {
+    return { addr: sender, signer };
+}
+exports.transactionSignerAccount = transactionSignerAccount;
 /** 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.
@@ -21,28 +46,28 @@ exports.DISPENSER_ACCOUNT = 'DISPENSER';
  * @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) {
+function mnemonicAccount(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;
+exports.mnemonicAccount = mnemonicAccount;
 /**
  * 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**,
+ * * **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
+ *   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('ACCOUNT', algod)
  * ```
  *
@@ -71,12 +96,12 @@ async function getAccount(account, algod, kmdClient) {
     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 signer = mnemonicAccount(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`);
+            _1.Config.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]);
+            return new account_1.SigningAccount(signer, process.env[senderKey]);
         }
         else {
             return signer;
@@ -90,32 +115,6 @@ async function getAccount(account, algod, kmdClient) {
     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();
-    if (!suppressLog) {
-        config_1.AlgoKitConfig.logger.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();
-    if (!suppressLog) {
-        config_1.AlgoKitConfig.logger.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
@@ -138,11 +137,12 @@ exports.getAccountAddressAsString = getAccountAddressAsString;
  *  otherwise it will load the account mnemonic stored in process.env.DISPENSER_MNEMONIC @see {getAccount}
  *
  * @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}
  */
-async function getDispenserAccount(algod) {
+async function getDispenserAccount(algod, kmd) {
     // 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);
+    return canFundFromDefaultAccount ? await (0, localnet_1.getLocalNetDispenserAccount)(algod, kmd) : await getAccount(account_1.DISPENSER_ACCOUNT, algod);
 }
 exports.getDispenserAccount = getDispenserAccount;
 //# sourceMappingURL=account.js.map

package/account.js.map

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

package/amount.d.ts

@@ -0,0 +1,8 @@
+import { AlgoAmount } from './types/amount';
+/** Returns an amount of Algos using @see AlgoAmount */
+export declare const algos: (algos: number) => AlgoAmount;
+/** Returns an amount of µAlgos using @see AlgoAmount */
+export declare const microAlgos: (microAlgos: number) => AlgoAmount;
+/** Returns an amount of µAlgos to cover standard fees for the given number of transactions using @see AlgoAmount */
+export declare const transactionFees: (numberOfTransactions: number) => AlgoAmount;
+//# sourceMappingURL=amount.d.ts.map

package/amount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.d.ts","sourceRoot":"","sources":["../src/amount.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,uDAAuD;AACvD,eAAO,MAAM,KAAK,UAAW,MAAM,eAElC,CAAA;AAED,wDAAwD;AACxD,eAAO,MAAM,UAAU,eAAgB,MAAM,eAE5C,CAAA;AAED,oHAAoH;AACpH,eAAO,MAAM,eAAe,yBAA0B,MAAM,eAE3D,CAAA"}

package/amount.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transactionFees = exports.microAlgos = exports.algos = void 0;
+const algosdk_1 = __importDefault(require("algosdk"));
+const amount_1 = require("./types/amount");
+/** Returns an amount of Algos using @see AlgoAmount */
+const algos = (algos) => {
+    return amount_1.AlgoAmount.Algos(algos);
+};
+exports.algos = algos;
+/** Returns an amount of µAlgos using @see AlgoAmount */
+const microAlgos = (microAlgos) => {
+    return amount_1.AlgoAmount.MicroAlgos(microAlgos);
+};
+exports.microAlgos = microAlgos;
+/** Returns an amount of µAlgos to cover standard fees for the given number of transactions using @see AlgoAmount */
+const transactionFees = (numberOfTransactions) => {
+    return amount_1.AlgoAmount.MicroAlgos(numberOfTransactions * algosdk_1.default.ALGORAND_MIN_TX_FEE);
+};
+exports.transactionFees = transactionFees;
+//# sourceMappingURL=amount.js.map

package/amount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amount.js","sourceRoot":"","sources":["../src/amount.ts"],"names":[],"mappings":";;;;;;AAAA,sDAA6B;AAC7B,2CAA2C;AAE3C,uDAAuD;AAChD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;IACrC,OAAO,mBAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAChC,CAAC,CAAA;AAFY,QAAA,KAAK,SAEjB;AAED,wDAAwD;AACjD,MAAM,UAAU,GAAG,CAAC,UAAkB,EAAE,EAAE;IAC/C,OAAO,mBAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAC1C,CAAC,CAAA;AAFY,QAAA,UAAU,cAEtB;AAED,oHAAoH;AAC7G,MAAM,eAAe,GAAG,CAAC,oBAA4B,EAAE,EAAE;IAC9D,OAAO,mBAAU,CAAC,UAAU,CAAC,oBAAoB,GAAG,iBAAO,CAAC,mBAAmB,CAAC,CAAA;AAClF,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B"}

package/app.d.ts

@@ -0,0 +1,51 @@
+import algosdk, { Algodv2 } from 'algosdk';
+import { ApplicationResponse, PendingTransactionResponse } from './types/algod';
+import { ABIReturn, AppCallArgs, AppCallParams, AppCallTransactionResult, AppCompilationResult, AppReference, CompiledTeal, CreateAppParams, UpdateAppParams } from './types/app';
+/**
+ * Creates a smart contract app, returns the details of the created app.
+ * @param create The parameters to create the app with
+ * @param algod An algod client
+ * @returns The details of the created app, or the transaction to create it if `skipSending`
+ */
+export declare function createApp(create: CreateAppParams, algod: Algodv2): Promise<Partial<AppCompilationResult> & AppCallTransactionResult & AppReference>;
+/**
+ * Updates a smart contract app.
+ * @param update The parameters to update the app with
+ * @param algod An algod client
+ * @returns The transaction
+ */
+export declare function updateApp(update: UpdateAppParams, algod: Algodv2): Promise<Partial<AppCompilationResult> & AppCallTransactionResult>;
+/**
+ * Issues a call to a given app.
+ * @param call The call details.
+ * @param algod An algod client
+ * @returns The result of the call
+ */
+export declare function callApp(call: AppCallParams, algod: Algodv2): Promise<AppCallTransactionResult>;
+export declare function getABIReturn(args?: AppCallArgs, confirmation?: PendingTransactionResponse): ABIReturn | undefined;
+/** Returns the app args ready to load onto an app @see {Transaction} object */
+export declare function getAppArgsForTransaction(args?: AppCallArgs): {
+    accounts: string[] | undefined;
+    appArgs: Uint8Array[] | undefined;
+    boxes: algosdk.BoxReference[] | undefined;
+    foreignApps: number[] | undefined;
+    foreignAssets: number[] | undefined;
+    lease: Uint8Array | undefined;
+} | undefined;
+/**
+ * Gets the current data for the given app from algod.
+ *
+ * @param appId The id of the app
+ * @param algod An algod client
+ * @returns The data about the app
+ */
+export declare function getAppByIndex(appId: number, algod: Algodv2): Promise<ApplicationResponse>;
+/**
+ * Compiles the given TEAL using algod and returns the result.
+ *
+ * @param algod An algod client
+ * @param tealCode The TEAL code
+ * @returns The information about the compiled file
+ */
+export declare function compileTeal(tealCode: string, algod: Algodv2): Promise<CompiledTeal>;
+//# sourceMappingURL=app.d.ts.map

package/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAEd,OAAO,EAMR,MAAM,SAAS,CAAA;AAIhB,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAA;AAC/E,OAAO,EACL,SAAS,EAET,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EAEZ,YAAY,EACZ,eAAe,EACf,eAAe,EAChB,MAAM,aAAa,CAAA;AAEpB;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,wBAAwB,GAAG,YAAY,CAAC,CA2ClF;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,GAAG,wBAAwB,CAAC,CA6BnE;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAqCpG;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,0BAA0B,GAAG,SAAS,GAAG,SAAS,CA6BjH;AAED,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,WAAW;;;;;;;cA4E1D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,gCAEhE;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CASzF"}

package/app.js

@@ -0,0 +1,288 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileTeal = exports.getAppByIndex = exports.getAppArgsForTransaction = exports.getABIReturn = exports.callApp = exports.updateApp = exports.createApp = void 0;
+const algosdk_1 = __importStar(require("algosdk"));
+const buffer_1 = require("buffer");
+const _1 = require("./");
+const transaction_1 = require("./transaction");
+const app_1 = require("./types/app");
+/**
+ * Creates a smart contract app, returns the details of the created app.
+ * @param create The parameters to create the app with
+ * @param algod An algod client
+ * @returns The details of the created app, or the transaction to create it if `skipSending`
+ */
+async function createApp(create, algod) {
+    const { from, approvalProgram: approval, clearStateProgram: clear, schema, note, transactionParams, args, ...sendParams } = create;
+    const compiledApproval = typeof approval === 'string' ? await compileTeal(approval, algod) : undefined;
+    const approvalProgram = compiledApproval ? compiledApproval.compiledBase64ToBytes : approval;
+    const compiledClear = typeof clear === 'string' ? await compileTeal(clear, algod) : undefined;
+    const clearProgram = compiledClear ? compiledClear.compiledBase64ToBytes : clear;
+    const transaction = algosdk_1.default.makeApplicationCreateTxnFromObject({
+        approvalProgram: approvalProgram,
+        clearProgram: clearProgram,
+        numLocalInts: schema.localInts,
+        numLocalByteSlices: schema.localByteSlices,
+        numGlobalInts: schema.globalInts,
+        numGlobalByteSlices: schema.globalByteSlices,
+        extraPages: schema.extraPages ?? Math.floor((approvalProgram.length + clearProgram.length) / app_1.APP_PAGE_MAX_SIZE),
+        onComplete: algosdk_1.default.OnApplicationComplete.NoOpOC,
+        suggestedParams: await (0, transaction_1.getTransactionParams)(transactionParams, algod),
+        from: (0, transaction_1.getSenderAddress)(from),
+        note: (0, transaction_1.encodeTransactionNote)(note),
+        ...getAppArgsForTransaction(args),
+        rekeyTo: undefined,
+    });
+    const { confirmation } = await (0, transaction_1.sendTransaction)({ transaction, from, sendParams }, algod);
+    if (confirmation) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const appId = confirmation['application-index'];
+        _1.Config.getLogger(sendParams.suppressLog).debug(`Created app ${appId} from creator ${(0, transaction_1.getSenderAddress)(from)}`);
+        return {
+            transaction,
+            confirmation,
+            appId,
+            appAddress: algosdk_1.default.getApplicationAddress(appId),
+            return: getABIReturn(args, confirmation),
+            compiledApproval,
+            compiledClear,
+        };
+    }
+    else {
+        return { transaction, appId: 0, appAddress: '', compiledApproval, compiledClear };
+    }
+}
+exports.createApp = createApp;
+/**
+ * Updates a smart contract app.
+ * @param update The parameters to update the app with
+ * @param algod An algod client
+ * @returns The transaction
+ */
+async function updateApp(update, algod) {
+    const { appId, from, approvalProgram: approval, clearStateProgram: clear, note, transactionParams, args, ...sendParams } = update;
+    const compiledApproval = typeof approval === 'string' ? await compileTeal(approval, algod) : undefined;
+    const approvalProgram = compiledApproval ? compiledApproval.compiledBase64ToBytes : approval;
+    const compiledClear = typeof clear === 'string' ? await compileTeal(clear, algod) : undefined;
+    const clearProgram = compiledClear ? compiledClear.compiledBase64ToBytes : clear;
+    const transaction = algosdk_1.default.makeApplicationUpdateTxnFromObject({
+        appIndex: appId,
+        approvalProgram: approvalProgram,
+        clearProgram: clearProgram,
+        suggestedParams: await (0, transaction_1.getTransactionParams)(transactionParams, algod),
+        from: (0, transaction_1.getSenderAddress)(from),
+        note: (0, transaction_1.encodeTransactionNote)(note),
+        ...getAppArgsForTransaction(args),
+        rekeyTo: undefined,
+    });
+    _1.Config.getLogger(sendParams.suppressLog).debug(`Updating app ${appId}`);
+    const result = await (0, transaction_1.sendTransaction)({ transaction, from, sendParams }, algod);
+    return {
+        ...result,
+        return: getABIReturn(args, result.confirmation),
+        compiledApproval,
+        compiledClear,
+    };
+}
+exports.updateApp = updateApp;
+/**
+ * Issues a call to a given app.
+ * @param call The call details.
+ * @param algod An algod client
+ * @returns The result of the call
+ */
+async function callApp(call, algod) {
+    const { appId, callType, from, args, note, transactionParams, ...sendParams } = call;
+    const appCallParameters = {
+        appIndex: appId,
+        from: (0, transaction_1.getSenderAddress)(from),
+        suggestedParams: await (0, transaction_1.getTransactionParams)(transactionParams, algod),
+        ...getAppArgsForTransaction(args),
+        note: (0, transaction_1.encodeTransactionNote)(note),
+        rekeyTo: undefined,
+    };
+    let transaction;
+    switch (callType) {
+        case 'optin':
+            transaction = algosdk_1.default.makeApplicationOptInTxnFromObject(appCallParameters);
+            break;
+        case 'clearstate':
+            transaction = algosdk_1.default.makeApplicationClearStateTxnFromObject(appCallParameters);
+            break;
+        case 'closeout':
+            transaction = algosdk_1.default.makeApplicationCloseOutTxnFromObject(appCallParameters);
+            break;
+        case 'delete':
+            transaction = algosdk_1.default.makeApplicationDeleteTxnFromObject(appCallParameters);
+            break;
+        case 'normal':
+            transaction = algosdk_1.default.makeApplicationNoOpTxnFromObject(appCallParameters);
+            break;
+    }
+    const result = await (0, transaction_1.sendTransaction)({ transaction, from, sendParams }, algod);
+    return {
+        ...result,
+        return: getABIReturn(args, result.confirmation),
+    };
+}
+exports.callApp = callApp;
+function getABIReturn(args, confirmation) {
+    try {
+        if (!args || !('method' in args)) {
+            return undefined;
+        }
+        const method = 'txnCount' in args.method ? args.method : new algosdk_1.ABIMethod(args.method);
+        if (method.returns.type !== 'void' && confirmation) {
+            const logs = confirmation.logs || [];
+            if (logs.length === 0) {
+                throw new Error('App call transaction did not log a return value');
+            }
+            const lastLog = logs[logs.length - 1];
+            if (lastLog.byteLength < 4 || lastLog.slice(0, 4).toString() !== app_1.ABI_RETURN_PREFIX.toString()) {
+                throw new Error('App call transaction did not log a return value (ABI_RETURN_PREFIX not found)');
+            }
+            return {
+                rawReturnValue: new Uint8Array(lastLog.slice(4)),
+                returnValue: method.returns.type.decode(new Uint8Array(lastLog.slice(4))),
+                decodeError: undefined,
+            };
+        }
+    }
+    catch (e) {
+        return {
+            rawReturnValue: undefined,
+            returnValue: undefined,
+            decodeError: e,
+        };
+    }
+    return undefined;
+}
+exports.getABIReturn = getABIReturn;
+/** Returns the app args ready to load onto an app @see {Transaction} object */
+function getAppArgsForTransaction(args) {
+    if (!args)
+        return undefined;
+    let actualArgs;
+    if ('method' in args) {
+        // todo: Land a change to algosdk that extract the logic from ATC, because (fair warning) this is a HACK
+        // I don't want to have to rewrite all of the ABI resolution logic so using an ATC temporarily here
+        // and passing stuff in to keep it happy like a randomly generated account :O
+        // Most of these values aren't being used since the transaction is discarded
+        const dummyAtc = new algosdk_1.AtomicTransactionComposer();
+        const dummyAccount = algosdk_1.default.generateAccount();
+        const dummySigner = (0, algosdk_1.makeBasicAccountTransactionSigner)(dummyAccount);
+        const dummyAppId = 1;
+        const dummyParams = {
+            fee: 1,
+            firstRound: 1,
+            genesisHash: buffer_1.Buffer.from('abcd', 'utf-8').toString('base64'),
+            genesisID: 'a',
+            lastRound: 1,
+        };
+        const methodArgs = args.args?.map((a) => {
+            if (typeof a !== 'object') {
+                return a;
+            }
+            // Handle the various forms of transactions to wrangle them for ATC
+            return 'txn' in a
+                ? a
+                : 'transaction' in a
+                    ? { txn: a.transaction, signer: dummySigner }
+                    : 'txID' in a
+                        ? { txn: a, signer: dummySigner }
+                        : a;
+        });
+        const dummyOnComplete = algosdk_1.OnApplicationComplete.NoOpOC;
+        dummyAtc.addMethodCall({
+            method: 'txnCount' in args.method ? args.method : new algosdk_1.ABIMethod(args.method),
+            methodArgs,
+            // Rest are dummy values
+            appID: dummyAppId,
+            sender: dummyAccount.addr,
+            signer: dummySigner,
+            suggestedParams: dummyParams,
+            onComplete: dummyOnComplete,
+        });
+        const txn = dummyAtc.buildGroup()[0];
+        actualArgs = {
+            accounts: txn.txn.appAccounts,
+            appArgs: txn.txn.appArgs,
+            apps: txn.txn.appForeignApps,
+            assets: txn.txn.appForeignAssets,
+            boxes: txn.txn.boxes?.map((b) => ({
+                appId: b.appIndex,
+                name: b.name,
+            })),
+            lease: args.lease,
+        };
+    }
+    else {
+        actualArgs = args;
+    }
+    const encoder = new TextEncoder();
+    return {
+        accounts: actualArgs?.accounts?.map((a) => (typeof a === 'string' ? a : algosdk_1.default.encodeAddress(a.publicKey))),
+        appArgs: actualArgs?.appArgs?.map((a) => (typeof a === 'string' ? encoder.encode(a) : a)),
+        boxes: actualArgs?.boxes?.map((ref) => ({
+            appIndex: ref.appId,
+            name: typeof ref.name === 'string' ? encoder.encode(ref.name) : ref.name,
+        })),
+        foreignApps: actualArgs?.apps,
+        foreignAssets: actualArgs?.assets,
+        lease: typeof actualArgs?.lease === 'string' ? encoder.encode(actualArgs?.lease) : actualArgs?.lease,
+    };
+}
+exports.getAppArgsForTransaction = getAppArgsForTransaction;
+/**
+ * Gets the current data for the given app from algod.
+ *
+ * @param appId The id of the app
+ * @param algod An algod client
+ * @returns The data about the app
+ */
+async function getAppByIndex(appId, algod) {
+    return (await algod.getApplicationByID(appId).do());
+}
+exports.getAppByIndex = getAppByIndex;
+/**
+ * Compiles the given TEAL using algod and returns the result.
+ *
+ * @param algod An algod client
+ * @param tealCode The TEAL code
+ * @returns The information about the compiled file
+ */
+async function compileTeal(tealCode, algod) {
+    const compiled = await algod.compile(tealCode).sourcemap(true).do();
+    return {
+        teal: tealCode,
+        compiled: compiled.result,
+        compiledHash: compiled.hash,
+        compiledBase64ToBytes: new Uint8Array(buffer_1.Buffer.from(compiled.result, 'base64')),
+        sourceMap: new algosdk_1.SourceMap(compiled['sourcemap']),
+    };
+}
+exports.compileTeal = compileTeal;
+//# sourceMappingURL=app.js.map