FEATURE: Lightning Network Integration

[BenGWeeks]

Description

Enable Nod.ie to connect to LND (Lightning Network Daemon) for voice-controlled Bitcoin Lightning operations.

User Stories

• As a node operator, I want to check my channel balances by voice
• As a Bitcoin user, I want to create and pay invoices through voice commands
• As a merchant, I want voice alerts for incoming payments

Core Features

1. LND Connection

• Connect to LND via gRPC or REST API
• Support for macaroon authentication
• TLS certificate handling
• Connection status monitoring

2. Channel Management

• List channels with voice-friendly aliases
• Check individual channel balances
• Monitor channel health ("Which channels need attention?")
• Open/close channel commands with confirmations

3. Payment Operations

• Create invoices: "Create a 10,000 sat invoice for coffee"
• Pay invoices: "Pay this invoice [bolt11]"
• Check payment status
• Payment history queries

4. Voice Alerts

• Incoming payment notifications
• Channel closure warnings
• Low balance alerts
• Routing failure notifications

5. Black-Panther Integration

• Auto-discover LND on black-panther home server
• Secure local network communication
• Shared configuration management

Example Interactions

User: "What's my Lightning balance?"
Nod.ie: "You have 0.05 Bitcoin across 5 active channels."

User: "Create an invoice for 50,000 sats"
Nod.ie: "Creating invoice... Done\! The payment request is [reads bolt11]"

User: "Which channels are low on inbound?"
Nod.ie: "Your channel with ACINQ has only 10% inbound capacity remaining."

Technical Requirements

• LND 0.15+ compatibility
• Secure credential storage
• Real-time channel state monitoring
• Voice-optimized response formatting

Security

• Never speak private keys or seeds
• Require confirmation for large payments
• Rate limiting on payment operations
• Secure storage of macaroons

Dependencies

• @lightninglabs/lnc-web or lightning-terminal
• LND running with REST/gRPC enabled
• Proper macaroon permissions

Priority

High - Core feature for Bitcoin node operators