Skip to content

Notifications

Vigil's notification system keeps you informed about wallet activity through multiple channels.

Overview

When Vigil detects activity involving your monitored wallets, notifications are sent through your configured channels based on your preferences.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Wallet Event   │────▶│  Notification   │────▶│  Your Channels  │
│  (deposit, etc) │     │  Preferences    │     │  (Email, Nostr) │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Notification Channels

Vigil supports three notification channels:

Channel Best For Privacy Level
Email Traditional, reliable Moderate
Webhook Programmatic integration High
Nostr Decentralized, encrypted Maximum

Learn about channels →

Notification Preferences

Control which events trigger notifications:

  • Global Preferences - Default settings for all wallets
  • Per-Wallet Preferences - Override globals for specific wallets

Learn about preferences →

Notification Events

Notifications can be triggered by different event types:

Event Description
transaction.deposit Incoming transaction detected
transaction.withdrawal Outgoing transaction detected
theft_shield.incident_detected Theft Shield detected unauthorized activity
theft_shield.sweep_broadcast Theft Shield broadcast a defense transaction
psbt.invalidated PSBTs need regeneration

Confirmation thresholds (for example, notifying at 1 or 6 confirmations) are configured in your notification preferences.

Full event list →

Quick Setup

1. Add a Channel

Go to Settings → Notifications → Add Channel

Choose your preferred channel type and configure it.

2. Configure Preferences

Go to Settings → Notifications → Preferences

Enable the events you want to be notified about.

3. Test Notifications

Send a test notification to verify your setup works.

Notification Flow

1. Event occurs (e.g., deposit detected)
         │
         ▼
2. Check global preferences
   └── Is this event type enabled?
         │
         ▼
3. Check wallet preferences (if any)
   └── Does wallet have overrides?
         │
         ▼
4. Determine target channels
   └── Which channels should receive this?
         │
         ▼
5. Send notifications
   └── Email, Webhook, and/or Nostr

Multi-Channel Strategy

For critical wallets, use multiple channels:

High-Value Cold Storage:
├── Email (primary)
├── Nostr DM (backup)
└── Webhook (logging)

This ensures you receive alerts even if one channel fails.

Confirmation Tracking

Configure when to receive confirmation notifications:

Setting Use Case
0-conf (mempool) Immediate awareness
1 confirmation Quick verification
3 confirmations Standard security
6 confirmations High-value transactions

In This Section

Next: Notification Channels →