Calimero Core

Calimero is a peer-to-peer platform for building collaborative apps with automatic conflict-free sync, encrypted P2P networking, and group-based access control. Write your app in Rust or JavaScript, compile to WASM, and every node runs the same logic with state that converges automatically.

Start Here

Pick your path based on what you want to do.

1

Build an App

Get a node running, deploy your first app, and understand groups, contexts, and CRDTs.

Getting Started →

2

Deploy & Operate

Install merod, configure nodes, manage groups and members, set up TEE mode.

merod & meroctl →

3

Understand the Architecture

Dive into the internals: actors, governance DAGs, sync protocols, storage schema.

System Overview →

System Map

meroctl CLI operator Admin Dashboard embedded SPA External Clients RPC / WS / SSE Server Layer Axum · REST Admin API · JSON-RPC · WebSocket · SSE · Prometheus NodeManager Network events, blob cache, heartbeats Delta handling, stream routing Actix Actor ContextManager Contexts, groups, governance DAGs Application lifecycle, upgrades Actix Actor NetworkManager libp2p: gossipsub, Kad, mDNS, relay Streams, AutoNAT v2, DCUtR Actix Actor SyncManager Hash/Level/Snapshot Delta protocols WASM Runtime Wasmer + Cranelift 50+ host functions Storage Layer RocksDB · 10 columns · typed keys · causal DAG · CRDT collections · blob store mero-auth JWT issuing + verification Pluggable providers Challenge/nonce auth Embedded or proxy mode P2P Network Other Calimero nodes gossipsub · streams · DHT calimero-sdk #[app::state] #[app::logic] → WASM → Runtime
Node
Context
Network
Sync
Runtime
Storage
Server / SDK
Auth

Click any box to jump to its deep-dive page.

Crate Index

◆

Node

NodeManager actor, event handling, blob cache, heartbeats, startup orchestration.

 ◆

Context & Groups

ContextManager actor, 20+ handlers, GroupStore, governance DAGs, upgrades.

 ◆

Network & P2P

libp2p swarm with 10 behaviours, gossipsub, Kademlia, streams, discovery.

 ◆

Storage

Column-family KV over RocksDB. 10 columns, typed keys, 20+ group prefixes.

 ◆

Sync Engine

Hash comparison, level-wise, snapshot, and delta protocols. Governance catch-up.

 ◆

WASM Runtime

Wasmer + Cranelift, VMLogic, 50+ host functions, CRDT support, profiling.

 ◆

Server & API

Axum HTTP: REST admin, JSON-RPC, WebSocket, SSE, Prometheus, auth guard.

 ◆

SDK & Apps

Proc macros for app development. State, logic, events, migrations. 15+ sample apps.

 ◆

Auth

JWT service, pluggable providers, challenge flow, embedded or proxy mode.

Key Concepts

Context

A context binds a group (governance) to an application (WASM). Members join via the group, execute methods against the application, and state is replicated across all nodes via the sync engine. Each context has its own DAG of state deltas.

Group

A group owns one or more contexts. Group membership, capabilities, visibility, and access control are managed via signed governance operations (SignedGroupOp) that form a causal DAG. Managed locally via signed governance operations that propagate via gossipsub and catch-up protocols.

State Sync

Application state changes produce CausalDelta entries in a DAG. Deltas are broadcast via gossip and reconciled using multiple protocols: hash comparison (small diffs), level-wise (broad diffs), snapshot (full transfer), or direct delta exchange.

WASM Execution

Applications are compiled to WASM via the calimero-sdk. The runtime provides 50+ host functions for storage, events, CRDTs, blobs, and identity. State mutations produce deltas that propagate to all peers.