refactor: refinements to support client generator v3

src/algokit_utils/__init__.py

@@ -14,6 +14,7 @@
 from algokit_utils.applications.app_manager import DELETABLE_TEMPLATE_NAME, UPDATABLE_TEMPLATE_NAME
 from algokit_utils.errors.logic_error import LogicError
 from algokit_utils.clients.algorand_client import AlgorandClient
+from algokit_utils.protocols import AlgorandClientProtocol
 
 # Common managers/clients that are frequently used entry points
 from algokit_utils.accounts.account_manager import AccountManager
@@ -138,6 +139,7 @@
     "AlgorandClient",
     "DELETABLE_TEMPLATE_NAME",
     "UPDATABLE_TEMPLATE_NAME",
+    "AlgorandClientProtocol",
     # Common managers/clients
     "AccountManager",
     "AppClient",

src/algokit_utils/_debugging.py

@@ -169,7 +169,7 @@ def _build_avm_sourcemap(
         source_map = compiled_teal.source_map.__dict__
         teal_content = compiled_teal.teal
     elif isinstance(compiled_teal, CompiledTeal):
-        program_hash = base64.b64encode(checksum(compiled_teal.compiled)).decode()
+        program_hash = base64.b64encode(checksum(compiled_teal.compiled_base64_to_bytes)).decode()
         source_map = compiled_teal.source_map.__dict__ if compiled_teal.source_map else {}
         teal_content = compiled_teal.teal
     else:

src/algokit_utils/applications/abi.py

@@ -15,6 +15,7 @@
 ABIStruct: TypeAlias = dict[str, list[dict[str, "ABIValue"]]]
 Arc56ReturnValueType: TypeAlias = ABIValue | ABIStruct | None
 
+
 ABIType: TypeAlias = algosdk.abi.ABIType
 ABIArgumentType: TypeAlias = algosdk.abi.ABIType | algosdk.abi.ABITransactionType | algosdk.abi.ABIReferenceType
 
@@ -56,13 +57,13 @@ def is_success(self) -> bool:
 
     def get_arc56_value(
         self, method: Arc56Method | AlgorandABIMethod, structs: dict[str, list[StructField]]
-    ) -> ABIValue | ABIStruct | None:
+    ) -> Arc56ReturnValueType:
         return get_arc56_value(self, method, structs)
 
 
 def get_arc56_value(
     abi_return: ABIReturn, method: Arc56Method | AlgorandABIMethod, structs: dict[str, list[StructField]]
-) -> ABIValue | ABIStruct | None:
+) -> Arc56ReturnValueType:
     if isinstance(method, AlgorandABIMethod):
         type_str = method.returns.type
         struct = None  # AlgorandABIMethod doesn't have struct info