feat: hbar support

Signed-off-by: prajeeta pal <prajeetapal@gmail.com>

Author: prajeeta15

CHANGELOG.md

@@ -7,21 +7,28 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 ## [Unreleased]
 
 ### Added
+
 - Add examples/tokens/token_create_transaction_pause_key.py example demonstrating token pause/unpause behavior and pause key usage (#833)
 - Added `docs/sdk_developers/training/transaction_lifecycle.md` to explain the typical lifecycle of executing a transaction using the Hedera Python SDK.
 - Add inactivity bot workflow to unassign stale issue assignees (#952)
+- feat: Allow `add_hbar_transfer`, `add_approved_hbar_transfer`, and internal `_add_hbar_transfer` to accept `Hbar` objects in addition to raw tinybar integers, with internal normalization to tinybars. Added tests validating the new behavior.
+
 ### Changed
+
 -
 
 ### Fixed
+
 -
 
 ### Breaking Change
+
 -
 
 ## [0.1.10] - 2025-12-03
 
 ### Added
+
 - Added docs/sdk_developers/training/workflow: a training for developers to learn the workflow to contribute to the python SDK.
 - Added Improved NFT allowance deletion flow with receipt-based status checks and strict `SPENDER_DOES_NOT_HAVE_ALLOWANCE` verification.
 - Add `max_automatic_token_associations`, `staked_account_id`, `staked_node_id` and `decline_staking_reward` fields to `AccountUpdateTransaction` (#801)
@@ -30,8 +37,8 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Added `.github/workflows/merge-conflict-bot.yml` to automatically detect and notify users of merge conflicts in Pull Requests.
 - Added `.github/workflows/bot-office-hours.yml` to automate the Weekly Office Hour Reminder.
 - feat: Implement account creation with EVM-style alias transaction example.
-- Added validation logic in `.github/workflows/pr-checks.yml` to detect when no new changelog entries are added under [Unreleased]
-- feat: Allow `add_hbar_transfer`, `add_approved_hbar_transfer`, and internal `_add_hbar_transfer` to accept `Hbar` objects in addition to raw tinybar integers, with internal normalization to tinybars. Added tests validating the new behavior.
+- Added validation logic in `.github/workflows/pr-checks.yml` to detect when no new changelog entries are added under [Unreleased].
+- Support for message chunking in `TopicSubmitMessageTransaction`.
 
 ### Changed
 
@@ -41,7 +48,6 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - feat: Add string representation method for `CustomFractionalFee` class and update `custom_fractional_fee.py` example.
 - Moved query examples to their respective domain folders to improve structure matching.
 
-
 ### Fixed
 
 - fixed workflow: changelog check with improved sensitivity to deletions, additions, new releases

src/hiero_sdk_python/transaction/transfer_transaction.py

@@ -2,11 +2,12 @@
 Defines TransferTransaction for transferring HBAR or tokens between accounts.
 """
 
-from typing import Dict, List, Optional, Tuple
+from typing import Dict, List, Optional, Tuple, Union
 
 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.hbar import Hbar
 from hiero_sdk_python.hapi.services import basic_types_pb2, crypto_transfer_pb2, transaction_pb2
 from hiero_sdk_python.hapi.services.schedulable_transaction_body_pb2 import (
     SchedulableTransactionBody,
@@ -60,14 +61,14 @@ def _init_hbar_transfers(self, hbar_transfers: Dict[AccountId, int]) -> None:
             self.add_hbar_transfer(account_id, amount)
 
     def _add_hbar_transfer(
-        self, account_id: AccountId, amount: int, is_approved: bool = False
+        self, account_id: AccountId, amount: Union[int, Hbar], is_approved: bool = False
     ) -> "TransferTransaction":
         """
         Internal method to add a HBAR transfer to the transaction.
 
         Args:
             account_id (AccountId): The account ID of the sender or receiver.
-            amount (int): The amount of the HBAR to transfer.
+            amount (Union[int, Hbar]): The amount of the HBAR to transfer (in tinybars if int, or Hbar object).
             is_approved (bool, optional): Whether the transfer is approved. Defaults to False.
 
         Returns:
@@ -81,11 +82,13 @@ def _add_hbar_transfer(
         if amount is None:
             raise TypeError("amount cannot be None.")
 
-        if not isinstance(amount, int):
-            raise TypeError("amount must be an integer.")
+        if isinstance(amount, Hbar):
+            amount = amount.to_tinybars()
+        elif not isinstance(amount, int):
+            raise TypeError("amount must be an integer or Hbar object.")
 
         if amount == 0:
-            raise ValueError("amount must be a non-zero integer.")
+            raise ValueError("Amount must be a non-zero value.")
 
         if not isinstance(is_approved, bool):
             raise TypeError("is_approved must be a boolean.")
@@ -95,17 +98,17 @@ def _add_hbar_transfer(
                 transfer.amount += amount
                 return self
 
-                self.hbar_transfers.append(
-                    HbarTransfer(account_id, amount, is_approved))
-                return self
+        self.hbar_transfers.append(
+            HbarTransfer(account_id, amount, is_approved))
+        return self
 
-    def add_hbar_transfer(self, account_id: AccountId, amount: int) -> "TransferTransaction":
+    def add_hbar_transfer(self, account_id: AccountId, amount: Union[int, Hbar]) -> "TransferTransaction":
         """
         Adds a HBAR transfer to the transaction.
 
         Args:
             account_id (AccountId): The account ID of the sender or receiver.
-            amount (int): The amount of the HBAR to transfer.
+            amount (Union[int, Hbar]): The amount of the HBAR to transfer (in tinybars if int, or Hbar object).
 
         Returns:
             TransferTransaction: The current instance of the transaction for chaining.
@@ -114,14 +117,14 @@ def add_hbar_transfer(self, account_id: AccountId, amount: int) -> "TransferTran
         return self
 
     def add_approved_hbar_transfer(
-        self, account_id: AccountId, amount: int
+        self, account_id: AccountId, amount: Union[int, Hbar]
     ) -> "TransferTransaction":
         """
         Adds a HBAR transfer with approval to the transaction.
 
         Args:
             account_id (AccountId): The account ID of the sender or receiver.
-            amount (int): The amount of the HBAR to transfer.
+            amount (Union[int, Hbar]): The amount of the HBAR to transfer (in tinybars if int, or Hbar object).
 
         Returns:
             TransferTransaction: The current instance of the transaction for chaining.