Bridge API (mainnet)

Proxies production bridge.riddlewallet.com /v1/bridge/* with partner fee breakdown.

Widget setup (script, iframe, origin allowlist): Setup Bridge widget.

GET  /api/v1/bridge/currencies
GET  /api/v1/bridge/estimate?fromCurrency=xrp&toCurrency=eth&amount=10
POST /api/v1/bridge/prepare  # unsigned fee + deposit (any wallet)
POST /api/v1/bridge/create   # live key required — feeTxHash
GET  /api/v1/bridge/status?id=ORDER_ID

Two on-chain legs on every wallet: (1) platform fee to the suite bank, (2) deposit to the order address. Create stays gated by on-chain fee proof (feeTxHash). Partner attribution is attached via X-Riddle-Partner and body fields. Embeds show amount due (deposit + extra fee). When the fee is collected, partner share is accrued to the collection balance.