Skip to content

docs(integrations): add Phoenix DEX multi-hop swap + stealth announce guide - #139

Merged
truthixify merged 1 commit into
wraith-protocol:developfrom
sanusishafii989:develop
Aug 29, 2026
Merged

docs(integrations): add Phoenix DEX multi-hop swap + stealth announce guide#139
truthixify merged 1 commit into
wraith-protocol:developfrom
sanusishafii989:develop

Conversation

@sanusishafii989

Copy link
Copy Markdown
Contributor

Summary

Closes #125

Adds the Phoenix DEX integration guide, completing the DEX documentation suite alongside Soroswap and Aquarius. The guide covers quoting multi-hop routes via the on-chain Phoenix Router, slippage/deadline parameter construction, and wrapping a swap + stealth-announce in a single fee-bumped transaction.

Changes

  • New file: guides/integrations/phoenix.mdx
    • Overview & features with a comparison callout (Phoenix vs. Soroswap: routing model, dynamic multi-hop, fee tiers, PHO incentives)
    • Multi-hop route quoting via Soroban simulateTransaction (XLM → PHO → USDC)
    • Slippage (min_amount_out) and deadline parameter construction
    • Combined atomic transaction: Phoenix swap + Wraith announce in a single tx
    • Fee-bump wrapping via TransactionBuilder.buildFeeBumpTransaction
    • Complete Futurenet end-to-end runnable example
    • Recipient scanning, error handling with retries, production checklist
  • Modified: guides/integrations/_meta.json — registered phoenix (and other existing integration pages that were missing)
  • Modified: docs.json — added guides/integrations/phoenix to the Integrations nav group; consolidated duplicate Integrations groups into one
  • Modified: guides/integrations/soroswap.mdx — added cross-link to phoenix.mdx in the "See also" section

Acceptance Checklist

  • guides/integrations/phoenix.mdx exists with all required sections
  • All 9 TypeScript code snippets pass compilation (tsc --noEmit with the same ambient prelude as CI check:snippets)
  • Runnable Futurenet end-to-end example included (XLM → USDC via Phoenix router → stealth announcement)
  • Navigation sidebar includes "Phoenix DEX" in both _meta.json and docs.json
  • Cross-linked bidirectionally with guides/integrations/soroswap.mdx
  • Fee-bumped transaction wrapping documented (TransactionBuilder.buildFeeBumpTransaction)
  • Differences vs. Soroswap callout included (routing model, multi-hop, fee tiers)

Closes #125
Screenshot (496)

@drips-wave

drips-wave Bot commented Aug 26, 2026

Copy link
Copy Markdown

@sanusishafii989 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

Copy link
Copy Markdown
Contributor

Thanks @sanusishafii989. Only docs.json conflicts here. #135 rewrote the nav and two more guides landed after it, so your Integrations entry needs re-adding on top:

git fetch origin
git rebase origin/develop

guides/integrations/phoenix.mdx itself is untouched by the conflict, and the Soroswap cross-link is a nice touch.

@truthixify

Copy link
Copy Markdown
Contributor

Rebased onto develop and force-pushed to your branch, since both conflicts were mechanical. Your commits are unchanged.

Two files collided, both just list ordering:

  • docs.json: took develop's alphabetical Integrations list and inserted guides/integrations/phoenix into it
  • guides/integrations/_meta.json: develop's copy only had two entries while yours had seven, so I took the union of both, kept fxdao from develop, and sorted it to match docs.json

Verified locally: check:nav-coverage passes (68 pages) and check:snippets passes (609 snippets).

Note your PR head is your fork's develop branch, so that branch has been rewritten. git fetch && git reset --hard origin/develop on your fork before you continue, or you will get a divergence next push.

@truthixify
truthixify merged commit 1a43cb4 into wraith-protocol:develop Aug 29, 2026
3 checks passed
@truthixify

Copy link
Copy Markdown
Contributor

Merged @sanusishafii989. The multi-hop router walkthrough and the explicit contrast against Soroswap's routing model is the part people evaluating the two will actually use. Reminder to reset your fork's develop locally, since I rewrote it.

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.

Phoenix DEX integration guide

2 participants