Add DFX fiat ramp provider

[j0ntz]

CHANGELOG

Does this branch warrant an entry to the CHANGELOG?

• Yes
• No

Dependencies

none

Requirements

If you have made any visual changes to the GUI. Make sure you have:

• Tested on iOS device
• Tested on Android device
• Tested on small-screen device (iPod Touch)
• Tested on large-screen device (tablet)

Description

Integrate DFX (API, docs) as a new SEPA fiat buy/sell ramp (no swap), using the new src/plugins/ramps/ external-ramp pattern (same shape as bitsofgold/libertyx): no quoting API, the user is deeplinked into the DFX web widget to complete the buy/sell.

What this adds:

• src/plugins/ramps/dfx/dfxRampPlugin.ts and dfxRampTypes.ts — the DFX external ramp factory plus its init-options cleaner.
• Registers dfx in allRampPlugins.ts.
• Adds the dfx GUI plugin (baseUri: https://app.dfx.swiss, camera permission for QR scanning) and wires dfx into RAMP_PLUGIN_INITS in envConfig.ts (default undefined, i.e. off until enabled via env/info-server).

Support matrix: sepa payment type, EUR/CHF, SEPA region plus Switzerland and Liechtenstein, for Bitcoin, Ethereum, Arbitrum, Optimism, Polygon, Base, BNB Smart Chain, Solana and Monero; buy → /buy, sell → /sell.

A second commit adds testIDs to the ramp create scene's fiat/crypto dropdown buttons so UI tests can drive the selectors by id.

Testing: drove the Buy flow on the iOS simulator with region Germany / fiat EUR / Bitcoin. DFX surfaces as the "SEPA Bank Transfer" payment method ("Powered By: DFX", settlement 1-3 days), and selecting it opens the DFX web widget (app.dfx.swiss). Screenshots attached. tsc --noEmit, eslint and the jest suite pass.

Asana task

---

Note

Low Risk
New optional ramp provider behind env init config; no changes to auth, payments, or existing ramp quoting flows beyond registration and UI test hooks.

Overview
Adds DFX as a new SEPA fiat buy/sell ramp using the same external-ramp pattern as Bits of Gold and LibertyX: no in-app quoting; users are deeplinked into the DFX web widget at https://app.dfx.swiss (/buy or /sell).

Wiring includes a new dfx GUI plugin (camera permission for QR), registration in allRampPlugins.ts, and optional RAMP_PLUGIN_INITS.dfx in envConfig.ts (off until enabled via env/info-server). Support is SEPA for EUR/CHF in SEPA countries plus CH/LI, with settlement 1–3 days, for BTC, ETH, several EVM L2s, BSC, Solana, and Monero. Init options allow partnerIcon and a wallet identifier for white-label builds.

Also adds testIDs rampFiatDropdown and rampCryptoDropdown on RampCreateScene dropdown buttons for UI automation.

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

[j0ntz]

📸 Test evidence (iOS sim — DFX buy flow)

agent proof 1216018838183206 01 buy germany eur

agent proof 1216018838183206 02 dfx sepa provider listed

agent proof 1216018838183206 03 dfx webview opened

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

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit fc8ddf3. Configure here.}