Skip to content

feat: add Soroswap swap-then-stealth integration guide - #99

Merged
truthixify merged 1 commit into
wraith-protocol:developfrom
brooksdevon001-star:feat/soroswap-integration-guide
Jul 27, 2026
Merged

feat: add Soroswap swap-then-stealth integration guide#99
truthixify merged 1 commit into
wraith-protocol:developfrom
brooksdevon001-star:feat/soroswap-integration-guide

Conversation

@brooksdevon001-star

Copy link
Copy Markdown
Contributor

Adds a new integration guide for Soroswap — Stellar's primary AMM and aggregator — showing how
to combine a token swap with a Wraith stealth announcement in a single flow.

What's in the guide:

  • Concept diagram walking through the full swap-then-stealth lifecycle
  • Soroswap API client setup (typed helpers for /quote, /quote/build, /send)
  • Route quoting across Soroswap, Phoenix, and Aqua liquidity sources
  • Slippage (slippageBps) and quote freshness handling, with an explicit warning against caching
    quotes
  • Building the unsigned transaction with the recipient's stealth address in the to field — the
    key integration point
  • Signing, submitting, and announcing via the Wraith Soroban announcer contract
  • Complete end-to-end swapThenStealth() function (copy-pasteable, testnet-ready)
  • Recipient scanning with fetchAnnouncements + scanAnnouncements
  • Error handling with retry logic, protocol selection table, and a production checklist

Nav: New "Integrations" group added to the Guides sidebar with this as the first entry.

CI: All 430 checkable snippets pass pnpm run check:snippets.
closes #80

@drips-wave

drips-wave Bot commented Jul 26, 2026

Copy link
Copy Markdown

@brooksdevon001-star 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! 🚀

Learn more about application limits

@truthixify
truthixify merged commit ebfbecb into wraith-protocol:develop Jul 27, 2026
2 checks passed
@truthixify

Copy link
Copy Markdown
Contributor

Merged, thanks. Soroswap integration doc has been requested a bunch of times.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Soroswap integration guide

2 participants