Documentation
Read the rules. Then run them.
Everything you need to mine, hold, run a node, or build on xCoin. Every link below goes to something that exists today; specs and code are the source of truth, this page is the index.
Whitepaper
Monetary policy, MetalDAG proof-of-work, post-quantum spend rules, addresses, and network parameters. The normative description.
Read → 02 · CharterThe xCoin Charter
Version 1, the text committed in the genesis block: name and units, supply, identity and lineage, emission, ownership, history, changing the rules, what this chain is for, custody of this text. Its SHA-256 is the commitment in the genesis coinbase.
Read → 03 · ConceptsArchitecture
The plain-language tour: consensus, spend authority, emission, hardware. Start here if the whitepaper is too dense.
Read → 04 · MiningMining guide
How proof-of-work works, mine in the browser, download NerdMiner, bring your own address.
xcoinminer.com → 05 · SourceNode source
The reference implementation: consensus, MetalDAG, ML-DSA-65 and SLH-DSA-SHA2-128s, RPC, and the XIP directory. Build it, run it, verify it.
GitHub → 06 · WalletWallet CLI
Seed, addresses, balance, and maturity-aware send with native ML-DSA-65 signing. The seed never reaches the node.
GitHub → 07 · APIExplorer API
The explorer at superknet.com is live on mainnet and its API is public: /api/stats for height, supply, difficulty and hashrate, /api/network for miners. Read live mainnet chain state without running a node.
XIP process
How to propose a change. Rough consensus and running code; consensus-critical proposals (XCIPs) carry the highest bar.
XIP-0001 → 09 · HelpForum
Rigs, help, nodes, protocol, build. Ask there first; the answer usually already exists. Login is a signature from your address.
minedifferent.com →Quick start · mine in five minutes
- Get an address. Install the wallet CLI (xPay is a demo of the same wallet) and generate a seed; your receive address starts with
xpa1r. Back the seed up offline. - Mine with MMM on your Mac: get it from github.com/SystemThreat/MMM, open Setup, and enter network Mainnet, explorer
https://superknet.com, poolpool.xcoinminer.comport3335, any worker name, password blank, and yourxpa1raddress. Press Start Mining. - No Mac at hand? Try it in your browser: open xcoinminer.com, paste the address, press start. It mines the same pool, slowly.
- Coinbase rewards mature after 1,000 blocks, about 3.5 days. The explorer at superknet.com shows live mainnet figures, from genesis on September 26, 2026, 00:00 UTC.
# command-line alternative to MMM NerdMiner xpa1r… --pool pool.xcoinminer.com:3335 --base 1790380800 --worker rig1 # log in to the forum with your mining key (no password) NerdMiner login
Quick start · run a node
Build the node from the code (CMake; the binaries are nexd and nex-cli in build/bin/). Mainnet has been live since genesis on September 26, 2026, 00:00 UTC: run nexd with no network flag and it joins mainnet on P2P port 9333, with every peer connection encrypted by hybrid post-quantum key exchange (ML-KEM-768, XIP-4) from block 0. Five DNS seed hostnames are named in the code and their records are live (each resolves to every fleet node), so a fresh node finds the network on its own; -addnode is optional. Live nodes are listed at superknet.com. Testnet A (-testnet) is retired (ledger archived at height 3,555).
# ~/.xcoin/nex.conf listen=1 # mainnet: P2P 9333, RPC 8332; the DNS seeds find peers for you (-addnode is optional) nexd -daemon nex-cli getblockchaininfo
Mainnet (live since 2026-09-26 00:00:00 UTC): genesis 3bc1a36df7d786a5c4584e21d248e0a3785a96aaa60a5b3959dfad50283379f2 · charter hash fd9b475afdbe178864f32802726cc60c27290c09efd472d0934b1c733d3b9340 · currency id e6e4ae00e1d3b25a7e4c2e94d3216d70f6b6f2e7cbd38bf23acaed391edea060 · P2P 9333 · RPC 8332 · magic 58 50 41 03 · addresses xpa1r…. Testnet A (retired): genesis 1dc4131e…43ccb9 · P2P 19333 · RPC 19432 · magic 58 54 41 02.
Glossary
- XID (Ӿ), the ticker. 1 XID = 100,000,000 sat; the cap is 100,000,000 XID.
- MetalDAG, the memory-hard proof-of-work (4 GiB dataset at launch, +128 MiB per 14-day epoch).
- ML-DSA-65, the FIPS 204 lattice signature that authorizes a spend. SLH-DSA-SHA2-128s (FIPS 205) is equally valid at consensus and serves as the fallback leaf.
- xpa1r…, a bech32m witness-v3 address committing to a post-quantum spend tree.
- XIP / XCIP, an improvement proposal; the C marks consensus-critical.
Ecosystem
| Thing | Where | What it does |
|---|---|---|
| Pool | pool.xcoinminer.com:3335 | Stratum (172.96.186.49). Mine with MMM on your Mac: Setup network Mainnet, explorer https://superknet.com, this host and port. |
| Explorer | superknet.com | Mainnet explorer, live since genesis on September 26, 2026, 00:00 UTC. Public API: /api/stats and /api/network. |
| Forum + chat | minedifferent.com | Login = ML-DSA-65 signature. Live chat is the widget on every xCoin site, including this one. |
| MMM | SystemThreat/MMM | The recommended miner: native Mac Metal Miner GUI, mainnet setup at macmetalminer.com. |
| NerdMiner | xcoinminer.com | Native Mac miner, forum login, local stats server for the NerdMiner MD browser extension. |
| xPay | xpayapp.com | Demo wallet with NFC card cold storage. |
| Medium post | medium.com/@knexcoin | Why xCoin exists, in one read. |