chore: Restructure dependencies and add optional extras (hiero-ledger#1679)

Signed-off-by: Manish Dait <daitmanish88@gmail.com>

Author: manishdait

.github/workflows/deps-check.yml

@@ -0,0 +1,76 @@
+name: Dependency Compatibility Check
+
+on:
+  push:
+    paths:
+      - "pyproject.toml"
+  pull_request:
+    paths:
+      - "pyproject.toml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  min-deps:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.14"]
+
+    steps:
+      - name: Harden the runner (Audit all outbound calls)
+        uses: step-security/harden-runner@e3f713f2d8f53843e71c69a996d56f51aa9adfb9 # v2.14.1
+        with:
+          egress-policy: audit
+      
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@803947b9bd8e9f986429fa0c5a41c367cd732b41 # v7.2.1
+
+      - name: Create virtual environment
+        run: uv venv
+
+      - name: Install minimum dependencies and tooling
+        run: |
+          uv sync --all-extras --resolution=lowest-direct
+
+      - name: Show resolved core dependency versions
+        run: |
+          echo "Resolved core dependency versions:"
+          PATTERN='^(
+            protobuf|
+            grpcio|
+            cryptography|
+            requests|
+            pycryptodome|
+            eth-abi|
+            python-dotenv|
+            eth-keys|
+            rlp|
+            grpcio-tools|
+            ruff|
+            mypy|
+            typing-extensions|
+            pytest
+          )\s'
+          uv pip list | grep -E "$(echo "$PATTERN" | tr -d '\n ')"
+
+      - name: Generate Proto Files
+        run: |
+          uv run python generate_proto.py
+
+      - name: Run unit tests (min deps)
+        run: |
+          uv run pytest tests/unit -v

.github/workflows/pr-check-examples.yml

@@ -27,7 +27,7 @@ jobs:
         uses: astral-sh/setup-uv@803947b9bd8e9f986429fa0c5a41c367cd732b41
 
       - name: Install dependencies
-        run: uv sync
+        run: uv sync --all-extras
 
       - name: Generate Proto Files
         run: uv run python generate_proto.py

.github/workflows/pr-check-test.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - name: Harden the runner (Audit all outbound calls)

CHANGELOG.md

@@ -151,6 +151,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Added `/working` command to reset the inactivity timer on issues and PRs. ([#1552](https://github.com/hiero-ledger/hiero-sdk-python/issues/1552))
 - Added `grpc_deadline` support for transaction and query execution.
 - Type hints to exception classes (`PrecheckError`, `MaxAttemptsError`, `ReceiptStatusError`) constructors and string methods.
+- Added `__eq__` and `__hash__` functions for Keys.
 
 ### Documentation
 - Fix relative links in `testing.md`, clean up `CONTRIBUTING.md` TOC, and normalize test file naming and paths (`#1706`)
@@ -258,6 +259,8 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - chore: update merge conflict bot message with web editor tips (#1592)
 - chore: update MAINTAINERS.md to include new maintainer Manish Dait and sort maintainers by GitHub ID. (#1691)
 - chore: clarify wording in the bot-assignment-check.sh (#1748)
+- Refactored SDK dependencies to use version ranges, moved build-only deps out of runtime, removed unused core deps and added optional extras.
+
 
 ### Fixed
 - Corrected broken documentation links in SDK developer training files.(#1707)

README.md

@@ -6,6 +6,8 @@
 
 A Python SDK for interacting with the Hedera Hashgraph platform.
 
+>**Python compatibility:** 
+> The SDK supports Python ≥ 3.10 and is tested on Python 3.10–3.14. Newer Python versions may work but have not yet been validated.
 
 ## Quick Start
 

docs/sdk_developers/examples.md

@@ -24,6 +24,24 @@ python examples/name_of_file.py
 python -m examples.name_of_module
 ```
 
+### Optional Dependencies for Examples
+
+Some example scripts (notably those related to Ethereum / EVM functionality) require **optional dependencies** that are not installed by default.
+
+If you encounter import errors related to Ethereum libraries, install the ETH extra before running those examples.
+
+#### Using uv (recommended)
+
+```bash
+uv sync --dev --extra eth
+```
+
+#### Using pip
+
+```bash
+pip install -e ".[eth]"
+```
+
 You'll need your environment variables and uv set up as outlined in /README.md [README](https://github.com/hiero-ledger/hiero-sdk-python/blob/main/README.md)
 
 

docs/sdk_developers/setup.md

@@ -144,6 +144,35 @@ pip install -e .
 
 **Note:** This method requires you to have Python 3.10+ already installed on your system. Changes to your local code will be immediately reflected when you import the SDK.
 
+## Installing Optional Dependencies
+Some SDK features (such as Ethereum-related functionality) rely on optional dependencies that are not installed by default.
+
+These optional dependencies are required for:
+- Integration tests covering ETH-specific features
+- Running ETH-related example scripts
+
+Optional dependencies are provided via **extras**.
+
+#### Using pip
+To install the SDK for local development with Ethereum support enabled:
+```bash
+pip install -e ".[eth]"
+```
+
+#### Using uv (recommended)
+For most contributors, start with the standard development environment:
+```bash
+uv sync
+```
+If you are working on ETH functionality, running ETH-related tests, or executing ETH examples, install the ETH extra explicitly:
+```bash
+uv sync --dev --extra eth
+```
+
+Optional: To install all available extras (useful full-matrix testing):
+```bash
+uv sync --dev --all-extras
+```
 
 ## Generate Protocol Buffers
 

docs/sdk_developers/testing.md

@@ -235,6 +235,36 @@ TOPIC_ID=0.0.1234569
 
 ---
 
+### Optional Dependencies for Tests
+
+Some unit and integration tests (notably those covering Ethereum / EVM
+functionality) rely on **optional ETH-related dependencies**. These
+dependencies are **not installed by default**.
+
+If these dependencies are missing ETH-related unit tests may fail with import errors.
+
+These dependencies are provided via the `eth` extra.
+
+#### Using uv (recommended)
+
+When working on the SDK locally and running the full test suite:
+
+```bash
+uv sync --dev --extra eth
+```
+This installs:
+- All standard development dependencies (pytest, ruff, mypy, etc.)
+- All ETH-related optional dependencies required for tests and examples
+
+#### Using pip
+If you are using pip instead of uv:
+
+```bash
+pip install -e ".[eth]"
+```
+
+This ensures all ETH-related test code paths execute correctly during development.
+
 ### VS Code Setup
 
 VS Code provides excellent Python testing support with built-in test discovery and debugging.

pyproject.toml

@@ -12,18 +12,15 @@ authors = [
 ]
 license = { file = "LICENSE" }
 readme = "README.md"
-requires-python = ">=3.10, <3.14"
+requires-python = ">=3.10, <4"
 dependencies = [
-    "grpcio-tools==1.76.0",
-    "protobuf==6.33.2",
-    "grpcio==1.76.0",
-    "cryptography==44.0.0",
-    "python-dotenv==1.2.1",
-    "requests>=2.32.4",
-    "pycryptodome==3.23.0",
-    "eth-abi==5.2.0",
-    "rlp>=4.0.0",
-    "eth-keys==0.7.0",
+    "protobuf>=4.21.12,<7",
+    "grpcio>=1.76.0,<2",
+    "cryptography>=44.0.1,<47",
+    "requests>=2.31.0,<3",
+    "pycryptodome>=3.18.0,<4",
+    "eth-abi>=5.1.0,<6",
+    "python-dotenv>=1.2.1,<3",
 ]
 classifiers = [
     "Development Status :: 2 - Pre-Alpha",
@@ -32,27 +29,36 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Operating System :: OS Independent",
     "Intended Audience :: Developers",
     "Topic :: Software Development :: Libraries",
 ]
 
+[project.optional-dependencies]
+eth = [
+    "eth-keys>=0.7.0,<0.8",
+    "rlp>=4.0.1,<5",
+]
+
 [dependency-groups]
 dev = [
-    "pytest>=8.3.4",
-    "pytest-cov>=7.0.0",
+    "grpcio-tools>=1.76.0,<2",
+    "pytest>=8.3.4,<9",
+    "pytest-cov>=7.0.0,<8",
 ]
+
 lint = [
-    "ruff>=0.14.9",
-    "mypy>=1.18.2",
-    "typing-extensions>=4.15.0",
+    "ruff>=0.14.9,<1",
+    "mypy>=1.18.2,<2",
+    "typing-extensions>=4.15.0,<5",
 ]
 
 [tool.uv]
 default-groups = ["dev", "lint"]
 
 [build-system]
-requires = ["pdm-backend", "setuptools", "setuptools_scm"]
+requires = ["pdm-backend", "setuptools", "setuptools_scm", "grpcio-tools"]
 build-backend = "pdm.backend"
 
 [tool.setuptools_scm]
@@ -72,7 +78,7 @@ testpaths = ["tests"]
 
 [tool.ruff]
 line-length = 120
-target-version = "py310"
+target-version = "py314"
 
 [tool.ruff.lint]
 select = [

src/hiero_sdk_python/crypto/private_key.py

@@ -469,3 +469,20 @@ def _parse_legacy_ecdsa_der_key(key_bytes: bytes) -> "ec.EllipticCurvePrivateKey
             return ec.derive_private_key(private_int, ec.SECP256K1())
         except Exception as exc:
             raise ValueError(f"Failed to derive ECDSA private key: {exc}") from exc
+    
+    def __eq__(self, other: object) -> bool:
+        """
+        Compare two PrivateKey objects for equality.
+        """
+        if not isinstance(other, PrivateKey):
+            return NotImplemented
+
+        # Different algorithms can never be equal
+        if self.is_ed25519() != other.is_ed25519():
+            return False
+
+        return self.to_bytes_raw() == other.to_bytes_raw()
+    
+    def __hash__(self) -> int:
+        """Returns the hash value for the private key."""
+        return hash((self.is_ed25519(), self.to_bytes_raw()))