algokit-utils 3.0.3b1__py3-none-any.whl → 4.0.0__py3-none-any.whl

algokit_utils/_legacy_v2/_ensure_funded.py

@@ -124,7 +124,7 @@ def ensure_funded(
     Funds a given account using a funding source to ensure it has sufficient spendable ALGOs.
 
     Ensures the target account has enough ALGOs free to spend after accounting for ALGOs locked in minimum balance
-    requirements. See https://developer.algorand.org/docs/get-details/accounts/#minimum-balance for details on minimum
+    requirements. See https://dev.algorand.co/concepts/smart-contracts/costs-constraints#mbr for details on minimum
     balance requirements.
 
     :param client: An instance of the AlgodClient class from the AlgoSDK library

algokit_utils/_legacy_v2/asset.py

@@ -73,7 +73,7 @@ def opt_in(algod_client: "AlgodClient", account: Account, asset_ids: list[int])
     """
     Opt-in to a list of assets on the Algorand blockchain. Before an account can receive a specific asset,
     it must `opt-in` to receive it. An opt-in transaction places an asset holding of 0 into the account and increases
-    its minimum balance by [100,000 microAlgos](https://developer.algorand.org/docs/get-details/asa/#assets-overview).
+    its minimum balance by [100,000 microAlgos](https://dev.algorand.co/concepts/assets/overview).
 
     :param algod_client: An instance of the AlgodClient class from the algosdk library.
     :param account: An instance of the Account class representing the account that wants to opt-in to the assets.

algokit_utils/accounts/account_manager.py

@@ -1,14 +1,14 @@
 import os
 from collections.abc import Callable
 from dataclasses import dataclass
-from typing import Any
+from typing import Any, overload
 
 import algosdk
 from algosdk import mnemonic
 from algosdk.atomic_transaction_composer import TransactionSigner
 from algosdk.mnemonic import to_private_key
 from algosdk.transaction import SuggestedParams
-from typing_extensions import Self
+from typing_extensions import Self, deprecated
 
 from algokit_utils.accounts.kmd_account_manager import KmdAccountManager
 from algokit_utils.clients.client_manager import ClientManager
@@ -71,7 +71,7 @@ class AccountInformation:
     """
     Information about an Algorand account's current status, balance and other properties.
 
-    See `https://developer.algorand.org/docs/rest-apis/algod/#account` for detailed field descriptions.
+    See `https://dev.algorand.co/reference/rest-apis/algod/#account` for detailed field descriptions.
     """
 
     address: str
@@ -215,6 +215,7 @@ class AccountManager:
         )
         return self
 
+    @overload
     def set_signer_from_account(self, account: TransactionSignerAccountProtocol) -> Self:
         """
         Tracks the given account for later signing.
@@ -227,11 +228,80 @@ class AccountManager:
 
         :example:
             >>> account_manager = AccountManager(client_manager)
-            >>> account_manager.set_signer_from_account(SigningAccount(private_key=algosdk.account.generate_account()[0]))
+            >>> 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]))
-        """  # noqa: E501
-        self._accounts[account.address] = account
+        """
+
+    @overload
+    @deprecated("Use set_signer_from_account(account) instead of set_signer_from_account(signer)")
+    def set_signer_from_account(self, signer: TransactionSignerAccountProtocol) -> Self:
+        """
+        Tracks the given account for later signing.
+
+        Note: If you are generating accounts via the various methods on `AccountManager`
+        (like `random`, `from_mnemonic`, `logic_sig`, etc.) then they automatically get tracked.
+
+        :param signer: The account to register (deprecated, use account parameter instead)
+        :returns: The `AccountManager` instance for method chaining
+
+        :example:
+            >>> account_manager = AccountManager(client_manager)
+            >>> 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]))
+        """
+
+    def set_signer_from_account(
+        self,
+        *args: TransactionSignerAccountProtocol,
+        **kwargs: TransactionSignerAccountProtocol,
+    ) -> Self:
+        """
+        Tracks the given account for later signing.
+
+        Note: If you are generating accounts via the various methods on `AccountManager`
+        (like `random`, `from_mnemonic`, `logic_sig`, etc.) then they automatically get tracked.
+
+        The method accepts either a positional argument or a keyword argument named 'account' or 'signer'.
+        The 'signer' parameter is deprecated and will show a warning when used.
+
+        :param *args: Variable positional arguments. The first argument should be a TransactionSignerAccountProtocol.
+        :param **kwargs: Variable keyword arguments. Can include 'account' or 'signer' (deprecated) as
+            TransactionSignerAccountProtocol.
+        :returns: The `AccountManager` instance for method chaining
+        :raises ValueError: If no account or signer argument is provided
+
+        :example:
+            >>> account_manager = AccountManager(client_manager)
+            >>> # Using positional argument
+            >>> account_manager.set_signer_from_account(
+            ...     SigningAccount(private_key=algosdk.account.generate_account()[0])
+            ... )
+            >>> # Using keyword argument 'account'
+            >>> account_manager.set_signer_from_account(
+            ...     account=LogicSigAccount(AlgosdkLogicSigAccount(program, args))
+            ... )
+            >>> # Using deprecated keyword argument 'signer'
+            >>> account_manager.set_signer_from_account(
+            ...     signer=MultiSigAccount(multisig_params, [account1, account2])
+            ... )
+        """
+        # Extract the account from either positional args or keyword args
+        if args:
+            account_obj = args[0]
+        elif "account" in kwargs:
+            account_obj = kwargs["account"]
+        elif "signer" in kwargs:
+            account_obj = kwargs["signer"]
+        else:
+            raise ValueError("Missing required argument: either 'account' or 'signer'")
+
+        self._accounts[account_obj.address] = account_obj
         return self
 
     def get_signer(self, sender: str | TransactionSignerAccountProtocol) -> TransactionSigner:
@@ -277,7 +347,7 @@ class AccountManager:
         """
         Returns the given sender account's current status, balance and spendable amounts.
 
-        See `<https://developer.algorand.org/docs/rest-apis/algod/#get-v2accountsaddress>`_
+        See `<https://dev.algorand.co/reference/rest-apis/algod/#account>`_
         for response data schema details.
 
         :param sender: The address or account compliant with `TransactionSignerAccountProtocol` protocol to look up
@@ -542,7 +612,7 @@ class AccountManager:
 
         .. warning::
             Please be careful with this function and be sure to read the
-            `official rekey guidance <https://developer.algorand.org/docs/get-details/accounts/rekey/>`_.
+            `official rekey guidance <https://dev.algorand.co/concepts/accounts/rekeying>`_.
 
         :example:
             >>> # Basic example (with string addresses):
@@ -623,7 +693,7 @@ class AccountManager:
         Ensures the given account has a certain amount of Algo free to spend (accounting for
         Algo locked in minimum balance requirement).
 
-        See `<https://developer.algorand.org/docs/get-details/accounts/#minimum-balance>`_ for details.
+        See `<https://dev.algorand.co/concepts/smart-contracts/costs-constraints#mbr>`_ for details.
 
         :param account_to_fund: The account to fund
         :param dispenser_account: The account to use as a dispenser funding source
@@ -725,7 +795,7 @@ class AccountManager:
         as a funding source such that the given account has a certain amount of Algo free to spend
         (accounting for Algo locked in minimum balance requirement).
 
-        See `<https://developer.algorand.org/docs/get-details/accounts/#minimum-balance>`_ for details.
+        See `<https://dev.algorand.co/concepts/smart-contracts/costs-constraints#mbr>`_ for details.
 
         :param account_to_fund: The account to fund
         :param min_spending_balance: The minimum balance of Algo that the account should have available to
@@ -818,7 +888,7 @@ class AccountManager:
         Uses the TestNet Dispenser API as a funding source such that the account has a certain amount
         of Algo free to spend (accounting for Algo locked in minimum balance requirement).
 
-        See `<https://developer.algorand.org/docs/get-details/accounts/#minimum-balance>`_ for details.
+        See `<https://dev.algorand.co/concepts/smart-contracts/costs-constraints#mbr>`_ for details.
 
         :param account_to_fund: The account to fund
         :param dispenser_client: The TestNet dispenser funding client

algokit_utils/clients/dispenser_api_client.py

@@ -144,8 +144,8 @@ class TestNetDispenserApiClient:
     @overload
     def fund(self, address: str, amount: int) -> DispenserFundResponse: ...
 
-    @deprecated("Asset ID parameter is deprecated. Can now use `fund(address, amount)` instead.")
     @overload
+    @deprecated("Asset ID parameter is deprecated. Can now use `fund(address, amount)` instead.")
     def fund(self, address: str, amount: int, asset_id: int | None = None) -> DispenserFundResponse: ...
 
     def fund(self, address: str, amount: int, asset_id: int | None = None) -> DispenserFundResponse:  # noqa: ARG002

algokit_utils/config.py

@@ -59,7 +59,7 @@ class UpdatableConfig:
         self._trace_all: bool = False
         self._trace_buffer_size_mb: int | float = 256  # megabytes
         self._max_search_depth: int = 10
-        self._populate_app_call_resources: bool = False
+        self._populate_app_call_resources: bool = True
         self._configure_project_root()
 
     def _configure_project_root(self) -> None:
@@ -123,7 +123,7 @@ class UpdatableConfig:
         trace_all: bool = False,
         trace_buffer_size_mb: float = 256,
         max_search_depth: int = 10,
-        populate_app_call_resources: bool = False,
+        populate_app_call_resources: bool = True,
         logger: logging.Logger | None = None,
     ) -> None:
         """
@@ -134,7 +134,7 @@ class UpdatableConfig:
         :param trace_all: Whether to trace all operations. Defaults to False.
         :param trace_buffer_size_mb: The trace buffer size in megabytes. Defaults to 256.
         :param max_search_depth: The maximum depth to search for a specific file. Defaults to 10.
-        :param populate_app_call_resources: Whether to populate app call resources. Defaults to False.
+        :param populate_app_call_resources: Whether to populate app call resources. Defaults to True.
         :param logger: A custom logger to use. Defaults to AlgoKitLogger instance.
         """
         if logger is not None:

algokit_utils/transactions/transaction_composer.py

@@ -831,7 +831,11 @@ def prepare_group_for_sending(  # noqa: C901, PLR0912, PLR0915
     """
     # Get execution info via simulation
     execution_info = _get_group_execution_info(
-        atc, algod, populate_app_call_resources, cover_app_call_inner_transaction_fees, additional_atc_context
+        atc,
+        algod,
+        populate_app_call_resources if populate_app_call_resources is not None else config.populate_app_call_resource,
+        cover_app_call_inner_transaction_fees,
+        additional_atc_context,
     )
     max_fees = additional_atc_context.max_fees if additional_atc_context else None
 
@@ -1971,8 +1975,7 @@ class TransactionComposer:
         pattern = r"^[a-zA-Z0-9][a-zA-Z0-9_/@.-]{4,31}$"
         if not re.match(pattern, note["dapp_name"]):
             raise ValueError(
-                "dapp_name must be 5-32 chars, start with alphanumeric, "
-                "and contain only alphanumeric, _, /, @, ., or -"
+                "dapp_name must be 5-32 chars, start with alphanumeric, and contain only alphanumeric, _, /, @, ., or -"
             )
 
         data = note["data"]

{algokit_utils-3.0.3b1.dist-info → algokit_utils-4.0.0.dist-info}/METADATA

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

{algokit_utils-3.0.3b1.dist-info → algokit_utils-4.0.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
 algokit_utils/__init__.py,sha256=he0sKUGvOgN2ROlXJ_6GOBqElfoDy3c5_XgVA3BYACU,1039
 algokit_utils/_debugging.py,sha256=nAiC10WXiZsvc0RPWOrMLpjJQZT_ItgcMl7D9Z4DfYc,11703
 algokit_utils/_legacy_v2/__init__.py,sha256=WcRE30axWjGnBB09bJCeTw9NT-2_jDN_CVJITFcIDc8,4689
-algokit_utils/_legacy_v2/_ensure_funded.py,sha256=_k3hc_xL-_KOEmvF3mofk-Z2D1n8dSo9Rz8OLqPnoNg,6912
+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/application_specification.py,sha256=wp2Y9ou2_F-bSFbDnm6AEhFexybmD7-fAT0CuWtO26g,521
-algokit_utils/_legacy_v2/asset.py,sha256=b4GEzsPuHAbb330ZjoyY3lol0SisQGwJiOpnXvuXvJI,7594
+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/logic_error.py,sha256=pmaMTuvbOD7PHukSY4epzJRptSivc4O0vFZdW_zzZ38,345
@@ -14,7 +14,7 @@ algokit_utils/_legacy_v2/models.py,sha256=hH7aO50E4po4EgxXI9zdX5HTthn1HLfSLvkuPf
 algokit_utils/_legacy_v2/network_clients.py,sha256=z_zm1da9CVBG2TOAnXeYkHBh6a8HtXsSdNrlEizc8J0,5928
 algokit_utils/account.py,sha256=gyGrBSoafUh8WV677IzYGkYoxtzzElsgxGMp4SgA4pk,410
 algokit_utils/accounts/__init__.py,sha256=_LyY0se6TaQOes7vAcmbpt6pmG4VKlzfTt37-IjwimA,138
-algokit_utils/accounts/account_manager.py,sha256=LEqAp4AAssUugWG4PkOHw9oVmhIK-iZMGYcR7_q6zT0,38997
+algokit_utils/accounts/account_manager.py,sha256=dIECz1QzkvV4bzsqoUJ4cRzJ6evHcRM2TpQpBf8l0ng,42242
 algokit_utils/accounts/kmd_account_manager.py,sha256=qPlklyoIk0B6B78GZX-VKwSgmfZBKgp5U2k51fg1YXg,6459
 algokit_utils/algorand.py,sha256=OvYMolOGK-tupKLDohtP_P59jlELIWW2hRqf1CYfrns,13732
 algokit_utils/application_client.py,sha256=5UIxXIBjukjRyjZPCeXmaNlAftbb3TziV7EfBolW79k,337
@@ -39,9 +39,9 @@ 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=eTkgaDVRl-auRnd_t3tQQzdrpLky6I1rQLR_1ZUXmrw,28615
-algokit_utils/clients/dispenser_api_client.py,sha256=TL4BZqRS81y55NVi_1Fczqkw8EmRcRavHTHkaSLw-t4,7336
+algokit_utils/clients/dispenser_api_client.py,sha256=3TgbnQsDmC9zSfDIykwNKDadbXLhQKZxUSbPwTDJISY,7336
 algokit_utils/common.py,sha256=5wl83vWw91RYdEC4hTTufqaptKiFtgjKLIyONDmRSH0,300
-algokit_utils/config.py,sha256=SFqfR_JKlx-pCOps1xF646oZqtIcRS2AtasiYne63E4,6051
+algokit_utils/config.py,sha256=CvDH5B8uPWnm6wCHHlMsl-0lONzq26vPLvwmnbw7c-k,6048
 algokit_utils/deploy.py,sha256=UUtSDI6JcBUuto62FuirhUlDcjZwQyLkiERgDMx8P7A,330
 algokit_utils/dispenser_api.py,sha256=-EO4Dq3q_v4kSMey43kXJfoX8uCBPJpjEMTlLI7xn_I,324
 algokit_utils/errors/__init__.py,sha256=CmuiLVjzMAOYxPaIIwmYCNArsso_RtS2ssFoNdp5CMs,61
@@ -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=x_pCYWaOQvigzTWPN9KwnmUZGC_MvgxYsCtY0HXqJPw,104042
+algokit_utils/transactions/transaction_composer.py,sha256=66_vY6DNs4gDhLRAamtzzo7oeLM8nxS9QKwZY_tidYc,104138
 algokit_utils/transactions/transaction_creator.py,sha256=cuP6Xm-fhGoCc2FNSbLiEg3iQRwW38rfdTzsqPyEcpM,29053
 algokit_utils/transactions/transaction_sender.py,sha256=foK_2S-gUl9D7xkWG3lD526qIKz5mVibHNKVREQCgoA,50079
-algokit_utils-3.0.3b1.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-3.0.3b1.dist-info/METADATA,sha256=c58s4IG_nnES-xqFkIJk6EMTcvq9FpRiTEmIxDqumYw,2420
-algokit_utils-3.0.3b1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-algokit_utils-3.0.3b1.dist-info/RECORD,,
+algokit_utils-4.0.0.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-4.0.0.dist-info/METADATA,sha256=u8F32Z2gvnS71zPzFOu8tkP9P65MyyJNWmFwPHkDBe4,2418
+algokit_utils-4.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+algokit_utils-4.0.0.dist-info/RECORD,,