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

package/types/app-factory.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import algosdk from 'algosdk';
 import { AlgorandClientInterface } from './algorand-client-interface';
 import { AppReturn, SendAppTransactionResult, TealTemplateParams } from './app';
@@ -6,8 +5,9 @@ import { ABIStruct, Arc56Contract, Arc56Method } from './app-arc56';
 import { AppClient, AppClientBareCallParams, AppClientCompilationParams, AppClientMethodCallParams, AppClientParams, AppSourceMaps, ResolveAppClientByCreatorAndName } from './app-client';
 import { AppDeployParams } from './app-deployer';
 import { AppSpec } from './app-spec';
+import { AppMethodCall, AppMethodCallTransactionArgument } from './composer';
 import { Expand } from './expand';
-import { ExecuteParams } from './transaction';
+import { SendParams } from './transaction';
 import OnApplicationComplete = algosdk.OnApplicationComplete;
 import ABIValue = algosdk.ABIValue;
 /** Parameters to create an app client */
@@ -76,8 +76,14 @@ export type CreateSchema = {
      * This is immutable once the app is created. */
     extraProgramPages?: number;
 };
-/** Parameters to define a create call for an `AppFactory` */
-export type AppFactoryCreateParams = Expand<AppClientMethodCallParams & AppClientCompilationParams & CreateOnComplete & ExecuteParams & CreateSchema> | Expand<AppClientBareCallParams & AppClientCompilationParams & CreateOnComplete & ExecuteParams & CreateSchema>;
+/** Params to specify a bare (raw) create call for an app */
+export type AppFactoryCreateParams = Expand<AppClientBareCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema>;
+/** Params to specify a create method call for an app */
+export type AppFactoryCreateMethodCallParams = Expand<AppClientMethodCallParams & AppClientCompilationParams & CreateOnComplete & CreateSchema>;
+/** Params to get an app client by ID from an app factory. */
+export type AppFactoryAppClientParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>;
+/** Params to get an app client by creator address and name from an app factory. */
+export type AppFactoryResolveAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand' | 'appSpec'>>;
 /** Parameters to define a deployment for an `AppFactory` */
 export type AppFactoryDeployParams = Expand<Omit<AppDeployParams, 'createParams' | 'updateParams' | 'deleteParams' | 'metadata'> & {
     /** Create transaction parameters to use if a create needs to be issued as part of deployment */
@@ -115,7 +121,21 @@ export declare class AppFactory {
     private _clearSourceMap;
     private _paramsMethods;
     constructor(params: AppFactoryParams);
-    /** Get parameters to define create and deploy related calls to the current app */
+    /** Get parameters to create transactions (create and deploy related calls) for the current app.
+     *
+     * A good mental model for this is that these parameters represent a deferred transaction creation.
+     * @example Create a transaction in the future using Algorand Client
+     * ```typescript
+     * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})
+     * // ...
+     * await algorand.send.AppCreateMethodCall(createAppParams)
+     * ```
+     * @example Define a nested transaction as an ABI argument
+     * ```typescript
+     * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})
+     * await appClient.send.call({method: 'my_method', args: [createAppParams]})
+     * ```
+     */
     get params(): {
         /** Return params for a create ABI call, including deploy-time TEAL template replacements and compilation if provided */
         create: (params: {
@@ -136,7 +156,7 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
             deployTimeParams?: TealTemplateParams | undefined;
             updatable?: boolean | undefined;
             deletable?: boolean | undefined;
@@ -152,10 +172,10 @@ export declare class AppFactory {
             } | undefined;
             extraProgramPages?: number | undefined;
         }) => Promise<({
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: undefined;
-            compiledClear?: undefined;
+            approvalProgram: Uint8Array;
+            compiledApproval: undefined;
+            clearStateProgram: Uint8Array;
+            compiledClear: undefined;
             deployTimeParams: TealTemplateParams | undefined;
             schema: {
                 /** The number of integers saved in global state. */
@@ -184,7 +204,7 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
             updatable?: boolean | undefined;
             deletable?: boolean | undefined;
             extraProgramPages?: number | undefined;
@@ -221,14 +241,14 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
             updatable?: boolean | undefined;
             deletable?: boolean | undefined;
             extraProgramPages?: number | undefined;
         }) & {
             sender: string;
             method: Arc56Method;
-            args: (algosdk.Transaction | algosdk.ABIValue | algosdk.TransactionWithSigner | Promise<algosdk.Transaction> | import("./composer").AppMethodCall<{
+            args: (algosdk.Transaction | algosdk.ABIValue | algosdk.TransactionWithSigner | Promise<algosdk.Transaction> | AppMethodCall<{
                 lease?: string | Uint8Array | undefined;
                 note?: string | Uint8Array | undefined;
                 maxFee?: import("./amount").AlgoAmount | undefined;
@@ -255,7 +275,7 @@ export declare class AppFactory {
                     localByteSlices: number;
                 } | undefined;
                 extraProgramPages?: number | undefined;
-            }> | import("./composer").AppMethodCall<{
+            }> | AppMethodCall<{
                 sender: string;
                 signer?: algosdk.TransactionSigner | import("./account").TransactionSignerAccount | undefined;
                 rekeyTo?: string | undefined;
@@ -276,7 +296,7 @@ export declare class AppFactory {
                 boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
                 approvalProgram: string | Uint8Array;
                 clearStateProgram: string | Uint8Array;
-            }> | import("./composer").AppMethodCall<import("./composer").AppMethodCallParams>)[] | undefined;
+            }> | AppMethodCall<import("./composer").AppMethodCallParams>)[] | undefined;
             onComplete: algosdk.OnApplicationComplete.NoOpOC | algosdk.OnApplicationComplete.OptInOC | algosdk.OnApplicationComplete.CloseOutOC | algosdk.OnApplicationComplete.UpdateApplicationOC | algosdk.OnApplicationComplete.DeleteApplicationOC;
         }>;
         /** Return params for a deployment update ABI call */
@@ -298,7 +318,7 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
         }) => {
             lease?: string | Uint8Array | undefined;
             note?: string | Uint8Array | undefined;
@@ -317,11 +337,11 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
         } & {
             sender: string;
             method: Arc56Method;
-            args: (algosdk.Transaction | algosdk.ABIValue | algosdk.TransactionWithSigner | Promise<algosdk.Transaction> | import("./composer").AppMethodCall<{
+            args: (algosdk.Transaction | algosdk.ABIValue | algosdk.TransactionWithSigner | Promise<algosdk.Transaction> | AppMethodCall<{
                 lease?: string | Uint8Array | undefined;
                 note?: string | Uint8Array | undefined;
                 maxFee?: import("./amount").AlgoAmount | undefined;
@@ -348,7 +368,7 @@ export declare class AppFactory {
                     localByteSlices: number;
                 } | undefined;
                 extraProgramPages?: number | undefined;
-            }> | import("./composer").AppMethodCall<{
+            }> | AppMethodCall<{
                 sender: string;
                 signer?: algosdk.TransactionSigner | import("./account").TransactionSignerAccount | undefined;
                 rekeyTo?: string | undefined;
@@ -369,7 +389,7 @@ export declare class AppFactory {
                 boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
                 approvalProgram: string | Uint8Array;
                 clearStateProgram: string | Uint8Array;
-            }> | import("./composer").AppMethodCall<import("./composer").AppMethodCallParams>)[] | undefined;
+            }> | AppMethodCall<import("./composer").AppMethodCallParams>)[] | undefined;
             onComplete: algosdk.OnApplicationComplete.UpdateApplicationOC;
         };
         /** Return params for a deployment delete ABI call */
@@ -391,7 +411,7 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
         }) => {
             lease?: string | Uint8Array | undefined;
             note?: string | Uint8Array | undefined;
@@ -410,11 +430,11 @@ export declare class AppFactory {
             boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
             sender?: string | undefined;
             method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
+            args?: (algosdk.ABIValue | AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
         } & {
             sender: string;
             method: Arc56Method;
-            args: (algosdk.Transaction | algosdk.ABIValue | algosdk.TransactionWithSigner | Promise<algosdk.Transaction> | import("./composer").AppMethodCall<{
+            args: (algosdk.Transaction | algosdk.ABIValue | algosdk.TransactionWithSigner | Promise<algosdk.Transaction> | AppMethodCall<{
                 lease?: string | Uint8Array | undefined;
                 note?: string | Uint8Array | undefined;
                 maxFee?: import("./amount").AlgoAmount | undefined;
@@ -441,7 +461,7 @@ export declare class AppFactory {
                     localByteSlices: number;
                 } | undefined;
                 extraProgramPages?: number | undefined;
-            }> | import("./composer").AppMethodCall<{
+            }> | AppMethodCall<{
                 sender: string;
                 signer?: algosdk.TransactionSigner | import("./account").TransactionSignerAccount | undefined;
                 rekeyTo?: string | undefined;
@@ -462,7 +482,7 @@ export declare class AppFactory {
                 boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
                 approvalProgram: string | Uint8Array;
                 clearStateProgram: string | Uint8Array;
-            }> | import("./composer").AppMethodCall<import("./composer").AppMethodCallParams>)[] | undefined;
+            }> | AppMethodCall<import("./composer").AppMethodCallParams>)[] | undefined;
             onComplete: algosdk.OnApplicationComplete.DeleteApplicationOC;
         };
         bare: {
@@ -500,10 +520,10 @@ export declare class AppFactory {
                 } | undefined;
                 extraProgramPages?: number | undefined;
             } | undefined) => Promise<({
-                approvalProgram: Buffer;
-                clearStateProgram: Buffer;
-                compiledApproval?: undefined;
-                compiledClear?: undefined;
+                approvalProgram: Uint8Array;
+                compiledApproval: undefined;
+                clearStateProgram: Uint8Array;
+                compiledClear: undefined;
                 deployTimeParams: TealTemplateParams | undefined;
                 schema: {
                     /** The number of integers saved in global state. */
@@ -655,44 +675,68 @@ export declare class AppFactory {
             };
         };
     };
-    /**
-     * Creates an instance of the app and returns the result of the creation
-     * transaction and an app client to interact with that app instance.
-     *
-     * Performs deploy-time TEAL template placeholder substitutions (if specified).
-     * @param params The parameters to create the app
-     * @returns The app client and the result of the creation transaction
-     */
-    create(params?: AppFactoryCreateParams): Promise<{
-        app: AppClient;
-        result: {
-            compiledApproval?: import("./app").CompiledTeal | undefined;
-            compiledClear?: import("./app").CompiledTeal | undefined;
-            appId: bigint;
-            groupId: string;
-            txIds: string[];
-            returns?: import("./app").ABIReturn[] | undefined;
-            confirmations: algosdk.modelsv2.PendingTransactionResponse[];
-            transactions: algosdk.Transaction[];
-            confirmation: algosdk.modelsv2.PendingTransactionResponse;
-            transaction: algosdk.Transaction;
-            appAddress: string;
-            return?: algosdk.ABIValue | ABIStruct | undefined;
-        } | {
-            compiledApproval?: import("./app").CompiledTeal | undefined;
-            compiledClear?: import("./app").CompiledTeal | undefined;
-            return: undefined;
-            groupId: string;
-            txIds: string[];
-            returns?: import("./app").ABIReturn[] | undefined;
-            confirmations: algosdk.modelsv2.PendingTransactionResponse[];
+    /** Create transactions for the current app */
+    readonly createTransaction: {
+        /** Create bare (raw) transactions for the current app */
+        bare: {
+            /** Create a create call transaction, including deploy-time TEAL template replacements and compilation if provided */
+            create: (params?: AppFactoryCreateParams) => Promise<algosdk.Transaction>;
+        };
+        /** Create a create ABI call transaction, including deploy-time TEAL template replacements and compilation if provided */
+        create: (params: AppFactoryCreateMethodCallParams) => Promise<{
             transactions: algosdk.Transaction[];
-            confirmation: algosdk.modelsv2.PendingTransactionResponse;
-            transaction: algosdk.Transaction;
-            appId: bigint;
-            appAddress: string;
+            methodCalls: Map<number, algosdk.ABIMethod>;
+            signers: Map<number, algosdk.TransactionSigner>;
+        }>;
+    };
+    /** Send transactions to the current app */
+    readonly send: {
+        /** Send bare (raw) transactions for the current app */
+        bare: {
+            create: (params?: AppFactoryCreateParams & SendParams) => Promise<{
+                appClient: AppClient;
+                result: {
+                    compiledApproval?: import("./app").CompiledTeal | undefined;
+                    compiledClear?: import("./app").CompiledTeal | undefined;
+                    return: undefined;
+                    groupId: string;
+                    txIds: string[];
+                    returns?: import("./app").ABIReturn[] | undefined;
+                    confirmations: algosdk.modelsv2.PendingTransactionResponse[];
+                    transactions: algosdk.Transaction[];
+                    confirmation: algosdk.modelsv2.PendingTransactionResponse;
+                    transaction: algosdk.Transaction;
+                    appId: bigint;
+                    appAddress: string;
+                };
+            }>;
         };
-    }>;
+        /**
+         * Creates an instance of the app and returns the result of the creation
+         * transaction and an app client to interact with that app instance.
+         *
+         * Performs deploy-time TEAL template placeholder substitutions (if specified).
+         * @param params The parameters to create the app
+         * @returns The app client and the result of the creation transaction
+         */
+        create: (params: AppFactoryCreateMethodCallParams & SendParams) => Promise<{
+            appClient: AppClient;
+            result: {
+                compiledApproval?: import("./app").CompiledTeal | undefined;
+                compiledClear?: import("./app").CompiledTeal | undefined;
+                appId: bigint;
+                groupId: string;
+                txIds: string[];
+                returns?: import("./app").ABIReturn[] | undefined;
+                confirmations: algosdk.modelsv2.PendingTransactionResponse[];
+                transactions: algosdk.Transaction[];
+                confirmation: algosdk.modelsv2.PendingTransactionResponse;
+                transaction: algosdk.Transaction;
+                appAddress: string;
+                return?: algosdk.ABIValue | ABIStruct | undefined;
+            };
+        }>;
+    };
     /**
      * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).
      *
@@ -705,14 +749,14 @@ export declare class AppFactory {
      * @returns The app client and the result of the deployment
      */
     deploy(params: AppFactoryDeployParams): Promise<{
-        app: AppClient;
+        appClient: AppClient;
         result: {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: import("./app").CompiledTeal | undefined;
-            compiledClear?: import("./app").CompiledTeal | undefined;
+            approvalProgram: Uint8Array;
+            compiledApproval: undefined;
+            clearStateProgram: Uint8Array;
+            compiledClear: undefined;
             operationPerformed: "create";
             version: string;
             name: string;
@@ -759,10 +803,10 @@ export declare class AppFactory {
         } | {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: import("./app").CompiledTeal | undefined;
-            compiledClear?: import("./app").CompiledTeal | undefined;
+            approvalProgram: Uint8Array;
+            compiledApproval: undefined;
+            clearStateProgram: Uint8Array;
+            compiledClear: undefined;
             operationPerformed: "update";
             appId: bigint;
             appAddress: string;
@@ -809,10 +853,10 @@ export declare class AppFactory {
         } | {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: import("./app").CompiledTeal | undefined;
-            compiledClear?: import("./app").CompiledTeal | undefined;
+            approvalProgram: Uint8Array;
+            compiledApproval: undefined;
+            clearStateProgram: Uint8Array;
+            compiledClear: undefined;
             operationPerformed: "replace";
             version: string;
             name: string;
@@ -861,10 +905,10 @@ export declare class AppFactory {
         } | {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: undefined;
-            compiledClear?: undefined;
+            approvalProgram: Uint8Array;
+            compiledApproval: undefined;
+            clearStateProgram: Uint8Array;
+            compiledClear: undefined;
             operationPerformed: "nothing";
             appId: bigint;
             appAddress: string;
@@ -904,7 +948,7 @@ export declare class AppFactory {
      * @param params The parameters to create the app client
      * @returns The `AppClient`
      */
-    getAppClientById(params: Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>): AppClient;
+    getAppClientById(params: AppFactoryAppClientParams): AppClient;
     /**
      * Returns a new `AppClient` client, resolving the app by creator address and name
      * using AlgoKit app deployment semantics (i.e. looking for the app creation transaction note).
@@ -914,7 +958,7 @@ export declare class AppFactory {
      * @param params The parameters to create the app client
      * @returns The `AppClient`
      */
-    getAppClientByCreatorAddressAndName(params: Expand<Omit<AppClientParams, 'algorand' | 'appSpec' | 'appId'> & ResolveAppClientByCreatorAndName>): Promise<AppClient>;
+    getAppClientByCreatorAndName(params: AppFactoryResolveAppClientByCreatorAndNameParams): Promise<AppClient>;
     /**
      * Takes an error that may include a logic error from a call to the current app and re-exposes the
      * error to include source code information via the source map and ARC-56 spec.
@@ -946,9 +990,20 @@ export declare class AppFactory {
      *
      * Will store any generated source maps for later use in debugging.
      */
-    private compile;
+    compile(compilation?: AppClientCompilationParams): Promise<{
+        approvalProgram: Uint8Array;
+        compiledApproval: undefined;
+        clearStateProgram: Uint8Array;
+        compiledClear: undefined;
+    } | {
+        approvalProgram: Uint8Array;
+        compiledApproval: import("./app").CompiledTeal;
+        clearStateProgram: Uint8Array;
+        compiledClear: import("./app").CompiledTeal;
+    }>;
     private getBareParams;
     private getABIParams;
+    private getCreateABIArgsWithDefaultValues;
     /** Returns the sender for a call, using the `defaultSender`
      * if none provided and throws an error if neither provided */
     private getSender;
@@ -962,6 +1017,5 @@ export declare class AppFactory {
      * @param method The method that was called
      * @returns The smart contract response with an updated return value
      */
-    parseMethodCallReturn<TReturn extends Uint8Array | ABIValue | ABIStruct | undefined, TResult extends SendAppTransactionResult = SendAppTransactionResult>(result: Promise<TResult> | TResult, method: Arc56Method): Promise<Expand<Omit<TResult, 'return'> & AppReturn<TReturn>>>;
+    parseMethodCallReturn<TReturn extends Uint8Array | ABIValue | ABIStruct | undefined, TResult extends SendAppTransactionResult = SendAppTransactionResult>(result: Promise<TResult> | TResult, method: Arc56Method): Promise<Omit<TResult, 'return'> & AppReturn<TReturn>>;
 }
-//# sourceMappingURL=app-factory.d.ts.map

package/types/app-factory.js

@@ -14,6 +14,69 @@ var OnApplicationComplete = algosdk.OnApplicationComplete;
  */
 class AppFactory {
     constructor(params) {
+        /** Create transactions for the current app */
+        this.createTransaction = {
+            /** Create bare (raw) transactions for the current app */
+            bare: {
+                /** Create a create call transaction, including deploy-time TEAL template replacements and compilation if provided */
+                create: async (params) => {
+                    return this._algorand.createTransaction.appCreate(await this.params.bare.create(params));
+                },
+            },
+            /** Create a create ABI call transaction, including deploy-time TEAL template replacements and compilation if provided */
+            create: async (params) => {
+                return this._algorand.createTransaction.appCreateMethodCall(await this.params.create(params));
+            },
+        };
+        /** Send transactions to the current app */
+        this.send = {
+            /** Send bare (raw) transactions for the current app */
+            bare: {
+                create: async (params) => {
+                    const updatable = params?.updatable ?? this._updatable;
+                    const deletable = params?.deletable ?? this._deletable;
+                    const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams;
+                    const compiled = await this.compile({ deployTimeParams, updatable, deletable });
+                    const result = await this.handleCallErrors(async () => ({
+                        ...(await this._algorand.send.appCreate(await this.params.bare.create({ ...params, updatable, deletable, deployTimeParams }))),
+                        return: undefined,
+                    }));
+                    return {
+                        appClient: this.getAppClientById({
+                            appId: result.appId,
+                        }),
+                        result: {
+                            ...result,
+                            ...compiled,
+                        },
+                    };
+                },
+            },
+            /**
+             * Creates an instance of the app and returns the result of the creation
+             * transaction and an app client to interact with that app instance.
+             *
+             * Performs deploy-time TEAL template placeholder substitutions (if specified).
+             * @param params The parameters to create the app
+             * @returns The app client and the result of the creation transaction
+             */
+            create: async (params) => {
+                const updatable = params?.updatable ?? this._updatable;
+                const deletable = params?.deletable ?? this._deletable;
+                const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams;
+                const compiled = await this.compile({ deployTimeParams, updatable, deletable });
+                const result = await this.handleCallErrors(async () => this.parseMethodCallReturn(this._algorand.send.appCreateMethodCall(await this.params.create({ ...params, updatable, deletable, deployTimeParams })), types_appArc56.getArc56Method(params.method, this._appSpec)));
+                return {
+                    appClient: this.getAppClientById({
+                        appId: result.appId,
+                    }),
+                    result: {
+                        ...result,
+                        ...compiled,
+                    },
+                };
+            },
+        };
         this._appSpec = types_appClient.AppClient.normaliseAppSpec(params.appSpec);
         this._appName = params.appName ?? this._appSpec.name;
         this._algorand = params.algorand;
@@ -24,38 +87,23 @@ class AppFactory {
         this._deletable = params.deletable;
         this._paramsMethods = this.getParamsMethods();
     }
-    /** Get parameters to define create and deploy related calls to the current app */
-    get params() {
-        return this._paramsMethods;
-    }
-    /**
-     * Creates an instance of the app and returns the result of the creation
-     * transaction and an app client to interact with that app instance.
+    /** Get parameters to create transactions (create and deploy related calls) for the current app.
      *
-     * Performs deploy-time TEAL template placeholder substitutions (if specified).
-     * @param params The parameters to create the app
-     * @returns The app client and the result of the creation transaction
+     * A good mental model for this is that these parameters represent a deferred transaction creation.
+     * @example Create a transaction in the future using Algorand Client
+     * ```typescript
+     * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})
+     * // ...
+     * await algorand.send.AppCreateMethodCall(createAppParams)
+     * ```
+     * @example Define a nested transaction as an ABI argument
+     * ```typescript
+     * const createAppParams = appFactory.params.create({method: 'create_method', args: [123, 'hello']})
+     * await appClient.send.call({method: 'my_method', args: [createAppParams]})
+     * ```
      */
-    async create(params) {
-        const updatable = params?.updatable ?? this._updatable;
-        const deletable = params?.deletable ?? this._deletable;
-        const deployTimeParams = params?.deployTimeParams ?? this._deployTimeParams;
-        const compiled = await this.compile({ deployTimeParams, updatable, deletable });
-        const result = await this.handleCallErrors(async () => params && 'method' in params
-            ? this.parseMethodCallReturn(this._algorand.send.appCreateMethodCall(await this.params.create({ ...params, updatable, deletable, deployTimeParams })), types_appArc56.getArc56Method(params.method, this._appSpec))
-            : {
-                ...(await this._algorand.send.appCreate(await this.params.bare.create({ ...params, updatable, deletable, deployTimeParams }))),
-                return: undefined,
-            });
-        return {
-            app: this.getAppClientById({
-                appId: result.appId,
-            }),
-            result: {
-                ...result,
-                ...compiled,
-            },
-        };
+    get params() {
+        return this._paramsMethods;
     }
     /**
      * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).
@@ -91,7 +139,7 @@ class AppFactory {
                 deletable,
             },
         });
-        const app = this.getAppClientById({
+        const appClient = this.getAppClientById({
             appId: deployResult.appId,
         });
         const result = {
@@ -99,7 +147,7 @@ class AppFactory {
             ...compiled,
         };
         return {
-            app,
+            appClient,
             result: {
                 ...result,
                 return: 'return' in result
@@ -145,7 +193,7 @@ class AppFactory {
      * @param params The parameters to create the app client
      * @returns The `AppClient`
      */
-    getAppClientByCreatorAddressAndName(params) {
+    getAppClientByCreatorAndName(params) {
         return types_appClient.AppClient.fromCreatorAndName({
             ...params,
             algorand: this._algorand,
@@ -290,10 +338,34 @@ class AppFactory {
             ...params,
             sender: this.getSender(params.sender),
             method: types_appArc56.getArc56Method(params.method, this._appSpec),
-            args: types_appClient.AppClient.getABIArgsWithDefaultValues(params.method, params.args, this._appSpec),
+            args: this.getCreateABIArgsWithDefaultValues(params.method, params.args),
             onComplete,
         };
     }
+    getCreateABIArgsWithDefaultValues(methodNameOrSignature, args) {
+        const m = types_appArc56.getArc56Method(methodNameOrSignature, this._appSpec);
+        return args?.map((a, i) => {
+            const arg = m.args[i];
+            if (a !== undefined) {
+                // If a struct then convert to tuple for the underlying call
+                return arg.struct && typeof a === 'object' && !Array.isArray(a)
+                    ? types_appArc56.getABITupleFromABIStruct(a, this._appSpec.structs[arg.struct], this._appSpec.structs)
+                    : a;
+            }
+            const defaultValue = arg.defaultValue;
+            if (defaultValue) {
+                switch (defaultValue.source) {
+                    case 'literal':
+                        if (typeof defaultValue.data === 'number')
+                            return defaultValue.data;
+                        return types_appArc56.getABIDecodedValue(Buffer.from(defaultValue.data, 'base64'), m.method.args[i].type, this._appSpec.structs);
+                    default:
+                        throw new Error(`Can't provide default value for ${defaultValue.source} for a contract creation call`);
+                }
+            }
+            throw new Error(`No value provided for required argument ${arg.name ?? `arg${i + 1}`} in call to method ${m.name}`);
+        });
+    }
     /** Returns the sender for a call, using the `defaultSender`
      * if none provided and throws an error if neither provided */
     getSender(sender) {