Real-time uranium mine operations dashboard built on the XRPL EVM Sidechain Testnet. A fully deployed Solidity contract powering a live Web3 dashboard — no backend, no server, one HTML file.
Contract on Explorer → 0x22ACA8...97bE31
ZUC Mine Command Center is the operational control layer for a live on-chain uranium mining system deployed on the XRPL EVM Sidechain.
It is not a static dashboard — it is a direct execution interface over a production Solidity contract.
Through a single frontend surface, operators can:
- read live on-chain state (miners, reserves, ownership)
- execute contract functions via signed transactions
- monitor network conditions in real time (block height, gas, latency)
- visualize system topology and resource distribution in 3D
The system is built with a strict architecture constraint:
No backend. No API. No middleware.
UI (index.html)
→ ethers.js (provider + signer)
→ XRPL EVM Sidechain (RPC)
→ ZUCMine.sol (on-chain state + logic)
- every state update is on-chain truth
- every action is a signed transaction
- every visualization reflects live contract state
In practice, this functions as a blockchain-native command center, where the UI is not a wrapper — it is the execution surface of the protocol itself.
- ✅ Live contract deployed at
0x22ACA8269801bF50d96c7e7F296c11799597bE31 - ✅ All read functions queried on wallet connect (miners, reserves, mine names, owner)
- ✅ All write functions exposed with full 4-step transaction lifecycle (estimate gas → broadcast → mine → confirm)
- ✅ Auto chain detection — prompts MetaMask to switch to XRPL EVM Testnet if on wrong network
- ✅ Real-time event feed via ethers.js provider
- ✅ Live block number and gas price monitoring
- ✅ Three.js interactive globe showing node topology
- ✅ Three.js 3D mine network map with animated node connection
- ✅ Three.js geological terrain viewer with ore deposit simulation
- ✅ Chart.js reserve history charts with live updates
- ✅ Cyberpunk dark theme — neon accents, scanlines, beam animations, depth glow
- ✅ Responsive layout (desktop + mobile)
- ✅ On-chain transaction log feed with explorer links
- ✅ Network health indicators (block time, gas, chain ID, RPC status)
This interface allows direct execution of contract write functions via MetaMask, exposing the full transaction lifecycle from initiation to confirmation.
Deployed: 0x22ACA8269801bF50d96c7e7F296c11799597bE31
Network: XRPL EVM Sidechain Testnet (Chain ID: 1449000)
Compiler: Solidity 0.8.24
addMiner(string _name, uint256 _oreMined)
// Register a new miner with their cumulative ore production.
// onlyOwner. Emits MinerAdded.
setMineName(uint256 _mineId, string _name)
// Set or update the display name of a mine.
// onlyOwner. Emits MineNameSet.
storeReserves(uint256 _mineID, uint256 _tons)
// Record current ore reserves for a mine in tons.
// onlyOwner. Emits ReservesStored.
transferOwnership(address _newOwner)
// Transfer contract ownership to a new address.
// onlyOwner. Reverts on zero address.getMineInfo(uint256 _mineId) → (uint256 tons, string name)
// Returns reserve tonnage and name for a mine.
getMiner(uint256 _minerID) → Miner(id, name, oreMined)
// Returns full miner struct.
getReserves(uint256 _mineID) → uint256
// Returns ore reserve tonnage.
owner() → address
miners(uint256) → Miner
mineNames(uint256) → string
mineReserves(uint256) → uint256
minerCount() → uint256| Pattern | Implementation |
|---|---|
onlyOwner modifier |
Gates all write functions |
| Custom errors | NotOwner(), ZeroAddress() — gas efficient vs require strings |
| Indexed events | MinerAdded, MineNameSet, ReservesStored, OwnershipTransferred |
| Struct storage | Miner struct in mapping |
| View functions | All reads are view — zero gas cost |
| Layer | Technology |
|---|---|
| Blockchain | XRPL EVM Sidechain Testnet |
| Smart Contract | Solidity 0.8.24 |
| Web3 Provider | Ethers.js v5 (CDN) |
| 3D Visualisation | Three.js r128 (CDN) |
| Charts | Chart.js 4.4.1 (CDN) |
| Frontend | Vanilla HTML/CSS/JS — zero build step |
| Fonts | Orbitron, Rajdhani (Google Fonts) |
| Hosting | Vercel |
zuc-mine-command-center/
├── index.html ← Full dashboard (single file)
├── ZUCMine.sol ← Deployed Solidity contract
├── .github/
│ └── workflows/
│ └── deploy.yml ← Auto-deploy to GitHub Pages on push
├── LICENSE
└── README.md
No install required — just open the file:
git clone https://github.com/yourusername/zuc-mine-command-center
open index.html
# or: python3 -m http.server 8080The included GitHub Actions workflow auto-deploys on every push to main.
- Push to GitHub
- Go to Settings → Pages → Source → select
GitHub Actions - Push any commit — workflow runs and deploys
- Live at
https://yourusername.github.io/zuc-mine-command-center
- Go to Settings → Pages
- Source:
Deploy from a branch - Branch:
main// (root) - Save
Add XRPL EVM Testnet to MetaMask:
| Field | Value |
|---|---|
| Network Name | XRPL EVM Testnet |
| RPC URL | https://rpc.testnet.xrplevm.org |
| Chain ID | 1449000 |
| Symbol | XRP |
| Explorer | https://explorer.testnet.xrplevm.org |
The dashboard auto-detects your network on connect and prompts a switch if you're on the wrong chain.
Get free testnet XRP: https://faucet.testnet.xrplevm.org
# Install Foundry
curl -L https://foundry.paradigm.xyz | bash && foundryup
# Deploy
forge create ZUCMine.sol:ZUCMine \
--rpc-url https://rpc.testnet.xrplevm.org \
--interactive \
--legacy
# Paste the printed address into index.html:
# var CONTRACT = "0x...";| Project | Description | Status |
|---|---|---|
| ZUC Mine Command Center | On-chain uranium mining operations dashboard — real-time reserve tracking, miner registry, and contract interaction via a fully frontend-driven command interface | ✅ Live |
| U235 Fuel Cycle | Nuclear fuel cycle pipeline — uranium ore to enriched fuel rod, deterministic multi-stage processing with full on-chain traceability | ✅ Live |
| ISR Network | Intelligence surveillance reconnaissance system — on-chain asset tracking, mission lifecycle state machine, and role-based operator control | ✅ Live |
| Dark Matter Farm | DeFi yield protocol — experimental high-convexity farming system with custom reward mechanics and on-chain state-driven emissions | ✅ Live |
| COHR LAB | Semiconductor fabrication lifecycle system — deterministic on-chain state machine tracking irreversible production stages from crystal growth to final pigtail with full auditability | ✅ Live |
MIT — see LICENSE