DApp Connection


description: Connect DropFi to decentralized applications

DApp Connection

🔗 How DApp Connection Works

DropFi injects the window.xrpl object into every webpage, allowing seamless interaction with XRPL DApps without exposing your private keys.

🚀 Connecting to a DApp

Automatic Detection

When you visit an XRPL DApp:

  1. DApp detects DropFi via window.xrpl
  2. Shows "Connect Wallet" button
  3. Click to initiate connection
  4. DropFi popup appears for approval

Connection Flow

What DApps Can Access

Can Access:

  • Your public address
  • Network you're connected to
  • Request signatures (with approval)
  • Listen for account changes

Cannot Access:

  • Your private keys
  • Your password
  • Other connected sites
  • Your transaction history

DEX & Trading

  • Sologenic DEX: Trade tokens
  • XRP Toolkit: Portfolio management
  • XRPL DEX: Native decentralized exchange

DeFi Protocols

  • XRP Liquidity Hub: AMM pools
  • Lending protocols: Borrow/lend
  • Yield farms: Earn rewards

NFT Marketplaces

  • XRP.CAFE: NFT trading
  • onXRP: NFT marketplace
  • XPmarket: Buy/sell NFTs

Gaming & Metaverse

  • XRPL Games: Various games
  • Metaverse projects: Virtual worlds
  • Play-to-earn: Gaming rewards

🔒 Managing Connections

View Connected Sites

  1. Click DropFi icon
  2. Go to Settings → Connected Sites
  3. See all active connections:

Disconnecting Sites

To revoke access:

  1. Find site in Connected Sites
  2. Click "Disconnect"
  3. Site must request permission again

Connection Permissions

Each connection allows the DApp to:

  • See your current address
  • Request transaction signatures
  • Detect when you switch accounts
  • Know your current network

🛡️ Security Best Practices

Before Connecting

  1. Verify URL: Check for typos/phishing
  2. HTTPS only: Never connect on HTTP
  3. Research DApp: Check community reviews
  4. Start small: Test with small amounts

Red Flags 🚩

  • Asks for your seed phrase
  • Requests password access
  • Unusual permission requests
  • Poor grammar/spelling
  • Too-good-to-be-true offers

Safe Connection Checklist

  • URL matches official site
  • HTTPS lock icon visible
  • Site has good reputation
  • Permissions seem reasonable
  • You understand what you're connecting to

🔄 Connection States

Active Connection

  • Green dot in extension
  • DApp shows "Connected"
  • Can request transactions
  • Receives account updates

Disconnected

  • No access to wallet
  • Must reconnect to use
  • Previous permissions revoked
  • Clean slate

Network Mismatch

  • DApp on different network
  • Transactions will fail
  • Switch networks to match
  • Or disconnect

💡 Advanced Features

Multiple Accounts

DropFi supports multiple accounts:

  1. Each DApp connection is per-account
  2. Switching accounts updates DApp
  3. DApps only see current account
  4. Previous account hidden

Session Management

  • Connections persist across browser restarts
  • Clearing browser data removes connections
  • Extension uninstall revokes all
  • Password change doesn't affect connections

Developer Mode

Enable in Settings → Advanced:

  • See detailed connection logs
  • View raw transaction data
  • Debug connection issues
  • Not for regular users

🚨 Troubleshooting

DApp Can't Find Wallet

  1. Ensure DropFi is installed
  2. Refresh the DApp page
  3. Check extension isn't disabled
  4. Try in new tab

Connection Rejected

  • User cancelled connection
  • Try connecting again
  • Check for popup blockers
  • Ensure DropFi unlocked

Transactions Failing

  1. Check network matches DApp
  2. Ensure sufficient XRP balance
  3. Verify transaction details
  4. Try reconnecting

Lost Connection

  • DropFi auto-locked
  • Browser/extension updated
  • DApp session expired
  • Simply reconnect

🎯 Pro Tips

Organize Connections

  • Disconnect unused DApps
  • Name accounts by purpose
  • Regular connection audit
  • Use separate accounts for testing

Stay Safe

  • Bookmark trusted DApps
  • Never rush connections
  • Read transaction details
  • When in doubt, disconnect

Optimize Experience

  • Pin DropFi for quick access
  • Use expanded view for DeFi
  • Enable notifications
  • Keep extension updated

🔐 Security Note: DropFi never shares your private keys with DApps. All sensitive operations require your explicit approval. You're always in control!