ProofSight Developer Docs
Build privacy-preserving prediction markets with zero-knowledge proofs on Solana
Status: Pre-Alpha Implementation
The ProofSight protocol is in active development. Core circuits with complete constraint logic, SDK with real cryptographic implementations (circomlib), comprehensive test suites, and research foundations are implemented and available on GitHub. CI/CD pipelines ensure code quality. Package names, method signatures, and costs are subject to change as implementation progresses. This documentation represents the current API design and architecture.
Getting Started
Installation
The ProofSight SDK source code is available on GitHub. Clone the repository to get started:
git clone https://github.com/ProofSightTeam/proofsight-protocol.gitThe SDK source code is available on GitHub. The package is configured as @proofsight/sdk but is currently in pre-alpha. You can use the source code directly from the repository or install locally.
cd sdk && npm installThe repository contains three main components:
/circuits- Zero-knowledge proof circuits (Circom)/sdk- TypeScript SDK with Merkle tree and crypto primitives/research- Formal proofs and privacy simulations
Quick Start
Once released, you will initialize the SDK with your Solana wallet connection:
import { ProofSightSDK } from '@proofsight/sdk';
import { Connection, Wallet } from '@solana/web3.js';
const connection = new Connection('https://api.mainnet-beta.solana.com');
const wallet = new Wallet(/* your wallet */);
const sdk = new ProofSightSDK({
connection,
wallet,
network: 'mainnet-beta'
});
// Initialize the SDK
await sdk.initialize();Prerequisites
- Node.js 18+ or Bun runtime
- Solana wallet (Phantom, Solflare, or programmatic wallet)
- Basic understanding of Solana development
Architecture Overview
ProofSight separates market transparency from position privacy through a three-layer architecture:
Layer 1: Privacy
Shielded pools build anonymity sets. Deposits are mixed and positions are represented as cryptographic commitments in Merkle trees.
Layer 2: Markets
Solana programs manage market state, odds calculation, and transaction batching. All market metrics remain public and verifiable.
Layer 3: Settlement
ZK-proofs enable anonymous claims. Traders prove winning positions without revealing identity, size, or history.
SDK & API Reference
The ProofSight SDK provides a complete interface for building privacy-preserving prediction market applications.
Core Methods
deposit(amount: number)
Deposit funds into the shielded pool to create an anonymous balance.
await sdk.deposit(1000);createPosition(marketId: string, outcome: number, amount: number)
Create a private position in a prediction market.
await sdk.createPosition('market-123', 1, 500);claim(positionId: string)
Claim winnings using zero-knowledge proof of position ownership.
await sdk.claim('position-456');Need Help?
Join our community or check out the GitHub repository for more resources