docs: cryptography deep dives#214
docs: cryptography deep dives#214marc0olo wants to merge 2 commits intoinfra/learn-hub-migration-prepfrom
Conversation
Add docs/concepts/certified-data.md covering the certified query response mechanism: single public key verification, certified state tree, certified variables interface, and applications (certified assets, Internet Identity). Expand docs/concepts/chain-key-cryptography.md with context on why threshold ECDSA is harder than BLS (asynchronous network, robustness requirements, protocol papers) and how Schnorr/EdDSA protocols are simplified variants. Link to new certified-data.md. Update docs/concepts/index.md and docs/guides/backends/certified-variables.md to reference certified-data.md. All 4 staging files under .migration/learn-hub/.../chain-key-cryptography/ consumed and deleted.
|
Review notes This PR is clean. No broken links, no banned patterns, frontmatter complete (including One optional improvement (not blocking): Ready to merge. |
|
Two issues to address before merging: 1. Em-dashes in
|
| File | Current order | Proposed order |
|---|---|---|
certified-data.md |
11 | 10 |
| chain-fusion | (current) | 11 |
vetkeys.md |
11 | 12 |
| security | (current) | 13 |
| governance | (current) | 14 |
Please verify the full ordering in the concepts sidebar before adjusting, as the right numbers depend on what other pages occupy orders 10 and above.
|
Content accuracy follow-up — The new subsection on key resharing states:
The Learn Hub source material only describes resharing occurring when subnet membership changes (e.g., node rotation). It does not describe periodic intra-subnet resharing as an adaptive adversary defense mechanism. This claim may be accurate — it is consistent with how proactive secret sharing works in threshold cryptography — but it goes beyond what the migration source supports. Please verify it against the IC interface spec or If not verifiable from available sources, the sentence should be narrowed to what is confirmed:
|
- Replace 4 em-dashes in certified-data.md with commas, colon, or parentheses - Resolve sidebar order collision: vetkeys 11->12, security 12->13 (certified-data stays at 11 in the sequence after chain-fusion at 10) - Narrow the resharing claim in chain-key-cryptography.md to what is confirmed from source material: resharing runs on membership changes, not described as periodic proactive secret sharing
|
Feedback addressed:
|
Summary
docs/concepts/certified-data.md— new concept page explaining: the verification problem (compare to Bitcoin SPV / Ethereum light clients), how ICP's single root public key enables chain-wide certificate verification, the certified state tree mechanism, certified variables interface, and applications (certified assets, Internet Identity)docs/concepts/chain-key-cryptography.md— adds context on why threshold ECDSA is significantly harder to implement than threshold BLS (asynchronous network requirement, robustness against 1/3 faulty nodes, protocol papers); notes that Schnorr/Ed25519 protocols are simplified variants with the same propertiesdocs/concepts/index.md— adds certified-data.md entry in the cryptography sectiondocs/guides/backends/certified-variables.md— links to the new concept page for background.migration/learn-hub/.../chain-key-cryptography/Sync recommendation
informed by learn hub staging files — chain-key-cryptography section