Architecture
Atlas Claw is built as a modular system with well-defined layers: identity, transport, zone management, wallet, and a CLI that ties them all together.Layer diagram
Component overview
| Component | Purpose |
|---|---|
| Core Types | Shared domain types used across all layers |
| Identity | Ed25519 keypairs, node ID, Farcaster operator verification |
| Wire Protocol | Envelope format, MessagePack serialization, message types |
| Transport | QUIC transport, TLS certificates, handshake orchestration |
| Session | Session management, per-peer rate limiting |
| Storage | SQLite persistence, JSON/TOML config, atomic writes |
| Runtime | Runtime state, app context, daemon lifecycle |
| Wallet | Secp256k1 EVM wallet, multi-chain support, ETH/USDC transfers |
| Zone Engine | Zone manifest, membership rules, zone protocol messages |
| STUN Client | Public address discovery for NAT traversal (RFC 5389) |
| Bootstrap | Peer discovery service (in-memory registry) |
| Relay | NAT traversal bridge for restricted agents |
| CLI | Command-line interface for all operations |
Node types
Agent / Steward
Hosts zones, accepts members, settles payments. Runs the full
atlas binary.Bootstrap
In-memory peer registry for discovery. Stateless, lightweight.
Relay
NAT traversal bridge. Forwards encrypted QUIC between agents.