riddleHUB
GuideConnect wallet

Docs · Getting started

Developers

Getting started

This hub is the public front door for the Riddle suite (https://riddlewallet.com). Keys stay on the device in Riddle Wallet. The hub never holds seeds.

1. Open Wallet

Go to https://wallet.riddlewallet.com. Create a vault or import an existing seed. Set a local PIN. Write the backup offline.

Hub, Guide, support, and chat never receive seeds. Anyone with the backup controls funds.

2. Connect the suite (SSO)

Other Riddle apps do not ask you to import the seed again. They open Wallet with:

https://wallet.riddlewallet.com?return=&app=&action=connect

Set return to the app URL (must be riddlewallet.com or *.riddlewallet.com), app to the product id (hub, swap, bridge, …), and action=connect.

Wallet unlocks, writes cookie rdl_sess with Domain=.riddlewallet.com, and may postMessage type riddle-wallet:connected. The opener stores the address session and returns. No second seed import.

Xaman SignIn is a different identity system. See Xaman.

3. Sign after idle

Browse freely. After 1 hour idle (REAUTH_IDLE_MS = 3600000), PIN or swipe again before send / swap / bridge. See payloads.

4. Units, fees, credits

  • Amounts are integer drops / lamports / wei — never float * 1e6.
  • Platform send fee is 0. Swap / bridge / Cafe bps follow Free → Gold. See fees & credits.
  • 1 credit = $0.01 (100 cr = $1). Credits power Studio, kits, ads, and games. They are not fee tiers.

Next

Ask Guide about thisdocs.md