Merge branch 'main' into TokenPauseTransaction

Author: exploreriii

examples/README.md

@@ -30,6 +30,7 @@ You can choose either syntax or even mix both styles in your projects.
   - [Token Update NFTs](#token-update-nfts)
   - [Pausing a Token](#pausing-a-token)
   - [Querying NFT Info](#querying-nft-info)
+  - [Querying Fungible Token Info](#querying-fungible-token-info)
 - [HBAR Transactions](#hbar-transactions)
   - [Transferring HBAR](#transferring-hbar)
 - [Topic Transactions](#topic-transactions)
@@ -524,6 +525,25 @@ nft_info = nft_info_query.execute(client)
 print(nft_info)
 ```
 
+### Querying Fungible Token Info
+
+#### Pythonic Syntax:
+```
+info_query = TokenInfoQuery(token_id=token_id)
+info = info_query.execute(client)
+print(info)
+```
+#### Method Chaining:
+```
+info_query = (
+        TokenInfoQuery()
+        .set_token_id(token_id)
+    )
+
+info = info_query.execute(client)
+print(info)
+```
+
 ## HBAR Transactions
 
 ### Transferring HBAR

examples/query_token_info_fungible.py

@@ -0,0 +1,74 @@
+import os
+import sys
+
+from dotenv import load_dotenv
+
+from hiero_sdk_python import (
+    Client,
+    AccountId,
+    PrivateKey,
+    Network,
+)
+from hiero_sdk_python.hapi.services.basic_types_pb2 import TokenType
+from hiero_sdk_python.query.token_info_query import TokenInfoQuery
+from hiero_sdk_python.response_code import ResponseCode
+from hiero_sdk_python.tokens.supply_type import SupplyType
+from hiero_sdk_python.tokens.token_create_transaction import TokenCreateTransaction
+
+load_dotenv()
+
+def setup_client():
+    """Initialize and set up the client with operator account"""
+    network = Network(network='testnet')
+    client = Client(network)
+
+    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_fungible_token(client, operator_id, operator_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(operator_id)
+        .set_token_type(TokenType.FUNGIBLE_COMMON)
+        .set_supply_type(SupplyType.FINITE)
+        .set_max_supply(1000)
+        .set_admin_key(operator_key)
+        .set_supply_key(operator_key)
+        .set_freeze_key(operator_key)
+        .execute(client)
+    )
+    
+    # Check if token creation was successful
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"Fungible token creation failed with status: {ResponseCode.get_name(receipt.status)}")
+        sys.exit(1)
+    
+    # Get token ID from receipt
+    token_id = receipt.tokenId
+    print(f"Fungible token created with ID: {token_id}")
+    
+    return token_id
+
+def query_token_info():
+    """
+    Demonstrates the token info query functionality by:
+    1. Creating a fungible token
+    2. Querying the token's information using TokenInfoQuery
+    3. Printing the token details of the TokenInfo object
+    """
+    client, operator_id, operator_key = setup_client()
+    token_id = create_fungible_token(client, operator_id, operator_key)
+        
+    info = TokenInfoQuery().set_token_id(token_id).execute(client)
+    print(f"Fungible token info: {info}")
+
+if __name__ == "__main__":
+    query_token_info()

examples/query_token_info_nft.py

@@ -0,0 +1,74 @@
+import os
+import sys
+
+from dotenv import load_dotenv
+
+from hiero_sdk_python import (
+    Client,
+    AccountId,
+    PrivateKey,
+    Network,
+)
+from hiero_sdk_python.hapi.services.basic_types_pb2 import TokenType
+from hiero_sdk_python.query.token_info_query import TokenInfoQuery
+from hiero_sdk_python.response_code import ResponseCode
+from hiero_sdk_python.tokens.supply_type import SupplyType
+from hiero_sdk_python.tokens.token_create_transaction import TokenCreateTransaction
+
+load_dotenv()
+
+def setup_client():
+    """Initialize and set up the client with operator account"""
+    network = Network(network='testnet')
+    client = Client(network)
+
+    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_nft(client, operator_id, operator_key):
+    """Create a non-fungible token"""
+    receipt = (
+        TokenCreateTransaction()
+        .set_token_name("MyExampleNFT")
+        .set_token_symbol("EXNFT")
+        .set_decimals(0)
+        .set_initial_supply(0)
+        .set_treasury_account_id(operator_id)
+        .set_token_type(TokenType.NON_FUNGIBLE_UNIQUE)
+        .set_supply_type(SupplyType.FINITE)
+        .set_max_supply(100)
+        .set_admin_key(operator_key)
+        .set_supply_key(operator_key)
+        .set_freeze_key(operator_key)
+        .execute(client)
+    )
+    
+    # Check if nft creation was successful
+    if receipt.status != ResponseCode.SUCCESS:
+        print(f"NFT creation failed with status: {ResponseCode.get_name(receipt.status)}")
+        sys.exit(1)
+    
+    # Get token ID from receipt
+    nft_token_id = receipt.tokenId
+    print(f"NFT created with ID: {nft_token_id}")
+    
+    return nft_token_id
+
+def query_token_info():
+    """
+    Demonstrates the token info query functionality by:
+    1. Creating a NFT
+    2. Querying the token's information using TokenInfoQuery
+    3. Printing the token details of the TokenInfo object
+    """
+    client, operator_id, operator_key = setup_client()
+    token_id = create_nft(client, operator_id, operator_key)
+    
+    info = TokenInfoQuery().set_token_id(token_id).execute(client)
+    print(f"Non-fungible token info: {info}")
+
+if __name__ == "__main__":
+    query_token_info()

src/hiero_sdk_python/__init__.py

@@ -58,6 +58,7 @@
 from .query.transaction_get_receipt_query import TransactionGetReceiptQuery
 from .query.account_balance_query import CryptoGetAccountBalanceQuery
 from .query.token_nft_info_query import TokenNftInfoQuery
+from .query.token_info_query import TokenInfoQuery
 
 # Address book
 from .address_book.endpoint import Endpoint
@@ -120,6 +121,7 @@
     "TransactionGetReceiptQuery",
     "CryptoGetAccountBalanceQuery",
     "TokenNftInfoQuery",
+    "TokenInfoQuery",
 
     # Address book
     "Endpoint",

src/hiero_sdk_python/query/token_info_query.py

@@ -0,0 +1,129 @@
+from hiero_sdk_python.query.query import Query
+from hiero_sdk_python.hapi.services import query_pb2, token_get_info_pb2
+from hiero_sdk_python.executable import _Method
+from hiero_sdk_python.channels import _Channel
+
+from hiero_sdk_python.tokens.token_id import TokenId
+from hiero_sdk_python.tokens.token_info import TokenInfo
+
+class TokenInfoQuery(Query):
+    """
+    A query to retrieve information about a specific Token.
+    
+    This class constructs and executes a query to retrieve information 
+    about a fungible or non-fungible token on the network,
+    including the token's properties and settings.
+    
+    """
+    def __init__(self, token_id=None):
+        """
+        Initializes a new TokenInfoQuery instance with an optional token_id.
+
+        Args:
+            token_id (TokenId, optional): The ID of the token to query.
+        """
+        super().__init__()
+        self.token_id : TokenId = token_id
+
+    def set_token_id(self, token_id: TokenId):
+        """
+        Sets the ID of the token to query. 
+
+        Args: 
+            token_id (TokenID): The ID of the token. 
+
+        Returns:
+            TokenInfoQuery: Returns self for method chaining. 
+        """
+        self.token_id = token_id
+        return self
+
+    def _make_request(self):
+        """
+        Constructs the protobuf request for the query.
+        
+        Builds a TokenGetInfoQuery protobuf message with the
+        appropriate header and token ID.
+
+        Returns:
+            Query: The protobuf query message.
+
+        Raises:
+            ValueError: If the token ID is not set.
+            Exception: If any other error occurs during request construction.
+        """
+        try:
+            if not self.token_id:
+                raise ValueError("Token ID must be set before making the request.")
+
+            query_header = self._make_request_header()
+
+            token_info_query = token_get_info_pb2.TokenGetInfoQuery()
+            token_info_query.header.CopyFrom(query_header)
+            token_info_query.token.CopyFrom(self.token_id.to_proto())
+
+            query = query_pb2.Query()
+            query.tokenGetInfo.CopyFrom(token_info_query)
+                  
+            return query
+        except Exception as e:
+            print(f"Exception in _make_request: {e}")
+            raise
+
+    def _get_method(self, channel: _Channel) -> _Method:
+        """
+        Returns the appropriate gRPC method for the token info query.
+        
+        Implements the abstract method from Query to provide the specific
+        gRPC method for getting token information.
+
+        Args:
+            channel (_Channel): The channel containing service stubs
+
+        Returns:
+            _Method: The method wrapper containing the query function
+        """
+        return _Method(
+            transaction_func=None,
+            query_func=channel.token.getTokenInfo
+        )
+
+    def execute(self, client):
+        """
+        Executes the token info query.
+        
+        Sends the query to the Hedera network and processes the response
+        to return a TokenInfo object.
+
+        This function delegates the core logic to `_execute()`, and may propagate exceptions raised by it.
+
+        Args:
+            client (Client): The client instance to use for execution
+
+        Returns:
+            TokenInfo: The token info from the network
+
+        Raises:
+            PrecheckError: If the query fails with a non-retryable error
+            MaxAttemptsError: If the query fails after the maximum number of attempts
+            ReceiptStatusError: If the query fails with a receipt status error
+        """
+        self._before_execute(client)
+        response = self._execute(client)
+
+        return TokenInfo._from_proto(response.tokenGetInfo.tokenInfo)
+
+    def _get_query_response(self, response):
+        """
+        Extracts the token info response from the full response.
+        
+        Implements the abstract method from Query to extract the
+        specific token info response object.
+        
+        Args:
+            response: The full response from the network
+            
+        Returns:
+            The token get info response object
+        """
+        return response.tokenGetInfo