Skip to content

Commit 4e1a318

Browse files
committed
docs(evidence): note cycles_evidence non-attestation on commit/release mirrors
1 parent 419622d commit 4e1a318

1 file changed

Lines changed: 19 additions & 2 deletions

File tree

drafts/cycles-evidence-v0.1.yaml

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -899,7 +899,17 @@ components:
899899

900900
CommitResponseMirror:
901901
type: object
902-
description: Mirror of `cycles-protocol-v0.yaml#/components/schemas/CommitResponse` — the body of `POST /v1/reservations/{reservation_id}/commit`.
902+
description: |
903+
Mirror of `cycles-protocol-v0.yaml#/components/schemas/CommitResponse` —
904+
the body of `POST /v1/reservations/{reservation_id}/commit`.
905+
906+
DELIBERATE OMISSION — `cycles_evidence`: the canonical response carries an
907+
optional `cycles_evidence` ref, but it is TRANSPORT METADATA and is NOT
908+
attested by this envelope, so it is intentionally absent here and
909+
`additionalProperties: false` FORBIDS it in the attested payload. The
910+
`evidence_id` is computed over this pre-evidence-ref response; servers
911+
MUST compute `evidence_id` before stamping `cycles_evidence` onto the wire
912+
response (see `CyclesEvidenceRef`).
903913
required: [status, charged]
904914
additionalProperties: false
905915
properties:
@@ -921,7 +931,14 @@ components:
921931

922932
ReleaseResponseMirror:
923933
type: object
924-
description: Mirror of `cycles-protocol-v0.yaml#/components/schemas/ReleaseResponse` — the body of `POST /v1/reservations/{reservation_id}/release`.
934+
description: |
935+
Mirror of `cycles-protocol-v0.yaml#/components/schemas/ReleaseResponse` —
936+
the body of `POST /v1/reservations/{reservation_id}/release`.
937+
938+
DELIBERATE OMISSION — `cycles_evidence`: as with the commit/reserve mirrors,
939+
the canonical response's optional `cycles_evidence` ref is TRANSPORT
940+
METADATA, NOT attested; `additionalProperties: false` forbids it here. The
941+
`evidence_id` is computed over this pre-evidence-ref response.
925942
required: [status, released]
926943
additionalProperties: false
927944
properties:

0 commit comments

Comments
 (0)