# kanari-network/kanari-sdk architecture

> Architecture diagram of the GitHub repository kanari-network/kanari-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kanari-network/kanari-sdk
- Repository: https://github.com/kanari-network/kanari-sdk

## Overview

Kanari is a Rust/Move workspace for a transaction network. Its principal workflow accepts a signed transaction through RPC, validates and gossips it, executes Move code, then commits transaction work into a checkpoint and synchronizes checkpoints to lagging nodes. The graph also preserves the documented client, query/index, framework, native-function, and state-commitment capabilities. Relationships are based on the README’s lifecycle and architecture diagrams; unsampled implementation details are not inferred.

Main entry points: [`crates/kanari-core/src/engine.rs`](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine.rs) (Blockchain engine), [`move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs`](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs) (Move runtime), [`crates/kanari-core/src/engine/apply_checkpoint.rs`](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine/apply_checkpoint.rs) (Checkpoint builder), [`crates/kanari-rpc-client/src/lib.rs`](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-client/src/lib.rs) (RPC client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Clients"]
  node_cli["Kanari CLI<br/>[main.rs]"]
  node_explorer["Explorer<br/>[page.tsx]"]
  node_rpc_client["RPC client<br/>[lib.rs]"]
end

subgraph group_api_node["API and node"]
  node_rpc_api["RPC API types<br/>[lib.rs]"]
  node_rpc_server["RPC server<br/>[lib.rs]"]
  node_node["Validator node<br/>[app.rs]"]
  node_p2p["P2P propagation<br/>[p2p.rs]"]
  node_sync["Checkpoint sync<br/>[sync.rs]"]
end

subgraph group_chain["Chain processing"]
  node_engine["Blockchain engine<br/>[engine.rs]"]
  node_mempool["Verified mempool<br/>[mempool.rs]"]
  node_checkpoint["Checkpoint builder"]
  node_consensus["DAG consensus<br/>[consensus.rs]"]
  node_dag_blocks["Mysticeti DAG blocks<br/>[block.rs]"]
end

subgraph group_execution["Execution"]
  node_runtime["Move runtime<br/>[object_storage.rs]"]
  node_natives["Move system natives<br/>[lib.rs]"]
  node_frameworks["Move frameworks<br/>[packages_config.rs]"]
end

subgraph group_state_crypto["State and crypto"]
  node_types["Transaction and object types<br/>[lib.rs]"]
  node_smt["Sparse Merkle Tree<br/>[sparse_merkle.rs]"]
  node_indexes["Transaction and object indexes<br/>[indexer.rs]"]
  node_store[("Persistent state store<br/>[object_storage.rs]")]
  node_crypto["Keys and signatures<br/>[lib.rs]"]
end

node_users(("Network users"))

node_users -->|"invoke commands"| node_cli
node_users -->|"browse network"| node_explorer
node_cli -->|"submit and query"| node_rpc_client
node_explorer -->|"query network"| node_rpc_client
node_rpc_client -->|"uses methods"| node_rpc_api
node_rpc_api -->|"defines requests"| node_rpc_server
node_rpc_server -->|"submits transactions"| node_engine
node_node -->|"serves requests"| node_rpc_server
node_node -->|"runs networking"| node_p2p
node_p2p -->|"propagates checkpoints"| node_sync
node_sync -->|"recovers checkpoints"| node_engine
node_engine -->|"admits transactions"| node_mempool
node_mempool -->|"gossips transactions"| node_p2p
node_engine -->|"executes transactions"| node_runtime
node_engine -->|"produces checkpoints"| node_checkpoint
node_checkpoint -->|"records DAG metadata"| node_consensus
node_consensus -->|"uses DAG primitives"| node_dag_blocks
node_checkpoint -->|"updates indexes"| node_indexes
node_engine -->|"processes chain types"| node_types
node_engine -->|"commits state root"| node_smt
node_engine -->|"persists state"| node_store
node_runtime -->|"reads and writes objects"| node_store
node_runtime -->|"invokes native functions"| node_natives
node_runtime -->|"loads Move modules"| node_frameworks
node_engine -->|"validates signatures"| node_crypto

click node_cli "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari/src/main.rs"
click node_explorer "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/kanariexplorer/app/page.tsx"
click node_rpc_client "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-client/src/lib.rs"
click node_rpc_api "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-api/src/lib.rs"
click node_rpc_server "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-server/src/lib.rs"
click node_node "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-node/src/app.rs"
click node_p2p "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-node/src/p2p.rs"
click node_sync "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-node/src/sync.rs"
click node_engine "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine.rs"
click node_mempool "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine/mempool.rs"
click node_checkpoint "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine/apply_checkpoint.rs"
click node_consensus "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/consensus.rs"
click node_dag_blocks "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/mysticeti/crates/dag/src/block.rs"
click node_runtime "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs"
click node_natives "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-system-natives/src/lib.rs"
click node_frameworks "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-frameworks/src/packages_config.rs"
click node_types "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-types/src/lib.rs"
click node_smt "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/smt/src/sparse_merkle.rs"
click node_indexes "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-indexer/src/indexer.rs"
click node_store "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs"
click node_crypto "https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-crypto/src/lib.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_explorer,node_rpc_client,node_users toneBlue
class node_rpc_api,node_rpc_server,node_node,node_p2p,node_sync toneAmber
class node_engine,node_mempool,node_checkpoint,node_consensus,node_dag_blocks toneMint
class node_runtime,node_natives,node_frameworks toneRose
class node_types,node_smt,node_indexes,node_store,node_crypto toneIndigo
```

## Components

### Clients

- [Kanari CLI](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari/src/main.rs): `crates/kanari/src/main.rs`
- [Explorer](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/kanariexplorer/app/page.tsx): `kanariexplorer/app/page.tsx`
- [RPC client](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-client/src/lib.rs): `crates/kanari-rpc-client/src/lib.rs`

### API and node

- [RPC API types](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-api/src/lib.rs): `crates/kanari-rpc-api/src/lib.rs`
- [RPC server](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-rpc-server/src/lib.rs): `crates/kanari-rpc-server/src/lib.rs`
- [Validator node](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-node/src/app.rs): `crates/kanari-node/src/app.rs`
- [P2P propagation](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-node/src/p2p.rs): `crates/kanari-node/src/p2p.rs`
- [Checkpoint sync](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-node/src/sync.rs): `crates/kanari-node/src/sync.rs`

### Chain processing

- [Blockchain engine](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine.rs): `crates/kanari-core/src/engine.rs`
- [Verified mempool](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine/mempool.rs): `crates/kanari-core/src/engine/mempool.rs`
- [Checkpoint builder](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/engine/apply_checkpoint.rs): `crates/kanari-core/src/engine/apply_checkpoint.rs`
- [DAG consensus](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-core/src/consensus.rs): `crates/kanari-core/src/consensus.rs`
- [Mysticeti DAG blocks](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/mysticeti/crates/dag/src/block.rs): `crates/mysticeti/crates/dag/src/block.rs`

### Execution

- [Move runtime](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs): `move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs`
- [Move system natives](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-system-natives/src/lib.rs): `crates/kanari-system-natives/src/lib.rs`
- [Move frameworks](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-frameworks/src/packages_config.rs): `crates/kanari-frameworks/src/packages_config.rs`

### State and crypto

- [Transaction and object types](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-types/src/lib.rs): `crates/kanari-types/src/lib.rs`
- [Sparse Merkle Tree](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/smt/src/sparse_merkle.rs): `crates/smt/src/sparse_merkle.rs`
- [Transaction and object indexes](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-indexer/src/indexer.rs): `crates/kanari-indexer/src/indexer.rs`
- [Persistent state store](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs): `move-execution/v2/kanari-move-runtime-v2/src/storage/object_storage.rs`
- [Keys and signatures](https://github.com/kanari-network/kanari-sdk/blob/kanari-sdk/crates/kanari-crypto/src/lib.rs): `crates/kanari-crypto/src/lib.rs`

### Other components

- **Network users**

## Connections

- Network users → Kanari CLI: invoke commands (evidence: `README.md`)
- Network users → Explorer: browse network (evidence: `README.md`)
- Kanari CLI → RPC client: submit and query (evidence: `README.md`)
- Explorer → RPC client: query network (evidence: `README.md`)
- RPC client → RPC API types: uses methods (evidence: `README.md`)
- RPC API types → RPC server: defines requests (evidence: `README.md`)
- RPC server → Blockchain engine: submits transactions (evidence: `README.md`)
- Validator node → RPC server: serves requests (evidence: `README.md`)
- Validator node → P2P propagation: runs networking (evidence: `README.md`)
- P2P propagation → Checkpoint sync: propagates checkpoints (evidence: `README.md`)
- Checkpoint sync → Blockchain engine: recovers checkpoints (evidence: `README.md`)
- Blockchain engine → Verified mempool: admits transactions (evidence: `README.md`)
- Verified mempool → P2P propagation: gossips transactions (evidence: `README.md`)
- Blockchain engine → Move runtime: executes transactions (evidence: `README.md`)
- Blockchain engine → Checkpoint builder: produces checkpoints (evidence: `README.md`)
- Checkpoint builder → DAG consensus: records DAG metadata (evidence: `README.md`)
- DAG consensus → Mysticeti DAG blocks: uses DAG primitives (evidence: `README.md`)
- Checkpoint builder → Transaction and object indexes: updates indexes (evidence: `README.md`)
- Blockchain engine → Transaction and object types: processes chain types (evidence: `README.md`)
- Blockchain engine → Sparse Merkle Tree: commits state root (evidence: `README.md`)
- Blockchain engine → Persistent state store: persists state (evidence: `README.md`)
- Move runtime → Persistent state store: reads and writes objects (evidence: `README.md`)
- Move runtime → Move system natives: invokes native functions (evidence: `README.md`)
- Move runtime → Move frameworks: loads Move modules (evidence: `README.md`)
- Blockchain engine → Keys and signatures: validates signatures (evidence: `README.md`)
