[Docs] Add Inline Code Examples to SDK README

[p3ris0n]

Reward: 200 Points (Stellar Wave 5)

Description
Improve onboarding for SDK users.

Acceptance Criteria
Add copy-pasteable examples for all core client methods in sdk/README.md.

[newmattock]

Hi @Jagadeeshftw, I’d like to take this on for Stellar Wave 5. Please assign @newmattock if this plan fits the issue.

I checked the current SDK surface and sdk/README.md. I would keep the PR docs-only and focused on copy-pasteable examples for the core client methods:

• add a setup section with shared client/keypair/address placeholders and the token amount convention for 7-decimal assets
• add examples for initialize, read methods (getBalance, getBalances, getTotalSupply, getName, getSymbol, getDecimals, getAllowance, getVersion), and write methods (mint, batchMint, transfer, approve, transferFrom, burn, transferOwnership, pause, unpause)
• include mock-client usage for frontend/unit-test workflows so users can try the same SDK flow without Soroban RPC access
• add examples for exported helpers/events where they are part of the public SDK surface, without inventing behavior beyond the current code
• run the SDK checks that are feasible for a docs-only PR and include the exact output in the PR body

I can make this reviewable as a single sdk/README.md improvement and keep the examples aligned with the current TypeScript signatures.

[JinadJay]

@JinadJay has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

I’m highly motivated to tackle this issue because your project is pushing the boundaries of what is possible in this space, and I want to contribute directly to building impactful, sustainable infrastructure.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @JinadJay to this issue.

[drips-wave]

Congratulations, @JinadJay! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 2026.

🧑‍💻 @JinadJay: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @JinadJay as part of the Stellar Wave Program's 5th Wave 🥳

😎 @JinadJay: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.