Skip to content

Alerts

Vigil provides two levels of alerting: basic alerts that work automatically out-of-the-box, and advanced alert rules for fine-tuning when notifications are sent.

Basic Alerts (Default)

Enabled automatically when you create a wallet:

  • Deposit alerts - Notified when funds are received
  • Withdrawal alerts - Notified when funds are spent

No setup required—you'll receive these alerts immediately through your configured notification channels.

Advanced Alert Rules (Optional)

Alert rules add conditional logic to refine when notifications are sent:

Transaction detected
         │
         ▼
Does it match alert rule conditions?
    │           │
    ▼           ▼
   Yes          No
    │           │
    ▼           ▼
 Send         Ignore
 notification

When to Use Alert Rules

Use Basic Alerts Use Advanced Rules
You want all deposit/withdrawal notifications Filter out small deposits (dust)
Default behavior is fine Only notify for large amounts
Simple monitoring Specific address monitoring
- Complex conditions (AND/OR)

Example Advanced Rules

  • High-value only: Deposits above 0.1 BTC
  • Dust filter: Ignore deposits below 0.0001 BTC
  • Specific outputs: Withdrawals to certain addresses
  • Confirmation tracking: Notify at 1, 3, and 6 confirmations

Use Cases

Scenario Rule Configuration
High-value only Deposits > 0.1 BTC
Withdrawal watch Any outgoing transaction
Dust filter Deposits > 0.0001 BTC (ignore dust)
Critical confirmations Notify at 1, 3, and 6 confirmations

Rules vs Preferences

Feature Notification Preferences Alert Rules
Scope Event type level Transaction level
Logic Enable/disable Conditional
Complexity Simple Advanced
Use Basic notifications Fine-grained control

Relationship: Alert rules work within enabled notification preferences. If deposit notifications are disabled, deposit alert rules won't trigger.

Quick Start

Out of the Box

  1. Create a wallet - Basic alerts are automatically enabled
  2. Configure notification channels - Email, Webhook, or Nostr
  3. Start receiving alerts - No additional setup needed

Fine-Tuning (Optional)

  1. Create alert rules - Add conditions to filter notifications
  2. Test - Send test transactions to verify rules work
  3. Adjust - Refine thresholds as needed

In This Section

Next: Simple Rules →