Specifications for confidential systems for institutions on Ethereum, by EthSystems. We design each protocol, test it in proof of concepts, and maintain it as editors.
Each specification states its trust model, threat model, and compliance boundary, so engineers, auditors, and regulators can read the same document. ERCs and other ecosystem standards may be outputs of this process.
The process is 1/COSS: one responsible editor per specification, and a lifecycle of raw → draft → stable. A Standards Track draft needs a reference implementation and an adversarial review. Stable needs independent third-party use.
Source is ethsystems/specs. See CONTRIBUTING.md to propose a specification.
| No | Spec | Title | Status | Editor |
|---|---|---|---|---|
| 1 | 1/COSS | Consensus-Oriented Specification System | draft | Oskar Thoren |
| 2 | 2/SHIELDED-POOL | Shielded Pool | draft | Oskar Thoren |
| 3 | 3/ATTESTED-POOL | Attested Shielded Pool | draft | Oskar Thoren |
The site is rendered from these Markdown files with pandoc 3.x.
bash scripts/render.sh # writes build/
python3 -m http.server 8765 --bind 127.0.0.1 -d build # open http://127.0.0.1:8765build/ is git-ignored. Do not commit rendered output.
Nothing syncs to the public mirror automatically. To publish, run one command:
scripts/release.sh # embargo default: newest commit older than 7 days
scripts/release.sh origin/main # release everything on mainIt arms SYNC_ENABLED, dispatches the Release workflow (fast-forward push of one sha
to ethsystems/specs), waits for it, and disarms.
The public deploy then rebuilds specs.ethsystems.org.
Further specifications are promoted from PoC and engagement work as they mature. The working queue is internal.
- ethsystems/map: use cases, patterns, and approaches. Patterns say what and why; specs here are the canonical normative protocols.
- ethsystems/pocs: proof of concepts. Each PoC's SPEC.md is an instance of (or a candidate for) a spec here.
- ethsystems/works: reusable Rust building blocks implementing these protocols.
Documents use CC0 1.0 by default. 1/COSS is the sole exception, under GPL-3.0-or-later.