Skip to content

Global Preferences

Global preferences are the default notification settings applied to all wallets unless overridden.

Accessing Global Preferences

  1. Go to Settings → Notifications
  2. Click Global Preferences

Configuration Options

Event Toggles

Enable or disable notifications for each event type:

Event Description Recommended
transaction.deposit Incoming funds detected ✅ Enable
transaction.withdrawal Outgoing funds detected ✅ Enable
theft_shield.incident_detected Unauthorized tx detected ✅ Enable
theft_shield.sweep_broadcast Defense tx broadcast ✅ Enable
psbt.invalidated PSBTs need refresh ✅ Enable

Channel Selection

For each enabled event, select which channels receive notifications:

transaction.deposit:
  ├── ✅ Email
  ├── ✅ Nostr
  └── ❌ Webhook (only for automation)

theft_shield.incident_detected:
  ├── ✅ Email
  ├── ✅ Nostr
  └── ✅ Webhook (log all incidents)

Confirmation Thresholds

Configure when to receive confirmation notifications:

Setting When Notified
Mempool only When tx enters mempool
1 confirmation After 1 block
3 confirmations After 3 blocks
6 confirmations After 6 blocks
Custom Specify number

Amount Thresholds

Set minimum amounts to trigger notifications:

Deposit notifications:
  Minimum amount: 0.001 BTC
  (Ignore dust deposits)

Withdrawal notifications:
  Minimum amount: 0 BTC
  (Alert on any withdrawal)

High Security

For high-value wallets:

transaction.deposit:
  enabled: true
  channels: [email, nostr, webhook]
  threshold: 0  # Any amount
  confirmations: [0, 1, 6]

transaction.withdrawal:
  enabled: true
  channels: [email, nostr, webhook]
  threshold: 0  # Any amount
  confirmations: [0, 1, 6]

theft_shield.*:
  enabled: true
  channels: [email, nostr, webhook]

Balanced

For everyday use:

transaction.deposit:
  enabled: true
  channels: [email]
  threshold: 0.001 BTC
  confirmations: [0, 3]

transaction.withdrawal:
  enabled: true
  channels: [email, nostr]
  threshold: 0
  confirmations: [0]

theft_shield.*:
  enabled: true
  channels: [email, nostr]

Minimal Noise

For low-activity wallets:

transaction.deposit:
  enabled: true
  channels: [email]
  threshold: 0.01 BTC
  confirmations: [3]

transaction.withdrawal:
  enabled: true
  channels: [email]
  threshold: 0.01 BTC
  confirmations: [0]

theft_shield.*:
  enabled: true
  channels: [email, nostr]

Saving Changes

  1. Configure your preferences
  2. Click Save Preferences
  3. Changes apply immediately to all wallets without custom preferences

Testing Preferences

After configuring:

  1. Click Send Test Notifications
  2. Select event types to test
  3. Verify receipt on all enabled channels

Next: Per-Wallet Preferences →