⛏️ ShinyChain

  ███████╗██╗  ██╗██╗███╗   ██╗██╗   ██╗ ██████╗██╗  ██╗ █████╗ ██╗███╗   ██╗
  ██╔════╝██║  ██║██║████╗  ██║╚██╗ ██╔╝██╔════╝██║  ██║██╔══██╗██║████╗  ██║
  ███████╗███████║██║██╔██╗ ██║ ╚████╔╝ ██║     ███████║███████║██║██╔██╗ ██║
  ╚════██║██╔══██║██║██║╚██╗██║  ╚██╔╝  ██║     ██╔══██║██╔══██║██║██║╚██╗██║
  ███████║██║  ██║██║██║ ╚████║   ██║   ╚██████╗██║  ██║██║  ██║██║██║ ╚████║
  ╚══════╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝   ╚═╝    ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝

A fully private, instant-mining blockchain — forked from Wownero (Monero fork)
Mine 3,600 SHINY every block. No peers. No halving. No waiting. Completely yours.

🚀 Quick Start  •  📋 Commands  •  🔧 Build from Source  •  🌐 Web Explorer  •  🔬 Source Changes

---

🌟 What is ShinyChain?

ShinyChain is a fully isolated, private blockchain built on Wownero (itself a Monero fork). It is designed for solo mining, development, research, and learning — completely air-gapped from every public network. You own the entire chain. You mine every block. You receive every coin.

No registration. No cloud. No fees. Runs 100% on your machine.

Chain Properties at a Glance

Property	ShinyChain	Wownero (upstream)
Block Reward	⭐ Fixed 3,600 SHINY forever	Decaying emission curve
Mining Difficulty	⭐ Always 1 (instant CPU mining)	Adjusted every block
Block Time Target	60 seconds	120 seconds
Coin Unlock	⭐ 1 block (~60 seconds)	10 blocks
Hard Fork Version	v15 from block 1	Progressive upgrade
Seed Nodes	⭐ None (fully private)	Public seed nodes
Checkpoints	⭐ None (no sync conflicts)	Yes
Network ID	Custom UUID (isolated)	Wownero ID
P2P Port	44567	34567
RPC Port	44568	34568
ZMQ Port	44569	34569
Address Prefix	Sh1... (prefix 19353)	Wo...
Privacy	Full RingCT + Bulletproofs	Full RingCT + Bulletproofs

---

✨ Key Features

• ⚡ Instant Mining — Difficulty is fixed at 1. Every single CPU hash is a valid block. No GPU, no ASIC, no proof-of-work wait time.
• 💰 Fixed Huge Reward — Exactly 3,600 SHINY per block, every block, forever. No halving. No emission curve. Predictable income.
• 🔒 Fully Private & Isolated — Custom Network ID + zero seed nodes = no outside node can ever connect, join, or sync. Your chain is yours alone.
• 🚀 Fast Unlock — Mined coins are spendable after just 1 confirmation (~60 seconds).
• 🛡️ Real Privacy Tech — Full RingCT transactions. Amounts and recipients are hidden on-chain. Real Bulletproofs zero-knowledge proofs.
• 🐳 Docker Ready — Three-container stack (daemon + wallet + web) launches with a single command. No manual setup needed.
• 🌐 Built-in Web UI — Block explorer + browser-based wallet at http://localhost:9753. Explore blocks, check balance, send coins — all in your browser.
• 📱 Multi-Platform — Runs on Linux, WSL2 (Windows), macOS, and even Android (Termux).
• 🔑 Latest Features from Block 1 — Hard fork v15 active from genesis. Subaddresses, RingCT, Bulletproofs — all available immediately.

---

🏗️ Architecture

ShinyChain runs as three coordinated Docker containers:

┌─────────────────────────────────────────────────────────────────┐
│                        Your Machine                             │
│                                                                 │
│  ┌──────────────────┐    ┌──────────────────┐                  │
│  │  shinychain_      │    │  shinychain_      │                  │
│  │  wallet           │───▶│  daemon           │                  │
│  │                   │    │                   │                  │
│  │  • Creates wallet │    │  • Runs blockchain│                  │
│  │  • Wallet RPC     │    │  • Auto-mines     │                  │
│  │  • Port 18083     │    │  • Port 44568     │                  │
│  └──────────────────┘    └──────────────────┘                  │
│           │                       │                             │
│           └───────────┬───────────┘                             │
│                       ▼                                         │
│           ┌──────────────────────┐                              │
│           │   shinychain_web     │◀── http://localhost:9753     │
│           │                     │                               │
│           │  • Block explorer   │                               │
│           │  • Wallet UI        │                               │
│           │  • Port 9753        │                               │
│           └──────────────────────┘                              │
│                                                                 │
│  Persistent volumes: chain_data / wallet_data / web_wallet      │
└─────────────────────────────────────────────────────────────────┘

Startup sequence: wallet creates/loads wallet → writes mining address → daemon reads address → daemon starts mining → web connects to daemon for explorer data.

---

🚀 Quick Start — Docker

Recommended method. No compilation needed. Works on any OS with Docker.

Prerequisites

# Linux / WSL2 (Ubuntu)
sudo apt-get install docker.io docker-compose-plugin

# macOS / Windows — install Docker Desktop from https://docker.com

Start the chain

# 1. Clone this repo
git clone https://github.com/Lord1Egypt/ShinyChain.git
cd ShinyChain/docker

# 2. Build the image (one-time, ~1 min with prebuilt binaries)
docker compose build

# 3. Launch all 3 containers (daemon + wallet + web)
docker compose up -d

# 4. Watch startup logs (Ctrl+C to exit logs, containers keep running)
docker compose logs -f

# 5. Open the web explorer + wallet in your browser
#    http://localhost:9753

That's it. Mining starts automatically. Coins accumulate in your wallet.

Stop / Reset

# Stop (keeps all blockchain data and coins)
docker compose down

# FULL RESET — deletes ALL coins and blockchain (creates new wallet)
docker compose down -v
docker compose up -d

---

📋 Command Reference

💳 Wallet Commands

# Check your balance (total + unlocked)
docker exec shinychain_wallet balance

# Send coins to an address
docker exec shinychain_wallet transfer <ADDRESS> <AMOUNT>
docker exec shinychain_wallet transfer Sh1pABC...XYZ 1000

# Generate a new subaddress (to receive payments)
docker exec shinychain_wallet new-address
docker exec shinychain_wallet new-address my-label

# Self-test: creates a subaddress and sends coins to it
docker exec shinychain_wallet test-transfer
docker exec shinychain_wallet test-transfer 5000

# Show your wallet address + 25-word seed phrase
docker exec shinychain_wallet cat /wallet/wallet_info.txt

# Interactive wallet shell (full wallet CLI)
docker exec -it shinychain_wallet bash

Fee note: This chain requires ~8× the default fee estimate. Helper scripts use priority 3 automatically. If you see "fee too low", use PRIORITY=4:

PRIORITY=4 docker exec shinychain_wallet transfer <ADDRESS> <AMOUNT>

⛏️ Mining Commands

# Show mining status (active?, speed, threads)
docker exec shinychain_daemon mine-status

# Stop mining
docker exec shinychain_daemon mine-stop

# Start mining (mines to your wallet address)
docker exec shinychain_daemon mine-start

# Show daemon status and blockchain height
docker exec shinychain_daemon wownerod status

# Interactive shell inside the daemon container
docker exec -it shinychain_daemon bash

🐳 Stack Control

# Start all 3 containers
docker compose up -d

# Stop (keeps blockchain + wallet data)
docker compose down

# Show container status
docker compose ps

# Tail live logs (all containers)
docker compose logs -f

# Tail logs for a specific container
docker compose logs -f daemon
docker compose logs -f wallet
docker compose logs -f web

# FULL RESET — wipes all coins + blockchain
docker compose down -v && docker compose up -d

---

🌐 Web Explorer & Wallet UI

Open http://localhost:9753 in any browser on your machine.

🔍 Explorer Tab Live chain stats (height, hash rate, difficulty) Latest blocks in real-time Click any block to see its transactions All block details (hash, timestamp, reward, size)

👛 Wallet Tab Enter your 25-word seed phrase to open a wallet View balance (total + unlocked) Send coins to any ShinyChain address Generate new subaddresses Runs a private wallet-rpc — your seed never leaves your machine

Security: The web app is served locally only. Never enter your seed phrase on a site you do not fully control.

---

🔧 Build from Source

Use this if you want to compile native binaries without Docker.

Linux / WSL2 (Ubuntu)

# Install build dependencies
sudo apt-get install build-essential cmake pkg-config libssl-dev \
  libzmq3-dev libunbound-dev libsodium-dev libunwind8-dev \
  libreadline-dev libboost-all-dev

# Clone this repo
git clone https://github.com/Lord1Egypt/ShinyChain.git
cd ShinyChain

# Compile — ALWAYS use -j2 (more threads will freeze low-RAM machines)
make -j2

# Binaries appear at:
#   build/Linux/master/release/bin/wownerod
#   build/Linux/master/release/bin/wownero-wallet-cli
#   build/Linux/master/release/bin/wownero-wallet-rpc

Quick Start with Native Binaries

cd build/Linux/master/release/bin/

# Create a new wallet
./wownero-wallet-cli --generate-new-wallet mywallet \
  --password "password" --mnemonic-language English --command address

# Start daemon + auto-mining (replace ADDRESS with your wallet address)
./wownerod --non-interactive --start-mining <YOUR_ADDRESS> --mining-threads 2

# Wait 15 seconds, then trigger mining
./wownerod start_mining <YOUR_ADDRESS> 2

# Check status
./wownerod status

Alternative: Apply the Patch to a Fresh Wownero Clone

# Clone the exact Wownero base commit
git clone https://github.com/wowario/wownero.git
cd wownero
git checkout b6e08f8c7
git submodule update --init --recursive

# Apply all ShinyChain changes
git apply /path/to/shinychain.patch

# Compile
make -j2

Android (Termux)

# Install Termux from F-Droid (NOT Play Store)
# https://f-droid.org/en/packages/com.termux/

pkg update
pkg install git cmake make clang python3 \
  boost openssl unbound libsodium readline libzmq \
  protobuf libudev pkg-config

# Copy shinychain.patch and setup_shinychain.sh to ~/
chmod +x setup_shinychain.sh
./setup_shinychain.sh

# Compile (use -j1 on slow phones to avoid overheating)
cd wownero && make -j2

---

🔬 Source Code Changes

ShinyChain modifies exactly 7 files from Wownero upstream. All changes are captured in shinychain.patch.

File	What Changed	Effect
src/cryptonote_config.h	Name → shinychain; ports 44567/44568/44569; custom network UUID; block time 60s; unlock window 1; reward 3600/block; address prefix 19353	Defines the entire chain identity and timing
src/cryptonote_basic/cryptonote_basic_impl.cpp	get_block_reward() returns fixed 3600 * COIN	Eliminates the emission curve — every block pays exactly 3,600 SHINY forever
src/cryptonote_basic/difficulty.cpp	All difficulty functions return 1	Every CPU hash is valid — no real proof-of-work, instant mining
src/hardforks/hardforks.cpp	Single entry: v15 from block 1	Activates all latest protocol features (Bulletproofs, RingCT, subaddresses) from genesis
src/checkpoints/checkpoints.cpp	All checkpoints removed	No sync conflicts on a private isolated chain
src/p2p/net_node.inl	All seed nodes commented out	Daemon can never discover or connect to external peers
src/rpc/core_rpc_server.cpp	check_core_ready() returns true when peers = 0	Mining RPC works on a standalone node without requiring --offline flag

📐 Deep Dive: How Instant Mining Works

Standard Monero-based blockchains use the RandomX (or RandomWOW) proof-of-work algorithm. The network continuously adjusts difficulty so that, on average, only one miner in the entire network finds a valid hash in the target block time.

ShinyChain removes this entirely by making every hash valid:

// src/cryptonote_basic/difficulty.cpp — ShinyChain version
uint64_t next_difficulty(std::vector<uint64_t> timestamps,
                         std::vector<uint64_t> cumulative_difficulties,
                         size_t target_seconds) {
    return 1;  // every hash is valid
}

With difficulty = 1, the daemon mines thousands of blocks per second on a single CPU core. The 60-second block target becomes a soft suggestion; in practice blocks arrive much faster.

💰 Deep Dive: Fixed Block Reward

Wownero (like Monero) uses a decaying emission formula where the reward shrinks over time toward a fixed "tail emission." ShinyChain replaces this with a constant:

// src/cryptonote_basic/cryptonote_basic_impl.cpp — ShinyChain version
bool get_block_reward(size_t median_weight, size_t current_block_weight,
                      uint64_t already_generated_coins,
                      uint64_t &reward, uint64_t &reward_without_fee,
                      uint64_t version) {
    reward = reward_without_fee = 3600 * COIN;  // fixed forever
    return true;
}

Every block, forever: 3,600.000000000000 SHINY.

---

🗂️ Repository Layout

ShinyChain/
├── shinychain.patch          ← All 7 source file changes in one patch
├── setup_shinychain.sh       ← Automated setup script for new machines
├── SHINYCHAIN_GUIDE.txt      ← Complete master guide (features, commands, troubleshooting)
├── shinychain_bundle.tar.gz  ← Portable bundle (patch + scripts + docker, no binaries)
│
├── docker/
│   ├── Dockerfile            ← Image definition (copies prebuilt binaries)
│   ├── docker-compose.yml    ← 3-service stack (daemon + wallet + web)
│   ├── entrypoint.sh         ← Container startup logic (3 service modes)
│   ├── webapp.py             ← Block explorer + wallet UI (pure Python stdlib)
│   ├── balance.sh            ← docker exec helper: check balance
│   ├── transfer.sh           ← docker exec helper: send coins
│   ├── new-address.sh        ← docker exec helper: generate subaddress
│   ├── test-transfer.sh      ← docker exec helper: self-test transfer
│   ├── mine-start.sh         ← docker exec helper: start mining
│   ├── mine-stop.sh          ← docker exec helper: stop mining
│   ├── mine-status.sh        ← docker exec helper: mining status
│   ├── COMMANDS.txt          ← Quick reference card
│   └── README.txt            ← Docker-specific guide
│
└── src/                      ← Modified Wownero source files
    ├── cryptonote_config.h                          ← Chain identity
    ├── cryptonote_basic/cryptonote_basic_impl.cpp   ← Fixed reward
    ├── cryptonote_basic/difficulty.cpp              ← Difficulty = 1
    ├── hardforks/hardforks.cpp                      ← v15 from genesis
    ├── checkpoints/checkpoints.cpp                  ← No checkpoints
    ├── p2p/net_node.inl                             ← No seed nodes
    └── rpc/core_rpc_server.cpp                      ← Solo RPC fix

---

🛠️ Troubleshooting

"Genesis block mismatch" when opening wallet

Cause: The wallet cache was created with a different binary (genesis hash changed after recompile).

Fix:

cd build/Linux/master/release/bin/
rm -f mywallet
./wownero-wallet-cli --restore-deterministic-wallet \
  --wallet-file mywallet --password "password" \
  --electrum-seed "YOUR 25 WORDS HERE"

"Failed to add genesis block"

rm -rf ~/.shinychain/lmdb
# Restart daemon — it regenerates genesis automatically

Balance shows 0 after refresh

rm -f mywallet
./wownero-wallet-cli --wallet-file mywallet --password "password" \
  --daemon-port 44568 --restore-height 0 --command refresh

"Mining did not start -- BUSY"

The daemon is still initializing. Wait 15 seconds after startup, then:

./wownerod start_mining YOUR_ADDRESS 2

Compilation freezes the system

Always compile with exactly 2 threads:

make -j2   # correct
make       # wrong — uses all CPU cores, freezes low-RAM machines
make -j8   # wrong

"fee too low" on transfer

# Use priority 4 (highest fee tier)
PRIORITY=4 docker exec shinychain_wallet transfer ADDRESS AMOUNT

Docker build fails with "out of memory"

Increase Docker memory limit to 4 GB+ in Docker Desktop → Settings → Resources.

---

📊 Mining Math

With difficulty = 1, you mine as fast as your CPU can hash:

Timeframe	Blocks	SHINY Earned
Per minute	~1+	~3,600+
Per hour	~60+	~216,000+
Per day	~1,440+	~5,184,000+
Per week	~10,080+	~36,288,000+

Actual rate depends on CPU speed. In practice, blocks come faster than the 60-second target because difficulty = 1 never adjusts.

---

🔐 Data & Persistence

Docker Volumes

Volume	Contents	Deleted on down -v?
chain_data	Blockchain LMDB database	Yes — re-mines from scratch
wallet_data	Wallet keys + info file	Yes — new wallet created
shared_data	Temp address file	Yes — auto-recreated
web_wallet	Web UI cached wallets	Yes — re-restored from seed

Back up your wallet seed before any down -v. The seed is at:

docker exec shinychain_wallet cat /wallet/wallet_info.txt

WSL2 Note

WSL2 resets wipe all Docker volumes. Back up the chain data if needed:

/var/lib/docker/volumes/docker_chain_data/_data/lmdb/

---

📦 Portable Bundle

To run ShinyChain on a new machine without cloning the full repo:

# Pack (run on your current machine)
tar -czf shinychain_bundle.tar.gz \
    shinychain.patch setup_shinychain.sh SHINYCHAIN_GUIDE.txt docker/

# Unpack and run (on the new machine)
tar -xzf shinychain_bundle.tar.gz
chmod +x setup_shinychain.sh
./setup_shinychain.sh   # clones Wownero, applies patch, compiles
cd docker
docker compose build
docker compose up -d

---

👤 About

ShinyChain was created and is maintained by Lord1Egypt.

Built on top of:

• Wownero — a privacy-focused Monero fork
• Monero — the gold standard of private cryptocurrency
• RandomWOW proof-of-work (difficulty hardcoded to 1 in ShinyChain)
• Bulletproofs zero-knowledge range proofs
• RingCT for hidden transaction amounts and recipients

All Changes Made by Lord1Egypt

Change	File
Chain identity: name, ports, network UUID, address prefix	src/cryptonote_config.h
Block time 60s, unlock window 1 block, spendable age 1	src/cryptonote_config.h
Fixed block reward: 3,600 SHINY forever	src/cryptonote_basic/cryptonote_basic_impl.cpp
Mining difficulty always = 1 (instant mining)	src/cryptonote_basic/difficulty.cpp
Hard fork v15 from genesis block	src/hardforks/hardforks.cpp
Removed all checkpoints	src/checkpoints/checkpoints.cpp
Removed all seed nodes	src/p2p/net_node.inl
Solo mining RPC fix (works without peers)	src/rpc/core_rpc_server.cpp
Full Docker stack (daemon + wallet + web)	docker/
Block explorer + browser wallet UI	docker/webapp.py
Automated multi-platform setup script	setup_shinychain.sh

---

⛏️ Mine SHINY. Stay private. Own your chain.

Made with ❤️ by Lord1Egypt