Confirmation Levels¶

Configure when to receive alerts based on transaction confirmation status.

Understanding Confirmations¶

Confirmations	Status	Security Level
0 (mempool)	Unconfirmed	Low - can be replaced
1	First block	Moderate - unlikely to reorg
3	Third block	Good - standard for merchants
6	Sixth block	High - widely accepted as final
100+	Deep	Maximum - practically irreversible

Confirmation Milestones¶

0-Conf (Mempool)¶

When: Transaction enters mempool

Use cases: - Instant awareness - Security monitoring - RBF detection

Risk: Transaction can be replaced or never confirm

1 Confirmation¶

When: Transaction included in a block

Use cases: - Quick verification - Low-value transactions - Initial confirmation

Risk: Possible (but rare) reorg

3 Confirmations¶

When: Three blocks deep

Use cases: - Merchant acceptance standard - Medium-value transactions - Good security balance

Risk: Reorg very unlikely

6 Confirmations¶

When: Six blocks deep

Use cases: - High-value transactions - Exchange deposits - Maximum security

Risk: Effectively irreversible

Configuration¶

Per-Transaction Type¶

Configure confirmation alerts separately for deposits and withdrawals:

Deposits:
  ├── Mempool (immediate awareness)
  ├── 1 confirmation (processing begins)
  └── 6 confirmations (funds available)

Withdrawals:
  ├── Mempool (verify it broadcast)
  └── 1 confirmation (successful send)

Multiple Milestones¶

Alert at several confirmation levels:

High-value deposit:
  ├── 0-conf: "Deposit detected"
  ├── 1-conf: "First confirmation"
  ├── 3-conf: "Payment processing"
  └── 6-conf: "Funds secured"

Practical Examples¶

Cold Storage¶

Deposits:
  - 0-conf: Email + Nostr (immediate alert)
  - 1-conf: Email (verified in block)
  - 6-conf: Email (fully confirmed)

Withdrawals:
  - 0-conf: Email + Nostr (should never happen!)

Daily Wallet¶

Deposits > 0.01 BTC:
  - 0-conf: Email
  - 3-conf: Email

Withdrawals:
  - 0-conf: Nostr (quick check)

Business Wallet¶

Deposits:
  - 0-conf: Webhook (log to database)
  - 3-conf: Webhook (mark as paid)
  - 6-conf: Webhook (funds available)

Confirmation Tracking¶

View confirmation progress in real-time:

Transaction abc123...
├── Detected: 12:00:00
├── 1 conf:   12:10:00 ✓
├── 3 conf:   12:30:00 ✓
└── 6 conf:   13:00:00 ⏳

Reorg Handling¶

If a reorg occurs:

Confirmation count may decrease
You'll be notified of the reorg
Tracking continues from new count

Transaction abc123...
├── 3 confirmations reached
│   ↓
├── ⚠️ REORG DETECTED
│   ↓
└── Back to 1 confirmation

Next: Testing Rules →