feat: add TransactionRecordQuery (#144)

* feat: add transaction_id field to TransactionReceipt

Signed-off-by: dosi <[email protected]>

* refactor: store transaction_id in TransactionReceipt

Signed-off-by: dosi <[email protected]>

* feat: add _from_proto() to TokenNftTransfer

Signed-off-by: dosi <[email protected]>

* test: add unit test for TokenNftTransfer _from_proto()

Signed-off-by: dosi <[email protected]>

* test: add unit tests for TransactionRecord

Signed-off-by: dosi <[email protected]>

* feat: implement TransactionRecord class

Signed-off-by: dosi <[email protected]>

* sqash s transaction record

Signed-off-by: dosi <[email protected]>

* feat: implement TransactionRecordQuery

Signed-off-by: dosi <[email protected]>

* test: implement integration tests for TransactionRecordQuery

Signed-off-by: dosi <[email protected]>

* test: add unit tests

Signed-off-by: dosi <[email protected]>

* docs: add query record example

Signed-off-by: dosi <[email protected]>

* chore: add TransactionRecord and TransactionRecordQuery to __init__.py

Signed-off-by: dosi <[email protected]>

* docs: add transaction record query to README

Signed-off-by: dosi <[email protected]>

* test: reduce test_transaction_record_query_execute() lines in TransactionRecordQuery unit tests

Signed-off-by: dosi <[email protected]>

* feat: add __repr__ method

Signed-off-by: Ivan Ivanov <[email protected]>

---------

Signed-off-by: dosi <[email protected]>
Signed-off-by: Ivan Ivanov <[email protected]>
Co-authored-by: Ivan Ivanov <[email protected]>

Author: Dosik13

examples/README.md

@@ -45,6 +45,8 @@ You can choose either syntax or even mix both styles in your projects.
   - [Deleting a Topic](#deleting-a-topic)
   - [Querying Topic](#querying-topic)
   - [Querying Topic Message](#querying-topic-message)
+- [Miscellaneous Queries](#miscellaneous-queries)
+  - [Querying Transaction Record](#querying-transaction-record)
 
 
 ## Account Transactions
@@ -876,4 +878,37 @@ query = (
     )
 
 query.subscribe(client)
+```
+
+## Miscellaneous Queries
+
+### Querying Transaction Record
+
+#### Pythonic Syntax:
+```
+query = TransactionRecordQuery(
+    transaction_id=transaction_id
+)
+
+record = query.execute(client)
+
+print(f"Transaction ID: {record.transaction_id}")
+print(f"Transaction Fee: {record.transaction_fee}")
+print(f"Transaction Hash: {record.transaction_hash}")
+print(f"Transaction Memo: {record.transaction_memo}")
+print(f"Transaction Account ID: {record.receipt.accountId}")
+```
+#### Method Chaining:
+```
+record = (
+    TransactionRecordQuery()
+    .set_transaction_id(transaction_id)
+    .execute(client)
+)
+
+print(f"Transaction ID: {record.transaction_id}")
+print(f"Transaction Fee: {record.transaction_fee}")
+print(f"Transaction Hash: {record.transaction_hash}")
+print(f"Transaction Memo: {record.transaction_memo}")
+print(f"Transaction Account ID: {record.receipt.accountId}")
 ```

examples/query_record.py

@@ -0,0 +1,180 @@
+import os
+import sys
+from dotenv import load_dotenv
+
+from hiero_sdk_python import (
+    Client,
+    AccountId,
+    PrivateKey,
+    Network,
+    Hbar,
+)
+from hiero_sdk_python.account.account_create_transaction import AccountCreateTransaction
+from hiero_sdk_python.query.transaction_record_query import TransactionRecordQuery
+from hiero_sdk_python.response_code import ResponseCode
+from hiero_sdk_python.tokens.supply_type import SupplyType
+from hiero_sdk_python.tokens.token_associate_transaction import TokenAssociateTransaction
+from hiero_sdk_python.tokens.token_create_transaction import TokenCreateTransaction
+from hiero_sdk_python.tokens.token_type import TokenType
+from hiero_sdk_python.transaction.transfer_transaction import TransferTransaction
+
+load_dotenv()
+
+def setup_client():
+    """Initialize and set up the client with operator account"""
+    # Initialize network and client
+    network = Network(network='testnet')
+    client = Client(network)
+
+    # Set up operator account
+    operator_id = AccountId.from_string(os.getenv('OPERATOR_ID'))
+    operator_key = PrivateKey.from_string(os.getenv('OPERATOR_KEY'))
+    client.set_operator(operator_id, operator_key)
+    
+    return client, operator_id, operator_key
+
+def create_account_transaction(client):
+    """Create a new account to get a transaction ID for record query"""
+    # Generate a new key pair for the account
+    new_account_key = PrivateKey.generate_ed25519()
+    
+    # Create the account
+    receipt = (
+        AccountCreateTransaction()
+        .set_key(new_account_key.public_key())
+        .set_initial_balance(Hbar(1))
+        .execute(client)
+    )
+    
+    # Check if account creation was successful
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"Account creation failed with status: {ResponseCode(receipt.status).name}")
+        sys.exit(1)
+    
+    # Get the new account ID and transaction ID from receipt
+    new_account_id = receipt.accountId
+    transaction_id = receipt.transaction_id
+    
+    print(f"Account created with ID: {new_account_id}")
+    
+    return new_account_id, new_account_key, transaction_id
+
+def create_fungible_token(client: 'Client', account_id, account_private_key):
+    """Create a fungible token"""
+    receipt = (
+        TokenCreateTransaction()
+        .set_token_name("MyExampleFT")
+        .set_token_symbol("EXFT")
+        .set_decimals(2)
+        .set_initial_supply(100)
+        .set_treasury_account_id(account_id)
+        .set_token_type(TokenType.FUNGIBLE_COMMON)
+        .set_supply_type(SupplyType.FINITE)
+        .set_max_supply(1000)
+        .set_admin_key(account_private_key)
+        .set_supply_key(account_private_key)
+        .execute(client)
+    )
+    
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"Fungible token creation failed with status: {ResponseCode(receipt.status).name}")
+        sys.exit(1)
+    
+    token_id = receipt.tokenId
+    print(f"\nFungible token created with ID: {token_id}")
+    
+    return token_id
+
+def associate_token(client, token_id, receiver_id, receiver_private_key):
+    """Associate token with an account"""
+    # Associate the token_id with the new account
+    receipt = (
+        TokenAssociateTransaction()
+        .set_account_id(receiver_id)
+        .add_token_id(token_id)
+        .freeze_with(client)
+        .sign(receiver_private_key) # Has to be signed here by receiver's key
+        .execute(client)
+    )
+    
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"Token association failed with status: {ResponseCode(receipt.status).name}")
+        sys.exit(1)
+    
+    print(f"Token successfully associated with account: {receiver_id}")
+
+def transfer_tokens(client, treasury_id, treasury_private_key, receiver_id, token_id, amount=10):
+    """Transfer tokens to the receiver account so we can later reject them"""
+    # Transfer tokens to the receiver account
+    receipt = (
+        TransferTransaction()
+        .add_token_transfer(token_id, treasury_id, -amount)
+        .add_token_transfer(token_id, receiver_id, amount)
+        .freeze_with(client)
+        .sign(treasury_private_key)
+        .execute(client)
+    )
+    
+    # Check if transfer was successful
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"Transfer failed with status: {ResponseCode(receipt.status).name}")
+        sys.exit(1)
+    
+    print(f"Successfully transferred {amount} tokens to receiver account {receiver_id}")
+    
+    return receipt
+
+def print_transaction_record(record):
+    """Print the transaction record"""
+    print(f"Transaction ID: {record.transaction_id}")
+    print(f"Transaction Fee: {record.transaction_fee}")
+    print(f"Transaction Hash: {record.transaction_hash.hex()}")
+    print(f"Transaction Memo: {record.transaction_memo}")
+    print(f"Transaction Account ID: {record.receipt.accountId}")
+    
+    print(f"\nTransfers made in the transaction:")
+    for account_id, amount in record.transfers.items():
+        print(f"  Account: {account_id}, Amount: {amount}")
+
+def query_record():
+    """
+    Demonstrates the transaction record query functionality by performing the following steps:
+    1. Creating a new account transaction to get a transaction ID
+    2. Querying and displaying the transaction record for account creation
+    3. Creating a fungible token and associating it with the new account
+    4. Transferring tokens from operator to new account
+    5. Querying and displaying the transaction record for token transfer
+    """
+    client, operator_id, operator_key = setup_client()
+    
+    # Create a transaction to get a transaction ID
+    new_account_id, new_account_key, transaction_id = create_account_transaction(client)
+    
+    record = (
+        TransactionRecordQuery()
+        .set_transaction_id(transaction_id)
+        .execute(client)
+    )
+    print("Transaction record for account creation:")
+    print_transaction_record(record)
+    
+    token_id = create_fungible_token(client, operator_id, operator_key)
+    associate_token(client, token_id, new_account_id, new_account_key)
+    transfer_receipt = transfer_tokens(client, operator_id, operator_key, new_account_id, token_id)
+    
+    transfer_record = (
+        TransactionRecordQuery()
+        .set_transaction_id(transfer_receipt.transaction_id)
+        .execute(client)
+    )
+    print("Transaction record for token transfer:")
+    print_transaction_record(transfer_record)
+    
+    print(f"\nToken Transfer Record:")
+    for token_id, transfers in transfer_record.token_transfers.items():
+        print(f"  Token ID: {token_id}")
+        for account_id, amount in transfers.items():
+            print(f"    Account: {account_id}, Amount: {amount}")
+
+if __name__ == "__main__":
+    query_record()

src/hiero_sdk_python/__init__.py

@@ -38,6 +38,7 @@
 from .transaction.transaction_id import TransactionId
 from .transaction.transaction_receipt import TransactionReceipt
 from .transaction.transaction_response import TransactionResponse
+from .transaction.transaction_record import TransactionRecord
 
 # Response / Codes
 from .response_code import ResponseCode
@@ -62,6 +63,7 @@
 from .query.topic_info_query import TopicInfoQuery
 from .query.topic_message_query import TopicMessageQuery
 from .query.transaction_get_receipt_query import TransactionGetReceiptQuery
+from .query.transaction_record_query import TransactionRecordQuery
 from .query.account_balance_query import CryptoGetAccountBalanceQuery
 from .query.token_nft_info_query import TokenNftInfoQuery
 from .query.token_info_query import TokenInfoQuery
@@ -116,6 +118,7 @@
     "TransactionId",
     "TransactionReceipt",
     "TransactionResponse",
+    "TransactionRecord",
 
     # Response
     "ResponseCode",
@@ -131,6 +134,7 @@
     "TopicInfoQuery",
     "TopicMessageQuery",
     "TransactionGetReceiptQuery",
+    "TransactionRecordQuery",
     "CryptoGetAccountBalanceQuery",
     "TokenNftInfoQuery",
     "TokenInfoQuery",

src/hiero_sdk_python/account/account_id.py

@@ -66,6 +66,17 @@ def __str__(self) -> str:
         """
         return f"{self.shard}.{self.realm}.{self.num}"
 
+    def __repr__(self):
+        """
+        Returns the repr representation of the AccountId.
+        """
+        return f"AccountId(shard={self.shard}, realm={self.realm}, num={self.num})"
+
+    def __eq__(self, other):
+            if not isinstance(other, AccountId):
+                return False
+            return (self.shard, self.realm, self.num) == (other.shard, other.realm, other.num)
+
     def __eq__(self, other: object) -> bool:
         """
         Checks equality between two AccountId instances.

src/hiero_sdk_python/query/transaction_get_receipt_query.py

@@ -219,7 +219,7 @@ def execute(self, client: Client) -> TransactionReceipt:
         self._before_execute(client)
         response = self._execute(client)
 
-        return TransactionReceipt._from_proto(response.transactionGetReceipt.receipt)
+        return TransactionReceipt._from_proto(response.transactionGetReceipt.receipt, self.transaction_id)
 
     def _get_query_response(self, response: response_pb2.Response) -> transaction_get_receipt_pb2.TransactionGetReceiptResponse:
         """