Wire swaps.xyz swap provider

[j0ntz]

CHANGELOG

Does this branch warrant an entry to the CHANGELOG?

• Yes
• No

Dependencies

Depends on EdgeApp/edge-exchange-plugins#480 (the swaps.xyz plugin). This PR is open for review now: it compiles and passes CI standalone. It should only MERGE after #480 merges, edge-exchange-plugins publishes a version containing the swapsxyz plugin, and this branch bumps edge-exchange-plugins to it. Without that bump the registration resolves to no plugin at runtime.

Requirements

No visual changes (env/config wiring only).

Description

Wire the new swaps.xyz swap provider so the app initializes it:

• src/envConfig.ts — add SWAPSXYZ_INIT core plugin init (apiKey).
• src/util/corePlugins.ts — register swapsxyz: ENV.SWAPSXYZ_INIT in the Centralized Swaps block of swapPlugins.
• src/actions/CategoriesActions.ts — pluginIdIcons entry so swap transactions carry the provider icon.
• src/constants/MerchantContacts.ts — MERCHANT_CONTACTS entry keyed on the plugin's swapInfo.displayName (swaps.xyz) for the transaction-list thumbnail.
• AGENTS.md (separate commit) — a Swap Provider Integration section listing every wiring point a new swap pluginId needs, since each one fails silently when missed.

No SwapVerifyTermsModal entry. swapsxyz is centralized (isDex: false, see EdgeApp/edge-exchange-plugins#480), but that modal is for providers whose gate is a terms acceptance the user completes in-app; swaps.xyz screens pre-quote and simply refuses a route it will not serve, so there is nothing to accept. The icon asset still needs uploading to content.edge.app at /exchangeIcons/swapsxyz/icon.png.

The runtime key is supplied via env.json SWAPSXYZ_INIT.apiKey. With a published edge-exchange-plugins containing the plugin, the app then offers swaps.xyz quotes.

Verified in-app on the iOS sim (with the plugin linked via updot and the key in env.json): a real Base ETH → USDC swap executed through swaps.xyz to the success scene. Evidence is attached to the plugin PR EdgeApp/edge-exchange-plugins#480.

Asana: https://app.asana.com/0/1215088146871429/1217036054017879

---

Note

Low Risk
Standard env and registration wiring with no auth or payment logic changes; swap behavior depends on the external plugin package version.

Overview
Registers the swaps.xyz centralized swap provider (swapsxyz) using the same wiring pattern as providers like Swapuz and n.exchange.

Runtime init: SWAPSXYZ_INIT in envConfig (optional apiKey from env.json) and swapsxyz: ENV.SWAPSXYZ_INIT in swapPlugins so the core can load the plugin from edge-exchange-plugins.

UI: Swap provider icon in pluginIdIcons and a MERCHANT_CONTACTS row with displayName swaps.xyz so transaction history shows the correct thumbnail.

Docs: AGENTS.md now documents the full swap-provider checklist (env, corePlugins, icons, merchant contacts, terms modal when needed).

Quotes only appear after edge-exchange-plugins is bumped to a release that includes the swapsxyz plugin; this PR does not bump that dependency.

^{Reviewed by Cursor Bugbot for commit a737b38. Bugbot is set up for automated code reviews on this repo. Configure here.}

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[peachbits]

Missing CategoriesActions and MerchantContacts entries. May also be missing the SwapVerifyTerms entry, if applicable

[j0ntz]

Added both missing entries in a fixup on Wire swaps.xyz swap provider:

• src/actions/CategoriesActions.ts pluginIdIcons: swapsxyz → /exchangeIcons/swapsxyz/icon.png
• src/constants/MerchantContacts.ts: { displayName: 'swaps.xyz' }, matching the plugin's swapInfo.displayName, same icon path

No SwapVerifyTermsModal entry: swapsxyz is isDex: true, and that modal's pluginData covers centralized providers with terms/KYC to accept (changenow, changelly, exolix, sideshift, swapuz, xgram). No DEX plugin (lifi, rango, thorchain, unizen, 0xgasless) has one.

The icon itself still 403s on content.edge.app for both /exchangeIcons/swapsxyz/icon.png and /swapsxyz.png, so the asset needs uploading to the content server separately.

Also added a ## Swap Provider Integration section to AGENTS.md as its own commit, listing every wiring point a new swap pluginId needs and noting that each fails silently when missed.

[j0ntz]

📸 Test evidence (after review fixes): swap executed with the swapsxyz wiring, tx row rendered

swap success

tx list row

Captured by the agent's in-app test run (build-and-test).