Skip to content

Wallet Connection

Shiru lets you connect your crypto wallet to view assets, sign transactions, and authenticate securely.

Shiru supports any wallet compatible with WalletConnect, including:

  • MetaMask (browser extension or mobile)
  • WalletConnect (scan QR code from any supported mobile wallet)
  • Coinbase Wallet
  • Trust Wallet
  • Rainbow
  • And many more via WalletConnect protocol

Your wallet can connect across 4 EVM-compatible chains:

NetworkUse Case
EthereumMain network, widest token support
ArbitrumFast & low-cost Ethereum L2
BaseCoinbase’s L2 network
BNB Chain (BSC)Binance ecosystem
  1. Sign in to your Shiru account
  2. Navigate to your dashboard or click Connect Wallet
  3. The wallet connection modal appears
  4. Select your preferred wallet
  5. If using browser extension (MetaMask): Approve the connection in the popup
  6. If using mobile wallet: Scan the QR code displayed
  7. Your wallet address appears in the app — you’re connected!

When connecting or authenticating, your wallet will ask you to sign a message. This is:

  • Free — no gas fees, no transaction on the blockchain
  • Safe — you’re just proving you own the address
  • Standard — follows the EIP-4361 (SIWE) specification

Important: Shiru 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.

If you’re on the wrong network:

  1. Shiru will prompt you to switch
  2. Your wallet will show a network switch request
  3. Approve the switch — done

You can also switch networks manually in your wallet app.

  1. Go to your account settings or click your wallet address
  2. Click Disconnect Wallet
  3. Your wallet is unlinked from your Shiru account

Note: Disconnecting your wallet doesn’t affect your assets on the blockchain. It only removes the link between your wallet and your Shiru account.

ProblemSolution
Wallet modal doesn’t appearRefresh the page, check if popup blockers are active
”User rejected” errorYou declined the signature — try again and approve
Wrong wallet address showingDisconnect and reconnect with the correct account
Connection timeoutCheck your internet, try again. Some wallets need the app open
Chain mismatchSwitch to a supported network in your wallet