The official multi-GPU proving service implementation for SP1, designed for the cloud and bare metal deployment.

Overview

This project implements a high performance SP1 proving cluster that can scale to thousands of GPUs. The system consists of several key components:

• API: REST API for interfacing with the cluster backed by Postgres
• Coordinator: Central service that manages task and worker coordination
• CPU/GPU Node: Distributed worker nodes that execute proof generation tasks
• Fulfiller: Service that syncs the cluster API with assigned proofs from the SP1 Prover Network
• Bidder: Service that bids on proofs from the SP1 Prover Network
• Artifact Store: Redis or S3 store used for storing ephemeral proving data

For detailed information on the architecture and deployment instructions, see the docs.

Development

To get started, you will need to have the following installed:

• Rust
• SP1

git clone https://github.com/succinctlabs/sp1-cluster.git
cd cluster

# Build
cargo build --release

Deploying

To deploy to a Kubernetes cluster, you can use the provided Helm chart in the infra/charts/sp1-cluster directory.

cd infra/charts/sp1-cluster
cp values-example.yaml values-testnet.yaml

Edit the values-testnet.yaml file to configure your cluster.

helm install sp1-cluster . -f values-testnet.yaml