xone.sh has 100 posts. This page groups each one under the operator question it answers, with one line each: 26 on install, 16 on sync, 12 on validate, 9 on rpc, 12 on troubleshoot, 10 on measure, 15 on compare. Start with the question you have, and follow the link.
Each post cites its sources: the xOne repositories, pull requests and read-only measurements. xOneTS, xOnePy and xOneC are private repositories.
How do I choose, install and upgrade xOne?
Pick a client, install it from a verified artifact, and upgrade it with a rollback path.
- Which xOne client should you run on XDC Network?: which of the four clients fits your use.
- xOneRS: a Rust foundation for XDC: the Rust client, xOneRS.
- xOneTS: the protocol, in a familiar language: the TypeScript client, xOneTS.
- xOnePy: a readable path into the protocol: the Python client, xOnePy.
- xOneC: close to the machine, open to ideas: the C++ client, xOneC.
- How to run and verify xOneRS, the Rust XDC client: run and verify xOneRS.
- How to run and verify xOneTS, the TypeScript XDC client: run and verify xOneTS.
- How to run and verify xOnePy, the Python XDC client: run and verify xOnePy.
- How to run and verify xOneC, the C++ XDC client: run and verify xOneC.
- Installing xOne with Homebrew, Helm, Stereum, Eth Docker or WSL2: Homebrew, Helm, Stereum, Eth Docker and WSL2.
- How to verify an xOne release artifact on XDC: check a release binary before you run it.
- XDC node hardware and disk requirements for xOne: CPU, memory and disk to plan for.
- How to plan disk space for an XDC node with xOne: disk space by network and mode.
- How xOne stores XDC chain data: engines and datadir: what is in the datadir.
- How xOne stamps a build: version string and reproducible releases: read the version string.
- How xOne releases work and how to read the version stamp: how releases are made.
- xOne release checklist: upgrade the four clients on XDC: upgrade steps for all four clients.
- How to upgrade or roll back an xOne node safely: upgrade and roll back safely.
- How to run a one-validator XDC dev chain with xone --dev: a one-validator local chain.
- Resuming an xone --dev chain: seeded fixtures on XDC: resume a seeded dev chain.
- Inside xOneTS: SQLite storage and dense sync on XDC: how xOneTS stores and syncs.
- Inside xOnePy: SQLite WAL and the event loop on XDC: how xOnePy stores and runs.
- Inside xOneC: MDBX and the producer path on XDC: how xOneC stores and produces.
- xOne roadmap: what gates A to E mean for XDC clients: what gates A to E mean.
- What changed in xOne on XDC this week (to 2026-11-15): changes in the week to 2026-11-15.
- What changed in xOne this week: a mid-week digest to 2026-11-15: changes from 2026-11-13 to 2026-11-15.
How do I sync a node and keep it at the tip?
Pick a sync mode, start from genesis or a snapshot, and keep good peers.
- Choosing an xOne sync mode on XDC: a decision table: a decision table for the sync mode.
- How snap, fast and full sync work in xOne on XDC: how snap, fast and full sync work.
- What happens when a snap pivot moves in xOne on XDC: what happens when the snap pivot moves.
- How to bootstrap an XDC node from a snapshot with xOne: start from a snapshot.
- Snapshot import with --staging: restore an xOne node safely: import a snapshot with --staging.
- How xOne snapshots and backups are made and verified: how snapshots are made and checked.
- How to run an XDC archive node with xOne: flags and status: run an archive node.
- How to run an XDC Apothem follower with xOne: measured: run an Apothem follower.
- How to join net2040 with xOne: step-by-step guide: join net2040 step by step.
- xOne on Apothem vs net2040: what changes for an operator: what differs between the two networks.
- How xOne refuses the wrong XDC network for a datadir: why a datadir refuses another network.
- How xOne checks a peer's chain before syncing from it: how a peer's chain is checked.
- How xOne chooses and drops XDC peers: dial sample, score, bans: how peers are chosen and dropped.
- Banning a peer by hand on xOne: admin_banPeer on XDC: ban a peer by hand.
- How to check an xOne node's networking from another host: check networking from another host.
- How xOne reinjects transactions after a reorg on XDC: what happens to transactions after a reorg.
How do I run a validator safely?
Set up the key, keep the safety record, and know how a block is built and sealed.
- How to run an XDC validator on net2040 with xOne: run a validator on net2040.
- Setting up an XDC validator key with xone-signer-setup.sh: set up the validator key.
- XDC validator key custody and seat rotation with xOne: key custody and seat rotation.
- The xOne safety record: what an XDC signer writes before it votes: what the signer writes before it signs.
- XDC validator daily checklist: what to watch with xOne: a daily checklist.
- Disk watermarks and block sealing: why a full disk stops xOne: why a full disk stops sealing.
- How xOne builds an XDC block: from the transaction pool to the seal: how a block is built and sealed.
- The XDC gas limit rule in xOne: xdcGasLimit and --miner.gaslimit: how the block gas limit is set.
- Transaction types on XDC: legacy, EIP-2930 and EIP-1559 in xOne: which transaction types each fork accepts.
- How epoch switches work on XDC and how xOne tests them: how epoch switches work.
- QC, TC and timeouts: what an XDPoS v2 follower verifies in xOne: QC, TC and timeouts in XDPoS v2.
- How xOne computes XDC penalties and rewards bit-exactly: penalties, rewards and comeback.
How do I serve and use JSON-RPC?
Serve only the namespaces you need, and know what each method returns.
- XDC JSON-RPC methods in xOne and how parity is checked: the namespaces and methods served.
- The XDPoS RPC namespace in xOne: the 15 methods and what each returns: the 15 XDPoS_ methods.
- Exposing xOne JSON-RPC safely on XDC: limits, namespaces, JWT: limits, namespaces and JWT for public RPC.
- xOne for XDC RPC providers: archive vs full, retention errors: archive or full for an RPC provider.
- Finality on XDC for exchanges and bridges: what xOne reports: finality for exchanges and bridges.
- How to trace an XDC transaction with xOne tracers: trace a transaction.
- How xOne handles XDC balances above 2^256: balances above 2^256.
- How to run the xOne RPC parity sweep, and compare your own node: compare your node with geth-XDC.
- The xOne CLI for XDC operators: attach, rpc check, wait-ready and more: attach, rpc check and other CLI tools.
How do I monitor a node and troubleshoot it?
Watch a small set of metrics and log lines, and read the incident notes when something breaks.
- How to monitor an XDC node with xOne: metrics, logs, ethstats: metrics, logs and ethstats.
- Ten xOne Prometheus metrics to alert on for an XDC node: ten metrics to alert on.
- How to tune Prometheus alerts for an xOne node on XDC: tune Prometheus alerts.
- Running xOne with Prometheus and Grafana in Docker Compose: Prometheus and Grafana in Docker Compose.
- xOne ops toolbox: ten host tools for XDC node operators: ten host tools for operators.
- Reading an xOne node log on XDC: the ten lines that matter: the ten log lines that matter.
- xOne log formats: text, JSON and slow-block lines on XDC: text, JSON and slow-block logs.
- Where does block time go? The xOne receive and slow-block log fields: where block time goes.
- What a refused block leaves behind: xOne's invalid-block evidence: what a refused block leaves behind.
- Why a one-block reorg wedged an xOne node on Apothem: a one-block reorg that wedged a node.
- net2040 incident log, week 46: xOne seat misses and outages: misses and outages in week 46.
- A load miss, explained: the Python validator at round 841,894: a miss caused by host load.
What do the measurements show?
Read-only measurements of the fleet: head, disk, memory, arrival time and turns.
- XDC fleet snapshot 2026-11-15: xOne and other clients: head, disk and memory of every node.
- Memory per XDC client: resident memory of 33 nodes from the fleet probe: memory by client and mode.
- Apothem datadir size by xOne client: measured after snap sync: Apothem datadir size by client.
- Four XDC clients on one host: load and disk records: load and disk with four clients on one host.
- How fast does a block reach each XDC client? A net2040 sample: how fast a block reaches each client.
- How many blocks are in an XDC epoch? net2040 numbers: how many blocks an epoch holds.
- reth-xdc on Apothem: a slow catch-up measured over nine samples: a slow catch-up over nine samples.
- How fair mint is measured on XDC net2040 with xOne: how fair mint is measured.
- Four xOne clients minting fair share on XDC net2040: the four clients' share of turns.
- One tracker for four XDC clients: how the hourly net2040 report works: the hourly net2040 report.
How does xOne compare with other XDC clients, and how is parity proven?
Measured comparisons with the other XDC clients, and the gates that prove parity with geth-XDC.
- xOne vs geth-XDC on net2040 and Apothem: measured results: against geth-XDC.
- xOne vs reth-xdc on XDC: measured head, disk, memory, RPC: against reth-xdc.
- xOne vs erigon-xdc: what we could measure on Apothem: against erigon-xdc.
- xOne vs besu-xdc: measured head, disk, memory and RPC: against besu-xdc.
- xOne vs nethermind-xdc on XDC: measured head, disk, memory, RPC: against nethermind-xdc.
- State of parity for XDC clients in xOne, week of 2026-11-15: parity status in the week of 2026-11-15.
- xOne RPC parity on Apothem and net2040 in numbers: RPC parity counts.
- How xOne proves parity with geth-XDC: the replay gate: the replay gate.
- xOne replay gate in numbers: vectors, blocks and hours: replay gate counts.
- Running the net2040 replay with xone-replay: fetch, run, gate: run the net2040 replay yourself.
- Running the Ethereum execution spec tests against xOne: the Ethereum execution spec tests.
- Running EVM state tests with xone evm statetest on XDC: the state-test runner.
- How xOne qualifies a release tarball with the t8n corpus gate: the t8n gate for a release.
- How xOne tracks feature gaps against other XDC clients: how feature gaps are tracked.
- How the xOne 13-section issue format keeps XDC gaps clear: the 13-section issue format.
Frequently asked questions
Where should a new operator start?
With which xOne client to run, then the run-and-verify post for that client, then choosing a sync mode.
Which post explains how to run an XDC validator with xOne?
How to run an XDC validator on net2040, with signer setup and the safety record.
Where are the measured comparisons with geth-XDC and the other clients?
Under the compare question above: one post per client, and the fleet snapshot for all nodes at one time.
Will this index be updated?
Yes. New posts are added under their question, and the updated date changes.
A NOTE ON READINESS
This article describes the source and evidence at its review date. Check the linked repository for current implementation and qualification status.
Explore the engineering evidenceEdit this page on GitHub opens the Markdown source (content/blog/xone-blog-index/index.md). GitHub may ask you to sign in. Report a correction opens a prefilled GitHub issue for this page.