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

package/types/application-client.js

@@ -0,0 +1,266 @@
+"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("./appspec");
+class ApplicationClient {
+    /**
+     * Create a new ApplicationClient instance
+     * @param appDetails The details of the app
+     * @param algod An algod instance
+     * @param indexer An indexer instance
+     */
+    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._appId = 0;
+        }
+        else {
+            if (appIdentifier.id < 0) {
+                throw new Error(`Attempt to create application client with invalid app id of ${appIdentifier.id}`);
+            }
+            this._appId = appIdentifier.id;
+        }
+        this._appAddress = algosdk_1.default.getApplicationAddress(this._appId);
+        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._appId !== 0) {
+            throw new Error(`Attempt to deploy app which already has an app id of ${this._appId}`);
+        }
+        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,
+                // todo: intelligent version management
+                version: version ?? '1.0',
+                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 (result.operationPerformed === 'nothing') {
+            return result;
+        }
+        if (!this.existingDeployments) {
+            throw new Error('Expected existingDeployments to be present');
+        }
+        const { transaction, confirmation, operationPerformed, ...appMetadata } = result;
+        // if (operationPerformed === 'replace') {
+        //   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/deletable etc.
+        if (this._appId !== 0) {
+            throw new Error(`Attempt to create app which already has an app id of ${this._appId}`);
+        }
+        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._appId = result.confirmation['application-index'];
+            this._appAddress = (0, algosdk_1.getApplicationAddress)(this._appId);
+        }
+        return result;
+    }
+    async update(update) {
+        const { sender, args, note, sendParams, deployTimeParameters } = update ?? {};
+        if (this._appId === 0) {
+            throw new Error(`Attempt to update app which doesn't have an app id 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)({
+            appId: this._appId,
+            // 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.appId === 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 and source map.
+        // todo: support readonly method calls
+        return (0, app_1.callApp)({
+            appId: appMetadata.appId,
+            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._appId === 0) {
+            const app = this.existingDeployments.apps[this.appSpec.contract.name];
+            if (!app) {
+                return {
+                    appId: 0,
+                    appAddress: (0, algosdk_1.getApplicationAddress)(0),
+                };
+            }
+            return app;
+        }
+        return {
+            appId: this._appId,
+            appAddress: this._appAddress,
+        };
+    }
+}
+exports.ApplicationClient = ApplicationClient;
+//# sourceMappingURL=application-client.js.map

package/types/application-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-client.js","sourceRoot":"","sources":["../../src/types/application-client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mDAAyH;AACzH,mCAA+B;AAC/B,gCAAsD;AACtD,8CAA4F;AAC5F,gDAAiD;AAEjD,uCAAoD;AA2BpD,MAAa,iBAAiB;IAY5B;;;;;OAKG;IACH,YAAY,UAA6B,EAAE,KAAc,EAAE,OAAgB;QACzE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,GAAG,UAAU,CAAA;QAC5D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC,CAAC,CAAC,GAAG,CAAA;QAE1E,IAAI,gBAAgB,IAAI,aAAa,EAAE;YACrC,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC,cAAc,CAAA;YAC5C,IAAI,aAAa,CAAC,mBAAmB,IAAI,aAAa,CAAC,mBAAmB,CAAC,OAAO,KAAK,IAAI,CAAC,QAAQ,EAAE;gBACpG,MAAM,IAAI,KAAK,CACb,sGAAsG,aAAa,CAAC,mBAAmB,CAAC,OAAO,iCAAiC,IAAI,CAAC,QAAQ,EAAE,CAChM,CAAA;aACF;YACD,IAAI,CAAC,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAA;YAC5D,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;SAChB;aAAM;YACL,IAAI,aAAa,CAAC,EAAE,GAAG,CAAC,EAAE;gBACxB,MAAM,IAAI,KAAK,CAAC,+DAA+D,aAAa,CAAC,EAAE,EAAE,CAAC,CAAA;aACnG;YACD,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,EAAE,CAAA;SAC/B;QAED,IAAI,CAAC,WAAW,GAAG,iBAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAEpB,gEAAgE;IAClE,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAC,MA2BZ;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAA;QAEvF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;SACvF;QACD,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;SAC5D;QACD,oEAAoE;QACpE,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,MAAO,CAAA;QAEnC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAA;SACnF;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAA,8BAAgB,EAAC,IAAI,CAAC,EAAE;YAC5C,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAA,8BAAgB,EACnE,IAAI,CACL,8EAA8E,IAAI,CAAC,QAAQ,EAAE,CAC/F,CAAA;SACF;QAED,MAAM,QAAQ,GAAG,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAEhF,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAC5B;YACE,oEAAoE;YACpE,IAAI;YACJ,eAAe,EAAE,QAAQ;YACzB,iBAAiB,EAAE,KAAK;YACxB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAChC,uCAAuC;gBACvC,OAAO,EAAE,OAAO,IAAI,KAAK;gBACzB,SAAS,EACP,WAAW;oBACX,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,KAAK,OAAO,CAAC;wBAClH,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB,KAAK,OAAO,CAC5H,CAAC,CAAC,CAAC,CAAC;gBACT,SAAS,EACP,WAAW;oBACX,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,KAAK,OAAO,CAAC;wBAClH,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,kBAAkB,KAAK,OAAO,CAC5H,CAAC,CAAC,CAAC,CAAC;aACV;YACD,MAAM,EAAE;gBACN,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe;gBAC3D,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS;gBAC/C,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe;gBACzD,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS;aAC9C;YACD,iBAAiB,EAAE,IAAI,CAAC,MAAM;YAC9B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;YACrB,GAAG,UAAU;YACb,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;SAC9C,EACD,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,OAAO,CACb,CAAA;QAED,2BAA2B;QAC3B,IAAI,MAAM,CAAC,kBAAkB,KAAK,SAAS,EAAE;YAC3C,OAAO,MAAM,CAAA;SACd;QAED,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;SAC9D;QACD,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,CAAA;QAChF,0CAA0C;QAC1C,oCAAoC;QACpC,IAAI;QACJ,IAAI,CAAC,mBAAmB,GAAG;YACzB,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO;YACzC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE;SACtF,CAAA;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAMZ;QACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAE7E,iDAAiD;QAEjD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;SACvF;QAED,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;SAC5D;QAED,MAAM,QAAQ,GAAG,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAEhF,MAAM,MAAM,GAAG,MAAM,IAAA,eAAS,EAC5B;YACE,oEAAoE;YACpE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,MAAO;YAC5B,eAAe,EAAE,IAAA,wCAA2B,EAAC,QAAQ,EAAE,oBAAoB,CAAC;YAC5E,iBAAiB,EAAE,IAAA,wCAA2B,EAAC,KAAK,EAAE,oBAAoB,CAAC;YAC3E,MAAM,EAAE;gBACN,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe;gBAC3D,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS;gBAC/C,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe;gBACzD,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS;aAC9C;YACD,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,IAAI;YACV,iBAAiB,EAAE,IAAI,CAAC,MAAM;YAC9B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;SACtB,EACD,IAAI,CAAC,KAAK,CACX,CAAA;QAED,IAAI,MAAM,CAAC,YAAY,EAAE;YACvB,oEAAoE;YACpE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,mBAAmB,CAAE,CAAA;YACvD,IAAI,CAAC,WAAW,GAAG,IAAA,+BAAqB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAA;SACtD;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAMZ;QACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,GAAG,MAAM,IAAI,EAAE,CAAA;QAE7E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAA;SAC9E;QAED,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;SAC5D;QAED,MAAM,QAAQ,GAAG,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QACtF,MAAM,KAAK,GAAG,eAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAEhF,MAAM,MAAM,GAAG,MAAM,IAAA,eAAS,EAC5B;YACE,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,oEAAoE;YACpE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,MAAO;YAC5B,eAAe,EAAE,IAAA,wCAA2B,EAAC,QAAQ,EAAE,oBAAoB,CAAC;YAC5E,iBAAiB,EAAE,IAAA,wCAA2B,EAAC,KAAK,EAAE,oBAAoB,CAAC;YAC3E,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,IAAI;YACV,iBAAiB,EAAE,IAAI,CAAC,MAAM;YAC9B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;SACtB,EACD,IAAI,CAAC,KAAK,CACX,CAAA;QAED,OAAO,MAAM,CAAA;IACf,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAiBC;QAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;QAE5D,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;SAC1D;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACjD,IAAI,WAAW,CAAC,KAAK,KAAK,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,kBAAkB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAA;SAC9H;QAED,2CAA2C;QAC3C,IAAI,QAAqB,CAAA;QACzB,WAAW;QACX,IAAI,QAAQ,IAAI,IAAI,EAAE;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAChD,IAAI,CAAC,SAAS,EAAE;gBACd,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,MAAM,uBAAuB,CAAC,CAAA;aAClF;YACD,QAAQ,GAAG;gBACT,MAAM,EAAE,SAAS;gBACjB,IAAI,EAAE,IAAI,CAAC,UAAU;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAA;SACF;aAAM;YACL,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAA;SAC3B;QAED,kFAAkF;QAClF,yDAAyD;QACzD,sCAAsC;QAEtC,OAAO,IAAA,aAAO,EACZ;YACE,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,QAAQ,EAAE,QAAQ;YAClB,oEAAoE;YACpE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,MAAO;YAC5B,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,IAAI;YACV,iBAAiB,EAAE,IAAI,CAAC,MAAM;YAC9B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;SACtB,EACD,IAAI,CAAC,KAAK,CACX,CAAA;IACH,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAA;YAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;gBACtB,MAAM,IAAI,KAAK,CACb,6BAA6B,MAAM,gBACjC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IACxB,qFAAqF,OAAO,CAAC,GAAG,CAAC,yBAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/H,CAAA;aACF;YACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAA;SAClB;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,yBAAe,EAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAA;IACjF,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC5B,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,QAAQ,EAAE;YAC9C,IAAI,CAAC,mBAAmB,GAAG,MAAM,IAAA,iCAAoB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;SACnF;QAED,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;YACjD,MAAM,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACrE,IAAI,CAAC,GAAG,EAAE;gBACR,OAAO;oBACL,KAAK,EAAE,CAAC;oBACR,UAAU,EAAE,IAAA,+BAAqB,EAAC,CAAC,CAAC;iBACrC,CAAA;aACF;YACD,OAAO,GAAG,CAAA;SACX;QAED,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,UAAU,EAAE,IAAI,CAAC,WAAW;SACb,CAAA;IACnB,CAAC;CACF;AA5WD,8CA4WC"}

package/types/appspec.d.ts

@@ -0,0 +1,77 @@
+import { ABIContractParams, ABIMethod, ABIMethodParams } from 'algosdk';
+export interface AppSpec {
+    hints: HintSpec;
+    schema: SchemaSpec;
+    source: AppSources;
+    contract: ABIContractParams;
+    state: StateSchemaSpec;
+    bare_call_config: {
+        no_op?: CallConfigValue;
+        opt_in?: CallConfigValue;
+        close_out?: CallConfigValue;
+        clear_state?: CallConfigValue;
+        update_application?: CallConfigValue;
+        delete_application?: CallConfigValue;
+    };
+}
+export type HintSpec = Record<string, Hint>;
+export interface AppSources {
+    approval: string;
+    clear: string;
+}
+export type CallConfigValue = 'NEVER' | 'CALL' | 'CREATE' | 'ALL';
+export interface Hint {
+    structs: Record<string, Struct>;
+    readonly: boolean;
+    default_arguments: Record<string, DefaultArgument>;
+    call_config: {
+        no_op?: CallConfigValue;
+        opt_in?: CallConfigValue;
+        close_out?: CallConfigValue;
+        clear_state?: CallConfigValue;
+        update_application?: CallConfigValue;
+        delete_application?: CallConfigValue;
+    };
+}
+export type StructElement = [string, string];
+export interface Struct {
+    name: string;
+    elements: StructElement[];
+}
+export interface DefaultArgument {
+    source: string;
+    data: string | bigint | number;
+}
+export declare enum AVMType {
+    uint64 = 0,
+    bytes = 1
+}
+export interface DeclaredSchemaValueSpec {
+    type: AVMType;
+    key: string;
+    desc: string;
+    static: boolean;
+}
+export interface ReservedSchemaValueSpec {
+    type: AVMType;
+    desc: string;
+    max_keys: number;
+}
+export interface SchemaSpec {
+    local: Schema;
+    global: Schema;
+}
+export interface Schema {
+    declared: Record<string, DeclaredSchemaValueSpec>;
+    reserved: Record<string, ReservedSchemaValueSpec>;
+}
+export interface StateSchemaSpec {
+    global: StateSchema;
+    local: StateSchema;
+}
+export type StateSchema = {
+    num_uints: number;
+    num_byte_slices: number;
+};
+export declare const getABISignature: (method: ABIMethodParams | ABIMethod) => string;
+//# sourceMappingURL=appspec.d.ts.map

package/types/appspec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appspec.d.ts","sourceRoot":"","sources":["../../src/types/appspec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAEvE,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,EAAE,UAAU,CAAA;IAClB,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,KAAK,EAAE,eAAe,CAAA;IACtB,gBAAgB,EAAE;QAChB,KAAK,CAAC,EAAE,eAAe,CAAA;QACvB,MAAM,CAAC,EAAE,eAAe,CAAA;QACxB,SAAS,CAAC,EAAE,eAAe,CAAA;QAC3B,WAAW,CAAC,EAAE,eAAe,CAAA;QAC7B,kBAAkB,CAAC,EAAE,eAAe,CAAA;QACpC,kBAAkB,CAAC,EAAE,eAAe,CAAA;KACrC,CAAA;CACF;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEjE,MAAM,WAAW,IAAI;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAClD,WAAW,EAAE;QACX,KAAK,CAAC,EAAE,eAAe,CAAA;QACvB,MAAM,CAAC,EAAE,eAAe,CAAA;QACxB,SAAS,CAAC,EAAE,eAAe,CAAA;QAC3B,WAAW,CAAC,EAAE,eAAe,CAAA;QAC7B,kBAAkB,CAAC,EAAE,eAAe,CAAA;QACpC,kBAAkB,CAAC,EAAE,eAAe,CAAA;KACrC,CAAA;CACF;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAC/B;AAED,oBAAY,OAAO;IACjB,MAAM,IAAA;IACN,KAAK,IAAA;CACN;AACD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,eAAe,WAAY,eAAe,GAAG,SAAS,WAIlE,CAAA"}

package/types/appspec.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getABISignature = exports.AVMType = void 0;
+var AVMType;
+(function (AVMType) {
+    AVMType[AVMType["uint64"] = 0] = "uint64";
+    AVMType[AVMType["bytes"] = 1] = "bytes";
+})(AVMType = exports.AVMType || (exports.AVMType = {}));
+const getABISignature = (method) => {
+    const argSignature = method.args.map((a) => a.type).join(',');
+    const returnSignature = method.returns.type;
+    return `{${method.name}}(${argSignature})${returnSignature}`;
+};
+exports.getABISignature = getABISignature;
+//# sourceMappingURL=appspec.js.map

package/types/appspec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appspec.js","sourceRoot":"","sources":["../../src/types/appspec.ts"],"names":[],"mappings":";;;AAqDA,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,yCAAM,CAAA;IACN,uCAAK,CAAA;AACP,CAAC,EAHW,OAAO,GAAP,eAAO,KAAP,eAAO,QAGlB;AAkCM,MAAM,eAAe,GAAG,CAAC,MAAmC,EAAE,EAAE;IACrE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC7D,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAA;IAC3C,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,eAAe,EAAE,CAAA;AAC9D,CAAC,CAAA;AAJY,QAAA,eAAe,mBAI3B"}

package/types/config.d.ts

@@ -0,0 +1,15 @@
+import { Logger } from './logging';
+/** The AlgoKit configuration type */
+export interface Config {
+    logger: Logger;
+}
+/** Updatable AlgoKit config */
+export declare class UpdatableConfig implements Readonly<Config> {
+    private config;
+    get logger(): Logger;
+    getLogger(returnNullLogger?: boolean): Logger;
+    constructor();
+    /** Update the AlgoKit configuration with your own configuration settings */
+    configure(newConfig: Config): void;
+}
+//# sourceMappingURL=config.d.ts.map

package/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,EAAc,MAAM,WAAW,CAAA;AAE7D,qCAAqC;AACrC,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,+BAA+B;AAC/B,qBAAa,eAAgB,YAAW,QAAQ,CAAC,MAAM,CAAC;IACtD,OAAO,CAAC,MAAM,CAAQ;IAEtB,IAAI,MAAM,WAET;IAED,SAAS,CAAC,gBAAgB,CAAC,EAAE,OAAO;;IAcpC,4EAA4E;IAC5E,SAAS,CAAC,SAAS,EAAE,MAAM;CAG5B"}

package/types/config.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdatableConfig = void 0;
+const logging_1 = require("./logging");
+/** Updatable AlgoKit config */
+class UpdatableConfig {
+    get logger() {
+        return this.config.logger;
+    }
+    getLogger(returnNullLogger) {
+        if (returnNullLogger) {
+            return logging_1.nullLogger;
+        }
+        return this.logger;
+    }
+    constructor() {
+        this.config = {
+            logger: logging_1.consoleLogger,
+        };
+    }
+    /** Update the AlgoKit configuration with your own configuration settings */
+    configure(newConfig) {
+        this.config = newConfig;
+    }
+}
+exports.UpdatableConfig = UpdatableConfig;
+//# sourceMappingURL=config.js.map

package/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":";;;AAAA,uCAA6D;AAO7D,+BAA+B;AAC/B,MAAa,eAAe;IAG1B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAA;IAC3B,CAAC;IAED,SAAS,CAAC,gBAA0B;QAClC,IAAI,gBAAgB,EAAE;YACpB,OAAO,oBAAU,CAAA;SAClB;QAED,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;QACE,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,uBAAa;SACtB,CAAA;IACH,CAAC;IAED,4EAA4E;IAC5E,SAAS,CAAC,SAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAA;IACzB,CAAC;CACF;AAzBD,0CAyBC"}