Architecture

AISP Under the Hood

AISP is a 5-layer protocol stack sitting on top of the Blackhole 9-layer mesh OS. Click any AISP layer to explore its internals — or scroll to see how the full stack fits together.

AISP Runs on the Blackhole 9-Layer Stack

AISP Application Layeryou are here
Blackhole L7 — Applications (BMAP, sessions, exec)
Blackhole L6 — Policy (Zero Trust tokens, ZK proofs)
Blackhole L5 — Addressing (MagicDNS *.bh)
Blackhole L4 — Connectivity (WireGuard ChaCha20)
Blackhole L3 — Discovery (CRDT PeerRegistry)
Blackhole L2 — Bootstrap (Ed25519, Cap'n Proto)
Blackhole L1 — Embedded NATS (built-in broker)
Blackhole L0 — Kernel Agent (agent.go)
Blackhole L-1 — XDP BPF Fast Path (<100µs)

AISP inherits WireGuard encryption, CRDT peer discovery, Zero Trust tokens, and XDP fast path from Blackhole — for free.

The 5 AISP Layers

Click any layer to explore its internals.

Session
FSM — INIT → ACTIVE → SUSPENDED → TERMINATED

The session layer manages agent lifecycles as an explicit finite state machine. Sessions survive network partitions and agent restarts — state is checkpointed to the CRDT store at every transition. A suspended session resumes exactly where it left off.

  • States: INIT → ACTIVE → SUSPENDED → TERMINATED
  • Ed25519 session authentication on every handshake
  • Monotonic sequence numbers prevent replay attacks
  • Crash recovery: resume from last CRDT checkpoint
  • Session multiplexing: one agent, many concurrent sessions
  • Timeout + keepalive configurable per session

Three Things No Other Agent Protocol Has

CRDT FileSync

Agents can sync files across the mesh without a central coordinator. Conflict behavior and convergence are validated during assisted onboarding.

Zero Trust built in

Agent identity is cryptographically proven via Ed25519 + ZK Schnorr. Offline verification — no server call, no OCSP, no PKI infrastructure needed.

XDP fast path

When agents are on the same Blackhole mesh, XDP fast-path behavior is treated as a deployment-specific validation target.

Framework Integration

LangChain
AI Framework
AutoGen
AI Framework
CrewAI
AI Framework
AISP SDK (Go / Python / Node.js)
Sessions · Memory (6 CRDTs) · Identity (ZK)
Session FSM
Memory (6 CRDTs)
Identity (ZK Schnorr)
Blackhole Mesh (9 layers — XDP BPF through Applications)
Mesh latency, XDP fast path, and WireGuard behavior validated per deployment

AISP vs Other Protocols

FeatureAISPgRPCWebSocketHTTP
Persistent sessions
Mesh transport
6 CRDT memory types
ZK identity proofs
Offline verification
XDP fast path
Self-hosted
Latency (p50)0.4ms2ms3ms12ms