Documentation

Vertically integrated MEV infrastructure — search, execution, and block building as one stack.

These docs are a work in progress. Sections marked planned describe the intended design and are not yet available.

#Architecture

Zeminus is organized as a single pipeline rather than a set of disconnected bots:

Search — opportunity discovery across AMMs and accessible orderflow.
Execute — capital-light, flash-funded, fail-closed on-chain execution.
Build — block construction and orderflow integration. planned

#The Stack

Each layer feeds the next. Discovery surfaces opportunities; execution captures them atomically with downside bounded on-chain; the builder layer closes the loop from signal to settled block.

#MEV Primer

Maximal Extractable Value (MEV) is the value obtainable from ordering, inserting, or censoring transactions within a block. Zeminus focuses on the non-toxic, competitive subset — primarily backruns and atomic arbitrage — captured through transparent, fail-closed execution.

#Execution Model

Execution is capital-light: the capital for each opportunity is borrowed via flash loan, the cycle runs atomically, and the loan is repaid in the same transaction. No standing inventory is required.

Atomic multi-venue cycles (V2 / V3 / V4).
Flash-funded — no idle capital at risk.
Per-leg exact-input with early-abort floors.

#Safety & Guards

Every execution carries an on-chain profit guard. If the cycle does not clear its minimum threshold, the transaction reverts — the flash loan is never repaid, the whole transaction unwinds, and the bundle is dropped. Unprofitable attempts cost nothing beyond gas; principal is never at risk.

Fail-closed by construction: a landed transaction is, by definition, one that satisfied its guard.

#Orderflow planned

Interfaces for routing and integrating orderflow will be documented here.

#Bundles planned

Bundle format, semantics, and submission flow. To be published with the public release.

#RPC Endpoints planned

Endpoint URLs, authentication, and methods. Not yet available.

#Block Building planned

Block construction, ordering policy, and builder integration — the final layer of the stack.

#API planned

Programmatic reference. To be published with the public release.

#Glossary

Backrun — a transaction placed immediately after a target to capture the price impact it creates.
Atomic arbitrage — a profit-or-revert cycle settled within a single transaction.
Flash loan — uncollateralized capital borrowed and repaid within one transaction.
Profit guard — an on-chain check that reverts execution below a minimum threshold.

#Security

Contracts are designed to hold no standing funds and to fail closed. A responsible-disclosure process and audit references will be published with the public release. planned

#License

Zeminus source is released under the Business Source License 1.1 (BUSL-1.1): source-available, with production use restricted until the change date, after which it converts to an open-source license.

#FAQ

Is Zeminus live? In development. This documentation is being built out ahead of release.

What chains? Ethereum mainnet first.