feat: Refactor custom_royalty_fee.py example for end-to-end execution (hiero-ledger#1160)

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

Author: Adityarya11

CHANGELOG.md

@@ -81,6 +81,8 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Format token examples with Black for consistent code style and improved readability (#1119) 
 - Replaced `ResponseCode.get_name(receipt.status)` with the  `ResponseCode(receipt.status).name` across examples and integration tests for consistency. (#1136)
 - Moved helpful references to Additional Context section and added clickable links.
+- Transformed `examples\tokens\custom_royalty_fee.py` to be an end-to-end example, that interacts with the Hedera network, rather than a static object demo.
+
 
 
 

examples/tokens/custom_fee_royalty.py

@@ -0,0 +1,123 @@
+"""
+Run with:
+uv run examples/tokens/custom_royalty_fee.py
+python examples/tokens/custom_royalty_fee.py
+"""
+ 
+import os
+import sys
+from dotenv import load_dotenv
+
+from hiero_sdk_python.client.network import Network
+from hiero_sdk_python.crypto.private_key import PrivateKey
+from hiero_sdk_python.client.client import Client
+from hiero_sdk_python.query.token_info_query import TokenInfoQuery
+from hiero_sdk_python.account.account_id import AccountId
+from hiero_sdk_python.response_code import ResponseCode
+from hiero_sdk_python.tokens.supply_type import SupplyType
+from hiero_sdk_python.tokens.custom_fixed_fee import CustomFixedFee
+from hiero_sdk_python.tokens.custom_royalty_fee import CustomRoyaltyFee
+from hiero_sdk_python.hbar import Hbar
+from hiero_sdk_python.tokens.token_create_transaction import TokenCreateTransaction
+from hiero_sdk_python.tokens.token_type import TokenType
+
+load_dotenv()
+network_name = os.getenv("NETWORK", "testnet").lower()
+
+def setup_client():
+    """Initialize and set up the client with operator account"""
+    
+    network = Network(network_name)
+    print(f"Connecting to the Hedera {network_name} network")
+    client = Client(network)
+
+    try:
+        operator_id_str = os.getenv('OPERATOR_ID')
+        operator_key_str = os.getenv('OPERATOR_KEY')
+
+        if not operator_id_str or not operator_key_str:
+            raise ValueError("Environment variables OPERATOR_ID or OPERATOR_KEY are missing.")
+
+        operator_id = AccountId.from_string(operator_id_str)
+        operator_key = PrivateKey.from_string(operator_key_str)
+
+        client.set_operator(operator_id, operator_key)
+        print(f"Client set up with operator id {client.operator_account_id}")
+        return client, operator_id, operator_key
+    
+    except (TypeError, ValueError) as e:
+        print(f"Error: {e}")
+        print("Please check OPERATOR_ID and OPERATOR_KEY in your .env file.")
+        sys.exit(1)
+
+def custom_royalty_fee_example():
+    """Demonstrates how to create a token with a custom royalty fee."""    
+    
+    client, operator_id, operator_key = setup_client()
+
+    with client:
+        print("\n--- Creating Custom Royalty Fee ---")
+        
+        fallback_fee = CustomFixedFee(
+            amount=Hbar(1).to_tinybars(),
+            fee_collector_account_id=operator_id,
+            all_collectors_are_exempt=False
+        )
+        
+        royalty_fee = CustomRoyaltyFee(
+            numerator=5, 
+            denominator=100,
+            fallback_fee=fallback_fee,
+            fee_collector_account_id=operator_id,
+            all_collectors_are_exempt=False
+        )
+
+        print(f"Royalty Fee Configured: {royalty_fee.numerator}/{royalty_fee.denominator}")
+        print(f"Fallback Fee: {Hbar.from_tinybars(fallback_fee.amount)} HBAR")
+
+        print("\n--- Creating Token with Royalty Fee ---")
+        transaction = (
+            TokenCreateTransaction()
+            .set_token_name("Royalty NFT Collection")
+            .set_token_symbol("RNFT")
+            .set_treasury_account_id(operator_id)
+            .set_admin_key(operator_key)
+            .set_supply_key(operator_key)
+            .set_token_type(TokenType.NON_FUNGIBLE_UNIQUE)
+            .set_decimals(0)
+            .set_initial_supply(0)
+            .set_supply_type(SupplyType.FINITE)
+            .set_max_supply(100)
+            .set_custom_fees([royalty_fee])
+            .freeze_with(client)
+            .sign(operator_key)
+        )
+        
+        try:
+            receipt = transaction.execute(client)
+
+            if receipt.status != ResponseCode.SUCCESS:
+                print(f"Transaction failed with status: {ResponseCode(receipt.status).name}")
+                return
+
+            token_id = receipt.token_id
+            print(f"Token created successfully with ID: {token_id}")
+
+            print("\n--- Verifying Fee on Network ---")
+            token_info = TokenInfoQuery().set_token_id(token_id).execute(client)
+
+            retrieved_fees = token_info.custom_fees
+            if retrieved_fees:
+                print(f"Success! Found {len(retrieved_fees)} custom fee(s) on token.")
+                for fee in retrieved_fees:
+                    print(f"Fee Collector: {fee.fee_collector_account_id}")
+                    print(f"Fee Details: {fee}")
+            else:
+                print("Error: No custom fees found on the token.")
+
+        except Exception as e:
+            print(f"Transaction execution failed: {e}")
+            sys.exit(1)
+
+if __name__ == "__main__":
+    custom_royalty_fee_example()