# solana-foundation/kora architecture

> Architecture diagram of the GitHub repository solana-foundation/kora, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/solana-foundation/kora
- Repository: https://github.com/solana-foundation/kora

## Overview

Kora is Solana signing infrastructure: clients submit transactions over JSON-RPC, and the node exposes signing and fee-payment operations while applying configurable validation and signer policies. The Rust library also provides token and transaction handling, fee calculation, authentication, rate limiting, caching, and monitoring; the TypeScript SDK offers client and payment-planning integrations. Edges are limited to relationships shown by the excerpts, SOURCE INDEX references, or README; several implementation paths are supported by the tree but were not sampled.

Main entry points: [`crates/lib/src/validator/transaction_validator.rs`](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/validator/transaction_validator.rs) (Transaction validation), [`crates/lib/src/rpc_server/server.rs`](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/rpc_server/server.rs) (JSON-RPC server), [`crates/cli/src/main.rs`](https://github.com/solana-foundation/kora/blob/main/crates/cli/src/main.rs) (CLI commands), [`crates/lib/src/transaction/transaction.rs`](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/transaction.rs) (Transaction processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and API"]
  node_cli["CLI commands<br/>[main.rs]"]
  node_rpc_server["JSON-RPC server<br/>[server.rs]"]
  node_rpc_methods["RPC methods"]
  node_auth["Request authentication<br/>[auth.rs]"]
end

subgraph group_signing["Signing and transactions"]
  node_signer_pool["Signer pool<br/>[pool.rs]"]
  node_transaction["Transaction processing<br/>[transaction.rs]"]
  node_versioned_transaction["Versioned transactions"]
  node_token2022["Token-2022 security"]
end

subgraph group_policy["Fees and policy"]
  node_validator["Transaction validation"]
  node_fee_policy["Fee-payer policies"]
  node_fee_calculation["Fee calculation<br/>[fee.rs]"]
  node_token_support["Token support<br/>[token.rs]"]
end

subgraph group_operations["Node operations"]
  node_config["Configuration<br/>[config.rs]"]
  node_state["Shared node state<br/>[state.rs]"]
  node_cache[("Redis caching<br/>[cache.rs]")]
  node_usage_limits["Rate and spend limits<br/>[limiter.rs]"]
  node_metrics["Metrics monitoring<br/>[balance.rs]"]
end

subgraph group_sdk["Client SDK"]
  node_sdk_client["TypeScript RPC client<br/>[client.ts]"]
  node_sdk_payment["Payment instruction<br/>[payment.ts]"]
  node_sdk_plugin["Kit integration<br/>[plugin.ts]"]
  node_sdk_planner["Transaction planner<br/>[planner.ts]"]
end

node_operator(("Node operator"))

node_operator -->|"runs"| node_cli
node_cli -->|"loads"| node_config
node_cli -->|"starts"| node_rpc_server
node_rpc_server -->|"registers"| node_rpc_methods
node_rpc_server -->|"applies"| node_auth
node_rpc_server -->|"starts"| node_metrics
node_state -->|"reads"| node_config
node_state -->|"accesses"| node_signer_pool
node_transaction -->|"uses"| node_versioned_transaction
node_transaction -->|"uses"| node_token2022
node_validator -->|"uses"| node_transaction
node_validator -->|"uses"| node_fee_calculation
node_validator -->|"uses"| node_token_support
node_validator -->|"uses"| node_fee_policy
node_sdk_client -->|"calls"| node_rpc_methods
node_sdk_client -->|"builds"| node_sdk_payment
node_sdk_plugin -->|"configures"| node_sdk_planner
node_sdk_plugin -->|"builds"| node_sdk_payment
node_sdk_planner -->|"uses"| node_sdk_client

click node_cli "https://github.com/solana-foundation/kora/blob/main/crates/cli/src/main.rs"
click node_rpc_server "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/rpc_server/server.rs"
click node_rpc_methods "https://github.com/solana-foundation/kora/tree/main/crates/lib/src/rpc_server/method"
click node_auth "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/rpc_server/auth.rs"
click node_config "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/config.rs"
click node_state "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/state.rs"
click node_signer_pool "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/signer/pool.rs"
click node_transaction "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/transaction.rs"
click node_versioned_transaction "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/versioned_transaction.rs"
click node_token2022 "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/token2022_security.rs"
click node_validator "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/validator/transaction_validator.rs"
click node_fee_policy "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/validator/transaction_validator/fee_payer_outflow_props.rs"
click node_fee_calculation "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/fee/fee.rs"
click node_token_support "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/token/token.rs"
click node_cache "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/cache.rs"
click node_usage_limits "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/usage_limit/limiter.rs"
click node_metrics "https://github.com/solana-foundation/kora/blob/main/crates/lib/src/metrics/balance.rs"
click node_sdk_client "https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/client.ts"
click node_sdk_payment "https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/kit/payment.ts"
click node_sdk_plugin "https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/plugin.ts"
click node_sdk_planner "https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/kit/planner.ts"

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_rpc_server,node_rpc_methods,node_auth toneBlue
class node_signer_pool,node_transaction,node_versioned_transaction,node_token2022 toneAmber
class node_validator,node_fee_policy,node_fee_calculation,node_token_support toneMint
class node_config,node_state,node_cache,node_usage_limits,node_metrics toneRose
class node_sdk_client,node_sdk_payment,node_sdk_plugin,node_sdk_planner,node_operator toneIndigo
```

## Components

### Entry and API

- [CLI commands](https://github.com/solana-foundation/kora/blob/main/crates/cli/src/main.rs): `crates/cli/src/main.rs`
- [JSON-RPC server](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/rpc_server/server.rs): `crates/lib/src/rpc_server/server.rs`
- [RPC methods](https://github.com/solana-foundation/kora/tree/main/crates/lib/src/rpc_server/method): `crates/lib/src/rpc_server/method`
- [Request authentication](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/rpc_server/auth.rs): `crates/lib/src/rpc_server/auth.rs`

### Signing and transactions

- [Signer pool](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/signer/pool.rs): `crates/lib/src/signer/pool.rs`
- [Transaction processing](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/transaction.rs): `crates/lib/src/transaction/transaction.rs`
- [Versioned transactions](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/versioned_transaction.rs): `crates/lib/src/transaction/versioned_transaction.rs`
- [Token-2022 security](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/transaction/token2022_security.rs): `crates/lib/src/transaction/token2022_security.rs`

### Fees and policy

- [Transaction validation](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/validator/transaction_validator.rs): `crates/lib/src/validator/transaction_validator.rs`
- [Fee-payer policies](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/validator/transaction_validator/fee_payer_outflow_props.rs): `crates/lib/src/validator/transaction_validator/fee_payer_outflow_props.rs`
- [Fee calculation](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/fee/fee.rs): `crates/lib/src/fee/fee.rs`
- [Token support](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/token/token.rs): `crates/lib/src/token/token.rs`

### Node operations

- [Configuration](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/config.rs): `crates/lib/src/config.rs`
- [Shared node state](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/state.rs): `crates/lib/src/state.rs`
- [Redis caching](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/cache.rs): `crates/lib/src/cache.rs`
- [Rate and spend limits](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/usage_limit/limiter.rs): `crates/lib/src/usage_limit/limiter.rs`
- [Metrics monitoring](https://github.com/solana-foundation/kora/blob/main/crates/lib/src/metrics/balance.rs): `crates/lib/src/metrics/balance.rs`

### Client SDK

- [TypeScript RPC client](https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/client.ts): `sdks/ts/src/client.ts`
- [Payment instruction](https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/kit/payment.ts): `sdks/ts/src/kit/payment.ts`
- [Kit integration](https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/plugin.ts): `sdks/ts/src/plugin.ts`
- [Transaction planner](https://github.com/solana-foundation/kora/blob/main/sdks/ts/src/kit/planner.ts): `sdks/ts/src/kit/planner.ts`

### Other components

- **Node operator**

## Connections

- Node operator → CLI commands: runs
- CLI commands → Configuration: loads (evidence: `crates/cli/src/main.rs`)
- CLI commands → JSON-RPC server: starts
- JSON-RPC server → RPC methods: registers (evidence: `crates/lib/src/rpc_server/server.rs`)
- JSON-RPC server → Request authentication: applies (evidence: `crates/lib/src/rpc_server/server.rs`)
- JSON-RPC server → Metrics monitoring: starts (evidence: `crates/lib/src/rpc_server/server.rs`)
- Shared node state → Configuration: reads (evidence: `crates/lib/src/state.rs`)
- Shared node state → Signer pool: accesses (evidence: `crates/lib/src/state.rs`)
- Transaction processing → Versioned transactions: uses (evidence: `crates/lib/src/transaction/mod.rs`)
- Transaction processing → Token-2022 security: uses (evidence: `crates/lib/src/transaction/mod.rs`)
- Transaction validation → Transaction processing: uses (evidence: `crates/lib/src/validator/transaction_validator.rs`)
- Transaction validation → Fee calculation: uses (evidence: `crates/lib/src/validator/transaction_validator.rs`)
- Transaction validation → Token support: uses (evidence: `crates/lib/src/validator/transaction_validator.rs`)
- Transaction validation → Fee-payer policies: uses (evidence: `crates/lib/src/validator/transaction_validator.rs`)
- TypeScript RPC client → RPC methods: calls
- TypeScript RPC client → Payment instruction: builds (evidence: `sdks/ts/src/client.ts`)
- Kit integration → Transaction planner: configures (evidence: `sdks/ts/src/kit/index.ts`)
- Kit integration → Payment instruction: builds (evidence: `sdks/ts/src/kit/index.ts`)
- Transaction planner → TypeScript RPC client: uses (evidence: `sdks/ts/src/kit/planner.ts`)
