@algorandfoundation/algokit-utils 7.0.0-beta.1 → 7.0.0-beta.3

package/types/app-deployer.mjs

@@ -0,0 +1,352 @@
+import algosdk from 'algosdk';
+import { Config } from '../config.mjs';
+import { lookupAccountCreatedApplicationByAddress, searchTransactions } from '../indexer-lookup.mjs';
+import { APP_DEPLOY_NOTE_DAPP, OnSchemaBreak, OnUpdate } from './app.mjs';
+import AlgoKitComposer from './composer.mjs';
+
+/** Allows management of deployment and deployment metadata of applications. */
+class AppDeployer {
+    /**
+     * Creates an `AppManager`
+     * @param appManager An `AppManager` instance
+     * @param transactionSender An `AlgorandClientTransactionSender` instance
+     * @param indexer An optional indexer instance; supply if you want to indexer to look up app metadata
+     */
+    constructor(appManager, transactionSender, indexer) {
+        this._appLookups = new Map();
+        this._appManager = appManager;
+        this._transactionSender = transactionSender;
+        this._indexer = indexer;
+    }
+    /**
+     * Idempotently deploy (create if not exists, update if changed) an app against the given name for the given creator account, including deploy-time TEAL template placeholder substitutions (if specified).
+     *
+     * To understand the architecture decisions behind this functionality please see https://github.com/algorandfoundation/algokit-cli/blob/main/docs/architecture-decisions/2023-01-12_smart-contract-deployment.md
+     *
+     * **Note:** When using the return from this function be sure to check `operationPerformed` to get access to various return properties like `transaction`, `confirmation` and `deleteResult`.
+     *
+     * **Note:** if there is a breaking state schema change to an existing app (and `onSchemaBreak` is set to `'replace'`) the existing app will be deleted and re-created.
+     *
+     * **Note:** if there is an update (different TEAL code) to an existing app (and `onUpdate` is set to `'replace'`) the existing app will be deleted and re-created.
+     * @param deployment The arguments to control the app deployment
+     * @returns The app reference of the new/existing app
+     */
+    async deploy(deployment) {
+        const { metadata, deployTimeParams, onSchemaBreak, onUpdate, createParams, updateParams, deleteParams, executeParams, existingDeployments, ignoreCache, } = deployment;
+        // Set creation note
+        createParams.note = updateParams.note = AlgoKitComposer.arc2Note({
+            dAppName: APP_DEPLOY_NOTE_DAPP,
+            data: metadata,
+            format: 'j',
+        });
+        // Check for required fields
+        if (existingDeployments && existingDeployments.creator !== createParams.sender) {
+            throw new Error(`Received invalid existingDeployments value for creator ${existingDeployments.creator} when attempting to deploy for creator ${createParams.sender}`);
+        }
+        if (!existingDeployments && !this._indexer) {
+            throw new Error(`Didn't receive an indexer client when this AppManager was created, but also didn't receive an existingDeployments cache - one of them must be provided`);
+        }
+        Config.getLogger(executeParams?.suppressLog).info(`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'}`);
+        // Compile code if required
+        const compiledApproval = typeof createParams.approvalProgram === 'string'
+            ? await this._appManager.compileTealTemplate(createParams.approvalProgram, deployTimeParams, metadata)
+            : undefined;
+        const approvalProgram = compiledApproval ? compiledApproval.compiledBase64ToBytes : createParams.approvalProgram;
+        const compiledClear = typeof createParams.clearStateProgram === 'string'
+            ? await this._appManager.compileTealTemplate(createParams.clearStateProgram, deployTimeParams)
+            : undefined;
+        const clearStateProgram = compiledClear ? compiledClear.compiledBase64ToBytes : createParams.clearStateProgram;
+        // Define routines for create, update, and replace
+        const createApp = async () => {
+            const result = await ('method' in createParams
+                ? this._transactionSender.appCreateMethodCall({ ...createParams, approvalProgram, clearStateProgram, ...executeParams })
+                : this._transactionSender.appCreate({ ...createParams, approvalProgram, clearStateProgram, ...executeParams }));
+            const appMetadata = {
+                appId: result.appId,
+                appAddress: result.appAddress,
+                ...metadata,
+                createdMetadata: metadata,
+                createdRound: BigInt(result.confirmation.confirmedRound),
+                updatedRound: BigInt(result.confirmation.confirmedRound),
+                deleted: false,
+            };
+            this.updateAppLookup(createParams.sender, appMetadata);
+            return {
+                operationPerformed: 'create',
+                compiledApproval,
+                compiledClear,
+                ...result,
+                ...appMetadata,
+            };
+        };
+        const updateApp = async (existingApp) => {
+            Config.getLogger(executeParams?.suppressLog).info(`Updating existing ${metadata.name} app for ${createParams.sender} to version ${metadata.version}.`);
+            const result = await ('method' in updateParams
+                ? this._transactionSender.appUpdateMethodCall({
+                    appId: existingApp.appId,
+                    approvalProgram,
+                    clearStateProgram,
+                    ...updateParams,
+                    ...executeParams,
+                })
+                : this._transactionSender.appUpdate({
+                    appId: existingApp.appId,
+                    approvalProgram,
+                    clearStateProgram,
+                    ...updateParams,
+                    ...executeParams,
+                }));
+            const appMetadata = {
+                appId: existingApp.appId,
+                appAddress: existingApp.appAddress,
+                createdMetadata: existingApp.createdMetadata,
+                createdRound: existingApp.createdRound,
+                updatedRound: BigInt(result.confirmation.confirmedRound),
+                ...metadata,
+                deleted: false,
+            };
+            this.updateAppLookup(createParams.sender, appMetadata);
+            return {
+                operationPerformed: 'update',
+                compiledApproval,
+                compiledClear,
+                ...result,
+                ...appMetadata,
+            };
+        };
+        const replaceApp = async (existingApp) => {
+            Config.getLogger(executeParams?.suppressLog).info(`Deploying a new ${metadata.name} app for ${createParams.sender}; deploying app with version ${metadata.version}.`);
+            Config.getLogger(executeParams?.suppressLog).warn(`Deleting existing ${metadata.name} app with id ${existingApp.appId} from ${deleteParams.sender} account.`);
+            const composer = this._transactionSender.newGroup();
+            if ('method' in createParams) {
+                composer.addAppCreateMethodCall({ ...createParams, approvalProgram, clearStateProgram });
+            }
+            else {
+                composer.addAppCreate({ ...createParams, approvalProgram, clearStateProgram });
+            }
+            const createIndex = await composer.count();
+            if ('method' in deleteParams) {
+                composer.addAppDeleteMethodCall({ appId: existingApp.appId, ...deleteParams });
+            }
+            else {
+                composer.addAppDelete({ appId: existingApp.appId, ...deleteParams });
+            }
+            const result = await composer.execute({ ...executeParams, suppressLog: true });
+            const confirmation = result.confirmations.at(createIndex - 1);
+            const transaction = result.transactions.at(createIndex - 1);
+            const deleteTransaction = result.transactions.at(-1);
+            Config.getLogger(executeParams?.suppressLog).warn(`Sent transactions ${transaction.txID()} to create app with id ${confirmation.applicationIndex} and ${deleteTransaction.txID()} to delete app with id ${existingApp.appId} from ${createParams.sender} account.`);
+            const appMetadata = {
+                appId: BigInt(confirmation.applicationIndex),
+                appAddress: algosdk.getApplicationAddress(confirmation.applicationIndex),
+                ...metadata,
+                createdMetadata: metadata,
+                createdRound: BigInt(confirmation.confirmedRound),
+                updatedRound: BigInt(confirmation.confirmedRound),
+                deleted: false,
+            };
+            this.updateAppLookup(createParams.sender, appMetadata);
+            return {
+                operationPerformed: 'replace',
+                ...result,
+                compiledApproval,
+                compiledClear,
+                transaction,
+                confirmation,
+                return: 'method' in createParams ? result.returns?.[0] : undefined,
+                deleteReturn: 'method' in deleteParams ? result.returns?.at(-1) : undefined,
+                ...appMetadata,
+                deleteResult: { transaction: deleteTransaction, confirmation: result.confirmations.at(-1) },
+            };
+        };
+        // Lookup existing app metadata
+        const apps = existingDeployments ?? (await this.getCreatorAppsByName(createParams.sender, ignoreCache));
+        const existingApp = apps.apps[metadata.name];
+        if (!existingApp || existingApp.deleted) {
+            Config.getLogger(executeParams?.suppressLog).info(`App ${metadata.name} not found in apps created by ${createParams.sender}; deploying app with version ${metadata.version}.`);
+            return await createApp();
+        }
+        Config.getLogger(executeParams?.suppressLog).info(`Existing app ${metadata.name} found by creator ${createParams.sender}, with app id ${existingApp.appId} and version ${existingApp.version}.`);
+        const existingAppRecord = await this._appManager.getById(existingApp.appId);
+        const existingApproval = Buffer.from(existingAppRecord.approvalProgram).toString('base64');
+        const existingClear = Buffer.from(existingAppRecord.clearStateProgram).toString('base64');
+        const newApproval = Buffer.from(approvalProgram).toString('base64');
+        const newClear = Buffer.from(clearStateProgram).toString('base64');
+        // Check for changes
+        const isUpdate = newApproval !== existingApproval || newClear !== existingClear;
+        const isSchemaBreak = existingAppRecord.localInts < (createParams.schema?.localInts ?? 0) ||
+            existingAppRecord.globalInts < (createParams.schema?.globalInts ?? 0) ||
+            existingAppRecord.localByteSlices < (createParams.schema?.localByteSlices ?? 0) ||
+            existingAppRecord.globalByteSlices < (createParams.schema?.globalByteSlices ?? 0);
+        if (isSchemaBreak) {
+            Config.getLogger(executeParams?.suppressLog).warn(`Detected a breaking app schema change in app ${existingApp.appId}:`, {
+                from: {
+                    globalInts: existingAppRecord.globalInts,
+                    globalByteSlices: existingAppRecord.globalByteSlices,
+                    localInts: existingAppRecord.localInts,
+                    localByteSlices: existingAppRecord.localByteSlices,
+                },
+                to: createParams.schema,
+            });
+            if (onSchemaBreak === undefined || onSchemaBreak === 'fail' || onSchemaBreak === OnSchemaBreak.Fail) {
+                throw new Error('Schema break detected and onSchemaBreak=OnSchemaBreak.Fail, stopping deployment. ' +
+                    'If you want to try deleting and recreating the app then ' +
+                    're-run with onSchemaBreak=OnSchemaBreak.ReplaceApp');
+            }
+            if (onSchemaBreak === 'append' || onSchemaBreak === OnSchemaBreak.AppendApp) {
+                Config.getLogger(executeParams?.suppressLog).info('onSchemaBreak=AppendApp, will attempt to create a new app');
+                return await createApp();
+            }
+            if (existingApp.deletable) {
+                Config.getLogger(executeParams?.suppressLog).info('App is deletable and onSchemaBreak=ReplaceApp, will attempt to create new app and delete old app');
+            }
+            else {
+                Config.getLogger(executeParams?.suppressLog).info('App is not deletable but onSchemaBreak=ReplaceApp, will attempt to delete app, delete will most likely fail');
+            }
+            return await replaceApp(existingApp);
+        }
+        if (isUpdate) {
+            Config.getLogger(executeParams?.suppressLog).info(`Detected a TEAL update in app ${existingApp.appId} for creator ${createParams.sender}`);
+            if (onUpdate === undefined || onUpdate === 'fail' || onUpdate === OnUpdate.Fail) {
+                throw new Error('Update detected and onUpdate=Fail, stopping deployment. Try a different onUpdate value to not fail.');
+            }
+            if (onUpdate === 'append' || onUpdate === OnUpdate.AppendApp) {
+                Config.getLogger(executeParams?.suppressLog).info('onUpdate=AppendApp, will attempt to create a new app');
+                return await createApp();
+            }
+            if (onUpdate === 'update' || onUpdate === OnUpdate.UpdateApp) {
+                if (existingApp.updatable) {
+                    Config.getLogger(executeParams?.suppressLog).info(`App is updatable and onUpdate=UpdateApp, updating app...`);
+                }
+                else {
+                    Config.getLogger(executeParams?.suppressLog).warn(`App is not updatable but onUpdate=UpdateApp, will attempt to update app, update will most likely fail`);
+                }
+                return await updateApp(existingApp);
+            }
+            if (onUpdate === 'replace' || onUpdate === OnUpdate.ReplaceApp) {
+                if (existingApp.deletable) {
+                    Config.getLogger(executeParams?.suppressLog).warn('App is deletable and onUpdate=ReplaceApp, creating new app and deleting old app...');
+                }
+                else {
+                    Config.getLogger(executeParams?.suppressLog).warn('App is not deletable and onUpdate=ReplaceApp, will attempt to create new app and delete old app, delete will most likely fail');
+                }
+                return await replaceApp(existingApp);
+            }
+        }
+        Config.getLogger(executeParams?.suppressLog).debug('No detected changes in app, nothing to do.');
+        return { ...existingApp, operationPerformed: 'nothing' };
+    }
+    updateAppLookup(sender, appMetadata) {
+        const lookup = this._appLookups.get(sender);
+        if (!lookup) {
+            this._appLookups.set(sender, { creator: sender, apps: { [appMetadata.name]: appMetadata } });
+        }
+        else {
+            lookup.apps[appMetadata.name] = appMetadata;
+        }
+    }
+    /**
+     * Returns a lookup of name => app metadata (id, address, ...metadata) for all apps created by the given account that have
+     * an [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) `AppDeployNote` as the transaction
+     * note of the app creation transaction.
+     *
+     * This function caches the result for the given creator account so that subsequent calls will not require an indexer lookup.
+     *
+     * If the `AppManager` instance wasn't created with an indexer client, this function will throw an error.
+     *
+     * @param creatorAddress The address of the account that is the creator of the apps you want to search for
+     * @param ignoreCache Whether ot not to ignore the cache and force a lookup, default: use the cache
+     * @returns A name-based lookup of the app metadata
+     */
+    async getCreatorAppsByName(creatorAddress, ignoreCache) {
+        const appLookup = {};
+        if (!ignoreCache && this._appLookups.has(creatorAddress)) {
+            return this._appLookups.get(creatorAddress);
+        }
+        if (!this._indexer) {
+            throw new Error(`Didn't receive an indexer client when this AppManager was created, but received a call to getCreatorApps`);
+        }
+        // Extract all apps that account created
+        const createdApps = (await lookupAccountCreatedApplicationByAddress(this._indexer, creatorAddress))
+            .map((a) => {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            return { id: BigInt(a.id), createdAtRound: a['created-at-round'], deleted: a.deleted };
+        })
+            .sort((a, b) => a.createdAtRound - b.createdAtRound);
+        // For each app that account created (in parallel)...
+        const apps = 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 searchTransactions(this._indexer, (s) => s
+                .minRound(createdApp.createdAtRound)
+                .txType(algosdk.TransactionType.appl)
+                .applicationID(Number(createdApp.id))
+                .address(creatorAddress)
+                .addressRole('sender')
+                .notePrefix(Buffer.from(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 null;
+            return { createdApp, appCreationTransaction, latestAppUpdateTransaction };
+        }));
+        apps
+            .filter((a) => a !== null)
+            .forEach((a) => {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            const { createdApp, appCreationTransaction, latestAppUpdateTransaction } = a;
+            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_DEPLOY_NOTE_DAPP}:j{`))
+                    // Clearly not APP_DEPLOY JSON; ignoring...
+                    return;
+                return JSON.parse(noteAsString.substring(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: algosdk.getApplicationAddress(createdApp.id),
+                        createdMetadata: creationNote,
+                        createdRound: BigInt(appCreationTransaction['confirmed-round'] ?? 0),
+                        ...(updateNote ?? creationNote),
+                        updatedRound: BigInt(latestAppUpdateTransaction?.['confirmed-round'] ?? 0),
+                        deleted: createdApp.deleted ?? false,
+                    };
+                }
+            }
+            catch (e) {
+                Config.logger.warn(`Received error trying to retrieve app with ${createdApp.id} for creator ${creatorAddress}; failing silently`, e);
+                return;
+            }
+        });
+        const lookup = {
+            creator: creatorAddress,
+            apps: appLookup,
+        };
+        this._appLookups.set(creatorAddress, lookup);
+        return lookup;
+    }
+}
+
+export { AppDeployer };
+//# sourceMappingURL=app-deployer.mjs.map

package/types/app-deployer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-deployer.mjs","sources":["../../src/types/app-deployer.ts"],"sourcesContent":[null],"names":["indexer.lookupAccountCreatedApplicationByAddress","indexer.searchTransactions"],"mappings":"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"}

package/types/app-manager.d.ts

@@ -0,0 +1,235 @@
+import algosdk from 'algosdk';
+import { TransactionSignerAccount } from './account';
+import { BoxName, type ABIReturn, type AppDeployMetadata, type AppState, type CompiledTeal, type TealTemplateParams } from './app';
+import modelsv2 = algosdk.modelsv2;
+/** Information about an app. */
+export interface AppInformation {
+    /** The ID of the app. */
+    appId: bigint;
+    /** The escrow address that the app operates with. */
+    appAddress: string;
+    /**
+     * Approval program.
+     */
+    approvalProgram: Uint8Array;
+    /**
+     * Clear state program.
+     */
+    clearStateProgram: Uint8Array;
+    /**
+     * The address that created this application. This is the address where the
+     * parameters and global state for this application can be found.
+     */
+    creator: string;
+    /**
+     * Current global state values.
+     */
+    globalState: AppState;
+    /** The number of allocated ints in per-user local state. */
+    localInts: number;
+    /** The number of allocated byte slices in per-user local state. */
+    localByteSlices: number;
+    /** The number of allocated ints in global state. */
+    globalInts: number;
+    /** The number of allocated byte slices in global state. */
+    globalByteSlices: number;
+    /** Any extra pages that are needed for the smart contract. */
+    extraProgramPages?: number;
+}
+/**
+ * Something that identifies an app box name - either a:
+ *  * `Uint8Array` (the actual binary of the box name)
+ *  * `string` (that will be encoded to a `Uint8Array`)
+ *  * `TransactionSignerAccount` (that will be encoded into the
+ *    public key address of the corresponding account)
+ */
+export type BoxIdentifier = string | Uint8Array | TransactionSignerAccount;
+/**
+ * A grouping of the app ID and name identifier to reference an app box.
+ */
+export interface BoxReference {
+    /**
+     * A unique application id
+     */
+    appId: bigint;
+    /**
+     * Identifier for a box name
+     */
+    name: BoxIdentifier;
+}
+/**
+ * Parameters to get and decode a box value as an ABI type.
+ */
+export interface BoxValueRequestParams {
+    /** The ID of the app return box names for */
+    appId: bigint;
+    /** The name of the box to return either as a string, binary array or `BoxName` */
+    boxName: BoxIdentifier;
+    /** The ABI type to decode the value using */
+    type: algosdk.ABIType;
+}
+/**
+ * Parameters to get and decode a box value as an ABI type.
+ */
+export interface BoxValuesRequestParams {
+    /** The ID of the app return box names for */
+    appId: bigint;
+    /** The names of the boxes to return either as a string, binary array or BoxName` */
+    boxNames: BoxIdentifier[];
+    /** The ABI type to decode the value using */
+    type: algosdk.ABIType;
+}
+/** Allows management of application information. */
+export declare class AppManager {
+    private _algod;
+    private _compilationResults;
+    /**
+     * Creates an `AppManager`
+     * @param algod An algod instance
+     */
+    constructor(algod: algosdk.Algodv2);
+    /**
+     * Compiles the given TEAL using algod and returns the result, including source map.
+     *
+     * The result of this compilation is also cached keyed by the TEAL
+     *  code so it can be retrieved via `getCompilationResult`.
+     *
+     * This function is re-entrant; it will only compile the same code once.
+     *
+     * @param tealCode The TEAL code
+     * @returns The information about the compiled file
+     */
+    compileTeal(tealCode: string): Promise<CompiledTeal>;
+    /**
+     * Performs template substitution of a teal template and compiles it, returning the compiled result.
+     *
+     * Looks for `TMPL_{parameter}` for template replacements and replaces AlgoKit deploy-time control parameters
+     * if deployment metadata is specified.
+     *
+     * * `TMPL_UPDATABLE` for updatability / immutability control
+     * * `TMPL_DELETABLE` for deletability / permanence control
+     *
+     * @param tealTemplateCode The TEAL logic to compile
+     * @param templateParams 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
+     */
+    compileTealTemplate(tealTemplateCode: string, templateParams?: TealTemplateParams, deploymentMetadata?: AppDeployMetadata): Promise<CompiledTeal>;
+    /**
+     * Returns a previous compilation result.
+     * @param tealCode The TEAL code
+     * @returns The information about the previously compiled file
+     *  or `undefined` if that TEAL code wasn't previously compiled
+     */
+    getCompilationResult(tealCode: string): CompiledTeal | undefined;
+    /**
+     * Returns the current app information for the app with the given ID.
+     *
+     * @example
+     * ```typescript
+     * const appInfo = await appManager.getById(12353n);
+     * ```
+     *
+     * @param appId The ID of the app
+     * @returns The app information
+     */
+    getById(appId: bigint): Promise<AppInformation>;
+    /**
+     * Returns the current local state values for the given app ID and account address
+     *
+     * @param appId The ID of the app to return local state for
+     * @param address The string address of the account to get local state for the given app
+     * @returns The current local state for the given (app, account) combination
+     */
+    getLocalState(appId: bigint, address: string): Promise<AppState>;
+    /**
+     * Returns the names of the current boxes for the given app.
+     * @param appId The ID of the app return box names for
+     * @returns The current box names
+     */
+    getBoxNames(appId: bigint): Promise<BoxName[]>;
+    /**
+     * Returns the value of the given box name for the given app.
+     * @param appId The ID of the app return box names for
+     * @param boxName The name of the box to return either as a string, binary array or `BoxName`
+     * @returns The current box value as a byte array
+     */
+    getBoxValue(appId: bigint, boxName: BoxIdentifier): Promise<Uint8Array>;
+    /**
+     * Returns the value of the given box names for the given app.
+     * @param appId The ID of the app return box names for
+     * @param boxNames The names of the boxes to return either as a string, binary array or `BoxName`
+     * @returns The current box values as a byte array in the same order as the passed in box names
+     */
+    getBoxValues(appId: bigint, boxNames: BoxIdentifier[]): Promise<Uint8Array[]>;
+    /**
+     * Returns the value of the given box name for the given app decoded based on the given ABI type.
+     * @param request The parameters for the box value request
+     * @returns The current box value as an ABI value
+     */
+    getBoxValueFromABIType(request: BoxValueRequestParams): Promise<algosdk.ABIValue>;
+    /**
+     * Returns the value of the given box names for the given app decoded based on the given ABI type.
+     * @param request The parameters for the box value request
+     * @returns The current box values as an ABI value in the same order as the passed in box names
+     */
+    getBoxValuesFromABIType(request: BoxValuesRequestParams): Promise<algosdk.ABIValue[]>;
+    /**
+     * Returns a `algosdk.BoxReference` given a `BoxIdentifier` or `BoxReference`.
+     * @param boxId The box to return a reference for
+     * @returns The box reference ready to pass into a `algosdk.Transaction`
+     */
+    static getBoxReference(boxId: BoxIdentifier | BoxReference): algosdk.BoxReference;
+    /**
+     * Converts an array of global/local state values from the algod api to a more friendly
+     * generic object keyed by the UTF-8 value of the key.
+     * @param state A `global-state`, `local-state`, `global-state-deltas` or `local-state-deltas`
+     * @returns An object keyeed by the UTF-8 representation of the key with various parsings of the values
+     */
+    static decodeAppState(state: {
+        key: string;
+        value: modelsv2.TealValue | modelsv2.EvalDelta;
+    }[]): AppState;
+    /**
+     * Returns any ABI return values for the given app call arguments and transaction confirmation.
+     * @param confirmation The transaction confirmation from algod
+     * @param method The ABI method
+     * @returns The return value for the method call
+     */
+    static getABIReturn(confirmation: modelsv2.PendingTransactionResponse | undefined, method: algosdk.ABIMethod | undefined): ABIReturn | undefined;
+    /**
+     * Replaces AlgoKit deploy-time deployment control parameters within the given TEAL template code.
+     *
+     * * `TMPL_UPDATABLE` for updatability / immutability control
+     * * `TMPL_DELETABLE` for deletability / permanence control
+     *
+     * Note: If these values are defined, but the corresponding `TMPL_*` value
+     *  isn't in the teal code it will throw an exception.
+     *
+     * @param tealTemplateCode The TEAL template code to substitute
+     * @param params The deploy-time deployment control parameter value to replace
+     * @returns The replaced TEAL code
+     */
+    static replaceTealTemplateDeployTimeControlParams(tealTemplateCode: string, params: {
+        updatable?: boolean;
+        deletable?: boolean;
+    }): string;
+    /**
+     * Performs template substitution of a teal file.
+     *
+     * Looks for `TMPL_{parameter}` for template replacements.
+     *
+     * @param tealTemplateCode The TEAL template code to make parameter replacements in
+     * @param templateParams Any parameters to replace in the teal code
+     * @returns The TEAL code with replacements
+     */
+    static replaceTealTemplateParams(tealTemplateCode: string, templateParams?: TealTemplateParams): string;
+    /**
+     * Remove comments from TEAL code (useful to reduce code size before compilation).
+     *
+     * @param tealCode The TEAL logic to strip
+     * @returns The TEAL without comments
+     */
+    static stripTealComments(tealCode: string): string;
+}
+//# sourceMappingURL=app-manager.d.ts.map

package/types/app-manager.d.ts.map

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