Wallet Connection

Supported Wallets

Xiru supports any wallet compatible with WalletConnect, including:

• MetaMask — browser extension or mobile app
• WalletConnect — scan QR code from any compatible mobile wallet
• Coinbase Wallet
• Trust Wallet
• Rainbow
• And 100+ more via the WalletConnect protocol

How to Connect

1. Sign in to your Xiru account
2. Click Connect Wallet on the dashboard or navigation
3. The wallet selection modal appears
4. Choose your preferred wallet
5. Browser extension (MetaMask): Approve the connection in the popup
6. Mobile wallet: Scan the QR code displayed on screen
7. Your wallet address appears in the app — you’re connected!

Signing Messages

When connecting or authenticating, your wallet asks you to sign a message:

• Free — no gas fees, no on-chain transaction
• Safe — proves ownership without exposing your private key
• Standard — follows EIP-4361 (Sign-In with Ethereum) specification

Warning: Xiru will NEVER ask you to sign a transaction that sends funds. If you see a transaction request instead of a message signature, reject it immediately.

Switching Networks

If you’re on an unsupported network:

1. Xiru prompts you to switch
2. Your wallet shows a network switch request
3. Approve the switch — done

You can also switch networks manually in your wallet settings.

Disconnecting

1. Go to Account Settings or click your wallet address
2. Click Disconnect Wallet
3. Your wallet is unlinked

Disconnecting doesn’t affect your blockchain assets. It only removes the link between your wallet and your Xiru account.

Common Issues

Problem	Solution
Modal doesn’t appear	Refresh page, disable popup blockers
”User rejected” error	You declined the signature — try again, click Approve
Wrong address showing	Disconnect, switch account in wallet, reconnect
Connection timeout	Check internet, restart wallet app, try again
Chain mismatch	Switch to a supported network when prompted