Active development. This project is under active development. APIs, schemas, and on-chain layouts may change between releases. Production use at your own risk. Issues and PRs welcome.
Unified Cross-Chain State Synchronization Platform
Switchboard enables seamless cross-chain state synchronization, allowing developers to deploy once and sync everywhere. By leveraging Solana's performance and sub-second finality, Switchboard provides real-time verification across all supported chains with sub-400ms coordination latency.
Build Status Coverage License Solana
π Sub-400ms Latency - Real-time cross-chain coordination π 50+ Chain Support - All major EVM and non-EVM networks ποΈ 90% Code Reuse - Deploy once, sync everywhere πΎ Flexible Database - MongoDB or PostgreSQL support π Enterprise Security - Production-ready authentication π Real-time Analytics - Complete observability stack
Switchboard uses a simplified 2-service architecture:
βββββββββββββββββββ ββββββββββββββββββββ
β Customer API ββββββ Core Engine β
β (Port 3000) β β (Port 3001) β
β β β β
β β’ Authenticationβ β β’ Oracle Service β
β β’ API Gateway β β β’ Blockchain Ops β
β β’ Rate Limiting β β β’ Billing Logic β
β β’ Security β β β’ Cross-chain β
β β’ Request Proxy β β Coordination β
βββββββββββββββββββ ββββββββββββββββββββ
- Node.js 18+
- Docker & Docker Compose
- 8GB+ RAM recommended
git clone https://github.com/cryptuon/switchboard.git
cd switchboard
npm installcp .env.example .env
# Edit .env with your configurationWith MongoDB (default):
npm run docker:up
With PostgreSQL:
DATABASE_TYPE=postgresql docker-compose --profile postgres up
# Check Customer API curl http://localhost:3000/health # Check Core Engine curl http://localhost:3001/health # Run integration tests npm run test:integration
Full docs: docs.cryptuon.com/switchboard/ Β· Marketing: switchboard.cryptuon.com
| Topic | Location |
|---|---|
| Architecture | docs/ARCHITECTURE.md |
| Deployment | docs/deployment/ |
| API Reference | docs/examples/ |
| Development | docs/development/ |
| Configuration | .env.example |
# Build all services npm run build # Build specific services npm run build:customer-api npm run build:core-engine
# Start all services in development mode npm run dev # Start specific services npm run dev:customer-api npm run dev:core-engine
# Run all tests npm run test # Run integration tests npm run test:integration # Run performance tests npm run test:performance
EVM Networks: Ethereum, Polygon, Arbitrum, Optimism, BSC, Avalanche, Base, zkSync Era, Polygon zkEVM
L1 Alternatives: Solana (coordinator), NEAR, Cosmos, Terra, Sui, Aptos
Emerging Networks: Celestia, StarkNet, Flow, Celo, Gnosis
- Coordination Latency: <400ms across 50+ chains
- Throughput: 10,000+ coordinated operations/second
- Uptime: 99.9% SLA with automatic failover
- Gas Optimization: 40% reduction in cross-chain fees
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
- π Documentation: docs.cryptuon.com/switchboard/
- π Marketing site: switchboard.cryptuon.com
- π Bug Reports: GitHub Issues
- π¬ Discussions: GitHub Discussions
Built with β€οΈ for the multi-chain future