Deployment

Everything you need to run Kaizen Core in production or development.

Quick Start

# Clone and start
git clone https://github.com/mitosis-org/kaizen-core.git
cd kaizen-core
docker compose up -d
 
# Access
open http://localhost:3000   # Tester UI
open http://localhost:3003   # Grafana (monitoring)

Services Overview

Service	Port	Description
proxy	8546	Unified RPC/WS endpoint (recommended)
write-node	8545	Sequencer
read-node-aggressive	8547	Low-latency queries
read-node-archive	8548	Full history
oracle	8550	Price aggregator
solver	3001	Quote provider
bridge	3002	Deposit relayer
settler	-	Settlement service
tester	3000	Frontend app
grafana	3003	Monitoring

Guides

Docker Setup - Complete Docker Compose configuration
Configuration - Node configuration reference
Monitoring - Prometheus, Grafana, Loki setup

Architecture

┌─────────────────────────────────────────────────────────┐
│                      Frontend                           │
│                    (localhost:3000)                     │
└────────────────────────┬────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────┐
│                    RPC Proxy (:8546)                    │
│            Routes: writes → sequencer                   │
│                    reads → read nodes                   │
└────────────────────────┬────────────────────────────────┘
                         │
        ┌────────────────┼────────────────┐
        ▼                ▼                ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│  Write Node   │ │  Read Node    │ │  Read Node    │
│  (sequencer)  │ │  (aggressive) │ │  (archive)    │
│    :8545      │ │    :8547      │ │    :8548      │
└───────┬───────┘ └───────────────┘ └───────────────┘
        │                gRPC sync
        └────────────────────────────────────────┐
        │                                        │
        ▼                                        ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│    Oracle     │ │    Solver     │ │    Settler    │
│    :8550      │ │    :3001      │ │   (gRPC)      │
└───────────────┘ └───────────────┘ └───────────────┘

Environment Variables

Variable	Description	Default
`BRIDGE_PRIVATE_KEY`	Bridge relayer key	Test key
`SOLVER_PRIVATE_KEY`	Solver signer key	Test key
`SETTLER_PRIVATE_KEY`	Settler key	Test key
`POSTGRES_PASSWORD`	Database password	`kaizen`