HLV Protocol

HLV Protocol bridges Bitcoin Lightning liquidity (L2) with Hedera DeFi, enabling seamless cross-chain swaps and automated rebalancing.

Key features include: • Modular Vincent abilities for Lightning and Hedera • Atomic swap execution (HTLC & NWC integration) • 20% automatic rebalance logic • Interactive React UI & RESTful backend API

HLV leverages the Vincent ability pattern for scalable, plug-and-play automation. The architecture is configurable for testnet/mainnet and tracks swap status live.

Modular Abilities: • @hlv/ability-lightning-invoice: Lightning invoice creation via NWC • @hlv/ability-hedera-htlc: Hedera HTLC contract interactions for wBTC • @hlvuser/ability-lightning-payment - Lightning Network payments via NWC

Backend: • Job-based async rebalance flow • RESTful API endpoints (/api/rebalance, /api/swaps) • Hedera network config (Testnet/Mainnet) with chainId switch • Agent monitors HTLC, claims wBTC after Lightning payment events

Frontend: • React components for rebalance actions • Step-by-step dialogs display swap details, amounts, status

References: HLV monorepo, ability READMEs, backend/frontend docs, HTLC contract deployment