Bring Your Own Wallet

BYOW lets you sign in to Aura with an external wallet instead of the embedded wallet. Your external wallet becomes your trading identity. You fund it however you normally fund a wallet — exchange withdrawal, an existing balance, or via Hyperunit after login.

Available on both web and mobile. See Embedded vs External Wallet for the custody and fee differences.

How it works on web

1. On the sign-in screen, pick Connect wallet or use another app.
2. Privy's wallet modal opens with supported browser extensions (MetaMask, Rabby, Coinbase Wallet) and a WalletConnect QR fallback for any wallet that isn't installed as an extension.
3. Approve the connection in your wallet.
4. Your wallet prompts you to sign a short message — this is an off-chain signature, not a transaction, so it costs nothing.
5. You're signed in. The browser returns you to where you were before the dialog opened.

Privy handles the signing internally on web — you won't see a separate SIWE step.

How it works on mobile

1. On the sign-in screen, tap Bring your wallet.
2. The wallet picker opens (powered by Reown AppKit over WalletConnect v2). Pick your wallet.
3. Your wallet app opens via deep link. Approve the connection.
4. Aura generates a Sign-In with Ethereum (SIWE) message. Your wallet prompts you to sign it — off-chain, no cost.
5. You're signed back into Aura, returned to the route you were on before sign-in.

On either platform your external wallet is only prompted for one-time setup signatures (login, agent key approval, builder fee if applicable). Day-to-day trading uses the agent key — your external wallet is never asked to sign individual orders.

Funding after sign-in

BYOW is an authentication method, not a deposit method. After you're signed in with your external wallet:

• If you already hold assets in that wallet — bridge them to Hyperliquid via Hyperunit or use Hyperliquid's own bridge UI.
• If the wallet is empty — fund it via an exchange withdrawal, another wallet transfer, or a card onramp inside your wallet app. Then bridge.

See Deposit Not Detected if funds don't appear after bridging.

Common errors

"Wallet connect failed. Please try again." (web)

Privy couldn't complete the wallet handshake. Usually one of:

1. Popup/modal blocked. Some browsers or extensions silently block Privy's connect modal. Allow popups for the site and retry.
2. No wallet extension detected. If you don't have MetaMask, Rabby, or Coinbase Wallet installed, use the WalletConnect QR in the modal and scan from your phone wallet.
3. Wallet locked. Unlock your wallet extension first, then retry.

"Signature declined"

You hit reject in your wallet. Tap retry and approve the signature prompt. If you meant to reject, pick a different sign-in method.

"Wallet address mismatch" (mobile, signer mismatch)

The wallet address that signed the SIWE message didn't match the address Aura requested. The usual cause: you switched accounts in your wallet app between connect and sign.

Fix:

1. Tap retry.
2. Confirm which account is active in your wallet app before signing.
3. Don't switch accounts mid-flow.

After 3 mismatches in a row, Aura escalates to "Contact support" and stops offering retry. Contact support with the wallet and the intended address.

"WalletConnect unavailable" (mobile)

The wallet connection layer failed to initialize. Usually caused by an app update that didn't install cleanly:

1. Fully quit Aura and reopen.
2. If still broken, reinstall Aura.
3. Make sure your wallet app is also updated.

Wallet picker opens but my wallet isn't listed

• Web: Privy shows installed browser extensions first. Use the WalletConnect QR option for wallets not installed as extensions, or anything on your phone.
• Mobile: Reown's registry covers hundreds of wallets. Scroll the full list. If your wallet doesn't support WalletConnect v2, BYOW won't work with it.

Mobile: signed but nothing happened

Deep-link callback didn't fire — your wallet app signed but the return link to Aura failed. Fix:

1. Foreground Aura manually (swipe back from the wallet app).
2. If Aura is stuck on "Verifying…", the callback will still complete once server-side SIWE verification finishes.
3. If stuck more than 30 seconds, back out and start again.

Web: browser on a phone

Privy's web modal works on mobile browsers, but the experience is rough compared to the native mobile app's BYOW flow. If you're on a phone, prefer the mobile app.

Privy domain / "Privy error"

The domain in the SIWE message didn't match Privy's allowed domains. This is a server-side misconfiguration, not something you can fix as a user. Contact support noting which build (prod / QA / dev) you're on.

What BYOW costs

• 0.1bp Aura builder fee on mainnet Hyperliquid perps (embedded wallets are zero until $1B lifetime volume).
• Gas is sponsored. You don't need HYPE or MATIC in your external wallet for Aura actions.

See Fees & Costs for full details.

Can I switch from embedded to BYOW later?

Not as a migration — embedded and BYOW are separate Aura accounts. If you started with Google/Apple and want to move to your own wallet, you'd sign in fresh with BYOW and move any funds manually. Trading history, positions, and collateral do not move between accounts.