@algorandfoundation/algokit-utils 6.2.1 → 7.0.0-alpha.1

package/types/asset.d.ts

@@ -2,7 +2,7 @@ import algosdk from 'algosdk';
 import { AlgoAmount } from './amount';
 import { SendTransactionFrom, SendTransactionParams, TransactionNote } from './transaction';
 import SuggestedParams = algosdk.SuggestedParams;
-/** Parameters for `createAsset` call. */
+/** @deprecated Parameters for `createAsset` call. */
 export interface CreateAssetParams extends SendTransactionParams {
     /** The account to create the asset.
      *
@@ -60,7 +60,7 @@ export interface CreateAssetParams extends SendTransactionParams {
     /** An (optional) [transaction lease](https://developer.algorand.org/articles/leased-transactions-securing-advanced-smart-contract-design/) to apply */
     lease?: string | Uint8Array;
 }
-/** Parameters for `assetOptIn` call. */
+/** @deprecated Parameters for `assetOptIn` call. */
 export interface AssetOptInParams extends SendTransactionParams {
     /** The account to opt in/out for */
     account: SendTransactionFrom;
@@ -73,14 +73,14 @@ export interface AssetOptInParams extends SendTransactionParams {
     /** An (optional) [transaction lease](https://developer.algorand.org/articles/leased-transactions-securing-advanced-smart-contract-design/) to apply */
     lease?: string | Uint8Array;
 }
-/** Parameters for `assetOptOut` call. */
+/** @deprecated Parameters for `assetOptOut` call. */
 export interface AssetOptOutParams extends AssetOptInParams {
     /** The address of the creator account for the asset; if unspecified then it looks it up using algod */
     assetCreatorAddress?: string;
     /** Whether or not to validate the account has a zero-balance before issuing the opt-out; default = true */
     ensureZeroBalance?: boolean;
 }
-/** Parameters for `assetBulkOptIn` / `assetBulkOptOut` call. */
+/** @deprecated Parameters for `assetBulkOptIn` / `assetBulkOptOut` call. */
 export interface AssetBulkOptInOutParams {
     /** The account to opt in/out for */
     account: SendTransactionFrom;
@@ -97,4 +97,3 @@ export interface AssetBulkOptInOutParams {
     /** Whether to suppress log messages from transaction send, default: do not suppress */
     suppressLog?: boolean;
 }
-//# sourceMappingURL=asset.d.ts.map

package/types/async-event-emitter.d.ts

@@ -0,0 +1,14 @@
+import { EventDataMap, EventType } from './lifecycle-events';
+export type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void;
+export declare class AsyncEventEmitter {
+    private listenerWrapperMap;
+    private listenerMap;
+    emitAsync<K extends EventType>(eventName: K, event: EventDataMap[K]): Promise<void>;
+    emitAsync(eventName: string | symbol, event: unknown): Promise<void>;
+    on<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter;
+    on<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter;
+    once<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter;
+    once<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter;
+    removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter;
+    off: (eventName: string | symbol, listener: AsyncEventListener) => AsyncEventEmitter;
+}

package/types/async-event-emitter.js

@@ -0,0 +1,50 @@
+'use strict';
+
+class AsyncEventEmitter {
+    constructor() {
+        this.listenerWrapperMap = new WeakMap();
+        this.listenerMap = {};
+        this.off = this.removeListener;
+    }
+    async emitAsync(eventName, event) {
+        for (const listener of this.listenerMap[eventName] ?? []) {
+            await listener(event, eventName);
+        }
+    }
+    on(eventName, listener) {
+        if (!this.listenerMap[eventName])
+            this.listenerMap[eventName] = [];
+        this.listenerMap[eventName].push(listener);
+        return this;
+    }
+    once(eventName, listener) {
+        const wrappedListener = async (event, eventName) => {
+            try {
+                return await listener(event, eventName);
+            }
+            finally {
+                this.removeListener(eventName, wrappedListener);
+            }
+        };
+        this.listenerWrapperMap.set(listener, wrappedListener);
+        return this.on(eventName, wrappedListener);
+    }
+    removeListener(eventName, listener) {
+        const wrappedListener = this.listenerWrapperMap.get(listener);
+        if (wrappedListener) {
+            this.listenerWrapperMap.delete(listener);
+            if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {
+                this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1);
+            }
+        }
+        else {
+            if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {
+                this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1);
+            }
+        }
+        return this;
+    }
+}
+
+exports.AsyncEventEmitter = AsyncEventEmitter;
+//# sourceMappingURL=async-event-emitter.js.map

package/types/async-event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-event-emitter.js","sources":["../../src/types/async-event-emitter.ts"],"sourcesContent":["import { EventDataMap, EventType } from './lifecycle-events'\n\nexport type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void\n\nexport class AsyncEventEmitter {\n  private listenerWrapperMap = new WeakMap<AsyncEventListener, AsyncEventListener>()\n  private listenerMap: Record<string | symbol, AsyncEventListener[]> = {}\n\n  async emitAsync<K extends EventType>(eventName: K, event: EventDataMap[K]): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void> {\n    for (const listener of this.listenerMap[eventName] ?? []) {\n      await listener(event, eventName)\n    }\n  }\n\n  on<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  on<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  on(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    if (!this.listenerMap[eventName]) this.listenerMap[eventName] = []\n    this.listenerMap[eventName].push(listener as AsyncEventListener)\n    return this\n  }\n\n  once<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  once<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  once(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener: AsyncEventListener = async (event, eventName) => {\n      try {\n        return await listener(event, eventName)\n      } finally {\n        this.removeListener(eventName, wrappedListener)\n      }\n    }\n    this.listenerWrapperMap.set(listener, wrappedListener)\n    return this.on(eventName, wrappedListener)\n  }\n\n  removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener = this.listenerWrapperMap.get(listener)\n    if (wrappedListener) {\n      this.listenerWrapperMap.delete(listener)\n      if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1)\n      }\n    } else {\n      if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1)\n      }\n    }\n\n    return this\n  }\n\n  off = this.removeListener\n}\n"],"names":[],"mappings":";;MAIa,iBAAiB,CAAA;AAA9B,IAAA,WAAA,GAAA;AACU,QAAA,IAAA,CAAA,kBAAkB,GAAG,IAAI,OAAO,EAA0C,CAAA;QAC1E,IAAW,CAAA,WAAA,GAAkD,EAAE,CAAA;AAgDvE,QAAA,IAAA,CAAA,GAAG,GAAG,IAAI,CAAC,cAAc,CAAA;KAC1B;AA7CC,IAAA,MAAM,SAAS,CAAC,SAA0B,EAAE,KAAc,EAAA;AACxD,QAAA,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE;AACxD,YAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;SACjC;KACF;IAID,EAAE,CAAC,SAA0B,EAAE,QAA4B,EAAA;AACzD,QAAA,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;AAAE,YAAA,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;QAClE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAA8B,CAAC,CAAA;AAChE,QAAA,OAAO,IAAI,CAAA;KACZ;IAID,IAAI,CAAC,SAA0B,EAAE,QAA4B,EAAA;QAC3D,MAAM,eAAe,GAAuB,OAAO,KAAK,EAAE,SAAS,KAAI;AACrE,YAAA,IAAI;AACF,gBAAA,OAAO,MAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;aACxC;oBAAS;AACR,gBAAA,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;aAChD;AACH,SAAC,CAAA;QACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;QACtD,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;KAC3C;IAED,cAAc,CAAC,SAA0B,EAAE,QAA4B,EAAA;QACrE,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC7D,IAAI,eAAe,EAAE;AACnB,YAAA,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACxC,YAAA,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE;gBAChE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;aAC5F;SACF;aAAM;AACL,YAAA,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE;gBACzD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;aACrF;SACF;AAED,QAAA,OAAO,IAAI,CAAA;KACZ;AAGF;;;;"}

package/types/async-event-emitter.mjs

@@ -0,0 +1,48 @@
+class AsyncEventEmitter {
+    constructor() {
+        this.listenerWrapperMap = new WeakMap();
+        this.listenerMap = {};
+        this.off = this.removeListener;
+    }
+    async emitAsync(eventName, event) {
+        for (const listener of this.listenerMap[eventName] ?? []) {
+            await listener(event, eventName);
+        }
+    }
+    on(eventName, listener) {
+        if (!this.listenerMap[eventName])
+            this.listenerMap[eventName] = [];
+        this.listenerMap[eventName].push(listener);
+        return this;
+    }
+    once(eventName, listener) {
+        const wrappedListener = async (event, eventName) => {
+            try {
+                return await listener(event, eventName);
+            }
+            finally {
+                this.removeListener(eventName, wrappedListener);
+            }
+        };
+        this.listenerWrapperMap.set(listener, wrappedListener);
+        return this.on(eventName, wrappedListener);
+    }
+    removeListener(eventName, listener) {
+        const wrappedListener = this.listenerWrapperMap.get(listener);
+        if (wrappedListener) {
+            this.listenerWrapperMap.delete(listener);
+            if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {
+                this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1);
+            }
+        }
+        else {
+            if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {
+                this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1);
+            }
+        }
+        return this;
+    }
+}
+
+export { AsyncEventEmitter };
+//# sourceMappingURL=async-event-emitter.mjs.map

package/types/async-event-emitter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-event-emitter.mjs","sources":["../../src/types/async-event-emitter.ts"],"sourcesContent":["import { EventDataMap, EventType } from './lifecycle-events'\n\nexport type AsyncEventListener<T = unknown> = (event: T, eventName: string | symbol) => Promise<void> | void\n\nexport class AsyncEventEmitter {\n  private listenerWrapperMap = new WeakMap<AsyncEventListener, AsyncEventListener>()\n  private listenerMap: Record<string | symbol, AsyncEventListener[]> = {}\n\n  async emitAsync<K extends EventType>(eventName: K, event: EventDataMap[K]): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void>\n  async emitAsync(eventName: string | symbol, event: unknown): Promise<void> {\n    for (const listener of this.listenerMap[eventName] ?? []) {\n      await listener(event, eventName)\n    }\n  }\n\n  on<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  on<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  on(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    if (!this.listenerMap[eventName]) this.listenerMap[eventName] = []\n    this.listenerMap[eventName].push(listener as AsyncEventListener)\n    return this\n  }\n\n  once<K extends EventType>(eventName: K, listener: AsyncEventListener<EventDataMap[K]>): AsyncEventEmitter\n  once<T = unknown>(eventName: string | symbol, listener: AsyncEventListener<T>): AsyncEventEmitter\n  once(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener: AsyncEventListener = async (event, eventName) => {\n      try {\n        return await listener(event, eventName)\n      } finally {\n        this.removeListener(eventName, wrappedListener)\n      }\n    }\n    this.listenerWrapperMap.set(listener, wrappedListener)\n    return this.on(eventName, wrappedListener)\n  }\n\n  removeListener(eventName: string | symbol, listener: AsyncEventListener): AsyncEventEmitter {\n    const wrappedListener = this.listenerWrapperMap.get(listener)\n    if (wrappedListener) {\n      this.listenerWrapperMap.delete(listener)\n      if (this.listenerMap[eventName]?.indexOf(wrappedListener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(wrappedListener), 1)\n      }\n    } else {\n      if (this.listenerMap[eventName]?.indexOf(listener) !== -1) {\n        this.listenerMap[eventName].splice(this.listenerMap[eventName].indexOf(listener), 1)\n      }\n    }\n\n    return this\n  }\n\n  off = this.removeListener\n}\n"],"names":[],"mappings":"MAIa,iBAAiB,CAAA;AAA9B,IAAA,WAAA,GAAA;AACU,QAAA,IAAA,CAAA,kBAAkB,GAAG,IAAI,OAAO,EAA0C,CAAA;QAC1E,IAAW,CAAA,WAAA,GAAkD,EAAE,CAAA;AAgDvE,QAAA,IAAA,CAAA,GAAG,GAAG,IAAI,CAAC,cAAc,CAAA;KAC1B;AA7CC,IAAA,MAAM,SAAS,CAAC,SAA0B,EAAE,KAAc,EAAA;AACxD,QAAA,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE;AACxD,YAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;SACjC;KACF;IAID,EAAE,CAAC,SAA0B,EAAE,QAA4B,EAAA;AACzD,QAAA,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;AAAE,YAAA,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;QAClE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAA8B,CAAC,CAAA;AAChE,QAAA,OAAO,IAAI,CAAA;KACZ;IAID,IAAI,CAAC,SAA0B,EAAE,QAA4B,EAAA;QAC3D,MAAM,eAAe,GAAuB,OAAO,KAAK,EAAE,SAAS,KAAI;AACrE,YAAA,IAAI;AACF,gBAAA,OAAO,MAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;aACxC;oBAAS;AACR,gBAAA,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;aAChD;AACH,SAAC,CAAA;QACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;QACtD,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;KAC3C;IAED,cAAc,CAAC,SAA0B,EAAE,QAA4B,EAAA;QACrE,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC7D,IAAI,eAAe,EAAE;AACnB,YAAA,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACxC,YAAA,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE;gBAChE,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;aAC5F;SACF;aAAM;AACL,YAAA,IAAI,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE;gBACzD,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;aACrF;SACF;AAED,QAAA,OAAO,IAAI,CAAA;KACZ;AAGF;;;;"}

package/types/client-manager.d.ts

@@ -1,12 +1,13 @@
 import algosdk from 'algosdk';
-import { AppLookup } from './app';
-import { AppDetails, AppDetailsBase, AppSpecAppDetailsBase, ApplicationClient, ResolveAppByCreatorAndNameBase, ResolveAppByIdBase } from './app-client';
+import { AlgorandClientInterface } from './algorand-client-interface';
+import { AppClient, AppClientParams, ResolveAppClientByCreatorAndName } from './app-client';
+import { AppFactory, AppFactoryParams } from './app-factory';
 import { TestNetDispenserApiClient, TestNetDispenserApiClientParams } from './dispenser-client';
-import { AlgoClientConfig, AlgoConfig } from './network-client';
+import { Expand } from './expand';
+import { AlgoClientConfig, AlgoConfig, NetworkDetails } from './network-client';
 import Kmd = algosdk.Kmd;
 import Indexer = algosdk.Indexer;
 import Algodv2 = algosdk.Algodv2;
-import IntDecoding = algosdk.IntDecoding;
 /** Clients from algosdk that interact with the official Algorand APIs */
 export interface AlgoSdkClients {
     /** Algod client, see https://developer.algorand.org/docs/rest-apis/algod/ */
@@ -16,24 +17,28 @@ export interface AlgoSdkClients {
     /** Optional KMD client, see https://developer.algorand.org/docs/rest-apis/kmd/ */
     kmd?: algosdk.Kmd;
 }
-/** Details of the current network. */
-export interface NetworkDetails {
-    /** Whether or not the network is TestNet. */
-    isTestNet: boolean;
-    /** Whether or not the network is MainNet. */
-    isMainNet: boolean;
-    /** Whether or not the network is LocalNet. */
-    isLocalNet: boolean;
-    /** The genesis ID of the current network. */
-    genesisId: string;
-    /** The base64 genesis hash of the current network. */
-    genesisHash: string;
-}
+/** Params to get an app factory from `ClientManager`. */
+export type ClientAppFactoryParams = Expand<Omit<AppFactoryParams, 'algorand'>>;
+/** Params to get an app client by creator address and name from `ClientManager`. */
+export type ClientResolveAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand'>>;
+/** Params to get an app client by ID from `ClientManager`. */
+export type ClientAppClientParams = Expand<Omit<AppClientParams, 'algorand'>>;
+/** Params to get an app client by network from `ClientManager`. */
+export type ClientAppClientByNetworkParams = Expand<Omit<AppClientParams, 'algorand' | 'appId'>>;
+/** Params to get a typed app client by creator address and name from `ClientManager`. */
+export type ClientTypedAppClientByCreatorAndNameParams = Expand<Omit<ResolveAppClientByCreatorAndName, 'algorand' | 'appSpec'>>;
+/** Params to get a typed app client by ID from `ClientManager`. */
+export type ClientTypedAppClientParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec'>>;
+/** Params to get a typed app client by network from `ClientManager`. */
+export type ClientTypedAppClientByNetworkParams = Expand<Omit<AppClientParams, 'algorand' | 'appSpec' | 'appId'>>;
+/** Params to get a typed app factory from `ClientManager`. */
+export type ClientTypedAppFactoryParams = Expand<Omit<AppFactoryParams, 'algorand' | 'appSpec'>>;
 /** Exposes access to various API clients. */
 export declare class ClientManager {
     private _algod;
     private _indexer?;
     private _kmd?;
+    private _algorand?;
     /**
      * algosdk clients or config for interacting with the official Algorand APIs.
      * @param clientsOrConfig The clients or config to use
@@ -54,11 +59,13 @@ export declare class ClientManager {
      * const clientManager = new ClientManager({ algodConfig, indexerConfig, kmdConfig })
      * ```
      */
-    constructor(clientsOrConfig: AlgoConfig | AlgoSdkClients);
+    constructor(clientsOrConfig: AlgoConfig | AlgoSdkClients, algorandClient?: AlgorandClientInterface);
     /** Returns an algosdk Algod API client. */
     get algod(): algosdk.Algodv2;
     /** Returns an algosdk Indexer API client or throws an error if it's not been provided. */
     get indexer(): algosdk.Indexer;
+    /** Returns an algosdk Indexer API client or `undefined` if it's not been provided. */
+    get indexerIfPresent(): algosdk.Indexer | undefined;
     /** Returns an algosdk KMD API client or throws an error if it's not been provided. */
     get kmd(): algosdk.Kmd;
     private _getNetworkPromise;
@@ -95,10 +102,10 @@ export declare class ClientManager {
     isMainNet(): Promise<boolean>;
     /**
      * Returns a TestNet Dispenser API client.
+     *
      * Refer to [docs](https://github.com/algorandfoundation/algokit/blob/main/docs/testnet_api.md) on guidance to obtain an access token.
      *
      * @param params An object containing parameters for the TestNetDispenserApiClient class.
-     *  Or null if you want the client to load the access token from the environment variable `ALGOKIT_DISPENSER_ACCESS_TOKEN`.
      * @example
      * const client = clientManager.getTestNetDispenser(
      *     {
@@ -109,35 +116,156 @@ export declare class ClientManager {
      *
      * @returns An instance of the TestNetDispenserApiClient class.
      */
-    getTestNetDispenser(params?: TestNetDispenserApiClientParams | null): TestNetDispenserApiClient;
+    getTestNetDispenser(params: TestNetDispenserApiClientParams): TestNetDispenserApiClient;
+    /**
+     * Returns a TestNet Dispenser API client, loading the auth token from `process.env.ALGOKIT_DISPENSER_ACCESS_TOKEN`.
+     *
+     * Refer to [docs](https://github.com/algorandfoundation/algokit/blob/main/docs/testnet_api.md) on guidance to obtain an access token.
+     *
+     * @param params An object containing parameters for the TestNetDispenserApiClient class.
+     * @example
+     * const client = clientManager.getTestNetDispenserFromEnvironment(
+     *     {
+     *       requestTimeout: 15,
+     *     }
+     * )
+     *
+     * @returns An instance of the TestNetDispenserApiClient class.
+     */
+    getTestNetDispenserFromEnvironment(params?: Omit<TestNetDispenserApiClientParams, 'authToken'>): TestNetDispenserApiClient;
     /**
-     * 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: ClientAppFactoryParams): AppFactory;
+    /**
+     * 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
+     * ```typescript
+     * 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: AppClientByCreatorAndNameDetails, cachedAppLookup?: AppLookup): ApplicationClient;
+    getAppClientByCreatorAndName(params: ClientResolveAppClientByCreatorAndNameParams): Promise<AppClient>;
     /**
-     * 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
+     * ```typescript
+     * const appClient = algorand.client.getAppClientById({
+     *   appSpec: '{/* ARC-56 or ARC-32 compatible JSON *\}',
+     *   appId: 12345n,
+     * })
+     * ```
+     * @returns The `AppClient`
+     */
+    getAppClientById(params: ClientAppClientParams): AppClient;
+    /**
+     * 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
+     * ```typescript
+     * 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`
      */
-    getAppClientById(details: AppClientByIdDetails): ApplicationClient;
+    getAppClientByNetwork(params: ClientAppClientByNetworkParams): Promise<AppClient>;
     /**
      * 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.
+     * @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",
+     *   defaultSender: alice,
+     * })
+     * ```
+     * @example Specify name
+     * ```typescript
+     * const appClient = algorand.client.getTypedAppClientByCreatorAndName(MyContractClient, {
+     *   creatorAddress: "CREATORADDRESS",
+     *   name: "contract-name",
+     *   defaultSender: alice,
+     * })
+     * ```
      * @returns The typed client instance
      */
-    getTypedAppClientByCreatorAndName<TClient>(typedClient: TypedAppClient<TClient>, details: TypedAppClientByCreatorAndNameDetails, cachedAppLookup?: AppLookup): TClient;
+    getTypedAppClientByCreatorAndName<TClient extends TypedAppClient<InstanceType<TClient>>>(typedClient: TClient, params: ClientTypedAppClientByCreatorAndNameParams): Promise<InstanceType<TClient>>;
     /**
      * 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, {
+     *   appId: 12345n,
+     *   defaultSender: alice,
+     * })
+     * ```
+     * @returns The typed client instance
+     */
+    getTypedAppClientById<TClient extends TypedAppClient<InstanceType<TClient>>>(typedClient: TClient, params: ClientTypedAppClientParams): InstanceType<TClient>;
+    /**
+     * 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
      */
-    getTypedAppClientById<TClient>(typedClient: TypedAppClient<TClient>, details: TypedAppClientByIdDetails): TClient;
+    getTypedAppClientByNetwork<TClient extends TypedAppClient<InstanceType<TClient>>>(typedClient: TClient, params?: ClientTypedAppClientByNetworkParams): Promise<InstanceType<TClient>>;
+    /**
+     * 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
+     */
+    getTypedAppFactory<TClient>(typedFactory: TypedAppFactory<TClient>, params?: ClientTypedAppFactoryParams): TClient;
     /**
      * Retrieve client configurations from environment variables when defined or get defaults (expects to be called from a Node.js environment)
      *
@@ -214,7 +342,6 @@ export declare class ClientManager {
      * Returns an indexer SDK client that automatically retries on idempotent calls
      *
      * @param config The config of the client
-     * @param overrideIntDecoding Override the default int decoding for responses, uses MIXED by default to avoid lost precision for big integers
      * @example AlgoNode (testnet)
      * ```typescript
      *  const indexer = ClientManager.getIndexerClient(ClientManager.getAlgoNodeConfig('testnet', 'indexer'))
@@ -230,16 +357,11 @@ export declare class ClientManager {
      *  const indexer = ClientManager.getIndexerClient({server: 'http://localhost', port: '8980', token: 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'})
      *  await indexer.makeHealthCheck().do()
      * ```
-     * @example Override int decoding for responses
-     * ```typescript
-     *  const indexer = ClientManager.getIndexerClient(config, IntDecoding.BIGINT)
-     * ```
      */
-    static getIndexerClient(config: AlgoClientConfig, overrideIntDecoding?: IntDecoding): Indexer;
+    static getIndexerClient(config: AlgoClientConfig): Indexer;
     /**
      * Returns an indexer SDK client that automatically retries on idempotent calls loaded from environment variables (expects to be called from a Node.js environment).
      *
-     * @param overrideIntDecoding Override the default int decoding for responses, uses MIXED by default to avoid lost precision for big integers
      * @example
      *
      *  ```typescript
@@ -248,7 +370,7 @@ export declare class ClientManager {
      *  await indexer.makeHealthCheck().do()
      *  ```
      */
-    static getIndexerClientFromEnvironment(overrideIntDecoding?: IntDecoding): Indexer;
+    static getIndexerClientFromEnvironment(): Indexer;
     /**
      * Returns a KMD SDK client.
      *
@@ -276,22 +398,13 @@ export declare class ClientManager {
  * Interface to identify a typed client that can be used to interact with an application.
  */
 export interface TypedAppClient<TClient> {
-    new (details: AppDetails, algod: algosdk.Algodv2): TClient;
+    new (params: Omit<AppClientParams, 'appSpec'>): TClient;
+    fromNetwork(params: Omit<AppClientParams, 'appId' | 'appSpec'>): Promise<TClient>;
+    fromCreatorAndName(params: Omit<ResolveAppClientByCreatorAndName, 'appSpec'>): Promise<TClient>;
 }
 /**
- * Details to resolve an app client by creator address and name.
+ * Interface to identify a typed factory that can be used to create and deploy an application.
  */
-export type AppClientByCreatorAndNameDetails = AppSpecAppDetailsBase & AppDetailsBase & Omit<ResolveAppByCreatorAndNameBase, 'findExistingUsing'>;
-/**
- * Details to resolve a typed app creator address and name.
- */
-export type TypedAppClientByCreatorAndNameDetails = AppDetailsBase & Omit<ResolveAppByCreatorAndNameBase, 'findExistingUsing'>;
-/**
- * Details to resolve an app client by app ID.
- */
-export type AppClientByIdDetails = AppSpecAppDetailsBase & AppDetailsBase & ResolveAppByIdBase;
-/**
- * Details to resolve a typed app by app ID.
- */
-export type TypedAppClientByIdDetails = AppDetailsBase & ResolveAppByIdBase;
-//# sourceMappingURL=client-manager.d.ts.map
+export interface TypedAppFactory<TClient> {
+    new (params: Omit<AppFactoryParams, 'appSpec'>): TClient;
+}