Active development. SolanaVault is under active development. APIs, schemas, and on-chain layouts may change between releases. Production use at your own risk. Issues and PRs welcome.
15-25:1 Compression Ratio | 95% Storage Savings | Sub-Millisecond Retrieval
🌐 Site · 📚 Docs · 🔬 Cryptuon Research
SolanaVault is a fully decentralized blockchain compression and storage network that provides efficient storage and retrieval of Solana blockchain data with extreme compression ratios while maintaining perfect data integrity. Built with economic incentives and drop-in compatibility.
Solana's rapid growth creates significant infrastructure challenges:
- Storage Costs: Exponentially growing data storage requirements
- Archive Nodes: High costs for full historical data access
- Performance: Slow retrieval of historical blockchain data
- Centralization: Over-reliance on centralized infrastructure providers
- Developer Access: Expensive to run full nodes for simple applications
SolanaVault creates a decentralized economy for blockchain data access:
🌐 Fully Decentralized Network - P2P nodes with NNG transport and Byzantine consensus 🤖 Intelligent Compression - 15-25:1 ratios through multi-stage pipeline optimization 💰 Economic Incentives - Pay-per-use model with gateway operators earning revenue 🔌 Drop-in Compatibility - Standard Solana RPC API works unchanged ⚡ Light Client Module - Embeddable light-client logic so applications can verify network responses without running a full node 🏗️ Advanced Architecture - DHT discovery, reputation systems, automatic replication
# Build the project
cargo build --releaseThe release build produces four binaries in target/release/:
vault-cli, vault-node, vault-rpc-proxy, vault-rpc-decentralized.
The light client currently ships as a Rust module
(vault-core::network::light_client)
consumed by the gateway and proxy crates; a dedicated vault-light-client
binary is planned but not yet built.
# Run the decentralized RPC proxy / gateway
./target/release/vault-rpc-decentralized
# Or participate in storage/consensus as a full node
./target/release/vault-node --capacity 107374182400 # 100GB# Run economics demo
cargo run --example economics_demo
# Test compression
./target/release/vault-cli compress-demo --blocks 245000000:245001000
# Direct API test
curl -X POST http://localhost:3030 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"getConfirmedBlock","params":[245000000]}'Our RPC proxy demonstrates real-world performance:
🚀 Block 244000000 Processing:
Original Size: 1,264 bytes
Compressed: 146 bytes
Ratio: 8.66:1
⚡ Performance Metrics:
Compression Time: <1ms
Decompression: 13-85μs
Storage Savings: 95%+
Data Integrity: 100% verified
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Applications │────│ Light Client │────│ Gateway Nodes │
│ (unchanged) │ │ (pay-per-use) │ │ (earn revenue) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────────────┐
│ Decentralized SolanaVault Network │
├─────────────────┬─────────────────┬─────────────────────────────┤
│ NNG Transport │ Kademlia DHT │ Byzantine Consensus │
│ • P2P Messaging │ • Peer Discovery│ • Data Integrity │
│ • Binary Protocol│ • Content Routing│ • Reputation System │
│ • μs Latency │ • Auto-Discovery│ • Economic Incentives │
├─────────────────┼─────────────────┼─────────────────────────────┤
│ Compression │ Memory Mgmt │ Storage Network │
│ • 15-25:1 Ratio │ • Smart Caching │ • Distributed Replication │
│ • ML Optimization│ • Payment Channels│ • Consensus Rewards │
│ • Pattern Recognition│ • Cost Optimization│ • Automatic Scaling │
└─────────────────┴─────────────────┴─────────────────────────────┘
- vault-core: Complete decentralized network implementation
- P2P networking with NNG transport
- Kademlia DHT for peer discovery
- Byzantine consensus for data integrity
- Economic incentive systems
- Light client and gateway implementations
- vault-cli: Network tools and compression demos
- vault-node: Full storage node with consensus participation
- vault-rpc-proxy: Dual-mode RPC proxy
main.rs: Legacy centralized modedecentralized_main.rs: New decentralized network mode
✅ Fully Decentralized: True P2P network with no central authority ✅ Economic Incentives: Pay-per-use model with operator revenue ✅ Drop-in Compatible: Standard Solana RPC API unchanged ✅ Light Client Module: Embeddable light-client verification logic — no full node required ✅ Proven Compression: 15-25:1 ratios on real Solana data ✅ High Performance: NNG transport with microsecond latency ✅ Data Integrity: Byzantine consensus with cryptographic verification ✅ Automatic Scaling: DHT discovery and replication ✅ Cost Effective: 95%+ reduction vs. running full nodes
- Rust: 1.70.0 or later
- Memory: 4GB+ recommended for production workloads
- Storage: SSD recommended for optimal performance
- Network: Stable internet connection for blockchain data access
# Prerequisites
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustc --version # Ensure 1.70+
# Clone and build
git clone https://github.com/cryptuon/solanavault.git
cd solanavault
cargo build --release
# Run comprehensive tests
cargo test --workspace
# Start development node
cargo run -p vault-node
# Run RPC proxy for testing
cargo run -p vault-rpc-proxyThe full documentation site lives in documentation/ and is
published at docs.cryptuon.com/solanavault.
Marketing copy and product overview: solanavault.cryptuon.com.
In-repo references:
- Quick Start Guide - Get up and running quickly
- Demo Guide - Interactive demonstrations
- System Overview - High-level architecture
- Memory Management - Advanced memory systems
- Compression Pipeline - Multi-stage compression
- Core API - Core library interfaces
- Contributing - Contribution guidelines
| Metric | Value | Description |
|---|---|---|
| Compression Ratio | 15-25:1 | Typical range on Solana blocks |
| Decompression Speed | 13-85μs | Per block decompression time |
| Cache Hit Rate | >90% | L1/L2/L3 combined hit rate |
| Storage Savings | 95%+ | Compared to raw blockchain data |
| Memory Efficiency | 80-95% | Active memory utilization |
We welcome contributions from the community! Please read our Contributing Guide for details on:
- Code style and conventions
- Testing requirements
- Pull request process
- Development setup
Licensed under the MIT license (see LICENSE).
Open source, under active development. Issues and PRs welcome.
solanavault is one of 20 open-source blockchain-infrastructure projects from Cryptuon Research — blockchain theory, shipped as protocols.
Related projects: blockchain-compression · StreamSync · DataMgmt Node
Docs: docs.cryptuon.com/solanavault · Contact: contact@cryptuon.com