@algorandfoundation/algokit-utils 10.0.0-alpha.7 → 10.0.0-alpha.9

package/types/app-deployer.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-deployer.js","names":["TransactionComposer","APP_DEPLOY_NOTE_DAPP","appMetadata: AppMetadata","existingApp","getApplicationAddress","calculateExtraProgramPages","OnSchemaBreak","OnUpdate","getAddress","Address","appLookup: Record<string, AppMetadata>","TransactionType"],"sources":["../../src/types/app-deployer.ts"],"sourcesContent":["import { ABIReturn } from '@algorandfoundation/algokit-abi'\nimport { Address, getAddress, getApplicationAddress, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { IndexerClient } from '@algorandfoundation/algokit-indexer-client'\nimport { TransactionType } from '@algorandfoundation/algokit-transact'\nimport { Config } from '../config'\nimport * as indexer from '../indexer-lookup'\nimport { calculateExtraProgramPages } from '../util'\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 { Expand } from './expand'\nimport { ConfirmedTransactionResult, SendParams } from './transaction'\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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 indexer.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 indexer.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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"}
+{"version":3,"file":"app-deployer.js","names":["TransactionComposer","APP_DEPLOY_NOTE_DAPP","appMetadata: AppMetadata","existingApp","getApplicationAddress","calculateExtraProgramPages","OnSchemaBreak","OnUpdate","getAddress","Address","appLookup: Record<string, AppMetadata>","TransactionType"],"sources":["../../src/types/app-deployer.ts"],"sourcesContent":["import { ABIReturn } from '@algorandfoundation/algokit-abi'\nimport { Address, getAddress, getApplicationAddress, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { IndexerClient } from '@algorandfoundation/algokit-indexer-client'\nimport { TransactionType } from '@algorandfoundation/algokit-transact'\nimport { Config } from '../config'\nimport * as indexer from '../indexer-lookup'\nimport { calculateExtraProgramPages } from '../util'\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 { Expand } from './expand'\nimport { ConfirmedTransactionResult, SendParams } from './transaction'\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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 indexer.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 indexer.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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"}

package/types/app-deployer.mjs

@@ -67,7 +67,7 @@ var AppDeployer = class {
 	* ```
 	*/
 	async deploy(deployment) {
-		const { metadata, deployTimeParams, onSchemaBreak, onUpdate, createParams, updateParams, deleteParams, existingDeployments, ignoreCache,...sendParams } = deployment;
+		const { metadata, deployTimeParams, onSchemaBreak, onUpdate, createParams, updateParams, deleteParams, existingDeployments, ignoreCache, ...sendParams } = deployment;
 		createParams.note = updateParams.note = TransactionComposer.arc2Note({
 			dAppName: APP_DEPLOY_NOTE_DAPP,
 			data: metadata,

package/types/app-deployer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"app-deployer.mjs","names":["appMetadata: AppMetadata","existingApp","appLookup: Record<string, AppMetadata>","indexer.lookupAccountCreatedApplicationByAddress","indexer.searchTransactions"],"sources":["../../src/types/app-deployer.ts"],"sourcesContent":["import { ABIReturn } from '@algorandfoundation/algokit-abi'\nimport { Address, getAddress, getApplicationAddress, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { IndexerClient } from '@algorandfoundation/algokit-indexer-client'\nimport { TransactionType } from '@algorandfoundation/algokit-transact'\nimport { Config } from '../config'\nimport * as indexer from '../indexer-lookup'\nimport { calculateExtraProgramPages } from '../util'\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 { Expand } from './expand'\nimport { ConfirmedTransactionResult, SendParams } from './transaction'\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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 indexer.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 indexer.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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"}
+{"version":3,"file":"app-deployer.mjs","names":["appMetadata: AppMetadata","existingApp","appLookup: Record<string, AppMetadata>","indexer.lookupAccountCreatedApplicationByAddress","indexer.searchTransactions"],"sources":["../../src/types/app-deployer.ts"],"sourcesContent":["import { ABIReturn } from '@algorandfoundation/algokit-abi'\nimport { Address, getAddress, getApplicationAddress, ReadableAddress } from '@algorandfoundation/algokit-common'\nimport { IndexerClient } from '@algorandfoundation/algokit-indexer-client'\nimport { TransactionType } from '@algorandfoundation/algokit-transact'\nimport { Config } from '../config'\nimport * as indexer from '../indexer-lookup'\nimport { calculateExtraProgramPages } from '../util'\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 { Expand } from './expand'\nimport { ConfirmedTransactionResult, SendParams } from './transaction'\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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 ${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 indexer.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 indexer.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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"}

package/types/app-factory.d.ts

@@ -246,7 +246,7 @@ declare class AppFactory {
       sender: Address;
       signer: AddressWithTransactionSigner | TransactionSigner | undefined;
       method: ABIMethod;
-      args: (Transaction | ABIValue | TransactionWithSigner | AppMethodCall<{
+      args: (Transaction | Promise<Transaction> | ABIValue | TransactionWithSigner | AppMethodCall<{
         sender: SendingAddress;
         signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
@@ -258,8 +258,7 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        appId: bigint;
-        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
+        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -267,11 +266,19 @@ declare class AppFactory {
         boxReferences?: (BoxReference | BoxIdentifier)[] | undefined;
         accessReferences?: ResourceReference[] | undefined;
         rejectVersion?: number | undefined;
+        appId?: 0 | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
+        schema?: {
+          globalInts: number;
+          globalByteSlices: number;
+          localInts: number;
+          localByteSlices: number;
+        } | undefined;
+        extraProgramPages?: number | undefined;
       }> | AppMethodCall<{
-        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         sender: SendingAddress;
+        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -281,8 +288,9 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
+        appId: bigint;
+        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
         args?: Uint8Array[] | undefined;
-        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
         assetReferences?: bigint[] | undefined;
@@ -291,14 +299,7 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-        schema?: {
-          globalInts: number;
-          globalByteSlices: number;
-          localInts: number;
-          localByteSlices: number;
-        } | undefined;
-        extraProgramPages?: number | undefined;
-      }> | Promise<Transaction> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
+      }> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
       onComplete: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication;
     }>;
     /** Return params for a deployment update ABI call */
@@ -348,7 +349,7 @@ declare class AppFactory {
       sender: Address;
       signer: AddressWithTransactionSigner | TransactionSigner | undefined;
       method: ABIMethod;
-      args: (Transaction | ABIValue | TransactionWithSigner | AppMethodCall<{
+      args: (Transaction | Promise<Transaction> | ABIValue | TransactionWithSigner | AppMethodCall<{
         sender: SendingAddress;
         signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
@@ -360,8 +361,7 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        appId: bigint;
-        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
+        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -369,11 +369,19 @@ declare class AppFactory {
         boxReferences?: (BoxReference | BoxIdentifier)[] | undefined;
         accessReferences?: ResourceReference[] | undefined;
         rejectVersion?: number | undefined;
+        appId?: 0 | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
+        schema?: {
+          globalInts: number;
+          globalByteSlices: number;
+          localInts: number;
+          localByteSlices: number;
+        } | undefined;
+        extraProgramPages?: number | undefined;
       }> | AppMethodCall<{
-        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         sender: SendingAddress;
+        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -383,8 +391,9 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
+        appId: bigint;
+        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
         args?: Uint8Array[] | undefined;
-        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
         assetReferences?: bigint[] | undefined;
@@ -393,14 +402,7 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-        schema?: {
-          globalInts: number;
-          globalByteSlices: number;
-          localInts: number;
-          localByteSlices: number;
-        } | undefined;
-        extraProgramPages?: number | undefined;
-      }> | Promise<Transaction> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
+      }> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
       onComplete: OnApplicationComplete.UpdateApplication;
     };
     /** Return params for a deployment delete ABI call */
@@ -450,7 +452,7 @@ declare class AppFactory {
       sender: Address;
       signer: AddressWithTransactionSigner | TransactionSigner | undefined;
       method: ABIMethod;
-      args: (Transaction | ABIValue | TransactionWithSigner | AppMethodCall<{
+      args: (Transaction | Promise<Transaction> | ABIValue | TransactionWithSigner | AppMethodCall<{
         sender: SendingAddress;
         signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
@@ -462,8 +464,7 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
-        appId: bigint;
-        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
+        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         args?: Uint8Array[] | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
@@ -471,11 +472,19 @@ declare class AppFactory {
         boxReferences?: (BoxReference | BoxIdentifier)[] | undefined;
         accessReferences?: ResourceReference[] | undefined;
         rejectVersion?: number | undefined;
+        appId?: 0 | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
+        schema?: {
+          globalInts: number;
+          globalByteSlices: number;
+          localInts: number;
+          localByteSlices: number;
+        } | undefined;
+        extraProgramPages?: number | undefined;
       }> | AppMethodCall<{
-        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         sender: SendingAddress;
+        signer?: AddressWithTransactionSigner | TransactionSigner | undefined;
         rekeyTo?: ReadableAddress | undefined;
         note?: string | Uint8Array | undefined;
         lease?: string | Uint8Array | undefined;
@@ -485,8 +494,9 @@ declare class AppFactory {
         validityWindow?: number | bigint | undefined;
         firstValidRound?: bigint | undefined;
         lastValidRound?: bigint | undefined;
+        appId: bigint;
+        onComplete?: OnApplicationComplete.UpdateApplication | undefined;
         args?: Uint8Array[] | undefined;
-        onComplete?: OnApplicationComplete.NoOp | OnApplicationComplete.OptIn | OnApplicationComplete.CloseOut | OnApplicationComplete.UpdateApplication | OnApplicationComplete.DeleteApplication | undefined;
         accountReferences?: ReadableAddress[] | undefined;
         appReferences?: bigint[] | undefined;
         assetReferences?: bigint[] | undefined;
@@ -495,14 +505,7 @@ declare class AppFactory {
         rejectVersion?: number | undefined;
         approvalProgram: string | Uint8Array;
         clearStateProgram: string | Uint8Array;
-        schema?: {
-          globalInts: number;
-          globalByteSlices: number;
-          localInts: number;
-          localByteSlices: number;
-        } | undefined;
-        extraProgramPages?: number | undefined;
-      }> | Promise<Transaction> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
+      }> | AppMethodCall<AppMethodCallParams> | undefined)[] | undefined;
       onComplete: OnApplicationComplete.DeleteApplication;
     };
     bare: {

package/types/app-manager.d.ts

@@ -44,6 +44,8 @@ interface AppInformation {
   globalByteSlices: number;
   /** Any extra pages that are needed for the smart contract. */
   extraProgramPages?: number;
+  /** The number of updates to the application programs */
+  version?: number;
 }
 /**
  * Something that identifies an app box name - either a:

package/types/app-manager.js

@@ -91,7 +91,7 @@ var AppManager = class AppManager {
 	* @returns The app information
 	*/
 	async getById(appId) {
-		const app = await this._algod.getApplicationById(appId);
+		const app = await this._algod.applicationById(appId);
 		const convertedGlobalState = (app.params.globalState ?? []).map((kv) => ({
 			key: kv.key,
 			value: kv.value
@@ -107,7 +107,8 @@ var AppManager = class AppManager {
 			globalInts: app.params.globalStateSchema?.numUints ?? 0,
 			globalByteSlices: app.params.globalStateSchema?.numByteSlices ?? 0,
 			extraProgramPages: app.params.extraProgramPages ?? 0,
-			globalState: AppManager.decodeAppState(convertedGlobalState)
+			globalState: AppManager.decodeAppState(convertedGlobalState),
+			version: app.params.version
 		};
 	}
 	/**
@@ -154,7 +155,7 @@ var AppManager = class AppManager {
 	* ```
 	*/
 	async getBoxNames(appId) {
-		return (await this._algod.getApplicationBoxes(appId)).boxes.map((b) => {
+		return (await this._algod.applicationBoxes(appId)).boxes.map((b) => {
 			return {
 				nameRaw: b.name,
 				nameBase64: Buffer.from(b.name).toString("base64"),
@@ -175,7 +176,7 @@ var AppManager = class AppManager {
 	async getBoxValue(appId, boxName) {
 		const boxId = typeof boxName === "object" && "nameRaw" in boxName ? boxName.nameRaw : boxName;
 		const name = AppManager.getBoxReference(boxId).name;
-		return (await this._algod.getApplicationBoxByName(Number(appId), name)).value;
+		return (await this._algod.applicationBoxByName(Number(appId), name)).value;
 	}
 	/**
 	* Returns the value of the given box names for the given app.