Repository navigation
ZkOS v0.1.1: Zero-Knowledge OS with Privacy-First Architecture
Pre-release
Pre-release
π ZkOS v0.1.1
August 15, 2025
Welcome to ZkOS! We're excited to announce the first public release of ZkOS, a revolutionary zero-knowledge enabled blockchain operating system built in Rust. This milestone represents months of development focused on creating a privacy-preserving, trustless, and decentralized blockchain infrastructure.
π― What is ZkOS?
ZkOS is a comprehensive UTXO-based blockchain architecture that provides three core state types:
- πͺ Coins: Confidential digital assets with ElGamal encryption
- π Memos: Programmable data containers with time-bound access
- ποΈ State: Smart contract state with nonce-based versioning
β οΈ Security Notice
This is an experimental testnet release and is NOT safe for production use. ZkOS v0.1.0 contains known timing-leak vulnerabilities inherited from upstream crates. Please review our Security Policy before using this software in any environment.
β¨ New Features
ποΈ Core Architecture
- Zero-Knowledge Virtual Machine (zkVM) - Execute and verify smart contracts with zero-knowledge proofs
- UTXO-Based State Management - Immutable state transitions with efficient verification
- Privacy-Preserving Transactions - Confidential transfers using QuisQuis protocol
- Bulletproofs Integration - Range proofs and zero-knowledge circuit proof system
π Blockchain Integration
- Chain Oracle Module - NEW! Cosmos blockchain integration for real-time block processing and indexing
- PostgreSQL Persistence - Robust UTXO storage with database backup and recovery
- JSON-RPC API - Complete transaction and UTXO query interface
π Cryptographic Primitives
- Merkle Tree Implementation - Program inclusion proofs and Taproot support (RFC 6962 compliant)
- Multi-signature Support - Advanced signature schemes with
mulmsgsigandstarsig - Address Management - Blockchain address computation and verification utilities
- Range Proofs - Bulletproofs for value bound verification
π§ Infrastructure & DevOps
π³ Containerization
- Docker Support - Complete containerized deployment with multi-stage builds
- Environment Configuration - Comprehensive
.envtemplate with all necessary variables - Port Management - Exposed ports 3030 (API) and 2500 (telemetry)
π οΈ Developer Experience
- Comprehensive Documentation - API docs, specifications, and quickstart guides added across all crates
- Improved Error Handling - Better error messages and debugging information
- Enhanced Testing - Expanded test coverage with edge case handling
- CI/CD Pipeline - Automated linting, testing, and release workflows
π Improvements
- Validator Wallet Integration - Added
nyks-walletdependency for validator operations - Enhanced UTXO Management - Improved address-to-UTXO mapping with RwLock optimization
- Better Block Processing - More reliable chain oracle with improved error handling
- Environment Variable Support - Configurable file paths and service endpoints
- Thread Pool Optimization - Better concurrency for transaction processing
π Bug Fixes
- Null Handling - Fixed deserialization issues for Genesis block (height 1)
- Memory Management - Resolved unwrap panics in block type processing
- Configuration Loading - Fixed environment variable loading and defaults
- Database Connections - Improved PostgreSQL connection reliability
- Build Issues - Resolved compilation warnings and dependency conflicts
π¦ Components Included
| Component | Description |
|---|---|
zkvm |
Zero-knowledge virtual machine and transaction verification |
transaction |
Data structures and proofs for confidential transactions |
utxo-in-memory |
UTXO store with PostgreSQL persistence |
transactionapi |
JSON-RPC API server for blockchain interaction |
chain-oracle |
NEW! Cosmos blockchain integration module |
address |
Address format utilities for the network |
merkle |
Merkle tree operations and proof generation |
rangeproof |
Bulletproofs range proof system |
mulmsgsig |
Multi-message signature schemes |
starsig |
Star signature cryptographic primitives |
readerwriter |
Encoding/decoding utilities for blockchain data |
π Getting Started
Prerequisites
- Rust 1.87 or newer
- PostgreSQL for UTXO persistence
- Access to a Cosmos-based blockchain
- ProtoBuf compiler for validator wallet
Quick Installation
# Clone the repository
git clone -b v0.1.0 https://github.com/twilight-project/zkos-rust.git
cd zkos-rust
# Build the workspace
cargo build --release
# Run tests
cargo test --workspaceRunning Your First Node
# Start the UTXO store and chain oracle
cargo run -p api_serverπ Documentation
- π Architecture Overview
- π Quick Start Guide
- π§ Configuration Reference
- π Full Changelog
- π‘οΈ Security Policy
π What's Next?
This is just the beginning! Our roadmap includes:
- Production-ready security audits
- Advanced privacy features
- Enhanced smart contract capabilities
- Interoperability with other blockchain networks
- Performance optimizations and scalability improvements