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

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;
@@ -151,48 +171,11 @@ export declare class AppFactory {
                 localByteSlices: number;
             } | undefined;
             extraProgramPages?: number | undefined;
-        }) => Promise<({
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: undefined;
-            compiledClear?: undefined;
-            deployTimeParams: TealTemplateParams | undefined;
-            schema: {
-                /** The number of integers saved in global state. */
-                globalInts: number;
-                /** The number of byte slices saved in global state. */
-                globalByteSlices: number;
-                /** The number of integers saved in local state. */
-                localInts: number;
-                /** The number of byte slices saved in local state. */
-                localByteSlices: number;
-            };
-            lease?: string | Uint8Array | undefined;
-            note?: string | Uint8Array | undefined;
-            maxFee?: import("./amount").AlgoAmount | undefined;
-            signer?: algosdk.TransactionSigner | import("./account").TransactionSignerAccount | undefined;
-            rekeyTo?: string | undefined;
-            staticFee?: import("./amount").AlgoAmount | undefined;
-            extraFee?: import("./amount").AlgoAmount | undefined;
-            validityWindow?: number | undefined;
-            firstValidRound?: bigint | undefined;
-            lastValidRound?: bigint | undefined;
-            onComplete?: algosdk.OnApplicationComplete.NoOpOC | algosdk.OnApplicationComplete.OptInOC | algosdk.OnApplicationComplete.CloseOutOC | algosdk.OnApplicationComplete.UpdateApplicationOC | algosdk.OnApplicationComplete.DeleteApplicationOC | undefined;
-            accountReferences?: string[] | undefined;
-            appReferences?: bigint[] | undefined;
-            assetReferences?: bigint[] | undefined;
-            boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
-            sender?: string | undefined;
-            method: string;
-            args?: (algosdk.ABIValue | import("./composer").AppMethodCallTransactionArgument | ABIStruct | undefined)[] | undefined;
-            updatable?: boolean | undefined;
-            deletable?: boolean | undefined;
-            extraProgramPages?: number | undefined;
-        } | {
+        }) => Promise<{
             approvalProgram: Uint8Array;
-            compiledApproval: import("./app").CompiledTeal;
             clearStateProgram: Uint8Array;
-            compiledClear: import("./app").CompiledTeal;
+            approvalProgramCompilationResult?: import("./app").CompiledTeal | undefined;
+            clearStateProgramCompilationResult?: import("./app").CompiledTeal | undefined;
             deployTimeParams: TealTemplateParams | undefined;
             schema: {
                 /** The number of integers saved in global state. */
@@ -221,14 +204,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 +238,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 +259,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 +281,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 +300,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 +331,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 +352,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 +374,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 +393,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 +424,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 +445,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: {
@@ -499,47 +482,11 @@ export declare class AppFactory {
                     localByteSlices: number;
                 } | undefined;
                 extraProgramPages?: number | undefined;
-            } | undefined) => Promise<({
-                approvalProgram: Buffer;
-                clearStateProgram: Buffer;
-                compiledApproval?: undefined;
-                compiledClear?: undefined;
-                deployTimeParams: TealTemplateParams | undefined;
-                schema: {
-                    /** The number of integers saved in global state. */
-                    globalInts: number;
-                    /** The number of byte slices saved in global state. */
-                    globalByteSlices: number;
-                    /** The number of integers saved in local state. */
-                    localInts: number;
-                    /** The number of byte slices saved in local state. */
-                    localByteSlices: number;
-                };
-                lease?: string | Uint8Array | undefined;
-                note?: string | Uint8Array | undefined;
-                maxFee?: import("./amount").AlgoAmount | undefined;
-                args?: Uint8Array[] | undefined;
-                signer?: algosdk.TransactionSigner | import("./account").TransactionSignerAccount | undefined;
-                rekeyTo?: string | undefined;
-                staticFee?: import("./amount").AlgoAmount | undefined;
-                extraFee?: import("./amount").AlgoAmount | undefined;
-                validityWindow?: number | undefined;
-                firstValidRound?: bigint | undefined;
-                lastValidRound?: bigint | undefined;
-                accountReferences?: string[] | undefined;
-                appReferences?: bigint[] | undefined;
-                assetReferences?: bigint[] | undefined;
-                boxReferences?: (import("./app-manager").BoxIdentifier | import("./app-manager").BoxReference)[] | undefined;
-                sender?: string | undefined;
-                updatable?: boolean | undefined;
-                deletable?: boolean | undefined;
-                onComplete?: algosdk.OnApplicationComplete.NoOpOC | algosdk.OnApplicationComplete.OptInOC | algosdk.OnApplicationComplete.CloseOutOC | algosdk.OnApplicationComplete.UpdateApplicationOC | algosdk.OnApplicationComplete.DeleteApplicationOC | undefined;
-                extraProgramPages?: number | undefined;
-            } | {
+            } | undefined) => Promise<{
                 approvalProgram: Uint8Array;
-                compiledApproval: import("./app").CompiledTeal;
                 clearStateProgram: Uint8Array;
-                compiledClear: import("./app").CompiledTeal;
+                approvalProgramCompilationResult?: import("./app").CompiledTeal | undefined;
+                clearStateProgramCompilationResult?: import("./app").CompiledTeal | undefined;
                 deployTimeParams: TealTemplateParams | undefined;
                 schema: {
                     /** The number of integers saved in global state. */
@@ -571,7 +518,7 @@ export declare class AppFactory {
                 deletable?: boolean | undefined;
                 onComplete?: algosdk.OnApplicationComplete.NoOpOC | algosdk.OnApplicationComplete.OptInOC | algosdk.OnApplicationComplete.CloseOutOC | algosdk.OnApplicationComplete.UpdateApplicationOC | algosdk.OnApplicationComplete.DeleteApplicationOC | undefined;
                 extraProgramPages?: number | undefined;
-            }) & {
+            } & {
                 sender: string;
                 onComplete: algosdk.OnApplicationComplete.NoOpOC | algosdk.OnApplicationComplete.OptInOC | algosdk.OnApplicationComplete.CloseOutOC | algosdk.OnApplicationComplete.UpdateApplicationOC | algosdk.OnApplicationComplete.DeleteApplicationOC;
             }>;
@@ -655,44 +602,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,12 +676,10 @@ 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;
             operationPerformed: "create";
@@ -734,33 +703,6 @@ export declare class AppFactory {
         } | {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Uint8Array;
-            compiledApproval: import("./app").CompiledTeal;
-            clearStateProgram: Uint8Array;
-            compiledClear: import("./app").CompiledTeal;
-            operationPerformed: "create";
-            version: string;
-            name: string;
-            deleted: boolean;
-            createdRound: bigint;
-            updatedRound: bigint;
-            createdMetadata: import("./app").AppDeployMetadata;
-            deletable?: boolean | undefined;
-            updatable?: boolean | 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;
-        } | {
-            return: algosdk.ABIValue | ABIStruct | undefined;
-            deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
             compiledApproval?: import("./app").CompiledTeal | undefined;
             compiledClear?: import("./app").CompiledTeal | undefined;
             operationPerformed: "update";
@@ -784,33 +726,6 @@ export declare class AppFactory {
         } | {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Uint8Array;
-            compiledApproval: import("./app").CompiledTeal;
-            clearStateProgram: Uint8Array;
-            compiledClear: import("./app").CompiledTeal;
-            operationPerformed: "update";
-            appId: bigint;
-            appAddress: string;
-            createdRound: bigint;
-            updatedRound: bigint;
-            createdMetadata: import("./app").AppDeployMetadata;
-            deleted: boolean;
-            name: string;
-            version: string;
-            deletable?: boolean | undefined;
-            updatable?: boolean | undefined;
-            groupId: string;
-            txIds: string[];
-            returns?: import("./app").ABIReturn[] | undefined;
-            confirmations: algosdk.modelsv2.PendingTransactionResponse[];
-            transactions: algosdk.Transaction[];
-            confirmation: algosdk.modelsv2.PendingTransactionResponse;
-            transaction: algosdk.Transaction;
-        } | {
-            return: algosdk.ABIValue | ABIStruct | undefined;
-            deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
             compiledApproval?: import("./app").CompiledTeal | undefined;
             compiledClear?: import("./app").CompiledTeal | undefined;
             operationPerformed: "replace";
@@ -835,54 +750,8 @@ export declare class AppFactory {
         } | {
             return: algosdk.ABIValue | ABIStruct | undefined;
             deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Uint8Array;
-            compiledApproval: import("./app").CompiledTeal;
-            clearStateProgram: Uint8Array;
-            compiledClear: import("./app").CompiledTeal;
-            operationPerformed: "replace";
-            version: string;
-            name: string;
-            deleted: boolean;
-            createdRound: bigint;
-            updatedRound: bigint;
-            createdMetadata: import("./app").AppDeployMetadata;
-            deletable?: boolean | undefined;
-            updatable?: boolean | 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;
-            deleteResult: import("./transaction").ConfirmedTransactionResult;
-        } | {
-            return: algosdk.ABIValue | ABIStruct | undefined;
-            deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Buffer;
-            clearStateProgram: Buffer;
-            compiledApproval?: undefined;
-            compiledClear?: undefined;
-            operationPerformed: "nothing";
-            appId: bigint;
-            appAddress: string;
-            createdRound: bigint;
-            updatedRound: bigint;
-            createdMetadata: import("./app").AppDeployMetadata;
-            deleted: boolean;
-            name: string;
-            version: string;
-            deletable?: boolean | undefined;
-            updatable?: boolean | undefined;
-        } | {
-            return: algosdk.ABIValue | ABIStruct | undefined;
-            deleteReturn: algosdk.ABIValue | ABIStruct | undefined;
-            approvalProgram: Uint8Array;
-            compiledApproval: import("./app").CompiledTeal;
-            clearStateProgram: Uint8Array;
-            compiledClear: import("./app").CompiledTeal;
+            compiledApproval?: import("./app").CompiledTeal | undefined;
+            compiledClear?: import("./app").CompiledTeal | undefined;
             operationPerformed: "nothing";
             appId: bigint;
             appAddress: string;
@@ -904,7 +773,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 +783,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 +815,10 @@ export declare class AppFactory {
      *
      * Will store any generated source maps for later use in debugging.
      */
-    private compile;
+    compile(compilation?: AppClientCompilationParams): Promise<import("./app-client").AppClientCompilationResult>;
     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,5 +832,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>>;
 }