Prerequisites

Prerequisites

Before integrating with Turbine.cash private transfers, ensure you have the following:

Required Dependencies

Node.js / TypeScript

npm install @solana/web3.js @coral-xyz/anchor
npm install [PLACEHOLDER: POSEIDON_NPM_PACKAGE]

Package	Purpose
@solana/web3.js	Solana blockchain interaction
@coral-xyz/anchor	Anchor program client
[PLACEHOLDER: POSEIDON_NPM_PACKAGE]	Poseidon hash function for commitments

Browser Requirements

For browser-based applications:

• Wallet adapter: Use @solana/wallet-adapter-react or similar
• Crypto: Browser-native crypto.getRandomValues() for secure randomness

Solana Knowledge

You should be familiar with:

• Solana transactions and instructions
• PDAs (Program Derived Addresses)
• Token accounts (SPL Token program)
• Anchor IDL and client generation

API Access

The Turbine.cash API requires authentication:

1. Wallet signature: Sign a message with your wallet
2. Auth token: Receive a JWT-like token for subsequent requests
3. Headers: Include the token in x-api-auth header

See Authentication for the full flow.

Local Storage

Your application MUST securely store:

Data	Purpose	Consequences if Lost
nullifier	32-byte random value	Cannot withdraw funds
secret	32-byte random value	Cannot withdraw funds
leafIndex	Position in Merkle tree	Cannot generate proof

Caution

There is NO recovery mechanism. If users lose their secrets, their funds are permanently locked. Your application must:

• Provide clear backup instructions
• Use secure storage (encrypted local storage, secure enclave, etc.)
• Consider backup export functionality

Network Requirements

RPC Endpoints

You’ll interact with:

Service	Purpose
Solana RPC	Sending deposit transactions
Turbine.cash API	Relayer, indexer, authentication

CORS

The Turbine.cash API supports CORS for browser applications. No proxy required.

Development Environment

For local development:

# Clone your project
git clone your-project

# Install dependencies
npm install

# Set environment variables
export SOLANA_NETWORK=devnet
export TURBINE_API_URL=https://worker.turbine.cash

Recommended: TypeScript

We recommend TypeScript for type safety:

interface DepositSecrets {
  nullifier: Uint8Array;  // 32 bytes
  secret: Uint8Array;     // 32 bytes
  commitment: Uint8Array; // 32 bytes
  leafIndex: number;
}

interface WithdrawParams {
  nullifierHash: Uint8Array;
  proof: Uint8Array;
  root: Uint8Array;
  recipient: string;
}

Next Steps

1. Configure Network Settings
2. Implement Authentication
3. Build Your First Deposit