@algorandfoundation/algokit-utils 10.0.0-alpha.9 → 10.0.0-beta.2

package/app-deployer.js

@@ -0,0 +1,353 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_address = require("./packages/common/src/address.js");
+const require_transaction_type = require("./packages/transact/src/transactions/transaction-type.js");
+const require_config = require("./config.js");
+const require_app = require("./app.js");
+const require_util = require("./util.js");
+const require_composer = require("./composer.js");
+const require_indexer_lookup = require("./indexer-client/indexer-lookup.js");
+//#region src/app-deployer.ts
+/** Allows management of deployment and deployment metadata of applications. */
+var AppDeployer = class {
+	_appManager;
+	_transactionSender;
+	_indexer;
+	_appLookups = /* @__PURE__ */ new Map();
+	/**
+	* Creates an `AppManager`
+	* @param appManager An `AppManager` instance
+	* @param transactionSender An `AlgorandClientTransactionSender` instance
+	* @param indexer An optional indexer instance; supply if you want to indexer to look up app metadata
+	* @example
+	* ```ts
+	* const deployer = new AppDeployer(appManager, transactionSender, indexer)
+	* ```
+	*/
+	constructor(appManager, transactionSender, indexer) {
+		this._appManager = appManager;
+		this._transactionSender = transactionSender;
+		this._indexer = indexer;
+	}
+	/**
+	* 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).
+	*
+	* To understand the architecture decisions behind this functionality please see https://github.com/algorandfoundation/algokit-cli/blob/main/docs/architecture-decisions/2023-01-12_smart-contract-deployment.md
+	*
+	* **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.
+	*
+	* **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.
+	*
+	* **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.
+	* @param deployment The arguments to control the app deployment
+	* @returns The result of the deployment
+	* @example
+	* ```ts
+	* const deployResult = await deployer.deploy({
+	*   createParams: {
+	*     sender: 'SENDER_ADDRESS',
+	*     approvalProgram: 'APPROVAL PROGRAM',
+	*     clearStateProgram: 'CLEAR PROGRAM',
+	*     schema: {
+	*       globalByteSlices: 0,
+	*       globalInts: 0,
+	*       localByteSlices: 0,
+	*       localInts: 0
+	*     }
+	*   },
+	*   updateParams: {
+	*     sender: 'SENDER_ADDRESS'
+	*   },
+	*   deleteParams: {
+	*     sender: 'SENDER_ADDRESS'
+	*   },
+	*   metadata: { name: 'my_app', version: '2.0', updatable: false, deletable: false },
+	*   onSchemaBreak: 'append',
+	*   onUpdate: 'append'
+	*  })
+	* ```
+	*/
+	async deploy(deployment) {
+		const { metadata, deployTimeParams, onSchemaBreak, onUpdate, createParams, updateParams, deleteParams, existingDeployments, ignoreCache, ...sendParams } = deployment;
+		createParams.note = updateParams.note = require_composer.TransactionComposer.arc2Note({
+			dAppName: require_app.APP_DEPLOY_NOTE_DAPP,
+			data: metadata,
+			format: "j"
+		});
+		if (existingDeployments && existingDeployments.creator.toString() !== createParams.sender.toString()) throw new Error(`Received invalid existingDeployments value for creator ${existingDeployments.creator} when attempting to deploy for creator ${require_address.getAddress(createParams.sender)}`);
+		if (!existingDeployments && !this._indexer) throw new Error(`Didn't receive an indexer client when this AppManager was created, but also didn't receive an existingDeployments cache - one of them must be provided`);
+		require_config.Config.getLogger(sendParams?.suppressLog).info(`Idempotently deploying app "${metadata.name}" from creator ${require_address.getAddress(createParams.sender)} using ${createParams.approvalProgram.length} bytes of ${typeof createParams.approvalProgram === "string" ? "teal code" : "AVM bytecode"} and ${createParams.clearStateProgram.length} bytes of ${typeof createParams.approvalProgram === "string" ? "teal code" : "AVM bytecode"}`);
+		const compiledApproval = typeof createParams.approvalProgram === "string" ? await this._appManager.compileTealTemplate(createParams.approvalProgram, deployTimeParams, metadata) : void 0;
+		const approvalProgram = compiledApproval ? compiledApproval.compiledBase64ToBytes : createParams.approvalProgram;
+		const compiledClear = typeof createParams.clearStateProgram === "string" ? await this._appManager.compileTealTemplate(createParams.clearStateProgram, deployTimeParams) : void 0;
+		const clearStateProgram = compiledClear ? compiledClear.compiledBase64ToBytes : createParams.clearStateProgram;
+		const createApp = async () => {
+			const result = await ("method" in createParams ? this._transactionSender.appCreateMethodCall({
+				...createParams,
+				approvalProgram,
+				clearStateProgram,
+				...sendParams
+			}) : this._transactionSender.appCreate({
+				...createParams,
+				approvalProgram,
+				clearStateProgram,
+				...sendParams
+			}));
+			const appMetadata = {
+				appId: result.appId,
+				appAddress: result.appAddress,
+				...metadata,
+				createdMetadata: metadata,
+				createdRound: BigInt(result.confirmation.confirmedRound),
+				updatedRound: BigInt(result.confirmation.confirmedRound),
+				deleted: false
+			};
+			this.updateAppLookup(createParams.sender, appMetadata);
+			return {
+				operationPerformed: "create",
+				compiledApproval,
+				compiledClear,
+				...result,
+				...appMetadata
+			};
+		};
+		const updateApp = async (existingApp) => {
+			require_config.Config.getLogger(sendParams?.suppressLog).info(`Updating existing ${metadata.name} app for ${require_address.getAddress(createParams.sender)} to version ${metadata.version}.`);
+			const result = await ("method" in updateParams ? this._transactionSender.appUpdateMethodCall({
+				appId: existingApp.appId,
+				approvalProgram,
+				clearStateProgram,
+				...updateParams,
+				...sendParams
+			}) : this._transactionSender.appUpdate({
+				appId: existingApp.appId,
+				approvalProgram,
+				clearStateProgram,
+				...updateParams,
+				...sendParams
+			}));
+			const appMetadata = {
+				appId: existingApp.appId,
+				appAddress: existingApp.appAddress,
+				createdMetadata: existingApp.createdMetadata,
+				createdRound: existingApp.createdRound,
+				updatedRound: BigInt(result.confirmation.confirmedRound),
+				...metadata,
+				deleted: false
+			};
+			this.updateAppLookup(createParams.sender, appMetadata);
+			return {
+				operationPerformed: "update",
+				compiledApproval,
+				compiledClear,
+				...result,
+				...appMetadata
+			};
+		};
+		const replaceApp = async (existingApp) => {
+			require_config.Config.getLogger(sendParams?.suppressLog).info(`Deploying a new ${metadata.name} app for ${require_address.getAddress(createParams.sender)}; deploying app with version ${metadata.version}.`);
+			require_config.Config.getLogger(sendParams?.suppressLog).warn(`Deleting existing ${metadata.name} app with id ${existingApp.appId} from ${require_address.getAddress(deleteParams.sender)} account.`);
+			const composer = this._transactionSender.newGroup();
+			if ("method" in createParams) composer.addAppCreateMethodCall({
+				...createParams,
+				approvalProgram,
+				clearStateProgram
+			});
+			else composer.addAppCreate({
+				...createParams,
+				approvalProgram,
+				clearStateProgram
+			});
+			const createIndex = await composer.count();
+			if ("method" in deleteParams) composer.addAppDeleteMethodCall({
+				appId: existingApp.appId,
+				...deleteParams
+			});
+			else composer.addAppDelete({
+				appId: existingApp.appId,
+				...deleteParams
+			});
+			const result = await composer.send({ ...sendParams });
+			const confirmation = result.confirmations.at(createIndex - 1);
+			const transaction = result.transactions.at(createIndex - 1);
+			const deleteTransaction = result.transactions.at(-1);
+			require_config.Config.getLogger(sendParams?.suppressLog).warn(`Sent transactions ${transaction.txId()} to create app with id ${confirmation.appId} and ${deleteTransaction.txId()} to delete app with id ${existingApp.appId} from ${require_address.getAddress(createParams.sender)} account.`);
+			const appMetadata = {
+				appId: confirmation.appId,
+				appAddress: require_address.getApplicationAddress(confirmation.appId),
+				...metadata,
+				createdMetadata: metadata,
+				createdRound: BigInt(confirmation.confirmedRound),
+				updatedRound: BigInt(confirmation.confirmedRound),
+				deleted: false
+			};
+			this.updateAppLookup(createParams.sender, appMetadata);
+			return {
+				operationPerformed: "replace",
+				...result,
+				compiledApproval,
+				compiledClear,
+				transaction,
+				confirmation,
+				return: "method" in createParams ? result.returns?.[0] : void 0,
+				deleteReturn: "method" in deleteParams ? result.returns?.at(-1) : void 0,
+				...appMetadata,
+				deleteResult: {
+					transaction: deleteTransaction,
+					confirmation: result.confirmations.at(-1)
+				}
+			};
+		};
+		const existingApp = (existingDeployments ?? await this.getCreatorAppsByName(createParams.sender, ignoreCache)).apps[metadata.name];
+		if (!existingApp || existingApp.deleted) {
+			require_config.Config.getLogger(sendParams?.suppressLog).info(`App ${metadata.name} not found in apps created by ${require_address.getAddress(createParams.sender)}; deploying app with version ${metadata.version}.`);
+			return await createApp();
+		}
+		require_config.Config.getLogger(sendParams?.suppressLog).info(`Existing app ${metadata.name} found by creator ${require_address.getAddress(createParams.sender)}, with app id ${existingApp.appId} and version ${existingApp.version}.`);
+		const existingAppRecord = await this._appManager.getById(existingApp.appId);
+		const existingApproval = Buffer.from(existingAppRecord.approvalProgram).toString("base64");
+		const existingClear = Buffer.from(existingAppRecord.clearStateProgram).toString("base64");
+		const extraPages = existingAppRecord.extraProgramPages ?? 0;
+		const newApprovalBytes = Buffer.from(approvalProgram);
+		const newClearBytes = Buffer.from(clearStateProgram);
+		const newApproval = newApprovalBytes.toString("base64");
+		const newClear = newClearBytes.toString("base64");
+		const newExtraPages = require_util.calculateExtraProgramPages(newApprovalBytes, newClearBytes);
+		const isUpdate = newApproval !== existingApproval || newClear !== existingClear;
+		if (existingAppRecord.localInts < (createParams.schema?.localInts ?? 0) || existingAppRecord.globalInts < (createParams.schema?.globalInts ?? 0) || existingAppRecord.localByteSlices < (createParams.schema?.localByteSlices ?? 0) || existingAppRecord.globalByteSlices < (createParams.schema?.globalByteSlices ?? 0) || extraPages < newExtraPages) {
+			require_config.Config.getLogger(sendParams?.suppressLog).warn(`Detected a breaking app schema change in app ${existingApp.appId}:`, {
+				from: {
+					globalInts: existingAppRecord.globalInts,
+					globalByteSlices: existingAppRecord.globalByteSlices,
+					localInts: existingAppRecord.localInts,
+					localByteSlices: existingAppRecord.localByteSlices,
+					extraProgramPages: extraPages
+				},
+				to: {
+					...createParams.schema,
+					extraProgramPages: newExtraPages
+				}
+			});
+			if (onSchemaBreak === void 0 || onSchemaBreak === "fail" || onSchemaBreak === require_app.OnSchemaBreak.Fail) throw new Error("Schema break detected and onSchemaBreak=OnSchemaBreak.Fail, stopping deployment. If you want to try deleting and recreating the app then re-run with onSchemaBreak=OnSchemaBreak.ReplaceApp");
+			if (onSchemaBreak === "append" || onSchemaBreak === require_app.OnSchemaBreak.AppendApp) {
+				require_config.Config.getLogger(sendParams?.suppressLog).info("onSchemaBreak=AppendApp, will attempt to create a new app");
+				return await createApp();
+			}
+			if (existingApp.deletable) require_config.Config.getLogger(sendParams?.suppressLog).info("App is deletable and onSchemaBreak=ReplaceApp, will attempt to create new app and delete old app");
+			else require_config.Config.getLogger(sendParams?.suppressLog).info("App is not deletable but onSchemaBreak=ReplaceApp, will attempt to delete app, delete will most likely fail");
+			return await replaceApp(existingApp);
+		}
+		if (isUpdate) {
+			require_config.Config.getLogger(sendParams?.suppressLog).info(`Detected a TEAL update in app ${existingApp.appId} for creator ${require_address.getAddress(createParams.sender)}`);
+			if (onUpdate === void 0 || onUpdate === "fail" || onUpdate === require_app.OnUpdate.Fail) throw new Error("Update detected and onUpdate=Fail, stopping deployment. Try a different onUpdate value to not fail.");
+			if (onUpdate === "append" || onUpdate === require_app.OnUpdate.AppendApp) {
+				require_config.Config.getLogger(sendParams?.suppressLog).info("onUpdate=AppendApp, will attempt to create a new app");
+				return await createApp();
+			}
+			if (onUpdate === "update" || onUpdate === require_app.OnUpdate.UpdateApp) {
+				if (existingApp.updatable) require_config.Config.getLogger(sendParams?.suppressLog).info(`App is updatable and onUpdate=UpdateApp, updating app...`);
+				else require_config.Config.getLogger(sendParams?.suppressLog).warn(`App is not updatable but onUpdate=UpdateApp, will attempt to update app, update will most likely fail`);
+				return await updateApp(existingApp);
+			}
+			if (onUpdate === "replace" || onUpdate === require_app.OnUpdate.ReplaceApp) {
+				if (existingApp.deletable) require_config.Config.getLogger(sendParams?.suppressLog).warn("App is deletable and onUpdate=ReplaceApp, creating new app and deleting old app...");
+				else require_config.Config.getLogger(sendParams?.suppressLog).warn("App is not deletable and onUpdate=ReplaceApp, will attempt to create new app and delete old app, delete will most likely fail");
+				return await replaceApp(existingApp);
+			}
+		}
+		require_config.Config.getLogger(sendParams?.suppressLog).debug("No detected changes in app, nothing to do.");
+		return {
+			...existingApp,
+			operationPerformed: "nothing"
+		};
+	}
+	updateAppLookup(sender, appMetadata) {
+		const s = require_address.getAddress(sender).toString();
+		const lookup = this._appLookups.get(s);
+		if (!lookup) this._appLookups.set(s, {
+			creator: require_address.Address.fromString(s),
+			apps: { [appMetadata.name]: appMetadata }
+		});
+		else lookup.apps[appMetadata.name] = appMetadata;
+	}
+	/**
+	* Returns a lookup of name => app metadata (id, address, ...metadata) for all apps created by the given account that have
+	* an [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) `AppDeployNote` as the transaction
+	* note of the app creation transaction.
+	*
+	* This function caches the result for the given creator account so that subsequent calls will not require an indexer lookup.
+	*
+	* If the `AppManager` instance wasn't created with an indexer client, this function will throw an error.
+	*
+	* @param creator The address of the account that is the creator of the apps you want to search for
+	* @param ignoreCache Whether or not to ignore the cache and force a lookup, default: use the cache
+	* @returns A name-based lookup of the app metadata
+	* @example
+	* ```ts
+	* const result = await deployer.getCreatorAppsByName(creator)
+	*/
+	async getCreatorAppsByName(creator, ignoreCache) {
+		const appLookup = {};
+		const creatorAddress = require_address.getAddress(creator);
+		const creatorString = creatorAddress.toString();
+		if (!ignoreCache && this._appLookups.has(creatorString)) return this._appLookups.get(creatorString);
+		if (!this._indexer) throw new Error(`Didn't receive an indexer client when this AppManager was created, but received a call to getCreatorApps`);
+		const createdApps = (await require_indexer_lookup.lookupAccountCreatedApplicationByAddress(this._indexer, creatorString)).map((a) => {
+			return {
+				id: a.id,
+				createdAtRound: a.createdAtRound,
+				deleted: a.deleted
+			};
+		}).sort((a, b) => Number(a.createdAtRound - b.createdAtRound));
+		(await Promise.all(createdApps.map(async (createdApp) => {
+			const appTransactions = await require_indexer_lookup.searchTransactions(this._indexer, {
+				minRound: createdApp.createdAtRound,
+				txType: require_transaction_type.TransactionType.AppCall,
+				applicationId: createdApp.id,
+				address: creatorAddress,
+				addressRole: "sender",
+				notePrefix: Buffer.from(require_app.APP_DEPLOY_NOTE_DAPP).toString("base64")
+			});
+			const appCreationTransaction = appTransactions.transactions.filter((t) => t.applicationTransaction?.applicationId === 0n && t.sender.toString() === creatorAddress.toString())[0];
+			const latestAppUpdateTransaction = appTransactions.transactions.filter((t) => t.sender.toString() === creatorAddress.toString()).sort((a, b) => a.confirmedRound === b.confirmedRound ? (b.intraRoundOffset - a.intraRoundOffset) / 10 : Number(b.confirmedRound - a.confirmedRound))[0];
+			if (!appCreationTransaction?.note) return null;
+			return {
+				createdApp,
+				appCreationTransaction,
+				latestAppUpdateTransaction
+			};
+		}))).filter((a) => a !== null).forEach((a) => {
+			const { createdApp, appCreationTransaction, latestAppUpdateTransaction } = a;
+			const parseNote = (note) => {
+				if (!note) return;
+				if (!note.startsWith(`ALGOKIT_DEPLOYER:j{`)) return;
+				return JSON.parse(note.substring(require_app.APP_DEPLOY_NOTE_DAPP.length + 2));
+			};
+			try {
+				const creationNote = parseNote(appCreationTransaction.note ? Buffer.from(appCreationTransaction.note).toString("utf-8") : void 0);
+				const updateNote = parseNote(latestAppUpdateTransaction.note ? Buffer.from(latestAppUpdateTransaction.note).toString("utf-8") : void 0);
+				if (creationNote?.name) appLookup[creationNote.name] = {
+					appId: createdApp.id,
+					appAddress: require_address.getApplicationAddress(createdApp.id),
+					createdMetadata: creationNote,
+					createdRound: appCreationTransaction.confirmedRound ?? 0n,
+					...updateNote ?? creationNote,
+					updatedRound: latestAppUpdateTransaction?.confirmedRound ?? 0n,
+					deleted: createdApp.deleted ?? false
+				};
+			} catch (e) {
+				require_config.Config.logger.warn(`Received error trying to retrieve app with ${createdApp.id} for creator ${creatorAddress}; failing silently`, e);
+				return;
+			}
+		});
+		const lookup = {
+			creator: creatorAddress,
+			apps: appLookup
+		};
+		this._appLookups.set(creatorString, lookup);
+		return lookup;
+	}
+};
+//#endregion
+exports.AppDeployer = AppDeployer;
+
+//# sourceMappingURL=app-deployer.js.map

package/app-deployer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-deployer.js","names":["TransactionComposer","APP_DEPLOY_NOTE_DAPP","getAddress","getApplicationAddress","calculateExtraProgramPages","OnSchemaBreak","OnUpdate","Address","lookupAccountCreatedApplicationByAddress","searchTransactions","TransactionType"],"sources":["../src/app-deployer.ts"],"sourcesContent":["import { ABIReturn } from '@algorandfoundation/algokit-abi'\nimport { Address, Expand, getAddress, getApplicationAddress, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { IndexerClient } from '@algorandfoundation/algokit-indexer-client'\nimport { TransactionType } from '@algorandfoundation/algokit-transact'\nimport { AlgorandClientTransactionSender } from './algorand-client-transaction-sender'\nimport {\n  APP_DEPLOY_NOTE_DAPP,\n  OnSchemaBreak,\n  OnUpdate,\n  type AppDeployMetadata,\n  type SendAppCreateTransactionResult,\n  type SendAppUpdateTransactionResult,\n  type TealTemplateParams,\n} from './app'\nimport { AppManager } from './app-manager'\nimport {\n  AppCreateMethodCall,\n  AppCreateParams,\n  AppDeleteMethodCall,\n  AppDeleteParams,\n  AppUpdateMethodCall,\n  AppUpdateParams,\n  TransactionComposer,\n} from './composer'\nimport { Config } from './config'\nimport { lookupAccountCreatedApplicationByAddress, searchTransactions } from './indexer-client'\nimport { ConfirmedTransactionResult, SendParams } from './transaction/types'\nimport { calculateExtraProgramPages } from './util'\n\n/** Params to specify an update transaction for an app deployment */\nexport type DeployAppUpdateParams = Expand<Omit<AppUpdateParams, 'appId' | 'approvalProgram' | 'clearStateProgram'>>\n/** Params to specify an update method call for an app deployment */\nexport type DeployAppUpdateMethodCall = Expand<Omit<AppUpdateMethodCall, 'appId' | 'approvalProgram' | 'clearStateProgram'>>\n/** Params to specify a transaction for an app deployment */\nexport type DeployAppDeleteParams = Expand<Omit<AppDeleteParams, 'appId'>>\n/** Params to specify a delete method call for an app deployment */\nexport type DeployAppDeleteMethodCall = Expand<Omit<AppDeleteMethodCall, 'appId'>>\n\n/** The parameters to idempotently deploy an app */\nexport type AppDeployParams = Expand<\n  SendParams & {\n    /** The deployment metadata */\n    metadata: AppDeployMetadata\n    /** Any deploy-time parameters to replace in the TEAL code before compiling it (used if teal code is passed in as a string) */\n    deployTimeParams?: TealTemplateParams\n    /** What action to perform if a schema break (storage schema or extra pages change) is detected:\n     *\n     * * `fail` - Fail the deployment (throw an error, **default**)\n     * * `replace` - Delete the old app and create a new one\n     * * `append` - Deploy a new app and leave the old one as is\n     */\n    onSchemaBreak?: 'replace' | 'fail' | 'append' | OnSchemaBreak\n    /** What action to perform if a TEAL code update is detected:\n     *\n     * * `fail` - Fail the deployment (throw an error, **default**)\n     * * `update` - Update the app with the new TEAL code\n     * * `replace` - Delete the old app and create a new one\n     * * `append` - Deploy a new app and leave the old one as is\n     */\n    onUpdate?: 'update' | 'replace' | 'fail' | 'append' | OnUpdate\n    /** Create transaction parameters to use if a create needs to be issued as part of deployment */\n    createParams: AppCreateParams | AppCreateMethodCall\n    /** Update transaction parameters to use if an update needs to be issued as part of deployment */\n    updateParams: DeployAppUpdateParams | DeployAppUpdateMethodCall\n    /** Delete transaction parameters to use if a delete needs to be issued as part of deployment */\n    deleteParams: DeployAppDeleteParams | DeployAppDeleteMethodCall\n    /** Optional cached value of the existing apps for the given creator; use this to avoid an indexer lookup */\n    existingDeployments?: AppLookup\n    /** Whether or not to ignore the app metadata cache and force a lookup, default: use the cache **/\n    ignoreCache?: boolean\n  }\n>\n\n/** The metadata that can be collected about a deployed app */\nexport interface AppMetadata extends AppDeployMetadata {\n  /** The id of the app */\n  appId: bigint\n  /** The Algorand address of the account associated with the app */\n  appAddress: Address\n  /** The round the app was created */\n  createdRound: bigint\n  /** The last round that the app was updated */\n  updatedRound: bigint\n  /** The metadata when the app was created */\n  createdMetadata: AppDeployMetadata\n  /** Whether or not the app is deleted */\n  deleted: boolean\n}\n\n/** A lookup of name -> Algorand app for a creator */\nexport interface AppLookup {\n  /** The address of the creator associated with this lookup */\n  creator: Readonly<Address>\n  /** A hash map of app name to app metadata */\n  apps: {\n    [name: string]: AppMetadata\n  }\n}\n\nexport type AppDeployResult =\n  | Expand<{ operationPerformed: 'create' } & Omit<AppMetadata, 'appId' | 'appAddress'> & SendAppCreateTransactionResult>\n  | Expand<{ operationPerformed: 'update' } & AppMetadata & SendAppUpdateTransactionResult>\n  | Expand<\n      { operationPerformed: 'replace' } & Omit<AppMetadata, 'appId' | 'appAddress'> &\n        SendAppCreateTransactionResult & {\n          deleteReturn?: ABIReturn\n          deleteResult: ConfirmedTransactionResult\n        }\n    >\n  | Expand<{ operationPerformed: 'nothing' } & AppMetadata>\n\n/** Allows management of deployment and deployment metadata of applications. */\nexport class AppDeployer {\n  private _appManager: AppManager\n  private _transactionSender: AlgorandClientTransactionSender\n  private _indexer?: IndexerClient\n  private _appLookups = new Map<string, AppLookup>()\n\n  /**\n   * Creates an `AppManager`\n   * @param appManager An `AppManager` instance\n   * @param transactionSender An `AlgorandClientTransactionSender` instance\n   * @param indexer An optional indexer instance; supply if you want to indexer to look up app metadata\n   * @example\n   * ```ts\n   * const deployer = new AppDeployer(appManager, transactionSender, indexer)\n   * ```\n   */\n  constructor(appManager: AppManager, transactionSender: AlgorandClientTransactionSender, indexer?: IndexerClient) {\n    this._appManager = appManager\n    this._transactionSender = transactionSender\n    this._indexer = indexer\n  }\n\n  /**\n   * 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).\n   *\n   * To understand the architecture decisions behind this functionality please see https://github.com/algorandfoundation/algokit-cli/blob/main/docs/architecture-decisions/2023-01-12_smart-contract-deployment.md\n   *\n   * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.\n   *\n   * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.\n   *\n   * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.\n   * @param deployment The arguments to control the app deployment\n   * @returns The result of the deployment\n   * @example\n   * ```ts\n   * const deployResult = await deployer.deploy({\n   *   createParams: {\n   *     sender: 'SENDER_ADDRESS',\n   *     approvalProgram: 'APPROVAL PROGRAM',\n   *     clearStateProgram: 'CLEAR PROGRAM',\n   *     schema: {\n   *       globalByteSlices: 0,\n   *       globalInts: 0,\n   *       localByteSlices: 0,\n   *       localInts: 0\n   *     }\n   *   },\n   *   updateParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   deleteParams: {\n   *     sender: 'SENDER_ADDRESS'\n   *   },\n   *   metadata: { name: 'my_app', version: '2.0', updatable: false, deletable: false },\n   *   onSchemaBreak: 'append',\n   *   onUpdate: 'append'\n   *  })\n   * ```\n   */\n  async deploy(deployment: AppDeployParams): Promise<AppDeployResult> {\n    const {\n      metadata,\n      deployTimeParams,\n      onSchemaBreak,\n      onUpdate,\n      createParams,\n      updateParams,\n      deleteParams,\n      existingDeployments,\n      ignoreCache,\n      ...sendParams\n    } = deployment\n\n    // Set creation note\n\n    createParams.note = updateParams.note = TransactionComposer.arc2Note({\n      dAppName: APP_DEPLOY_NOTE_DAPP,\n      data: metadata,\n      format: 'j',\n    })\n\n    // Check for required fields\n\n    if (existingDeployments && existingDeployments.creator.toString() !== createParams.sender.toString()) {\n      throw new Error(\n        `Received invalid existingDeployments value for creator ${existingDeployments.creator} when attempting to deploy for creator ${getAddress(createParams.sender)}`,\n      )\n    }\n    if (!existingDeployments && !this._indexer) {\n      throw new Error(\n        `Didn't receive an indexer client when this AppManager was created, but also didn't receive an existingDeployments cache - one of them must be provided`,\n      )\n    }\n\n    Config.getLogger(sendParams?.suppressLog).info(\n      `Idempotently deploying app \"${metadata.name}\" from creator ${getAddress(createParams.sender)} using ${createParams.approvalProgram.length} bytes of ${typeof createParams.approvalProgram === 'string' ? 'teal code' : 'AVM bytecode'} and ${createParams.clearStateProgram.length} bytes of ${typeof createParams.approvalProgram === 'string' ? 'teal code' : 'AVM bytecode'}`,\n    )\n\n    // Compile code if required\n\n    const compiledApproval =\n      typeof createParams.approvalProgram === 'string'\n        ? await this._appManager.compileTealTemplate(createParams.approvalProgram, deployTimeParams, metadata)\n        : undefined\n    const approvalProgram = compiledApproval ? compiledApproval.compiledBase64ToBytes : createParams.approvalProgram\n\n    const compiledClear =\n      typeof createParams.clearStateProgram === 'string'\n        ? await this._appManager.compileTealTemplate(createParams.clearStateProgram, deployTimeParams)\n        : undefined\n    const clearStateProgram = compiledClear ? compiledClear.compiledBase64ToBytes : createParams.clearStateProgram\n\n    // Define routines for create, update, and replace\n\n    const createApp = async () => {\n      const result = await ('method' in createParams\n        ? this._transactionSender.appCreateMethodCall({ ...createParams, approvalProgram, clearStateProgram, ...sendParams })\n        : this._transactionSender.appCreate({ ...createParams, approvalProgram, clearStateProgram, ...sendParams }))\n      const appMetadata: AppMetadata = {\n        appId: result.appId,\n        appAddress: result.appAddress,\n        ...metadata,\n        createdMetadata: metadata,\n        createdRound: BigInt(result.confirmation.confirmedRound!),\n        updatedRound: BigInt(result.confirmation.confirmedRound!),\n        deleted: false,\n      }\n      this.updateAppLookup(createParams.sender, appMetadata)\n      return {\n        operationPerformed: 'create',\n        compiledApproval,\n        compiledClear,\n        ...result,\n        ...appMetadata,\n      } satisfies SendAppCreateTransactionResult & AppMetadata & { operationPerformed: 'create' }\n    }\n    const updateApp = async (existingApp: AppMetadata) => {\n      Config.getLogger(sendParams?.suppressLog).info(\n        `Updating existing ${metadata.name} app for ${getAddress(createParams.sender)} to version ${metadata.version}.`,\n      )\n      const result = await ('method' in updateParams\n        ? this._transactionSender.appUpdateMethodCall({\n            appId: existingApp.appId,\n            approvalProgram,\n            clearStateProgram,\n            ...updateParams,\n            ...sendParams,\n          })\n        : this._transactionSender.appUpdate({\n            appId: existingApp.appId,\n            approvalProgram,\n            clearStateProgram,\n            ...updateParams,\n            ...sendParams,\n          }))\n      const appMetadata: AppMetadata = {\n        appId: existingApp.appId,\n        appAddress: existingApp.appAddress,\n        createdMetadata: existingApp.createdMetadata,\n        createdRound: existingApp.createdRound,\n        updatedRound: BigInt(result.confirmation.confirmedRound!),\n        ...metadata,\n        deleted: false,\n      }\n      this.updateAppLookup(createParams.sender, appMetadata)\n      return {\n        operationPerformed: 'update',\n        compiledApproval,\n        compiledClear,\n        ...result,\n        ...appMetadata,\n      } satisfies SendAppUpdateTransactionResult & AppMetadata & { operationPerformed: 'update' }\n    }\n    const replaceApp = async (existingApp: AppMetadata) => {\n      Config.getLogger(sendParams?.suppressLog).info(\n        `Deploying a new ${metadata.name} app for ${getAddress(createParams.sender)}; deploying app with version ${metadata.version}.`,\n      )\n\n      Config.getLogger(sendParams?.suppressLog).warn(\n        `Deleting existing ${metadata.name} app with id ${existingApp.appId} from ${getAddress(deleteParams.sender)} account.`,\n      )\n\n      const composer = this._transactionSender.newGroup()\n      if ('method' in createParams) {\n        composer.addAppCreateMethodCall({ ...createParams, approvalProgram, clearStateProgram })\n      } else {\n        composer.addAppCreate({ ...createParams, approvalProgram, clearStateProgram })\n      }\n      const createIndex = await composer.count()\n      if ('method' in deleteParams) {\n        composer.addAppDeleteMethodCall({ appId: existingApp.appId, ...deleteParams })\n      } else {\n        composer.addAppDelete({ appId: existingApp.appId, ...deleteParams })\n      }\n      const result = await composer.send({ ...sendParams })\n      const confirmation = result.confirmations.at(createIndex - 1)!\n      const transaction = result.transactions.at(createIndex - 1)!\n      const deleteTransaction = result.transactions.at(-1)!\n\n      Config.getLogger(sendParams?.suppressLog).warn(\n        `Sent transactions ${transaction.txId()} to create app with id ${confirmation.appId} and ${deleteTransaction.txId()} to delete app with id ${\n          existingApp.appId\n        } from ${getAddress(createParams.sender)} account.`,\n      )\n\n      const appMetadata: AppMetadata = {\n        appId: confirmation.appId!,\n        appAddress: getApplicationAddress(confirmation.appId!),\n        ...metadata,\n        createdMetadata: metadata,\n        createdRound: BigInt(confirmation.confirmedRound!),\n        updatedRound: BigInt(confirmation.confirmedRound!),\n        deleted: false,\n      }\n      this.updateAppLookup(createParams.sender, appMetadata)\n\n      return {\n        operationPerformed: 'replace',\n        ...result,\n        compiledApproval,\n        compiledClear,\n        transaction,\n        confirmation,\n        return: 'method' in createParams ? result.returns?.[0] : undefined,\n        deleteReturn: 'method' in deleteParams ? result.returns?.at(-1) : undefined,\n        ...appMetadata,\n        deleteResult: { transaction: deleteTransaction, confirmation: result.confirmations.at(-1)! },\n      } satisfies { operationPerformed: 'replace' } & AppMetadata &\n        SendAppCreateTransactionResult & {\n          deleteReturn?: ABIReturn\n          deleteResult: ConfirmedTransactionResult\n        }\n    }\n\n    // Lookup existing app metadata\n\n    const apps = existingDeployments ?? (await this.getCreatorAppsByName(createParams.sender, ignoreCache))\n\n    const existingApp = apps.apps[metadata.name]\n    if (!existingApp || existingApp.deleted) {\n      Config.getLogger(sendParams?.suppressLog).info(\n        `App ${metadata.name} not found in apps created by ${getAddress(createParams.sender)}; deploying app with version ${metadata.version}.`,\n      )\n\n      return await createApp()\n    }\n\n    Config.getLogger(sendParams?.suppressLog).info(\n      `Existing app ${metadata.name} found by creator ${getAddress(createParams.sender)}, with app id ${existingApp.appId} and version ${existingApp.version}.`,\n    )\n\n    const existingAppRecord = await this._appManager.getById(existingApp.appId)\n    const existingApproval = Buffer.from(existingAppRecord.approvalProgram).toString('base64')\n    const existingClear = Buffer.from(existingAppRecord.clearStateProgram).toString('base64')\n    const extraPages = existingAppRecord.extraProgramPages ?? 0\n\n    const newApprovalBytes = Buffer.from(approvalProgram)\n    const newClearBytes = Buffer.from(clearStateProgram)\n    const newApproval = newApprovalBytes.toString('base64')\n    const newClear = newClearBytes.toString('base64')\n    const newExtraPages = calculateExtraProgramPages(newApprovalBytes, newClearBytes)\n\n    // Check for changes\n\n    const isUpdate = newApproval !== existingApproval || newClear !== existingClear\n    const isSchemaBreak =\n      existingAppRecord.localInts < (createParams.schema?.localInts ?? 0) ||\n      existingAppRecord.globalInts < (createParams.schema?.globalInts ?? 0) ||\n      existingAppRecord.localByteSlices < (createParams.schema?.localByteSlices ?? 0) ||\n      existingAppRecord.globalByteSlices < (createParams.schema?.globalByteSlices ?? 0) ||\n      extraPages < newExtraPages\n\n    if (isSchemaBreak) {\n      Config.getLogger(sendParams?.suppressLog).warn(`Detected a breaking app schema change in app ${existingApp.appId}:`, {\n        from: {\n          globalInts: existingAppRecord.globalInts,\n          globalByteSlices: existingAppRecord.globalByteSlices,\n          localInts: existingAppRecord.localInts,\n          localByteSlices: existingAppRecord.localByteSlices,\n          extraProgramPages: extraPages,\n        },\n        to: { ...createParams.schema, extraProgramPages: newExtraPages },\n      })\n\n      if (onSchemaBreak === undefined || onSchemaBreak === 'fail' || onSchemaBreak === OnSchemaBreak.Fail) {\n        throw new Error(\n          'Schema break detected and onSchemaBreak=OnSchemaBreak.Fail, stopping deployment. ' +\n            'If you want to try deleting and recreating the app then ' +\n            're-run with onSchemaBreak=OnSchemaBreak.ReplaceApp',\n        )\n      }\n\n      if (onSchemaBreak === 'append' || onSchemaBreak === OnSchemaBreak.AppendApp) {\n        Config.getLogger(sendParams?.suppressLog).info('onSchemaBreak=AppendApp, will attempt to create a new app')\n        return await createApp()\n      }\n\n      if (existingApp.deletable) {\n        Config.getLogger(sendParams?.suppressLog).info(\n          'App is deletable and onSchemaBreak=ReplaceApp, will attempt to create new app and delete old app',\n        )\n      } else {\n        Config.getLogger(sendParams?.suppressLog).info(\n          'App is not deletable but onSchemaBreak=ReplaceApp, will attempt to delete app, delete will most likely fail',\n        )\n      }\n\n      return await replaceApp(existingApp)\n    }\n\n    if (isUpdate) {\n      Config.getLogger(sendParams?.suppressLog).info(\n        `Detected a TEAL update in app ${existingApp.appId} for creator ${getAddress(createParams.sender)}`,\n      )\n\n      if (onUpdate === undefined || onUpdate === 'fail' || onUpdate === OnUpdate.Fail) {\n        throw new Error('Update detected and onUpdate=Fail, stopping deployment. Try a different onUpdate value to not fail.')\n      }\n\n      if (onUpdate === 'append' || onUpdate === OnUpdate.AppendApp) {\n        Config.getLogger(sendParams?.suppressLog).info('onUpdate=AppendApp, will attempt to create a new app')\n        return await createApp()\n      }\n\n      if (onUpdate === 'update' || onUpdate === OnUpdate.UpdateApp) {\n        if (existingApp.updatable) {\n          Config.getLogger(sendParams?.suppressLog).info(`App is updatable and onUpdate=UpdateApp, updating app...`)\n        } else {\n          Config.getLogger(sendParams?.suppressLog).warn(\n            `App is not updatable but onUpdate=UpdateApp, will attempt to update app, update will most likely fail`,\n          )\n        }\n\n        return await updateApp(existingApp)\n      }\n\n      if (onUpdate === 'replace' || onUpdate === OnUpdate.ReplaceApp) {\n        if (existingApp.deletable) {\n          Config.getLogger(sendParams?.suppressLog).warn(\n            'App is deletable and onUpdate=ReplaceApp, creating new app and deleting old app...',\n          )\n        } else {\n          Config.getLogger(sendParams?.suppressLog).warn(\n            'App is not deletable and onUpdate=ReplaceApp, will attempt to create new app and delete old app, delete will most likely fail',\n          )\n        }\n\n        return await replaceApp(existingApp)\n      }\n    }\n\n    Config.getLogger(sendParams?.suppressLog).debug('No detected changes in app, nothing to do.')\n\n    return { ...existingApp, operationPerformed: 'nothing' }\n  }\n\n  private updateAppLookup(sender: ReadableAddress, appMetadata: AppMetadata) {\n    const s = getAddress(sender).toString()\n    const lookup = this._appLookups.get(s)\n    if (!lookup) {\n      this._appLookups.set(s, { creator: Address.fromString(s), apps: { [appMetadata.name]: appMetadata } })\n    } else {\n      lookup.apps[appMetadata.name] = appMetadata\n    }\n  }\n\n  /**\n   * Returns a lookup of name => app metadata (id, address, ...metadata) for all apps created by the given account that have\n   * an [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) `AppDeployNote` as the transaction\n   * note of the app creation transaction.\n   *\n   * This function caches the result for the given creator account so that subsequent calls will not require an indexer lookup.\n   *\n   * If the `AppManager` instance wasn't created with an indexer client, this function will throw an error.\n   *\n   * @param creator The address of the account that is the creator of the apps you want to search for\n   * @param ignoreCache Whether or not to ignore the cache and force a lookup, default: use the cache\n   * @returns A name-based lookup of the app metadata\n   * @example\n   * ```ts\n   * const result = await deployer.getCreatorAppsByName(creator)\n   */\n  async getCreatorAppsByName(creator: ReadableAddress, ignoreCache?: boolean): Promise<AppLookup> {\n    const appLookup: Record<string, AppMetadata> = {}\n\n    const creatorAddress = getAddress(creator)\n    const creatorString = creatorAddress.toString()\n    if (!ignoreCache && this._appLookups.has(creatorString)) {\n      return this._appLookups.get(creatorString)!\n    }\n\n    if (!this._indexer) {\n      throw new Error(`Didn't receive an indexer client when this AppManager was created, but received a call to getCreatorApps`)\n    }\n\n    // Extract all apps that account created\n    const createdApps = (await lookupAccountCreatedApplicationByAddress(this._indexer, creatorString))\n      .map((a) => {\n        return { id: a.id, createdAtRound: a.createdAtRound!, deleted: a.deleted }\n      })\n      .sort((a, b) => Number(a.createdAtRound - b.createdAtRound))\n\n    // For each app that account created (in parallel)...\n    const apps = await Promise.all(\n      createdApps.map(async (createdApp) => {\n        // Find any app transactions for that app in the round it was created (should always just be a single creation transaction)\n        const appTransactions = await searchTransactions(this._indexer!, {\n          minRound: createdApp.createdAtRound,\n          txType: TransactionType.AppCall,\n          applicationId: createdApp.id,\n          address: creatorAddress,\n          addressRole: 'sender',\n          notePrefix: Buffer.from(APP_DEPLOY_NOTE_DAPP).toString('base64'),\n        })\n\n        // Triple check the transaction is intact by filtering for the one we want:\n        //  * application-id is 0 when the app is first created\n        //  * also verify the sender to prevent a potential security risk\n        const appCreationTransaction = appTransactions.transactions.filter(\n          (t) => t.applicationTransaction?.applicationId === 0n && t.sender.toString() === creatorAddress.toString(),\n        )[0]\n\n        const latestAppUpdateTransaction = appTransactions.transactions\n          .filter((t) => t.sender.toString() === creatorAddress.toString())\n          .sort((a, b) =>\n            a.confirmedRound === b.confirmedRound\n              ? (b.intraRoundOffset! - a.intraRoundOffset!) / 10\n              : Number(b.confirmedRound! - a.confirmedRound!),\n          )[0]\n\n        if (!appCreationTransaction?.note)\n          // No note; ignoring\n          return null\n\n        return { createdApp, appCreationTransaction, latestAppUpdateTransaction }\n      }),\n    )\n\n    apps\n      .filter((a) => a !== null)\n      .forEach((a) => {\n        const { createdApp, appCreationTransaction, latestAppUpdateTransaction } = a!\n\n        const parseNote = (note?: string) => {\n          if (!note) {\n            // No note; ignoring...\n            return\n          }\n\n          if (!note.startsWith(`${APP_DEPLOY_NOTE_DAPP}:j{`))\n            // Clearly not APP_DEPLOY JSON; ignoring...\n            return\n\n          return JSON.parse(note.substring(APP_DEPLOY_NOTE_DAPP.length + 2)) as AppDeployMetadata\n        }\n\n        try {\n          const creationNote = parseNote(\n            appCreationTransaction.note ? Buffer.from(appCreationTransaction.note).toString('utf-8') : undefined,\n          )\n          const updateNote = parseNote(\n            latestAppUpdateTransaction.note ? Buffer.from(latestAppUpdateTransaction.note).toString('utf-8') : undefined,\n          )\n          if (creationNote?.name) {\n            appLookup[creationNote.name] = {\n              appId: createdApp.id,\n              appAddress: getApplicationAddress(createdApp.id),\n              createdMetadata: creationNote,\n              createdRound: appCreationTransaction.confirmedRound ?? 0n,\n              ...(updateNote ?? creationNote),\n              updatedRound: latestAppUpdateTransaction?.confirmedRound ?? 0n,\n              deleted: createdApp.deleted ?? false,\n            }\n          }\n        } catch (e) {\n          Config.logger.warn(\n            `Received error trying to retrieve app with ${createdApp.id} for creator ${creatorAddress}; failing silently`,\n            e,\n          )\n          return\n        }\n      })\n\n    const lookup = {\n      creator: creatorAddress,\n      apps: appLookup,\n    }\n\n    this._appLookups.set(creatorString, lookup)\n\n    return lookup\n  }\n}\n"],"mappings":"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"}