Skip to content

docs: rewrite swaps page to reflect automatic swap behaviour#104

Open
greg-rhinestone wants to merge 3 commits intomainfrom
greg/swaps-docs-update
Open

docs: rewrite swaps page to reflect automatic swap behaviour#104
greg-rhinestone wants to merge 3 commits intomainfrom
greg/swaps-docs-update

Conversation

@greg-rhinestone
Copy link
Collaborator

What changed

Rewrote the swaps page based on how the orchestrator actually works (confirmed with Diego + Kurt).

Key changes:

  • Swaps are now framed as automatic — they happen whenever input/output token isn't a settlement token (both origin and destination sides)
  • Settlement tokens clarified: ETH, WETH, USDC, USDT, USDT0
  • Removed the old "Swaps vs injected swaps" framing which was misleading
  • Custom swap calldata section rewritten with the critical constraint: final destination token must be a settlement token
  • Dropped specific DEX aggregator names
  • Added note about settlement-only chains (Plasma, HyperEVM, Soneium)

Closes the misrepresentation identified in the swaps architecture review.

@mintlify
Copy link

mintlify bot commented Mar 23, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
rhinestone 🟢 Ready View Preview Mar 23, 2026, 10:43 AM

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.

1 participant