Introduction
Welcome to the official StyxPay documentation. This repository contains comprehensive documentation for the StyxPay platform - the leading authorization-based onchain neobank.
📚 Documentation Sections
New to StyxPay? Start here!
Quick guides to get you up and running with development.
Quick Start Guide - Installation and setup (~15 min)
Project Overview - Architecture and concepts (~30 min)
Perfect for: New developers, product managers, designers
Deep technical implementation details.
Comprehensive guides on cryptography, blockchain, and architecture.
Frontend Architecture - Next.js implementation (~45 min)
ZK Proof System - Zero-knowledge proofs (~90 min)
Transaction Settlement - Solana settlement (~60 min)
Solana Program Architecture - Smart contracts (~75 min)
Perfect for: Blockchain developers, cryptography researchers, senior engineers
Quick reference for components and APIs.
Practical guides for day-to-day development.
Components Guide - UI components and styling (~40 min)
API Reference - Backend APIs and SDKs (~50 min)
Perfect for: Frontend developers, backend developers, integrators
⚙️ Operations
Deployment and contribution guides.
Everything you need for production and open source contributions.
Deployment Guide - Production deployment (~60 min)
Contributing Guide - How to contribute (~30 min)
Perfect for: DevOps engineers, contributors, maintainers
🎯 Recommended Learning Paths
Path 1: Frontend Developer
Getting Started → Understand the basics
Frontend Architecture → Learn implementation
Components Guide → Build interfaces
Total time: ~2 hours
Path 2: Blockchain Developer
Project Overview → Understand the system
Solana Program Architecture → Learn smart contracts
ZK Proof System → Master cryptography
Total time: ~3.5 hours
Path 3: Full-Stack Understanding
Complete all sections in order for comprehensive understanding.
Total time: ~8 hours
🚀 Quick Start
Visit http://localhost:3000
🔗 Quick Links
Live Demo: styxpay.app/demo
Main Website: styxpay.app
GitHub: github.com/styxpay/styxpay
📖 About StyxPay
StyxPay is an enterprise-grade onchain neobank with programmable security, built on Solana. We provide authorization-based banking infrastructure that gives users complete control over their digital assets.
Key Features
Authorization-Based Security - Pull-based payment model with cryptographic signatures
Zero-Knowledge Privacy - ZK-SNARK proofs keep transactions private
Virtual Cards - Create instant virtual cards for spending anywhere
Programmable Logic - Define custom spending rules and authorization policies
Instant Settlement - Sub-second transaction finality on Solana
🛠️ Tech Stack
Frontend
Framework: Next.js 15 (App Router)
Language: TypeScript
Styling: Tailwind CSS
UI Components: shadcn/ui, Lucide Icons
Fonts: Inter (body), Space Grotesk (display)
Blockchain
Network: Solana (Mainnet)
Smart Contracts: Anchor Framework
ZK Proofs: Groth16 (BN254 curve)
Hash Function: Poseidon
Commitments: Pedersen
Cryptography
Proof System: Groth16 ZK-SNARKs
Curve: BN254 (128-bit security)
Hash: Poseidon (ZK-friendly)
Commitments: Pedersen
Merkle Trees: Sparse Merkle Trees (depth 20)
📝 Documentation Structure
🔒 Security
StyxPay implements multiple layers of security:
Zero-Knowledge Proofs: Transactions are verified without revealing amounts or parties
Authorization Logic: Programmable spending rules prevent unauthorized transactions
Nullifier Tracking: Prevents double-spending attacks
Merkle Trees: Efficient state commitment and verification
Solana Security: Leverages Solana's security model and finality
Cryptographic Guarantees
Privacy: Transaction details remain confidential
Integrity: Cannot forge valid proofs
Non-repudiation: Transactions are cryptographically signed
Finality: Irreversible after ~30 seconds
📊 Performance Metrics
Transaction Processing
Proving Time: 52.3ms per transaction
Verification Time: 2.1ms on-chain
Throughput: 476 tx/sec (single validator)
Latency: < 240ms end-to-end
On-Chain Efficiency
Proof Size: 128 bytes
Gas Cost: ~50,000 CU
Account Size: 512 bytes (user account)
Tree Depth: 20 (supports 1M accounts)
🧪 Testing
Coverage
Unit tests for all cryptographic primitives
Integration tests for settlement flow
End-to-end tests for user journeys
Fuzzing for edge cases
Audit Status
Smart contract audit: Pending
ZK circuit audit: Pending
Frontend security review: Pending
🆘 Support
Documentation Feedback
Found an error? Have a suggestion? Open an issue
Technical Support
General
Development
Cryptography
Blockchain
Security
Community
Discord: Join server
Twitter: @styxpay
📈 Version History
v1.0.0 (Current) - January 2026
✅ Initial documentation release
✅ Complete technical architecture
✅ ZK proof system documentation
✅ Transaction settlement guide
✅ Solana program architecture
✅ Organized section structure with navigation
📄 License
Proprietary - All rights reserved © 2025 StyxPay
Last Updated: January 2026 | Documentation Version: 1.0.0 | Platform Version: 1.0.0 (Private Beta)
Last updated