synor/docs/PLAN
Gulshan Yadav f56a6f5088 feat(wallet): add OS keychain integration with biometric unlock
Add cross-platform keychain support using the keyring crate for secure
credential storage with biometric authentication (TouchID on macOS,
Windows Hello on Windows, Secret Service on Linux).

- Add keychain module with enable/disable biometric unlock
- Add Tauri commands for keychain operations
- Add Keychain error variant for proper error handling
- Add Java SDK foundation
- Update milestone docs to reflect 95% completion
2026-01-11 17:31:21 +05:30
..
PHASE0-Foundation Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE1-NodeIntegration Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE2-CLIWallet Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE3-NetworkBootstrap Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE4-SmartContracts Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE5-Governance Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE6-QualityAssurance Initial commit: Synor blockchain monorepo 2026-01-08 05:22:17 +05:30
PHASE7-ProductionReadiness feat(wallet): add OS keychain integration with biometric unlock 2026-01-11 17:31:21 +05:30
PHASE9-SynorHosting feat(cli): add deploy command for Synor Hosting 2026-01-10 12:59:35 +05:30
PHASE10-Database-Advanced.md feat(database): add SQL, Graph, and Raft Replication modules 2026-01-10 19:32:14 +05:30
PHASE11-Synor-Compute-L2-Part2-HyperEfficiency.md feat(compute): add Phase 11 Synor Compute L2 heterogeneous compute layer 2026-01-11 13:53:57 +05:30
PHASE11-Synor-Compute-L2-Part3-HeterogeneousCompute.md feat(compute): add Phase 11 Synor Compute L2 heterogeneous compute layer 2026-01-11 13:53:57 +05:30
PHASE11-Synor-Compute-L2.md feat(compute): add Phase 11 Synor Compute L2 heterogeneous compute layer 2026-01-11 13:53:57 +05:30
README.md feat(database): complete Phase 10 Database Gateway 2026-01-10 18:11:13 +05:30
VALIDATION_REPORT.md feat: add synor.cc landing page and zero-cost deployment plan 2026-01-10 09:26:21 +05:30

Synor Development Plan

Structured milestone documentation for the Synor quantum-secure blockchain

Phase Overview

Phase Name Status Progress Milestones
0 Foundation Complete 100% 2
1 Node Integration Complete 100% 2
2 CLI Wallet Complete 100% 2
3 Network Bootstrap Complete 100% 2
4 Smart Contracts Complete 100% 2
5 Governance Complete 100% 2
6 Quality Assurance Complete 100% 3
7 Production Readiness 🔄 In Progress 85% 3
8 Synor Storage L2 Complete 100% 3
9 Synor Hosting Complete 100% 3
10 Synor Database L2 Complete 100% 3
11 Economics & Billing Planned 0% 3
12 Fiat Gateway Planned 0% 2

Phase 7 Breakdown

Milestone Status Progress
Security Audit Pending Requires external
Mainnet Launch 🔒 Blocked Awaiting 30-day testnet
Ecosystem 🔄 In Progress 85%

Ecosystem Components (Milestone 3)

Component Status Notes
Web Wallet 95% QR, hardware, i18n complete
Desktop Wallet 90% System tray, auto-updates done
Mobile Wallet 0% Deferred to post-mainnet
Explorer Frontend 100% Full React app deployed
Documentation 90% 4 tutorials + exchange guide
API Gateway 95% Rate limiting operational
Exchange Integration 80% Comprehensive docs ready

Phase 8 Breakdown (Synor Storage L2)

Milestone Status Progress
Storage Core Complete 100%
Storage Node Complete 100%
Storage Gateway Complete 100%

Storage Components

Component Status Notes
Content Addressing (CID) 100% Blake3/SHA256 synor1... format
Chunker 100% Content-defined chunking
Erasure Coding 100% Reed-Solomon 10+4
Storage Proofs 100% Merkle proof verification
Deal Management 100% On-chain deal lifecycle
Storage Node 100% P2P storage service
HTTP Gateway 100% Content retrieval API
Docker Deployment 100% 3-node cluster config

Phase 9 Breakdown (Synor Hosting)

Milestone Status Progress
Hosting Core Complete 100%
Hosting Gateway Complete 100%
Hosting CLI Complete 100%

Hosting Components

Component Status Notes
Name Registry 100% On-chain name→CID mapping
Domain Verification 100% CNAME/TXT DNS verification
Hosting Router 100% Host-based request routing
synor.json Config 100% SPA, redirects, headers
Hosting Gateway 100% Axum HTTP server
Rate Limiting 100% Token bucket algorithm
Cache Control 100% Immutable assets, SPA support
Docker Deployment 100% Caddy + wildcard HTTPS
CLI Deploy Command 100% synor deploy push/init/list/delete
Admin Dashboard 0% Web UI for management (deferred)

Phase 10 Breakdown (Synor Database L2)

Milestone Status Progress
Database Core Complete 100%
Query Layer Complete 100%
Database Gateway Complete 100%

Database Components

Component Status Notes
Key-Value Store 100% Redis-compatible API (TTL, INCR, MGET)
Document Store 100% MongoDB-compatible queries & filters
Vector Store 100% AI/RAG optimized, cosine/euclidean/dot
Time-Series 100% Metrics, downsampling, aggregations
Query Engine 100% Unified document + vector queries
Schema Validator 100% Field types, required, strict mode
Indexing 100% B-tree, hash, unique indexes
Database Pricing 100% Pay-per-use cost calculator
Relational (SQL) 0% SQLite-compatible subset (deferred)
Graph Store 0% Relationship queries (deferred)
Replication 0% Raft consensus (deferred)
Gateway HTTP API 100% REST API with auth, rate limiting

Database Pricing Model

Tier Storage/GB/month Queries/million Vectors/million
Free 0.5 GB 1M 100K
Standard 0.1 SYNOR 0.01 SYNOR 0.05 SYNOR
Premium 0.2 SYNOR 0.005 SYNOR 0.02 SYNOR
Enterprise Custom Custom Custom

Phase 11 Breakdown (Economics & Billing)

Milestone Status Progress
Pricing Oracle Planned 0%
Metering Service Planned 0%
Billing Engine Planned 0%

Economics Components

Component Status Notes
Pricing Oracle 0% SYNOR/USD price feeds
Usage Metering 0% Real-time resource tracking
Billing Engine 0% Invoice generation, payments
Cost Calculator 0% CLI synor cost estimate
SLA Enforcement 0% Smart contract guarantees
Staking Rewards 0% Node operator incentives

Fee Distribution Model

Transaction Fees:
├── 10% → Burn (deflationary)
├── 60% → Stakers (rewards)
├── 20% → Community Pool (treasury)
└── 10% → Miners/Validators

L2 Service Fees (Storage, Hosting, Database):
├── 70% → Node Operators
├── 20% → Protocol Treasury
└── 10% → Burn

Phase 12 Breakdown (Fiat Gateway)

Milestone Status Progress
On-Ramp Integration Planned 0%
Off-Ramp Integration Planned 0%

Fiat Gateway Components

Component Status Notes
Ramp Network SDK 0% Primary on-ramp provider
Off-Ramp Service 0% SYNOR → Fiat conversion
Swap Aggregator 0% Cross-chain token swaps
Payment Widget 0% Embeddable checkout

Ramp Network Integration

Reference: https://rampnetwork.com/

Planned Features:

Feature Description Priority
Buy SYNOR Credit/debit card purchases 🔴 Critical
Sell SYNOR Fiat withdrawals to bank 🔴 Critical
Apple Pay/Google Pay Mobile wallet support 🟡 High
Bank Transfer (SEPA/ACH) Lower fee option 🟡 High
Recurring Purchases DCA functionality 🟢 Medium
NFT Checkout Direct NFT purchases 🟢 Medium
B2B API Enterprise integrations 🟢 Medium

Coverage:

  • 150+ countries supported
  • 40+ fiat currencies
  • 90+ cryptocurrencies (add SYNOR)
  • KYC/AML compliant

Integration Endpoints:

POST /api/v1/onramp/quote    - Get purchase quote
POST /api/v1/onramp/buy      - Initiate purchase
POST /api/v1/offramp/sell    - Sell SYNOR for fiat
GET  /api/v1/rates           - Current exchange rates
POST /api/v1/swap            - Cross-chain swap

Directory Structure

docs/PLAN/
├── README.md (this file)
├── PHASE0-Foundation/
│   ├── 01-Milestone-01-CoreTypes.md
│   └── 01-Milestone-02-Cryptography.md
├── PHASE1-NodeIntegration/
│   ├── 01-Milestone-01-ServiceWiring.md
│   └── 01-Milestone-02-GenesisChain.md
├── PHASE2-CLIWallet/
│   ├── 01-Milestone-01-WalletCrypto.md
│   └── 01-Milestone-02-CLICommands.md
├── PHASE3-NetworkBootstrap/
│   ├── 01-Milestone-01-TestnetDeployment.md
│   └── 01-Milestone-02-NetworkHardening.md
├── PHASE4-SmartContracts/
│   ├── 01-Milestone-01-ContractSDK.md
│   └── 01-Milestone-02-ContractTooling.md
├── PHASE5-Governance/
│   ├── 01-Milestone-01-DAOLaunch.md
│   └── 01-Milestone-02-GovernanceFeatures.md
├── PHASE6-QualityAssurance/
│   ├── 01-Milestone-01-Benchmarks.md
│   ├── 01-Milestone-02-Testing.md
│   └── 01-Milestone-03-Optimization.md
├── PHASE7-ProductionReadiness/
│   ├── 01-Milestone-01-Security.md
│   ├── 01-Milestone-02-MainnetLaunch.md
│   └── 01-Milestone-03-Ecosystem.md
├── PHASE8-SynorStorageL2/
│   ├── 01-Milestone-01-StorageCore.md
│   ├── 01-Milestone-02-StorageNode.md
│   └── 01-Milestone-03-StorageGateway.md
├── PHASE9-SynorHosting/
│   ├── 01-Milestone-01-HostingCore.md
│   ├── 01-Milestone-02-HostingGateway.md
│   └── 01-Milestone-03-HostingCLI.md
├── PHASE10-SynorDatabaseL2/
│   ├── 01-Milestone-01-DatabaseCore.md
│   ├── 01-Milestone-02-QueryLayer.md
│   └── 01-Milestone-03-DatabaseGateway.md
├── PHASE11-EconomicsBilling/
│   ├── 01-Milestone-01-PricingOracle.md
│   ├── 01-Milestone-02-MeteringService.md
│   └── 01-Milestone-03-BillingEngine.md
├── PHASE12-FiatGateway/
│   ├── 01-Milestone-01-OnRamp.md
│   └── 01-Milestone-02-OffRamp.md

Validation Strategy

Each milestone includes:

  • Tasks: Specific implementation requirements
  • Files: Source files to create/modify
  • Validation Commands: Commands to verify implementation
  • Validation Agents: Automated agents for code review
  • Security Checks: Security-specific validations
  • Compliance: Regulatory compliance requirements

Running Validations

# Run all unit tests
cargo test --workspace

# Run integration tests
cargo test --workspace --test '*'

# Run benchmarks
cargo bench --workspace

# Security audit with cargo-audit
cargo audit

# Code coverage
cargo tarpaulin --workspace --out Html

# Lint with clippy
cargo clippy --workspace -- -D warnings

Agent-Based Validation

Agent Purpose Trigger
code-reviewer Code quality and patterns After milestone completion
silent-failure-hunter Error handling validation After error-related changes
pr-test-analyzer Test coverage analysis Before PR merge
type-design-analyzer Type system validation After type changes

Last updated: January 10, 2026