Skip to content

Notification Preferences

Control which events trigger notifications and how they're delivered.

Preference Hierarchy

Vigil uses a two-level preference system:

Global Preferences (defaults for all wallets)
         │
         ▼
Per-Wallet Preferences (overrides for specific wallets)

If a wallet has custom preferences, those are used. Otherwise, global preferences apply.

Preference Components

Each preference controls:

  1. Event Type - What happened (deposit, withdrawal, etc.)
  2. Enabled - Whether to notify for this event
  3. Channels - Which channels receive the notification
  4. Threshold - Minimum amount to trigger (optional)
  5. Confirmations - When to notify (mempool, confirmed, etc.)

Quick Setup

Basic Monitoring

Enable notifications for all deposits and withdrawals:

  1. Go to Settings → Notifications → Preferences
  2. Enable:
  3. ✅ transaction.deposit
  4. ✅ transaction.withdrawal
  5. Select channels: Email, Nostr, etc.
  6. Save

Security-Focused

Enable critical alerts only:

  1. Enable:
  2. ✅ transaction.withdrawal (any outgoing)
  3. ✅ theft_shield.incident_detected
  4. ✅ psbt.invalidated
  5. Set withdrawal threshold to 0 (any amount)
  6. Enable all channels for redundancy

Minimal Notifications

Reduce noise, only critical events:

  1. Enable only:
  2. ✅ theft_shield.incident_detected
  3. ✅ theft_shield.sweep_broadcast
  4. ✅ Large withdrawals (set threshold)
  5. Disable:
  6. ❌ Small deposits
  7. ❌ Confirmations (for routine transactions)

Managing Preferences

Viewing Current Preferences

  1. Go to Settings → Notifications → Preferences
  2. See list of all event types
  3. View enabled/disabled status
  4. See configured channels

Editing Preferences

  1. Find the event type
  2. Toggle enabled/disabled
  3. Select/deselect channels
  4. Set thresholds if applicable
  5. Save changes

In This Section

Next: Global Preferences →