Skip to content

Conversation

@CynthiaFotso
Copy link
Contributor

Description

This PR adds a beginner-friendly documentation page explaining the transaction lifecycle in the Python SDK.

Linked Issue

Fixes #864: Create docs/sdk_developers/training/transaction_lifecycle.md

Checklist

  • Created docs/sdk_developers/training/transaction_lifecycle.md

  • Overview of the transaction flow (construct → freeze → sign → execute → check receipt)

  • Detailed explanation of each step, including why the order matters

  • Code examples using both Pythonic and method chaining syntax

  • A simple flow diagram

  • Common pitfalls and best practices

  • Referenced existing examples like examples/token_grant_kyc.py and examples/token_associate.py

Copy link
Contributor

@exploreriii exploreriii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wow ! excellent work!
we have one issue - we don't yet have a get receipt method in the python sdk

currently executing it will also get you a receipt

@exploreriii
Copy link
Contributor

Hi @CynthiaFotso please rebase to pull in main's changes, we applied a fix that was blocking our tests.

@exploreriii
Copy link
Contributor

Hi @CynthiaFotso please do let us know if we can be of assistance

@github-actions
Copy link

github-actions bot commented Dec 3, 2025

Hello, this is the Office Hour Bot.

This is a reminder that the Hiero Python SDK Office Hours are scheduled in approximately 4 hours (14:00 UTC).

This session provides an opportunity to ask questions regarding this Pull Request or receive assistance from a maintainer.

Details:

Disclaimer: This is an automated reminder. Please verify the schedule here to be notified of any changes.

@nadineloepfe
Copy link
Contributor

Hi @CynthiaFotso ,
Are you still working on this?
Thank you

@CynthiaFotso
Copy link
Contributor Author

Hi @nadineloepfe
Yes I am.
I am sorry for the delay, I had exams going on in school.
I had planned to complete this today.

Copilot AI review requested due to automatic review settings December 3, 2025 13:39
Copilot finished reviewing on behalf of CynthiaFotso December 3, 2025 13:43
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive beginner-friendly documentation explaining the transaction lifecycle in the Hedera Python SDK. The guide covers the essential five-step flow (construct → freeze → sign → execute → check receipt) with detailed explanations, code examples in both Pythonic and method chaining styles, and common pitfalls to avoid.

Key Changes

  • Created docs/sdk_developers/training/transaction_lifecycle.md with complete transaction lifecycle documentation
  • Added entry to CHANGELOG.md documenting the new training guide
  • Includes practical code examples, flow diagrams, and ResponseCode failure examples

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
docs/sdk_developers/training/transaction_lifecycle.md New comprehensive guide explaining transaction lifecycle with step-by-step walkthrough, code examples, common pitfalls, and best practices
CHANGELOG.md Added changelog entry documenting the new transaction lifecycle training guide

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@CynthiaFotso
Copy link
Contributor Author

@exploreriii
As promised, there you go.
Kindly have a look and let me know if there are some modifications to be done.

@exploreriii
Copy link
Contributor

Hi @CynthiaFotso thank you so much, could you take a look to update the copilot feedback please?

@CynthiaFotso
Copy link
Contributor Author

Hi @CynthiaFotso thank you so much, could you take a look to update the copilot feedback please?

Yes I did and I have already addressed those changes.

Copy link
Contributor

@exploreriii exploreriii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excellent contribution - really incredible work!

I would like to merge this

We have a new release, 0.1.10
This means your changelog entry is outdated

Please pull in recent changes and rebase
and move this:

  • Added docs/sdk_developers/training/transaction_lifecycle.md to explain the typical lifecycle of executing a transaction using the Hedera Python SDK.
    rouhgly to line 11 or so

Signed-off-by: Cynthia Fotso <cynthiafotso8@gmail.com>
Signed-off-by: Cynthia Fotso <cynthiafotso8@gmail.com>
Signed-off-by: Cynthia Fotso <cynthiafotso8@gmail.com>
Signed-off-by: Cynthia Fotso <cynthiafotso8@gmail.com>
Signed-off-by: Cynthia Fotso <cynthiafotso8@gmail.com>
Signed-off-by: Cynthia Fotso <cynthiafotso8@gmail.com>
@CynthiaFotso
Copy link
Contributor Author

@exploreriii
It is done !

@exploreriii exploreriii merged commit acf4d26 into hiero-ledger:main Dec 3, 2025
17 of 18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create docs/sdk_developers/training/transaction_lifecycle.md

3 participants