[Good First Issue]: what about the flow?

[exploreriii]

🆕🐥 Newcomer Friendly

This Good First Issue is a guided, well-scoped task intended for new contributors to the Hiero Python SDK.

It is designed to help you:
✅ understand how the repository is structured
✅ practice the standard contribution workflow
✅ submit and merge a pull request

A maintainer or mentor actively monitors this issue and will help guide it to completion.

Important

This issue does not require prior domain knowledge.

• No Hiero or Hedera experience needed
• No distributed ledger background required
• Basic Python and Git are sufficient

⏱️ Typical time to complete: 30–90 minutes (once setup is done)
🧩 Difficulty: Small, well-contained change
🎓 Best for: New contributors

👾 Issue description

This issue addresses a small but real improvement needed at the Hiero Python SDK.

Edit here. Example provided below.

💡 Proposed Solution

Edit here. Example provided below.

🛠️ Implementation Steps

Edit here. Example provided below.

📋 Step-by-Step Setup Guide

Suggestions:

• Visual Studio (VS) Code: Guide

• GitHub Desktop: Guide

• Hedera Testnet Account with root .env file: Guide

• Create a GPG key linked to GitHub: Guide

Setup the Hiero Python SDK for development

• Fork Create an online and local copy of the repository: Guide

• Connect origin with upstream: Guide

• Install Packages and protobuffs: Guide

• Sync Main pull any recent upstream changes: Guide

You are set up! 🎉

📋 Step-by-step contribution guide

✅ Get ready

• Claim the issue: comment /assign: Guide

• Double check the Issue and AI plan: carefully re-read the issue description and the CodeRabbit AI plan

• Ask questions early: ask on Discord, your @mentor (Python SDK help) and the @good_first_issue_support_team (setup and workflow help)

• Sync with main: pull the latest upstream changes Guide

• 💡 Tip: Before coding, leave a short comment describing what you plan to change. We’ll confirm you’re on the right track.

🛠️ Solve the Issue

• Create a branch from main: Guide

• Implement the solution: follow the implementation steps in the issue description.

• Commit with DCO and GPG signing: commit changes using: git commit -S -s -m "chore: your message", Guide

• Add a .CHANGELOG.md entry: under the appropriate [UNRELEASED] section and commit as git commit -S -s -m "chore: changelog entry" Guide

🚀 Create the pull request

• Push your commits: push your branch to your fork git push origin your-branch-name

• Open a pull request: here guide

• Complete the PR description: briefly describe your changes, Guide

• Link the Issue: link the issue the PR solves in the PR description, Guide

• Submit the pull request: click **Create pull request** 🎉

✅ Acceptance criteria

To be able to close this issue, the following criteria must be met:

• The issue is solved: I’ve carefully read and implemented the issue requirements

• I did not add extra changes: I did not modify anything beyond what is described in the issue

• Behavior: All other existing features continue to work as before

• Checks and feedback: All checks pass and any requested changes have been made

🧭 Getting help if you’re stuck

If you run into questions or get blocked, don’t spend more than 20 minutes stuck on your own.

You can:

• comment on this issue and tag @good_first_issue_support_team or @mentor_name
• ask for help in Discord

Getting stuck and reaching out for help is a normal part of the contribution process.
Even partial progress or draft pull requests are welcome!

🤔 What to expect after submitting a PR

Once you open a pull request, here’s what happens next:

🤖 Automated checks

A few automated checks will run and all must pass before your PR can be merged, such as:

• signing
• changelog entry
• solo unit and integration tests
• examples
• code quality checks

👉 You can open each check to see detailed results and error messages if anything fails.

🤝 AI feedback (CodeRabbit)

You’ll receive quick feedback from CodeRabbit AI, which may:

• point out potential issues
• suggest improvements or alternatives

AI feedback is advisory — it can make mistakes - use what’s helpful and relevant to the issue description.

😎 Team Member review

A Python SDK team member will review your PR, typically within 1–3 days.
Reviews focus on clarity and learning.

• You may be asked to make changes, or
• Your PR may be approved as-is ✅

Once approved, PRs are usually merged within one day.

🔄 Merge conflicts

Merge conflicts can occasionally happen as the SDK updates. This is normal and fixable.

• Changelog conflicts
  These are common and can usually be resolved by accepting both changes using GitHub’s online editor in the pull request.

• Other conflicts
  More complex conflicts may require rebasing your branch and resolving them locally.
  👉 Follow the step-by-step Rebasing Guide for help.

🏁 What success looks like

When this issue is complete, you will have:
✅ Solved a real issue we need resolving
✅ a merged pull request in the Hiero Python SDK
✅ your name permanently in the project history
✅ confidence to take on larger issues next

🤖 AI usage guidelines

You’re welcome to use AI tools while working on this issue.

Many contributors do — especially for:

• understanding unfamiliar code
• drafting small refactors
• sanity-checking approaches

Use AI responsibly:

• review suggestions carefully
• apply changes incrementally
• test as you go

If in doubt, ask — maintainers are happy to help.

🤔 Additional Help

First Points of Contact:

• Discord
• Comment with @mentor_name (for Python SDK questions)
• Comment with @hiero-ledger/hiero-sdk-good-first-issue-support (for setup and workflow questions)
  The more you ask, the more you learn and so do we!

Documentation:

• README.md

• CONTRIBUTING.md

• Project Structure

• DCO and Verified Signing Guide

• Changelog Guide

• Rebasing Guide

• Merge Conflicts Guide

• Linking Issues Guide

• Workflow Guide

• Pin Github Actions Guide

• Running Examples

• Testing on Forks

• General Training

• General SDK Developer Docs

Calls:

• Get hands-on-help by our expert team at our Office Hours
• Learn, raise issues and provide feedback at Community Calls

[soham-k-sinha]

/assign

[github-actions]

👋 Hi @soham-k-sinha, welcome to the Hiero Python SDK community!

You've been assigned this Good First Issue, and today’s on-call mentor from @hiero-ledger/hiero-sdk-python-triage is @exploreriii. They're here to help you land a great first contribution.

How to get started

• Review the issue description and any linked docs
• Share updates early and ask @exploreriii anything right here
• Keep the feedback loop short so we can support you quickly

Need more backup? @hiero-ledger/hiero-sdk-good-first-issue-support is also on standby to cheer you on.

Mentor: @exploreriii
Mentee: @soham-k-sinha

If you're enjoying the SDK, consider ⭐️ starring the repository so it's easy to find later.

Happy building!
— Python SDK Team

[github-actions]

@coderabbitai plan

[soham-k-sinha]

@exploreriii Hey, I've installed and setup the Hiero Python SDK for development. I didn't really understand what issue I have to work on. I read the docs and have followed everything above. Would appreciate your guidance.