Developers

Docs

Public integration notes. Hosts come from the hub catalog. Guide model grok-4.6. SSO cookie rdl_sess. 100 credits = $1. Send fee 0. Machine copy: /llms.txt and /docs.md.

Getting started

Create or import a self-custodial wallet, connect the suite once, then open any Riddle app without a second seed.

Suite map

Canonical production hosts from the hub catalog — one SSO cookie across *.riddlewallet.com.

Suite SSO

Deep links

Connect, credits, plans, app hosts, and hub feature URLs — always production catalog hosts.

Payloads & units

Build amounts in drops, lamports, or wei. Never float × 1e6. Warn, then re-auth after idle.

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.

Ads

Fetch live creatives with GET {ADS_BASE}/api/ads/active?slot= — auctions settle in XRP on Dev.

Xaman

Xaman (Xumm) SignIn is a separate identity system from suite SSO. Do not mix session keys.

Brand

Solid colors only — no gradients. Sticky 44px header, solid footer, Inter, suite tokens.

Adding an app

Checklist: ecosystem.ts, HUB_LINKS, hub catalog APPS, pills, live screenshots.

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.

OpenAPI

Public hub + ads + guide contracts: health, ads/active, POST /api/ai/guide, SSO query params.