All Swaps Modals Refactor + CoW Protocol Adapters support #2739

mgrabina · 2025-10-29T17:49:50Z

Refactors all swaps modules for consistency, composability, and multi‑provider support.
Adds CoW Protocol adapters (including flash‑loan adapters) alongside existing ParaSwap flows.
Documents architecture, types, hooks, provider selection, and critical execution paths.

Unify UX, robustness, analytics and error handling across all swap‑related modals.
Remove duplicated and dispatch‑based code; centralize logic.
Enable easy provider extension.
Make complex flows (Debt Swap, Repay With Collateral) explicit and maintainable.

New module structure under src/components/transactions/Swap/ with a clear separation:
- modals/ (entry + content), inputs/, warnings/, details/, actions/, hooks/, helpers/, types/, constants/, analytics/.
Added CoW Protocol provider support and adapters:
- CoW market/limit orders for simple swaps.
- CoW flash‑loan adapters for protocol flows (Debt Swap, Repay With Collateral).
Provider selection logic:
- helpers/shared/provider.helpers.ts#getSwitchProvider chooses CoW when supported, else falls back to ParaSwap.
Centralized quoting and flow selection:
- hooks/useSwapQuote orchestrates quotes and normalizes results across providers.
- hooks/useFlowSelector derives HF impact and selects flash‑loan vs simple flow.
Centralized amount processing:
- hooks/useSwapOrderAmounts computes normalized sell/buy amounts, applies partner fee, slippage, and handles inversion.
Centralized gas estimation:
- hooks/useSwapGasEstimation provides consistent gas hints and toggles Gas Station.
Unified approvals:
- actions/approval/useSwapTokenApproval.ts handles ERC‑20 approvals, EIP‑2612 permits, and Aave credit delegation, including USDT reset logic.

Readme: src/components/transactions/Swap/README.md
- Diagram: src/components/transactions/Swap/docs/swap-modal-architecture.png
- Directory overview, data model, and extension steps.
Deep docblocks in:
- modals/request/BaseSwapModalContent.tsx (composition root, hook order, state ownership)
- hooks/* (quotes, flow selection, amounts, slippage, gas, reserves, native max)
- actions/* (CoW/ParaSwap, protocol flows, responsibilities, flash‑loan notes)
- helpers/shared/provider.helpers.ts (provider selection policy)
- Types: types/state.types.ts, types/params.types.ts, types/tokens.types.ts, types/quote.types.ts, types/shared.types.ts (field‑level TSDoc)

Inversion (Debt Swap, Repay With Collateral):
- UI inputs are expressed as “from” and “to”, but the economic swap behind protocol actions is reversed.
- We compute and store isInvertedSwap and processedSide so orders/quotes are correctly built:
  - Debt Swap: acquire new debt asset to repay old debt → build route/order newDebt → oldDebt.
  - Repay With Collateral: sell collateral to acquire debt asset to repay → collateral → debt asset.
Flash‑loans (CoW Adapters):
- Used when HF would drop below thresholds or flow semantics require atomicity.
- We compute flash‑loan fee, sign limit order, and post via adapter’s swap settings.

Quotes refreshed every 30s when idle; paused during actions, manual limit‑price edits, or explicit approval flows.
Slippage:
- Validated with safeSlippage derived for guards; CoW suggested slippage surfaces warnings if user input is too low.
Token selection/persistence:
- Session‑scoped persistence of selections; safe defaults; filters prevent wrapping pitfalls and native‑token issues for SCWs.

Verify simple swaps across supported networks for both providers.
Verify protocol flows:
- Debt Swap: delegation approval/permit, inverted route, adapter success path.
- Repay With Collateral: aToken approval/permit, inverted route, repayAll detection, adapter success path.
Verify edge cases:
- USDT approval reset path.
- Smart contract wallets (Safe vs non‑Safe) in CoW flows.
- Quote pause/resume and limit‑order edits.

vercel · 2025-10-29T17:49:55Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
interface	Ready	Preview	Comment	Nov 13, 2025 8:33pm

github-actions · 2025-11-13T16:09:16Z

Ipfs hash: bafybeidy5drbc7fgpoh7ehtpmr5s55tomqt4xca4aoqnksqh4n5sgbyfgq
Ipfs preview link: https://bafybeidy5drbc7fgpoh7ehtpmr5s55tomqt4xca4aoqnksqh4n5sgbyfgq.ipfs.cf-ipfs.com/

github-actions · 2025-11-13T16:09:26Z