nyx-privacy 0.1.0

Privacy SDK for Solana with optional x402 payment support - Python interface with Rust cryptographic backbone

Nyx Privacy

The Dark Layer for the Agentic Web.

Nyx Privacy is the production-ready privacy infrastructure for Solana, engineered specifically for Python developers and AI agents. By combining a high-level Python SDK with a high-performance Rust cryptographic core, Nyx Privacy solves the "transparency paradox" by enabling fully shielded transactions, private transfers, and chain-agnostic micropayments (x402) without sacrificing the speed required for modern DeFi or the usability required for autonomous agents.

The Trinity (Core Features)

1. The Nyx Shield (Privacy Primitives)

Turn public capital into private state. Nyx Privacy uses Pedersen Commitments on the BN254 curve to perfectly hide transaction amounts.

• Information-Theoretic Privacy: Amount data is mathematically impossible to extract without the blinding factor.
• Circuit-Safe Nullifiers: Two-step Poseidon hashing prevents double-spending while keeping your master secret isolated from the circuit.
• Front-Running Protection: A 30-root history buffer ensures your proofs remain valid even during network congestion.

2. Nyx Transfer (ZK-Transactions)

Move value without leaving a trace.

• Groth16 zkSNARKs: Generate proofs in seconds (2-5s) that certify transaction validity without revealing sender, recipient, or amount.
• Encrypted Notes: Uses ECDH and ChaCha20-Poly1305 to allow recipients to discover and decrypt their incoming funds securely.
• Unlinkability: The transaction graph is severed. Observers see a commitment enter and a different one leave, with no link between them.

3. Nyx Pay (x402 Integration)

Chain-agnostic payments for a multi-chain world.

• Gas Abstraction: Pay for privacy services on Solana using USDC on Base, Polygon, Avalanche, or 12+ other networks.
• Agent-Native: Based on the HTTP 402 standard, allowing AI agents to autonomously negotiate and pay for resources.
• Seamless Access: No accounts required. Cryptographically authorized per-request.

Developer Experience (The Stack)

"Python Simplicity. Rust Velocity."

Nyx Privacy utilizes a hybrid architecture to balance developer experience with raw performance.

Layer	Technology	Function
Interface	Python 3.12+	Async/await SDK for easy integration with AI agents and trading bots.
Engine	Rust Core	Native binaries handling heavy cryptography (Poseidon hashing, Proof generation).
Verifier	Anchor (Solana)	On-chain program handling state, Merkle trees, and nullifier tracking.

Quick Start

Installation

pip install nyx-privacy

Basic Usage

from nyx import NyxClient
from solders.keypair import Keypair

# Initialize the Dark Layer
client = NyxClient(rpc_url="https://api.mainnet-beta.solana.com")
user_keypair = Keypair()

# Shield assets (Public -> Private)
# Returns a commitment signature
secret, commitment = client.shield_assets(
    amount=1_000_000_000,  # 1 SOL
    token="SOL",
    keypair=user_keypair
)

# Transfer privately (Private -> Private)
# Proof generation takes <5s via Rust core
tx = await client.private_transfer_async(
    recipient=recipient_address,
    amount=500_000_000,  # 0.5 SOL
    sender_secret=secret,
    sender_commitment=commitment
)

# Unshield assets (Private -> Public)
tx = client.unshield_assets(
    commitment=commitment,
    secret=secret,
    recipient=user_keypair.pubkey()
)

Development

Prerequisites

• Python 3.12+
• Rust 1.70+
• Solana CLI tools
• Anchor Framework (for Solana program)

Building from Source

# Clone the repository
git clone https://github.com/nyxprivacy/nyx-privacy.git
cd nyx-privacy

# Install all packages in development mode
make install-dev

# Run tests
make test

# Build all packages
make build

Roadmap (The Path Forward)

• Phase 1: Foundation (Current)
  • Python SDK & Rust Core released.
  • Groth16 Circuits (~7,000 constraints) live on Devnet.
  • x402 Payment integration active on 15+ chains.
• Phase 2: The Network (v0.2.0)
  • Public Nyx Relayer Network launch.
  • Self-hosting infrastructure for relayers.
• Phase 3: Decentralization
  • Trusted Setup Ceremony (MPC) for production parameters.
  • Mainnet Launch.
• Phase 4: Expansion (2026)
  • Full Gas Abstraction (Pay all Solana fees with USDC).
  • Multi-asset support beyond SOL.

Nyx Security Architecture

• Curve: BN254 (alt_bn128).
• Hash: Poseidon (t=3, RF=8, RP=57).
• Proof System: Groth16 (256-byte proofs).
• Encryption: ChaCha20-Poly1305 + ECDH.
• Tree Depth: 20 levels (~1M leaves).
• Audit Status: MPC Ceremony Pending.

Documentation

• Getting Started: nyxprivacy.tech/docs/getting-started/overview
• API Reference: nyxprivacy.tech/docs/api
• Architecture: docs/ARCHITECTURE.md

Supported Networks (x402)

Nyx Privacy x402 integration supports payments on 15+ blockchains:

Mainnets: Base, Polygon, Avalanche, Solana, IoTeX, Peaq, Sei, XLayer Testnets: Base Sepolia, Polygon Amoy, Avalanche Fuji, Solana Devnet, and more

See x402 networks documentation for full list.

License

MIT License - see LICENSE for details

Contributing

Contributions welcome! Please see our contributing guidelines.

---

Nyx Privacy - The Dark Layer for the Agentic Web. Privacy for the Machine Economy.