Using Vouch Bridge

Check how an external engine binds source bytes, target bytes, engine identity, declared gates, and linked evidence in a Vouch Bridge report.

What a Bridge report carries

An external engine runs its own pipeline and emits vouch.bridge-report/v0. The report binds

  • exact source and target bytes by hash and byte length
  • engine name, version, and commit
  • the declared execution route and capability identifiers
  • declared gate results as pass, fail, or not-run
  • hashes of linked proof or gate artifacts
  • an attests and excludes boundary that records the observation supplied by the engine and the responsibilities it retains

This format lets an engine publish inspectable evidence while keeping its implementation private.

Verify a report

Run the external engine, preserve the source and target bytes, and pass the report and named artifacts to Lispex.

SH
lispex verify-bridge \
  --source source.lspx \
  --target translated.output \
  bridge-report.json

Add --linked <artifact-id>=<artifact-file> to bind a linked artifact. Add --expect-context <manifest.json> to select the expected profile, subject, and route through vouch.bridge-context-manifest/v0.

Exit 0 returns vouch.bridge-verify-report/v0 with successful structure, byte, boundary, and requested-context checks. Exit 1 returns a verification report with the failed check. Exit 2 identifies usage, input/output, or JSON parsing errors.

Artifact roles

ProductRole
External engineCreates the target and runs its declared gates
Bridge reportBinds that run to exact artifacts, identities, and results
lispex verify-bridgeValidates report structure and receiver-selected bindings
Recipient policyDecides which external engine, route, and evidence to accept

Bridge reports and native differential receipts remain distinct artifact classes. vouch.bridge-report/v0 enters lispex verify-bridge, while csk.differential-receipt/v0 records reference-interpreter agreement and enters lispex verify.

Keep going

The Vouch overview connects authentication, request binding, current execution agreement, and a local grant.

Lispex Vouch overview · Choosing Where to Run