docs: add Python quickstart for Stellar stealth payments - #143
Merged
truthixify merged 3 commits intoAug 27, 2026
Merged
Conversation
Covers the full flow for Python 3.11+ backends that want to talk to
Wraith contracts without the TypeScript SDK:
- guides/quickstarts/python.mdx (new)
- pip install stellar-sdk + cryptography only
- wraith_crypto.py inline utility: scan-key derivation via SHA-256
domain separation, X25519 ECDH, ed25519 point addition, view-tag
prefilter, sign_with_scalar (RFC 8032 compatible raw scalar signing)
- Fetch WRAITH_ANNOUNCEMENT events from Soroban RPC (getEvents + XDR decode)
- scan_announcements with view-tag prefilter (~255/256 skip rate)
- Send: createAccount activation + Soroban announcer invocation
- Spend: withdrawal tx signed with raw stealth scalar
- All Python fences marked no-check for the TS snippet gate
- Targets futurenet; notes testnet contract IDs for live testing
- sdk/overview.mdx: cross-link to Python quickstart under Next Steps
- docs.json: Quickstarts nav group added above Guides in the Guides tab
|
@Mathew2k-hash Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits. You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀 |
Contributor
|
Merged. Keeping the derivation helper inline rather than hand-waving at a package that does not exist yet was the right call @Mathew2k-hash. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a self-contained quickstart for Python 3.11+ developers who want to
interact with Wraith's Stellar contracts without the TypeScript SDK — a
frequently requested path from fintech backends and treasury tools.
guides/quickstarts/python.mdx (new)
A seven-step guide covering the full stealth payment lifecycle in Python:
required
domain separation matching the TS SDK constants), X25519 ECDH via Edwards-to-
Montgomery conversion, ed25519 point addition for stealth address generation,
the v2 view-tag prefilter (~255/256 skip rate), and RFC 8032-compatible
sign_with_scalar for spending from derived scalars
decode via stellar_sdk.xdr)
step
scalar
sdk/overview.mdx
Added a "Using Wraith from Python" section under Next Steps with a direct link
to the new guide.
docs.json
Added a Quickstarts nav group above the Guides group in the Guides tab, with
guides/quickstarts/python as its first entry.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Testing
@wraith-protocol/sdk/chains/stellar — same constant, same domain prefixes
steps that require live contracts (announcement fetch, Soroban invocation)