algokit-utils 5.0.0a3__py3-none-any.whl

algokit_utils/applications/app_deployer.py

@@ -0,0 +1,788 @@
+import base64
+import dataclasses
+import json
+from dataclasses import asdict, dataclass, fields
+from typing import Literal, TypeVar
+
+from algokit_algod_client import models as algod_models
+from algokit_common import get_application_address
+from algokit_indexer_client import IndexerClient
+from algokit_utils.applications.abi import ABIReturn
+from algokit_utils.applications.app_manager import AppManager
+from algokit_utils.applications.enums import OnSchemaBreak, OnUpdate, OperationPerformed
+from algokit_utils.config import config
+from algokit_utils.models.state import TealTemplateParams
+from algokit_utils.models.transaction import SendParams
+from algokit_utils.transactions.transaction_composer import (
+    AppCreateMethodCallParams,
+    AppCreateParams,
+    AppDeleteMethodCallParams,
+    AppDeleteParams,
+    AppUpdateMethodCallParams,
+    AppUpdateParams,
+    TransactionComposer,
+    calculate_extra_program_pages,
+)
+from algokit_utils.transactions.transaction_sender import (
+    AlgorandClientTransactionSender,
+    SendAppCreateTransactionResult,
+    SendAppTransactionResult,
+    SendAppUpdateTransactionResult,
+)
+
+__all__ = [
+    "APP_DEPLOY_NOTE_DAPP",
+    "AppDeployParams",
+    "AppDeployResult",
+    "AppDeployer",
+    "AppDeploymentMetaData",
+    "ApplicationLookup",
+    "ApplicationMetaData",
+    "ApplicationReference",
+    "OnSchemaBreak",
+    "OnUpdate",
+    "OperationPerformed",
+]
+
+
+APP_DEPLOY_NOTE_DAPP: str = "ALGOKIT_DEPLOYER"
+
+
+@dataclasses.dataclass
+class AppDeploymentMetaData:
+    """Metadata about an application stored in a transaction note during creation."""
+
+    name: str
+    version: str
+    deletable: bool | None
+    updatable: bool | None
+
+    def dictify(self) -> dict[str, str | bool]:
+        return {k: v for k, v in asdict(self).items() if v is not None}
+
+
+@dataclasses.dataclass(frozen=True)
+class ApplicationReference:
+    """Information about an Algorand app"""
+
+    app_id: int
+    app_address: str
+
+
+@dataclasses.dataclass(frozen=True)
+class ApplicationMetaData:
+    """Complete metadata about a deployed app"""
+
+    reference: ApplicationReference
+    deploy_metadata: AppDeploymentMetaData
+    created_round: int
+    updated_round: int
+    deleted: bool = False
+
+    @property
+    def app_id(self) -> int:
+        return self.reference.app_id
+
+    @property
+    def app_address(self) -> str:
+        return self.reference.app_address
+
+    @property
+    def name(self) -> str:
+        return self.deploy_metadata.name
+
+    @property
+    def version(self) -> str:
+        return self.deploy_metadata.version
+
+    @property
+    def deletable(self) -> bool | None:
+        return self.deploy_metadata.deletable
+
+    @property
+    def updatable(self) -> bool | None:
+        return self.deploy_metadata.updatable
+
+
+@dataclasses.dataclass
+class ApplicationLookup:
+    """Cache of {py:class}`ApplicationMetaData` for a specific `creator`
+
+    Can be used as an argument to {py:class}`AppClient` to reduce the number of calls when deploying multiple
+    apps or discovering multiple app_ids
+    """
+
+    creator: str
+    apps: dict[str, ApplicationMetaData] = dataclasses.field(default_factory=dict)
+
+
+@dataclass(kw_only=True)
+class AppDeployParams:
+    """Parameters for deploying an app"""
+
+    metadata: AppDeploymentMetaData
+    """The deployment metadata"""
+    deploy_time_params: TealTemplateParams | None = None
+    """Optional template parameters to use during compilation"""
+    on_schema_break: (Literal["replace", "fail", "append"] | OnSchemaBreak) | None = None
+    """Optional on schema break action"""
+    on_update: (Literal["update", "replace", "fail", "append"] | OnUpdate) | None = None
+    """Optional on update action"""
+    create_params: AppCreateParams | AppCreateMethodCallParams
+    """The creation parameters"""
+    update_params: AppUpdateParams | AppUpdateMethodCallParams
+    """The update parameters"""
+    delete_params: AppDeleteParams | AppDeleteMethodCallParams
+    """The deletion parameters"""
+    existing_deployments: ApplicationLookup | None = None
+    """Optional existing deployments"""
+    ignore_cache: bool = False
+    """Whether to ignore the cache"""
+    max_fee: int | None = None
+    """Optional maximum fee"""
+    send_params: SendParams | None = None
+    """Optional send parameters"""
+
+
+# Union type for all possible deploy results
+@dataclass(frozen=True)
+class AppDeployResult:
+    """The result of a deployment"""
+
+    app: ApplicationMetaData
+    """The application metadata"""
+    operation_performed: OperationPerformed
+    """The operation performed"""
+    create_result: SendAppCreateTransactionResult[ABIReturn] | None = None
+    """The create result"""
+    update_result: SendAppUpdateTransactionResult[ABIReturn] | None = None
+    """The update result"""
+    delete_result: SendAppTransactionResult[ABIReturn] | None = None
+    """The delete result"""
+
+
+class AppDeployer:
+    """Manages deployment and deployment metadata of applications
+
+    :param app_manager: The app manager to use
+    :param transaction_sender: The transaction sender to use
+    :param indexer: The indexer to use
+
+    :example:
+        >>> deployer = AppDeployer(app_manager, transaction_sender, indexer)
+    """
+
+    def __init__(
+        self,
+        app_manager: AppManager,
+        transaction_sender: AlgorandClientTransactionSender,
+        indexer: IndexerClient | None = None,
+    ):
+        self._app_manager = app_manager
+        self._transaction_sender = transaction_sender
+        self._indexer = indexer
+        self._app_lookups: dict[str, ApplicationLookup] = {}
+
+    def deploy(self, deployment: AppDeployParams) -> AppDeployResult:
+        """Idempotently deploy (create if not exists, update if changed) an app against the given name for the given
+        creator account, including deploy-time TEAL template placeholder substitutions (if specified).
+
+        To understand the architecture decisions behind this functionality please see
+        https://github.com/algorandfoundation/algokit-cli/blob/main/docs/architecture-decisions/2023-01-12_smart-contract-deployment.md
+
+        **Note:** When using the return from this function be sure to check `operation_performed` to get access to
+        return properties like `transaction`, `confirmation` and `delete_result`.
+
+        **Note:** if there is a breaking state schema change to an existing app (and `on_schema_break` is set to
+        `'replace'`) the existing app will be deleted and re-created.
+
+        **Note:** if there is an update (different TEAL code) to an existing app (and `on_update` is set to `'replace'`)
+        the existing app will be deleted and re-created.
+
+        :param deployment: The arguments to control the app deployment
+        :returns: The result of the deployment
+        :raises ValueError: If the app spec format is invalid
+
+        :example:
+            >>> deployer.deploy(AppDeployParams(
+            ...     create_params=AppCreateParams(
+            ...         sender='SENDER_ADDRESS',
+            ...         approval_program='APPROVAL PROGRAM',
+            ...         clear_state_program='CLEAR PROGRAM',
+            ...         schema={
+            ...             'global_byte_slices': 0,
+            ...             'global_ints': 0,
+            ...             'local_byte_slices': 0,
+            ...             'local_ints': 0
+            ...         }
+            ...     ),
+            ...     update_params=AppUpdateParams(
+            ...         sender='SENDER_ADDRESS'
+            ...     ),
+            ...     delete_params=AppDeleteParams(
+            ...         sender='SENDER_ADDRESS'
+            ...     ),
+            ...     metadata=AppDeploymentMetaData(
+            ...         name='my_app',
+            ...         version='2.0',
+            ...         updatable=False,
+            ...         deletable=False
+            ...     ),
+            ...     on_schema_break=OnSchemaBreak.AppendApp,
+            ...     on_update=OnUpdate.AppendApp
+            ... )
+            ... )
+        """
+
+        # Create new instances with updated notes
+        send_params = deployment.send_params or SendParams()
+        suppress_log = send_params.get("suppress_log") or False
+
+        config.logger.info(
+            f'Idempotently deploying app "{deployment.metadata.name}" from creator '
+            f"{deployment.create_params.sender} using {len(deployment.create_params.approval_program)} bytes of "
+            f"{'teal code' if isinstance(deployment.create_params.approval_program, str) else 'AVM bytecode'} and "
+            f"{len(deployment.create_params.clear_state_program)} bytes of "
+            f"{'teal code' if isinstance(deployment.create_params.clear_state_program, str) else 'AVM bytecode'}",
+            extra={"suppress_log": suppress_log},
+        )
+        note = TransactionComposer.arc2_note(
+            {
+                "dapp_name": APP_DEPLOY_NOTE_DAPP,
+                "format": "j",
+                "data": deployment.metadata.dictify(),
+            }
+        )
+        create_params = dataclasses.replace(deployment.create_params, note=note)
+        update_params = dataclasses.replace(deployment.update_params, note=note)
+
+        deployment = dataclasses.replace(
+            deployment,
+            create_params=create_params,
+            update_params=update_params,
+        )
+
+        # Validate inputs
+        if (
+            deployment.existing_deployments
+            and deployment.existing_deployments.creator != deployment.create_params.sender
+        ):
+            raise ValueError(
+                f"Received invalid existingDeployments value for creator "
+                f"{deployment.existing_deployments.creator} when attempting to deploy "
+                f"for creator {deployment.create_params.sender}"
+            )
+
+        if not deployment.existing_deployments and not self._indexer:
+            raise ValueError(
+                "Didn't receive an indexer client when this AppManager was created, "
+                "but also didn't receive an existingDeployments cache - one of them must be provided"
+            )
+
+        # Compile code if needed
+        approval_program = deployment.create_params.approval_program
+        clear_program = deployment.create_params.clear_state_program
+
+        if isinstance(approval_program, str):
+            compiled_approval = self._app_manager.compile_teal_template(
+                approval_program,
+                deployment.deploy_time_params,
+                deployment.metadata.__dict__,
+            )
+            approval_program = compiled_approval.compiled_base64_to_bytes
+
+        if isinstance(clear_program, str):
+            compiled_clear = self._app_manager.compile_teal_template(
+                clear_program,
+                deployment.deploy_time_params,
+            )
+            clear_program = compiled_clear.compiled_base64_to_bytes
+
+        # Get existing app metadata
+        apps = deployment.existing_deployments or self.get_creator_apps_by_name(
+            creator_address=deployment.create_params.sender,
+            ignore_cache=deployment.ignore_cache,
+        )
+
+        existing_app = apps.apps.get(deployment.metadata.name)
+        if not existing_app or existing_app.deleted:
+            return self._create_app(
+                deployment=deployment,
+                approval_program=approval_program,
+                clear_program=clear_program,
+            )
+
+        # Check for changes
+        existing_app_record = self._app_manager.get_by_id(existing_app.app_id)
+
+        existing_approval = base64.b64encode(existing_app_record.approval_program).decode()
+        existing_clear = base64.b64encode(existing_app_record.clear_state_program).decode()
+        extra_pages = existing_app_record.extra_program_pages or 0
+
+        calculate_extra_program_pages(existing_app_record.approval_program, existing_app_record.clear_state_program)
+
+        new_approval = base64.b64encode(approval_program).decode()
+        new_clear = base64.b64encode(clear_program).decode()
+        new_extra_pages = calculate_extra_program_pages(approval_program, clear_program)
+
+        is_update = new_approval != existing_approval or new_clear != existing_clear
+        is_schema_break = (
+            existing_app_record.local_ints
+            < (deployment.create_params.schema.get("local_ints", 0) if deployment.create_params.schema else 0)
+            or existing_app_record.global_ints
+            < (deployment.create_params.schema.get("global_ints", 0) if deployment.create_params.schema else 0)
+            or existing_app_record.local_byte_slices
+            < (deployment.create_params.schema.get("local_byte_slices", 0) if deployment.create_params.schema else 0)
+            or existing_app_record.global_byte_slices
+            < (deployment.create_params.schema.get("global_byte_slices", 0) if deployment.create_params.schema else 0)
+            or extra_pages < new_extra_pages
+        )
+
+        if is_schema_break:
+            config.logger.warning(
+                f"Detected a breaking app schema change in app {existing_app.app_id}:",
+                extra={
+                    "from": {
+                        "global_ints": existing_app_record.global_ints,
+                        "global_byte_slices": existing_app_record.global_byte_slices,
+                        "local_ints": existing_app_record.local_ints,
+                        "local_byte_slices": existing_app_record.local_byte_slices,
+                    },
+                    "to": deployment.create_params.schema,
+                    "suppress_log": suppress_log,
+                },
+            )
+
+            return self._handle_schema_break(
+                deployment=deployment,
+                existing_app=existing_app,
+                approval_program=approval_program,
+                clear_program=clear_program,
+            )
+
+        if is_update:
+            config.logger.info(
+                f"Detected a TEAL update in app {existing_app.app_id} for creator {deployment.create_params.sender}",
+                extra={"suppress_log": suppress_log},
+            )
+            return self._handle_update(
+                deployment=deployment,
+                existing_app=existing_app,
+                approval_program=approval_program,
+                clear_program=clear_program,
+            )
+
+        config.logger.debug("No detected changes in app, nothing to do.", extra={"suppress_log": suppress_log})
+        return AppDeployResult(
+            app=existing_app,
+            operation_performed=OperationPerformed.Nothing,
+        )
+
+    def _create_app(
+        self,
+        deployment: AppDeployParams,
+        approval_program: bytes,
+        clear_program: bytes,
+    ) -> AppDeployResult:
+        """Create a new application"""
+
+        if isinstance(deployment.create_params, AppCreateMethodCallParams):
+            create_result = self._transaction_sender.app_create_method_call(
+                extend(
+                    AppCreateMethodCallParams,
+                    deployment.create_params,
+                    approval_program=approval_program,
+                    clear_state_program=clear_program,
+                ),
+                send_params=deployment.send_params,
+            )
+        else:
+            create_result = self._transaction_sender.app_create(
+                extend(
+                    AppCreateParams,
+                    deployment.create_params,
+                    approval_program=approval_program,
+                    clear_state_program=clear_program,
+                ),
+                send_params=deployment.send_params,
+            )
+
+        app_metadata = ApplicationMetaData(
+            reference=ApplicationReference(
+                app_id=create_result.app_id, app_address=get_application_address(create_result.app_id)
+            ),
+            deploy_metadata=deployment.metadata,
+            created_round=_get_confirmed_round(create_result.confirmation),
+            updated_round=_get_confirmed_round(create_result.confirmation),
+            deleted=False,
+        )
+
+        self._update_app_lookup(deployment.create_params.sender, app_metadata)
+        config.logger.debug(
+            f"Sent transaction ID {create_result.app_id} (AppCreate) from {deployment.create_params.sender}",
+            extra={
+                "suppress_log": deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+            },
+        )
+
+        return AppDeployResult(
+            app=app_metadata,
+            operation_performed=OperationPerformed.Create,
+            create_result=create_result,
+        )
+
+    def _replace_app(
+        self,
+        deployment: AppDeployParams,
+        existing_app: ApplicationMetaData,
+        approval_program: bytes,
+        clear_program: bytes,
+    ) -> AppDeployResult:
+        composer = self._transaction_sender.new_group()
+
+        # Add create transaction
+        has_abi_create = isinstance(deployment.create_params, AppCreateMethodCallParams)
+        if has_abi_create:
+            composer.add_app_create_method_call(
+                AppCreateMethodCallParams(
+                    **{
+                        **deployment.create_params.__dict__,
+                        "approval_program": approval_program,
+                        "clear_state_program": clear_program,
+                    }
+                )
+            )
+        else:
+            composer.add_app_create(
+                AppCreateParams(
+                    **{
+                        **deployment.create_params.__dict__,
+                        "approval_program": approval_program,
+                        "clear_state_program": clear_program,
+                    }
+                )
+            )
+
+        # Add delete transaction
+        has_abi_delete = isinstance(deployment.delete_params, AppDeleteMethodCallParams)
+        if has_abi_delete:
+            delete_call_params = AppDeleteMethodCallParams(
+                **{
+                    **deployment.delete_params.__dict__,
+                    "app_id": existing_app.app_id,
+                }
+            )
+            composer.add_app_delete_method_call(delete_call_params)
+        else:
+            delete_params = AppDeleteParams(
+                **{
+                    **deployment.delete_params.__dict__,
+                    "app_id": existing_app.app_id,
+                }
+            )
+            composer.add_app_delete(delete_params)
+
+        result = composer.send(deployment.send_params)
+
+        create_result = SendAppCreateTransactionResult[ABIReturn].from_composer_result(
+            result, is_abi=has_abi_create, index=0
+        )
+        delete_result = SendAppTransactionResult[ABIReturn].from_composer_result(
+            result, is_abi=has_abi_delete, index=-1
+        )
+
+        app_id_raw = result.confirmations[0].app_id
+        if app_id_raw is None:
+            raise ValueError("Could not determine app_id from transaction confirmation")
+        assert app_id_raw is not None
+        app_id = int(app_id_raw)
+        app_metadata = ApplicationMetaData(
+            reference=ApplicationReference(app_id=app_id, app_address=get_application_address(app_id)),
+            deploy_metadata=deployment.metadata,
+            created_round=_get_confirmed_round(result.confirmations[0]),
+            updated_round=_get_confirmed_round(result.confirmations[0]),
+            deleted=False,
+        )
+        self._update_app_lookup(deployment.create_params.sender, app_metadata)
+        config.logger.debug(
+            f"Group transaction sent: Replaced app {existing_app.app_id} with new app {app_id} from "
+            f"{deployment.create_params.sender} (Composer group count: {composer.count()})",
+            extra={
+                "suppress_log": deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+            },
+        )
+
+        return AppDeployResult(
+            app=app_metadata,
+            operation_performed=OperationPerformed.Replace,
+            create_result=create_result,
+            update_result=None,
+            delete_result=delete_result,
+        )
+
+    def _update_app(
+        self,
+        deployment: AppDeployParams,
+        existing_app: ApplicationMetaData,
+        approval_program: bytes,
+        clear_program: bytes,
+    ) -> AppDeployResult:
+        """Update an existing application"""
+
+        if isinstance(deployment.update_params, AppUpdateMethodCallParams):
+            result = self._transaction_sender.app_update_method_call(
+                AppUpdateMethodCallParams(
+                    **{
+                        **deployment.update_params.__dict__,
+                        "app_id": existing_app.app_id,
+                        "approval_program": approval_program,
+                        "clear_state_program": clear_program,
+                    }
+                ),
+                send_params=deployment.send_params,
+            )
+        else:
+            result = self._transaction_sender.app_update(
+                AppUpdateParams(
+                    **{
+                        **deployment.update_params.__dict__,
+                        "app_id": existing_app.app_id,
+                        "approval_program": approval_program,
+                        "clear_state_program": clear_program,
+                    }
+                ),
+                send_params=deployment.send_params,
+            )
+
+        app_metadata = ApplicationMetaData(
+            reference=ApplicationReference(app_id=existing_app.app_id, app_address=existing_app.app_address),
+            deploy_metadata=deployment.metadata,
+            created_round=existing_app.created_round,
+            updated_round=_get_confirmed_round(result.confirmation),
+            deleted=False,
+        )
+
+        self._update_app_lookup(deployment.create_params.sender, app_metadata)
+        config.logger.debug(
+            f"Sent transaction ID {existing_app.app_id} (AppUpdate) from {deployment.create_params.sender}",
+            extra={
+                "suppress_log": deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+            },
+        )
+
+        return AppDeployResult(
+            app=app_metadata,
+            operation_performed=OperationPerformed.Update,
+            update_result=result,
+        )
+
+    def _handle_schema_break(
+        self,
+        deployment: AppDeployParams,
+        existing_app: ApplicationMetaData,
+        approval_program: bytes,
+        clear_program: bytes,
+    ) -> AppDeployResult:
+        suppress_log = deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+
+        if deployment.on_schema_break in (OnSchemaBreak.Fail, "fail") or deployment.on_schema_break is None:
+            raise ValueError(
+                "Schema break detected and on_schema_break=OnSchemaBreak.Fail, stopping deployment. "
+                "If you want to try deleting and recreating the app then "
+                "re-run with on_schema_break=OnSchemaBreak.ReplaceApp"
+            )
+
+        if deployment.on_schema_break in (OnSchemaBreak.AppendApp, "append"):
+            config.logger.info(
+                "on_schema_break=AppendApp, will attempt to create a new app", extra={"suppress_log": suppress_log}
+            )
+            return self._create_app(deployment, approval_program, clear_program)
+
+        if existing_app.deletable:
+            config.logger.info(
+                "App is deletable and on_schema_break=ReplaceApp, will attempt to create new app and delete old app",
+                extra={"suppress_log": suppress_log},
+            )
+        else:
+            config.logger.info(
+                "App is not deletable but on_schema_break=ReplaceApp, will attempt to create a new app and "
+                "delete the old app, delete will most likely fail",
+                extra={
+                    "suppress_log": suppress_log,
+                },
+            )
+
+        return self._replace_app(deployment, existing_app, approval_program, clear_program)
+
+    def _handle_update(
+        self,
+        deployment: AppDeployParams,
+        existing_app: ApplicationMetaData,
+        approval_program: bytes,
+        clear_program: bytes,
+    ) -> AppDeployResult:
+        suppress_log = deployment.send_params.get("suppress_log") or False if deployment.send_params else False
+
+        if deployment.on_update in (OnUpdate.Fail, "fail") or deployment.on_update is None:
+            raise ValueError(
+                "Update detected and on_update=Fail, stopping deployment. Try a different on_update value to not fail."
+            )
+
+        if deployment.on_update in (OnUpdate.AppendApp, "append"):
+            config.logger.info(
+                "on_update=AppendApp, will attempt to create a new app", extra={"suppress_log": suppress_log}
+            )
+            return self._create_app(deployment, approval_program, clear_program)
+
+        if deployment.on_update in (OnUpdate.UpdateApp, "update"):
+            if existing_app.updatable:
+                config.logger.info(
+                    "App is updatable and on_update=UpdateApp, updating app...",
+                    extra={"suppress_log": suppress_log},
+                )
+            else:
+                config.logger.warning(
+                    "App is not updatable but on_update=UpdateApp, will attempt to update app, "
+                    "update will most likely fail",
+                    extra={"suppress_log": suppress_log},
+                )
+            return self._update_app(deployment, existing_app, approval_program, clear_program)
+
+        if deployment.on_update in (OnUpdate.ReplaceApp, "replace"):
+            if existing_app.deletable:
+                config.logger.warning(
+                    "App is deletable and on_update=ReplaceApp, will attempt to create new app and delete old app",
+                    extra={"suppress_log": suppress_log},
+                )
+            else:
+                config.logger.warning(
+                    "App is not deletable but on_update=ReplaceApp, will attempt to create a new app and "
+                    "delete the old app, delete will most likely fail",
+                    extra={"suppress_log": suppress_log},
+                )
+            return self._replace_app(deployment, existing_app, approval_program, clear_program)
+
+        raise ValueError(f"Unsupported on_update value: {deployment.on_update}")
+
+    def _update_app_lookup(self, sender: str, app_metadata: ApplicationMetaData) -> None:
+        """Update the app lookup cache"""
+
+        lookup = self._app_lookups.get(sender)
+        if not lookup:
+            self._app_lookups[sender] = ApplicationLookup(
+                creator=sender,
+                apps={app_metadata.name: app_metadata},
+            )
+        else:
+            lookup.apps[app_metadata.name] = app_metadata
+
+    def get_creator_apps_by_name(self, *, creator_address: str, ignore_cache: bool = False) -> ApplicationLookup:
+        """Returns a lookup of name => app metadata (id, address, ...metadata) for all apps created by the given account
+        that have an [ARC-2](https://github.com/algorandfoundation/ARCs/blob/main/ARCs/arc-0002.md) `AppDeployNote` as
+        the transaction note of the app creation transaction.
+
+        This function caches the result for the given creator account so that subsequent calls won't require an indexer
+        lookup.
+
+        If the `AppManager` instance wasn't created with an indexer client, this function will throw an error.
+
+        :param creator_address: The address of the account that is the creator of the apps you want to search for
+        :param ignore_cache: Whether or not to ignore the cache and force a lookup, default: use the cache
+        :returns: A name-based lookup of the app metadata
+        :raises ValueError: If the app spec format is invalid
+        :example:
+            >>> result = await deployer.get_creator_apps_by_name(creator)
+        """
+
+        if not ignore_cache and creator_address in self._app_lookups:
+            return self._app_lookups[creator_address]
+
+        if not self._indexer:
+            raise ValueError(
+                "Didn't receive an indexer client when this AppManager was created, "
+                "but received a call to get_creator_apps"
+            )
+
+        app_lookup: dict[str, ApplicationMetaData] = {}
+
+        # Get all apps created by account
+        # TODO: See if empty iterable responses can be changed to empty lists instead of None
+        created_apps = self._indexer.search_for_applications(creator=creator_address).applications or []
+
+        encoded_note_prefix = base64.b64encode(APP_DEPLOY_NOTE_DAPP.encode()).decode()
+
+        for app in created_apps:
+            app_id = app.id_
+
+            # Get creation transaction
+            creation_txns = self._indexer.search_for_transactions(
+                application_id=app_id,
+                min_round=app.created_at_round,
+                address=creator_address,
+                address_role="sender",
+                note_prefix=encoded_note_prefix,
+                limit=1,
+            ).transactions
+
+            if not creation_txns:
+                continue
+
+            creation_txn = creation_txns[0]
+
+            try:
+                if not creation_txn.note:
+                    continue
+                note = base64.b64decode(creation_txn.note).decode()
+                if not note.startswith(f"{APP_DEPLOY_NOTE_DAPP}:j"):
+                    continue
+
+                metadata = json.loads(note[len(APP_DEPLOY_NOTE_DAPP) + 2 :])
+
+                if metadata.get("name") and creation_txn.confirmed_round:
+                    app_lookup[metadata["name"]] = ApplicationMetaData(
+                        reference=ApplicationReference(app_id=app_id, app_address=get_application_address(app_id)),
+                        deploy_metadata=AppDeploymentMetaData(
+                            name=metadata["name"],
+                            version=metadata.get("version", "1.0"),
+                            deletable=metadata.get("deletable"),
+                            updatable=metadata.get("updatable"),
+                        ),
+                        created_round=creation_txn.confirmed_round,
+                        updated_round=creation_txn.confirmed_round,
+                        deleted=app.deleted if app.deleted is not None else False,
+                    )
+            except Exception as e:
+                config.logger.warning(
+                    f"Error processing app {app_id} for creator {creator_address}: {e}",
+                )
+                continue
+
+        lookup = ApplicationLookup(creator=creator_address, apps=app_lookup)
+        self._app_lookups[creator_address] = lookup
+        return lookup
+
+
+_T = TypeVar("_T")
+
+
+def extend(new_type: type[_T], base_instance: object, **changes: object) -> _T:
+    assert dataclasses.is_dataclass(new_type), "expected dataclass type"
+    base_type = type(base_instance)
+    assert dataclasses.is_dataclass(base_type), "expected dataclass instance"
+    old_type_fields = {f.name: f for f in fields(base_type)}
+    new_type_fields = fields(new_type)
+    for a in new_type_fields:
+        if not a.init:
+            continue
+        if a.name not in changes and a.name in old_type_fields:
+            changes[a.name] = getattr(base_instance, a.name)
+
+    return new_type(**changes)
+
+
+def _get_confirmed_round(confirmation: algod_models.PendingTransactionResponse | None) -> int:
+    """Extract the confirmed round from a typed response model."""
+
+    if confirmation is None:
+        return 0
+    return confirmation.confirmed_round or 0