Connect APIs, give agents a shared budget, and trace what they actually execute. Economic Machine handles policy, approval, payment recovery and receipts. Your keys stay in your environment.
Website · Console · Architecture · C++ engine · Smart contracts · Self-host
| Directory | Contents |
|---|---|
| src/economic_machine | Typed state, ISA, compiler, invariants and deterministic runtime |
| native | C++ kernel, financial primitives, search and sandboxed workers |
| markets | Agent-native Solana/Arbitrum perpetual orderbooks, native execution and versioned research policies |
| contracts | Solidity DataPass, commerce, mining and token contracts |
| src/machine_engine | Accounts, shared budgets, agent policies and execution recovery |
| src/machine_commerce | Service discovery, payment adapters, licensing and delivery |
| tests / cases | Boundary tests, adversarial cases and typed example programs |
| web / site | Console and public tool interfaces |
| docs / products | Architecture, integration references and tool guides |
The source snapshot now includes the fifty-lane Muse research pool, Muse policy and receipt adapters, resident workers, Solana evidence indexing and EVM extraction and wallet search, including Robinhood adapters.
These are source and fixture tests. Historical research grants retain their expired deadlines and fixed authority checks. No running agents, private desk, credentials, raw datasets or operator journals are included, and publication does not resume a previous job. Complete wallet coverage, internal traces, independent consensus finality and profitable trading are not claimed.
Build outputs, operational records, private configuration and internal planning are not part of the public toolkit. See contributing.
| Tool | Purpose | |
|---|---|---|
| Engine | Shared budgets, typed programs, approvals and durable execution records. | |
| Atlas | Source-linked APAC public compute-price observations. | |
| DataPass | Versioned data licenses, wallet entitlement checks and delivery. | |
| Mining | Verifiable work, publishable artifacts and bounded SKEW issuance. | |
| Swap / Fuel | Wallet-approved USDC → native ETH with settlement tracking. | |
| SiteLens | Power-to-GPU capacity scenarios with explicit assumptions. |
Each tool has its own source map and usage guide. They share one runtime and console; the product directories are entry points, not six separately published Python packages.
Python 3.11+; Linux is recommended for the native tools. Run from a source checkout:
git clone https://github.com/skew-labs/economic-machine.git
cd economic-machine
python3 -m venv .venv
.venv/bin/pip install -e .
umask 077
export ENGINE_ADMIN_TOKEN="$(.venv/bin/python -c 'import secrets; print(secrets.token_urlsafe(48))')"
.venv/bin/economic-machine serve --db runtime/engine.sqlite3 --port 8800Open http://127.0.0.1:8800/engine and unlock it with that token. Keep the checkout:
the console currently loads web assets from the repository. This is a local owner
installation; hosted multi-user commerce needs its own authentication and merchant configuration.
CMake 3.20+, a C++20 compiler and threads are required. No model or wallet is needed.
cmake -S native -B build/native -DCMAKE_BUILD_TYPE=Release
cmake --build build/native --parallel 2
ctest --test-dir build/native --output-on-failureBuilds the kernel, financial primitives, route-search and solution-search libraries. Linux additionally builds the sandboxed worker pipeline. Native outputs are candidates; they do not authorize signatures or transactions.
The perpetual-market adapters separate frozen-model policy search, native event execution and authoritative chain accounting. Solana v6 has devnet verification, v7 is an undeployed candidate, and Arbitrum has a bounded mainnet pilot. The research companion reports strategy comparisons, loss incidence, CU/gas and finality with their measurement limits.
flowchart LR
Agent[Your agent / API] --> Engine[Engine: policy + budget + approval]
Atlas[Atlas / SiteLens] --> Engine
Mining[Mining: verified work] --> DataPass[DataPass: publish + license + deliver]
Engine --> DataPass
Engine --> Services[x402 services]
Engine --> Fuel[Swap / Fuel]
DataPass --> Chain[Arbitrum settlement]
Services --> Chain
Fuel --> Chain
Chain --> Receipts[Reconcile + receipts]
Receipts --> Engine
Source availability is not a deployment or audit claim. Signing, live order transmission, merchant admission and mining deployment are separate operator-controlled steps. Unknown payment outcomes retain their budget reservation until reconciled. See security boundaries.
Software is MIT licensed. Data rights and third-party marks have separate terms; see NOTICE. SKEW brand downloads.