@algorandfoundation/algokit-utils 0.1.0 → 1.0.0-beta.11

package/deploy-app.d.ts

@@ -0,0 +1,93 @@
+import { Algodv2, Indexer } from 'algosdk';
+import { ApplicationStateSchema } from './types/algod';
+import { AppDeploymentParams, AppDeployMetadata, AppLookup, AppMetadata, CompiledTeal, TealTemplateParameters } from './types/app';
+import { ConfirmedTransactionResult, SendTransactionFrom } from './types/transaction';
+/**
+ * Idempotently deploy (create, update/delete if changed) an app against the given name via the given creator account, including deploy-time template placeholder substitutions.
+ *
+ * To understand the architecture decisions behind this functionality please @see https://github.com/algorandfoundation/algokit-cli/blob/main/docs/architecture-decisions/2023-01-12_smart-contract-deployment.md
+ *
+ * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.
+ *
+ * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.
+ *
+ * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.
+ * @param deployment The arguments to control the app deployment
+ * @param algod An algod client
+ * @param indexer An indexer client, needed if `existingDeployments` not passed in
+ * @returns The app reference of the new/existing app
+ */
+export declare function deployApp(deployment: AppDeploymentParams, algod: Algodv2, indexer?: Indexer): Promise<(ConfirmedTransactionResult & AppMetadata & {
+    operationPerformed: 'create' | 'update';
+}) | (ConfirmedTransactionResult & AppMetadata & {
+    deleteResult: ConfirmedTransactionResult;
+    operationPerformed: 'replace';
+}) | (AppMetadata & {
+    operationPerformed: 'nothing';
+})>;
+/** Returns true is there is a breaking change in the application state schema from before to after.
+ *  i.e. if the schema becomes larger, since applications can't ask for more schema after creation.
+ *  Otherwise, there is no error, the app just doesn't store data in the extra schema :(
+ *
+ * @param before The existing schema
+ * @param after The new schema
+ * @returns Whether or not there is a breaking change
+ */
+export declare function isSchemaIsBroken(before: ApplicationStateSchema, after: ApplicationStateSchema): boolean;
+/**
+ * Returns a lookup of name => app metadata (id, address, ...metadata) for all apps created by the given account that have an @see {AppDeployNote} in the transaction note of the creation transaction.
+ *
+ * **Note:** It's recommended this is only called once and then stored since it's a somewhat expensive operation (multiple indexer calls).
+ *
+ * @param creatorAccount The account (with private key loaded) or string address of an account that is the creator of the apps you want to search for
+ * @param indexer An indexer client
+ * @returns A name-based lookup of the app information (id, address)
+ */
+export declare function getCreatorAppsByName(creatorAccount: SendTransactionFrom | string, indexer: Indexer): Promise<AppLookup>;
+/**
+ * Return the transaction note for an app deployment.
+ * @param metadata The metadata of the deployment
+ * @returns The transaction note as a utf-8 string
+ */
+export declare function getAppDeploymentTransactionNote(metadata: AppDeployMetadata): {
+    dAppName: string;
+    data: AppDeployMetadata;
+    format: string;
+};
+/**
+ * Replaces deploy-time deployment control parameters within the given teal code.
+ *
+ * @see {UPDATABLE_TEMPLATE_NAME}
+ * @see {DELETABLE_TEMPLATE_NAME}
+ *
+ * @param tealCode The TEAL code to substitute
+ * @param params The deploy-time deployment control parameter value to replace
+ * @returns The replaced TEAL code
+ */
+export declare function replaceDeployTimeControlParams(tealCode: string, params: {
+    updatable?: boolean;
+    deletable?: boolean;
+}): string;
+/**
+ * Performs template substitution of a teal file.
+ *
+ * Looks for `TMPL_{parameter}` for template replacements.
+ *
+ * @param tealCode The TEAL logic to compile
+ * @param templateParameters Any parameters to replace in the .teal file before compiling
+ * @returns The TEAL code with replacements
+ */
+export declare function performTemplateSubstitution(tealCode: string, templateParameters?: TealTemplateParameters): string;
+/**
+ * Performs template substitution of a teal file and compiles it, returning the compiled result.
+ *
+ * Looks for `TMPL_{parameter}` for template replacements.
+ *
+ * @param tealCode The TEAL logic to compile
+ * @param algod An algod client
+ * @param templateParameters Any parameters to replace in the .teal file before compiling
+ * @param deploymentMetadata The deployment metadata the app will be deployed with
+ * @returns The information about the compiled code
+ */
+export declare function performTemplateSubstitutionAndCompile(tealCode: string, algod: Algodv2, templateParameters?: TealTemplateParameters, deploymentMetadata?: AppDeployMetadata): Promise<CompiledTeal>;
+//# sourceMappingURL=deploy-app.d.ts.map

package/deploy-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-app.d.ts","sourceRoot":"","sources":["../src/deploy-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAyB,OAAO,EAAmB,MAAM,SAAS,CAAA;AAKlF,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,WAAW,EAEX,YAAY,EAIZ,sBAAsB,EAEvB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAErF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,UAAU,EAAE,mBAAmB,EAC/B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CACN,CAAC,0BAA0B,GAAG,WAAW,GAAG;IAAE,kBAAkB,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,CAAC,GACxF,CAAC,0BAA0B,GAAG,WAAW,GAAG;IAAE,YAAY,EAAE,0BAA0B,CAAC;IAAC,kBAAkB,EAAE,SAAS,CAAA;CAAE,CAAC,GACxH,CAAC,WAAW,GAAG;IAAE,kBAAkB,EAAE,SAAS,CAAA;CAAE,CAAC,CACpD,CAkSA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,EAAE,KAAK,EAAE,sBAAsB,WAE7F;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,mBAAmB,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAyF7H;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,iBAAiB;;;;EAM1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,UAoBpH;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,sBAAsB,UAiBxG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qCAAqC,CACzD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,kBAAkB,CAAC,EAAE,sBAAsB,EAC3C,kBAAkB,CAAC,EAAE,iBAAiB,GACrC,OAAO,CAAC,YAAY,CAAC,CAcvB"}

package/deploy-app.js

@@ -0,0 +1,411 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performTemplateSubstitutionAndCompile = exports.performTemplateSubstitution = exports.replaceDeployTimeControlParams = exports.getAppDeploymentTransactionNote = exports.getCreatorAppsByName = exports.isSchemaIsBroken = exports.deployApp = void 0;
+const algosdk_1 = require("algosdk");
+const _1 = require("./");
+const app_1 = require("./app");
+const indexer_lookup_1 = require("./indexer-lookup");
+const transaction_1 = require("./transaction");
+const app_2 = require("./types/app");
+/**
+ * Idempotently deploy (create, update/delete if changed) an app against the given name via the given creator account, including deploy-time template placeholder substitutions.
+ *
+ * To understand the architecture decisions behind this functionality please @see https://github.com/algorandfoundation/algokit-cli/blob/main/docs/architecture-decisions/2023-01-12_smart-contract-deployment.md
+ *
+ * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.
+ *
+ * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.
+ *
+ * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.
+ * @param deployment The arguments to control the app deployment
+ * @param algod An algod client
+ * @param indexer An indexer client, needed if `existingDeployments` not passed in
+ * @returns The app reference of the new/existing app
+ */
+async function deployApp(deployment, algod, indexer) {
+    const { metadata, deployTimeParameters, onSchemaBreak, onUpdate, existingDeployments, createArgs, updateArgs, deleteArgs, ...appParams } = deployment;
+    if (existingDeployments && existingDeployments.creator !== (0, transaction_1.getSenderAddress)(appParams.from)) {
+        throw new Error(`Received invalid existingDeployments value for creator ${existingDeployments.creator} when attempting to deploy for creator ${appParams.from}`);
+    }
+    if (!existingDeployments && !indexer) {
+        throw new Error(`Didn't receive an indexer client, but also didn't receive an existingDeployments cache - one of them must be provided`);
+    }
+    _1.Config.getLogger(appParams.suppressLog).info(`Idempotently deploying app "${metadata.name}" from creator ${(0, transaction_1.getSenderAddress)(appParams.from)} using ${appParams.approvalProgram.length} bytes of teal code and ${appParams.clearStateProgram.length} bytes of teal code`);
+    appParams.approvalProgram =
+        typeof appParams.approvalProgram === 'string'
+            ? (await performTemplateSubstitutionAndCompile(appParams.approvalProgram, algod, deployTimeParameters, metadata))
+                .compiledBase64ToBytes
+            : appParams.approvalProgram;
+    appParams.clearStateProgram =
+        typeof appParams.clearStateProgram === 'string'
+            ? (await performTemplateSubstitutionAndCompile(appParams.clearStateProgram, algod, deployTimeParameters)).compiledBase64ToBytes
+            : appParams.clearStateProgram;
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const apps = existingDeployments ?? (await getCreatorAppsByName(appParams.from, indexer));
+    const create = async (skipSending) => {
+        const result = await (0, app_1.createApp)({
+            ...appParams,
+            args: createArgs,
+            note: getAppDeploymentTransactionNote(metadata),
+            skipSending: skipSending ?? false,
+            skipWaiting: false,
+        }, algod);
+        return {
+            transaction: result.transaction,
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            confirmation: result.confirmation,
+            appId: result.appId,
+            appAddress: result.appAddress,
+            createdMetadata: metadata,
+            createdRound: Number(result.confirmation?.['confirmed-round']),
+            updatedRound: Number(result.confirmation?.['confirmed-round']),
+            ...metadata,
+            deleted: false,
+            operationPerformed: 'create',
+        };
+    };
+    const existingApp = apps.apps[metadata.name];
+    if (!existingApp || existingApp.deleted) {
+        _1.Config.getLogger(appParams.suppressLog).info(`App ${metadata.name} not found in apps created by ${(0, transaction_1.getSenderAddress)(appParams.from)}; deploying app with version ${metadata.version}.`);
+        return await create();
+    }
+    _1.Config.getLogger(appParams.suppressLog).info(`Existing app ${metadata.name} found by creator ${(0, transaction_1.getSenderAddress)(appParams.from)}, with app id ${existingApp.appId} and version ${existingApp.version}.`);
+    const existingAppRecord = await (0, app_1.getAppByIndex)(existingApp.appId, algod);
+    const existingApproval = existingAppRecord.params['approval-program'];
+    const existingClear = existingAppRecord.params['clear-state-program'];
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const existingGlobalSchema = existingAppRecord.params['global-state-schema'];
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    const existingLocalSchema = existingAppRecord.params['local-state-schema'];
+    const newGlobalSchema = {
+        'num-byte-slice': appParams.schema.globalByteSlices,
+        'num-uint': appParams.schema.globalInts,
+    };
+    const newLocalSchema = {
+        'num-byte-slice': appParams.schema.localByteSlices,
+        'num-uint': appParams.schema.localInts,
+    };
+    const newApproval = Buffer.from(appParams.approvalProgram).toString('base64');
+    const newClear = Buffer.from(appParams.clearStateProgram).toString('base64');
+    const isUpdate = newApproval !== existingApproval || newClear !== existingClear;
+    const isSchemaBreak = isSchemaIsBroken(existingGlobalSchema, newGlobalSchema) || isSchemaIsBroken(existingLocalSchema, newLocalSchema);
+    const replace = async () => {
+        // Create
+        _1.Config.getLogger(appParams.suppressLog).info(`Deploying a new ${metadata.name} app for ${(0, transaction_1.getSenderAddress)(appParams.from)}; deploying app with version ${metadata.version}.`);
+        const { transaction: createTransaction } = await create(true);
+        // Delete
+        _1.Config.getLogger(appParams.suppressLog).warn(`Deleting existing ${metadata.name} app with id ${existingApp.appId} from ${(0, transaction_1.getSenderAddress)(appParams.from)} account.`);
+        const { transaction: deleteTransaction } = await (0, app_1.callApp)({
+            appId: existingApp.appId,
+            callType: 'delete',
+            from: appParams.from,
+            args: deleteArgs,
+            transactionParams: appParams.transactionParams,
+            suppressLog: appParams.suppressLog,
+            skipSending: true,
+        }, algod);
+        // Ensure create and delete happen atomically
+        const { confirmations } = await (0, transaction_1.sendGroupOfTransactions)({
+            transactions: [
+                {
+                    transaction: createTransaction,
+                    signer: appParams.from,
+                },
+                {
+                    transaction: deleteTransaction,
+                    signer: appParams.from,
+                },
+            ],
+            sendParams: {
+                maxRoundsToWaitForConfirmation: appParams.maxRoundsToWaitForConfirmation,
+                skipWaiting: false,
+                suppressLog: true,
+            },
+        }, algod);
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const createConfirmation = confirmations[0];
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const deleteConfirmation = confirmations[1];
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const newAppIndex = createConfirmation['application-index'];
+        _1.Config.getLogger(appParams.suppressLog).warn(`Sent transactions ${createTransaction.txID()} to create app with id ${newAppIndex} and ${deleteTransaction.txID()} to delete app with id ${existingApp.appId} from ${(0, transaction_1.getSenderAddress)(appParams.from)} account.`);
+        return {
+            transaction: createTransaction,
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            confirmation: createConfirmation,
+            appId: newAppIndex,
+            appAddress: (0, algosdk_1.getApplicationAddress)(newAppIndex),
+            createdMetadata: metadata,
+            createdRound: Number(createConfirmation['confirmed-round']),
+            updatedRound: Number(createConfirmation['confirmed-round']),
+            ...metadata,
+            deleted: false,
+            deleteResult: { transaction: deleteTransaction, confirmation: deleteConfirmation },
+            operationPerformed: 'replace',
+        };
+    };
+    const update = async () => {
+        _1.Config.getLogger(appParams.suppressLog).info(`Updating existing ${metadata.name} app for ${(0, transaction_1.getSenderAddress)(appParams.from)} to version ${metadata.version}.`);
+        const result = await (0, app_1.updateApp)({
+            appId: existingApp.appId,
+            from: appParams.from,
+            args: updateArgs,
+            note: getAppDeploymentTransactionNote(metadata),
+            approvalProgram: appParams.approvalProgram,
+            clearStateProgram: appParams.clearStateProgram,
+            transactionParams: appParams.transactionParams,
+            suppressLog: appParams.suppressLog,
+            skipSending: false,
+            skipWaiting: false,
+        }, algod);
+        return {
+            transaction: result.transaction,
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            confirmation: result.confirmation,
+            appId: existingApp.appId,
+            appAddress: existingApp.appAddress,
+            createdMetadata: existingApp.createdMetadata,
+            createdRound: existingApp.createdRound,
+            updatedRound: Number(result.confirmation?.['confirmed-round']),
+            ...metadata,
+            deleted: false,
+            operationPerformed: 'update',
+        };
+    };
+    if (isSchemaBreak) {
+        _1.Config.getLogger(appParams.suppressLog).warn(`Detected a breaking app schema change in app ${existingApp.appId}:`, {
+            from: {
+                global: existingGlobalSchema,
+                local: existingLocalSchema,
+            },
+            to: {
+                global: newGlobalSchema,
+                local: newLocalSchema,
+            },
+        });
+        if (onSchemaBreak === undefined || onSchemaBreak === 'fail' || onSchemaBreak === app_2.OnSchemaBreak.Fail) {
+            throw new Error('Schema break detected and onSchemaBreak=OnSchemaBreak.Fail, stopping deployment. ' +
+                'If you want to try deleting and recreating the app then ' +
+                're-run with onSchemaBreak=OnSchemaBreak.ReplaceApp');
+        }
+        if (existingApp.deletable) {
+            _1.Config.getLogger(appParams.suppressLog).info('App is deletable and onSchemaBreak=ReplaceApp, will attempt to create new app and delete old app');
+        }
+        else {
+            _1.Config.getLogger(appParams.suppressLog).info('App is not deletable but onSchemaBreak=ReplaceApp, will attempt to delete app, delete will most likely fail');
+        }
+        return await replace();
+    }
+    if (isUpdate) {
+        _1.Config.getLogger(appParams.suppressLog).info(`Detected a TEAL update in app ${existingApp.appId} for creator ${(0, transaction_1.getSenderAddress)(appParams.from)}`);
+        if (onUpdate === undefined || onUpdate === 'fail' || onUpdate === app_2.OnUpdate.Fail) {
+            throw new Error('Update detected and onUpdate=Fail, stopping deployment. ' +
+                'If you want to try deleting and recreating the app then ' +
+                're-run with onUpdate=UpdateApp');
+        }
+        if (onUpdate === 'update' || onUpdate === app_2.OnUpdate.UpdateApp) {
+            if (existingApp.updatable) {
+                _1.Config.getLogger(appParams.suppressLog).info(`App is updatable and onUpdate=UpdateApp, updating app...`);
+            }
+            else {
+                _1.Config.getLogger(appParams.suppressLog).warn(`App is not updatable but onUpdate=UpdateApp, will attempt to update app, update will most likely fail`);
+            }
+            return await update();
+        }
+        if (onUpdate === 'replace' || onUpdate === app_2.OnUpdate.ReplaceApp) {
+            if (existingApp.deletable) {
+                _1.Config.getLogger(appParams.suppressLog).warn('App is deletable and onUpdate=ReplaceApp, creating new app and deleting old app...');
+            }
+            else {
+                _1.Config.getLogger(appParams.suppressLog).warn('App is not deletable and onUpdate=ReplaceApp, will attempt to create new app and delete old app, delete will most likely fail');
+            }
+            return await replace();
+        }
+    }
+    _1.Config.getLogger(appParams.suppressLog).debug('No detected changes in app, nothing to do.');
+    return { ...existingApp, operationPerformed: 'nothing' };
+}
+exports.deployApp = deployApp;
+/** Returns true is there is a breaking change in the application state schema from before to after.
+ *  i.e. if the schema becomes larger, since applications can't ask for more schema after creation.
+ *  Otherwise, there is no error, the app just doesn't store data in the extra schema :(
+ *
+ * @param before The existing schema
+ * @param after The new schema
+ * @returns Whether or not there is a breaking change
+ */
+function isSchemaIsBroken(before, after) {
+    return before['num-byte-slice'] < after['num-byte-slice'] || before['num-uint'] < after['num-uint'];
+}
+exports.isSchemaIsBroken = isSchemaIsBroken;
+/**
+ * Returns a lookup of name => app metadata (id, address, ...metadata) for all apps created by the given account that have an @see {AppDeployNote} in the transaction note of the creation transaction.
+ *
+ * **Note:** It's recommended this is only called once and then stored since it's a somewhat expensive operation (multiple indexer calls).
+ *
+ * @param creatorAccount The account (with private key loaded) or string address of an account that is the creator of the apps you want to search for
+ * @param indexer An indexer client
+ * @returns A name-based lookup of the app information (id, address)
+ */
+async function getCreatorAppsByName(creatorAccount, indexer) {
+    const appLookup = {};
+    const creatorAddress = typeof creatorAccount !== 'string' ? (0, transaction_1.getSenderAddress)(creatorAccount) : creatorAccount;
+    // Extract all apps that account created
+    const createdApps = (await (0, indexer_lookup_1.lookupAccountCreatedApplicationByAddress)(indexer, creatorAddress)).map((a) => {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return { id: a.id, createdAtRound: a['created-at-round'], deleted: a.deleted };
+    });
+    // For each app that account created (in parallel)...
+    await Promise.all(createdApps.map(async (createdApp) => {
+        // Find any app transactions for that app in the round it was created (should always just be a single creation transaction)
+        const appTransactions = await (0, indexer_lookup_1.searchTransactions)(indexer, (s) => s
+            .minRound(createdApp.createdAtRound)
+            .txType(algosdk_1.TransactionType.appl)
+            .applicationID(createdApp.id)
+            .address(creatorAddress)
+            .addressRole('sender')
+            .notePrefix(Buffer.from(app_2.APP_DEPLOY_NOTE_DAPP).toString('base64')));
+        // Triple check the transaction is intact by filtering for the one we want:
+        //  * application-id is 0 when the app is first created
+        //  * also verify the sender to prevent a potential security risk
+        const appCreationTransaction = appTransactions.transactions.filter(
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        (t) => t['application-transaction']['application-id'] === 0 && t.sender === creatorAddress)[0];
+        const latestAppUpdateTransaction = appTransactions.transactions
+            .filter((t) => t.sender === creatorAddress)
+            .sort((a, b) => a['confirmed-round'] === b['confirmed-round']
+            ? // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                (b['intra-round-offset'] - a['intra-round-offset']) / 10
+            : // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                b['confirmed-round'] - a['confirmed-round'])[0];
+        if (!appCreationTransaction?.note)
+            // No note; ignoring
+            return;
+        const parseNote = (note) => {
+            if (!note) {
+                // No note; ignoring...
+                return;
+            }
+            const decoder = new TextDecoder();
+            const noteAsBase64 = decoder.decode(Buffer.from(note));
+            const noteAsString = Buffer.from(noteAsBase64, 'base64').toString('utf-8');
+            if (!noteAsString.startsWith(`${app_2.APP_DEPLOY_NOTE_DAPP}:j{`))
+                // Clearly not APP_DEPLOY JSON; ignoring...
+                return;
+            return JSON.parse(noteAsString.substring(app_2.APP_DEPLOY_NOTE_DAPP.length + 2));
+        };
+        try {
+            const creationNote = parseNote(appCreationTransaction.note);
+            const updateNote = parseNote(latestAppUpdateTransaction.note);
+            if (creationNote?.name) {
+                appLookup[creationNote.name] = {
+                    appId: createdApp.id,
+                    appAddress: (0, algosdk_1.getApplicationAddress)(createdApp.id),
+                    createdMetadata: creationNote,
+                    createdRound: Number(appCreationTransaction['confirmed-round']),
+                    ...(updateNote ?? creationNote),
+                    updatedRound: Number(latestAppUpdateTransaction?.['confirmed-round']),
+                    deleted: createdApp.deleted ?? false,
+                };
+            }
+        }
+        catch (e) {
+            _1.Config.logger.warn(`Received error trying to retrieve app with ${createdApp.id} for creator ${creatorAddress}; failing silently`, e);
+            return;
+        }
+    }));
+    return {
+        creator: creatorAddress,
+        apps: appLookup,
+    };
+}
+exports.getCreatorAppsByName = getCreatorAppsByName;
+/**
+ * Return the transaction note for an app deployment.
+ * @param metadata The metadata of the deployment
+ * @returns The transaction note as a utf-8 string
+ */
+function getAppDeploymentTransactionNote(metadata) {
+    return {
+        dAppName: app_2.APP_DEPLOY_NOTE_DAPP,
+        data: metadata,
+        format: 'j',
+    };
+}
+exports.getAppDeploymentTransactionNote = getAppDeploymentTransactionNote;
+/**
+ * Replaces deploy-time deployment control parameters within the given teal code.
+ *
+ * @see {UPDATABLE_TEMPLATE_NAME}
+ * @see {DELETABLE_TEMPLATE_NAME}
+ *
+ * @param tealCode The TEAL code to substitute
+ * @param params The deploy-time deployment control parameter value to replace
+ * @returns The replaced TEAL code
+ */
+function replaceDeployTimeControlParams(tealCode, params) {
+    if (params.updatable !== undefined) {
+        if (!tealCode.includes(app_2.UPDATABLE_TEMPLATE_NAME)) {
+            throw new Error(`Deploy-time updatability control requested for app deployment, but ${app_2.UPDATABLE_TEMPLATE_NAME} not present in TEAL code`);
+        }
+        tealCode = tealCode.replace(new RegExp(app_2.UPDATABLE_TEMPLATE_NAME, 'g'), (params.updatable ? 1 : 0).toString());
+    }
+    if (params.deletable !== undefined) {
+        if (!tealCode.includes(app_2.DELETABLE_TEMPLATE_NAME)) {
+            throw new Error(`Deploy-time deletability control requested for app deployment, but ${app_2.DELETABLE_TEMPLATE_NAME} not present in TEAL code`);
+        }
+        tealCode = tealCode.replace(new RegExp(app_2.DELETABLE_TEMPLATE_NAME, 'g'), (params.deletable ? 1 : 0).toString());
+    }
+    return tealCode;
+}
+exports.replaceDeployTimeControlParams = replaceDeployTimeControlParams;
+/**
+ * Performs template substitution of a teal file.
+ *
+ * Looks for `TMPL_{parameter}` for template replacements.
+ *
+ * @param tealCode The TEAL logic to compile
+ * @param templateParameters Any parameters to replace in the .teal file before compiling
+ * @returns The TEAL code with replacements
+ */
+function performTemplateSubstitution(tealCode, templateParameters) {
+    if (templateParameters !== undefined) {
+        for (const key in templateParameters) {
+            const value = templateParameters[key];
+            const token = `TMPL_${key.replace(/^TMPL_/, '')}`;
+            tealCode = tealCode.replace(new RegExp(token, 'g'), typeof value === 'string'
+                ? `0x${Buffer.from(value, 'utf-8').toString('hex')}`
+                : ArrayBuffer.isView(value)
+                    ? `0x${Buffer.from(value).toString('hex')}`
+                    : value.toString());
+        }
+    }
+    return tealCode;
+}
+exports.performTemplateSubstitution = performTemplateSubstitution;
+/**
+ * Performs template substitution of a teal file and compiles it, returning the compiled result.
+ *
+ * Looks for `TMPL_{parameter}` for template replacements.
+ *
+ * @param tealCode The TEAL logic to compile
+ * @param algod An algod client
+ * @param templateParameters Any parameters to replace in the .teal file before compiling
+ * @param deploymentMetadata The deployment metadata the app will be deployed with
+ * @returns The information about the compiled code
+ */
+async function performTemplateSubstitutionAndCompile(tealCode, algod, templateParameters, deploymentMetadata) {
+    tealCode = performTemplateSubstitution(tealCode, templateParameters);
+    if (deploymentMetadata) {
+        tealCode = replaceDeployTimeControlParams(tealCode, deploymentMetadata);
+    }
+    const compiled = await algod.compile(tealCode).do();
+    return {
+        teal: tealCode,
+        compiled: compiled.result,
+        compiledHash: compiled.hash,
+        compiledBase64ToBytes: new Uint8Array(Buffer.from(compiled.result, 'base64')),
+    };
+}
+exports.performTemplateSubstitutionAndCompile = performTemplateSubstitutionAndCompile;
+//# sourceMappingURL=deploy-app.js.map

package/deploy-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-app.js","sourceRoot":"","sources":["../src/deploy-app.ts"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,14 @@
+import { UpdatableConfig } from './types/config';
+export * from './account';
+export * from './amount';
+export * from './app';
+export * from './application-client';
+export * from './deploy-app';
+export * from './indexer-lookup';
+export * from './localnet';
+export * from './network-client';
+export * from './transaction';
+export * from './transfer';
+/** The AlgoKit config. To update it use the configure method. */
+export declare const Config: UpdatableConfig;
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,OAAO,CAAA;AACrB,cAAc,sBAAsB,CAAA;AACpC,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAE1B,iEAAiE;AACjE,eAAO,MAAM,MAAM,iBAAwB,CAAA"}

package/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+const config_1 = require("./types/config");
+__exportStar(require("./account"), exports);
+__exportStar(require("./amount"), exports);
+__exportStar(require("./app"), exports);
+__exportStar(require("./application-client"), exports);
+__exportStar(require("./deploy-app"), exports);
+__exportStar(require("./indexer-lookup"), exports);
+__exportStar(require("./localnet"), exports);
+__exportStar(require("./network-client"), exports);
+__exportStar(require("./transaction"), exports);
+__exportStar(require("./transfer"), exports);
+/** The AlgoKit config. To update it use the configure method. */
+exports.Config = new config_1.UpdatableConfig();
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAgD;AAEhD,4CAAyB;AACzB,2CAAwB;AACxB,wCAAqB;AACrB,uDAAoC;AACpC,+CAA4B;AAC5B,mDAAgC;AAChC,6CAA0B;AAC1B,mDAAgC;AAChC,gDAA6B;AAC7B,6CAA0B;AAE1B,iEAAiE;AACpD,QAAA,MAAM,GAAG,IAAI,wBAAe,EAAE,CAAA"}

package/indexer-lookup.d.ts

@@ -0,0 +1,31 @@
+import { Indexer } from 'algosdk';
+import SearchForTransactions from 'algosdk/dist/types/client/v2/indexer/searchForTransactions';
+import { ApplicationResult, TransactionLookupResult, TransactionSearchResults } from './types/indexer';
+/**
+ * Looks up a transaction by ID using Indexer.
+ * @param indexer An indexer client
+ * @param transactionId The ID of the transaction to look up
+ * @returns The result of the look-up
+ */
+export declare function lookupTransactionById(transactionId: string, indexer: Indexer): Promise<TransactionLookupResult>;
+/**
+ * Looks up applications that were created by the given address.
+ * @param indexer An indexer instance
+ * @param address The address of the creator to look up
+ * @param getAll Whether or not to include deleted applications
+ * @param paginationLimit The number of records to return per paginated request, default @see {DEFAULT_INDEXER_MAX_API_RESOURCES_PER_ACCOUNT}
+ * @returns The list of application results
+ */
+export declare function lookupAccountCreatedApplicationByAddress(indexer: Indexer, address: string, getAll?: boolean | undefined, paginationLimit?: number): Promise<ApplicationResult[]>;
+/**
+ * Allows transactions to be searched for the given criteria.
+ * @param indexer An indexer client
+ * @param searchCriteria The criteria to search for
+ * @param paginationLimit The number of records to return per paginated request, default @see {DEFAULT_INDEXER_MAX_API_RESOURCES_PER_ACCOUNT}
+ * @returns The search results
+ */
+export declare function searchTransactions(indexer: Indexer, searchCriteria: (s: SearchForTransactions) => SearchForTransactions, paginationLimit?: number): Promise<TransactionSearchResults>;
+export declare function executePaginatedRequest<TResult, TRequest extends {
+    do: () => Promise<any>;
+}>(extractItems: (response: any) => TResult[], buildRequest: (nextToken?: string) => TRequest): Promise<TResult[]>;
+//# sourceMappingURL=indexer-lookup.d.ts.map

package/indexer-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer-lookup.d.ts","sourceRoot":"","sources":["../src/indexer-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,qBAAqB,MAAM,4DAA4D,CAAA;AAC9F,OAAO,EAAkC,iBAAiB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AAItI;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAErH;AAED;;;;;;;GAOG;AACH,wBAAsB,wCAAwC,CAC5D,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,OAAO,GAAG,SAAqB,EACvC,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmB9B;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,qBAAqB,EACnE,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,wBAAwB,CAAC,CA0BnC;AAID,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,QAAQ,SAAS;IAAE,EAAE,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAA;CAAE,EAEhG,YAAY,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,OAAO,EAAE,EAC1C,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,QAAQ,GAC7C,OAAO,CAAC,OAAO,EAAE,CAAC,CAoBpB"}