https://github.com/soqucoin/soqucoin
Soqucoin-SOQ: very quantum. much resistance.
https://github.com/soqucoin/soqucoin
binius cryptocurrency dilithium dogecoin-fork merkel post-quantum-cryptography sangria scrypt-algorithm
Last synced: 11 days ago
JSON representation
Soqucoin-SOQ: very quantum. much resistance.
- Host: GitHub
- URL: https://github.com/soqucoin/soqucoin
- Owner: soqucoin
- License: mit
- Created: 2025-11-18T23:01:52.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-05-31T00:09:11.000Z (15 days ago)
- Last Synced: 2026-05-31T02:03:13.238Z (15 days ago)
- Topics: binius, cryptocurrency, dilithium, dogecoin-fork, merkel, post-quantum-cryptography, sangria, scrypt-algorithm
- Language: C++
- Homepage: https://soqu.org/
- Size: 177 MB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: COPYING
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
Soqucoin™ Core
The first production cryptocurrency with native post-quantum signatures and confidential transactions
About •
Features •
Quick Start •
Documentation •
Contributing •
License
---
## About
Soqucoin is a Scrypt-based proof-of-work cryptocurrency that removes ECDSA from the transaction authorization path and uses **NIST-standardized ML-DSA-44 (Dilithium)** signatures. It combines two batch-verification techniques—**PAT** (Practical Aggregation Technique) and **LatticeFold+**—to achieve scalable post-quantum security without sacrificing performance.
> **Why does this matter?** Quantum computers will eventually break ECDSA. Soqucoin makes all user transaction signatures quantum-resistant without requiring a soft-fork migration from an ECDSA-based design.
### Current Status
| Milestone | Status | Date |
|-----------|--------|------|
| Consensus code merged | ✅ Complete | Nov 20, 2025 |
| ASIC validation (L7) | ✅ Complete | Nov 24, 2025 |
| Testnet3 launch | ✅ Complete | Dec 2025 |
| Stability testing (1200+ blocks) | ✅ Complete | Jan 2, 2026 |
| Halborn security audit (30 findings) | ✅ Complete | Feb–Mar 2026 |
| Lattice-BP++ consensus wired | ✅ Complete | Apr 2026 |
| Mainnet genesis | 🔄 In Progress | Q2 2026 |
---
## Features
### Post-Quantum Cryptography
| Component | Implementation | Security Level |
|-----------|---------------|----------------|
| **Signatures** | ML-DSA-44 (Dilithium) | NIST Level 2 (128-bit quantum) |
| **Address Hashing** | SHA-256 | 128-bit collision |
| **Batch Verification** | LatticeFold+ / PAT | Constant-size proofs |
| **Proof-of-Work** | Scrypt (N=1024, r=1, p=1) | Grover-resistant |
### Confidential Transactions (Lattice-BP++)
| Component | Implementation | Security Level |
|-----------|---------------|----------------|
| **Commitments** | Lattice (Module-LWE, n=256, q=8380417) | NIST Level 2 (quantum-safe) |
| **Range Proofs** | Lattice-BP++ | NIST Level 2 (quantum-safe) |
| **Ring Signatures** | Module-LWE ring sigs (up to size 11) | NIST Level 2 (quantum-safe) |
| **Proof Size** | 12,321 bytes | — |
| **Verify Time** | 0.022 ms | Apple M-series arm64 |
> **Note:** Lattice-BP++ uses the same Module-LWE/SIS hardness assumptions as NIST's ML-DSA (Dilithium) standard, providing full quantum resistance. Activated via `OP_LATTICEBP_RANGEPROOF` (witness v4) soft fork. Patent pending.
### Performance Benchmarks
```
┌─────────────────────────────────┬────────────────┬─────────────┐
│ Operation │ Time (M4) │ Size │
├─────────────────────────────────┼────────────────┼─────────────┤
│ Dilithium Sign │ 0.177 ms │ 2,420 bytes │
│ Dilithium Verify │ 0.041 ms │ — │
│ PAT Aggregate (1000 sigs) │ 0.67 ms │ 72 bytes │
│ LatticeFold+ Verify (512 sigs) │ 0.68 ms │ 1.38 KB │
│ Lattice-BP++ Prove │ 0.556 ms │ 12.3 KB │
│ Lattice-BP++ Verify │ 0.022 ms │ — │
└─────────────────────────────────┴────────────────┴─────────────┘
```
### ASIC Compatibility
Validated on **Antminer L7** (9.5 GH/s):
- Standard Stratum V1 protocol
- Zero firmware modifications
- Zero rejected shares (cleaner than Litecoinpool/Powerpool)
- 640+ blocks continuous operation, zero crashes
### PAT (Practical Aggregation Technique)
**Status**: ✅ Fully Implemented (v1.0) — November 2025
Soqucoin implements PAT for logarithmic batching of Dilithium signatures through Merkle tree commitments. This provides massive space savings for batch transaction validation.
#### Implementation Details
| Component | Status | File |
|-----------|--------|------|
| Proof Generation | ✅ Complete | `src/crypto/pat/logarithmic.cpp` |
| Proof Verification | ✅ Complete | `CreateLogarithmicProof()` |
| Simple Mode Verification | ✅ Production | `VerifyLogarithmicProof()` |
| Full Mode Verification | ✅ Infrastructure Ready | Full witness validation |
| Consensus Opcode | ✅ Active | `OP_CHECKPATAGG` (0xfd) |
| Unit Tests | ✅ 17/17 Passing | `test/pat_tests.cpp` |
| Integration Tests | ✅ Complete | `test/pat_script_tests.cpp` |
#### Verification Guarantees
- ✅ **Merkle Root Binding**: Prevents proof forgery and signature omission
- ✅ **Hash Aggregation (SHA3-256)**: Prevents rogue-key substitution attacks
- ✅ **Message Commitment**: Prevents message tampering or reordering
- ✅ **Non-Malleability**: Canonical ordering ensures unique proofs
#### Performance Metrics
| Metric | Value | Notes |
|--------|-------|-------|
| Proof Size | 100 bytes | Constant, regardless of batch size |
| Verification (Simple) | < 4 µs | O(1) constant time |
| Verification (Full) | ~800 µs @ n=1024 | O(log n) tree traversal |
| Space Savings | 25,600× @ n=1024 | vs individual Dilithium signatures |
| Activation | Block 0 | Active since genesis |
#### Consensus Mode
```
Stack:
OP_CHECKPATAGG
Use Case: Transaction validation, block verification
Trust Model: Full cryptographic verification with witness data
```
#### Documentation
- **Wire Format**: [doc/pat-specification.md](doc/pat-specification.md)
- **API Reference**: [src/crypto/pat/logarithmic.h](src/crypto/pat/logarithmic.h)
- **Test Vectors**: [test/pat_tests.cpp](test/pat_tests.cpp)
---
## Quick Start
### Prerequisites
- C++14 compiler (GCC 7+ or Clang 8+)
- Boost 1.70+
- OpenSSL 1.1+
- libevent 2.1+
### Build from Source
```bash
git clone https://github.com/soqucoin/soqucoin.git
cd soqucoin
./autogen.sh
./configure
make -j$(nproc)
make install # optional
```
### Run a Node
```bash
# Stagenet (current active network)
./src/soqucoind -stagenet -daemon -server -rpcuser=soqucoin -rpcpassword=YOUR_PASSWORD
# Mainnet (after genesis)
./src/soqucoind -daemon -server -rpcuser=soqucoin -rpcpassword=YOUR_PASSWORD
# Regtest (local development)
./src/soqucoind -regtest -daemon
```
### ⛏️ Solo Mining
The **SOQ Solo Miner** is a lightweight stratum proxy included in `contrib/solo-miner/`. Mine blocks directly to your wallet, zero pool fees.
```bash
# 1. Configure with your node RPC and wallet address
cd contrib/solo-miner
cp config.example.json config.json && nano config.json
# 2. Run it
./soq-solo-miner config.json
# 3. Point your ASIC/GPU at stratum+tcp://localhost:3333
```
📖 [Full Solo Mining Guide](contrib/solo-miner/README.md)
### Network Ports
| Network | P2P | RPC |
|---------|-----|-----|
| Mainnet | 33388 | 33389 |
| Testnet | 44556 | 44555 |
| Stagenet | 28333 | 28332 |
| Regtest | 18444 | 18332 |
---
## Documentation
| Document | Description |
|----------|-------------|
| [INSTALL.md](INSTALL.md) | Build instructions for all platforms |
| [doc/stagenet-mining-guide.md](doc/stagenet-mining-guide.md) | Stagenet mining & node setup |
| [contrib/solo-miner/README.md](contrib/solo-miner/README.md) | Solo mining stratum proxy |
| [doc/pat-specification.md](doc/pat-specification.md) | PAT wire format specification |
| [Whitepaper](https://soqu.org/whitepaper/soqucoin_whitepaper.pdf) | Technical specification |
---
## Architecture
### Consensus Opcodes
| Opcode | Hex | Witness | Purpose |
|--------|-----|---------|----------|
| `OP_LATTICEBP_RANGEPROOF` | 0xfa | v4 | Lattice-BP++ range proof verification |
| `OP_CHECKFOLDPROOF` | 0xfc | v3 | LatticeFold+ batch proof verification |
| `OP_CHECKPATAGG` | 0xfd | v2 | PAT Merkle commitment verification |
### Prover Implementation Status
| Component | Location | Status |
|-----------|----------|--------|
| **PAT Prover** | `src/crypto/pat/logarithmic.cpp` | ✅ In-tree |
| **PAT Verifier** | `src/crypto/pat/logarithmic.cpp` | ✅ In-tree |
| **LatticeFold+ Prover** | Off-chain (trusted pools) | ✅ Operational |
| **LatticeFold+ Verifier** | `src/crypto/latticefold/verifier.cpp` | ✅ In-tree |
| **Lattice-BP++ Prover** | `src/crypto/latticebp/range_proof.cpp` | ✅ In-tree |
| **Lattice-BP++ Verifier** | `src/crypto/latticebp/range_proof.cpp` | ✅ In-tree |
| **PQ Wallet Library** | `src/wallet/pqwallet/` | ✅ In-tree |
Note: LatticeFold+ is `ALWAYS_ACTIVE` from genesis on all networks. Lattice-BP++ is `ALWAYS_ACTIVE` on regtest, `NEVER_ACTIVE` on mainnet pending audit.
### Branch Structure
| Branch | Purpose |
|--------|---------|
| `main` | Active development (default, protected) |
| `release/v1.0.x` | Stable release branch (hotfixes only) |
| `feature/*` | Feature branches (PR into main) |
---
## Contributing
### Pre-Launch Policy
Soqucoin Core is in **pre-genesis final validation**. The consensus stack has completed security audit (Halborn, 30 findings remediated) and is undergoing final pre-mainnet testing.
**How to contribute now:**
1. **Report bugs** — Open a [GitHub Issue](https://github.com/soqucoin/soqucoin/issues)
2. **Discuss features** — Join [GitHub Discussions](https://github.com/soqucoin/soqucoin/discussions)
3. **Share test data** — Regtest blocks, fuzz corpora, ASIC screenshots
> Pull requests will be enabled immediately after genesis. Contributors who help stress-test the chain will be credited in the launch paper.
### Code Style
This project follows [Bitcoin Core contribution guidelines](CONTRIBUTING.md):
- C++17 standard
- 4-space indentation
- No trailing whitespace
- Signed commits required
---
## Tokenomics
| Parameter | Value |
|-----------|-------|
| **Ticker** | SOQ |
| **Algorithm** | Scrypt |
| **Block Time** | 1 minute |
| **Initial Block Reward** | 500,000 SOQ |
| **Halving Interval** | 100,000 blocks (~69 days) |
| **Terminal Emission** | 10,000 SOQ perpetual (after block 600,000) |
| **Supply Model** | Inflationary with declining rate |
| **Premine** | 0 SOQ |
**Fair Launch** — No premine, no ICO, no founder allocation, no treasury. 100% proof-of-work distribution.
---
## Security
For security vulnerabilities, please see [SECURITY.md](.github/SECURITY.md).
**Do not** open public issues for security-related bugs.
---
## License
Soqucoin Core is released under the terms of the MIT license. See [COPYING](COPYING) for details.
---
Built with 🔐 by the Soqucoin Core developers