Introduction
Onyx SDK provides privacy-preserving stealth addresses for Solana. Send and receive SOL without revealing your identity on the blockchain.
What are Stealth Addresses?
A cryptographic technique that allows a sender to create a unique one-time address for each payment, making it impossible for outside observers to link payments to a recipient's public identity.
How It Works
Receiver generates a meta-address
A pair of public keys (spending + viewing) that can be shared publicly.
Sender creates a stealth payment
Uses the meta-address to derive a unique stealth address and ephemeral key.
Payment is sent
SOL is transferred to the stealth address. The ephemeral key is published.
Receiver scans and claims
Using their viewing key, the receiver detects payments and derives the spending key.
Quick Example
use onyx_sdk::{StealthMetaAddress, StealthPayment, StealthKeypair};
// Receiver: Generate and share meta-address
let meta = StealthMetaAddress::generate();
let public_meta = meta.public_meta_address();
println!("Share this: {}", public_meta.to_string());
// Sender: Create stealth payment
let payment = StealthPayment::create(&public_meta, amount).unwrap();
// Transfer SOL to payment.stealth_address
// Publish payment.ephemeral_pubkey
// Receiver: Derive spending keypair
let keypair = StealthKeypair::derive(&meta, &payment.ephemeral_pubkey).unwrap();
// Use keypair to spend from stealth_addressFeatures
- One-time addresses - Each payment uses a unique address
- Unlinkable - Observers cannot connect payments to your identity
- Efficient scanning - On-chain registry for payment detection
- Ed25519 compatible - Works with Solana's native key format