Skip to content

docs: add protocol configuration page - #57

Merged
heeckhau merged 3 commits into
masterfrom
docs/protocol-configuration
May 27, 2026
Merged

docs: add protocol configuration page#57
heeckhau merged 3 commits into
masterfrom
docs/protocol-configuration

Conversation

@heeckhau

@heeckhau heeckhau commented May 11, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds docs/protocol/configuration.md — a reference page for the configuration surface of the core TLSNotary protocol crates.
  • Covers TlsClientConfig, VerifierConfig, ProveConfig, MpcTlsConfig (MPC mode), and ProxyTlsConfig (Proxy mode).
  • Includes a sizing checklist and an extended explanation of online vs deferred decryption.
  • Slots in at sidebar_position: 7, after Server Identity Privacy.

The page is structured so that mode-independent options come first, then the two mode-specific config sections side by side, reflecting the asymmetry between MPC (heavy preallocation) and Proxy (minimal).

heeckhau added 2 commits May 19, 2026 09:34
Documents the configuration surface of the core TLSNotary protocol
crates: TlsClientConfig, VerifierConfig, ProveConfig, MpcTlsConfig
(MPC mode) and ProxyTlsConfig (Proxy mode), plus sizing guidance and
the online-vs-deferred decryption explanation.
Editorial pass over the protocol configuration page
@heeckhau
heeckhau force-pushed the docs/protocol-configuration branch from bacdee5 to 8cd4e99 Compare May 19, 2026 09:23
@heeckhau
heeckhau marked this pull request as ready for review May 19, 2026 09:23
@heeckhau
heeckhau requested a review from th4s May 19, 2026 09:23

@th4s th4s left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 reads very good

Comment thread docs/protocol/configuration.md Outdated
Comment thread docs/protocol/configuration.md Outdated
Comment thread docs/protocol/configuration.md Outdated
Comment thread docs/protocol/configuration.md
- Fix inaccurate claim that the session is rejected when max_recv_data_online != max_recv_data with defer_decryption_from_start=false (it actually aborts mid-stream at runtime).
- Document ProverControl for toggling online decryption mid-session.
- Tighten Network setting recommendation and minor prose cleanup.
@heeckhau
heeckhau merged commit 796a61b into master May 27, 2026
1 check passed
@heeckhau
heeckhau deleted the docs/protocol-configuration branch May 27, 2026 09:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants