@algorandfoundation/algokit-utils 7.0.0-beta.7 → 7.0.0-beta.9

package/types/app-client.mjs

@@ -50,6 +50,7 @@ class AppClient {
         this._appName = params.appName ?? this._appSpec.name;
         this._algorand = params.algorand;
         this._defaultSender = params.defaultSender;
+        this._defaultSigner = params.defaultSigner;
         this._approvalSourceMap = params.approvalSourceMap;
         this._clearSourceMap = params.clearSourceMap;
         this._localStateMethods = (address) => this.getStateMethods(() => this.getLocalState(address), () => this._appSpec.state.keys.local, () => this._appSpec.state.maps.local);
@@ -145,6 +146,10 @@ class AppClient {
     get appSpec() {
         return this._appSpec;
     }
+    /** A reference to the underlying `AlgorandClient` this app client is using. */
+    get algorand() {
+        return this._algorand;
+    }
     /** Get parameters to create transactions for the current app.
      *
      * A good mental model for this is that these parameters represent a deferred transaction creation.
@@ -394,9 +399,7 @@ class AppClient {
             }
             return {
                 approvalProgram: Buffer.from(appSpec.byteCode.approval, 'base64'),
-                compiledApproval: undefined,
                 clearStateProgram: Buffer.from(appSpec.byteCode.clear, 'base64'),
-                compiledClear: undefined,
             };
         }
         const approvalTemplate = Buffer.from(appSpec.source.approval, 'base64').toString('utf-8');
@@ -540,7 +543,11 @@ class AppClient {
         return {
             /** Signs and sends an update call, including deploy-time TEAL template replacements and compilation if provided */
             update: async (params) => {
-                return await this.handleCallErrors(async () => this._algorand.send.appUpdate(await this.params.bare.update(params)));
+                const compiled = await this.compile(params);
+                return {
+                    ...(await this.handleCallErrors(async () => this._algorand.send.appUpdate(await this.params.bare.update(params)))),
+                    ...compiled,
+                };
             },
             /** Signs and sends an opt-in call */
             optIn: (params) => {
@@ -571,6 +578,7 @@ class AppClient {
                 return {
                     ...params,
                     sender: this.getSender(params.sender),
+                    signer: this.getSigner(params.sender, params.signer),
                     receiver: this.appAddress,
                 };
             },
@@ -643,7 +651,11 @@ class AppClient {
                     const result = await this._algorand
                         .newGroup()
                         .addAppCallMethodCall(await this.params.call(params))
-                        .simulate();
+                        .simulate({
+                        allowUnnamedResources: params.populateAppCallResources,
+                        // Simulate calls for a readonly method shouldn't invoke signing
+                        skipSignatures: true,
+                    });
                     return this.processMethodCallReturn({
                         ...result,
                         transaction: result.transactions.at(-1),
@@ -694,7 +706,7 @@ class AppClient {
             },
         };
     }
-    /** Returns the sender for a call, using the `defaultSender`
+    /** Returns the sender for a call, using the provided sender or using the `defaultSender`
      * if none provided and throws an error if neither provided */
     getSender(sender) {
         if (!sender && !this._defaultSender) {
@@ -702,11 +714,18 @@ class AppClient {
         }
         return sender ?? this._defaultSender;
     }
+    /** Returns the signer for a call, using the provided signer or the `defaultSigner`
+     * if no signer was provided and the call will use default sender
+     * or `undefined` otherwise (so the signer is resolved from `AlgorandClient`) */
+    getSigner(sender, signer) {
+        return signer ?? (!sender ? this._defaultSigner : undefined);
+    }
     getBareParams(params, onComplete) {
         return {
             ...params,
             appId: this._appId,
             sender: this.getSender(params?.sender),
+            signer: this.getSigner(params?.sender, params?.signer),
             onComplete,
         };
     }
@@ -718,6 +737,7 @@ class AppClient {
             ...params,
             appId: this._appId,
             sender: sender,
+            signer: this.getSigner(params.sender, params.signer),
             method,
             onComplete,
             args,