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

package/types/client-manager.mjs

@@ -1,6 +1,7 @@
 import algosdk from 'algosdk';
 import { AlgoHttpClientWithRetry } from './algo-http-client-with-retry.mjs';
-import { ApplicationClient } from './app-client.mjs';
+import { AppClient } from './app-client.mjs';
+import { AppFactory } from './app-factory.mjs';
 import { TestNetDispenserApiClient } from './dispenser-client.mjs';
 import { genesisIdIsLocalNet } from './network-client.mjs';
 
@@ -29,7 +30,7 @@ class ClientManager {
      * const clientManager = new ClientManager({ algodConfig, indexerConfig, kmdConfig })
      * ```
      */
-    constructor(clientsOrConfig) {
+    constructor(clientsOrConfig, algorandClient) {
         const _clients = 'algod' in clientsOrConfig
             ? clientsOrConfig
             : {
@@ -40,6 +41,7 @@ class ClientManager {
         this._algod = _clients.algod;
         this._indexer = _clients.indexer;
         this._kmd = _clients.kmd;
+        this._algorand = algorandClient;
     }
     /** Returns an algosdk Algod API client. */
     get algod() {
@@ -150,32 +152,99 @@ class ClientManager {
         return new TestNetDispenserApiClient(params ? { ...params, authToken: '' } : undefined);
     }
     /**
-     * Returns a new `ApplicationClient` client, resolving the app by creator address and name.
-     * @param details The details to resolve the app by creator address and name
-     * @param cachedAppLookup A cached app lookup that matches a name to on-chain details; either this is needed or indexer is required to be passed in to this manager on construction.
-     * @returns The `ApplicationClient`
+     * Returns a new `AppFactory` client
+     * @example Basic example
+     * ```typescript
+     * const factory = algorand.client.getAppFactory({
+     *   appSpec: '{/* ARC-56 or ARC-32 compatible JSON *\/}',
+     * })
+     * ```
+     * @example Advanced example
+     * ```typescript
+     * const factory = algorand.client.getAppFactory({
+     *   appSpec: parsedAppSpec_AppSpec_or_Arc56Contract,
+     *   defaultSender: "SENDERADDRESS",
+     *   appName: "OverriddenAppName",
+     *   version: "2.0.0",
+     *   updatable: true,
+     *   deletable: false,
+     *   deployTimeParams: { ONE: 1, TWO: 'value' }
+     * })
+     * ```
+     */
+    getAppFactory(params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app factory from a ClientManager without an Algorand client');
+        }
+        return new AppFactory({ ...params, algorand: this._algorand });
+    }
+    /**
+     * Returns a new `AppClient` client for managing calls and state for an ARC-32/ARC-56 app.
+     * This method resolves the app ID by looking up the creator address and name
+     * using AlgoKit app deployment semantics (i.e. looking for the app creation transaction note).
+     * @param params The parameters to create the app client
+     * @example Basic
+     * const appClient = algorand.client.getAppClientByCreatorAndName({
+     *   appSpec: '{/* ARC-56 or ARC-32 compatible JSON *\}',
+     *   // appId resolved by looking for app ID of named app by this creator
+     *   creatorAddress: 'CREATORADDRESS',
+     * })
+     * @returns The `AppClient`
      */
-    getAppClientByCreatorAndName(details, cachedAppLookup) {
-        return new ApplicationClient({ ...details, resolveBy: 'creatorAndName', findExistingUsing: cachedAppLookup ?? this.indexer }, this._algod);
+    getAppClientByCreatorAndName(params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app client from a ClientManager without an Algorand client');
+        }
+        return AppClient.fromCreatorAndName({
+            ...params,
+            algorand: this._algorand,
+        });
     }
     /**
-     * Returns a new `ApplicationClient` client, resolving the app by app ID.
-     * @param details The details to resolve the app by ID
-     * @returns The `ApplicationClient`
+     * Returns a new `AppClient` client for managing calls and state for an ARC-32/ARC-56 app.
+     * @param params The parameters to create the app client
+     * @example Basic
+     * const appClient = algorand.client.getAppClientById({
+     *   appSpec: '{/* ARC-56 or ARC-32 compatible JSON *\}',
+     *   appId: 12345n,
+     * })
+     * @returns The `AppClient`
      */
-    getAppClientById(details) {
-        return new ApplicationClient({ ...details, resolveBy: 'id' }, this._algod);
+    getAppClientById(params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app client from a ClientManager without an Algorand client');
+        }
+        return new AppClient({ ...params, algorand: this._algorand });
+    }
+    /**
+     * Returns a new `AppClient` client for managing calls and state for an ARC-56 app.
+     * This method resolves the app ID for the current network based on
+     * pre-determined network-specific app IDs specified in the ARC-56 app spec.
+     *
+     * If no IDs are in the app spec or the network isn't recognised, an error is thrown.
+     * @param params The parameters to create the app client
+     * @example Basic
+     * const appClient = algorand.client.getAppClientByNetwork({
+     *   appSpec: '{/* ARC-56 or ARC-32 compatible JSON *\}',
+     *   // appId resolved by using ARC-56 spec to find app ID for current network
+     * })
+     * @returns The `AppClient`
+     */
+    async getAppClientByNetwork(params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app client from a ClientManager without an Algorand client');
+        }
+        return AppClient.fromNetwork({ ...params, algorand: this._algorand });
     }
     /**
      * Returns a new typed client, resolving the app by creator address and name.
      * @param typedClient The typed client type to use
-     * @param details The details to resolve the app by creator address and name
-     * @param cachedAppLookup A cached app lookup that matches a name to on-chain details; either this is needed or indexer is required to be passed in to this manager on construction.
-     * @example Use name in ARC-32 app spec
+     * @param params The params to resolve the app by creator address and name
+     * @example Use name in ARC-32 / ARC-56 app spec
      * ```typescript
      * const appClient = algorand.client.getTypedAppClientByCreatorAndName(MyContractClient, {
      *   creatorAddress: "CREATORADDRESS",
-     *   sender: alice,
+     *   defaultSender: alice,
      * })
      * ```
      * @example Specify name
@@ -183,29 +252,74 @@ class ClientManager {
      * const appClient = algorand.client.getTypedAppClientByCreatorAndName(MyContractClient, {
      *   creatorAddress: "CREATORADDRESS",
      *   name: "contract-name",
-     *   sender: alice,
+     *   defaultSender: alice,
      * })
      * ```
      * @returns The typed client instance
      */
-    getTypedAppClientByCreatorAndName(typedClient, details, cachedAppLookup) {
-        return new typedClient({ ...details, resolveBy: 'creatorAndName', findExistingUsing: cachedAppLookup ?? this.indexer }, this._algod);
+    async getTypedAppClientByCreatorAndName(typedClient, params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app client from a ClientManager without an Algorand client');
+        }
+        return typedClient.fromCreatorAndName({ ...params, algorand: this._algorand });
     }
     /**
      * Returns a new typed client, resolving the app by app ID.
      * @param typedClient The typed client type to use
-     * @param details The details to resolve the app by ID
+     * @param params The params to resolve the app by ID
      * @example
      * ```typescript
      * const appClient = algorand.client.getTypedAppClientById(MyContractClient, {
-     *   id: 12345,
+     *   appId: 12345n,
+     *   defaultSender: alice,
+     * })
+     * ```
+     * @returns The typed client instance
+     */
+    getTypedAppClientById(typedClient, params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app client from a ClientManager without an Algorand client');
+        }
+        return new typedClient({ ...params, algorand: this._algorand });
+    }
+    /**
+     * Returns a new typed client, resolves the app ID for the current network based on
+     * pre-determined network-specific app IDs specified in the ARC-56 app spec.
+     *
+     * If no IDs are in the app spec or the network isn't recognised, an error is thrown.
+     * @param typedClient The typed client type to use
+     * @param params The params to resolve the app by network
+     * @example
+     * ```typescript
+     * const appClient = algorand.client.getTypedAppClientByNetwork(MyContractClient, {
+     *   defaultSender: alice,
+     * })
+     * ```
+     * @returns The typed client instance
+     */
+    getTypedAppClientByNetwork(typedClient, params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app client from a ClientManager without an Algorand client');
+        }
+        return typedClient.fromNetwork({ ...params, algorand: this._algorand });
+    }
+    /**
+     * Returns a new typed app factory.
+     * @param typedFactory The typed factory type to use
+     * @param params The params to resolve the factory by
+     * @example
+     * ```typescript
+     * const appFactory = algorand.client.getTypedAppFactory(MyContractClient, {
      *   sender: alice,
      * })
      * ```
      * @returns The typed client instance
      */
-    getTypedAppClientById(typedClient, details) {
-        return new typedClient({ ...details, resolveBy: 'id' }, this._algod);
+    getTypedAppFactory(typedFactory, params) {
+        if (!this._algorand) {
+            throw new Error('Attempt to get app factory from a ClientManager without an Algorand client');
+        }
+        return new typedFactory({ ...params, algorand: this._algorand });
     }
     /**
      * Retrieve client configurations from environment variables when defined or get defaults (expects to be called from a Node.js environment)

package/types/client-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client-manager.mjs","sources":["../../src/types/client-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"client-manager.mjs","sources":["../../src/types/client-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/types/composer.d.ts

@@ -3,10 +3,15 @@ import { TransactionSignerAccount } from './account';
 import { AlgoAmount } from './amount';
 import { AppManager, BoxIdentifier, BoxReference } from './app-manager';
 import { Expand } from './expand';
-import { Arc2TransactionNote, SendAtomicTransactionComposerResults } from './transaction';
+import { Arc2TransactionNote, ExecuteParams, SendAtomicTransactionComposerResults } from './transaction';
 import Transaction = algosdk.Transaction;
+import TransactionSigner = algosdk.TransactionSigner;
 import TransactionWithSigner = algosdk.TransactionWithSigner;
+import SimulateResponse = algosdk.modelsv2.SimulateResponse;
+import modelsv2 = algosdk.modelsv2;
 export declare const MAX_TRANSACTION_GROUP_SIZE = 16;
+/** Options to control a simulate request */
+export type SimulateOptions = Expand<Omit<ConstructorParameters<typeof modelsv2.SimulateRequest>[0], 'txnGroups'>>;
 /** Common parameters for defining a transaction. */
 export type CommonTransactionParams = {
     /** The address of the account sending the transaction. */
@@ -283,7 +288,7 @@ export type OnlineKeyRegistrationParams = CommonTransactionParams & {
 export type CommonAppCallParams = CommonTransactionParams & {
     /** ID of the application; 0 if the application is being created. */
     appId: bigint;
-    /** The [on-complete](https://developer.algorand.org/docs/get-details/dapps/avm/teal/specification/#oncomplete) action of the call. */
+    /** The [on-complete](https://developer.algorand.org/docs/get-details/dapps/avm/teal/specification/#oncomplete) action of the call; defaults to no-op. */
     onComplete?: algosdk.OnApplicationComplete;
     /** Any [arguments to pass to the smart contract call](https://developer.algorand.org/docs/get-details/dapps/avm/teal/#argument-passing). */
     args?: Uint8Array[];
@@ -317,7 +322,9 @@ export type AppCreateParams = Expand<Omit<CommonAppCallParams, 'appId'> & {
         /** The number of byte slices saved in local state. */
         localByteSlices: number;
     };
-    /** Number of extra pages required for the programs. This is immutable once the app is created. */
+    /** Number of extra pages required for the programs.
+     * Defaults to the number needed for the programs in this call if not specified.
+     * This is immutable once the app is created. */
     extraProgramPages?: number;
 }>;
 export type AppUpdateParams = Expand<CommonAppCallParams & {
@@ -331,6 +338,10 @@ export type AppUpdateParams = Expand<CommonAppCallParams & {
 export type AppCallParams = CommonAppCallParams & {
     onComplete?: Exclude<algosdk.OnApplicationComplete, algosdk.OnApplicationComplete.UpdateApplicationOC>;
 };
+/** Parameters to define a method call transaction. */
+export type AppMethodCallParams = CommonAppCallParams & {
+    onComplete?: Exclude<algosdk.OnApplicationComplete, algosdk.OnApplicationComplete.UpdateApplicationOC | algosdk.OnApplicationComplete.ClearStateOC>;
+};
 /** Parameters to define an application delete call transaction. */
 export type AppDeleteParams = CommonAppCallParams & {
     onComplete?: algosdk.OnApplicationComplete.DeleteApplicationOC;
@@ -338,7 +349,8 @@ export type AppDeleteParams = CommonAppCallParams & {
 export type AppCreateMethodCall = AppMethodCall<AppCreateParams>;
 export type AppUpdateMethodCall = AppMethodCall<AppUpdateParams>;
 export type AppDeleteMethodCall = AppMethodCall<AppDeleteParams>;
-export type AppCallMethodCall = AppMethodCall<AppCallParams>;
+export type AppCallMethodCall = AppMethodCall<AppMethodCallParams>;
+export type AppMethodCallTransactionArgument = TransactionWithSigner | Transaction | Promise<Transaction> | AppMethodCall<AppCreateParams> | AppMethodCall<AppUpdateParams> | AppMethodCall<AppMethodCallParams>;
 export type AppMethodCall<T> = Expand<Omit<T, 'args'>> & {
     /** The ABI method to call */
     method: algosdk.ABIMethod;
@@ -349,17 +361,8 @@ export type AppMethodCall<T> = Expand<Omit<T, 'args'>> & {
      * * An unawaited transaction (e.g. from algorand.transactions.transactionType())
      * * Another method call (via method call params object)
      */
-    args?: (algosdk.ABIValue | TransactionWithSigner | Transaction | Promise<Transaction> | AppMethodCall<AppCreateParams> | AppMethodCall<AppUpdateParams> | AppMethodCall<AppCallParams>)[];
+    args?: (algosdk.ABIValue | TransactionWithSigner | Transaction | Promise<Transaction> | AppMethodCall<AppCreateParams> | AppMethodCall<AppUpdateParams> | AppMethodCall<AppMethodCallParams>)[];
 };
-/** Parameters to configure transaction execution. */
-export interface ExecuteParams {
-    /** The number of rounds to wait for confirmation. By default until the latest lastValid has past. */
-    maxRoundsToWaitForConfirmation?: number;
-    /** Whether to suppress log messages from transaction send, default: do not suppress. */
-    suppressLog?: boolean;
-    /** Whether to use simulate to automatically populate app call resources in the txn objects. Defaults to `Config.populateAppCallResources`. */
-    populateAppCallResources?: boolean;
-}
 /** Parameters to create an `AlgoKitComposer`. */
 export type AlgoKitComposerParams = {
     /** The algod client to use to get suggestedParams and send the transaction group */
@@ -413,6 +416,13 @@ export default class AlgoKitComposer {
      * @param params The configuration for this composer
      */
     constructor(params: AlgoKitComposerParams);
+    /**
+     * Add a pre-built transaction to the transaction group.
+     * @param transaction The pre-built transaction
+     * @param signer Optional signer override for the transaction
+     * @returns The composer so you can chain method calls
+     */
+    addTransaction(transaction: Transaction, signer?: TransactionSigner): AlgoKitComposer;
     /**
      * Add a payment transaction to the transaction group.
      * @param params The payment transaction parameters
@@ -599,6 +609,13 @@ export default class AlgoKitComposer {
      * @returns The execution result
      */
     execute(params?: ExecuteParams): Promise<SendAtomicTransactionComposerResults>;
+    /**
+     * Compose the atomic transaction group and simulate sending it to the network
+     * @returns The simulation result
+     */
+    simulate(options?: SimulateOptions): Promise<SendAtomicTransactionComposerResults & {
+        simulateResponse: SimulateResponse;
+    }>;
     static arc2Note(note: Arc2TransactionNote): Uint8Array;
 }
 //# sourceMappingURL=composer.d.ts.map

package/types/composer.d.ts.map

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

package/types/composer.js

@@ -3,13 +3,16 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var algosdk = require('algosdk');
+var config = require('../config.js');
 var transaction = require('../transaction/transaction.js');
 var types_app = require('./app.js');
 var types_appManager = require('./app-manager.js');
 var types_networkClient = require('./network-client.js');
+var simulateAndPersistResponse = require('../debugging/simulate-and-persist-response.js');
 
 var isTransactionWithSigner = algosdk.isTransactionWithSigner;
 var encodeAddress = algosdk.encodeAddress;
+var modelsv2 = algosdk.modelsv2;
 const MAX_TRANSACTION_GROUP_SIZE = 16;
 /** AlgoKit Composer helps you compose and execute transactions as a transaction group. */
 class AlgoKitComposer {
@@ -36,6 +39,20 @@ class AlgoKitComposer {
         this.defaultValidityWindowIsExplicit = params.defaultValidityWindow !== undefined;
         this.appManager = params.appManager ?? new types_appManager.AppManager(params.algod);
     }
+    /**
+     * Add a pre-built transaction to the transaction group.
+     * @param transaction The pre-built transaction
+     * @param signer Optional signer override for the transaction
+     * @returns The composer so you can chain method calls
+     */
+    addTransaction(transaction, signer) {
+        this.txns.push({
+            txn: transaction,
+            signer: signer ?? this.getSigner(algosdk.encodeAddress(transaction.from.publicKey)),
+            type: 'txnWithSigner',
+        });
+        return this;
+    }
     /**
      * Add a payment transaction to the transaction group.
      * @param params The payment transaction parameters
@@ -237,8 +254,9 @@ class AlgoKitComposer {
             txn.addLease(transaction.encodeLease(params.lease));
         if (params.rekeyTo)
             txn.addRekey(params.rekeyTo);
+        const encoder = new TextEncoder();
         if (params.note)
-            txn.note = transaction.encodeTransactionNote(params.note);
+            txn.note = typeof params.note === 'string' ? encoder.encode(params.note) : params.note;
         if (params.firstValidRound) {
             txn.firstRound = Number(params.firstValidRound);
         }
@@ -256,16 +274,16 @@ class AlgoKitComposer {
             throw Error('Cannot set both staticFee and extraFee');
         }
         if (params.staticFee !== undefined) {
-            txn.fee = params.staticFee.microAlgo;
+            txn.fee = Number(params.staticFee.microAlgo);
         }
         else {
             txn.fee = txn.estimateSize() * suggestedParams.fee || algosdk.ALGORAND_MIN_TX_FEE;
             if (params.extraFee)
-                txn.fee += params.extraFee.microAlgo;
+                txn.fee += Number(params.extraFee.microAlgo);
         }
         txn.flatFee = true;
         if (params.maxFee !== undefined && txn.fee > params.maxFee.microAlgo) {
-            throw Error(`Transaction fee ${txn.fee} is greater than maxFee ${params.maxFee}`);
+            throw Error(`Transaction fee ${txn.fee} µALGO is greater than maxFee ${params.maxFee}`);
         }
         return txn;
     }
@@ -281,7 +299,11 @@ class AlgoKitComposer {
                 return x.length == 0 || x.every(isAbiValue);
             return typeof x === 'bigint' || typeof x === 'boolean' || typeof x === 'number' || typeof x === 'string' || x instanceof Uint8Array;
         };
-        for (const arg of params.args ?? []) {
+        for (let i = 0; i < (params.args ?? []).length; i++) {
+            const arg = params.args[i];
+            if (arg === undefined) {
+                throw Error(`No value provided for argument ${i + 1} within call to ${params.method.name}`);
+            }
             if (isAbiValue(arg)) {
                 methodArgs.push(arg);
                 continue;
@@ -445,10 +467,11 @@ class AlgoKitComposer {
         const sdkParams = {
             from: params.sender,
             suggestedParams,
+            appArgs: params.args,
             onComplete: params.onComplete ?? algosdk.OnApplicationComplete.NoOpOC,
-            appAccounts: params.accountReferences,
-            appForeignApps: params.appReferences?.map((x) => Number(x)),
-            appForeignAssets: params.assetReferences?.map((x) => Number(x)),
+            accounts: params.accountReferences,
+            foreignApps: params.appReferences?.map((x) => Number(x)),
+            foreignAssets: params.assetReferences?.map((x) => Number(x)),
             boxes: params.boxReferences?.map(types_appManager.AppManager.getBoxReference),
             approvalProgram,
             clearProgram: clearStateProgram,
@@ -460,7 +483,6 @@ class AlgoKitComposer {
             }
             txn = algosdk.makeApplicationCreateTxnFromObject({
                 ...sdkParams,
-                onComplete: sdkParams.onComplete,
                 extraPages: 'extraProgramPages' in params
                     ? params.extraProgramPages ?? Math.floor((approvalProgram.length + clearStateProgram.length) / types_app.APP_PAGE_MAX_SIZE)
                     : 0,
@@ -618,13 +640,46 @@ class AlgoKitComposer {
         }
         return await transaction.sendAtomicTransactionComposer({
             atc: this.atc,
-            sendParams: {
+            executeParams: {
                 suppressLog: params?.suppressLog,
                 maxRoundsToWaitForConfirmation: waitRounds,
                 populateAppCallResources: params?.populateAppCallResources,
             },
         }, this.algod);
     }
+    /**
+     * Compose the atomic transaction group and simulate sending it to the network
+     * @returns The simulation result
+     */
+    async simulate(options) {
+        await this.build();
+        if (config.Config.debug && config.Config.projectRoot && !config.Config.traceAll) {
+            // Dump the traces to a file for use with AlgoKit AVM debugger
+            // Checks for false on traceAll because it should have been already
+            // executed above
+            await simulateAndPersistResponse.simulateAndPersistResponse({
+                atc: this.atc,
+                projectRoot: config.Config.projectRoot,
+                algod: this.algod,
+                bufferSizeMb: config.Config.traceBufferSizeMb,
+            });
+        }
+        const { methodResults, simulateResponse } = await this.atc.simulate(this.algod, new modelsv2.SimulateRequest({ txnGroups: [], ...options }));
+        if (simulateResponse && simulateResponse.txnGroups[0].failedAt) {
+            const error = new Error(`Transaction failed at transaction(s) ${simulateResponse.txnGroups[0].failedAt.join(', ')} in the group. ${simulateResponse.txnGroups.find((x) => x.failureMessage)?.failureMessage}`);
+            error.simulateResponse = simulateResponse;
+            throw error;
+        }
+        const transactions = this.atc.buildGroup().map((t) => t.txn);
+        return {
+            confirmations: simulateResponse.txnGroups[0].txnResults.map((t) => t.txnResult),
+            transactions: transactions,
+            txIds: transactions.map((t) => t.txID()),
+            groupId: Buffer.from(transactions[0].group ?? new Uint8Array()).toString('base64'),
+            simulateResponse,
+            returns: methodResults.map((m) => m),
+        };
+    }
     static arc2Note(note) {
         const arc2Payload = `${note.dAppName}:${note.format}${typeof note.data === 'string' ? note.data : JSON.stringify(note.data)}`;
         const encoder = new TextEncoder();