Getting Started

Installation

Add Cloak SDK to your Rust project. Published on crates.io as cloak-sdk.

Requirements

  • Rust 1.70 or later
  • Solana CLI 1.18+ (for on-chain interactions)
  • Anchor 0.30.x (for program deployment)

Add dependency

Using cargo:

Terminal
bash
cargo add cloak-sdk

Or add it manually to your Cargo.toml:

Cargo.toml
toml
[dependencies]
cloak-sdk = "1.0"

What's included

The SDK includes everything you need:

ModuleDescription
keysMeta-address generation, key storage, public sharing
addressStealth address derivation, payment creation
scannerPayment detection, viewing keys, payment history
spendSpending key derivation, Solana keypair conversion
zkGroth16 proofs, Pedersen commitments (BN254)

Verify installation

Create a test to verify everything is working:

tests/verify.rs
rust
use cloak_sdk::StealthMetaAddress;

#[test]
fn test_cloak_sdk() {
    let meta = StealthMetaAddress::generate();
    let public_str = meta.to_public_string();
    assert!(public_str.starts_with("stealth1"));
    println!("Cloak SDK v1.0 installed successfully!");
    println!("Public meta-address: {}", public_str);
}
Terminal
bash
cargo test test_cloak_sdk -- --nocapture

CLI installation

Cloak also provides a CLI for terminal-based operations:

Terminal
bash
# From the cloak-sdk repository
cargo install --path cli

# Verify
cloak --help

The CLI supports all SDK operations including --private (zk-SNARK hidden amounts) and --relayer (sender privacy) modes.