feat: Add Hip 1261 Implementation

.github/workflows/pr-check-secondary-unit-integration-test.yml

@@ -132,6 +132,7 @@ jobs:
         uses: hiero-ledger/hiero-solo-action@692b186bd2e4c8d46b9deb1c067dc6ddcf0abcd7 # v0.15.0
         with:
           installMirrorNode: true
+          mirrorNodeVersion: v0.153.0
 
       - name: Run integration tests
         id: integration

src/hiero_sdk_python/fees/fee_estimate.py

@@ -0,0 +1,22 @@
+"""Fee estimation models for calculating base and extra fees.
+
+This module defines the FeeEstimate dataclass, which aggregates
+a base fee with optional extra fee components.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from hiero_sdk_python.fees.fee_extra import FeeExtra
+
+
+@dataclass(frozen=True)
+class FeeEstimate:
+    """Represents a fee estimate composed of a base amount and optional extras."""
+
+    base: int
+    extras: list[FeeExtra] = field(default_factory=list)
+
+    def __post_init__(self) -> None:
+        object.__setattr__(self, "extras", tuple(self.extras))

src/hiero_sdk_python/fees/fee_estimate_mode.py

@@ -0,0 +1,15 @@
+"""Enumeration of fee estimation modes.
+
+Defines the available strategies for calculating fee estimates.
+"""
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class FeeEstimateMode(str, Enum):
+    """Supported modes for fee estimation."""
+
+    STATE = "STATE"
+    INTRINSIC = "INTRINSIC"

src/hiero_sdk_python/fees/fee_estimate_response.py

@@ -0,0 +1,25 @@
+"""Response model for fee estimation results.
+
+Contains the calculated fees across different categories along with
+the estimation mode and optional notes.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from hiero_sdk_python.fees.fee_estimate import FeeEstimate
+from hiero_sdk_python.fees.fee_estimate_mode import FeeEstimateMode
+from hiero_sdk_python.fees.network_fee import NetworkFee
+
+
+@dataclass(frozen=True)
+class FeeEstimateResponse:
+    """Represents the result of a fee estimation operation."""
+
+    mode: FeeEstimateMode
+    network_fee: NetworkFee | None = None
+    node_fee: FeeEstimate | None = None
+    service_fee: FeeEstimate | None = None
+    total: int = 0
+    high_volume_multiplier: int = 0

src/hiero_sdk_python/fees/fee_extra.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class FeeExtra:
+    """
+    Represents additional fee details associated with a transaction or operation.
+    """
+
+    name: str | None = None
+    included: int | None = None
+    count: int | None = None
+    charged: int | None = None
+    fee_per_unit: int | None = None
+    subtotal: int | None = None

src/hiero_sdk_python/fees/network_fee.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class NetworkFee:
+    multiplier: int
+    subtotal: int