Monitoring¶
This page covers Theft Shield monitoring status and controls.
Monitoring Status¶
Status Indicators¶
| Status | Meaning | Icon |
|---|---|---|
| Active | Full protection enabled | 🛡️ Green shield |
| Paused | Temporarily disabled | ⏸️ Yellow pause |
| Needs Attention | PSBTs need regeneration | ⚠️ Orange warning |
| Inactive | Not configured | ⚪ Gray empty |
Viewing Status¶
Navigate to Wallets → [Wallet] → Theft Shield to see:
- Current monitoring status
- Last activity timestamp
- PSBT validity status
- Protected UTXO count
Active Monitoring¶
When Theft Shield is active:
- Mempool Scanning - Every transaction is checked
- UTXO Matching - Transactions spending your UTXOs are flagged
- Whitelist Check - Legitimate transactions are allowed
- Ready to Respond - PSBTs are ready for instant broadcast
What We Monitor¶
| Data Point | Frequency |
|---|---|
| Bitcoin mempool | Continuous |
| Your monitored UTXOs | Real-time |
| Transaction propagation | Per-transaction |
Pausing Protection¶
You can temporarily pause Theft Shield:
When to Pause¶
- Making large transactions to new addresses
- Testing your setup
- Maintenance periods
How to Pause¶
- Go to Theft Shield → Monitoring
- Click Pause Protection
- Select duration (1 hour, 4 hours, 24 hours, indefinite)
- Confirm
Auto-Resume¶
If you select a duration, protection automatically resumes after that time.
Manual Resume¶
- Go to Theft Shield → Monitoring
- Click Resume Protection
Vulnerability Window
While paused, your wallet is NOT protected. Keep pause duration minimal.
"Needs Attention" Status¶
This status indicates your PSBTs need regeneration.
Common Causes¶
| Cause | Solution |
|---|---|
| Transaction sent | PSBTs invalidated, must regenerate |
| UTXO consolidated | PSBTs invalidated, must regenerate |
| New deposit received | Coverage reduced, regenerate recommended |
| PSBT expired | Regenerate PSBTs |
Resolving¶
- Click Regenerate PSBTs
- Download new unsigned PSBTs
- Sign with your hardware wallet
- Upload signed PSBTs
- Status returns to Active
Notifications¶
Monitoring Alerts¶
Vigil sends notifications for:
| Event | Description |
|---|---|
psbt.invalidated |
PSBTs need regeneration |
theft_shield.monitoring_toggled |
Monitoring was toggled |
theft_shield.incident_detected |
Potential theft detected |
theft_shield.sweep_broadcast |
Defense transaction broadcast |
Configuring Alerts¶
- Go to Settings → Notifications → Preferences
- Find "Theft Shield" section
- Enable desired event notifications
- Select channels (Email, Nostr, Webhook)
Dashboard Metrics¶
The Theft Shield dashboard shows:
Protection Overview¶
┌─────────────────────────────────┐
│ Theft Shield - Active 🛡️ │
├─────────────────────────────────┤
│ Protected Value: 0.5 BTC │
│ Protected UTXOs: 3 │
│ Valid PSBTs: 4 rounds │
│ Fee Budget: 0.01 BTC │
│ Last Scan: 2 sec ago │
└─────────────────────────────────┘
Activity Log¶
Recent monitoring activity:
[12:34:56] Mempool scan completed
[12:34:52] Mempool scan completed
[12:30:00] PSBT validity confirmed
[12:00:00] Daily status check: OK
Health Checks¶
Vigil performs regular health checks:
Automated Checks¶
| Check | Frequency | Purpose |
|---|---|---|
| PSBT validity | Hourly | Ensure PSBTs match current UTXOs |
| UTXO sync | Per-block | Track UTXO changes |
| Safe address | Daily | Verify address is valid |
Manual Check¶
- Go to Theft Shield → Monitoring
- Click Run Health Check
- Review results
Next: Incidents →