Stellar React hooks reference (when sdk-react ships)

[truthixify]

Tier: M (2-4 days) Type: writing

Context

SDK wave is shipping @wraith-protocol/sdk-react. Each hook needs a reference page showing signature, parameters, return type, examples, gotchas.

Scope

Write docs/reference/stellar-react-hooks.mdx:

• Hook-per-section: useStellarStealthKeys, useStellarAnnouncementScan, useStellarSendStealthPayment, useStellarName, useStellarBalance
• Each: signature, parameters, return type, side effects, example with running JSX, common pitfalls
• React Strict Mode behavior notes
• Mobile (React Native) caveats
• Linked from SDK Stellar page

Acceptance criteria

• Page committed (gated on sdk-react shipping)
• One full app example using all hooks
• Strict Mode notes accurate
• Linked from SDK + getting-started

Files to start with

• New: docs/reference/stellar-react-hooks.mdx

[baedboibidex-cmyk]

@baedboibidex-cmyk has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would love to handle this issue and author the definitive reference guide for @wraith-protocol/sdk-react. Writing clear, comprehensive documentation with production-grade examples is critical to driving smooth developer onboarding and successful SDK adoption. I have deep experience building with React/TypeScript and working with Stellar SDK wrappers, and I understand the friction points developers face when integrating web3 hooks.

To deliver an exceptional reference guide, I will structure docs/reference/stellar-react-hooks.mdx to include:

1. Granular Hook breakdowns: For each target hook (useStellarStealthKeys, useStellarAnnouncementScan, useStellarSendStealthPayment, useStellarName, and useStellarBalance), I will document:
   • Type-safe TypeScript signatures, parameter schemas, and explicit return shapes.
   • Comprehensive, copy-pasteable functional JSX examples demonstrating stateful integrations.
   • Known gotchas and side effects (e.g., loading state transitions, memoization needs).
2. Advanced Architectural Caveats:
   • React Strict Mode Behavior: Documenting how double-effect invocations affect asynchronous operations (such as initial network handshake cycles or cryptographic generation routines).
   • Mobile (React Native) Notes: Outlining necessary shims for cryptography primitives, polyfills, or performance constraints native to mobile environments.
3. End-to-End Orchestration Example: Building a complete, unified application component that seamlessly links all 5 hooks into a single cohesive wallet/stealth-payment sequence.
4. Clean Linking: Updating both the SDK overview and the getting-started guide to establish an intuitive navigation path for developers.

I am ready to deliver high-quality, production-ready documentation for the Wraith Protocol community!

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

[truthixify]

@baedboibidex-cmyk Assigned. Welcome to wave 6.

Quick expectations to make this smooth for both sides:

1. Branch from develop (not main). PRs target develop.
2. Open a draft PR within ~3 days of pickup so we can see direction early.
3. Update at least every 5 days. Silence is the only thing that costs you the assignment; if you get stuck or context changes, just say so on the PR.
4. Read the issue body's acceptance criteria carefully. Hitting those is the merge bar.

If anything is ambiguous, ask before building.

[adamualihantsu]

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

Hey maintainer, kindly assgn me to work on this issue

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

[drips-wave]

@truthixify baedboibidex-cmyk could not be assigned to this issue because they have reached the maximum of 4 accepted assignments per organization in the current wave of the Stellar Wave Program.

The assignee has been removed. Please choose a different contributor.

[agnesnaomiolim-cloud]

@agnesnaomiolim-cloud has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would like to work on this.

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

[boalambo]

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

Hello maintainer, I would like to work on this issue

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

[DevScoopee]

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

Hi, i fully understand what is to be done and can deliver. Kindly assign

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