feat: app client

[aorumbayev]

Proposed Changes

App Client implementation

Further notes

App Factory PR is to follow shortly against this branch to simplify review

[Copilot]

Pull Request Overview

This PR implements the AppClient for Algorand smart contract applications, providing a comprehensive client interface for interacting with ARC-56 compliant apps. The AppClient offers fluent APIs for transactions, state access, and app lifecycle management.

• Implements a full-featured AppClient with support for ARC-56 specifications
• Provides fluent APIs for transaction building, sending, and state access
• Adds configuration system with event emission capabilities for debugging and tracing
• Extends composer functionality with simulation support

Reviewed Changes

Copilot reviewed 27 out of 27 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
crates/algokit_utils/src/applications/app_client/mod.rs	Core AppClient implementation with network resolution and basic operations
crates/algokit_utils/src/applications/app_client/sender.rs	Transaction sending functionality with debugging support
crates/algokit_utils/src/applications/app_client/transaction_builder.rs	Transaction building utilities for various app operations
crates/algokit_utils/src/applications/app_client/params_builder.rs	Parameter building with ABI method resolution and default value handling
crates/algokit_utils/src/applications/app_client/state_accessor.rs	Structured state access for global, local, and box storage
crates/algokit_utils/src/applications/app_client/types.rs	Type definitions for AppClient parameters and configurations
crates/algokit_utils/src/config.rs	Global configuration system with async event emission
crates/algokit_utils/src/transactions/composer.rs	Extended composer with simulation capabilities
crates/algokit_utils/tests/applications/app_client.rs	Comprehensive test suite for AppClient functionality

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[aorumbayev]

@PatrickDinh i used your pr algorandfoundation/algokit-utils-ts#430 as a reference and added similar native struct support to abi crate which allowed removal of various helpers in the app client implementation, the abi handling should be more refined at this point feel free to take another look also pushed additional tests into app factory implementation as well -> #248, there is a few nested struct tests that i still need to add but ill do it after app factory pr is merged as using the factory as a fixture could simplify directly reusing existing nested struct tests from ts and py utils repos

[aorumbayev]

For context here, Pat's PR with further refinements merged, final steps missing is merge conflicts against main branch + final batch of tests

[aorumbayev]

@PatrickDinh @joe-p pushed additional batch of tests and added tweaks for more explicit lifetime names along with use of async trait for state accessor. Feel free to check again, i think at this point it will be simpler to merge this first then get the app factory merged as a follow up to this PR. I will rebase the app factory tomorrow and update factory related tests to ensure its not duplicating tests from this pr

[PatrickDinh]

@aorumbayev I noticed that compared to the TS version, we are missing the methods to get the app client from the client manager, maybe it's worth to keep track and do it in another PR.

• getAppClientByCreatorAndName
• getAppClientById
• getAppClientByNetwork

[aorumbayev]

@aorumbayev I noticed that compared to the TS version, we are missing the methods to get the app client from the client manager, maybe it's worth to keep track and do it in another PR.

• getAppClientByCreatorAndName
• getAppClientById
• getAppClientByNetwork

those are in the app factory PR

[joe-p]

Some areas that we can reduce duplication, but other than that LGTM

[engineering-ci]

🎉 This PR is included in version 1.0.0-alpha.65 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀