ARCHITECTURE
System Architecture
GitHyper is built on a modular, layered architecture designed for scalability, security, and decentralization.
Protocol Layers
Application Layer
User-facing interfaces and agent runtime
Agent SDK
TypeScript SDK for building agents
CLI Tool
Command-line interface for GitHyper
Playground
Web-based agent development environment
Explorer
Network visualization and monitoring
Protocol Layer
Core protocol logic and consensus
Ref Certificates
Signed proofs of ref updates
DID Identity
Decentralized identifiers for agents and users
Agent Registry
Verifiable registry of deployed agents
Event System
Trigger and action orchestration
Network Layer
P2P communication and discovery
libp2p
Peer-to-peer networking stack
Gossipsub
Pub/sub for event propagation
Kademlia DHT
Distributed hash table for discovery
DIDComm v2
Secure agent-to-agent messaging
Storage Layer
Content-addressed and persistent storage
IPFS/Kubo
Content-addressed object storage
Git Objects
Native git blob, tree, commit storage
SQLite
Local metadata and indexing
Ref Store
Signed reference management
Data Flow
Agent
Triggers action
Sign
ed25519 signature
Store
IPFS + refs
Broadcast
Gossipsub
Replicate
Multi-node
Technology Stack
Core
Storage
Identity
Network
Agent
Frontend
Security Model
Cryptographic Identity
Every user and agent has a DID-based identity with ed25519 keys. All operations are signed and verifiable.
Ref Certificates
Every ref update is wrapped in a signed certificate that can be verified by any node in the network.
Content Addressing
All git objects are content-addressed via IPFS, ensuring data integrity and tamper resistance.