Merge branch 'hiero-ledger:main' into main

Author: aceppaluni

.github/workflows/examples.yml

@@ -22,7 +22,7 @@ jobs:
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
         with:
           fetch-depth: 0
-      
+          
       - name: Install uv
         uses: astral-sh/setup-uv@1781c6eb42f98d67097986d30130a8ff6879fda2
 
@@ -37,17 +37,32 @@ jobs:
         uses: hiero-ledger/hiero-solo-action@6a1a77601cf3e69661fb6880530a4edf656b40d5 #v0.14.0
         with:
           installMirrorNode: true
-        
       - name: Run Examples
         env:
           OPERATOR_ID: ${{ steps.solo.outputs.accountId }}
           OPERATOR_KEY: ${{ steps.solo.outputs.privateKey }}
           CHAIN_ID: 012A
           NETWORK: solo
+        shell: bash
         run: |
+          set -euo pipefail
           files=$(ls examples/*.py)
+
           for file in $files;
           do
             echo -e "\n************ ${file} ************"
-            uv run -m examples.$(basename "$file" .py)
-          done
+
+            module="examples.$(basename "$file" .py)"
+
+            # Run the example and capture both stdout and stderr
+            if ! output=$(uv run -m "$module" 2>&1); then
+              echo -e "\n❌ Example failed: ${file}"
+              echo "************ Error Output ************"
+              echo "$output"
+              echo "**************************************"
+              exit 1
+            fi
+
+            echo "$output"
+            echo "✅ Completed ${file} successfully."
+          done

CHANGELOG.md

@@ -7,7 +7,13 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 ## [Unreleased]
 
 ### Added
+- Add `TokenFeeScheduleUpdateTransaction` class to support updating custom fee schedules on tokens (#471).
+- Add `examples/token_update_fee_schedule_fungible.py` and `examples/token_update_fee_schedule_nft.py` demonstrating the use of `TokenFeeScheduleUpdateTransaction`.
+- Update `docs/sdk_users/running_examples.md` to include `TokenFeeScheduleUpdateTransaction`.
+- added FreezeTransaction class
+- added FreezeType class
 - Added `docs/sdk_developers/pylance.md`, a new guide explaining how to set up and use **Pylance** in VS Code for validating imports, file references, and methods before review. (#713)
+- feat: TokenAirdropClaim Transaction, examples (with signing required and not), unit and integration tests (#201)
 - docs: Add Google-style docstrings to `TokenId` class and its methods in `token_id.py`.
 - added Google-style docstrings to the `TransactionRecord` class including all dataclass fields, `__repr__`, `_from_proto()` & `_to_proto()` methods.
 - Standardized docstrings, improved error handling, and updated type hinting (`str | None` to `Optional[str]`) for the `FileId` class (#652).
@@ -23,6 +29,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - docs: Add `docs/sdk_developers/project_structure.md` to explain repository layout and import paths.
 
 ### Changed
+- chore: replaced hardcoded 'testnet' messages with environment network name
 - chore: validate that token airdrop transactions require an available token service on the channel (#632) 
 - chore: update local environment configuration in env.example (#649)
 - chore: Update env.example NETWORK to encourage testnet or local usage (#659)
@@ -36,6 +43,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Expanded docs/sdk_developers/signing.md to clarify GPG and DCO requirements and add a Table of Contents (#455).
 - chore: Standardized client initialization across all examples/ files to promote consistency (#658).
 - chore: changed the file names of airdrop examples, classes, unit and integration tests so they are grouped together. (#631)
+- Refactor `AbstractTokenTransferTransaction` to unify Token/NFT transfer logic.
 
 ### Fixed
 - Added explicit read permissions to examples.yml (#623)
@@ -44,13 +52,18 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - fix: Resolve `__eq__` type conflict in `CustomFee` class (#627)
 - Fixes a type conflict in `token_id.py` where `from_string` could receive `None`, preventing a runtime error by raising a `ValueError` if the input is missing. #630
 - Dependabot alerts (version bumps)
+- Fixed incorrect `TokenType` import (protobuf vs. SDK enum) in 18 example files.
+- Update `schedule_sign_transaction_e2e_test` to check for key presence instead of relying on index.
 
 ### Breaking Changes
 - chore: changed the file names airdrop classes (#631)
 {pending_airdrop_id.py -> token_airdrop_pending_id.py}
 {pending_airdrop_record.py -> token_airdrop_pending_record.py}
 {token_cancel_airdrop_transaction.py -> token_airdrop_transaction_cancel.py}
 
+- In `TokenAirdropTransaction` the parameters of the following methods have been renamed:
+  - add_nft_transfer(sender → sender_id, receiver → receiver_id)
+  - add_approved_nft_transfer(sender → sender_id, receiver → receiver_id)
 
 ## [0.1.7] - 2025-10-28
 
@@ -162,6 +175,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Add strict type hints to `TransactionGetReceiptQuery` (#420)
 - Fixed broken documentation links in CONTRIBUTING.md by converting absolute GitHub URLs to relative paths
 - Updated all documentation references to use local paths instead of pointing to hiero-sdk project hub
+- chore: fix the examples workflow to log error messages and run on import failure (#738)
 
 ## [0.1.5] - 2025-09-25
 

docs/sdk_users/running_examples.md

@@ -955,7 +955,7 @@ transaction = (
     TokenAirdropTransaction()
     .add_token_transfer(token_id=token_id, account_id=operator_id, amount=-1)
     .add_token_transfer(token_id=token_id, account_id=recipient_id, amount=1)
-    .add_nft_transfer(nft_id=nft_id, serial_number=serial_number, sender=operator_id, receiver=recipient_id)
+    .add_nft_transfer(nft_id=nft_id, serial_number=serial_number, sender_id=operator_id, receiver_id=recipient_id)
     .freeze_with(client)
     .sign(operator_key)
 )
@@ -1034,22 +1034,61 @@ print(nft_info)
 ### Querying Fungible Token Info
 
 #### Pythonic Syntax:
-```
+```python
 info_query = TokenInfoQuery(token_id=token_id)
 info = info_query.execute(client)
 print(info)
 ```
+
 #### Method Chaining:
-```
+```python
 info_query = (
-        TokenInfoQuery()
-        .set_token_id(token_id)
-    )
+    TokenInfoQuery()
+    .set_token_id(token_id)
+)
 
 info = info_query.execute(client)
 print(info)
 ```
 
+### Updating a Token Fee Schedule
+
+#### Pythonic Syntax:
+
+```python
+# Note: Royalty fees are only for NON_FUNGIBLE_UNIQUE tokens.
+new_fees = [
+    CustomFixedFee(amount=100, fee_collector_account_id=collector_account_id),
+    CustomRoyaltyFee(numerator=5, denominator=10, fee_collector_account_id=collector_account_id)
+]
+
+transaction = TokenFeeScheduleUpdateTransaction(
+    token_id=token_id, # assumed NFT in this example
+    custom_fees=new_fees
+).freeze_with(client)
+
+transaction.sign(fee_schedule_key) # The fee_schedule_key MUST sign
+transaction.execute(client)
+```
+
+#### Method Chaining:
+
+```python
+# Note: Fractional fees are only for FUNGIBLE_COMMON tokens.
+new_fees = [
+    CustomFixedFee(amount=100, fee_collector_account_id=collector_account_id)
+]
+
+transaction = (
+    TokenFeeScheduleUpdateTransaction()
+    .set_token_id(token_id) # assumed FUNGIBLE in this example
+    .set_custom_fees(new_fees)
+    .freeze_with(client)
+)
+
+transaction.sign(fee_schedule_key) # The fee_schedule_key MUST sign
+transaction.execute(client)
+```
 ## HBAR Transactions
 
 ### Transferring HBAR

examples/account_allowance_hbar.py

@@ -16,16 +16,18 @@
 from hiero_sdk_python.transaction.transfer_transaction import TransferTransaction
 
 load_dotenv()
-
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client():
     """Initialize and set up the client with operator account"""
-    network = Network(os.getenv('NETWORK'))
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
-    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    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)
+    print(f"Client set up with operator id {client.operator_account_id}")
 
     return client
 

examples/account_allowance_nft.py

@@ -27,15 +27,18 @@
 
 load_dotenv()
 
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client():
     """Initialize and set up the client with operator account"""
-    network = Network(os.getenv('NETWORK'))
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
-    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    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)
+    print(f"Client set up with operator id {client.operator_account_id}")
 
     return client
 

examples/account_create.py

@@ -37,6 +37,7 @@
 )
 
 load_dotenv()
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client() -> Tuple[Client, PrivateKey]:
     """
@@ -59,11 +60,13 @@ def setup_client() -> Tuple[Client, PrivateKey]:
         OPERATOR_ID (str): The account ID of the operator (format: "0.0.xxxxx")
         OPERATOR_KEY (str): The private key of the operator account
     """
-    network = Network(os.getenv('NETWORK'))
+
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv('OPERATOR_ID'))
-    operator_key = PrivateKey.from_string(os.getenv('OPERATOR_KEY'))
+    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_key

examples/account_delete.py

@@ -17,19 +17,21 @@
 
 load_dotenv()
 
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client():
     """Initialize and set up the client with operator account"""
-    network = Network(os.getenv('NETWORK'))
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
-    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    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)
+    print(f"Client set up with operator id {client.operator_account_id}")
 
     return client
 
-
 def create_account(client):
     """Create a test account"""
     account_private_key = PrivateKey.generate_ed25519()

examples/account_update.py

@@ -20,15 +20,18 @@
 
 load_dotenv()
 
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client():
     """Initialize and set up the client with operator account"""
-    network = Network(os.getenv('NETWORK'))
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
-    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    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)
+    print(f"Client set up with operator id {client.operator_account_id}")
 
     return client
 

examples/contract_create.py

@@ -33,15 +33,18 @@
 
 load_dotenv()
 
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client():
     """Initialize and set up the client with operator account"""
-    network = Network(os.getenv('NETWORK'))
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
-    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    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)
+    print(f"Client set up with operator id {client.operator_account_id}")
 
     return client
 

examples/contract_create_constructor.py

@@ -37,15 +37,18 @@
 
 load_dotenv()
 
+network_name = os.getenv('NETWORK', 'testnet').lower()
 
 def setup_client():
     """Initialize and set up the client with operator account"""
-    network = Network(os.getenv('NETWORK'))
+    network = Network(network_name)
+    print(f"Connecting to Hedera {network_name} network!")
     client = Client(network)
 
-    operator_id = AccountId.from_string(os.getenv("OPERATOR_ID"))
-    operator_key = PrivateKey.from_string(os.getenv("OPERATOR_KEY"))
+    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)
+    print(f"Client set up with operator id {client.operator_account_id}")
 
     return client