chore: Add Typehinting to tokens module

Signed-off-by: Roger Barker <[email protected]>

additional changes to use "Any" and to update additional tokens module
files

Signed-off-by: Roger Barker <[email protected]>

More updates

Signed-off-by: Roger Barker <[email protected]>

Through token_mint_transactions

Signed-off-by: Roger Barker <[email protected]>

finished tokens module

Signed-off-by: Roger Barker <[email protected]>

Finished transaction model

Signed-off-by: Roger Barker <[email protected]>

chore: Typing README (#151)

* chore: starter mypy loose config

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

* chore: rename of main README

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

* chore: What are Types?

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

* chore: What are Type hints?-rest

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

* chore: fixing some small types and urls

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

* chore: basic contents for typing

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

* chore: markdown references for type hinting

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

* revert: README core naming

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

---------

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

fix: example scripts and README update (#154)

* fixed example scripts and readme

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

* added commas

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

---------

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

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: rbarker-dev

mypy.ini

@@ -2,7 +2,6 @@
 # Here it is kept quite loose as type hinting is introduced
 
 [mypy]
-
 # Do not error on imports that lack type stubs
 ignore_missing_imports = True
 
@@ -19,4 +18,4 @@ allow_untyped_defs = True
 follow_imports = silent
 
 # Turn off strict None‐checking—allows assigning X | None to X without error
-strict_optional = False
+strict_optional = False

src/hiero_sdk_python/client/network.py

@@ -66,7 +66,7 @@ def __init__(
         network: str = 'testnet',
         nodes: list[_Node] = None,
         mirror_address: str = None,
-    ):
+    ) -> None:
         """
         Initializes the Network with the specified network name or custom config.
 

src/hiero_sdk_python/query/account_balance_query.py

@@ -1,11 +1,11 @@
+import traceback
 from typing import Optional, Any
 from hiero_sdk_python.query.query import Query
 from hiero_sdk_python.hapi.services import crypto_get_account_balance_pb2, query_pb2
 from hiero_sdk_python.account.account_id import AccountId
 from hiero_sdk_python.account.account_balance import AccountBalance
 from hiero_sdk_python.executable import _Method
 from hiero_sdk_python.channels import _Channel
-import traceback
 
 class CryptoGetAccountBalanceQuery(Query):
     """

src/hiero_sdk_python/query/query.py

@@ -5,6 +5,17 @@
 import time
 from typing import Any, List, Optional, Union
 
+from typing import Any, List, Optional
+
+from hiero_sdk_python.exceptions import PrecheckError
+from hiero_sdk_python.executable import _Method
+from hiero_sdk_python.channels import _Channel
+from hiero_sdk_python.hapi.services import query_header_pb2, query_pb2
+from hiero_sdk_python.response_code import ResponseCode
+from hiero_sdk_python.hbar import Hbar
+from hiero_sdk_python.transaction.transfer_transaction import TransferTransaction
+from hiero_sdk_python.transaction.transaction_id import TransactionId
+from hiero_sdk_python.executable import _Executable, _ExecutionState
 from hiero_sdk_python.account.account_id import AccountId
 from hiero_sdk_python.channels import _Channel
 from hiero_sdk_python.client.client import Client, Operator

src/hiero_sdk_python/tokens/nft_id.py

@@ -46,6 +46,7 @@ def __init__(
             )
             token_id = tokenId
 
+<<<<<<< HEAD
         # Map legacy serialNumber -> serial_number
         if serial_number is None and serialNumber is not None:
             warnings.warn(
@@ -78,6 +79,18 @@ def __post_init__(self) -> None:
             raise TypeError(f"serial_number must be an integer, got {type(self.serial_number)}")
         if self.serial_number < 0:
             raise ValueError("serial_number must be non-negative")
+=======
+    def __post_init__(self) -> None:
+        """Validate the NftId after initialization."""
+        if self.tokenId is None:
+            raise TypeError("token_id is required")
+        if not isinstance(self.tokenId, TokenId):
+            raise TypeError(f"token_id must be of type TokenId, got {type(self.tokenId)}")
+        if not isinstance(self.serialNumber, int):
+            raise TypeError(f"Expected an integer for serial_number, got {type(self.serialNumber)}")
+        if self.serialNumber < 0:
+            raise ValueError("serial_number must be positive")
+>>>>>>> 1c940df (chore: Add Typehinting to tokens module)
 
     @classmethod
     def _from_proto(cls, nft_id_proto: Optional[basic_types_pb2.NftID] = None) -> "NftId":
@@ -96,16 +109,21 @@ def _to_proto(self) -> basic_types_pb2.NftID:
         """
         :return: a protobuf NftID object representation of this NftId object
         """
+<<<<<<< HEAD
         nft_id_proto = basic_types_pb2.NftID(
             token_ID=self.token_id._to_proto(),
             serial_number=self.serial_number,
         )
+=======
+        nft_id_proto:basic_types_pb2.NftID = basic_types_pb2.NftID(token_ID=self.tokenId._to_proto(), serial_number=self.serialNumber)
+
+>>>>>>> 1c940df (chore: Add Typehinting to tokens module)
         return nft_id_proto
 
     @classmethod
     def from_string(cls, nft_id_str: str) -> "NftId":
         """
-        :param nft_id_str: a string NftId representation
+        :param nft_id_str (str): a string NftId representation
         :return: returns the NftId parsed from the string input
         """
         parts = re.split(r"/", nft_id_str)

src/hiero_sdk_python/tokens/token_associate_transaction.py

@@ -5,9 +5,13 @@
 Provides TokenAssociateTransaction, a subclass of Transaction for associating
 tokens with accounts on the Hedera network using the Hedera Token Service (HTS) API.
 """
+from typing import Optional, List
+from hiero_sdk_python.account.account_id import AccountId
 from hiero_sdk_python.channels import _Channel
 from hiero_sdk_python.executable import _Method
 from hiero_sdk_python.hapi.services import token_associate_pb2
+from hiero_sdk_python.hapi.services import transaction_body_pb2
+from hiero_sdk_python.tokens.token_id import TokenId
 from hiero_sdk_python.transaction.transaction import Transaction
 
 
@@ -22,7 +26,7 @@ class TokenAssociateTransaction(Transaction):
     to build and execute a token association transaction.
     """
 
-    def __init__(self, account_id=None, token_ids=None):
+    def __init__(self, account_id: Optional[AccountId] = None, token_ids:Optional[List[TokenId]] = None) -> None:
         """
         Initializes a new TokenAssociateTransaction instance with optional keyword arguments.
 
@@ -31,24 +35,29 @@ def __init__(self, account_id=None, token_ids=None):
             token_ids (list of TokenId, optional): The tokens to associate with the account.
         """
         super().__init__()
-        self.account_id = account_id
-        self.token_ids = token_ids or []
+        self.account_id: Optional[AccountId] = account_id
+        self.token_ids: Optional[List[TokenId]] = token_ids or []
 
-        self._default_transaction_fee = 500_000_000
+        self._default_transaction_fee: int = 500_000_000
 
-    def set_account_id(self, account_id):
-        """Set the account ID for token association."""
+    def set_account_id(self, account_id: AccountId) -> "TokenAssociateTransaction":
+        """        
+        Sets the account ID for the token association transaction.
+        Args:
+            account_id (AccountId): The account ID to associate tokens with.
+        Returns:
+            TokenAssociateTransaction: The current instance for method chaining.
+        """
         self._require_not_frozen()
         self.account_id = account_id
         return self
 
-    def add_token_id(self, token_id):
-        """Add a token ID to the association list."""
+    def add_token_id(self, token_id: TokenId) -> "TokenAssociateTransaction":
         self._require_not_frozen()
         self.token_ids.append(token_id)
         return self
 
-    def build_transaction_body(self):
+    def build_transaction_body(self) -> transaction_body_pb2.TransactionBody:
         """
         Builds and returns the protobuf transaction body for token association.
 
@@ -66,7 +75,7 @@ def build_transaction_body(self):
             tokens=[token_id._to_proto() for token_id in self.token_ids]
         )
 
-        transaction_body = self.build_base_transaction_body()
+        transaction_body: transaction_body_pb2.TransactionBody = self.build_base_transaction_body()
         transaction_body.tokenAssociate.CopyFrom(token_associate_body)
 
         return transaction_body

src/hiero_sdk_python/tokens/token_burn_transaction.py

@@ -5,9 +5,10 @@
 Provides TokenBurnTransaction, a subclass of Transaction for burning fungible and
 non-fungible tokens on the Hedera network using the Hedera Token Service (HTS) API.
 """
-from typing import Optional
+from typing import List, Optional
 
 from hiero_sdk_python.hapi.services.token_burn_pb2 import TokenBurnTransactionBody
+from hiero_sdk_python.hapi.services import transaction_body_pb2
 from hiero_sdk_python.transaction.transaction import Transaction
 from hiero_sdk_python.channels import _Channel
 from hiero_sdk_python.executable import _Method
@@ -24,11 +25,11 @@ class TokenBurnTransaction(Transaction):
     to build and execute a token burn transaction.
     """
     def __init__(
-        self,
-        token_id: TokenId | None = None,
-        amount: Optional[int] = None,
-        serials: list[int] | None = None,
-    ):
+        self, 
+        token_id: Optional[TokenId] = None, 
+        amount: Optional[int] = None, 
+        serials: Optional[List[int]] = None
+    ) -> None:
         """
         Initializes a new TokenBurnTransaction instance with optional token_id, amount, and serials.
 
@@ -38,11 +39,11 @@ def __init__(
             serials (list[int], optional): The serial numbers of non-fungible tokens to burn.
         """
         super().__init__()
-        self.token_id: TokenId = token_id
+        self.token_id: Optional[TokenId] = token_id
         self.amount: Optional[int] = amount
-        self.serials: list[int] = serials if serials else []
-
-    def set_token_id(self, token_id: TokenId):
+        self.serials: Optional[List[int]] = serials if serials else []
+    
+    def set_token_id(self, token_id: TokenId) -> "TokenBurnTransaction":
         """
         Sets the token ID for this burn transaction.
 
@@ -55,8 +56,8 @@ def set_token_id(self, token_id: TokenId):
         self._require_not_frozen()
         self.token_id = token_id
         return self
-
-    def set_amount(self, amount: int):
+    
+    def set_amount(self, amount: int) -> "TokenBurnTransaction":
         """
         Sets the amount of fungible tokens to burn.
 
@@ -69,8 +70,8 @@ def set_amount(self, amount: int):
         self._require_not_frozen()
         self.amount = amount
         return self
-
-    def set_serials(self, serials: list[int]):
+    
+    def set_serials(self, serials: List[int]) -> "TokenBurnTransaction":
         """
         Sets the list of serial numbers of non-fungible tokens to burn.
 
@@ -83,8 +84,8 @@ def set_serials(self, serials: list[int]):
         self._require_not_frozen()
         self.serials = serials
         return self
-
-    def add_serial(self, serial: int):
+        
+    def add_serial(self, serial: int) -> "TokenBurnTransaction":
         """
         Adds a single serial number to the list of non-fungible tokens to burn.
 
@@ -98,8 +99,8 @@ def add_serial(self, serial: int):
         self._require_not_frozen()
         self.serials.append(serial)
         return self
-
-    def build_transaction_body(self):
+        
+    def build_transaction_body(self) -> transaction_body_pb2.TransactionBody:
         """
         Builds the transaction body for this token burn transaction.
 
@@ -120,7 +121,7 @@ def build_transaction_body(self):
             amount=self.amount,
             serialNumbers=self.serials
         )
-        transaction_body = self.build_base_transaction_body()
+        transaction_body: transaction_body_pb2.TransactionBody = self.build_base_transaction_body()
         transaction_body.tokenBurn.CopyFrom(token_burn_body)
         return transaction_body
 
@@ -141,8 +142,8 @@ def _get_method(self, channel: _Channel) -> _Method:
             transaction_func=channel.token.burnToken,
             query_func=None
         )
-
-    def _from_proto(self, proto: TokenBurnTransactionBody):
+    
+    def _from_proto(self, proto: TokenBurnTransactionBody) -> "TokenBurnTransaction":
         """
         Deserializes a TokenBurnTransactionBody from a protobuf object.