algokit-utils 1.2.0b8__py3-none-any.whl → 1.3.0b1__py3-none-any.whl

algokit_utils/__init__.py

@@ -83,6 +83,8 @@ from algokit_utils.network_clients import (
     get_kmd_client_from_algod_client,
     get_purestake_config,
     is_localnet,
+    is_mainnet,
+    is_testnet,
 )
 
 __all__ = [
@@ -155,6 +157,8 @@ __all__ = [
     "get_kmd_client_from_algod_client",
     "get_purestake_config",
     "is_localnet",
+    "is_mainnet",
+    "is_testnet",
     "EnsureBalanceParameters",
     "TransferParameters",
     "ensure_funded",

algokit_utils/deploy.py

@@ -489,7 +489,8 @@ class OnUpdate(Enum):
     """Update the Application with the new approval and clear programs"""
     ReplaceApp = 2
     """Create a new Application and delete the old Application in a single transaction"""
-    # TODO: AppendApp
+    AppendApp = 3
+    """Create a new application"""
 
 
 class OnSchemaBreak(Enum):
@@ -499,6 +500,8 @@ class OnSchemaBreak(Enum):
     """Fail the deployment"""
     ReplaceApp = 2
     """Create a new Application and delete the old Application in a single transaction"""
+    AppendApp = 3
+    """Create a new Application"""
 
 
 class OperationPerformed(Enum):
@@ -657,6 +660,10 @@ class Deployer:
                 "If you want to try deleting and recreating the app then "
                 "re-run with on_schema_break=OnSchemaBreak.ReplaceApp"
             )
+        if self.on_schema_break == OnSchemaBreak.AppendApp:
+            logger.info("Schema break detected and on_schema_break=AppendApp, will attempt to create new app")
+            return self._create_app()
+
         if self.existing_app_metadata_or_reference.deletable:
             logger.info(
                 "App is deletable and on_schema_break=ReplaceApp, will attempt to create new app and delete old app"
@@ -679,7 +686,10 @@ class Deployer:
                 "Update detected and on_update=Fail, stopping deployment. "
                 "If you want to try updating the app then re-run with on_update=UpdateApp"
             )
-        if self.existing_app_metadata_or_reference.updatable and self.on_update == OnUpdate.UpdateApp:
+        if self.on_update == OnUpdate.AppendApp:
+            logger.info("Update detected and on_update=AppendApp, will attempt to create new app")
+            return self._create_app()
+        elif self.existing_app_metadata_or_reference.updatable and self.on_update == OnUpdate.UpdateApp:
             logger.info("App is updatable and on_update=UpdateApp, will update app")
             return self._update_app()
         elif self.existing_app_metadata_or_reference.updatable and self.on_update == OnUpdate.ReplaceApp:

algokit_utils/models.py

@@ -2,6 +2,7 @@ import dataclasses
 from collections.abc import Sequence
 from typing import Any, Generic, Protocol, TypeAlias, TypedDict, TypeVar
 
+import algosdk.account
 from algosdk import transaction
 from algosdk.abi import Method
 from algosdk.atomic_transaction_composer import (
@@ -21,9 +22,13 @@ class Account:
 
     private_key: str
     """Base64 encoded private key"""
-    address: str
+    address: str = dataclasses.field(default="")
     """Address for this account"""
 
+    def __post_init__(self) -> None:
+        if not self.address:
+            self.address = algosdk.account.address_from_private_key(self.private_key)  # type: ignore[no-untyped-call]
+
     @property
     def public_key(self) -> bytes:
         """The public key for this account"""
@@ -36,6 +41,11 @@ class Account:
         """An AccountTransactionSigner for this account"""
         return AccountTransactionSigner(self.private_key)
 
+    @staticmethod
+    def new_account() -> "Account":
+        private_key, address = algosdk.account.generate_account()  # type: ignore[no-untyped-call]
+        return Account(private_key=private_key)
+
 
 @dataclasses.dataclass(kw_only=True)
 class TransactionResponse:

algokit_utils/network_clients.py

@@ -16,6 +16,8 @@ __all__ = [
     "get_kmd_client_from_algod_client",
     "get_purestake_config",
     "is_localnet",
+    "is_mainnet",
+    "is_testnet",
 ]
 
 _PURE_STAKE_HOST = "purestake.io"
@@ -82,6 +84,18 @@ def is_localnet(client: AlgodClient) -> bool:
     return params.gen in ["devnet-v1", "sandnet-v1", "dockernet-v1"]
 
 
+def is_mainnet(client: AlgodClient) -> bool:
+    """Returns True if client genesis is `mainnet-v1`"""
+    params = client.suggested_params()
+    return bool(params.gen == "mainnet-v1")
+
+
+def is_testnet(client: AlgodClient) -> bool:
+    """Returns True if client genesis is `testnet-v1`"""
+    params = client.suggested_params()
+    return bool(params.gen == "testnet-v1")
+
+
 def get_kmd_client_from_algod_client(client: AlgodClient) -> KMDClient:
     """Returns an {py:class}`algosdk.kmd.KMDClient` from supplied `client`
 

{algokit_utils-1.2.0b8.dist-info → algokit_utils-1.3.0b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: algokit-utils
-Version: 1.2.0b8
+Version: 1.3.0b1
 Summary: Utilities for Algorand development for use by AlgoKit
 License: MIT
 Author: Algorand Foundation

{algokit_utils-1.2.0b8.dist-info → algokit_utils-1.3.0b1.dist-info}/RECORD

@@ -1,16 +1,16 @@
-algokit_utils/__init__.py,sha256=wuh-p9PubCj9Bj2tpxP3tQ5qZPs_nUHzB16BHi9Aq2c,4091
+algokit_utils/__init__.py,sha256=Ko-gEPeER-Ho8lRU_a6k5SsV3mTfZa6CP1I9dmZjQvk,4159
 algokit_utils/_ensure_funded.py,sha256=DjwGnCC_6USLQV5wIMJZRVQFlQ1uLrGDMxRF471atsQ,4410
 algokit_utils/_simulate_315_compat.py,sha256=9qCsNnKa1FXYfCccMFiE0mGEcZJiBuPmUy7ZRvvUSqU,2841
 algokit_utils/_transfer.py,sha256=K8TMoaFcZE74xZ1rhp1De0Ri4mg8vs8pu-iJLOa5WoE,3569
 algokit_utils/account.py,sha256=UIuOQZe28pQxjEP9TzhtYlOU20tUdzzS-nIIZM9Bp6Y,7364
 algokit_utils/application_client.py,sha256=k3eTyhY3zyfpajHffo1uJ2u1C0vlYPmdALl5jmgH1WM,56488
 algokit_utils/application_specification.py,sha256=XusOe7VrGPun2UoNspC9Ei202NzPkxRNx5USXiABuXc,7466
-algokit_utils/deploy.py,sha256=UmVlJ-0vo91EjPXRC1EjkFBh5frJ0R4nCnlyZABhcRg,34168
+algokit_utils/deploy.py,sha256=sY6u0T39DuF6oLpal0eJAc76EmjPWdoCPk2OSKGccnM,34650
 algokit_utils/logic_error.py,sha256=8O_4rJ1t57JEG81ucRNih2ojc1-EOm2fVxW6m-1ZXI8,2550
-algokit_utils/models.py,sha256=1IXNhibqtZ7cmuH31mLvNLcpJzaMl9lOD0EqsTPyglU,5876
-algokit_utils/network_clients.py,sha256=dq8yyTLKtyb9yG3tsXV-eZLF3iqMaFWs9kNWm1V4CdU,4857
+algokit_utils/models.py,sha256=75tWWa3W-37Om3YgkcuKiuHAGzMkFIJ9U-eHO29RPi4,6319
+algokit_utils/network_clients.py,sha256=KmuSHG2kSdJfo9W4pIB_4RjnBL2yMQNGlF54lxXTnsQ,5267
 algokit_utils/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-algokit_utils-1.2.0b8.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
-algokit_utils-1.2.0b8.dist-info/METADATA,sha256=VjqC24FemTAouDXAwiChHgbjLRMXO89jHtN0uJLSHls,2072
-algokit_utils-1.2.0b8.dist-info/WHEEL,sha256=WGfLGfLX43Ei_YORXSnT54hxFygu34kMpcQdmgmEwCQ,88
-algokit_utils-1.2.0b8.dist-info/RECORD,,
+algokit_utils-1.3.0b1.dist-info/LICENSE,sha256=J5i7U1Q9Q2c7saUzlvFRmrCCFhQyXb5Juz_LO5omNUw,1076
+algokit_utils-1.3.0b1.dist-info/METADATA,sha256=75vQhThgjoQUr2xDl-t--FnVEl9bHz7kAs7LS4jVwns,2072
+algokit_utils-1.3.0b1.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+algokit_utils-1.3.0b1.dist-info/RECORD,,

{algokit_utils-1.2.0b8.dist-info → algokit_utils-1.3.0b1.dist-info}/WHEEL

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