algokit-utils 4.0.1b3__py3-none-any.whl → 4.1.0__py3-none-any.whl

algokit_utils/_legacy_v2/account.py

@@ -32,7 +32,7 @@ _DEFAULT_ACCOUNT_MINIMUM_BALANCE = 1_000_000_000
 
 
 @deprecated(
-    "Use `algorand.account.from_mnemonic()` instead. Example: " "`account = algorand.account.from_mnemonic(mnemonic)`"
+    "Use `algorand.account.from_mnemonic()` instead. Example: `account = algorand.account.from_mnemonic(mnemonic)`"
 )
 def get_account_from_mnemonic(mnemonic: str) -> Account:
     """Convert a mnemonic (25 word passphrase) into an Account"""
@@ -127,7 +127,7 @@ def get_dispenser_account(client: "AlgodClient") -> Account:
 
 
 @deprecated(
-    "Use `algorand.account.from_kmd()` instead. Example: " "`account = algorand.account.from_kmd(name, predicate)`"
+    "Use `algorand.account.from_kmd()` instead. Example: `account = algorand.account.from_kmd(name, predicate)`"
 )
 def get_kmd_wallet_account(
     client: "AlgodClient",

algokit_utils/_legacy_v2/application_client.py

@@ -243,9 +243,7 @@ class ApplicationClient:
         """Creates a copy of this ApplicationClient, using the new signer, sender and app_id values if provided.
         Will also substitute provided template_values into the associated app_spec in the copy"""
         new_client: ApplicationClient = copy.copy(self)
-        new_client._prepare(  # noqa: SLF001
-            new_client, signer=signer, sender=sender, app_id=app_id, template_values=template_values
-        )
+        new_client._prepare(new_client, signer=signer, sender=sender, app_id=app_id, template_values=template_values)
         return new_client
 
     def _prepare(

algokit_utils/_legacy_v2/deploy.py

@@ -641,8 +641,7 @@ class Deployer:
         elif self.on_update == OnUpdate.ReplaceApp:
             if self.existing_app_metadata_or_reference.updatable is False:
                 logger.warning(
-                    "App is not updatable and on_update=ReplaceApp, "
-                    "will attempt to create new app and delete old app"
+                    "App is not updatable and on_update=ReplaceApp, will attempt to create new app and delete old app"
                 )
             else:
                 logger.warning(

algokit_utils/applications/app_client.py

@@ -95,6 +95,9 @@ __all__ = [
 # TEAL opcodes for constant blocks
 BYTE_CBLOCK = 38  # bytecblock opcode
 INT_CBLOCK = 32  # intcblock opcode
+MAX_SIMULATE_OPCODE_BUDGET = (
+    20_000 * 16
+)  # https://github.com/algorand/go-algorand/blob/807b29a91c371d225e12b9287c5d56e9b33c4e4c/ledger/simulation/trace.go#L104
 
 T = TypeVar("T")  # For generic return type in _handle_call_errors
 
@@ -449,21 +452,16 @@ class _StateAccessor:
                 if not box.name_raw.startswith(prefix):
                     continue
 
-                encoded_key = prefix + box.name_raw
-                base64_key = base64.b64encode(encoded_key).decode("utf-8")
-
                 try:
                     key = get_abi_decoded_value(box.name_raw[len(prefix) :], metadata.key_type, self._app_spec.structs)
                     value = get_abi_decoded_value(
-                        self._algorand.app.get_box_value(self._app_id, base64.b64decode(base64_key)),
+                        self._algorand.app.get_box_value(self._app_id, box.name_raw),
                         metadata.value_type,
                         self._app_spec.structs,
                     )
                     result[str(key)] = value
                 except Exception as e:
-                    if "Failed to decode key" in str(e):
-                        raise ValueError(f"Failed to decode key {base64_key}") from e
-                    raise ValueError(f"Failed to decode value for key {base64_key}") from e
+                    raise ValueError(f"Failed to decode value for key {box.name_raw.decode('utf-8')}") from e
 
             return result
 
@@ -1183,7 +1181,6 @@ class _TransactionSender:
         :param params: Parameters for the application call including method and transaction options
         :param send_params: Send parameters
         :return: The result of sending or simulating the transaction, including ABI return value if applicable
-        :raises ValueError: If the transaction is read-only and `max_fee` is not provided
         """
         is_read_only_call = (
             params.on_complete == algosdk.transaction.OnComplete.NoOpOC or params.on_complete is None
@@ -1194,14 +1191,10 @@ class _TransactionSender:
             readonly_send_params = send_params or SendParams()
 
             # Read-only calls do not require fees to be paid, as they are only simulated on the network.
-            # Therefore there is no value in calculating the minimum fee needed for a successful app call with inners.
-            # As a a result we only need to send a single simulate call,
-            # however to do this successfully we need to ensure fees for the transaction are fully covered using maxFee.
-            if readonly_send_params.get("cover_app_call_inner_transaction_fees"):
-                if params.max_fee is None:
-                    raise ValueError(
-                        "Please provide a `max_fee` for the transaction when `cover_app_call_inner_transaction_fees` is enabled."  # noqa: E501
-                    )
+            # With maximum opcode budget provided, ensure_budget won't create inner transactions,
+            # so fee coverage is no longer a concern for read-only calls.
+            # If max_fee is provided, use it as static_fee for potential benefits.
+            if readonly_send_params.get("cover_app_call_inner_transaction_fees") and params.max_fee is not None:
                 readonly_params = replace(readonly_params, static_fee=params.max_fee, extra_fee=None)
 
             method_call_to_simulate = self._algorand.new_group().add_app_call_method_call(
@@ -1215,11 +1208,13 @@ class _TransactionSender:
                         skip_signatures=True,
                         allow_more_logs=True,
                         allow_empty_signatures=True,
-                        extra_opcode_budget=None,
+                        extra_opcode_budget=MAX_SIMULATE_OPCODE_BUDGET,
                         exec_trace_config=None,
                         simulation_round=None,
                     )
                 except Exception as e:
+                    # For read-only calls with max opcode budget, fee issues should be rare
+                    # but we can still provide helpful error message if they occur
                     if readonly_send_params.get("cover_app_call_inner_transaction_fees") and "fee too small" in str(e):
                         raise ValueError(
                             "Fees were too small. You may need to increase the transaction `maxFee`."
@@ -2047,7 +2042,7 @@ class AppClient:
                         if not value:
                             raise ValueError(
                                 f"Key '{default_value.data}' not found in {default_value.source} "
-                                f"storage for argument {method_arg.name or f'arg{i+1}'}"
+                                f"storage for argument {method_arg.name or f'arg{i + 1}'}"
                             )
 
                         if value.value_raw:
@@ -2065,7 +2060,7 @@ class AppClient:
             elif not algosdk.abi.is_abi_transaction_type(method_arg.type):
                 raise ValueError(
                     f"No value provided for required argument "
-                    f"{method_arg.name or f'arg{i+1}'} in call to method {method.name}"
+                    f"{method_arg.name or f'arg{i + 1}'} in call to method {method.name}"
                 )
             elif arg_value is None and default_value is None:
                 # At this point only allow explicit None values if no default value was identified

algokit_utils/applications/app_deployer.py

@@ -239,7 +239,7 @@ class AppDeployer:
         suppress_log = send_params.get("suppress_log") or False
 
         config.logger.info(
-            f"Idempotently deploying app \"{deployment.metadata.name}\" from creator "
+            f'Idempotently deploying app "{deployment.metadata.name}" from creator '
             f"{deployment.create_params.sender} using {len(deployment.create_params.approval_program)} bytes of "
             f"{'teal code' if isinstance(deployment.create_params.approval_program, str) else 'AVM bytecode'} and "
             f"{len(deployment.create_params.clear_state_program)} bytes of "
@@ -447,7 +447,8 @@ class AppDeployer:
         composer = self._transaction_sender.new_group()
 
         # Add create transaction
-        if isinstance(deployment.create_params, AppCreateMethodCallParams):
+        has_abi_create = isinstance(deployment.create_params, AppCreateMethodCallParams)
+        if has_abi_create:
             composer.add_app_create_method_call(
                 AppCreateMethodCallParams(
                     **{
@@ -467,10 +468,10 @@ class AppDeployer:
                     }
                 )
             )
-        create_txn_index = composer.count() - 1
 
         # Add delete transaction
-        if isinstance(deployment.delete_params, AppDeleteMethodCallParams):
+        has_abi_delete = isinstance(deployment.delete_params, AppDeleteMethodCallParams)
+        if has_abi_delete:
             delete_call_params = AppDeleteMethodCallParams(
                 **{
                     **deployment.delete_params.__dict__,
@@ -486,12 +487,15 @@ class AppDeployer:
                 }
             )
             composer.add_app_delete(delete_params)
-        delete_txn_index = composer.count() - 1
 
-        result = composer.send()
+        result = composer.send(deployment.send_params)
 
-        create_result = SendAppCreateTransactionResult[ABIReturn].from_composer_result(result, create_txn_index)
-        delete_result = SendAppTransactionResult[ABIReturn].from_composer_result(result, delete_txn_index)
+        create_result = SendAppCreateTransactionResult[ABIReturn].from_composer_result(
+            result, is_abi=has_abi_create, index=0
+        )
+        delete_result = SendAppTransactionResult[ABIReturn].from_composer_result(
+            result, is_abi=has_abi_delete, index=-1
+        )
 
         app_id = int(result.confirmations[0]["application-index"])  # type: ignore[call-overload]
         app_metadata = ApplicationMetaData(
@@ -623,8 +627,7 @@ class AppDeployer:
 
         if deployment.on_update in (OnUpdate.Fail, "fail") or deployment.on_update is None:
             raise ValueError(
-                "Update detected and on_update=Fail, stopping deployment. "
-                "Try a different on_update value to not fail."
+                "Update detected and on_update=Fail, stopping deployment. Try a different on_update value to not fail."
             )
 
         if deployment.on_update in (OnUpdate.AppendApp, "append"):

algokit_utils/applications/app_factory.py

@@ -1122,13 +1122,12 @@ class AppFactory:
                     results.append(decoded_value)
                 else:
                     raise ValueError(
-                        f"Cannot provide default value from source={default_value.source} "
-                        "for a contract creation call."
+                        f"Cannot provide default value from source={default_value.source} for a contract creation call."
                     )
             else:
                 param_name = param.name or f"arg{i + 1}"
                 raise ValueError(
-                    f"No value provided for required argument {param_name} " f"in call to method {method.name}"
+                    f"No value provided for required argument {param_name} in call to method {method.name}"
                 )
 
         return results

algokit_utils/transactions/transaction_composer.py

@@ -17,7 +17,7 @@ from algosdk.atomic_transaction_composer import (
     TransactionSigner,
     TransactionWithSigner,
 )
-from algosdk.transaction import ApplicationCallTxn, OnComplete, SuggestedParams
+from algosdk.transaction import OnComplete, SuggestedParams
 from algosdk.v2client.algod import AlgodClient
 from algosdk.v2client.models.simulate_request import SimulateRequest
 from typing_extensions import deprecated
@@ -1833,8 +1833,7 @@ class TransactionComposer:
         group = self.build().transactions
 
         if not params:
-            has_app_call = any(isinstance(txn.txn, ApplicationCallTxn) for txn in group)
-            params = SendParams() if has_app_call else SendParams()
+            params = SendParams()
 
         cover_app_call_inner_transaction_fees = params.get("cover_app_call_inner_transaction_fees")
         populate_app_call_resources = params.get("populate_app_call_resources")

algokit_utils/transactions/transaction_sender.py

@@ -81,7 +81,9 @@ class SendSingleTransactionResult:
     """The ABI return value if applicable"""
 
     @classmethod
-    def from_composer_result(cls, result: SendAtomicTransactionComposerResults, index: int = -1) -> Self:
+    def from_composer_result(
+        cls, result: SendAtomicTransactionComposerResults, *, is_abi: bool = False, index: int = -1
+    ) -> Self:
         # Get base parameters
         base_params = {
             "transaction": result.transactions[index],
@@ -104,12 +106,12 @@ class SendSingleTransactionResult:
                 {
                     "app_id": app_id,
                     "app_address": algosdk.logic.get_application_address(app_id),
-                    "abi_return": result.returns[index] if result.returns else None,  # type: ignore[dict-item]
+                    "abi_return": result.returns[index] if result.returns and is_abi else None,  # type: ignore[dict-item]
                 }
             )
         # For regular app transactions, just add abi_return
         elif cls is SendAppTransactionResult:
-            base_params["abi_return"] = result.returns[index] if result.returns else None  # type: ignore[assignment]
+            base_params["abi_return"] = result.returns[index] if result.returns and is_abi else None  # type: ignore[assignment]
 
         return cls(**base_params)  # type: ignore[arg-type]
 
@@ -650,8 +652,7 @@ class AlgorandClientTransactionSender:
         return self._send(
             lambda c: c.add_asset_opt_in,
             pre_log=lambda params, transaction: (
-                f"Opting in {params.sender} to asset with ID {params.asset_id} via transaction "
-                f"{transaction.get_txid()}"
+                f"Opting in {params.sender} to asset with ID {params.asset_id} via transaction {transaction.get_txid()}"
             ),
         )(params, send_params)
 
@@ -714,7 +715,7 @@ class AlgorandClientTransactionSender:
                     )
             except Exception as e:
                 raise ValueError(
-                    f"Account {params.sender} is not opted-in to Asset {params.asset_id}; " "can't opt-out."
+                    f"Account {params.sender} is not opted-in to Asset {params.asset_id}; can't opt-out."
                 ) from e
 
         if not hasattr(params, "creator"):

{algokit_utils-4.0.1b3.dist-info → algokit_utils-4.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: algokit-utils
-Version: 4.0.1b3
+Version: 4.1.0
 Summary: Utilities for Algorand development for use by AlgoKit
 License: MIT
 Author: Algorand Foundation

{algokit_utils-4.0.1b3.dist-info → algokit_utils-4.1.0.dist-info}/RECORD

@@ -3,12 +3,12 @@ algokit_utils/_debugging.py,sha256=nAiC10WXiZsvc0RPWOrMLpjJQZT_ItgcMl7D9Z4DfYc,1
 algokit_utils/_legacy_v2/__init__.py,sha256=WcRE30axWjGnBB09bJCeTw9NT-2_jDN_CVJITFcIDc8,4689
 algokit_utils/_legacy_v2/_ensure_funded.py,sha256=k52b56CfWttPiu2gy09HIEiXl0eIz5WKQy-iuhxpSQg,6909
 algokit_utils/_legacy_v2/_transfer.py,sha256=nMHm3jXKJLLjOLqjMK_B3bFsslDCx45EPJ5yt7Ex-8k,6464
-algokit_utils/_legacy_v2/account.py,sha256=mv5GjHlIPKNr3dx1FI1aAYFiJqeVpCbf0mTUXeYu0UU,8314
-algokit_utils/_legacy_v2/application_client.py,sha256=Gb7WldXLi0V92YfeU19HP1rJ-L4Rmz2Lxm2q45tQJ2s,59610
+algokit_utils/_legacy_v2/account.py,sha256=9rLtA67cDLJZozCbeMzQS0aZPHXh-z5MxTKEUcbzDtw,8308
+algokit_utils/_legacy_v2/application_client.py,sha256=nSTnT98WRWhxo4xjtQACJW7hmIwhb9EMzyhkUcX50CM,59572
 algokit_utils/_legacy_v2/application_specification.py,sha256=wp2Y9ou2_F-bSFbDnm6AEhFexybmD7-fAT0CuWtO26g,521
 algokit_utils/_legacy_v2/asset.py,sha256=vuSmqwEp2W6bpLB34_fUkzZ8VnLDXC__d-rqI4bmkDM,7574
 algokit_utils/_legacy_v2/common.py,sha256=lB6zHUDJSjYiZ41hvcG0P5TZk_t-n2Iy0OXuQcJosm0,823
-algokit_utils/_legacy_v2/deploy.py,sha256=uoRaUTIYzLZdUucW3DOIbD3qwa9CvLgo1GSJ1Ibfmsw,32778
+algokit_utils/_legacy_v2/deploy.py,sha256=RMQ3AG5cNRzcYHzpFM9fQJo2f4dQeFDBKPIvx4K2e6Q,32755
 algokit_utils/_legacy_v2/logic_error.py,sha256=pmaMTuvbOD7PHukSY4epzJRptSivc4O0vFZdW_zzZ38,345
 algokit_utils/_legacy_v2/models.py,sha256=hH7aO50E4po4EgxXI9zdX5HTthn1HLfSLvkuPfgAATc,7403
 algokit_utils/_legacy_v2/network_clients.py,sha256=z_zm1da9CVBG2TOAnXeYkHBh6a8HtXsSdNrlEizc8J0,5928
@@ -21,9 +21,9 @@ algokit_utils/application_client.py,sha256=5UIxXIBjukjRyjZPCeXmaNlAftbb3TziV7EfB
 algokit_utils/application_specification.py,sha256=wV0H088IudMqlxsW-gsZIfJyKA4e-zVwxJ-cR__ouBA,1379
 algokit_utils/applications/__init__.py,sha256=NGjhpBeExsQZOAYCT2QUFag1xuKoFiX-Ux5SR2GNzd8,452
 algokit_utils/applications/abi.py,sha256=OjTdn4szJPPeC8XmosdDYtkIIVgQSWAnqz2DHw5OH9g,10117
-algokit_utils/applications/app_client.py,sha256=wM3tH0-oW6uQG_W0RLiL3iULnvAPpNM-O9BiPw5wfiU,88470
-algokit_utils/applications/app_deployer.py,sha256=kAypS20VM-yAwosCcYdMwTmXntGOt_6EN_i5nIYN5rw,30627
-algokit_utils/applications/app_factory.py,sha256=PPJnR-fs1hNkEMlIqwY7jx63hPnOkdyiIK6l4-A3d10,45383
+algokit_utils/applications/app_client.py,sha256=891BMnUOIOenEWgeelSIMgi0Wj4kggluWiKAu6-GYrE,88208
+algokit_utils/applications/app_deployer.py,sha256=xJCu7SU66OTg5misSbSF0QI8abRB-DWAwAVKd1kNcPI,30685
+algokit_utils/applications/app_factory.py,sha256=jVAzoK1J9S-BTGHA5BLxT-cl0pWhPdf222W4fYpFihE,45352
 algokit_utils/applications/app_manager.py,sha256=8bboIswlwBQhPIqilSBMaxd83yHjIpkloezmtgcAdZY,22301
 algokit_utils/applications/app_spec/__init__.py,sha256=HtjAhAqHNFml9WbRKGmhJnwyJeW8AztPRO_BriQ84vs,140
 algokit_utils/applications/app_spec/arc32.py,sha256=8MMGUopPzkWq48rl5sYbc2Awf-RKnxSX8F0P0UibK5M,7523
@@ -61,10 +61,10 @@ algokit_utils/protocols/account.py,sha256=CowaVY7ErBP84TWBHNvBjkZy18whPb8HIlMZtJ
 algokit_utils/protocols/typed_clients.py,sha256=UrQrHbN2SvS8pEFJ8JQodvouoWeBrQOQGZGyBQx1KLM,3322
 algokit_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 algokit_utils/transactions/__init__.py,sha256=7fYF3m6DyOGzbV36MT5svo0wSkj9AIz496kWgIWSAlk,225
-algokit_utils/transactions/transaction_composer.py,sha256=66_vY6DNs4gDhLRAamtzzo7oeLM8nxS9QKwZY_tidYc,104138
+algokit_utils/transactions/transaction_composer.py,sha256=eK-6l2W1CkbKID1ezi-zCs_TxA2i5ZTm3YTl8sT2Zfw,103995
 algokit_utils/transactions/transaction_creator.py,sha256=cuP6Xm-fhGoCc2FNSbLiEg3iQRwW38rfdTzsqPyEcpM,29053
-algokit_utils/transactions/transaction_sender.py,sha256=foK_2S-gUl9D7xkWG3lD526qIKz5mVibHNKVREQCgoA,50079
-algokit_utils-4.0.1b3.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-4.0.1b3.dist-info/METADATA,sha256=Wuty91rhnlGVlhzljvqS9TzoCJu5vJTVJ2eniZGacQ0,2421
-algokit_utils-4.0.1b3.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-algokit_utils-4.0.1b3.dist-info/RECORD,,
+algokit_utils/transactions/transaction_sender.py,sha256=Wi3ws9S-Df1JeTlaSTXmq-WS24Gsq7WGsKk1B0z23ao,50117
+algokit_utils-4.1.0.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-4.1.0.dist-info/METADATA,sha256=9Et8L9-7fqp3dk3J_N8X6_6AWHm4EZf7qy7IIyuYEA4,2419
+algokit_utils-4.1.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+algokit_utils-4.1.0.dist-info/RECORD,,

{algokit_utils-4.0.1b3.dist-info → algokit_utils-4.1.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.2
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any