# Riddle
https://riddlewallet.com

> Self-custodial suite hub. Keys stay in Wallet (https://wallet.riddlewallet.com). Suite SSO cookie rdl_sess Domain=.riddlewallet.com. Xaman SignIn is separate.

Connect: https://wallet.riddlewallet.com?return=&app=&action=connect
postMessage: riddle-wallet:connected
Ads: GET https://dev.riddlewallet.com/api/ads/active?slot=
Guide: POST /api/ai/guide (XAI_API_KEY server-only, model grok-4.6 / GUIDE_MODEL, 503 if missing key)
Units: drops / lamports / wei — never float * 1e6
Credits: 1 cr = $0.01; 100 cr = $1; credits ≠ fee tiers
Fees: swap free 0.85% gold 0.1%; bridge 1.2%→0.5%; cafe 1.0%→0.4%; send 0
Re-auth idle: 1 hour (REAUTH_IDLE_MS). No second seed import. No secrets in this file.

## Hub
- https://riddlewallet.com/apps
- https://riddlewallet.com/features
- https://riddlewallet.com/docs
- https://riddlewallet.com/start
- https://riddlewallet.com/guide
- https://riddlewallet.com/fees
- https://riddlewallet.com/credits

## Docs
- https://riddlewallet.com/docs/getting-started — Create or import a self-custodial wallet, connect the suite once, then open any Riddle app without a second seed.
- https://riddlewallet.com/docs/suite-map — Canonical production hosts from the hub catalog — one SSO cookie across *.riddlewallet.com.
- https://riddlewallet.com/docs/sso — Login once in Wallet. Cookie rdl_sess on .riddlewallet.com follows you. No second seed import.
- https://riddlewallet.com/docs/deep-links — Connect, credits, plans, app hosts, and hub feature URLs — always production catalog hosts.
- https://riddlewallet.com/docs/payloads — Build amounts in drops, lamports, or wei. Never float × 1e6. Warn, then re-auth after idle.
- https://riddlewallet.com/docs/fees-credits — Swap 0.85%→0.1% Gold, bridge 1.2%→0.5%, cafe 1.0%→0.4%, send 0. Credits are $0.01 each — not fee tiers.
- https://riddlewallet.com/docs/ads — Fetch live creatives with GET {ADS_BASE}/api/ads/active?slot= — auctions settle in XRP on Dev.
- https://riddlewallet.com/docs/xaman — Xaman (Xumm) SignIn is a separate identity system from suite SSO. Do not mix session keys.
- https://riddlewallet.com/docs/brand — Solid colors only — no gradients. Sticky 44px header, solid footer, Inter, suite tokens.
- https://riddlewallet.com/docs/adding-an-app — Checklist: ecosystem.ts, HUB_LINKS, hub catalog APPS, pills, live screenshots.
- https://riddlewallet.com/docs/guide-bot — POST /api/ai/guide on the hub. Server-only XAI_API_KEY. Model grok-4.6 via GUIDE_MODEL. 503 if the key is missing.
- https://riddlewallet.com/docs/openapi — Public hub + ads + guide contracts: health, ads/active, POST /api/ai/guide, SSO query params.

## Apps
- https://riddlewallet.com/apps/wallet — Self-custodial multichain keys, suite credits, and Free → Gold fee tiers. One SSO for every Riddle app.
- https://riddlewallet.com/apps/swap — XRPL DEX and multi-chain trade — swap.riddlewallet.com
- https://riddlewallet.com/apps/bridge — Bridge to and from XRPL and 1,200+ markets.
- https://riddlewallet.com/apps/scanner — Tokens, NFTs, charts, and project pages.
- https://riddlewallet.com/apps/cafe — Buy Now and offers with broker settle on XRPL.
- https://riddlewallet.com/apps/creator — Token project kits and XRPL launch flows.
- https://riddlewallet.com/apps/dev — AI creatives, token/NFT kits, ad auctions — PAYG credits.
- https://riddlewallet.com/apps/social — Pay by @handle, news, and messages.
- https://riddlewallet.com/apps/pay — Send by @handle, X, or any chain address.
- https://riddlewallet.com/apps/game — Hub · Fight · Cities on suite credits.
- https://riddlewallet.com/apps/fighter — NFT arena, wagers, and tournaments on suite credits.
- https://riddlewallet.com/apps/cities — Lands, plant, buildings, and city scoring.
- https://riddlewallet.com/apps/sniper — Non-custodial XRPL AMM radar — you sign, no hot wallet.
- https://riddlewallet.com/apps/loyalty — Share and Spaces on X → monthly 10% off Wallet plans.
- https://riddlewallet.com/apps/partners — Partner integrations for the Riddle suite.
- https://riddlewallet.com/apps/account — Privacy, consent, and account center.

## Features
- https://riddlewallet.com/features/create-wallet — Generate a self-custodial vault on your device. Keys never go to the hub.
- https://riddlewallet.com/features/import-wallet — Bring an existing seed or key into the encrypted on-device keystore.
- https://riddlewallet.com/features/multi-wallet — Switch among connected wallets — type + address always visible.
- https://riddlewallet.com/features/portfolio — Balances across XRPL, EVM, Solana, and Stellar in one shell.
- https://riddlewallet.com/features/send — Send native assets. Platform send fee is 0 bps (never collected).
- https://riddlewallet.com/features/receive — Show a receive address / QR for the selected chain.
- https://riddlewallet.com/features/address-book — Named destinations so you do not paste the wrong account.
- https://riddlewallet.com/features/nfts — Gallery of NFTs you hold — open Cafe to trade.
- https://riddlewallet.com/features/walletconnect — Use Riddle as the signing wallet for dApps.
- https://riddlewallet.com/features/pin-lock — Local keystore gated by PIN. Not a server password.
- https://riddlewallet.com/features/reauth — Browse freely. Sign again after 1 hour idle (or after Lock).
- https://riddlewallet.com/features/export-backup — Reveal seed/keys only behind PIN + warning. Never on this hub.
- https://riddlewallet.com/features/swap — DEX routes with slippage, fee bps, and wrong-asset warnings.
- https://riddlewallet.com/features/bridge — Cross-chain quotes with ETA and memo when required.
- https://riddlewallet.com/features/cafe-buy-now — Brokered NFT purchase with XRP settle.
- https://riddlewallet.com/features/cafe-offers — Create or accept NFToken offers via Xaman / Wallet.
- https://riddlewallet.com/features/scanner-tokens — Token pages, charts, and discovery.
- https://riddlewallet.com/features/scanner-nfts — NFT collection pages and Cafe handoff.
- https://riddlewallet.com/features/pay-handle — Send using a Riddle handle, X, or a raw address.
- https://riddlewallet.com/features/social-riddlebook — Social + pay-by-handle on social.riddlewallet.com.
- https://riddlewallet.com/features/suite-credits — 100 credits = $1. Powers Studio, kits, ads — not a swap fee discount.
- https://riddlewallet.com/features/credit-packs — Buy packs on Wallet or Dev. Same ledger everywhere.
- https://riddlewallet.com/features/payg — When a quota is exhausted, pay per kit/pack (memo RDL1|PAYG|…).
- https://riddlewallet.com/features/tiers-free-gold — Free / Bronze $4.99 / Silver $14.99 / Gold $39.99 — lower swap, bridge, Cafe bps.
- https://riddlewallet.com/features/ad-slots — Suite inventory via GET /api/ads/active?slot= — auction in XRP.
- https://riddlewallet.com/features/dev-studio — Prompt → image on the server with the suite Grok key. Never in the browser.
- https://riddlewallet.com/features/token-kit — Name, ticker, supply, icon → JSON + Creator deep-link.
- https://riddlewallet.com/features/nft-kit — Collection, traits, art pack, Cafe checklist.
- https://riddlewallet.com/features/loyalty-x — Share / retweet / Spaces → monthly 10% off Wallet plans.
- https://riddlewallet.com/features/civilisations — Command dashboard for lands, wars, arena, NFT roles.
- https://riddlewallet.com/features/cities — Build on lands with the same ledger as Civ & Fight.
- https://riddlewallet.com/features/fighter — NFT street-fighter arena with credit wagers.
- https://riddlewallet.com/features/sniper — AMM radar. You sign. No hot wallet on the desk.
- https://riddlewallet.com/features/sso — Login once in Wallet. Cookie rdl_sess on .riddlewallet.com follows you.
- https://riddlewallet.com/features/xaman-connect — Xaman (Xumm) SignIn SSO is its own system — not Riddle Wallet suite SSO.
- https://riddlewallet.com/features/payload-warnings — Every sign path shows network, amount, destination, and irreversible copy.

Full markdown: https://riddlewallet.com/docs.md