Skip to content

Commit b7f26c0

Browse files
committed
docs: clarify live operation boundary
1 parent dae5158 commit b7f26c0

4 files changed

Lines changed: 82 additions & 59 deletions

File tree

README.md

Lines changed: 23 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@
99
ZERO is an open-source runtime and operator terminal for running autonomous
1010
capital operations without giving up custody. It starts with onchain perpetual
1111
markets: paper-first execution, safety gates, local journals, Hyperliquid
12-
read-only/live boundaries, public proof packets, and intelligence contracts.
12+
read-only/live boundaries, self-evolution loops, public proof packets, and
13+
intelligence contracts.
1314

1415
> Not another trading bot. ZERO is the control plane that makes autonomous
1516
> onchain operations inspectable, interruptible, and self-custodial.
@@ -77,15 +78,25 @@ service or an unattended live-capital promise.
7778
## Launch Status
7879

7980
This repository is the public product page and open-core engineering home for
80-
ZERO. It is useful today for paper-mode runtime work, operator-terminal
81-
development, safety-gate design, public proof contracts, and ZERO Intelligence
82-
API contract work.
81+
ZERO. It is launch-ready for paper runtime work, operator-terminal development,
82+
safety-gate design, public proof contracts, self-evolution workflows, ZERO
83+
Network contracts, and ZERO Intelligence API contracts.
8384

84-
It is not yet a promise that a new operator can clone the repo and run a fully
85-
autonomous live-capital system unattended. Live-capable code must pass local
86-
custody, reconciliation, immune, journal, dead-man, and operator-friction
87-
checks before risk can increase. Treat live mode as a self-custodial canary
88-
path, not a shortcut.
85+
For live capital, the public stance is exact: ZERO is a self-custodial local
86+
runtime, not a hosted custody service. Operators bring their own wallet,
87+
exchange account, limits, journals, kill switch, and disclosure policy. The
88+
runtime can only increase risk after local custody, reconciliation, immune,
89+
journal, dead-man, and operator-friction checks pass.
90+
91+
## Live Operation Boundary
92+
93+
| Question | Public answer |
94+
| --- | --- |
95+
| Can a new engineer run ZERO today? | Yes: clone, bootstrap, run the paper API, inspect it through the CLI, and verify proof packs. |
96+
| Can ZERO trade live? | Operator-owned deployments have live Hyperliquid execution evidence represented by `zero.live_trading_evidence.v1`. |
97+
| Does the public repo publish raw live records? | No. It publishes redacted evidence, hash-only proof, canary workflows, and verifiers. |
98+
| Does ZERO custody funds? | No. Live mode is local, self-custodial, explicit, and gated. |
99+
| Is unattended live trading the default? | No. Paper is default; live risk requires canary review and local operator responsibility. |
89100

90101
## Why ZERO Exists
91102

@@ -110,11 +121,11 @@ guarded by preflight checks.
110121

111122
| Surface | Role | Public status |
112123
| --- | --- | --- |
113-
| ZERO Runtime | Python engine for paper execution, production-parity OODA reports, live-readiness contracts, journals, safety gates, strategy adapters, venue adapter interfaces, and canary evidence. | Open source |
124+
| ZERO Runtime | Python engine for paper execution, production-parity OODA reports, live-readiness contracts, journals, safety gates, strategy adapters, venue adapter interfaces, local evolution gates, and canary evidence. | Open source |
114125
| ZERO Terminal | Rust CLI/TUI for setup, diagnostics, state inspection, replay, live cockpit views, and supervised actions. | Open source |
115126
| ZERO Evolution | Local memory, genesis proposals, research reports, decision-stack review, guardian review, red-team, paper canaries, calibration, promotion plans, local apply receipts, rollback receipts, and evolve loops that let ZERO improve under review. | Memory, genesis, research, decision stack, paper-first evolve gates, local apply, and rollback execution open; protected promotion remains human-reviewed |
116-
| ZERO Network | Public-safe profiles, leaderboards, verification badges, profile verification, and deterministic proof-chain packets. | Open source contracts |
117-
| ZERO Intelligence | Delayed public snapshots plus commercial realtime APIs, history, cohorts, webhooks, exports, and SLAs. | Open contracts + paid access |
127+
| ZERO Network | Public-safe profiles, empty/active/stale page states, leaderboards, verification badges, profile verification, and deterministic proof-chain packets. | Open source contracts |
128+
| ZERO Intelligence | Delayed public snapshots plus commercial realtime APIs, history, cohorts, webhooks, exports, and SLAs built from verified autonomous behavior. | Open contracts + paid access |
118129

119130
## Capability Boundary
120131

docs/launch-scorecard.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,8 @@ reserved for ZERO Intelligence.
5454
- Shared paper API contract fixtures pinned by Python API tests and Rust client tests
5555
- First-class GitHub product page with category narrative, above-the-fold
5656
terminal proof artifact, quickstart, safety model, open-core boundary,
57-
capability boundary, operator proof path, and contributor paths
57+
live-operation boundary, capability boundary, operator proof path, and
58+
contributor paths
5859
- First-10-minutes guide and reproducible terminal demo capture for source and
5960
installed release binaries, including the live cockpit/readiness boundary
6061
- Fresh source-tree rehearsal that copies the publishable checkout into a

0 commit comments

Comments
 (0)