RFC-0026 · Reference catalog
Versioned draft snapshot
RFCs, reference catalogs, and evidence reflect Spec 3b2e3e7a114fb826b1445d39a48756b8fff629cd. Counts and pending/status notes belong to that snapshot. Read the dated project update for later progress.
Source repositories are private during staging. Links marked “repository access required” need access to the linked repository.
Generated reference catalog. This page renders structured Lean data for RFC-0026: defined terms, diagnostics, dependencies, and invariants. It does not establish proof coverage or runtime conformance. The authored narrative lives in
RFC-0026.This page is generated from the
lean/Gnomon/Spec/module for RFC-0026. Edit that source and regenerate this catalog.
Title: gRPC Protocol Binding
Status: draft
Depends on: RFC-0001, RFC-0006, RFC-0008, RFC-0024
Extended by: RFC-0030, RFC-0034
Proof citations in source: 4 / 4. Standalone proof verification is pending.
Definitions
(none defined)
Diagnostics
| Code | Severity | Description |
|---|---|---|
M26610 | Error | gRPC transient status code (UNAVAILABLE or DEADLINE_EXCEEDED) received with no matching transient selector in the errors {} block. |
M26611 | Error | gRPC auth error (UNAUTHENTICATED or PERMISSION_DENIED) received with no matching selector in the errors {} block. |
M26612 | Error | gRPC NOT_FOUND status received with no matching selector in the errors {} block. |
M26613 | Error | gRPC status code not covered by special cases received with no matching selector in the errors {} block. |
M26614 | Error | tls: none is set on a client in a production environment. Startup is aborted. |
M26615 | Error | service: or rpc: slot missing from a gRPC operation; or streaming mode constraints violated (incorrect input or returns shape for declared mode:). |
M26616 | Error | A gRPC call exceeded its deadline: and was cancelled by the runtime. Reported to the caller as DEADLINE_EXCEEDED. |
Dependency neighborhood
graph LR
nRFC_0026["RFC-0026"]
nRFC_0001["RFC-0001"]
nRFC_0026 --> nRFC_0001
nRFC_0006["RFC-0006"]
nRFC_0026 --> nRFC_0006
nRFC_0008["RFC-0008"]
nRFC_0026 --> nRFC_0008
nRFC_0024["RFC-0024"]
nRFC_0026 --> nRFC_0024
nRFC_0030["RFC-0030"]
nRFC_0030 --> nRFC_0026
nRFC_0034["RFC-0034"]
nRFC_0034 --> nRFC_0026
Invariants
- A gRPC call exceeding its deadline must be cancelled by the runtime immediately upon expiry and reported as DEADLINE_EXCEEDED via M26616. (enforced by: runtime)
- An operation with mode bidi-streaming must have exactly one Stream
input field and a Stream returns type. (enforced by: compile-time) - An operation with mode client-streaming must contain exactly one input field of type Stream
, otherwise the compiler emits M26615. (enforced by: compile-time) - An operation with mode server-streaming must declare a returns type of Stream
, otherwise the compiler emits M26615. (enforced by: compile-time) - Implementations must propagate the deadline as a gRPC deadline on the outgoing call so the server is also notified, not merely as a client-side timer. (enforced by: runtime)
- In a production environment the runtime must reject any client with tls: none and raise M26614 as a startup-time error, refusing to start. (enforced by: runtime)
- gRPC connections default to TLS using the system certificate store and require no explicit configuration. (enforced by: runtime)
- gRPC status codes outside the special cases and not matched by any errors selector must be treated as non-retryable and reported as M26613. (enforced by: runtime)
Normative Statements
Statements are structured source data. Proof citations, where present, have not passed a standalone Gnomon proof gate.
Auth
- MUST — Authors needing api-key or basic auth MUST use auth: none and inject credentials via custom interceptors.
Call Mode Semantics
- MUST — bidi-streaming operations MUST have one Stream
input field and Stream returns. - MUST — client-streaming operations MUST contain exactly one input field of type Stream
. - MUST — server-streaming operations MUST declare returns as Stream
. (proof citation: rfc0026_b8_grounded; verification pending)
Slot Extensions
- MUST — A cancelled deadline-exceeded call MUST produce M26616 and be reported as DEADLINE_EXCEEDED. (proof citation:
rfc0026_b5_grounded; verification pending) - MUST — A gRPC call exceeding its deadline MUST be cancelled by the runtime immediately upon expiry.
- MUST — Implementations MUST propagate the deadline as a gRPC deadline on the outgoing call so the server is notified.
TLS Configuration
- MUST — In production environments the runtime MUST reject any client with tls: none and raise M26614, refusing to start. (proof citation:
rfc0026_b3_grounded; verification pending) - MUST — The runtime MUST detect the active environment at startup.
gRPC Status Code Taxonomy
- MUST — Unlisted unmatched gRPC status codes MUST be treated as non-retryable and reported as M26613. (proof citation:
rfc0026_b12_grounded; verification pending)
Linked References
| Direction | Target |
|---|---|
| Depends on | RFC-0001 |
| Depends on | RFC-0006 |
| Depends on | RFC-0008 |
| Depends on | RFC-0024 |
| Extended by | RFC-0030 |
| Extended by | RFC-0034 |