docs: add stellar cryptography architecture page#62
Merged
truthixify merged 4 commits intoJun 27, 2026
Conversation
|
@emarkees 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
Author
|
@truthixify Kindly review branch |
Contributor
|
Architecture page content + docs.json + federation cross-link look good. The 2170-line rm package-lock.json
git add package-lock.json
git commit --amend --no-edit
git push --force-with-lease |
7222565 to
305fe9e
Compare
Contributor
Author
|
@truthixify Issue ahs been fixed but there is a compiled error |
305fe9e to
a83b59b
Compare
Contributor
|
Lockfile gone, rebased cleanly. 98-line Stellar cryptography architecture page + federation cross-link + snippet-check script tweak. Thanks @emarkees. |
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
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.
Closes #22
Description
This PR introduces the Stellar Cryptography Architecture documentation page (
docs/architecture/stellar-cryptography.mdx). It serves to bridge the gap between the@wraith-protocol/sdkcode and the cryptographic rationale behind it, allowing auditors and contributors to fully understand the protocol's stealth payment mechanisms on Stellar without having to reverse-engineer the source.Changes Included
stellar-cryptography.mdxwhich maps high-level cryptographic concepts directly to their specificsdk/chains/stellar/*implementations.docs.jsonunder the Architecture navigation group.Cryptographic Concepts Covered
ed25519oversecp256k1for Stellar network compatibility.X25519shared secrets, referencing RFC 7748.wraith:prefixes (spending:,viewing:,scalar:,tag:) and their exact collision-prevention boundaries.signWithScalarimplementation for deriving signatures from a raw stealth scalar instead of a standard 32-byte seed while upholding RFC 8032.st:xlm:encoding prefix, payload concatenation, and Stellar'sStrKeyencoding.Visual Documentation
Includes two Mermaid SVG diagrams for at-a-glance comprehension: