Skip to main content
This is the product and developer documentation for BlockX. BlockX is a function-execution framework for on-chain data: it receives tasks, scans trigger data, executes lightweight Python functions in parallel, and writes the results back to BlockDB.

Architecture overview

Which components make up the system, how a task flows through it, and the three design principles.

Task lifecycle

The end-to-end sequence and states from ReserveWorkerSlot to TaskResult.

Repository layout

What lives where, why it is laid out that way, and which directory to look at when you want to change X.

Components

Worker, Coordinator, call execution, IO, plugins, Python Executor, and more, with a dedicated page for each.

Local development

Environment setup, build and test commands, and common issues.

Contributing

The spec-first workflow, code conventions, and commit and PR rules.
New to this project? Follow the “Suggested reading order” at the end of the Architecture overview first, then go to the page of the component you want to change.