Documentation

Kanari Documentation

Protocol Stack

Current Kanari layered architecture and component relationships.

Last updated

Protocol Stack

Kanari is organized as a layered Move/object chain. Applications submit signed work through JSON-RPC; nodes gossip transactions and checkpoints; the core engine builds deterministic checkpoint work; the Move runtime executes state transitions; RocksDB and SMT roots persist the canonical state.

Mermaid diagram

Layer responsibilities

LayerResponsibility
ApplicationExplorer, CLI, wallets, and payment SDKs create and inspect user activity.
RPC / APIAxum JSON-RPC validates request shape, applies concurrency limits, and returns typed responses.
NodeRuns RPC, libp2p gossip, checkpoint sync, identity, consensus keys, and backup tooling.
Core chainOwns mempool, checkpoint production, state roots, transaction/object indexes, and DAG metadata.
ExecutionRuns Move VM calls, native functions, scheduler logic, and state changes.
Data / cryptoStores canonical state, object records, SMT roots, framework modules, signatures, and hashes.

Entity relationship overview

Mermaid diagram

This diagram is a documentation view of the runtime flow, not a database schema. The authoritative data lives in the Rust types, RocksDB stores, checkpoints, and SMT state root.