Skip to content

Fukuii Documentation

Welcome to the official documentation for Fukuii, an EVM-compliant Ethereum execution layer (EL) client written in Scala 3, with pluggable consensus.

  • 🚀 Getting Started

    New to Fukuii? Start here to get your node up and running.

    Quick Start

  • 🏃 For Node Operators

    Running a Fukuii node? Find configuration, security, and maintenance guides.

    Node Operations

  • ⚙ For Operators/SRE

    Deploy and monitor Fukuii in production environments.

    Operations Guide

  • 🔧 For Developers

    Contributing to Fukuii or building on top of it? Find architecture docs and development guides.

    Developer Guide

What is Fukuii?

Fukuii is an EVM-compliant execution layer client built with Scala 3. Originating as a fork of Mantis for Ethereum Classic, it has evolved into a general-purpose EVM engine that participates in any consensus model via a pluggable three-layer architecture (fukuii-core / fukuii-env / consensus module — see Pluggable Consensus Vision). It provides:

  • Dual PoW/PoS operation — Native Ethash mining for Ethereum Classic and Mordor, plus Engine API V1–V4 (through Prague/Electra) for post-Merge Ethereum networks paired with any CL client (Lighthouse, Prysm, Teku, Lodestar, Nimbus)
  • Full EVM through Prague/Electra — All mainstream EIPs supported, including EIP-1559, EIP-3855 (PUSH0), EIP-4844 (blob transactions), EIP-4895 (withdrawals), EIP-4788 (beacon root), EIP-7685 (execution requests), plus ETC's ECIP-1066 hard-fork schedule through Olympia (ECIP-1111/1112/1121)
  • Multi-mode sync — SNAP, fast, and regular sync for PoW chains; optimistic block import via Engine API for PoS chains
  • JSON-RPC API — eth_*, net_*, web3_*, debug_*, trace_*, admin_*, txpool_*, personal_*, engine_* (authrpc), plus MCP 2025-11-25 for agentic AI control
  • Hive-verified compliance — Full Ethereum Foundation Hive simulator suite (smoke, rpc, graphql, devp2p, sync, consensus, pyspec, engine, consume-engine, consume-rlp) runs per-simulator in CI
  • Docker support — Production-ready container images with signed releases and SLSA provenance
  • Comprehensive monitoring — Prometheus metrics, Grafana dashboards, health/readiness endpoints
I want to... Go to...
Run a node quickly Quick Start
Deploy with Docker Docker Guide
Configure my node Node Configuration
Secure my node Security Runbook
Understand the architecture Architecture Overview
Understand the pluggable-consensus design Pluggable Consensus Vision
Use the JSON-RPC API API Reference
Run as an Engine API execution layer API Reference — Engine API section
Contribute code Contributing Guide
Test compatibility Gorgoroth Network Testing

Supported Networks

Network Chain ID Consensus Status
Ethereum Classic 61 PoW (Ethash) Full sync (SNAP / fast / regular)
Mordor 63 PoW (Ethash) Full sync (SNAP / fast / regular)
Sepolia 11155111 PoS (Engine API) Validated — 21+ EL peers, Lighthouse CL
Ethereum Mainnet 1 PoS (Engine API) Configuration available

Documentation Organization

This documentation is organized by audience:

Community

Built with ❤ by Chippr Robotics LLC