feat: add detail to token_airdrop and token_airdrop_cancel

[tech0priyanshu]

Description:

Add detailed usage examples for token airdrop and token airdrop cancel to improve developer clarity.

• Add examples/token_airdrop.py with usage details
• Add examples/token_airdrop_cancel.py with usage details

Related issue(s):

Fixes #372

Checklist

• Documented (examples + README updated)

• Tested (ran examples locally, added references in docs)

[exploreriii]

Hi thank you for this @tech0priyanshu. We require a log in the changelog please to describe your PR.
If its not in the contributing.md, please could you help by creating an issue?

[exploreriii]

I love the formatting and additions...
Watch out the recipient balance is not adding up
Also please check a couple other details

[exploreriii]

I'm not sure this example is all working yet

Key bits to check

• whether association worked
• whether airdrop output is correct

[exploreriii]

Change to:
Added to the example script for Token Airdrop...
(as it existed before)
I'd suggest summarising the changes so its just one line. if that's not possible, make sure the bullets are indented so it is clear it is related to token airdrop change.

[exploreriii]

Hi @tech0priyanshu just checking in on this, let us know if you need any help. Thank you

[exploreriii]

Hi @tech0priyanshu , there is a problem with your signing for these commits:

🔴 | 29c4b5f | Revise CHANGELOG.md for recent updates | No sign-off matches the author or committer
🔴 29c4b5f Revise CHANGELOG.md for recent updates No sign-off matches the author or committer

This is your most recent commit I think so maybe the easiest path is to soft revert your last commit and re-sign it

[exploreriii]

Sorry, also, we have a new 0.1.5 update so please rebase with a changed section for the unreleased content

[exploreriii]

Your last commit is still unverified, make sure you
git commit -S -s -m "chore: changelog update"
perhaps soft revert and try again

[exploreriii]

Hi @tech0priyanshu
Could you please confirm if you are still working on this?
We will be releasing 0.1.6 which will require another rebase and a changelog update from 0.1.5 to 0.1.6
Many thanks

[tech0priyanshu]

Hi @explorerII Yes, I will make the necessary changes by tomorrow. I apologize for the delay; I was occupied with my exams.

…

On Fri, 17 Oct 2025 at 03:42, exploreriii ***@***.***> wrote: *exploreriii* left a comment (hiero-ledger/hiero-sdk-python#376) <#376 (comment)> Hi @tech0priyanshu <https://github.com/tech0priyanshu> Could you please confirm if you are still working on this? We will be releasing 0.1.6 which will require another rebase and a changelog update from 0.1.5 to 0.1.6 Many thanks — Reply to this email directly, view it on GitHub <#376 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BIHS6UN5UUM2EY5B4Q4DUC33YAJ5LAVCNFSM6AAAAACGK2HU2WVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTIMJTGAZDMNBSGY> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[exploreriii]

No problem take the time you need.

[tech0priyanshu]

Hi @exploreriii and @nadineloepfe,I have now implemented all the requested changes.

…

On Fri, 17 Oct 2025 at 19:22, exploreriii ***@***.***> wrote: *exploreriii* left a comment (hiero-ledger/hiero-sdk-python#376) <#376 (comment)> No problem take the time you need. — Reply to this email directly, view it on GitHub <#376 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BIHS6ULH7XMDYBHTC76N2DT3YDYALAVCNFSM6AAAAACGK2HU2WVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTIMJVG4YTAMRVGQ> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[exploreriii]

Got it, next on my review list

[exploreriii]

Hi @tech0priyanshu
Thanks for all this - it is looking robust and a lot of hard work has gone into it
However, as there is a lot more content and logic, would it be possible to split this up into more modular functions which are then called from the main?

For example:

def token_airdrop
should just literally airdrop

def token_airdrop_confirm
could do the checks etc

then in main
token_airdrop()
token_airdrop_confirm()

The reason I mention this is if users want to copy the examples and use them in their own code, they might not need all the logic - they might just want to just perform the airdrop, or just to associate, etc.

I know it will involve more work, what do you think?

[exploreriii]

@tech0priyanshu just checking if you need anything

[tech0priyanshu]

Hey @exploreriii Sorry for the delay in fixes — I had some important work that required me to travel out of town. I’ll complete the fixes and sync the update by *November 9*. Apologies for not posting earlier.

…

On Tue, 28 Oct 2025, 19:26 exploreriii, ***@***.***> wrote: *exploreriii* left a comment (hiero-ledger/hiero-sdk-python#376) <#376 (comment)> @tech0priyanshu <https://github.com/tech0priyanshu> just checking if you need anything — Reply to this email directly, view it on GitHub <#376 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BIHS6UNYMFGB2SKGEFX4WC33Z5YZRAVCNFSM6AAAAACGK2HU2WVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTINJWGYYDIOJXGM> . You are receiving this because you were mentioned.Message ID: ***@***.***>