Back to Wave Wiki

Setup Wave Hi

From Wave Wiki — the open reference for the Wave OS ecosystem.

1. Overview

This guide walks you through setting up Wave Hi — from your first login to claiming your @handle and linking a Theta wallet. Wave Hi is the decentralized messaging and social platform for the Wave OS ecosystem, accessible at wave-hi.base44.app or embedded in Wave OS at app.oswave.io.

2. Login

Wave Hi supports three login methods. Option A, Google Login: go to wave-hi.base44.app, click "Continue with Google", select your Google account — you're logged in and your Google email becomes your Wave OS email. Option B, MetaMask Wallet Login: go to wave-hi.base44.app, click "Continue with MetaMask", approve the connection prompt from your MetaMask/Theta Wallet extension — your wallet address becomes your identity anchor and no password is needed, your wallet IS your login. Option C, Email & Password: go to wave-hi.base44.app, enter your email address, click "Continue with email", check your inbox for a confirmation email, click the link to verify and set your password, then log in with your email and password. After login, your session is created, and your Wave OS email is used as the bridge to sync your @handle between Wave OS and Wave Hi.

3. Claim Your @Handle

Your @handle is your public identity across Wave OS and Wave Hi. After logging in, go to Settings — if you don't have a handle yet, you'll see a "Claim your @handle" button. Enter your desired handle (e.g., @eddie) and click "Claim Handle". The system checks if the handle is available; if available, your handle is registered and linked to your Wave OS email, and if taken, try a different handle. Rules: handles are first-come, first-served; once claimed, your handle syncs to Wave Hi automatically; the same @handle shows in Wave OS (profile badge) and Wave Hi (Channels, Feed, Settings); and your handle is linked to your Wave OS email — change emails and you keep your handle.

4. Link Your Theta Wallet

Each @handle can be linked to one Theta wallet address, enabling TFUEL transactions, Beam file transfers, and decentralized features. First-time wallet linking: when you register your @handle, you can provide a wallet address — if you logged in with MetaMask, your wallet is auto-filled; if you used email/Google login, you can enter a wallet address manually or skip (default: 0x0). Updating your linked wallet: your wallet can be changed at any time from Wave Hi Settings using cryptographic signature verification. Step 1, initiate the update: go to Settings in Wave Hi, click "Update Wallet" — if you have the MetaMask/Theta Wallet extension it connects automatically, or you can enter a wallet address manually. Step 2, receive the challenge: the app calls the updateWallet function without a signature, and the backend returns a challenge message such as "I am linking wallet 0x... to my Wave Hi handle @eddie", unique to your handle and new wallet address. Step 3, sign the challenge: if MetaMask is available you'll be prompted to sign the challenge in one click, the signature is created with your new wallet's private key, and no private keys are ever exposed or transmitted. Step 4, verify and update: the app sends the signature back to the backend, the backend verifies it using ethers.js, the signature must match the new wallet address or the update is rejected, and if verified the wallet is updated on your profile. Security: no one can link a wallet they don't control; the signature proves ownership without exposing private keys; a wallet already linked to another @handle cannot be linked to yours; and only the profile owner (verified via Wave OS email) can initiate a wallet update. Manual wallet entry (no MetaMask): if you don't have MetaMask or the Theta Wallet extension installed, you can enter a wallet address manually for initial linking, however wallet updates require signature verification — install MetaMask or the Theta Wallet extension to use the update flow, downloadable at metamask.io.

5. Verify Your Setup

After completing the steps above, verify everything is working. Check your handle: your @handle should appear in the Wave Hi header and Settings. Check your wallet: your wallet address should show in Settings (truncated: 0x1234...abcd). Test messaging: open a Channel and send a message. Check Wave OS sync: log into Wave OS at app.oswave.io — your @handle should appear in your profile.

6. Troubleshooting

Common issues and fixes: handle already taken — try a variation or check if you already registered it with a different email; MetaMask not connecting — refresh the page, check your extension is enabled, try unlocking MetaMask first; wallet update rejected — ensure you're signing with the NEW wallet, not your old one; handle not syncing to Wave OS — make sure you're using the same email on both platforms; "Install MetaMask" message — you need a Web3 wallet extension to verify wallet updates, install MetaMask or Theta Wallet.

7. Published by

Published by xBuildy. Wave Hi app: wave-hi.base44.app. Wave OS: app.oswave.io. Created: August 2026. Version: 1.0.