Stokes (STKS) - Kaspa's Speed, Bitcoin's Halving

✅ Testnet Live - Join Public Testing!

Be part of the future of fair-launch cryptocurrencies

Current Status

🧪 TESTNET PHASE - Help Us Test!

We're in public testnet to ensure a fair, bug-free mainnet launch. Join us in testing!

What's Working

✅ Bitcoin-style halving emission (100M supply, 4-year halvings)
✅ Sub-second block times via blockDAG (50 blocks/sec)
✅ Solo and multi-node mining
✅ Wallet creation and transactions
✅ Full node synchronization

What We're Testing

🧪 Network stability under load
🧪 Halving mechanism accuracy
🧪 Mining difficulty adjustment
🧪 Transaction validation
🧪 Wallet security and usability

Coming Soon

📅 Mainnet launch date announcement
📊 Block explorer
💬 Telegram group

Mainnet Launch: TBA - Will be announced with advance notice

⚡ Instant Confirmations

Sub-second block times via blockDAG architecture powered by Kaspa's PHANTOM protocol

💎 Bitcoin-Style Halving

100M total supply with 4-year halvings. Bitcoin's proven halving model at 500x the speed

🎯 Fair Launch

No premine, no ICO, no VC allocation. Pure proof-of-work mining

🔒 Fixed Supply Cap

100 million STKS maximum supply. Predictable, deflationary emission via halving

🌐 High Throughput

50 blocks/sec parallel processing - 500x faster than Bitcoin

🔐 Proven Security

Battle-tested PHANTOM consensus from Kaspa foundation

Why Stokes?

Most cryptocurrencies force you to choose between speed OR scarcity:

Bitcoin: Scarce but slow (10 min blocks)
Kaspa: Fast but smooth chromatic emission (no halving events)

Stokes combines both: Fast like Kaspa + Scarce like Bitcoin

Comparison

Feature	Stokes	Bitcoin	Kaspa
Block Time	~1 second	10 minutes	~1 second
Halving	✅ Every ~4 years	✅ Every ~4 years	❌ No halvings
Supply	100M fixed	21M fixed	28.7B fixed
Architecture	BlockDAG	Blockchain	BlockDAG
Launch	Fair (PoW)	Fair (PoW)	Fair (PoW)

📦 Get Started with Stokes Testnet

Download pre-built binaries or build from source

Download Binaries Build from Source

📦 Available for Linux (x64, ARM64), macOS (Intel, Apple Silicon), and Windows (x64)

Quick Start Guide

Step 1: Install Go (if not already installed)

Stokes requires Go 1.23 or later. Install using one of these methods:

# Visit: https://go.dev/doc/install
# Or use your package manager:

# macOS
brew install go

# Ubuntu/Debian
sudo apt install golang-go

# Verify installation
go version  # Should show 1.23 or later

Step 2: Build from Source

Clone the repository and build the binaries:

# Clone repository
git clone https://github.com/stokesnetwork/stokes
cd stokes

# Build binaries
go build -o stokesd .
go build -o stokesctl ./cmd/stokesctl
go build -o stokesminer ./cmd/stokesminer
go build -o stokeswallet ./cmd/stokeswallet

Step 3: Start Testnet Node (Terminal 1 - Keep Open)

Option A: Connect to Public Testnet (Recommended)

Try connecting to the public testnet seed nodes:

./stokesd --testnet \
  --utxoindex \
  --connect=95.216.155.253:17711 \
  --connect=46.62.218.114:17711

Seed Nodes:
• 95.216.155.253:17711 (Germany)
• 46.62.218.114:17711 (Germany)

✅ If successful, you'll see:
[INF] TXMP: P2P Connected to 95.216.155.253:17711
[INF] TXMP: P2P Connected to 46.62.218.114:17711

Option B: Standalone Mode (For Local Testing)

If you want to test locally without connecting to the network, or if connection fails:

./stokesd --testnet --utxoindex --nodnsseed --nolisten

Note: Standalone mode creates your own local chain. Your blocks won't sync with the public testnet, but all features work identically for testing.

⚠️ Keep this terminal open! The node must stay running.

Step 4: Create Wallet & Get Mining Address (One Time Setup)

# Create wallet
./stokeswallet --testnet create -f ~/stokes-wallet-testnet/keys.json

# You'll be prompted for a password
# SAVE YOUR SEED PHRASE - This is your backup!

# Get a new address to receive mining rewards
./stokeswallet --testnet new-address -f ~/stokes-wallet-testnet/keys.json

Example output:
New address: stokestest:qpkqllexmwjp...
Copy this address - you'll need it for mining!

Step 5: Start Mining (Terminal 2 - Keep Open)

If connected to seed nodes (Option A):

# Replace YOUR_ADDRESS with address from Step 4
./stokesminer --testnet \
  --miningaddr=stokestest:YOUR_ADDRESS

If running standalone (Option B):

# Replace YOUR_ADDRESS with address from Step 4
./stokesminer --testnet \
  --miningaddr=stokestest:YOUR_ADDRESS \
  --mine-when-not-synced

Note: The --mine-when-not-synced flag is only needed for standalone/local mining. When connected to seed nodes, your node will sync existing blocks first, then start mining safely.

Step 6: Start Wallet Daemon (Terminal 3 - Keep Open)

To check your balance, you need the wallet daemon running:

./stokeswallet --testnet start-daemon \
  -f ~/stokes-wallet-testnet/keys.json \
  -s 127.0.0.1:17210

⚠️ Keep Terminal 3 open! The wallet daemon must stay running to check balances.

Step 7: Check Balance (Terminal 4 - Run When Needed)

# Check your balance (after mining 100+ blocks)
./stokeswallet --testnet balance

# Check block count
./stokesctl --testnet --rpcserver=127.0.0.1:17210 GetBlockCount

🎉 Congratulations! You're now mining Stokes!

Wallet Management

Managing Addresses

# Generate new receiving address
./stokeswallet --testnet new-address

# Show all your addresses
./stokeswallet --testnet show-addresses

# Check balance
./stokeswallet --testnet balance

Sending STKS

# Send coins to another address
./stokeswallet --testnet send \
  --send-amount 100 \
  --to-address stokestest:RECIPIENT_ADDRESS_HERE

⚠️ Wallet Security

Backup your seed phrase - Write it down on paper, store securely
Use a strong password - At least 12 characters, mix of letters/numbers/symbols
Never share your keys - Not your keys, not your coins!
Keep keys.json safe - This file contains your encrypted private keys

Troubleshooting

Node Won't Start

Problem: Node fails to start or crashes immediately

# 1. Check if port is already in use
lsof -i :17710

# 2. Kill existing process
pkill stokesd

# 3. Reset database (WARNING: deletes blockchain data)
rm -rf ~/Library/Application\ Support/stokes-testnet  # macOS
rm -rf ~/.stokes-testnet  # Linux

# 4. Start fresh
./stokesd --testnet --utxoindex

Wallet Can't Connect

Problem: Wallet daemon shows connection errors

# 1. Verify node is running
./stokesctl --testnet --rpcserver=127.0.0.1:17710 GetBlockCount

# 2. Check node started with --utxoindex flag
# Restart node with:
./stokesd --testnet --utxoindex

# 3. Restart wallet daemon
pkill stokeswallet
./stokeswallet --testnet start-daemon \
  -f ~/stokes-wallet/keys.json \
  -s 127.0.0.1:17710

Miner Not Finding Blocks

This is normal! Mining is probabilistic. Factors:

Your hash rate (higher = more blocks)
Network difficulty (adjusts automatically)
Other miners on network

Tips: Be patient, check hash rate is reasonable (~100+ Khash/s), ensure node is synced, try mining for at least 10-15 minutes.

Balance Shows "Pending"

This is normal! Coinbase rewards require 100 block confirmations before they're spendable.

# Get current block count
./stokesctl --testnet --rpcserver=127.0.0.1:17710 GetBlockCount

# Your first rewards become spendable at block 100
# Second rewards at block 101, etc.

Network Information

Network Ports

Network	P2P Port	RPC Port
Mainnet	17611	17610
Testnet	17711	17710
Simnet	17511	17510
Devnet	17611	17610

Address Prefixes

Network	Prefix	Example
Mainnet	`stokes:`	`stokes:qpkpllexmw...`
Testnet	`stokestest:`	`stokestest:qpkpllexmw...`
Simnet	`stokessim:`	`stokessim:qpkpllexmw...`
Devnet	`stokesdev:`	`stokesdev:qpkpllexmw...`

Mining Rewards

Current Reward: 0.007922022 STKS per block
Daily Emission: ~34,239 STKS/day (first era)
Maturity: 100 blocks (coins spendable after 100 confirmations)
Block Time: 20ms average (50 blocks/sec throughput)
Halving Interval: 6,311,520,000 blocks (~4 years)

Useful Commands

# Get node info
./stokesctl --testnet --rpcserver=127.0.0.1:17710 GetInfo

# Get block DAG info
./stokesctl --testnet --rpcserver=127.0.0.1:17710 GetBlockDagInfo

# Get peer info
./stokesctl --testnet --rpcserver=127.0.0.1:17710 GetConnectedPeerInfo

# Get mempool info
./stokesctl --testnet --rpcserver=127.0.0.1:17710 GetMempoolEntries

Testnet Genesis

4240b4dbce9f3a5d1483fd19146051264571494700ed3818b46cd84b0817ef38

Note: Mainnet genesis will be generated on launch day to ensure fair distribution.

Roadmap

✅ Phase 1: Development

Core blockchain implementation complete. Bitcoin-style halving implemented and tested.

🔄 Phase 2: Testnet (NOW)

Public testing, community building, bug fixes, and network stabilization.

⏳ Phase 3: Mainnet

Official mainnet launch after successful testnet period and security audits.

⏳ Phase 4: Ecosystem

DEX and CEX listings, block explorer, mining pools, and community tools.

Emission Schedule

Bitcoin-Style Halving: 100M total supply, 4-year halvings, 50 blocks/second

Era	Years	Reward/Block	STKS This Era	Cumulative
1	0-4	0.007922022 STKS	50M	50M (50%)
2	4-8	0.003961011 STKS	25M	75M (75%)
3	8-12	0.001980505 STKS	12.5M	87.5M (87.5%)
4	12-16	0.000990253 STKS	6.25M	93.75M (93.75%)
5+	16+	Continues halving	...	→ 100M
Total Maximum Supply				100 Million STKS

Daily Issuance: ~34,239 STKS/day (first era)
Block Production: 50 blocks/second (4,320,000 blocks/day)
Halving Interval: 6,311,520,000 blocks (~4 years at 50 BPS)
Philosophy: Bitcoin's proven halving model with Kaspa's high-throughput blockDAG

Contributing

We welcome contributions! Here's how you can help:

Test the network - Run nodes, mine, report bugs
Improve documentation - Fix typos, add examples
Submit bug reports - Use GitHub Issues
Propose features - Open discussions
Code contributions - Submit pull requests

Development Setup

# Clone repo
git clone https://github.com/stokesnetwork/stokes
cd stokes

# Run tests
go test ./...

# Run with race detector
go test -race ./...

# Format code
go fmt ./...

Support & Community

Discord: Join our Discord
GitHub Issues: Report bugs
Website: https://stokesnetwork.github.io/stokes

Coming Soon

Telegram group
Block explorer
Mining pools