System Overview
Orbinum is a modular blockchain built on Substrate with integrated privacy features through Zero-Knowledge proofs and full EVM compatibility via Frontier.
Table of Contents
Architecture Layers
Core Components
Privacy Layer
| Component | Crate | Purpose |
|---|---|---|
| Shielded Pool | pallet-shielded-pool | UTXO-based private transactions |
| ZK Verifier | pallet-zk-verifier | On-chain Groth16 proof verification |
| ZK Primitives | fp-zk-primitives | Poseidon hash, Merkle trees, commitments |
| ZK Circuits | fp-zk-circuits | R1CS circuits for proving |
EVM Layer
| Component | Crate | Purpose |
|---|---|---|
| EVM Execution | pallet-evm | Ethereum Virtual Machine |
| Ethereum Compat | pallet-ethereum | Ethereum transaction support |
| Base Fee | pallet-base-fee | EIP-1559 fee mechanism |
| Dynamic Fee | pallet-dynamic-fee | Fee adjustment |
Client Layer
| Component | Location | Purpose |
|---|---|---|
| Wallet CLI | client/wallet-cli | Privacy operations CLI |
| RPC Core | client/rpc-core | Custom RPC methods |
| Storage | client/storage | State management |
Data Flow
Shield Operation
Private Transfer
Crate Structure
orbinum-node-2/
├── frame/ # Substrate pallets
│ ├── shielded-pool/ # Privacy pool (653 lines)
│ ├── zk-verifier/ # Proof verification (533 lines)
│ ├── evm/ # EVM execution
│ ├── ethereum/ # Ethereum compatibility
│ ├── base-fee/ # EIP-1559
│ └── dynamic-fee/ # Fee adjustment
│
├── primitives/ # Core libraries
│ ├── zk-primitives/ # Crypto primitives (196 lines)
│ ├── zk-verifier/ # Verifier logic
│ ├── zk-circuits/ # R1CS circuits
│ ├── account/ # Account types
│ └── consensus/ # Consensus primitives
│
├── client/ # Client-side code
│ ├── wallet-cli/ # CLI wallet
│ ├── rpc/ # RPC implementations
│ └── storage/ # Storage layer
│
├── circuits/ # Circom circuits
│ ├── circuits/ # Circuit definitions
│ ├── scripts/ # Build scripts
│ └── test/ # Circuit tests
│
└── precompiles/ # EVM precompiles
Implementation Status
| Layer | Component | Status | Test Coverage |
|---|---|---|---|
| Runtime | pallet-shielded-pool | Implemented | Comprehensive |
| Runtime | pallet-zk-verifier | Implemented | Comprehensive |
| Runtime | pallet-evm | Implemented | Comprehensive |
| Primitives | fp-zk-primitives | Implemented | Comprehensive |
| Primitives | fp-zk-verifier | Implemented | Comprehensive |
| Client | wallet-cli | Implemented | Comprehensive |
| Circuits | Circom | Implemented | Comprehensive |
Next Steps
- Shielded Pool - Privacy pool architecture
- ZK Proofs - Cryptographic foundations
- EVM Compatibility - Ethereum integration