Skip to content

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

Open
sanusishafii989 wants to merge 1 commit into
wraith-protocol:developfrom
sanusishafii989:develop
Open

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

Conversation

@sanusishafii989

Copy link
Copy Markdown

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.

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