Skip to content

HighSiteRadioProtocal/lightning-watchtower

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Production Watchtower BOLT13 Docker

🗼 Lightning Network Watchtower

24/7 blockchain monitor that protects Lightning channels from fraud.
Detects cheating attempts and broadcasts penalty transactions automatically.

🌐 ServiceProblemFeaturesConnectSelf-HostContact


😱 The Problem

Alice and Bob: Lightning channel with 1 BTC
Current state: Alice = 0.7 BTC, Bob = 0.3 BTC
Old state:     Alice = 0.3 BTC, Bob = 0.7 BTC

Bob goes offline → Alice broadcasts OLD state → Steals 0.4 BTC!

✅ The Solution

Bob registers with our watchtower
↓
Watchtower monitors EVERY block 24/7
↓
Alice broadcasts old state → CAUGHT!
↓
Watchtower broadcasts penalty TX → Alice loses ALL her funds (1 BTC → Bob)
↓
Bob is protected even while offline 🔐

✨ Features

  • 🔍 24/7 Monitoring — Watches every block via bitcoind ZMQ
  • Instant Justice — Auto-broadcasts penalty TX when fraud detected
  • 🔐 Privacy-First — Encrypted breach hints, we can't see your data
  • 📡 BOLT13 Compatible — Works with LND wtclient natively
  • 💰 Reward System — We earn 1% of recovered funds as fee
  • 📊 Dashboard — Active sessions, breach attempts, uptime
  • 🐳 Docker Image — Self-host your own watchtower

🔗 Connect Your LN Node

Option 1: Use Our Hosted Watchtower

# LND — add our watchtower
lncli wtclient add <tower_pubkey>@watchtower.highsiteradio.com:9911

# Verify connection
lncli wtclient towers

# Core Lightning
lightning-cli watchtower-add watchtower.highsiteradio.com:9911

Tower pubkey available at watchtower.highsiteradio.com

Option 2: Subscribe (Premium)

Plan Cost Channels
Basic 1,000 sats/mo Up to 10 channels
Pro 5,000 sats/mo Unlimited channels
Annual 50,000 sats/yr Unlimited + priority

🔍 How Breach Detection Works

1. Client sends encrypted hint:
   { hint: first_16_bytes(revoked_txid), encrypted_blob: justice_tx }

2. New block arrives (ZMQ) ──> Check every TX

3. TX matches hint? 🔍
   ├── YES → Decrypt blob → Get justice TX → Broadcast → Funds recovered ✅
   └── NO  → Continue monitoring...

4. Notify client of breach + penalty

🏗️ Architecture

┌─────────────────┐      ┌─────────────────────┐     ┌───────────┐
│  LN Node        │ gRPC │   WATCHTOWER         │ RPC │  bitcoind │
│  Clients        │─────>│                      │────>│  (full    │
│                 │      │  Store breach hints   │     │   node)   │
│  Send encrypted │      │  Watch every block    │ ZMQ │           │
│  breach data    │      │  Match → Penalize     │<────│  Block    │
│                 │<─────│  Notify client        │     │  stream   │
└─────────────────┘      └─────────────────────┘     └───────────┘

🐳 Self-Host with Docker

docker pull ghcr.io/artificialmanny/lightning-watchtower:latest

docker run -d \
  --name watchtower \
  -p 8080:8080 \
  -p 9911:9911 \
  -e BITCOIND_RPC_URL=http://host:8332 \
  -e BITCOIND_RPC_USER=rpcuser \
  -e BITCOIND_RPC_PASS=rpcpass \
  -e ZMQ_BLOCK=tcp://host:28332 \
  -e ZMQ_TX=tcp://host:28333 \
  -e REWARD_RATE=0.01 \
  -v watchtower-data:/app/data \
  ghcr.io/artificialmanny/lightning-watchtower:latest

💰 Revenue

Source Potential
Subscriptions 1,000–5,000 sats/node/month
Breach rewards 1% of recovered funds (could be millions of sats)

A single successful breach detection on a large channel = massive reward.

🔗 Part of the HighsiteRadio BTC Suite

Service Link
⛏️ Mining Proxy View
📡 Nostr Relay View
📊 Mempool API View
🚀 TX Accelerator View
📱 HigsiteWallet View

📬 Contact

⚖️ License

Proprietary — Documentation and Docker deployment only. Source code under commercial license.

© 2026 HighsiteRadio. All rights reserved.


🔶 HighsiteRadio BTC Suite
Protecting Lightning channels 24/7 — even while you sleep

About

Lightning Network watchtower - 24/7 fraud detection with penalty transactions

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors