feat!: align Python API with TypeScript naming conventions

BREAKING CHANGE: Multiple API field and type renames to align with algokit-utils-ts
## Changes
### MultisigSubsignature
- Renamed \`address: str\` to \`public_key: bytes\` to match TypeScript's \`publicKey: Uint8Array\`
- Aligns with go-algorand canonical definition (\`Key PublicKey\` with wire key \`pk\`)
- Wire format unchanged - backward compatible at protocol level
### AppCallTransactionFields
- Renamed \`access\` to \`access_references\` to match TypeScript's \`accessReferences\`
- Wire key remains \`al\`
### Transaction
- Renamed \`app_call\` to \`application_call\` to match TypeScript's \`applicationCall\`
### SendAtomicTransactionComposerResults
- Removed backwards compatibility alias completely
- Use \`SendTransactionComposerResults\` instead"

Author: aorumbayev

docs/markdown/autoapi/algokit_utils/transactions/builders/common/index.md

@@ -59,7 +59,7 @@
 
 ### algokit_utils.transactions.builders.common.build_transaction_header(params: [algokit_utils.transactions.types.CommonTxnParams](../../types/index.md#algokit_utils.transactions.types.CommonTxnParams), suggested_params: SuggestedParamsLike, \*, default_validity_window: int, default_validity_window_is_explicit: bool, is_localnet: bool) → tuple[[TransactionHeader](#algokit_utils.transactions.builders.common.TransactionHeader), [FeeConfig](#algokit_utils.transactions.builders.common.FeeConfig)]
 
-### algokit_utils.transactions.builders.common.build_transaction(txn_type: algokit_transact.models.transaction.TransactionType, header: [TransactionHeader](#algokit_utils.transactions.builders.common.TransactionHeader), \*, payment: algokit_transact.models.payment.PaymentTransactionFields | None = None, asset_transfer: algokit_transact.models.asset_transfer.AssetTransferTransactionFields | None = None, asset_config: algokit_transact.models.asset_config.AssetConfigTransactionFields | None = None, asset_freeze: algokit_transact.models.asset_freeze.AssetFreezeTransactionFields | None = None, app_call: algokit_transact.models.app_call.AppCallTransactionFields | None = None, key_registration: algokit_transact.models.key_registration.KeyRegistrationTransactionFields | None = None) → algokit_transact.models.transaction.Transaction
+### algokit_utils.transactions.builders.common.build_transaction(txn_type: algokit_transact.models.transaction.TransactionType, header: [TransactionHeader](#algokit_utils.transactions.builders.common.TransactionHeader), \*, payment: algokit_transact.models.payment.PaymentTransactionFields | None = None, asset_transfer: algokit_transact.models.asset_transfer.AssetTransferTransactionFields | None = None, asset_config: algokit_transact.models.asset_config.AssetConfigTransactionFields | None = None, asset_freeze: algokit_transact.models.asset_freeze.AssetFreezeTransactionFields | None = None, application_call: algokit_transact.models.app_call.AppCallTransactionFields | None = None, key_registration: algokit_transact.models.key_registration.KeyRegistrationTransactionFields | None = None) → algokit_transact.models.transaction.Transaction
 
 ### algokit_utils.transactions.builders.common.apply_transaction_fees(txn: algokit_transact.models.transaction.Transaction, params: [algokit_utils.transactions.types.CommonTxnParams](../../types/index.md#algokit_utils.transactions.types.CommonTxnParams), fee_config: [FeeConfig](#algokit_utils.transactions.builders.common.FeeConfig)) → [BuiltTransaction](#algokit_utils.transactions.builders.common.BuiltTransaction)
 

docs/markdown/autoapi/algokit_utils/transactions/transaction_composer/index.md

@@ -2,10 +2,9 @@
 
 ## Attributes
 
-| [`AppMethodCallTransactionArgument`](#algokit_utils.transactions.transaction_composer.AppMethodCallTransactionArgument)         |    |
-|---------------------------------------------------------------------------------------------------------------------------------|----|
-| [`ErrorTransformer`](#algokit_utils.transactions.transaction_composer.ErrorTransformer)                                         |    |
-| [`SendAtomicTransactionComposerResults`](#algokit_utils.transactions.transaction_composer.SendAtomicTransactionComposerResults) |    |
+| [`AppMethodCallTransactionArgument`](#algokit_utils.transactions.transaction_composer.AppMethodCallTransactionArgument)   |    |
+|---------------------------------------------------------------------------------------------------------------------------|----|
+| [`ErrorTransformer`](#algokit_utils.transactions.transaction_composer.ErrorTransformer)                                   |    |
 
 ## Exceptions
 
@@ -108,8 +107,6 @@ Contains detailed debugging information including simulation traces and sent tra
 
 #### simulate_response *: algokit_algod_client.models.SimulateResponse | None* *= None*
 
-### algokit_utils.transactions.transaction_composer.SendAtomicTransactionComposerResults
-
 ### *class* algokit_utils.transactions.transaction_composer.TransactionComposer(params: [TransactionComposerParams](#algokit_utils.transactions.transaction_composer.TransactionComposerParams))
 
 Light-weight transaction composer built on top of algokit_transact.

docs/markdown/capabilities/transaction.md

@@ -4,7 +4,7 @@ Transaction management is one of the core capabilities provided by AlgoKit Utils
 
 ## Transaction Results
 
-All AlgoKit Utils functions that send transactions return either a `SendSingleTransactionResult` or `SendAtomicTransactionComposerResults`, providing consistent mechanisms to interpret transaction outcomes.
+All AlgoKit Utils functions that send transactions return either a `SendSingleTransactionResult` or `SendTransactionComposerResults`, providing consistent mechanisms to interpret transaction outcomes.
 
 ### SendSingleTransactionResult
 
@@ -30,13 +30,13 @@ Common variations include:
 - `SendAppUpdateTransactionResult` - Adds compilation results
 - `SendAppCreateTransactionResult` - Adds `app_id` and `app_address`
 
-### SendAtomicTransactionComposerResults
+### SendTransactionComposerResults
 
-When using the atomic transaction composer directly via `TransactionComposer.send()` or `TransactionComposer.simulate()`, you’ll receive a `SendAtomicTransactionComposerResults`:
+When using the atomic transaction composer directly via `TransactionComposer.send()` or `TransactionComposer.simulate()`, you’ll receive a `SendTransactionComposerResults`:
 
 ```python
 @dataclass
-class SendAtomicTransactionComposerResults:
+class SendTransactionComposerResults:
     group_id: str  # The group ID if this was a transaction group
     confirmations: list[AlgodResponseType]  # The confirmation info for each transaction
     tx_ids: list[str]  # The transaction IDs that were sent
@@ -64,8 +64,8 @@ These types extend the base transaction results to add an `abi_value` field that
 Different interfaces return different result types:
 
 1. **Direct Transaction Composer**
-   - `TransactionComposer.send()` → `SendAtomicTransactionComposerResults`
-   - `TransactionComposer.simulate()` → `SendAtomicTransactionComposerResults`
+   - `TransactionComposer.send()` → `SendTransactionComposerResults`
+   - `TransactionComposer.simulate()` → `SendTransactionComposerResults`
 2. **AlgorandClient Methods**
    - `.send.payment()` → `SendSingleTransactionResult`
    - `.send.asset_create()` → `SendSingleAssetCreateTransactionResult`
@@ -110,7 +110,7 @@ Key differences between result types:
    - Focus on transaction confirmation details
    - Include group support but optimized for single transactions
    - No direct ABI value parsing
-2. **Atomic Transaction Results** (`SendAtomicTransactionComposerResults`)
+2. **Atomic Transaction Results** (`SendTransactionComposerResults`)
    - Built for transaction groups
    - Include simulation support
    - Raw ABI returns via `.returns`

docs/source/capabilities/transaction.md

@@ -4,7 +4,7 @@ Transaction management is one of the core capabilities provided by AlgoKit Utils
 
 ## Transaction Results
 
-All AlgoKit Utils functions that send transactions return either a `SendSingleTransactionResult` or `SendAtomicTransactionComposerResults`, providing consistent mechanisms to interpret transaction outcomes.
+All AlgoKit Utils functions that send transactions return either a `SendSingleTransactionResult` or `SendTransactionComposerResults`, providing consistent mechanisms to interpret transaction outcomes.
 
 ### SendSingleTransactionResult
 
@@ -30,13 +30,13 @@ Common variations include:
 - `SendAppUpdateTransactionResult` - Adds compilation results
 - `SendAppCreateTransactionResult` - Adds `app_id` and `app_address`
 
-### SendAtomicTransactionComposerResults
+### SendTransactionComposerResults
 
-When using the atomic transaction composer directly via `TransactionComposer.send()` or `TransactionComposer.simulate()`, you'll receive a `SendAtomicTransactionComposerResults`:
+When using the atomic transaction composer directly via `TransactionComposer.send()` or `TransactionComposer.simulate()`, you'll receive a `SendTransactionComposerResults`:
 
 ```python
 @dataclass
-class SendAtomicTransactionComposerResults:
+class SendTransactionComposerResults:
     group_id: str  # The group ID if this was a transaction group
     confirmations: list[AlgodResponseType]  # The confirmation info for each transaction
     tx_ids: list[str]  # The transaction IDs that were sent
@@ -65,8 +65,8 @@ Different interfaces return different result types:
 
 1. **Direct Transaction Composer**
 
-   - `TransactionComposer.send()` → `SendAtomicTransactionComposerResults`
-   - `TransactionComposer.simulate()` → `SendAtomicTransactionComposerResults`
+   - `TransactionComposer.send()` → `SendTransactionComposerResults`
+   - `TransactionComposer.simulate()` → `SendTransactionComposerResults`
 
 2. **AlgorandClient Methods**
 
@@ -118,7 +118,7 @@ Key differences between result types:
    - Include group support but optimized for single transactions
    - No direct ABI value parsing
 
-2. **Atomic Transaction Results** (`SendAtomicTransactionComposerResults`)
+2. **Atomic Transaction Results** (`SendTransactionComposerResults`)
 
    - Built for transaction groups
    - Include simulation support

src/algokit_transact/logicsig.py

@@ -208,9 +208,10 @@ def delegate_multisig(
         address_to_signer = {account.addr: account.delegated_lsig_signer for account in signing_accounts}
 
         for subsig in msig.subsignatures:
-            if subsig.address in address_to_signer:
-                signature = address_to_signer[subsig.address](self._program, msig_public_key)
-                msig = apply_multisig_subsignature(msig, subsig.address, signature)
+            subsig_addr = address_from_public_key(subsig.public_key)
+            if subsig_addr in address_to_signer:
+                signature = address_to_signer[subsig_addr](self._program, msig_public_key)
+                msig = apply_multisig_subsignature(msig, subsig_addr, signature)
 
         self._multisig_signature = msig
         self._delegated_address = address_from_multisig_signature(msig)

src/algokit_transact/models/app_call.py

@@ -275,7 +275,7 @@ class AppCallTransactionFields:
             pass_obj=True,
         ),
     )
-    access: list[ResourceReference] | None = field(
+    access_references: list[ResourceReference] | None = field(
         default=None,
         metadata=wire(
             "al",
@@ -291,9 +291,11 @@ def __post_init__(self) -> None:
                 _normalize_box_reference(self, item) for item in _coerce_box_sequence(self.box_references)
             ]
             object.__setattr__(self, "box_references", normalized_boxes or None)
-        if self.access:
-            normalized_access = [_normalize_resource_reference(item) for item in _coerce_resource_sequence(self.access)]
-            object.__setattr__(self, "access", normalized_access or None)
+        if self.access_references:
+            normalized_access = [
+                _normalize_resource_reference(item) for item in _coerce_resource_sequence(self.access_references)
+            ]
+            object.__setattr__(self, "access_references", normalized_access or None)
 
 
 def _coerce_box_sequence(

src/algokit_transact/models/transaction.py

@@ -64,7 +64,7 @@ class Transaction:
     asset_config: AssetConfigTransactionFields | None = field(
         default=None, metadata=flatten(AssetConfigTransactionFields, present_if=lambda p: _get_tx_type(p) == "acfg")
     )
-    app_call: AppCallTransactionFields | None = field(
+    application_call: AppCallTransactionFields | None = field(
         default=None, metadata=flatten(AppCallTransactionFields, present_if=lambda p: _get_tx_type(p) == "appl")
     )
     key_registration: KeyRegistrationTransactionFields | None = field(

src/algokit_transact/multisig.py

@@ -4,6 +4,7 @@
 from collections.abc import Callable, Sequence
 from functools import cached_property
 
+from algokit_common import address_from_public_key
 from algokit_transact.codec.signed import encode_signed_transaction
 from algokit_transact.codec.transaction import encode_transaction
 from algokit_transact.models.signed_transaction import SignedTransaction
@@ -64,9 +65,10 @@ def signer(txn_group: Sequence[AlgokitTransaction], indexes_to_sign: Sequence[in
 
                 multisig_sig = base_multisig
                 for subsig in base_multisig.subsignatures:
-                    if subsig.address in address_to_signer:
-                        signature = address_to_signer[subsig.address](payload)
-                        multisig_sig = apply_multisig_subsignature(multisig_sig, subsig.address, signature)
+                    subsig_addr = address_from_public_key(subsig.public_key)
+                    if subsig_addr in address_to_signer:
+                        signature = address_to_signer[subsig_addr](payload)
+                        multisig_sig = apply_multisig_subsignature(multisig_sig, subsig_addr, signature)
 
                 signed = SignedTransaction(
                     transaction=txn,

src/algokit_transact/ops/validate.py

@@ -63,7 +63,7 @@ def validate_transaction(transaction: Transaction) -> None:
         transaction.payment,
         transaction.asset_transfer,
         transaction.asset_config,
-        transaction.app_call,
+        transaction.application_call,
         transaction.key_registration,
         transaction.asset_freeze,
         transaction.heartbeat,
@@ -79,7 +79,7 @@ def validate_transaction(transaction: Transaction) -> None:
     type_label: str | None = None
 
     match transaction:
-        case Transaction(app_call=app_call) if app_call is not None:
+        case Transaction(application_call=app_call) if app_call is not None:
             issues.extend(validate_app_call_fields(app_call))
             type_label = "App call"
         case Transaction(asset_config=asset_config) if asset_config is not None:

src/algokit_transact/signing/multisig.py

@@ -20,17 +20,17 @@ def new_multisig_signature(version: int, threshold: int, participants: Iterable[
     if threshold == 0 or threshold > len(participants):
         raise ValueError("Threshold must be greater than zero and less than or equal to the number of participants")
 
-    subsignatures = [MultisigSubsignature(address=address) for address in participants]
+    subsignatures = [MultisigSubsignature(public_key=public_key_from_address(address)) for address in participants]
     return MultisigSignature(version=version, threshold=threshold, subsignatures=subsignatures)
 
 
 def participants_from_multisig_signature(multisig_signature: MultisigSignature) -> list[str]:
-    return [subsig.address for subsig in multisig_signature.subsignatures]
+    return [address_from_public_key(subsig.public_key) for subsig in multisig_signature.subsignatures]
 
 
 def address_from_multisig_signature(multisig_signature: MultisigSignature) -> str:
     prefix = MULTISIG_DOMAIN_SEPARATOR.encode()
-    participant_keys = [public_key_from_address(subsig.address) for subsig in multisig_signature.subsignatures]
+    participant_keys = [subsig.public_key for subsig in multisig_signature.subsignatures]
 
     buffer = bytearray()
     buffer.extend(prefix)
@@ -50,10 +50,11 @@ def apply_multisig_subsignature(
 ) -> MultisigSignature:
     found = False
     updated = []
+    participant_pk = public_key_from_address(participant)
     for subsig in multisig_signature.subsignatures:
-        if subsig.address == participant:
+        if subsig.public_key == participant_pk:
             found = True
-            updated.append(MultisigSubsignature(address=subsig.address, signature=signature))
+            updated.append(MultisigSubsignature(public_key=subsig.public_key, signature=signature))
         else:
             updated.append(subsig)
     if not found:
@@ -75,7 +76,7 @@ def merge_multisignatures(multisig_a: MultisigSignature, multisig_b: MultisigSig
     merged_subsigs = []
     for subsig_a, subsig_b in zip(multisig_a.subsignatures, multisig_b.subsignatures, strict=False):
         signature = subsig_b.signature if subsig_b.signature is not None else subsig_a.signature
-        merged_subsigs.append(MultisigSubsignature(address=subsig_a.address, signature=signature))
+        merged_subsigs.append(MultisigSubsignature(public_key=subsig_a.public_key, signature=signature))
     return MultisigSignature(
         version=multisig_a.version,
         threshold=multisig_a.threshold,