algokit-utils 3.0.0b2__py3-none-any.whl → 3.0.0b4__py3-none-any.whl

algokit_utils/accounts/account_manager.py

@@ -222,7 +222,7 @@ class AccountManager:
 
         :example:
         >>> account_manager = AccountManager(client_manager)
-        >>> account_manager.set_signer_from_account(SigningAccount.new_account())
+        >>> account_manager.set_signer_from_account(SigningAccount(private_key=algosdk.account.generate_account()[0]))
         >>> account_manager.set_signer_from_account(LogicSigAccount(AlgosdkLogicSigAccount(program, args)))
         >>> account_manager.set_signer_from_account(MultiSigAccount(multisig_params, [account1, account2]))
         """
@@ -256,7 +256,7 @@ class AccountManager:
         :raises ValueError: If no account is found or if the account is not a regular account
 
         :example:
-        >>> sender = account_manager.random()
+        >>> sender = account_manager.random().address
         >>> # ...
         >>> # Returns the `TransactionSignerAccountProtocol` for `sender` that has previously been registered
         >>> account = account_manager.get_account(sender)
@@ -449,8 +449,8 @@ class AccountManager:
         :example:
         >>> account = account_manager.random()
         """
-        account = SigningAccount.new_account()
-        return self._register_account(account.private_key)
+        private_key, _ = algosdk.account.generate_account()
+        return self._register_account(private_key)
 
     def localnet_dispenser(self) -> SigningAccount:
         """

algokit_utils/application_specification.py

@@ -1,6 +1,6 @@
 import warnings
 
-from deprecated import deprecated
+from typing_extensions import deprecated
 
 warnings.warn(
     """The legacy v2 application_specification module is deprecated and will be removed in a future version.

algokit_utils/applications/app_client.py

@@ -5,7 +5,7 @@ import copy
 import json
 import os
 from collections.abc import Sequence
-from dataclasses import dataclass, fields
+from dataclasses import asdict, dataclass, fields
 from typing import TYPE_CHECKING, Any, Generic, Literal, TypedDict, TypeVar
 
 import algosdk
@@ -76,7 +76,6 @@ __all__ = [
     "AppClient",
     "AppClientBareCallCreateParams",
     "AppClientBareCallParams",
-    "AppClientCallParams",
     "AppClientCompilationParams",
     "AppClientCompilationResult",
     "AppClientCreateSchema",
@@ -85,6 +84,8 @@ __all__ = [
     "AppClientParams",
     "AppSourceMaps",
     "BaseAppClientMethodCallParams",
+    "CommonAppCallCreateParams",
+    "CommonAppCallParams",
     "CreateOnComplete",
     "FundAppAccountParams",
     "get_constant_block_offset",
@@ -201,106 +202,35 @@ class AppClientCompilationParams(TypedDict, total=False):
     deletable: bool | None
 
 
-@dataclass(kw_only=True)
-class FundAppAccountParams:
-    """Parameters for funding an application's account.
-
-    :ivar sender: Optional sender address
-    :ivar signer: Optional transaction signer
-    :ivar rekey_to: Optional address to rekey to
-    :ivar note: Optional transaction note
-    :ivar lease: Optional lease
-    :ivar static_fee: Optional static fee
-    :ivar extra_fee: Optional extra fee
-    :ivar max_fee: Optional maximum fee
-    :ivar validity_window: Optional validity window in rounds
-    :ivar first_valid_round: Optional first valid round
-    :ivar last_valid_round: Optional last valid round
-    :ivar amount: Amount to fund
-    :ivar close_remainder_to: Optional address to close remainder to
-    :ivar on_complete: Optional on complete action
-    """
-
-    sender: str | None = None
-    signer: TransactionSigner | None = None
-    rekey_to: str | None = None
-    note: bytes | None = None
-    lease: bytes | None = None
-    static_fee: AlgoAmount | None = None
-    extra_fee: AlgoAmount | None = None
-    max_fee: AlgoAmount | None = None
-    validity_window: int | None = None
-    first_valid_round: int | None = None
-    last_valid_round: int | None = None
-    amount: AlgoAmount
-    close_remainder_to: str | None = None
-    on_complete: algosdk.transaction.OnComplete | None = None
-
-
-@dataclass(kw_only=True)
-class AppClientCallParams:
-    """Parameters for calling an application.
-
-    :ivar method: Optional ABI method name or signature
-    :ivar args: Optional arguments to pass to method
-    :ivar boxes: Optional box references to load
-    :ivar accounts: Optional account addresses to load
-    :ivar apps: Optional app IDs to load
-    :ivar assets: Optional asset IDs to load
-    :ivar lease: Optional lease
-    :ivar sender: Optional sender address
-    :ivar note: Optional transaction note
-    :ivar send_params: Optional parameters to control transaction sending
-    """
-
-    method: str | None = None
-    args: list | None = None
-    boxes: list | None = None
-    accounts: list[str] | None = None
-    apps: list[int] | None = None
-    assets: list[int] | None = None
-    lease: (str | bytes) | None = None
-    sender: str | None = None
-    note: (bytes | dict | str) | None = None
-    send_params: dict | None = None
-
-
 ArgsT = TypeVar("ArgsT")
 MethodT = TypeVar("MethodT")
 
 
 @dataclass(kw_only=True, frozen=True)
-class BaseAppClientMethodCallParams(Generic[ArgsT, MethodT]):
-    """Base parameters for application method calls.
+class CommonAppCallParams:
+    """Common configuration for app call transaction parameters
+
+    :ivar account_references: List of account addresses to reference
+    :ivar app_references: List of app IDs to reference
+    :ivar asset_references: List of asset IDs to reference
+    :ivar box_references: List of box references to include
+    :ivar extra_fee: Additional fee to add to transaction
+    :ivar lease: Transaction lease value
+    :ivar max_fee: Maximum fee allowed for transaction
+    :ivar note: Arbitrary note for the transaction
+    :ivar rekey_to: Address to rekey account to
+    :ivar sender: Sender address override
+    :ivar signer: Custom transaction signer
+    :ivar static_fee: Fixed fee for transaction
+    :ivar validity_window: Number of rounds valid
+    :ivar first_valid_round: First valid round number
+    :ivar last_valid_round: Last valid round number"""
 
-    :ivar method: Method to call
-    :ivar args: Optional arguments to pass to method
-    :ivar account_references: Optional account references
-    :ivar app_references: Optional application references
-    :ivar asset_references: Optional asset references
-    :ivar box_references: Optional box references
-    :ivar extra_fee: Optional extra fee
-    :ivar first_valid_round: Optional first valid round
-    :ivar lease: Optional lease
-    :ivar max_fee: Optional maximum fee
-    :ivar note: Optional note
-    :ivar rekey_to: Optional rekey to address
-    :ivar sender: Optional sender address
-    :ivar signer: Optional transaction signer
-    :ivar static_fee: Optional static fee
-    :ivar validity_window: Optional validity window
-    :ivar last_valid_round: Optional last valid round
-    :ivar on_complete: Optional on complete action
-    """
-
-    method: MethodT
-    args: ArgsT | None = None
     account_references: list[str] | None = None
     app_references: list[int] | None = None
     asset_references: list[int] | None = None
-    box_references: Sequence[BoxReference | BoxIdentifier] | None = None
+    box_references: list[BoxReference | BoxIdentifier] | None = None
     extra_fee: AlgoAmount | None = None
-    first_valid_round: int | None = None
     lease: bytes | None = None
     max_fee: AlgoAmount | None = None
     note: bytes | None = None
@@ -309,82 +239,85 @@ class BaseAppClientMethodCallParams(Generic[ArgsT, MethodT]):
     signer: TransactionSigner | None = None
     static_fee: AlgoAmount | None = None
     validity_window: int | None = None
+    first_valid_round: int | None = None
     last_valid_round: int | None = None
-    on_complete: algosdk.transaction.OnComplete | None = None
+    on_complete: OnComplete | None = None
+
+
+@dataclass(frozen=True)
+class AppClientCreateSchema:
+    """Schema for application creation.
+
+    :ivar extra_program_pages: Optional number of extra program pages
+    :ivar schema: Optional application creation schema
+    """
+
+    extra_program_pages: int | None = None
+    schema: AppCreateSchema | None = None
 
 
 @dataclass(kw_only=True, frozen=True)
-class AppClientMethodCallParams(
-    BaseAppClientMethodCallParams[
-        Sequence[ABIValue | ABIStruct | AppMethodCallTransactionArgument | None],
-        str,
-    ]
-):
-    """Parameters for application method calls."""
+class CommonAppCallCreateParams(AppClientCreateSchema, CommonAppCallParams):
+    """Common configuration for app create call transaction parameters."""
+
+    on_complete: CreateOnComplete | None = None
 
 
 @dataclass(kw_only=True, frozen=True)
-class AppClientBareCallParams:
+class FundAppAccountParams(CommonAppCallParams):
+    """Parameters for funding an application's account.
+
+    :ivar amount: Amount to fund
+    :ivar close_remainder_to: Optional address to close remainder to
+    """
+
+    amount: AlgoAmount
+    close_remainder_to: str | None = None
+
+
+@dataclass(kw_only=True, frozen=True)
+class AppClientBareCallParams(CommonAppCallParams):
     """Parameters for bare application calls.
 
-    :ivar signer: Optional transaction signer
-    :ivar rekey_to: Optional rekey to address
-    :ivar lease: Optional lease
-    :ivar static_fee: Optional static fee
-    :ivar extra_fee: Optional extra fee
-    :ivar max_fee: Optional maximum fee
-    :ivar validity_window: Optional validity window
-    :ivar first_valid_round: Optional first valid round
-    :ivar last_valid_round: Optional last valid round
-    :ivar sender: Optional sender address
-    :ivar note: Optional note
     :ivar args: Optional arguments
-    :ivar account_references: Optional account references
-    :ivar app_references: Optional application references
-    :ivar asset_references: Optional asset references
-    :ivar box_references: Optional box references
     """
 
-    signer: TransactionSigner | None = None
-    rekey_to: str | None = None
-    lease: bytes | None = None
-    static_fee: AlgoAmount | None = None
-    extra_fee: AlgoAmount | None = None
-    max_fee: AlgoAmount | None = None
-    validity_window: int | None = None
-    first_valid_round: int | None = None
-    last_valid_round: int | None = None
-    sender: str | None = None
-    note: bytes | None = None
     args: list[bytes] | None = None
-    account_references: list[str] | None = None
-    app_references: list[int] | None = None
-    asset_references: list[int] | None = None
-    box_references: list[BoxReference | BoxIdentifier] | None = None
 
 
 @dataclass(frozen=True)
-class AppClientCreateSchema:
-    """Schema for application creation.
+class AppClientBareCallCreateParams(CommonAppCallCreateParams):
+    """Parameters for creating application with bare call."""
 
-    :ivar extra_program_pages: Optional number of extra program pages
-    :ivar schema: Optional application creation schema
-    """
+    on_complete: CreateOnComplete | None = None
 
-    extra_program_pages: int | None = None
-    schema: AppCreateSchema | None = None
 
+@dataclass(kw_only=True, frozen=True)
+class BaseAppClientMethodCallParams(Generic[ArgsT, MethodT], CommonAppCallParams):
+    """Base parameters for application method calls.
 
-@dataclass(frozen=True)
-class AppClientBareCallCreateParams(AppClientCreateSchema, AppClientBareCallParams):
-    """Parameters for creating application with bare call."""
+    :ivar method: Method to call
+    :ivar args: Optional arguments to pass to method
+    :ivar on_complete: Optional on complete action
+    """
 
-    on_complete: OnComplete | None = None
+    method: MethodT
+    args: ArgsT | None = None
+
+
+@dataclass(kw_only=True, frozen=True)
+class AppClientMethodCallParams(
+    BaseAppClientMethodCallParams[
+        Sequence[ABIValue | ABIStruct | AppMethodCallTransactionArgument | None],
+        str,
+    ]
+):
+    """Parameters for application method calls."""
 
 
 @dataclass(frozen=True)
 class AppClientMethodCallCreateParams(AppClientCreateSchema, AppClientMethodCallParams):
-    """Parameters for creating application with method call."""
+    """Parameters for creating application with method call"""
 
     on_complete: CreateOnComplete | None = None
 
@@ -799,14 +732,12 @@ class _MethodParamsBuilder:
         :param compilation_params: Parameters for the compilation, defaults to None
         :return: Parameters for updating the application
         """
-        compile_params = (
+        compile_params = asdict(
             self._client.compile(
                 app_spec=self._client.app_spec,
                 app_manager=self._algorand.app,
                 compilation_params=compilation_params,
-            ).__dict__
-            if compilation_params
-            else {}
+            )
         )
 
         input_params = {
@@ -1618,7 +1549,7 @@ class AppClient:
         program: bytes | None = None,
         approval_source_info: ProgramSourceInfo | None = None,
         clear_source_info: ProgramSourceInfo | None = None,
-    ) -> Exception:
+    ) -> LogicError | Exception:
         source_map = clear_source_map if is_clear_state_program else approval_source_map
 
         error_details = parse_logic_error(str(e))
@@ -1684,20 +1615,24 @@ class AppClient:
                     get_line_for_pc=custom_get_line_for_pc,
                     traces=None,
                 )
-
         if error_message:
             import re
 
             message = e.logic_error_str if isinstance(e, LogicError) else str(e)
             app_id = re.search(r"(?<=app=)\d+", message)
             tx_id = re.search(r"(?<=transaction )\S+(?=:)", message)
-            error = Exception(
+            runtime_error_message = (
                 f"Runtime error when executing {app_spec.name} "
                 f"(appId: {app_id.group() if app_id else 'N/A'}) in transaction "
                 f"{tx_id.group() if tx_id else 'N/A'}: {error_message}"
             )
-            error.__cause__ = e
-            return error
+            if isinstance(e, LogicError):
+                e.message = runtime_error_message
+                return e
+            else:
+                error = Exception(runtime_error_message)
+                error.__cause__ = e
+                return error
 
         return e
 

algokit_utils/applications/app_factory.py

@@ -23,7 +23,6 @@ from algokit_utils.applications.app_client import (
     AppClientBareCallParams,
     AppClientCompilationParams,
     AppClientCompilationResult,
-    AppClientCreateSchema,
     AppClientMethodCallCreateParams,
     AppClientMethodCallParams,
     AppClientParams,
@@ -88,17 +87,12 @@ class AppFactoryParams:
 
 
 @dataclass(kw_only=True, frozen=True)
-class _AppFactoryCreateBaseParams(AppClientCreateSchema):
+class AppFactoryCreateParams(AppClientBareCallCreateParams):
     on_complete: CreateOnComplete | None = None
 
 
 @dataclass(kw_only=True, frozen=True)
-class AppFactoryCreateParams(_AppFactoryCreateBaseParams, AppClientBareCallParams):
-    pass
-
-
-@dataclass(kw_only=True, frozen=True)
-class AppFactoryCreateMethodCallParams(_AppFactoryCreateBaseParams, AppClientMethodCallParams):
+class AppFactoryCreateMethodCallParams(AppClientMethodCallCreateParams):
     pass
 
 

algokit_utils/clients/dispenser_api_client.py

@@ -71,6 +71,9 @@ class TestNetDispenserApiClient:
     Default request timeout is 15 seconds. Modify by passing `request_timeout` to the constructor.
     """
 
+    # NOTE: ensures pytest does not think this is a test
+    # https://docs.pytest.org/en/stable/example/pythoncollection.html#customizing-test-collection
+    __test__ = False
     auth_token: str
     request_timeout = DISPENSER_REQUEST_TIMEOUT
 

algokit_utils/models/account.py

@@ -5,6 +5,7 @@ import algosdk.atomic_transaction_composer
 from algosdk.atomic_transaction_composer import AccountTransactionSigner, LogicSigTransactionSigner, TransactionSigner
 from algosdk.transaction import LogicSigAccount as AlgosdkLogicSigAccount
 from algosdk.transaction import Multisig, MultisigTransaction
+from typing_extensions import deprecated
 
 __all__ = [
     "DISPENSER_ACCOUNT_NAME",
@@ -66,6 +67,9 @@ class SigningAccount:
         """
         return AccountTransactionSigner(self.private_key)
 
+    @deprecated(
+        "Use `algorand.account.random()` or `SigningAccount(private_key=algosdk.account.generate_account()[0])` instead"
+    )
     @staticmethod
     def new_account() -> "SigningAccount":
         """Create a new random account.

algokit_utils/models/amount.py

@@ -1,34 +1,59 @@
 from __future__ import annotations
 
 from decimal import Decimal
+from typing import overload
 
 import algosdk
 from typing_extensions import Self
 
-__all__ = ["AlgoAmount"]
+__all__ = ["ALGORAND_MIN_TX_FEE", "AlgoAmount", "algo", "micro_algo", "transaction_fees"]
 
 
 class AlgoAmount:
     """Wrapper class to ensure safe, explicit conversion between µAlgo, Algo and numbers.
 
-    :param amount: A dictionary containing either algos, algo, microAlgos, or microAlgo as key
-                    and their corresponding value as an integer or Decimal.
-    :raises ValueError: If an invalid amount format is provided.
-
     :example:
-    >>> amount = AlgoAmount({"algos": 1})
-    >>> amount = AlgoAmount({"microAlgos": 1_000_000})
+    >>> amount = AlgoAmount(algos=1)
+    >>> amount = AlgoAmount(algo=1)
+    >>> amount = AlgoAmount.from_algos(1)
+    >>> amount = AlgoAmount.from_algo(1)
+    >>> amount = AlgoAmount(micro_algos=1_000_000)
+    >>> amount = AlgoAmount(micro_algo=1_000_000)
+    >>> amount = AlgoAmount.from_micro_algos(1_000_000)
+    >>> amount = AlgoAmount.from_micro_algo(1_000_000)
     """
 
-    def __init__(self, amount: dict[str, int | Decimal]):
-        if "microAlgos" in amount:
-            self.amount_in_micro_algo = int(amount["microAlgos"])
-        elif "microAlgo" in amount:
-            self.amount_in_micro_algo = int(amount["microAlgo"])
-        elif "algos" in amount:
-            self.amount_in_micro_algo = int(amount["algos"] * algosdk.constants.MICROALGOS_TO_ALGOS_RATIO)
-        elif "algo" in amount:
-            self.amount_in_micro_algo = int(amount["algo"] * algosdk.constants.MICROALGOS_TO_ALGOS_RATIO)
+    @overload
+    def __init__(self, *, micro_algos: int) -> None: ...
+
+    @overload
+    def __init__(self, *, micro_algo: int) -> None: ...
+
+    @overload
+    def __init__(self, *, algos: int | Decimal) -> None: ...
+
+    @overload
+    def __init__(self, *, algo: int | Decimal) -> None: ...
+
+    def __init__(
+        self,
+        *,
+        micro_algos: int | None = None,
+        micro_algo: int | None = None,
+        algos: int | Decimal | None = None,
+        algo: int | Decimal | None = None,
+    ):
+        if micro_algos is None and micro_algo is None and algos is None and algo is None:
+            raise ValueError("No amount provided")
+
+        if micro_algos is not None:
+            self.amount_in_micro_algo = int(micro_algos)
+        elif micro_algo is not None:
+            self.amount_in_micro_algo = int(micro_algo)
+        elif algos is not None:
+            self.amount_in_micro_algo = int(algos * algosdk.constants.MICROALGOS_TO_ALGOS_RATIO)
+        elif algo is not None:
+            self.amount_in_micro_algo = int(algo * algosdk.constants.MICROALGOS_TO_ALGOS_RATIO)
         else:
             raise ValueError("Invalid amount provided")
 
@@ -74,7 +99,7 @@ class AlgoAmount:
         :example:
         >>> amount = AlgoAmount.from_algos(1)
         """
-        return AlgoAmount({"algos": amount})
+        return AlgoAmount(algos=amount)
 
     @staticmethod
     def from_algo(amount: int | Decimal) -> AlgoAmount:
@@ -86,7 +111,7 @@ class AlgoAmount:
         :example:
         >>> amount = AlgoAmount.from_algo(1)
         """
-        return AlgoAmount({"algo": amount})
+        return AlgoAmount(algo=amount)
 
     @staticmethod
     def from_micro_algos(amount: int) -> AlgoAmount:
@@ -98,7 +123,7 @@ class AlgoAmount:
         :example:
         >>> amount = AlgoAmount.from_micro_algos(1_000_000)
         """
-        return AlgoAmount({"microAlgos": amount})
+        return AlgoAmount(micro_algos=amount)
 
     @staticmethod
     def from_micro_algo(amount: int) -> AlgoAmount:
@@ -110,7 +135,7 @@ class AlgoAmount:
         :example:
         >>> amount = AlgoAmount.from_micro_algo(1_000_000)
         """
-        return AlgoAmount({"microAlgo": amount})
+        return AlgoAmount(micro_algo=amount)
 
     def __str__(self) -> str:
         return f"{self.micro_algo:,} µALGO"
@@ -196,3 +221,36 @@ class AlgoAmount:
         else:
             raise TypeError(f"Unsupported operand type(s) for -: 'AlgoAmount' and '{type(other).__name__}'")
         return self
+
+
+# Helper functions
+def algo(algos: int) -> AlgoAmount:
+    """Create an AlgoAmount object representing the given number of Algo.
+
+    :param algos: The number of Algo to create an AlgoAmount object for.
+    :return: An AlgoAmount object representing the given number of Algo.
+    """
+    return AlgoAmount.from_algos(algos)
+
+
+def micro_algo(microalgos: int) -> AlgoAmount:
+    """Create an AlgoAmount object representing the given number of µAlgo.
+
+    :param microalgos: The number of µAlgo to create an AlgoAmount object for.
+    :return: An AlgoAmount object representing the given number of µAlgo.
+    """
+    return AlgoAmount.from_micro_algos(microalgos)
+
+
+ALGORAND_MIN_TX_FEE = micro_algo(1_000)
+
+
+def transaction_fees(number_of_transactions: int) -> AlgoAmount:
+    """Calculate the total transaction fees for a given number of transactions.
+
+    :param number_of_transactions: The number of transactions to calculate the fees for.
+    :return: The total transaction fees.
+    """
+
+    total_micro_algos = number_of_transactions * ALGORAND_MIN_TX_FEE.micro_algos
+    return micro_algo(total_micro_algos)

algokit_utils/transactions/transaction_composer.py

@@ -2,7 +2,6 @@ from __future__ import annotations
 
 import base64
 import json
-import math
 import re
 from copy import deepcopy
 from dataclasses import dataclass
@@ -796,6 +795,12 @@ def _find_available_transaction_index(
     return next((i for i, txn in enumerate(txns) if check_transaction(txn)), -1)
 
 
+def _num_extra_program_pages(approval: bytes | None, clear: bytes | None) -> int:
+    """Calculate minimum number of extra_pages required for provided approval and clear programs"""
+    total = len(approval or b"") + len(clear or b"")
+    return max(0, (total - 1) // algosdk.constants.APP_PAGE_MAX_SIZE)
+
+
 def populate_app_call_resources(atc: AtomicTransactionComposer, algod: AlgodClient) -> AtomicTransactionComposer:
     """Populate application call resources based on simulation results.
 
@@ -1975,12 +1980,7 @@ class TransactionComposer:
         if app_id == 0:
             extra_pages = getattr(params, "extra_program_pages", None)
             if extra_pages is None and approval_program is not None:
-                approval_len, clear_len = len(approval_program), len(clear_program or b"")
-                extra_pages = (
-                    int(math.floor((approval_len + clear_len) / algosdk.constants.APP_PAGE_MAX_SIZE))
-                    if approval_len
-                    else 0
-                )
+                extra_pages = _num_extra_program_pages(approval_program, clear_program)
 
         txn_params = {
             "app_id": app_id,
@@ -2085,9 +2085,6 @@ class TransactionComposer:
             elif isinstance(params.clear_state_program, bytes):
                 clear_program = params.clear_state_program
 
-        approval_program_len = len(approval_program) if approval_program else 0
-        clear_program_len = len(clear_program) if clear_program else 0
-
         sdk_params = {
             "sender": params.sender,
             "sp": suggested_params,
@@ -2120,10 +2117,7 @@ class TransactionComposer:
                     num_uints=params.schema.get("local_ints", 0),
                     num_byte_slices=params.schema.get("local_byte_slices", 0),
                 ),
-                "extra_pages": params.extra_program_pages
-                or math.floor((approval_program_len + clear_program_len) / algosdk.constants.APP_PAGE_MAX_SIZE)
-                if params.extra_program_pages
-                else 0,
+                "extra_pages": params.extra_program_pages or _num_extra_program_pages(approval_program, clear_program),
             }
 
         return self._common_txn_build_step(lambda x: algosdk.transaction.ApplicationCallTxn(**x), params, txn_params)

algokit_utils/transactions/transaction_sender.py

@@ -245,12 +245,12 @@ class AlgorandClientTransactionSender:
             compiled_approval = (
                 self._app_manager.get_compilation_result(params.approval_program)
                 if isinstance(params.approval_program, str)
-                else None
+                else params.approval_program
             )
             compiled_clear = (
                 self._app_manager.get_compilation_result(params.clear_state_program)
                 if isinstance(params.clear_state_program, str)
-                else None
+                else params.clear_state_program
             )
 
             return SendAppUpdateTransactionResult[ABIReturn](

{algokit_utils-3.0.0b2.dist-info → algokit_utils-3.0.0b4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: algokit-utils
-Version: 3.0.0b2
+Version: 3.0.0b4
 Summary: Utilities for Algorand development for use by AlgoKit
 License: MIT
 Author: Algorand Foundation
@@ -28,7 +28,7 @@ Largely these functions wrap the underlying Algorand SDK, but provide a higher l
 > **Note**
 > If you prefer TypeScript there's an equivalent [TypeScript utility library](https://github.com/algorandfoundation/algokit-utils-ts).
 
-[Install](https://github.com/algorandfoundation/algokit-utils-py#install) | [Documentation](https://algorandfoundation.github.io/algokit-utils-py/html/index.html)
+[Install](https://github.com/algorandfoundation/algokit-utils-py#install) | [Documentation](https://algorandfoundation.github.io/algokit-utils-py)
 
 ## Install
 

{algokit_utils-3.0.0b2.dist-info → algokit_utils-3.0.0b4.dist-info}/RECORD

@@ -14,16 +14,16 @@ algokit_utils/_legacy_v2/models.py,sha256=hH7aO50E4po4EgxXI9zdX5HTthn1HLfSLvkuPf
 algokit_utils/_legacy_v2/network_clients.py,sha256=5nqC-47hreWvMxR-PQWs_QP44wJDAGhtS1MQv8JQ82o,5660
 algokit_utils/account.py,sha256=gyGrBSoafUh8WV677IzYGkYoxtzzElsgxGMp4SgA4pk,410
 algokit_utils/accounts/__init__.py,sha256=_LyY0se6TaQOes7vAcmbpt6pmG4VKlzfTt37-IjwimA,138
-algokit_utils/accounts/account_manager.py,sha256=flONKOB2CbHUIOwtfcuJ_wNdDLW97-uE83teJHsCAGY,39319
+algokit_utils/accounts/account_manager.py,sha256=pQjfdDeoi5694QYD-EmvlVpuSvIYdFH_e0LKXkcwzRA,39369
 algokit_utils/accounts/kmd_account_manager.py,sha256=7HF2eKYULu6TAXSSXrSGZG7i6VuIEMyf6Ppmo5hE3EI,6342
 algokit_utils/algorand.py,sha256=Gtx3vspZmSxUrNWmh09NFQB24G4v4CEogYuRX_9o5Xw,10554
 algokit_utils/application_client.py,sha256=5UIxXIBjukjRyjZPCeXmaNlAftbb3TziV7EfBolW79k,337
-algokit_utils/application_specification.py,sha256=ACncbJVfXYd67M9rWkIJVXf-7Et-jLUpv2uESRraksM,1409
+algokit_utils/application_specification.py,sha256=-ZM13Qv-AcLmwudJCq8xGPoWLvAvKBICgAdHeFozKbY,1416
 algokit_utils/applications/__init__.py,sha256=NGjhpBeExsQZOAYCT2QUFag1xuKoFiX-Ux5SR2GNzd8,452
 algokit_utils/applications/abi.py,sha256=ZwiLuFXx2EwWJ_cOEvNWCzt5onoasm-QmQPv9N7d49g,10087
-algokit_utils/applications/app_client.py,sha256=WUdLu-aV4TUTd4R8y4RAi8EcP811rfO4AsSTiUmhm64,86013
+algokit_utils/applications/app_client.py,sha256=xHpcZhp6l1PO6OeY009rJ-T3rOyRAS7xrA3evAKI1Jk,83432
 algokit_utils/applications/app_deployer.py,sha256=RrSmIsbN84z0lNtGD8JP2FwkDmsAD_HvF8b4kHnCSmo,23099
-algokit_utils/applications/app_factory.py,sha256=yLe5TAss_r4JjE06rdtU7y2dmR9GrMh7JWG8ggApD-k,33605
+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
@@ -39,7 +39,7 @@ algokit_utils/beta/client_manager.py,sha256=xDFvsMSha0Ki42BGvKvfScQWT_W9y4GeP_RW
 algokit_utils/beta/composer.py,sha256=xDFvsMSha0Ki42BGvKvfScQWT_W9y4GeP_RWXjc3vnE,213
 algokit_utils/clients/__init__.py,sha256=qUuKBvfLnw4z6ZU9x7mc-mLjfnnXC9UcvtoeU33ZLJ8,136
 algokit_utils/clients/client_manager.py,sha256=DzJMf_jdQoZYNcy0sK34Uv-IenqJmfAupkqzo_Asp-A,25683
-algokit_utils/clients/dispenser_api_client.py,sha256=NDb6h7TVPR3qnkJNZIW1zlD5ufTlYLPnm5DeXCpR5Fc,5869
+algokit_utils/clients/dispenser_api_client.py,sha256=lx6II3beCt7YiKO2TrW6UbsRVirf3NoWMJi8HD_W5nI,6045
 algokit_utils/common.py,sha256=5wl83vWw91RYdEC4hTTufqaptKiFtgjKLIyONDmRSH0,300
 algokit_utils/config.py,sha256=Fd466a33pyqmblKn3YUEoSqMSGbKDmZeaS5Uu7_CNHw,7029
 algokit_utils/deploy.py,sha256=UUtSDI6JcBUuto62FuirhUlDcjZwQyLkiERgDMx8P7A,330
@@ -48,8 +48,8 @@ algokit_utils/errors/__init__.py,sha256=CmuiLVjzMAOYxPaIIwmYCNArsso_RtS2ssFoNdp5
 algokit_utils/errors/logic_error.py,sha256=uxqUOU9-D1R5TrKturCbmmWRVlB024Ca4CfVi8x_sgo,4104
 algokit_utils/logic_error.py,sha256=3duw-l6tBr-DeapO0e0tYHoa9rOxP-QZZ6QWmN8L9tc,305
 algokit_utils/models/__init__.py,sha256=0aB_c5pnkqKl1Z0hkxM9qbKn2qVdizZE2DvziN9ObqM,465
-algokit_utils/models/account.py,sha256=ruzbbGRL5L7LiFHBnlNMzJVDrJUwTMFq7IYhjk5oaQo,5829
-algokit_utils/models/amount.py,sha256=s9_2BCI5BOI_k9dnjNZZ0mNLwOOjlQyuTW4qgHUnTKI,7627
+algokit_utils/models/account.py,sha256=TdeKjhYkppD8g0DYRGbnCsi8zfPz3zU74DaZte_CYJw,6014
+algokit_utils/models/amount.py,sha256=2Eb5W9IduM4hqvWz0bpD8-8htKhhmUonaLCuz9c2_1w,9411
 algokit_utils/models/application.py,sha256=lM2_g5kZ18k_zyVzcbGvkvqHzksfb2sgRqowJ3pvUgo,1288
 algokit_utils/models/network.py,sha256=Qe631nHpLgjtGcwqWTc6D4Gk_5Fc_dutxD-bCTsb-xw,723
 algokit_utils/models/simulate.py,sha256=F9OSEfA9QGFGe5po24h8IGLor5z1ogu5Cwm3l6cHnAs,236
@@ -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=1JRtoDSRZw2lEzsTafnJE7SKAfrY0FffLa_nVWXZ8EU,94989
+algokit_utils/transactions/transaction_composer.py,sha256=yGLFgJk51BKgnwbGYmmuDIE7WPpZZmHqVAVZ7IWcRDQ,94794
 algokit_utils/transactions/transaction_creator.py,sha256=A1YHeGC2EkR2V0HPYJiXVOAEIrfjBW2KVyYgi3exm4E,6167
-algokit_utils/transactions/transaction_sender.py,sha256=83U9AuSkgQBCcyjLsyfYDi41VKVUHuC50_5UFWA5RFg,22728
-algokit_utils-3.0.0b2.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-3.0.0b2.dist-info/METADATA,sha256=2t6xOjJWexi71XknD5JtF8S5Y8BYABzNGKs82R6D22Q,2432
-algokit_utils-3.0.0b2.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-algokit_utils-3.0.0b2.dist-info/RECORD,,
+algokit_utils/transactions/transaction_sender.py,sha256=uQmHElJgUIxLXfdklMNoabjQQzUku8CFP82wwhfr44E,22769
+algokit_utils-3.0.0b4.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-3.0.0b4.dist-info/METADATA,sha256=-QVF-0xUq7DMn6ZLnL4uBA5M0pnI5yh2UrjuDOBFCOk,2416
+algokit_utils-3.0.0b4.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+algokit_utils-3.0.0b4.dist-info/RECORD,,