Skip to content

docs(specs): establish protocol terminology - #19

Draft
Wondertan wants to merge 5 commits into
mainfrom
docs/ceremony-terminology
Draft

docs(specs): establish protocol terminology#19
Wondertan wants to merge 5 commits into
mainfrom
docs/ceremony-terminology

Conversation

@Wondertan

@Wondertan Wondertan commented Aug 22, 2026

Copy link
Copy Markdown
Member

Summary

This PR establishes the protocol vocabulary and system model used by the ceremony specification. It is stacked on #20 so its naming choices can be reviewed without delaying the protocol changes.

Changes

Application and integration roles

  • Define Application and Application Deployment for the user-facing product and its frontend, backend, OAuth-client, redirect, and proving infrastructure.
  • Define Identity Integrator as the party that deploys or maintains an Identity Integration.
  • Rename the chain-side Consumer to Identity Integration.

Ledger and verification roles

  • Rename Consumer Chain to Execution Ledger.
  • Rename Chain ID, chainId, and Chain Profile to Ledger ID, ledgerId, and Ledger Profile.
  • Rename the shared Proof Verifier to Verifier Dispatcher.
  • Rename each ledger-specific platform verifier to Ledger OAuth Platform Proof Verifier (LOPPV); the implementation-neutral selector remains Platform Ceremony Version.

Browser and proof terms

  • Rename Canonical Runtime to Ceremony Client and Redirect Runtime to Ceremony Popup.
  • Rename the verifier input from Submission to OAuth Proof, distinguishing it from both the Execution Ledger transaction and the zero-knowledge proof.
  • Update the system diagram, role tables, assumptions, requirements, tests, and security prose to use those terms consistently.

Scope

This is a naming and system-model change. It does not change nonce construction, ceremony lifecycle, proof delivery, platform endpoints, or verifier behavior.

Validation

  • git diff --check
  • Old-term consistency search across all three normative files

@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from 6d3d8fb to 590551b Compare August 22, 2026 00:38
@Wondertan
Wondertan changed the base branch from main to docs/ceremony-browser-contract August 22, 2026 00:40
@Wondertan
Wondertan force-pushed the docs/ceremony-browser-contract branch from 4244b9b to f0955bb Compare August 22, 2026 00:46
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from 590551b to 77a6217 Compare August 22, 2026 00:46
@Wondertan
Wondertan force-pushed the docs/ceremony-browser-contract branch from f0955bb to 3ef62fd Compare August 24, 2026 12:45
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from 77a6217 to 4cd51fd Compare August 24, 2026 12:45
@Wondertan
Wondertan force-pushed the docs/ceremony-browser-contract branch from 3ef62fd to 88765ad Compare August 24, 2026 12:51
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from 4cd51fd to ed5719e Compare August 24, 2026 12:51
Co-authored-by: xgreenx <xgreenx9999@gmail.com>
Signed-off-by: Wondertan <hlibwondertan@gmail.com>
@Wondertan
Wondertan force-pushed the docs/ceremony-browser-contract branch from 88765ad to ab3a70b Compare August 24, 2026 18:59
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from ed5719e to 8413039 Compare August 24, 2026 18:59
Signed-off-by: Wondertan <hlibwondertan@gmail.com>
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from f4a9373 to f532c60 Compare August 24, 2026 20:08
Signed-off-by: Wondertan <hlibwondertan@gmail.com>
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from f532c60 to 2b6c484 Compare August 24, 2026 20:34
Wondertan and others added 2 commits August 24, 2026 21:38
Signed-off-by: Wondertan <hlibwondertan@gmail.com>
Co-authored-by: xgreenx <xgreenx9999@gmail.com>
Signed-off-by: Wondertan <hlibwondertan@gmail.com>
@Wondertan
Wondertan force-pushed the docs/ceremony-terminology branch from 2b6c484 to 1a2fa80 Compare August 24, 2026 20:40
@Wondertan
Wondertan marked this pull request as draft September 2, 2026 19:31
Base automatically changed from docs/ceremony-browser-contract to main September 3, 2026 09:07
@Wondertan

Copy link
Copy Markdown
Member Author

This is still wanted and awaits until protocol settles so we can rename everything at once

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.

1 participant