Built on Satoshi's foundation. Evolved with complexity theory. Driven by real-world utility.
COINjecture is a utility-based blockchain that proves computational work through NP-Complete problem solving. Instead of arbitrary hashing, we solve verifiable computational problems with practical applications. The native token is $BEANS.
Read the Manifesto | Architecture Docs | API Reference
- 🧮 Verifiable Work: NP-Complete problems (O(2^n) solve, O(n) verify)
- 📊 Emergent Tokenomics: No predetermined schedules, adapts to network behavior
- 🔧 Utility Layer: User-submitted computational work markets
- 🌐 Distributed Participation: Competition within hardware classes, not across them
- ⚡ Hardware-Class-Relative Competition: Mobile vs mobile, server vs server
- 🎯 Tier System: Hardware compatibility categories, not reward brackets
- Bitcoin: Hash until you find a number (arbitrary computation)
- COINjecture: Solve NP-Complete problems (verifiable complexity)
- Bitcoin: Fixed supply (21M), fixed block time (10 min), fixed halving schedule
- COINjecture: Supply emerges from cumulative work, block time from verification performance
- Not mining for coins
- Solving problems to prove computational work
- Optionally solving real problems users submit and pay for
- Read MANIFESTO.md for the conceptual foundation
- Review ARCHITECTURE.README.md for system design
- Check API.README.md for interface specifications
- Start with ARCHITECTURE.README.md for system overview
- Read API.README.md for interface specifications
- Dive into module-specific docs in docs/ for implementation details
- See PROJECT_STRUCTURE.md for directory organization
- Use
./scripts/deployment/deploy_mining_node.sh startto deploy mining node - Use
./scripts/deployment/deploy_bootstrap_to_droplet.shto deploy bootstrap node
- Read MANIFESTO.md to understand what COINjecture is
- Review API.README.md User Submissions section to submit problems
- Check docs/testing.md for development environment setup
📦 View All Downloads on GitHub
Download COINjecture-macOS-v3.15.0-Python.zip (0.7 MB)
Download COINjecture-3.15.0-macOS.dmg (35.9 MB)
Features:
- ✅ Dynamic Gas Calculation: IPFS-based gas costs (38K-600K+ gas range)
- ✅ Enhanced CLI: All commands support dynamic gas calculation
- ✅ Interactive Menu: User-friendly interface for beginners
- ✅ Direct CLI Access: Full command-line functionality for advanced users
- ✅ Live Network Integration: Real-time gas calculation during mining
- ✅ Cross-platform Support: macOS, Windows, Linux packages
Installation:
- Download the package above
- Extract and run
./install.sh - Launch with
./start_coinjecture.sh - COINjecture launches automatically! 🚀
Download COINjecture-Windows-v3.15.0-Python.zip (0.7 MB)
Installation:
- Download the package above
- Extract and run
install.bat - Launch with
start_coinjecture.bat
Download COINjecture-Linux-v3.15.0-Python.zip (0.7 MB)
Installation:
- Download the package above
- Extract and run
./install.sh - Launch with
./start_coinjecture.sh
COINjecture includes a comprehensive command-line interface with 15 commands and interactive menus:
# One-click installer (recommended)
python3 install_coinjecture.py
# Or download platform-specific launchers
# Windows: start_coinjecture.bat
# Unix: start_coinjecture.sh🚀 COINjecture Interactive Menu
============================================================
1. 🏗️ Setup & Configuration
2. ⛏️ Mining Operations
3. 💰 Problem Submissions
4. 🔍 Blockchain Explorer
5. 🌐 Network Management
6. 📊 Telemetry & Monitoring
7. ❓ Help & Documentation
8. 🚪 Exit
============================================================
# Start interactive menu
coinjectured interactive
# Initialize node
coinjectured init --role miner
# Start mining
coinjectured mine --tier desktop
# Submit problem
coinjectured submit-problem --type subset_sum --bounty 100
# Check submission status
coinjectured check-submission <submission_id>
# List active submissions
coinjectured list-submissionsinit- Initialize node configurationrun- Start node with specified rolemine- Start mining operationsget-block- Retrieve block by indexget-proof- Get proof data for blockadd-peer- Add network peerpeers- List connected peerssubmit-problem- Submit computational problemcheck-submission- Check submission statuslist-submissions- List active submissionsinteractive- Launch interactive menutelemetry- Manage telemetry settings
- 🌍 Network: TestNet (not mainnet)
- 🌐 API Server: https://api.coinjecture.com
- 📊 Latest Block: https://api.coinjecture.com/v1/data/block/latest
- 🔍 Health Check: https://api.coinjecture.com/health
- 🔗 Genesis: d1700c2681b75c1d22ed08285994c202d310ff25cf40851365ca6fea22011358
- 👥 Network: 16 total connections, 3 active peers (167.172.213.70:5000, peer2.example.com:5000, peer3.example.com:5000)
- ⚡ Real Miners: Connected to actual network miners (BEANS addresses)
- 🔄 Chain Regeneration: Successfully regenerated from genesis block
- 📡 All Endpoints: Available worldwide with TLS/SSL
| Document | Purpose |
|---|---|
| MANIFESTO.md | Vision and principles |
| ARCHITECTURE.README.md | System architecture |
| API.README.md | Language-agnostic API specifications |
| DYNAMIC_TOKENOMICS.README.md | Tokenomics system details |
| USER_GUIDE.md | Complete user instructions |
| QUICK_REFERENCE.md | Command reference |
| DOWNLOAD_PACKAGES.md | Installation guide |
- docs/blockchain/ - Module-specific specifications
- docs/devnet.md - Development environment setup
- docs/testing.md - Testing specifications
src/
├── core/ # Core blockchain implementation
│ └── blockchain.py # Main blockchain logic
├── tokenomics/ # Dynamic work score tokenomics
│ └── dynamic_tokenomics.py
├── user_submissions/ # User submission system
│ ├── aggregation.py
│ ├── pool.py
│ ├── submission.py
│ └── tracker.py
├── cli.py # Command-line interface
├── node.py # Node orchestration
├── pow.py # Proof-of-work module
├── storage.py # Storage and IPFS
├── consensus.py # Consensus engine
├── network.py # Network protocol
└── api/ # Faucet API server
├── faucet_server.py
├── cache_manager.py
└── update_cache.py
docs/ # Technical documentation
├── blockchain/ # Module specifications
├── devnet.md # Development environment
└── testing.md # Testing guide
scripts/ # Development and deployment scripts
tests/ # Test suite
assets/ # Diagrams and assets
└── diagrams/
└── block_structure.png
- Subset Sum: O(2^n) solve, O(n) verify - exact DP solver
- Knapsack: 0/1 Knapsack problem, NP-Complete
- Graph Coloring: Graph k-coloring, NP-Complete
- SAT: Boolean satisfiability, NP-Complete
- TSP: Traveling Salesman Problem, NP-Complete
- Factorization: Integer factorization, NP-Hard
- Lattice: Lattice-based problems, NP-Hard
- Clique: Maximum clique, NP-Complete
- Vertex Cover: Minimum vertex cover, NP-Complete
- Hamiltonian Path: NP-Complete
- Set Cover: NP-Complete
- Bin Packing: NP-Hard
- Job Scheduling: NP-Hard
| Tier | Name | Problem Size | Target Hardware | Characteristics |
|---|---|---|---|---|
| 1 | Mobile | 8-12 elements | Smartphones, tablets, IoT | Energy efficient, fast iteration |
| 2 | Desktop | 12-16 elements | Laptops, basic desktops | Balanced performance |
| 3 | Workstation | 16-20 elements | Gaming PCs, dev machines | Higher compute power |
| 4 | Server | 20-24 elements | Dedicated servers, cloud | Massive parallel processing |
| 5 | Cluster | 24-32 elements | Multi-node, supercomputers | Distributed computation |
Version: 3.15.0 (Live TestNet)
Status: Production Ready
License: MIT
- ✅ Live API Server - 24/7 worldwide access
- ✅ Interactive CLI - 15 commands with guided menus
- ✅ IPFS Integration - Off-chain proof storage
- ✅ User Submissions - Problem submission and solving
- ✅ Telemetry System - Real-time mining data
- ✅ Cross-Platform - Windows, macOS, Linux support
- Uptime: 100% since deployment
- Response Time: < 100ms average
- Availability: Global access
- Security: Rate limiting, HMAC authentication
- 📦 Releases: Download v3.15.0 packages
- 🐛 Issues: Report bugs and request features
- 💬 Discussions: Community discussions
- 📚 Documentation: Complete guides and API references
- ⭐ Star: Show your support for the project
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
MIT License - see LICENSE
Built on Satoshi Nakamoto's foundational insights about proof-of-work consensus and immutable ledgers. COINjecture evolves these concepts with complexity theory and real-world utility.
Not mining - solving.
Not arbitrary work - verifiable work.
Not predetermined schedules - emergent economics.
Not centralized - distributed by design.
COINjecture: Utility-based computational work, built on Satoshi's foundation.
Visit our live server: https://api.coinjecture.com