Merge branch 'pr970-signed' of https://github.com/cheese-cakee/hiero-sdk-python into pr970-signed

Author: cheese-cakee

.github/scripts/check_advanced_requirement.sh

@@ -0,0 +1,93 @@
+#!/bin/bash
+set -euo pipefail
+
+# 1. Define Helper Functions First
+log() {
+  echo "[advanced-check] $1"
+}
+
+# 2. Validate required environment variables
+if [[ -z "${REPO:-}" ]] || [[ -z "${ISSUE_NUMBER:-}" ]] || [[ -z "${GH_TOKEN:-}" ]]; then
+  log "ERROR: Required environment variables (REPO, ISSUE_NUMBER, GH_TOKEN) must be set"
+  exit 1
+fi
+
+# 3. Function to check a single user
+check_user() {
+  local user=$1
+  log "Checking qualification for @$user..."
+
+  # Permission exemption
+  PERM_JSON=$(gh api "repos/$REPO/collaborators/$user/permission" 2>/dev/null || echo '{"permission":"none"}')
+  PERMISSION=$(echo "$PERM_JSON" | jq -r '.permission // "none"')
+
+  if [[ "$PERMISSION" =~ ^(admin|write|triage)$ ]]; then
+    log "User @$user is core member ($PERMISSION). Qualification check skipped."
+    return 0
+  fi
+
+  # 2. Get counts
+  # Using exact repository label names ("Good First Issue" and "intermediate")
+  GFI_QUERY="repo:$REPO is:issue is:closed assignee:$user -reason:\"not planned\" label:\"Good First Issue\""
+  INT_QUERY="repo:$REPO is:issue is:closed assignee:$user -reason:\"not planned\" label:\"intermediate\""
+
+  GFI_COUNT=$(gh api "search/issues" -f q="$GFI_QUERY" --jq '.total_count' || echo "0")
+  INT_COUNT=$(gh api "search/issues" -f q="$INT_QUERY" --jq '.total_count' || echo "0")
+
+  # Numeric validation
+  if ! [[ "$GFI_COUNT" =~ ^[0-9]+$ ]]; then GFI_COUNT=0; fi
+  if ! [[ "$INT_COUNT" =~ ^[0-9]+$ ]]; then INT_COUNT=0; fi
+
+  # Validation Logic
+  if (( GFI_COUNT >= 1 )) && (( INT_COUNT >= 1 )); then
+    log "User @$user qualified."
+    return 0
+  else
+    log "User @$user failed. Unassigning..."
+
+    # Tailor the suggestion based on what is missing
+    # Links and names now match exact repository labels
+    if (( GFI_COUNT == 0 )); then
+      SUGGESTION="[Good First Issue](https://github.com/$REPO/labels/Good%20First%20Issue)"
+    else
+      SUGGESTION="[intermediate issue](https://github.com/$REPO/labels/intermediate)"
+    fi
+
+    # Post the message FIRST, then unassign.
+    MSG="Hi @$user, I cannot assign you to this issue yet.
+
+**Why?**
+Advanced issues involve high-risk changes to the core codebase. They require significant testing and can impact automation and CI behavior.
+
+**Requirement:**
+- Complete at least **1** 'Good First Issue' (You have: **$GFI_COUNT**)
+- Complete at least **1** 'intermediate' issue (You have: **$INT_COUNT**)
+
+Please check out our **$SUGGESTION** tasks to build your experience first!"
+
+    gh issue comment "$ISSUE_NUMBER" --repo "$REPO" --body "$MSG"
+    gh issue edit "$ISSUE_NUMBER" --repo "$REPO" --remove-assignee "$user"
+  fi
+}
+
+# --- Main Logic ---
+
+if [[ -n "${TRIGGER_ASSIGNEE:-}" ]]; then
+  check_user "$TRIGGER_ASSIGNEE"
+else
+  log "Checking all current assignees..."
+  
+  # Fetch assignees into a variable first. 
+  ASSIGNEE_LIST=$(gh issue view "$ISSUE_NUMBER" --repo "$REPO" --json assignees --jq '.assignees[].login')
+
+  if [[ -z "$ASSIGNEE_LIST" ]]; then
+    log "No assignees found to check."
+  else
+    # Use a here-string (<<<) to iterate over the variable safely.
+    while read -r user; do
+      if [[ -n "$user" ]]; then
+        check_user "$user"
+      fi
+    done <<< "$ASSIGNEE_LIST"
+  fi
+fi

.github/workflows/bot-advanced-check.yml

@@ -0,0 +1,38 @@
+name: PythonBot - Advanced Requirement Check
+
+on:
+  issues:
+    types: [assigned, labeled]
+
+permissions:
+  issues: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.issue.number }}
+  cancel-in-progress: true
+
+jobs:
+  check-advanced-qualification:
+    # Run only for issues labeled 'advanced', triggered by assignment or by adding
+    # the label to an issue that already has assignees
+    if: >
+      contains(github.event.issue.labels.*.name, 'advanced') && 
+      (github.event.action == 'assigned' || (github.event.action == 'labeled' && github.event.issue.assignees[0] != null))
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout scripts
+        # Pinned to v6.0.1 (8e8c483db84b4bee98b60c0593521ed34d9990e8)
+        # Followed guide: https://github.com/actions/checkout/releases
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        with:
+          sparse-checkout: .github/scripts
+
+      - name: Verify User Qualification
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TRIGGER_ASSIGNEE: ${{ github.event.assignee.login || '' }}
+          ISSUE_NUMBER: ${{ github.event.issue.number }}
+          REPO: ${{ github.repository }}
+        run: |
+          chmod +x .github/scripts/check_advanced_requirement.sh
+          ./.github/scripts/check_advanced_requirement.sh

CHANGELOG.md

@@ -7,7 +7,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 ## [Unreleased]
 
 ### Added
-
+- Automated assignment guard for `advanced` issues; requires completion of at least one `good first issue` and one `intermediate` issue before assignment (exempts maintainers, committers, and triage members). (#1142)
 - Added Hbar object support for TransferTransaction HBAR transfers:
   - Methods now accept `Union[int, Hbar]` for amount parameters with immediate normalization to tinybars
   - Includes comprehensive unit tests covering various Hbar units (HBAR, MICROBAR, NANOBAR, TINYBAR) and accumulation behavior with mixed `int` and `Hbar` inputs
@@ -111,6 +111,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 
 ### Fixed
 
+- Fixed the README account balance example to use correct SDK APIs and provide a runnable testnet setup. (#1250)
 - Fix token association verification in `token_airdrop_transaction.py` to correctly check if tokens are associated by using `token_id in token_balances` instead of incorrectly displaying zero balances which was misleading (#[815])
 - Fixed inactivity bot workflow not checking out repository before running (#964)
 - Fixed the topic_message_query integarion test

README.md

@@ -14,6 +14,7 @@ A Python SDK for interacting with the Hedera Hashgraph platform.
 ```bash
 pip install --upgrade pip
 pip install hiero-sdk-python
+pip install python-dotenv
 ```
 
 ### Environment Configuration
@@ -30,14 +31,22 @@ A sample file is provided: [.env.example](.env.example)
 ### Basic Usage
 
 ```python
-from hiero_sdk_python import Client, AccountBalanceQuery
+import os
+from dotenv import load_dotenv
+from hiero_sdk_python import Network, Client, CryptoGetAccountBalanceQuery, AccountId, PrivateKey
 
 # Connect to testnet
-client = Client.for_testnet()
-client.set_operator(account_id, private_key)
+load_dotenv()
+network = Network("testnet")
+client = Client(network)
+
+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)
 
 # Query account balance
-balance = AccountBalanceQuery(account_id=account_id).execute(client)
+balance = CryptoGetAccountBalanceQuery(account_id=operator_id).execute(client)
 print(f"Balance: {balance.hbars} HBAR")
 ```