📱Wallet Setup

Setting up your wallet is the first step to using DreamLend. This guide will walk you through connecting and configuring your wallet for the Somnia L1 network.

🎯 Supported Wallets

DreamLend supports all Somnia L1 compatible wallets:

🦊 MetaMask (Recommended)

  • Best For: Beginners and general use

  • Features: Easy setup, browser extension, mobile app

  • Download: metamask.io

🔗 WalletConnect

  • Best For: Mobile users and hardware wallets

  • Features: QR code connection, multiple wallet support

  • Compatible Wallets: Trust Wallet, Rainbow, Coinbase Wallet, and 200+ others

🏦 Coinbase Wallet

  • Best For: Coinbase users

  • Features: Direct integration with Coinbase exchange

  • Download: wallet.coinbase.com

🛡️ Hardware Wallets

  • Ledger: Via MetaMask or WalletConnect

  • Trezor: Via MetaMask or WalletConnect

  • Best For: Maximum security for large amounts

🦊 MetaMask Setup (Recommended)

Step 1: Install MetaMask

  1. Visit metamask.io

  2. Click "Download" for your browser

  3. Install the browser extension

  4. Create a new wallet or import existing one

  5. IMPORTANT: Securely backup your seed phrase

Step 2: Add Somnia L1 Network

Automatic Setup (Recommended)

  1. Visit dreamlend.finance

  2. Click "Connect Wallet"

  3. Select "MetaMask"

  4. When prompted, click "Add Network" or "Switch Network"

  5. Confirm the network addition in MetaMask

Manual Setup

If automatic setup doesn't work:

  1. Open MetaMask

  2. Click the network dropdown (usually shows "Ethereum Mainnet")

  3. Click "Add Network" → "Add a network manually"

  4. Enter the following details:

Network Name: Somnia L1 Testnet
New RPC URL: https://dream-rpc.somnia.network
Chain ID: 50312
Currency Symbol: SOM
Block Explorer URL: https://shannon-explorer.somnia.network/txs

  1. Click "Save"

  2. Switch to the Somnia L1 network

Step 3: Get Test SOM Tokens

You'll need SOM tokens for transaction fees:

  1. Visit the Somnia Faucet (if available)

  2. Enter your wallet address

  3. Request test SOM tokens

  4. Wait for tokens to arrive (usually instant)

Alternative: Ask in the DreamLend Discord for test tokens

📱 Mobile Wallet Setup

MetaMask Mobile

  1. Download MetaMask from App Store/Google Play

  2. Create or import your wallet

  3. Add Somnia L1 network (same details as above)

  4. Connect to DreamLend mobile interface

Trust Wallet

  1. Download Trust Wallet

  2. Create or import wallet

  3. Go to Settings → Networks → Add Custom Network

  4. Enter Somnia L1 details

  5. Use WalletConnect to connect to DreamLend

Coinbase Wallet

  1. Download Coinbase Wallet

  2. Set up your wallet

  3. Add custom network with Somnia L1 details

  4. Connect via WalletConnect

🔗 Connecting to DreamLend

First-Time Connection

  1. Visit dreamlend.finance

  2. Click "Connect Wallet" in the top right

  3. Choose your wallet type:

    • MetaMask: Direct connection

    • WalletConnect: QR code or deep link

    • Coinbase Wallet: Direct connection

  4. Approve the connection request

  5. Switch to Somnia L1 if prompted

Connection Troubleshooting

Wallet Not Detected

  • Refresh the page and try again

  • Disable other wallet extensions temporarily

  • Try incognito/private browsing mode

  • Update your wallet to the latest version

Network Issues

  • Check RPC URL: Ensure https://dream-rpc.somnia.network is correct

  • Verify Chain ID: Must be 50312

  • Clear cache: Clear browser cache and cookies

  • Try different RPC: Ask in Discord for alternative RPCs

Connection Fails

  • Approve in wallet: Check for pending approval requests

  • Unlock wallet: Ensure wallet is unlocked

  • Check network: Make sure you're on Somnia L1

  • Restart browser: Close and reopen browser

💰 Getting Test Tokens

Quick Mint on DreamLend

The easiest way to get test tokens:

  1. Connect your wallet to DreamLend

  2. Navigate to "Create" page

  3. Scroll to "Quick Mint Tokens" section

  4. Select tokens you want to mint:

    • MUSDT: Mock Tether (6 decimals)

    • MUSDC: Mock USD Coin (6 decimals)

    • MWBTC: Mock Wrapped Bitcoin (8 decimals)

    • MARB: Mock Arbitrum (18 decimals)

    • MSOL: Mock Solana (9 decimals)

  5. Click "Mint" for each token

  6. Confirm transactions in your wallet

Token Amounts

Each mint gives you:

  • MUSDT/MUSDC: 10,000 tokens

  • MWBTC: 1 token

  • MARB: 1,000 tokens

  • MSOL: 100 tokens

Alternative Sources

  • Somnia Faucet: Official testnet faucet (if available)

  • Discord Community: Ask for tokens in #faucet channel

  • Developer Tools: Use contract interaction tools

🔐 Security Best Practices

Seed Phrase Security

  • Write it down: Never store digitally

  • Multiple copies: Keep in different secure locations

  • Never share: DreamLend will never ask for your seed phrase

  • Test recovery: Verify you can restore your wallet

Transaction Safety

  • Verify addresses: Always double-check contract addresses

  • Check amounts: Confirm transaction amounts before signing

  • Gas limits: Use recommended gas limits

  • Phishing protection: Only use official DreamLend URLs

Wallet Hygiene

  • Regular updates: Keep wallet software updated

  • Secure browser: Use updated, secure browsers

  • Extension management: Only install trusted extensions

  • Lock wallet: Always lock when not in use

🛠️ Advanced Configuration

Custom RPC Endpoints

If the default RPC is slow, try alternatives:

Primary: https://dream-rpc.somnia.network
Backup: [Ask in Discord for alternatives]

Gas Configuration

Recommended gas settings for Somnia L1:

  • Gas Price: 1 gwei (very low fees)

  • Gas Limit: Use wallet estimates (usually accurate)

  • Priority Fee: Not required on Somnia L1

Multiple Accounts

Managing multiple accounts:

  1. Create additional accounts in MetaMask

  2. Switch between accounts using account selector

  3. Each account needs separate SOM for gas

  4. Track balances across all accounts

🔄 Switching Networks

From Ethereum to Somnia L1

  1. Open wallet network selector

  2. Choose "Somnia L1 Testnet"

  3. Confirm network switch

  4. Refresh DreamLend if needed

Network Auto-Detection

DreamLend will:

  • Detect wrong network automatically

  • Prompt to switch to Somnia L1

  • Show network status in interface

  • Block transactions on wrong networks

📞 Getting Help

Common Issues

  • "Wrong Network": Switch to Somnia L1

  • "Insufficient Funds": Get more SOM tokens

  • "Transaction Failed": Check gas and try again

  • "Wallet Not Connected": Refresh and reconnect

Support Channels

Emergency Recovery

If you lose access:

  1. Use seed phrase to restore wallet

  2. Import to new device if needed

  3. Contact support for protocol-specific help

  4. Check transaction history on explorer

✅ Verification Checklist

Before using DreamLend, ensure:

🔗 Quick Links

Your wallet is your gateway to DreamLend. Set it up securely and start your DeFi journey! 🚀

Next Step: Get Test Tokens to start lending and borrowing.

PreviousArchitectureNextNetwork Configuration

Last updated