algokit-utils 3.0.0b8__py3-none-any.whl → 3.0.0b10__py3-none-any.whl

algokit_utils/applications/app_client.py

@@ -1900,6 +1900,11 @@ class AppClient:
         method = self._app_spec.get_arc56_method(method_name_or_signature)
         result: list[ABIValue | ABIStruct | AppMethodCallTransactionArgument | None] = []
 
+        if args and len(method.args) < len(args):
+            raise ValueError(
+                f"Unexpected arg at position {len(method.args)}. {method.name} only expects {len(method.args)} args"
+            )
+
         for i, method_arg in enumerate(method.args):
             arg_value = args[i] if args and i < len(args) else None
 

algokit_utils/applications/app_spec/arc56.py

@@ -672,22 +672,47 @@ class SourceInfoModel:
         return SourceInfoModel(**data)
 
 
-def _dict_keys_to_snake_case(
-    value: Any,  # noqa: ANN401
-) -> Any:  # noqa: ANN401
+# constants that define which parent keys mark a region whose inner keys should remain unchanged.
+PROTECTED_TOP_DICTS = {"networks", "scratch_variables", "template_variables", "structs"}
+STATE_PROTECTED_PARENTS = {"keys", "maps"}
+STATE_PROTECTED_CHILDREN = {"global", "local", "box"}
+
+
+def _is_protected_path(path: tuple[str, ...]) -> bool:
+    """
+    Return True if the current recursion path indicates that we are inside a protected dictionary,
+    meaning that the keys should be left unchanged.
+    """
+    return (len(path) >= 2 and path[-2] in STATE_PROTECTED_PARENTS and path[-1] in STATE_PROTECTED_CHILDREN) or (  # noqa: PLR2004
+        len(path) >= 1 and path[-1] in PROTECTED_TOP_DICTS
+    )
+
+
+def _dict_keys_to_snake_case(value: Any, path: tuple[str, ...] = ()) -> Any:  # noqa: ANN401
+    """Recursively convert dictionary keys to snake_case except in protected sections.
+
+    A dictionary is not converted if it is directly under:
+      - keys/maps sections ("global", "local", "box")
+      - or one of the top-level keys ("networks", "scratchVariables", "templateVariables", "structs")
+    (Note that once converted the parent key names become snake_case.)
+    """
+    import re
+
     def camel_to_snake(s: str) -> str:
-        return "".join(["_" + c.lower() if c.isupper() else c for c in s]).lstrip("_")
-
-    match value:
-        case dict():
-            new_dict: dict[str, Any] = {}
-            for key, val in value.items():
-                new_dict[camel_to_snake(str(key))] = _dict_keys_to_snake_case(val)
-            return new_dict
-        case list():
-            return [_dict_keys_to_snake_case(item) for item in value]
-        case _:
-            return value
+        # Use a regular expression to insert an underscore before capital letters (except at start).
+        return re.sub(r"(?<!^)(?=[A-Z])", "_", s).lower()
+
+    if isinstance(value, dict):
+        protected = _is_protected_path(path)
+        new_dict = {}
+        for key, val in value.items():
+            new_key = key if protected else camel_to_snake(key)
+            new_dict[new_key] = _dict_keys_to_snake_case(val, (*path, new_key))
+        return new_dict
+    elif isinstance(value, list):
+        return [_dict_keys_to_snake_case(item, path) for item in value]
+    else:
+        return value
 
 
 class _Arc32ToArc56Converter:

algokit_utils/transactions/transaction_composer.py

@@ -591,9 +591,27 @@ class SendAtomicTransactionComposerResults:
     simulate_response: dict[str, Any] | None = None
 
 
+class UnnamedResourcesAccessed:
+    """Information about unnamed resource access."""
+
+    def __init__(self, resources_accessed: dict[str, Any] | None = None):
+        resources = resources_accessed or {}
+
+        if not isinstance(resources, dict):
+            raise TypeError(f"Expected dictionary object, got {type(resources_accessed)}")
+
+        self.accounts: list[str] | None = resources.get("accounts", None)
+        self.app_locals: list[dict[str, Any]] | None = resources.get("app-locals", None)
+        self.apps: list[int] | None = resources.get("apps", None)
+        self.asset_holdings: list[dict[str, Any]] | None = resources.get("asset-holdings", None)
+        self.assets: list[int] | None = resources.get("assets", None)
+        self.boxes: list[dict[str, Any]] | None = resources.get("boxes", None)
+        self.extra_box_refs: int | None = resources.get("extra-box-refs", None)
+
+
 @dataclass
 class ExecutionInfoTxn:
-    unnamed_resources_accessed: dict | None = None
+    unnamed_resources_accessed: UnnamedResourcesAccessed | None = None
     required_fee_delta: int = 0
 
 
@@ -601,7 +619,7 @@ class ExecutionInfoTxn:
 class ExecutionInfo:
     """Information about transaction execution from simulation."""
 
-    group_unnamed_resources_accessed: dict[str, Any] | None = None
+    group_unnamed_resources_accessed: UnnamedResourcesAccessed | None = None
     txns: list[ExecutionInfoTxn] | None = None
 
 
@@ -706,7 +724,7 @@ def _get_group_execution_info(  # noqa: C901, PLR0912
             )
         failed_at = group_response.get("failed-at", [0])[0]
         raise ValueError(
-            f"Error during resource population simulation in transaction {failed_at}: "
+            f"Error resolving execution info via simulate in transaction {failed_at}: "
             f"{group_response['failure-message']}"
         )
 
@@ -745,7 +763,7 @@ def _get_group_execution_info(  # noqa: C901, PLR0912
 
         txn_results.append(
             ExecutionInfoTxn(
-                unnamed_resources_accessed=txn_result_raw.get("unnamed-resources-accessed")
+                unnamed_resources_accessed=UnnamedResourcesAccessed(txn_result_raw.get("unnamed-resources-accessed"))
                 if populate_app_call_resources
                 else None,
                 required_fee_delta=required_fee_delta,
@@ -753,7 +771,7 @@ def _get_group_execution_info(  # noqa: C901, PLR0912
         )
 
     return ExecutionInfo(
-        group_unnamed_resources_accessed=group_response.get("unnamed-resources-accessed")
+        group_unnamed_resources_accessed=UnnamedResourcesAccessed(group_response.get("unnamed-resources-accessed"))
         if populate_app_call_resources
         else None,
         txns=txn_results,
@@ -1052,11 +1070,11 @@ def prepare_group_for_sending(  # noqa: C901, PLR0912, PLR0915
         resources = txn_info.unnamed_resources_accessed
         if resources and is_app_txn:
             app_txn = group[i].txn
-            if resources.get("boxes") or resources.get("extra-box-refs"):
+            if resources.boxes or resources.extra_box_refs:
                 raise ValueError("Unexpected boxes at transaction level")
-            if resources.get("appLocals"):
+            if resources.app_locals:
                 raise ValueError("Unexpected app local at transaction level")
-            if resources.get("assetHoldings"):
+            if resources.asset_holdings:
                 raise ValueError("Unexpected asset holding at transaction level")
 
             # Update application call fields
@@ -1066,10 +1084,10 @@ def prepare_group_for_sending(  # noqa: C901, PLR0912, PLR0915
             boxes = list(getattr(app_txn, "boxes", []) or [])
 
             # Add new resources
-            accounts.extend(resources.get("accounts", []))
-            foreign_apps.extend(resources.get("apps", []))
-            foreign_assets.extend(resources.get("assets", []))
-            boxes.extend(resources.get("boxes", []))
+            accounts.extend(resources.accounts or [])
+            foreign_apps.extend(resources.apps or [])
+            foreign_assets.extend(resources.assets or [])
+            boxes.extend(resources.boxes or [])
 
             # Validate limits
             if len(accounts) > MAX_APP_CALL_ACCOUNT_REFERENCES:
@@ -1113,45 +1131,41 @@ def prepare_group_for_sending(  # noqa: C901, PLR0912, PLR0915
     group_resources = execution_info.group_unnamed_resources_accessed
     if group_resources:
         # Handle cross-reference resources first
-        for app_local in group_resources.get("appLocals", []):
+        for app_local in group_resources.app_locals or []:
             populate_group_resource(group, app_local, "appLocal")
             # Remove processed resources
-            if "accounts" in group_resources:
-                group_resources["accounts"] = [
-                    acc for acc in group_resources["accounts"] if acc != app_local["account"]
-                ]
-            if "apps" in group_resources:
-                group_resources["apps"] = [app for app in group_resources["apps"] if int(app) != int(app_local["app"])]
+            if group_resources.accounts:
+                group_resources.accounts = [acc for acc in group_resources.accounts if acc != app_local["account"]]
+            if group_resources.apps:
+                group_resources.apps = [app for app in group_resources.apps if int(app) != int(app_local["app"])]
 
-        for asset_holding in group_resources.get("assetHoldings", []):
+        for asset_holding in group_resources.asset_holdings or []:
             populate_group_resource(group, asset_holding, "assetHolding")
             # Remove processed resources
-            if "accounts" in group_resources:
-                group_resources["accounts"] = [
-                    acc for acc in group_resources["accounts"] if acc != asset_holding["account"]
-                ]
-            if "assets" in group_resources:
-                group_resources["assets"] = [
-                    asset for asset in group_resources["assets"] if int(asset) != int(asset_holding["asset"])
+            if group_resources.accounts:
+                group_resources.accounts = [acc for acc in group_resources.accounts if acc != asset_holding["account"]]
+            if group_resources.assets:
+                group_resources.assets = [
+                    asset for asset in group_resources.assets if int(asset) != int(asset_holding["asset"])
                 ]
 
         # Handle remaining resources
-        for account in group_resources.get("accounts", []):
+        for account in group_resources.accounts or []:
             populate_group_resource(group, account, "account")
 
-        for box in group_resources.get("boxes", []):
+        for box in group_resources.boxes or []:
             populate_group_resource(group, box, "box")
-            if "apps" in group_resources:
-                group_resources["apps"] = [app for app in group_resources["apps"] if int(app) != int(box["app"])]
+            if group_resources.apps:
+                group_resources.apps = [app for app in group_resources.apps if int(app) != int(box["app"])]
 
-        for asset in group_resources.get("assets", []):
+        for asset in group_resources.assets or []:
             populate_group_resource(group, asset, "asset")
 
-        for app in group_resources.get("apps", []):
+        for app in group_resources.apps or []:
             populate_group_resource(group, app, "app")
 
         # Handle extra box references
-        extra_box_refs = group_resources.get("extra-box-refs", 0)
+        extra_box_refs = group_resources.extra_box_refs or 0
         for _ in range(extra_box_refs):
             populate_group_resource(group, {"app": 0, "name": ""}, "box")
 

{algokit_utils-3.0.0b8.dist-info → algokit_utils-3.0.0b10.dist-info}/METADATA

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

{algokit_utils-3.0.0b8.dist-info → algokit_utils-3.0.0b10.dist-info}/RECORD

@@ -21,13 +21,13 @@ algokit_utils/application_client.py,sha256=5UIxXIBjukjRyjZPCeXmaNlAftbb3TziV7EfB
 algokit_utils/application_specification.py,sha256=-ZM13Qv-AcLmwudJCq8xGPoWLvAvKBICgAdHeFozKbY,1416
 algokit_utils/applications/__init__.py,sha256=NGjhpBeExsQZOAYCT2QUFag1xuKoFiX-Ux5SR2GNzd8,452
 algokit_utils/applications/abi.py,sha256=IhrEUdg2kDzR4iU5_FzUDjlMIHO7Rfe-ibJ6z9CMUq8,10260
-algokit_utils/applications/app_client.py,sha256=oAwe9_6-ETWJIdXNScDvUiVYN8JNP4kplSnr3qCQPVY,84979
+algokit_utils/applications/app_client.py,sha256=TGMngl7BNLvMlMt3lsREEQrI0C1-jl4IhYqVNr2oG7g,85191
 algokit_utils/applications/app_deployer.py,sha256=MD7RIvh6Z6dFr9sx8dP5nP1DzSEbwz-vX-Exz_CwoN4,24740
 algokit_utils/applications/app_factory.py,sha256=wljyXuXWaMc3KJkDeACJ5XVEfIsVxeSXqdGTJ9p3tJQ,33425
 algokit_utils/applications/app_manager.py,sha256=EA1uRtmvPVAdKi1I5HSCpHjIDgLN7eZcEPT0Cj3C7fU,17661
 algokit_utils/applications/app_spec/__init__.py,sha256=HtjAhAqHNFml9WbRKGmhJnwyJeW8AztPRO_BriQ84vs,140
 algokit_utils/applications/app_spec/arc32.py,sha256=8MMGUopPzkWq48rl5sYbc2Awf-RKnxSX8F0P0UibK5M,7523
-algokit_utils/applications/app_spec/arc56.py,sha256=8GyQ_gDBSkHLzTL35D1r7dce5owhM8T_TYcHPQE_-_g,31727
+algokit_utils/applications/app_spec/arc56.py,sha256=LS-EA4lYNe6kCR9z6lvB8tGLV-t4qLe3Rttg2Wg5z7Y,32984
 algokit_utils/applications/enums.py,sha256=1MUBrPW9v0-OZk6jsa5rqSEEpC-z-6QAQIs9G7pLn1I,1257
 algokit_utils/asset.py,sha256=ZnNo_MsDGPb8UTPxi7cmIZpbrT0x0xZjblHP01pDAC0,874
 algokit_utils/assets/__init__.py,sha256=6igogt0eo0TEae6-rO9qPsmlrKkbnkq3aV8wtePX3yk,63
@@ -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=kxoBy4DcFT8GCKrCIntUSOXMyJJgJ1RZGX0QdB7YAXQ,95287
+algokit_utils/transactions/transaction_composer.py,sha256=S9GrGDCTg0JJa4HbcTVbGAsV_qAHW2xWNiT9olo6_tk,96058
 algokit_utils/transactions/transaction_creator.py,sha256=A1YHeGC2EkR2V0HPYJiXVOAEIrfjBW2KVyYgi3exm4E,6167
 algokit_utils/transactions/transaction_sender.py,sha256=uQmHElJgUIxLXfdklMNoabjQQzUku8CFP82wwhfr44E,22769
-algokit_utils-3.0.0b8.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-3.0.0b8.dist-info/METADATA,sha256=OqVqX28jUqd4GFWWSzHzJRNzbmUtD4rCiSuJNwh1IS8,2420
-algokit_utils-3.0.0b8.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-algokit_utils-3.0.0b8.dist-info/RECORD,,
+algokit_utils-3.0.0b10.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-3.0.0b10.dist-info/METADATA,sha256=uSusbjVEq43dNLdD_nfzk-AvBleVdY-TgCxCVOvbGC0,2421
+algokit_utils-3.0.0b10.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+algokit_utils-3.0.0b10.dist-info/RECORD,,