open-standards/sandbox/conformance/v1/README.md
Transaction Science 96cd5e98a0
All checks were successful
standards workspaces build + test / which workspaces this change touches (pull_request) Successful in 5s
repository checks / lockfiles, tests in CI, workflow hygiene, spec and section references, public text (pull_request) Successful in 48s
standards workspaces build + test / jcp-rs (jcp-conformance, jcp/jcp-rs, -p jcp-energy --features nvml, jcp-rs, linux) (pull_request) Successful in 1m41s
standards workspaces build + test / joule-ui-rs (joule-ui/joule-ui-rs, joule-ui-rs, linux) (pull_request) Successful in 1m10s
standards workspaces build + test / proof-rs (proof-conformance, proof/proof-rs, proof-rs, linux, true) (pull_request) Successful in 2m18s
standards workspaces build + test / sandbox-rs (sandbox-conformance, sandbox/sandbox-rs, sandbox-rs, linux) (pull_request) Successful in 2m38s
standards workspaces build + test / joulecontract-rs (joulecontract/joulecontract-rs, joulecontract-rs, linux-arm64, true) (pull_request) Successful in 2m43s
standards workspaces build + test / joule-code-rs (joule-code/joule-code-rs, joule-code-rs, linux-arm64, true) (pull_request) Successful in 5m23s
standards workspaces build + test / macOS energy backends (pull_request) Successful in 13m57s
standards workspaces build + test / jouledesk-rs (jouledesk/jouledesk-rs, jouledesk-rs, macos) (pull_request) Successful in 4m28s
sandbox: flow across a run's checkpoints — an untrusted read closes the sinks that follow
Sweep 2026-10-19 item #7, second half, by the owner's decision. Each
checkpoint was decided alone: a unit could read data an attacker writes and
later reach an endpoint it is granted, each call passing its own check, and
nothing connected the read to the egress. The Enforcer is stateless by
design (C2), so the connection had to be state the run carries explicitly.

sandbox-capability (SPEC §5.8):
- Grants.flow: FlowGrant { untrusted: [FlowSource { kind: Path|Kv|Program,
  pattern, origin }], tainted_may: [FlowSink { kind: Egress|Exec, target,
  accepts }] }. Omitted when empty, so a grant set without it keeps its bytes.
- RunTaint: the origins of untrusted data a run has read; only grows.
- Two pure Enforcer functions: taints(source), the origins a read adds; and
  may_reach(sink, &taint), where a tainted run reaches a sink only where
  tainted_may opens it to EVERY origin it carries (entries combine; `*`
  opens to any target or origin; an unopened sink is closed). Additional to
  the sink's capability, never instead. A decision stays a function of its
  inputs, the run's taint among them, as I/O counters already are.

sandbox-exec-wasm (S2, where the live checkpoints are): HostState carries
the taint. A storage or kv read that returns data, and a program's output,
taint the run from a source the grant marks; egress and exec are refused
with TAINTED (-6, distinct from DENIED) when the grant has not opened them
to the run's origins. sandbox-exec-os is untouched: it refuses network and
process grants outright, so no sink is reachable there.

sandbox-runtime: grants_content_id binds flow_untrusted and
flow_tainted_may when present, so the flow grant is part of the capability
surface (SPEC §1.2); a grant without one keeps its id.

Conformance class C13: sequence vectors (a run's calls in order; reads
check the origins after, sinks whether reachable), in code and in the new
conformance/v1/flow.json. The pack count goes to 13.

SPEC §5.8, spec/capabilities.md (the enforcer contract: pure, with the
run's history as an input), spec/conformance.md, conformance/v1/README.md;
SPEC §10's class list was missing C11 and C12 and now lists C11–C13.

Residuals, stated in §5.8: an unmarked source is read as the principal's
data, and a tainted run's writes are not marked, so data can lose its taint
between runs.

Note: running gen_vectors also rewrites attestation.json and negative.json
with "mechanism": null, a drift that predates this change; left out of it.

Tests:
- capability: three unit tests (a read carries every matching source's
  origin, kinds do not cross, `*` is any program; a tainted run reaches
  only what is opened to all it carries, entries combine; the taint only
  grows and an empty flow grant is not encoded).
- exec-wasm: three end-to-end through real guests (an untrusted storage,
  kv or program read closes the egress that follows, a clean read leaves it
  open; an untrusted read closes the launch that follows; a sink opens only
  to the origins named, and no flow grant is untouched).
- runtime: the flow grant is bound into the grant id, every part of it.
- C13.
Mutation testing: 17 mutants; 16 killed, 1 equivalent (the clean-run early
return in may_reach: an empty taint already satisfies "every origin").

Verified on the build host: sandbox-rs 428 tests (--locked); every
conformance class passes, C13 in code and from flow.json; clippy -D
warnings clean on sandbox-capability, -exec-wasm, -runtime, -conformance.
Repo checks pass.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-21 10:49:52 -04:00

1.4 KiB
Raw Permalink Blame History

Sandbox conformance vectors — v1

The v1 wire vectors. Each file is regenerated by gen_vectors and verified by the harness; see ../README.md and ../VERSIONS.md.

File Class Contents
content_addressing.json C1 byte inputs (hex) → expected b3: content id
capability.json C2 grant sets → allow/deny decision per query (incl. negatives)
receipt.json C3 a CPU+GPU receipt → canonical core (hex), content id, sealed JCR-1 envelope (hex), steward key
attestation.json C4 an S5 attestation → JCS bytes, content id, Ed25519 signature (hex), supervisor key
tier.json C5 grant set + isolation flags → required tier (S0–S7)
durable.json C6/C7/C10 a run-record trace → head id; a devcontainer → manifest id; a fleet → merkle root (all b3:)
negative.json C-neg malformed receipts + attestations a conformant host MUST reject
confidential.json C-tee SEV-SNP report verify (valid + negatives) + audit-chain check
flow.json C13 a run's calls in order → the origins each read adds, and whether each sink may be reached

The signing keys are fixed test keys embedded in the vector builders (receipt key [3;32], supervisor key [5;32]); the public keys travel in the vector files. These are conformance fixtures, not operational keys.