Quick Start

Get Paraloom up and running on your local machine.

Prerequisites

Before you begin, ensure you have:

• Rust 1.70+ - Install Rust
• Solana CLI 1.16+ - Install Solana
• 4GB RAM minimum
• 10GB disk space

Installation

1. Clone the Repository

git clone https://github.com/paraloom-labs/paraloom-core.git
cd paraloom-core

2. Build Everything

# Build Rust components
cargo build --release

# Build Solana program
cargo build-sbf

3. Run Tests

# Run all tests
cargo test --all --all-targets

# With output
cargo test --all --all-targets -- --nocapture

Local Testing (5 Validators)

solana-test-validator

./scripts/localnet/start-all.sh

./scripts/localnet/test-privacy-e2e.sh

./scripts/localnet/stop-all.sh

Compute Layer Demo

Run the distributed compute demonstration:

cargo run --bin compute-demo

This shows:

• 3 validators registering with different capacities
• 7 jobs submitted and load-balanced
• Job assignment and execution
• Result aggregation

Private Compute Example

cargo run --example private_compute_demo

Output demonstrates:

• Private job creation with encrypted input
• Input commitment generation
• Submission to shielded pool
• Multi-validator execution (2/3 consensus)
• zkSNARK proof generation
• Result verification and finalization
• Encrypted output retrieval

Devnet Testing

# Configure Solana CLI
solana config set --url devnet

# Start validators connected to devnet
./scripts/devnet/start-all.sh

# View logs
tail -f logs/devnet/validator1.log

# Stop validators
./scripts/devnet/stop-all.sh

Next Steps

• Architecture Overview - Understand the system design
• Privacy Layer - Learn about zkSNARK implementation
• Validator Guide - Run your own validator node