ALX Protocol Python Reference Implementation

The Python implementation provides ALX core protocol behavior for Python, AI, and data workflows.

It is a peer reference implementation. It does not define protocol truth. Protocol truth is defined by protocol/spec.md, protocol/schemas/, test-vectors/, and protocol/error-codes.json.

Capability Status

EIP-712 is an optional Ethereum-compatible signing suite. It is not required for core protocol conformance.

Install for Development

cd reference-implementations/python
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"

On macOS or Linux:

source .venv/bin/activate

Run Tests

pytest tests/

Protocol conformance adapter

The Python conformance adapter is:

reference-implementations/python/conformance_adapter.py

From the repository root:

node conformance/bin/run.js --impl "python reference-implementations/python/conformance_adapter.py"

Canonical Graph verification

validate_graph(seed, source, context) verifies the reachable Block Graph and returns one of valid, invalid, incomplete, or resource_limit_reached. The result is scoped to the supplied verification context and exactly follows the canonical Graph verification envelope.

The older two-argument validate_graph(graph, context) adjacency form remains available for compatibility. New integrations should use the canonical three-argument operation.

Package Layout

Related Documents

• ../../protocol/spec.md
• ../../test-vectors/
• ../PARITY.md
• ../../docs/implementers/conformance.md