xOnePy: a readable path into the protocol

A Python execution client with typed workspace packages, a py-evm adapter, and SQLite WAL storage.

xBy xOne teamNov 12, 2026 / 1 min read

xOnePy is the Python member of the xOne family, built around typed Python packages.

What it is

Runtime: CPython managed with uv
Execution: py-evm adapter
Storage: SQLite WAL
License: MIT

The repository includes follower, snapshot, and producer implementations.

Why Python

Python is the easiest language in the family to read. For anyone trying to understand how an XDC execution client fits together, a typed, modular Python codebase is a gentler entry point than a native one.

How to build it

The repository is currently private. You need uv and Python 3.12+; follow the repository runtime pin (the operations ADR selects CPython 3.13).

git clone https://github.com/XDCIndia/xOnePy.git
cd xOnePy
uv sync --frozen
uv run --frozen --no-sync xonepy --version

See pyproject.toml for the workspace layout.

Source

github.com/XDCIndia/xOnePy

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 evidence

xWritten by xOne team← All field notes

Build your way.

Choose an implementation to see its source-based build recipe.

ClientGoal

Use the pinned Rust toolchain and platform build prerequisites in the repository.

git clone https://github.com/XDCIndia/xOneRS.git
cd xOneRS
cargo build --locked --release -p xone
./target/release/xone --version

This recipe builds the client; it does not start a node. Mainnet operation is not yet qualified.

Open source guide

What it is

Why Python

How to build it

Source

Continue the investigation.

Four clients, one protocol: what each xOne client is for

How xOne releases are made, and how to read the version stamp

The conformance and replay gate