docs: add Stellar payment links guide#58
Conversation
- Add guides/stellar-payment-links.mdx covering URL schema, optional HMAC-SHA256 tamper-protection signature, deep-linking into native apps, QR code generation, expiry handling, StellarPaymentLink reference implementation walkthrough, and webhook receiver patterns - Register page in docs.json under Guides > Operations - Add cross-link from sdk/chains/stellar.mdx See Also section - Add cross-link from guides/privacy-best-practices.mdx See Also section Closes wraith-protocol#37
b141e8e to
a53fe39
Compare
|
@baedboibidex-cmyk 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! 🚀 |
|
Now conflicts on git fetch origin
git rebase origin/develop
git push --force-with-leaseContent is clean; just keep both sides of the conflicts in docs.json and sdk/chains/stellar.mdx. |
Conflicts resolved. |
|
Sorry @baedboibidex-cmyk — #53 just landed which means the same docs.json cascade hits again. One more rebase: git fetch origin
git rebase origin/develop
# docs.json: keep both sides (the merge marker will be in the same section)
# privacy-best-practices.mdx: keep both your addition and the new one from #53
git push --force-with-leaseYour remaining PRs (#55, #58, #63) all need this same step. After this round they'll all merge in sequence. |
docs: Stellar payment links guide (#37)
Summary
Adds
guides/stellar-payment-links.mdx— a complete guide for generating, signing, and receiving Wraith stealth payment links on Stellar.What changed
guides/stellar-payment-links.mdxcovering:to,amount,asset,memo,exp,sigparams) with a working example URLqrcode— file output and in-memory data URL for<img>tagsStellarPaymentLink.tsxreference implementation walkthrough — QR display, countdown timer, and payment confirmation polling via the Wraith agentpayment.confirmeddocs.json— page registered under Guides → Operationssdk/chains/stellar.mdx— See Also cross-link addedguides/privacy-best-practices.mdx— See Also cross-link addedAcceptance criteria
https://pay.example.com/pay?to=alice.wraith&amount=10&asset=XLM&memo=INV-2024-001&exp=1735689600&sig=...)StellarPaymentLink.tsxcomponent, Next.js invoice page usage)StellarPaymentLink.tsxcomponent documented inline (demo directory not present in repo; component code included as excerpts per acceptance criteria)Design decisions
sigitself) to make signing deterministic regardless of URL parameter order.crypto.timingSafeEqualused in both link verification and webhook verification to prevent timing attacks.expis optional — permanent links are valid for recurring billing; short-lived links for point-of-sale.Notes
demo/src/components/StellarPaymentLink.tsxlisted in scope was not present as an existing file in the repo (nodemo/directory ondevelop). The component is documented as a complete code excerpt inside the guide, satisfying the "reference implementation code excerpts" acceptance criterion.Closes #37