@algorandfoundation/algokit-utils 1.0.0-beta.8 → 1.0.0-beta.9

package/app.js

@@ -0,0 +1,265 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileTeal = exports.getAppByIndex = exports.getAppArgsForTransaction = exports.getABIReturn = exports.callApp = exports.updateApp = exports.createApp = exports.ABI_RETURN_PREFIX = exports.APP_PAGE_MAX_SIZE = void 0;
+const algosdk_1 = __importStar(require("algosdk"));
+const buffer_1 = require("buffer");
+const config_1 = require("./config");
+const transaction_1 = require("./transaction");
+/** The maximum number of bytes in an app code page */
+exports.APP_PAGE_MAX_SIZE = 2048;
+/** First 4 bytes of SHA-512/256 hash of "return" */
+exports.ABI_RETURN_PREFIX = new Uint8Array([21, 31, 124, 117]);
+/**
+ * Creates a smart contract app, returns the details of the created app.
+ * @param create The parameters to create the app with
+ * @param algod An algod client
+ * @returns The details of the created app, or the transaction to create it if `skipSending`
+ */
+async function createApp(create, algod) {
+    const { from, approvalProgram: approval, clearStateProgram: clear, schema, note, transactionParams, args, ...sendParams } = create;
+    const approvalProgram = typeof approval === 'string' ? (await compileTeal(approval, algod)).compiledBase64ToBytes : approval;
+    const clearProgram = typeof clear === 'string' ? (await compileTeal(clear, algod)).compiledBase64ToBytes : clear;
+    const transaction = algosdk_1.default.makeApplicationCreateTxnFromObject({
+        approvalProgram: approvalProgram,
+        clearProgram: clearProgram,
+        numLocalInts: schema.localInts,
+        numLocalByteSlices: schema.localByteSlices,
+        numGlobalInts: schema.globalInts,
+        numGlobalByteSlices: schema.globalByteSlices,
+        extraPages: schema.extraPages ?? Math.floor((approvalProgram.length + clearProgram.length) / exports.APP_PAGE_MAX_SIZE),
+        onComplete: algosdk_1.default.OnApplicationComplete.NoOpOC,
+        suggestedParams: await (0, transaction_1.getTransactionParams)(transactionParams, algod),
+        from: (0, transaction_1.getSenderAddress)(from),
+        note: (0, transaction_1.encodeTransactionNote)(note),
+        ...getAppArgsForTransaction(args),
+        rekeyTo: undefined,
+    });
+    const { confirmation } = await (0, transaction_1.sendTransaction)({ transaction, from, sendParams }, algod);
+    if (confirmation) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const appIndex = confirmation['application-index'];
+        config_1.AlgoKitConfig.getLogger(sendParams.suppressLog).debug(`Created app ${appIndex} from creator ${(0, transaction_1.getSenderAddress)(from)}`);
+        return {
+            transaction,
+            confirmation,
+            appIndex,
+            appAddress: algosdk_1.default.getApplicationAddress(appIndex),
+            return: getABIReturn(args, confirmation),
+        };
+    }
+    else {
+        return { transaction, appIndex: 0, appAddress: '' };
+    }
+}
+exports.createApp = createApp;
+/**
+ * Updates a smart contract app.
+ * @param update The parameters to update the app with
+ * @param algod An algod client
+ * @returns The transaction
+ */
+async function updateApp(update, algod) {
+    const { appIndex, from, approvalProgram: approval, clearStateProgram: clear, note, transactionParams, args, ...sendParams } = update;
+    const approvalProgram = typeof approval === 'string' ? (await compileTeal(approval, algod)).compiledBase64ToBytes : approval;
+    const clearProgram = typeof clear === 'string' ? (await compileTeal(clear, algod)).compiledBase64ToBytes : clear;
+    const transaction = algosdk_1.default.makeApplicationUpdateTxnFromObject({
+        appIndex,
+        approvalProgram: approvalProgram,
+        clearProgram: clearProgram,
+        suggestedParams: await (0, transaction_1.getTransactionParams)(transactionParams, algod),
+        from: (0, transaction_1.getSenderAddress)(from),
+        note: (0, transaction_1.encodeTransactionNote)(note),
+        ...getAppArgsForTransaction(args),
+        rekeyTo: undefined,
+    });
+    config_1.AlgoKitConfig.getLogger(sendParams.suppressLog).debug(`Updating app ${appIndex}`);
+    const result = await (0, transaction_1.sendTransaction)({ transaction, from, sendParams }, algod);
+    return {
+        ...result,
+        return: getABIReturn(args, result.confirmation),
+    };
+}
+exports.updateApp = updateApp;
+/**
+ * Issues a call to a given app.
+ * @param call The call details.
+ * @param algod An algod client
+ * @returns The result of the call
+ */
+async function callApp(call, algod) {
+    const { appIndex, callType, from, args, note, transactionParams, ...sendParams } = call;
+    const appCallParameters = {
+        appIndex: appIndex,
+        from: (0, transaction_1.getSenderAddress)(from),
+        suggestedParams: await (0, transaction_1.getTransactionParams)(transactionParams, algod),
+        ...getAppArgsForTransaction(args),
+        note: (0, transaction_1.encodeTransactionNote)(note),
+        rekeyTo: undefined,
+    };
+    let transaction;
+    switch (callType) {
+        case 'optin':
+            transaction = algosdk_1.default.makeApplicationOptInTxnFromObject(appCallParameters);
+            break;
+        case 'clearstate':
+            transaction = algosdk_1.default.makeApplicationClearStateTxnFromObject(appCallParameters);
+            break;
+        case 'closeout':
+            transaction = algosdk_1.default.makeApplicationCloseOutTxnFromObject(appCallParameters);
+            break;
+        case 'delete':
+            transaction = algosdk_1.default.makeApplicationDeleteTxnFromObject(appCallParameters);
+            break;
+        case 'normal':
+            transaction = algosdk_1.default.makeApplicationNoOpTxnFromObject(appCallParameters);
+            break;
+    }
+    const result = await (0, transaction_1.sendTransaction)({ transaction, from, sendParams }, algod);
+    return {
+        ...result,
+        return: getABIReturn(args, result.confirmation),
+    };
+}
+exports.callApp = callApp;
+function getABIReturn(args, confirmation) {
+    try {
+        if (!args || !('method' in args)) {
+            return undefined;
+        }
+        const method = 'txnCount' in args.method ? args.method : new algosdk_1.ABIMethod(args.method);
+        if (method.returns.type !== 'void' && confirmation) {
+            const logs = confirmation.logs || [];
+            if (logs.length === 0) {
+                throw new Error('App call transaction did not log a return value');
+            }
+            const lastLog = logs[logs.length - 1];
+            if (lastLog.byteLength < 4 || lastLog.slice(0, 4).toString() !== exports.ABI_RETURN_PREFIX.toString()) {
+                throw new Error('App call transaction did not log a return value (ABI_RETURN_PREFIX not found)');
+            }
+            return {
+                rawReturnValue: new Uint8Array(lastLog.slice(4)),
+                returnValue: method.returns.type.decode(new Uint8Array(lastLog.slice(4))),
+                decodeError: undefined,
+            };
+        }
+    }
+    catch (e) {
+        return {
+            rawReturnValue: undefined,
+            returnValue: undefined,
+            decodeError: e,
+        };
+    }
+    return undefined;
+}
+exports.getABIReturn = getABIReturn;
+/** Returns the app args ready to load onto an app @see {Transaction} object */
+function getAppArgsForTransaction(args) {
+    if (!args)
+        return undefined;
+    let actualArgs;
+    if ('method' in args) {
+        // todo: Land a change to algosdk that extract the logic from ATC, because (fair warning) this is a HACK
+        // I don't want to have to rewrite all of the ABI resolution logic so using an ATC temporarily here
+        // and passing stuff in to keep it happy like a randomly generated account :O
+        // Most of these values aren't being used since the transaction is discarded
+        const dummyAtc = new algosdk_1.AtomicTransactionComposer();
+        const dummyAccount = algosdk_1.default.generateAccount();
+        const dummyAppId = 1;
+        const dummyParams = {
+            fee: 1,
+            firstRound: 1,
+            genesisHash: buffer_1.Buffer.from('abcd', 'utf-8').toString('base64'),
+            genesisID: 'a',
+            lastRound: 1,
+        };
+        const dummyOnComplete = algosdk_1.OnApplicationComplete.NoOpOC;
+        dummyAtc.addMethodCall({
+            method: 'txnCount' in args.method ? args.method : new algosdk_1.ABIMethod(args.method),
+            methodArgs: args.args,
+            // Rest are dummy values
+            appID: dummyAppId,
+            sender: dummyAccount.addr,
+            signer: (0, algosdk_1.makeBasicAccountTransactionSigner)(dummyAccount),
+            suggestedParams: dummyParams,
+            onComplete: dummyOnComplete,
+        });
+        const txn = dummyAtc.buildGroup()[0];
+        actualArgs = {
+            accounts: txn.txn.appAccounts,
+            appArgs: txn.txn.appArgs,
+            apps: txn.txn.appForeignApps,
+            assets: txn.txn.appForeignAssets,
+            boxes: txn.txn.boxes,
+            lease: args.lease,
+        };
+    }
+    else {
+        actualArgs = args;
+    }
+    const encoder = new TextEncoder();
+    return {
+        accounts: actualArgs?.accounts?.map((a) => (typeof a === 'string' ? a : algosdk_1.default.encodeAddress(a.publicKey))),
+        appArgs: actualArgs?.appArgs?.map((a) => (typeof a === 'string' ? encoder.encode(a) : a)),
+        boxes: actualArgs?.boxes?.map((ref) => ({
+            appIndex: ref.appIndex,
+            name: typeof ref.name === 'string' ? encoder.encode(ref.name) : ref.name,
+        })),
+        foreignApps: actualArgs?.apps,
+        foreignAssets: actualArgs?.assets,
+        lease: typeof actualArgs?.lease === 'string' ? encoder.encode(actualArgs?.lease) : actualArgs?.lease,
+    };
+}
+exports.getAppArgsForTransaction = getAppArgsForTransaction;
+/**
+ * Gets the current data for the given app from algod.
+ *
+ * @param appIndex The index of the app
+ * @param algod An algod client
+ * @returns The data about the app
+ */
+async function getAppByIndex(appIndex, algod) {
+    return (await algod.getApplicationByID(appIndex).do());
+}
+exports.getAppByIndex = getAppByIndex;
+/**
+ * Compiles the given TEAL using algod and returns the result.
+ *
+ * @param algod An algod client
+ * @param tealCode The TEAL code
+ * @returns The information about the compiled file
+ */
+async function compileTeal(tealCode, algod) {
+    const compiled = await algod.compile(tealCode).do();
+    return {
+        teal: tealCode,
+        compiled: compiled.result,
+        compiledHash: compiled.hash,
+        compiledBase64ToBytes: new Uint8Array(buffer_1.Buffer.from(compiled.result, 'base64')),
+    };
+}
+exports.compileTeal = compileTeal;
+//# sourceMappingURL=app.js.map

package/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAYgB;AAChB,mCAA+B;AAC/B,qCAAwC;AACxC,+CASsB;AAGtB,sDAAsD;AACzC,QAAA,iBAAiB,GAAG,IAAI,CAAA;AACrC,oDAAoD;AACvC,QAAA,iBAAiB,GAAG,IAAI,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAkJnE;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,MAAuB,EAAE,KAAc;IACrE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAA;IAElI,MAAM,eAAe,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC5H,MAAM,YAAY,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAA;IAEhH,MAAM,WAAW,GAAG,iBAAO,CAAC,kCAAkC,CAAC;QAC7D,eAAe,EAAE,eAAe;QAChC,YAAY,EAAE,YAAY;QAC1B,YAAY,EAAE,MAAM,CAAC,SAAS;QAC9B,kBAAkB,EAAE,MAAM,CAAC,eAAe;QAC1C,aAAa,EAAE,MAAM,CAAC,UAAU;QAChC,mBAAmB,EAAE,MAAM,CAAC,gBAAgB;QAC5C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,yBAAiB,CAAC;QAC/G,UAAU,EAAE,iBAAO,CAAC,qBAAqB,CAAC,MAAM;QAChD,eAAe,EAAE,MAAM,IAAA,kCAAoB,EAAC,iBAAiB,EAAE,KAAK,CAAC;QACrE,IAAI,EAAE,IAAA,8BAAgB,EAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,IAAA,mCAAqB,EAAC,IAAI,CAAC;QACjC,GAAG,wBAAwB,CAAC,IAAI,CAAC;QACjC,OAAO,EAAE,SAAS;KACnB,CAAC,CAAA;IAEF,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAA,6BAAe,EAAC,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAA;IACxF,IAAI,YAAY,EAAE;QAChB,oEAAoE;QACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,mBAAmB,CAAE,CAAA;QAEnD,sBAAa,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,eAAe,QAAQ,iBAAiB,IAAA,8BAAgB,EAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAEvH,OAAO;YACL,WAAW;YACX,YAAY;YACZ,QAAQ;YACR,UAAU,EAAE,iBAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC;YACnD,MAAM,EAAE,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC;SACzC,CAAA;KACF;SAAM;QACL,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAA;KACpD;AACH,CAAC;AAvCD,8BAuCC;AAED;;;;;GAKG;AACI,KAAK,UAAU,SAAS,CAAC,MAAuB,EAAE,KAAc;IACrE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAA;IAEpI,MAAM,eAAe,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,QAAQ,CAAA;IAC5H,MAAM,YAAY,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAA;IAEhH,MAAM,WAAW,GAAG,iBAAO,CAAC,kCAAkC,CAAC;QAC7D,QAAQ;QACR,eAAe,EAAE,eAAe;QAChC,YAAY,EAAE,YAAY;QAC1B,eAAe,EAAE,MAAM,IAAA,kCAAoB,EAAC,iBAAiB,EAAE,KAAK,CAAC;QACrE,IAAI,EAAE,IAAA,8BAAgB,EAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,IAAA,mCAAqB,EAAC,IAAI,CAAC;QACjC,GAAG,wBAAwB,CAAC,IAAI,CAAC;QACjC,OAAO,EAAE,SAAS;KACnB,CAAC,CAAA;IAEF,sBAAa,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAA;IAEjF,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAe,EAAC,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAA;IAE9E,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC;KAChD,CAAA;AACH,CAAC;AAzBD,8BAyBC;AAED;;;;;GAKG;AACI,KAAK,UAAU,OAAO,CAAC,IAAmB,EAAE,KAAc;IAC/D,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,UAAU,EAAE,GAAG,IAAI,CAAA;IAEvF,MAAM,iBAAiB,GAAG;QACxB,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,IAAA,8BAAgB,EAAC,IAAI,CAAC;QAC5B,eAAe,EAAE,MAAM,IAAA,kCAAoB,EAAC,iBAAiB,EAAE,KAAK,CAAC;QACrE,GAAG,wBAAwB,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,IAAA,mCAAqB,EAAC,IAAI,CAAC;QACjC,OAAO,EAAE,SAAS;KACnB,CAAA;IAED,IAAI,WAAwB,CAAA;IAC5B,QAAQ,QAAQ,EAAE;QAChB,KAAK,OAAO;YACV,WAAW,GAAG,iBAAO,CAAC,iCAAiC,CAAC,iBAAiB,CAAC,CAAA;YAC1E,MAAK;QACP,KAAK,YAAY;YACf,WAAW,GAAG,iBAAO,CAAC,sCAAsC,CAAC,iBAAiB,CAAC,CAAA;YAC/E,MAAK;QACP,KAAK,UAAU;YACb,WAAW,GAAG,iBAAO,CAAC,oCAAoC,CAAC,iBAAiB,CAAC,CAAA;YAC7E,MAAK;QACP,KAAK,QAAQ;YACX,WAAW,GAAG,iBAAO,CAAC,kCAAkC,CAAC,iBAAiB,CAAC,CAAA;YAC3E,MAAK;QACP,KAAK,QAAQ;YACX,WAAW,GAAG,iBAAO,CAAC,gCAAgC,CAAC,iBAAiB,CAAC,CAAA;YACzE,MAAK;KACR;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAe,EAAC,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,CAAC,CAAA;IAE9E,OAAO;QACL,GAAG,MAAM;QACT,MAAM,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC;KAChD,CAAA;AACH,CAAC;AArCD,0BAqCC;AAED,SAAgB,YAAY,CAAC,IAAkB,EAAE,YAAyC;IACxF,IAAI;QACF,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE;YAChC,OAAO,SAAS,CAAA;SACjB;QACD,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,mBAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACnF,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,YAAY,EAAE;YAClD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,IAAI,EAAE,CAAA;YACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;gBACrB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;aACnE;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;YACrC,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,yBAAiB,CAAC,QAAQ,EAAE,EAAE;gBAC7F,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;aACjG;YACD,OAAO;gBACL,cAAc,EAAE,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAChD,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzE,WAAW,EAAE,SAAS;aACvB,CAAA;SACF;KACF;IAAC,OAAO,CAAC,EAAE;QACV,OAAO;YACL,cAAc,EAAE,SAAS;YACzB,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,CAAU;SACxB,CAAA;KACF;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AA7BD,oCA6BC;AAED,+EAA+E;AAC/E,SAAgB,wBAAwB,CAAC,IAAkB;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAA;IAE3B,IAAI,UAAuB,CAAA;IAC3B,IAAI,QAAQ,IAAI,IAAI,EAAE;QACpB,wGAAwG;QACxG,mGAAmG;QACnG,6EAA6E;QAC7E,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,IAAI,mCAAyB,EAAE,CAAA;QAChD,MAAM,YAAY,GAAG,iBAAO,CAAC,eAAe,EAAE,CAAA;QAC9C,MAAM,UAAU,GAAG,CAAC,CAAA;QACpB,MAAM,WAAW,GAAG;YAClB,GAAG,EAAE,CAAC;YACN,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,eAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5D,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,CAAC;SACb,CAAA;QACD,MAAM,eAAe,GAAG,+BAAqB,CAAC,MAAM,CAAA;QACpD,QAAQ,CAAC,aAAa,CAAC;YACrB,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,mBAAS,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5E,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,wBAAwB;YACxB,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,YAAY,CAAC,IAAI;YACzB,MAAM,EAAE,IAAA,2CAAiC,EAAC,YAAY,CAAC;YACvD,eAAe,EAAE,WAAW;YAC5B,UAAU,EAAE,eAAe;SAC5B,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAA;QACpC,UAAU,GAAG;YACX,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW;YAC7B,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO;YACxB,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc;YAC5B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,gBAAgB;YAChC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAA;KACF;SAAM;QACL,UAAU,GAAG,IAAI,CAAA;KAClB;IAED,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,OAAO;QACL,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5G,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAC3B,CAAC,GAAG,EAAE,EAAE,CACN,CAAC;YACC,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,IAAI,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;SAChD,CAAA,CAC7B;QACD,WAAW,EAAE,UAAU,EAAE,IAAI;QAC7B,aAAa,EAAE,UAAU,EAAE,MAAM;QACjC,KAAK,EAAE,OAAO,UAAU,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,KAAK;KACrG,CAAA;AACH,CAAC;AA1DD,4DA0DC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc;IAClE,OAAO,CAAC,MAAM,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAwB,CAAA;AAC/E,CAAC;AAFD,sCAEC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,KAAc;IAChE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAA;IACnD,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,YAAY,EAAE,QAAQ,CAAC,IAAI;QAC3B,qBAAqB,EAAE,IAAI,UAAU,CAAC,eAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;KAC9E,CAAA;AACH,CAAC;AARD,kCAQC"}

package/application-client.d.ts

@@ -0,0 +1,113 @@
+import { ABIArgument, ABIMethodParams, Algodv2, Indexer, SuggestedParams } from 'algosdk';
+import { AppCallArgs, AppReference, RawAppCallArgs } from './app';
+import { AppLookup, AppMetadata, OnSchemaBreak, OnUpdate, TealTemplateParameters } from './deploy-app';
+import { SendTransactionFrom, SendTransactionParams, TransactionNote } from './transaction';
+import { AppSpec } from './types/appspec';
+export declare class ApplicationClient {
+    private algod;
+    private indexer;
+    private appSpec;
+    private sender;
+    private params;
+    private existingDeployments;
+    private _appIndex;
+    private _appAddress;
+    private _creator;
+    constructor(appDetails: {
+        /** The ARC-0032 application spec as either:
+         *  * Parsed JSON @see {AppSpec}
+         *  * Raw JSON string
+         */
+        app: AppSpec | string;
+        /** Default sender to use for transactions issued by this application client */
+        sender?: SendTransactionFrom;
+        /** Default suggested params object to use */
+        params?: SuggestedParams;
+    } & ({
+        /** The index of an existing app to call using this client */
+        index: number;
+    } | {
+        /** The address of the app creator account */
+        creatorAddress: string;
+        /** Optional cached value of the existing apps for the given creator */
+        existingDeployments?: AppLookup;
+    }), algod: Algodv2, indexer: Indexer);
+    /**
+     * 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:** 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 deploy Deployment details
+     * @returns The metadata and transaction result(s) of the deployment, or just the metadata if it didn't need to issue transactions
+     */
+    deploy(deploy: {
+        /** The version of the contract, e.g. "1.0" */
+        version: string;
+        /** The optional sender to send the transaction from, will use the application client's default sender by default if specified */
+        sender?: SendTransactionFrom;
+        /** Whether or not to allow updates in the contract using the deploy-time updatability control if present in your contract.
+         * If this is not specified then it will automatically be determined based on the AppSpec definition
+         **/
+        allowUpdate?: boolean;
+        /** Whether or not to allow deletes in the contract using the deploy-time deletability control if present in your contract.
+         * If this is not specified then it will automatically be determined based on the AppSpec definition
+         **/
+        allowDelete?: boolean;
+        /** Parameters to control transaction sending */
+        sendParams?: Omit<SendTransactionParams, 'args' | 'skipSending' | 'skipWaiting'>;
+        /** Any deploy-time parameters to replace in the TEAL code */
+        deployTimeParameters?: TealTemplateParameters;
+        /** What action to perform if a schema break is detected */
+        onSchemaBreak?: 'replace' | 'fail' | OnSchemaBreak;
+        /** What action to perform if a TEAL update is detected */
+        onUpdate?: 'update' | 'replace' | 'fail' | OnUpdate;
+        /** Any args to pass to any create transaction that is issued as part of deployment */
+        createArgs?: AppCallArgs;
+        /** Any args to pass to any update transaction that is issued as part of deployment */
+        updateArgs?: AppCallArgs;
+        /** Any args to pass to any delete transaction that is issued as part of deployment */
+        deleteArgs?: AppCallArgs;
+    }): Promise<(import("./transaction").SendTransactionResult & AppMetadata & {
+        operationPerformed: "update" | "create";
+    }) | (import("./transaction").SendTransactionResult & AppMetadata & {
+        deleteResult?: import("./transaction").SendTransactionResult | undefined;
+        operationPerformed: "replace";
+    }) | (AppMetadata & {
+        operationPerformed: "none";
+    })>;
+    create(create?: {
+        sender?: SendTransactionFrom;
+        args?: AppCallArgs;
+        note?: TransactionNote;
+        sendParams?: SendTransactionParams;
+        deployTimeParameters?: TealTemplateParameters;
+    }): Promise<import("./app").AppCallTransactionResult & AppReference>;
+    update(update?: {
+        sender?: SendTransactionFrom;
+        args?: AppCallArgs;
+        note?: TransactionNote;
+        sendParams?: SendTransactionParams;
+        deployTimeParameters?: TealTemplateParameters;
+    }): Promise<import("./app").AppCallTransactionResult>;
+    call(call: {
+        callType: 'optin' | 'closeout' | 'clearstate' | 'delete' | 'normal';
+        sender?: SendTransactionFrom;
+        note?: TransactionNote;
+        sendParams?: SendTransactionParams;
+    } & ({
+        /** If calling an ABI method then either the name of the method, or the ABI signature, if undefined then a bare call will be made */
+        method: string;
+        /** The ABI args to pass in */
+        methodArgs: ABIArgument[];
+        /** The optional lease for the transaction */
+        lease?: string | Uint8Array;
+    } | {
+        args: RawAppCallArgs;
+    })): Promise<import("./app").AppCallTransactionResult>;
+    getABIMethod(method: string): ABIMethodParams | undefined;
+    private loadAppReference;
+}
+//# sourceMappingURL=application-client.d.ts.map

package/application-client.d.ts.map

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

package/application-client.js

@@ -0,0 +1,258 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationClient = void 0;
+const algosdk_1 = __importStar(require("algosdk"));
+const buffer_1 = require("buffer");
+const app_1 = require("./app");
+const deploy_app_1 = require("./deploy-app");
+const transaction_1 = require("./transaction");
+const appspec_1 = require("./types/appspec");
+class ApplicationClient {
+    constructor(appDetails, algod, indexer) {
+        const { app, sender, params, ...appIdentifier } = appDetails;
+        this.algod = algod;
+        this.indexer = indexer;
+        this.appSpec = typeof app == 'string' ? JSON.parse(app) : app;
+        if ('creatorAddress' in appIdentifier) {
+            this._creator = appIdentifier.creatorAddress;
+            if (appIdentifier.existingDeployments && appIdentifier.existingDeployments.creator !== this._creator) {
+                throw new Error(`Attempt to create application client with invalid existingDeployments against a different creator (${appIdentifier.existingDeployments.creator}) instead of expected creator ${this._creator}`);
+            }
+            this.existingDeployments = appIdentifier.existingDeployments;
+            this._appIndex = 0;
+        }
+        else {
+            if (appIdentifier.index < 0) {
+                throw new Error(`Attempt to create application client with invalid app index of ${appIdentifier.index}`);
+            }
+            this._appIndex = appIdentifier.index;
+        }
+        this._appAddress = algosdk_1.default.getApplicationAddress(this._appIndex);
+        this.sender = sender;
+        this.params = params;
+        // todo: find create, update, delete, etc. methods from app spec
+    }
+    /**
+     * 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:** 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 deploy Deployment details
+     * @returns The metadata and transaction result(s) of the deployment, or just the metadata if it didn't need to issue transactions
+     */
+    async deploy(deploy) {
+        const { sender, version, allowUpdate, allowDelete, sendParams, ...deployArgs } = deploy;
+        if (this._appIndex !== 0) {
+            throw new Error(`Attempt to deploy app which already has an app index of ${this._appIndex}`);
+        }
+        if (!sender && !this.sender) {
+            throw new Error('No sender provided, unable to deploy app');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const from = sender ?? this.sender;
+        if (!this._creator) {
+            throw new Error('Attempt to deploy a contract without having specified a creator');
+        }
+        if (this._creator !== (0, transaction_1.getSenderAddress)(from)) {
+            throw new Error(`Attempt to deploy contract with a sender address (${(0, transaction_1.getSenderAddress)(from)}) that differs from the given creator address for this application client: ${this._creator}`);
+        }
+        const approval = buffer_1.Buffer.from(this.appSpec.source.approval, 'base64').toString('utf-8');
+        const clear = buffer_1.Buffer.from(this.appSpec.source.clear, 'base64').toString('utf-8');
+        await this.loadAppReference();
+        const result = await (0, deploy_app_1.deployApp)({
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            from,
+            approvalProgram: approval,
+            clearStateProgram: clear,
+            metadata: {
+                name: this.appSpec.contract.name,
+                version: version,
+                updatable: allowUpdate ??
+                    ((!this.appSpec.bare_call_config.update_application && this.appSpec.bare_call_config.update_application !== 'NEVER') ||
+                        !!Object.keys(this.appSpec.hints).filter((h) => !this.appSpec.hints[h].call_config.update_application && this.appSpec.hints[h].call_config.update_application !== 'NEVER')[0]),
+                deletable: allowDelete ??
+                    ((!this.appSpec.bare_call_config.delete_application && this.appSpec.bare_call_config.delete_application !== 'NEVER') ||
+                        !!Object.keys(this.appSpec.hints).filter((h) => !this.appSpec.hints[h].call_config.delete_application && this.appSpec.hints[h].call_config.delete_application !== 'NEVER')[0]),
+            },
+            schema: {
+                globalByteSlices: this.appSpec.state.global.num_byte_slices,
+                globalInts: this.appSpec.state.global.num_uints,
+                localByteSlices: this.appSpec.state.local.num_byte_slices,
+                localInts: this.appSpec.state.local.num_uints,
+            },
+            transactionParams: this.params,
+            ...(sendParams ?? {}),
+            ...deployArgs,
+            existingDeployments: this.existingDeployments,
+        }, this.algod, this.indexer);
+        // Nothing needed to happen
+        if (!('transaction' in result)) {
+            return result;
+        }
+        if (!this.existingDeployments) {
+            throw new Error('Expected existingDeployments to be present');
+        }
+        const { transaction, confirmation, operationPerformed, ...appMetadata } = result;
+        if ('deleteResult' in appMetadata) {
+            delete appMetadata.deleteResult;
+        }
+        this.existingDeployments = {
+            creator: this.existingDeployments.creator,
+            apps: { ...this.existingDeployments.apps, [this.appSpec.contract.name]: appMetadata },
+        };
+        return result;
+    }
+    async create(create) {
+        const { sender, args, note, sendParams, deployTimeParameters } = create ?? {};
+        // todo: Add deploy-time updatable/etc.
+        if (this._appIndex !== 0) {
+            throw new Error(`Attempt to create app which already has an app index of ${this._appIndex}`);
+        }
+        if (!sender && !this.sender) {
+            throw new Error('No sender provided, unable to create app');
+        }
+        const approval = buffer_1.Buffer.from(this.appSpec.source.approval, 'base64').toString('utf-8');
+        const clear = buffer_1.Buffer.from(this.appSpec.source.clear, 'base64').toString('utf-8');
+        const result = await (0, app_1.createApp)({
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            from: sender ?? this.sender,
+            approvalProgram: (0, deploy_app_1.performTemplateSubstitution)(approval, deployTimeParameters),
+            clearStateProgram: (0, deploy_app_1.performTemplateSubstitution)(clear, deployTimeParameters),
+            schema: {
+                globalByteSlices: this.appSpec.state.global.num_byte_slices,
+                globalInts: this.appSpec.state.global.num_uints,
+                localByteSlices: this.appSpec.state.local.num_byte_slices,
+                localInts: this.appSpec.state.local.num_uints,
+            },
+            args: args,
+            note: note,
+            transactionParams: this.params,
+            ...(sendParams ?? {}),
+        }, this.algod);
+        if (result.confirmation) {
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            this._appIndex = result.confirmation['application-index'];
+            this._appAddress = (0, algosdk_1.getApplicationAddress)(this._appIndex);
+        }
+        return result;
+    }
+    async update(update) {
+        const { sender, args, note, sendParams, deployTimeParameters } = update ?? {};
+        if (this._appIndex === 0) {
+            throw new Error(`Attempt to update app which doesn't have an app index defined`);
+        }
+        if (!sender && !this.sender) {
+            throw new Error('No sender provided, unable to create app');
+        }
+        const approval = buffer_1.Buffer.from(this.appSpec.source.approval, 'base64').toString('utf-8');
+        const clear = buffer_1.Buffer.from(this.appSpec.source.clear, 'base64').toString('utf-8');
+        const result = await (0, app_1.updateApp)({
+            appIndex: this._appIndex,
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            from: sender ?? this.sender,
+            approvalProgram: (0, deploy_app_1.performTemplateSubstitution)(approval, deployTimeParameters),
+            clearStateProgram: (0, deploy_app_1.performTemplateSubstitution)(clear, deployTimeParameters),
+            args: args,
+            note: note,
+            transactionParams: this.params,
+            ...(sendParams ?? {}),
+        }, this.algod);
+        return result;
+    }
+    async call(call) {
+        const { sender, callType, note, sendParams, ...args } = call;
+        if (!sender && !this.sender) {
+            throw new Error('No sender provided, unable to call app');
+        }
+        const appMetadata = await this.loadAppReference();
+        if (appMetadata.appIndex === 0) {
+            throw new Error(`Attempt to call an app that can't be found '${this.appSpec.contract.name}' for creator '${this._creator}'.`);
+        }
+        // todo: use this in create et. al. as well
+        let callArgs;
+        // ABI call
+        if ('method' in args) {
+            const abiMethod = this.getABIMethod(args.method);
+            if (!abiMethod) {
+                throw new Error(`Attempt to call ABI method ${args.method}, but it wasn't found`);
+            }
+            callArgs = {
+                method: abiMethod,
+                args: args.methodArgs,
+                lease: args.lease,
+            };
+        }
+        else {
+            callArgs = args.args;
+        }
+        // todo: process ABI args as needed to make them nicer to deal with like beaker-ts???
+        // todo: support unwrapping a logic error?
+        return (0, app_1.callApp)({
+            appIndex: appMetadata.appIndex,
+            callType: callType,
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            from: sender ?? this.sender,
+            args: callArgs,
+            note: note,
+            transactionParams: this.params,
+            ...(sendParams ?? {}),
+        }, this.algod);
+    }
+    getABIMethod(method) {
+        if (!method.includes('(')) {
+            const methods = this.appSpec.contract.methods.filter((m) => m.name === method);
+            if (methods.length > 1) {
+                throw new Error(`Received a call to method ${method} in contract ${this.appSpec.contract.name}, but this resolved to multiple methods; please pass in an ABI signature instead: ${methods.map(appspec_1.getABISignature).join(', ')}`);
+            }
+            return methods[0];
+        }
+        return this.appSpec.contract.methods.find((m) => (0, appspec_1.getABISignature)(m) === method);
+    }
+    async loadAppReference() {
+        if (!this.existingDeployments && this._creator) {
+            this.existingDeployments = await (0, deploy_app_1.getCreatorAppsByName)(this._creator, this.indexer);
+        }
+        if (this.existingDeployments && this._appIndex === 0) {
+            const app = this.existingDeployments.apps[this.appSpec.contract.name];
+            if (!app) {
+                return {
+                    appIndex: 0,
+                    appAddress: (0, algosdk_1.getApplicationAddress)(0),
+                };
+            }
+            return app;
+        }
+        return {
+            appIndex: this._appIndex,
+            appAddress: this._appAddress,
+        };
+    }
+}
+exports.ApplicationClient = ApplicationClient;
+//# sourceMappingURL=application-client.js.map