Skip to content

Ledger Integration

Connect your Ledger hardware wallet to Cave for maximum security.

Why Use Ledger?

  • 🔐 Private keys never leave the device
  • 🛡️ Protected from malware and phishing
  • ✅ Physical confirmation for transactions
  • 💎 Industry-leading security

Requirements

  • Ledger Nano S, S Plus, or X
  • Latest Ledger firmware
  • Gno.land app installed on Ledger
  • Chrome/Brave browser

Setup Guide

Step 1: Prepare Ledger

  1. Connect Ledger to computer
  2. Enter PIN to unlock
  3. Open the Gno app on Ledger

Step 2: Connect to Cave

  1. Open Cave Wallet
  2. Go to Settings → Connect Hardware Wallet
  3. Select Ledger
  4. Click Connect

Step 3: Select Accounts

  1. Choose which accounts to import
  2. Name your accounts
  3. Click Import

Step 4: Done!

Your Ledger accounts now appear in Cave with a 🔐 icon.

Using Ledger

Viewing Balance

Works normally - no Ledger interaction needed.

Sending Transactions

  1. Create transaction in Cave
  2. Review details on Cave
  3. Verify on Ledger screen
  4. Press both buttons to confirm
  5. Transaction signed and sent

Always Verify

ALWAYS verify transaction details on your Ledger screen. Never blindly confirm.

Signing Messages

  1. dApp requests signature
  2. Review message in Cave
  3. Verify on Ledger
  4. Confirm on device

Troubleshooting

"Ledger Not Detected"

  1. Ensure Ledger is unlocked
  2. Open the Gno app on Ledger
  3. Try different USB port
  4. Try different cable
  5. Restart browser

"Transaction Rejected"

  • You pressed the wrong button
  • Transaction timed out
  • Try again and confirm within time limit

"App Not Installed"

  1. Open Ledger Live
  2. Go to Manager
  3. Search for "Gno"
  4. Install the app

Security Best Practices

  • ✅ Always verify on Ledger screen
  • ✅ Keep firmware updated
  • ✅ Store recovery phrase securely (separately from Ledger)
  • ❌ Never enter Ledger recovery phrase into computer
  • ❌ Never share recovery phrase

Comparison

FeatureSoftware WalletLedger
Key StorageBrowserHardware Device
Malware ProtectionLimitedStrong
Transaction SigningAutomaticManual Confirmation
CostFree~$79-149
ConvenienceHighMedium

Recommendation

Use Ledger for significant holdings. Software wallet is fine for daily small transactions.

The Gno.land Wallet