Skip to content

lightning-goats/hive-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

159 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lightning Hive Documentation

Canonical documentation for the cl-hive Lightning coordination suite.

Navigation

Architecture & Design

Document Description
Architecture Complete protocol specification
Hive System Overview High-level explanation of the suite, plugin boundaries, core flows
Genesis Origin story and design philosophy
The Hive Article Long-form writeup

Design Documents

Document Description
Cooperative Fee Coordination Pheromone-based fee coordination design
No Node Left Behind Fleet health monitoring and NNLB protocol
VPN Transport WireGuard VPN transport layer
Liquidity Integration cl-revenue-ops integration design
CL Revenue Ops Integration Bridge and circuit breaker design
AI Advisor Database Advisor mode database design
Fee Distribution Process Settlement and fee distribution flow

Planning Documents

See Planning Index for the full dependency-ordered document index.

Key documents:

# Document Status
01 Reputation Schema Phase 1 Implemented
02 Fleet Management Draft
03 Cashu Task Escrow Draft
04 Hive Marketplace Draft
05 Nostr Marketplace Draft
06 Hive Settlements Draft
07 Hive Liquidity Draft
08 Hive Client Draft
09 Archon Integration Draft
10 Node Provisioning Draft
11 Implementation Plan (Phase 1-3) Phase 2 Complete
12 Implementation Plan (Phase 4-6) Draft
13 Phase 6 Readiness-Gated Plan Planning-only
15 Hive System Overview Living overview

Plugin Architecture (Phase 6)

Document Description
cl-hive Core coordination plugin
cl-hive-comms Nostr + REST transport plugin
cl-hive-archon DID + VC identity plugin

Protocol Specs

Document Description
Communication Hardening Protocol hardening plan
Inter-Hive Relations Multi-hive federation spec
Payment-Based Protocol Payment-gated protocol design
Phase 9 Proposal Phase 9 overview
Phase 9.1 Protocol Protocol specification
Phase 9.2 Logic Logic specification
Phase 9.3 Economics Economics specification

Security

Document Description
Threat Model Security threat analysis
Security Review Security review findings
Attack Surface Attack surface analysis
Red Team Plan Red team testing plan
MCP Server Hardening MCP server security review

Deployment

Document Description
Docker Plugin Integration Docker deployment plan for Phase 6
Manual Install (Non-Docker) Manual installation guide

Operations

Document Description
Joining the Hive How to join an existing hive fleet
AI Advisor Setup AI advisor configuration
Advisor Intelligence Advisor intelligence integration
MCP Server MCP server setup and tool reference

Testing

Document Description
Testing Guide Testing overview
Testing Plan Comprehensive test plan
Simulation Report Simulation test results
Polar Setup Polar network testing setup

Research

Document Description
Swarm Intelligence Research Academic research survey

Code Repository

About

Lightning Hive canonical documentation

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages