Waiting for event…``` *** ### `signature` #### Example URLs **Simple message:** ``` http://localhost:5173/action/signature?iframe=true&message=Hello%20WalletTwo ``` **With redirect:** ``` http://localhost:5173/action/signature?iframe=true&message=Verify%20my%20identity&redirect_uri=https%3A%2F%2Fexample.com%2Fcallback ``` **Long message (UI truncates after 100 chars):** ``` http://localhost:5173/action/signature?iframe=true&message=This%20is%20a%20very%20long%20message%20that%20exceeds%20one%20hundred%20characters%20and%20will%20be%20visually%20truncated%20in%20the%20signing%20UI ``` **Missing message (no-op):** ``` http://localhost:5173/action/signature?iframe=true ``` *** #### Test scenarios | # | Scenario | How to trigger | Expected result | | - | ----------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------- | | 1 | Successful sign — postMessage | Open URL with `message`, listen on `message` | Receive `{ event: "message_signed", signature, message, user, wallet }` | | 2 | Successful sign — redirect | Add `redirect_uri` | Iframe navigates to `redirect_uri?signature=...&usr=...&wlt=...` after 3-second countdown | | 3 | Missing `message` param | Open URL without `message` | Signing UI mounts but nothing happens. No event fired | | 4 | Signature verification | Take `signature` and `message` from test 1 | `ethers.verifyMessage(message, signature)` returns the correct wallet address | | 5 | Message preview truncation | Use a message longer than 100 characters | UI shows first 100 chars followed by `...` | #### Test page ```html
Waiting for event…``` *** ### `logout` #### Example URLs **Minimal — postMessage only:** ``` http://localhost:5173/action/logout?iframe=true ``` **With redirect:** ``` http://localhost:5173/action/logout?iframe=true&redirect_uri=https%3A%2F%2Fexample.com%2Fsigned-out ``` **Hidden iframe (programmatic sign-out, no visible UI):** ```html ``` *** #### Test scenarios | # | Scenario | How to trigger | Expected result | | - | --------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------ | | 1 | Successful logout — postMessage | Open minimal URL in iframe, listen on `message` | Receive `{ event: "wallet_logout", type: "wallet_logout" }` | | 2 | Successful logout — redirect | Add `redirect_uri` | Iframe navigates to `redirect_uri` (no extra params appended) | | 3 | Logout fires even on server error | Simulate auth server being slow | Event still fires (the view uses `.finally()`) | | 4 | Post-logout navigation | After event fires, open `/wallet/dashboard` in iframe | Redirected to `/auth/login` by `LoggedMiddleware` | | 5 | No active session | Open with no logged-in user | Iframe redirects to `/auth/login` immediately (before logout logic runs) | #### Test page ```html
Status: Active session
``` *** ### `ramp` #### Example URLs **Minimal (fiat onramp, all defaults):** ``` http://localhost:5173/action/ramp?iframe=true ``` **EUR fiat purchase on Polygon (chain 137):** ``` http://localhost:5173/action/ramp?iframe=true&cur=EUR&ntwk=137&use_fiat=true ``` **Crypto-only flow with external reference:** ``` http://localhost:5173/action/ramp?iframe=true&use_fiat=false&ext_id=order_8821 ``` **Pre-fill amount and currency with redirect:** ``` http://localhost:5173/action/ramp?iframe=true&amt=50&cur=USD&ntwk=137&redirect_uri=https%3A%2F%2Fexample.com%2Framp-done ``` **With operator and payment method pre-selected:** ``` http://localhost:5173/action/ramp?iframe=true&op=my-operator&pm=credit_card&cur=EUR ``` **With additional bundled transaction:** Build this URL programmatically (the JSON value must be URL-encoded): ```js const additionalTxns = JSON.stringify([ { method: "mint", params: ["0xUserAddress", "1000000000000000000"], address: "0xYourContract", network: "137", wait_tx: true } ]); const url = new URL("http://localhost:5173/action/ramp"); url.searchParams.set("iframe", "true"); url.searchParams.set("ntwk", "137"); url.searchParams.set("cur", "EUR"); url.searchParams.set("additional_txns", additionalTxns); url.searchParams.set("redirect_uri", "https://example.com/ramp-done"); console.log(url.toString()); ``` *** #### Test scenarios | # | Scenario | How to trigger | Expected result | | - | ------------------------------ | ------------------------------------------ | ------------------------------------------------------------------------------------ | | 1 | Default fiat flow | Open minimal URL | Ramp UI loads after network resolves | | 2 | Network loading spinner | Open any URL before network state hydrates | Full-screen spinner until network is ready, then `RampProvider` mounts | | 3 | Invalid `additional_txns` JSON | Pass `additional_txns=not-valid-json` | Parse error is swallowed, ramp continues with `[]` | | 4 | Non-numeric `ntwk` | Pass `ntwk=abc` | `Number("abc")` → `NaN` → falls back to `undefined`, `RampProvider` uses its default | | 5 | External reference passthrough | Pass `ext_id=order_xyz` | `_externalId` prop is set on `RampProvider`, confirmed in network logs | | 6 | Crypto-only | Pass `use_fiat=false` | `RampProvider` mounts with `useFiat=false` | #### Test page ```htmlWaiting for events…``` *** ### Error state reference | Error state | Action(s) | Cause | | ------------------------------------ | ------------- | ------------------------------------------------------------------------- | | Iframe shows `/auth/login` | All | User is not logged in | | Iframe shows `/auth/email/verify` | All | User email not verified | | Iframe shows `/auth/wallet/register` | All | User has no wallet | | `TransactionNetworkError` | `transaction` | `network` param does not match any known chain ID | | `TransactionParameterError` | `transaction` | A transaction is missing `method`, `address`, or `params` is not an array | | No `message_signed` event fired | `signature` | `message` param was not provided | | `additional_txns` silently ignored | `ramp` | JSON in `additional_txns` was malformed | *** ### Quick URL builder (copy-paste into browser console) ```js function w2Action(action, params = {}) { const url = new URL(`http://localhost:5173/action/${action}`); url.searchParams.set("iframe", "true"); for (const [k, v] of Object.entries(params)) { if (v !== undefined && v !== null) { url.searchParams.set(k, typeof v === "object" ? JSON.stringify(v) : String(v)); } } return url.toString(); } // Examples w2Action("auth"); w2Action("auth", { redirect_uri: "https://example.com/cb" }); w2Action("signature", { message: "verify me" }); w2Action("logout"); w2Action("ramp", { cur: "EUR", ntwk: 137 }); w2Action("transaction", { network: 137, transactions: [{ method: "transfer", params: ["0xAbc", "1000"], address: "0xToken" }], redirect_uri: "https://example.com/done", auto_forward: true }); ```