Product and safety / Your screens
Signature screen
Words for your screens, ready to copy, so users know what they are signing and where their coins are.
Signing screen
Say what the signature does before the wallet opens. Show the receiving address in short form next to the button, and check it before you quote with GET /addresses/validate.
| Paying with | Before the wallet opens | The wallet shows |
|---|---|---|
| ETH, BNB, AVAX | "Sign your order, then confirm one transaction. Your ETH is held by the swap contract until your BTC is sent." | A typed message, then a transaction |
| USDC | "Sign in your wallet (once or twice). No gas. Your USDC is held by the swap contract until your BTC is sent." | A permit when needed, and a transfer bound to this order |
| SOL | "Approve in your wallet. Your SOL is held by the swap program until your BTC is sent." | A readable request, then the deposit |
A wallet that declines (user_rejected) needs no message: return to the confirm screen. On wrong_chain, say "Switch your wallet to Base to continue." Write "Maxy" as one word with a capital M. Use the logo as it is.
Status wording
state | Title | Line under it |
|---|---|---|
pending | Confirming your transaction | "Waiting for your transaction to confirm on Base." |
awaiting_deposit | Send your BTC | "Send exactly 0.0005 BTC to the address below, in one payment." |
in_progress | Sending your BTC | "Your BTC is on its way." |
completed | Sent | "0.00025282 BTC is on its way to your wallet. It shows there after the first confirmation, about 10 minutes." |
refundable | Your coins can come back | "The swap did not complete. Your 0.01 ETH is safe in the swap contract. [Get it back]" |
refunded | Refunded | "0.01 ETH is back in your wallet." |
cancelled | Cancelled | "Nothing was sent." |
expired | Expired | "The order expired before it started. Nothing was sent." |
failed | Something went wrong | "Your coins are safe. Contact support with order 0xa46d…0c50." |
Show success when btcTxId is set, with the transaction link. A sell can read expired after a wrong payment: if the user paid, send them to support (Failed sells). Accessibility and every failure's words are in the integration guide PDF.