Stellar end-to-end integration tutorial

[truthixify]

Labels: Stellar Wave, stellar, docs, drips, help-wanted
Tier: M (2–4 days)
Type: writing

Context

A developer landing on the docs today has to stitch together Getting Started, the Stellar chain page, the Spectre cookbook, and the contract reference to send a single stealth payment on Stellar. We need one tutorial page that takes a developer from "I have nothing" to "I just sent a stealth payment on Stellar testnet" in 30 minutes, end-to-end.

Scope

Write docs/guides/stellar-quickstart.mdx:

1. Prerequisites — Node 22+, pnpm, Freighter wallet, testnet XLM (link to friendbot).
2. Install the SDK — pnpm add @wraith-protocol/sdk @stellar/stellar-sdk @stellar/freighter-api.
3. Connect & derive keys — connect Freighter, sign the STEALTH_SIGNING_MESSAGE, derive stealth keys, render the meta-address.
4. Register a .wraith name (optional but recommended for the tutorial flow).
5. Send a payment — to either a meta-address or .wraith name; build the tx, sign with Freighter, submit, log the tx hash.
6. Scan for payments — show how to use a separate test wallet to receive, derive keys, scan announcements, and find the payment.
7. Withdraw — derive the stealth private key, build a withdrawal tx, sign with the derived key (not Freighter, this is the trick), submit.
8. Where to go next — link out to: agent client, multichain expansion, mainnet considerations.

Constraints

• Every code block must be runnable as-is. Use a recording / RPC fixture if needed for determinism.
• Show the expected output alongside each step, not just the code.
• One page, not many. Use Mintlify expandables to collapse less-essential detail.
• Include a "common errors" inline expandable: "If you see X, it's because Y. Fix: Z."

Out of scope

• Anything multichain. Stellar only.
• Spectre-driven flow (covered by #08).

Acceptance criteria

• stellar-quickstart.mdx committed with the full eight-section flow.
• Added to docs.json nav under Guides.
• A reviewer who has never touched Wraith follows it end-to-end and reports any friction. (Recruit a reviewer from the Drips contributor pool.)
• All code snippets pass the snippet-correctness audit (#07) if landed.

Why this matters

The number-one drop-off in dev-tool adoption is the gap between landing page and first successful payload. This page closes that gap for Stellar.

Files

• New: docs/guides/stellar-quickstart.mdx
• Reference style: docs/getting-started.mdx
• Source-of-truth for code: sdk/src/chains/stellar/*, demo/src/components/Stellar*.tsx

[Euvouserdoutor]

I can work on this and provide a concise PR with test/validation context. For direct contact, my email is jeffqueiroz321@gmail.com