⛏️ WorldLand Miner

One-Click Mining for WorldLand Seoul Mainnet (ECCPoW)

🇰🇷 한국어 가이드: README_KO.md — 비개발자도 쉽게 따라할 수 있는 한국어 가이드

Download, extract, and start mining in under a minute. No technical knowledge required.

---

🚀 Quick Start

1. Download the latest release from Releases
2. Extract the zip file to any folder
3. Run WorldLand Miner.hta (GUI) or setup.bat (CLI)
4. Done! Your miner is running.

---

📋 System Requirements

Requirement	Minimum
OS	Windows 10 / 11 (64-bit)
RAM	4 GB+
Disk	2 GB+ free space
Network	Stable internet connection
Ports	TCP/UDP 30303 (P2P)

---

🌐 Network Information

Property	Value
Network	Seoul Mainnet
Consensus	ECCPoW (Error-Correction Code Proof of Work)
Chain ID	103
Native Token	WL (18 decimals)
RPC URL	https://seoul.worldland.foundation/
P2P Port	30303

Bootnodes

enode://551bb6345ee...@3.39.197.118:30303
enode://a8ddef19f8a...@34.47.103.170:30303
enode://29edb4c62ce...@34.22.66.127:30303
enode://89d5457f55c...@18.141.201.245:30303
enode://4f83cbe244e...@13.200.114.1:30303
enode://21da5ff755a...@13.209.255.10:30303

---

🖥️ GUI Mode — WorldLand Miner.hta

The HTA application provides a visual interface for mining management.

Features

• Real-time monitoring — Block height, peer count, hashrate, balance
• One-click mining — Start/Stop with a single button
• Wallet management — Create new or import existing wallet
• Auto-refresh — Status updates every 8 seconds
• Balance tracking — Queries balance from the public RPC endpoint with local fallback

How to Use

1. Double-click WorldLand Miner.hta
2. On first run, choose Create NEW Wallet or Use EXISTING Wallet
3. Click Start Mining
4. Monitor your progress in the dashboard

---

⌨️ CLI Mode — Batch Scripts

For users who prefer command-line operation.

Files

Script	Description
setup.bat	First-time setup: creates wallet and starts mining
run-miner.bat	Start mining (auto-runs setup if no wallet)
stop-miner.bat	Gracefully stop the miner
status.bat	Check current mining status via RPC

Usage

:: First time setup (creates wallet + starts mining)
setup.bat

:: Start mining (subsequent runs)
run-miner.bat

:: Check status
status.bat

:: Stop mining
stop-miner.bat

---

📁 Files Created During Mining

File	Location	Description
wallet-address.txt	Miner folder	Your wallet address
password.txt	Miner folder	Auto-generated wallet password
Keystore	%LOCALAPPDATA%\Ethereum\keystore\	Encrypted private key
Chain data	%LOCALAPPDATA%\Ethereum\seoul\worldland\	Blockchain data

⚠️ Important: Back up your password.txt and keystore folder. If you lose these, you lose access to your wallet.

---

🔧 Troubleshooting

Peers stuck at 0

• Make sure TCP/UDP port 30303 is open in Windows Firewall
• The miner includes 6 stable bootnodes for peer discovery
• It may take 1-2 minutes to find peers after starting

Balance shows 0 or Error

• Balance is fetched from https://seoul.worldland.foundation/
• If the public RPC is unreachable, it falls back to your local node
• Your local node needs to be fully synced to show accurate balance
• Newly mined blocks need network confirmations before balance updates

Miner window closes immediately

• Check debug.log in the miner folder for errors
• Make sure worldland.exe is in the same folder as the scripts
• Run as Administrator if you encounter permission issues

Hashrate shows 0

• Mining uses 1 CPU thread by default
• Hashrate may take a few seconds to appear after starting
• ECCPoW is CPU-friendly — GPU is not required

---

🔗 Links

Resource	URL
Website	worldland.foundation
GitHub	github.com/cryptoecc
Core Node	cryptoecc/WorldLand
RPC Endpoint	https://seoul.worldland.foundation/

---

📜 License

This project is licensed under the terms included in the LICENSE file.

---

WorldLand Foundation © 2024-2026