Uh oh!
There was an error while loading. Please reload this page.
Deep Dive rewrite: align every page to the current architecture - #43
Conversation
Preview deployment for your docs. Learn more about Mintlify Previews.
|
255d316 to
b6c72b9Comparea751e61 to
b8c7afbCompare… replaces threshold-network content
… and current SDK signatures
…tecture.svg with Mermaid
…and commitment leg, replace Transactions.svg with Mermaid
…s and the ZK Verifier, replace Encrypt-a-value.svg with Mermaid
…testnet claim on host chains
…detail lives on its own page
…ing public retrieval
…ts and the rewritten decryption page
…ermit builder renamed in 0.7
| ## Trust model | ||
| The ZK Verifier runs inside a hardware-attested TEE (Intel TDX). Its signing key is held as Shamir shares by independent partners and released only to the exact attested code image. Neither the operator nor anyone else can sign approvals outside the reviewed program. See [Key Management](/deep-dive/cofhe-components/key-management) for how shares are created and released. After a successful verification, the service stores the ciphertext bytes in the CT Server and archives the inputs and proofs for auditability. | ||
| The ZK Verifier runs inside a hardware-attested TEE (Intel TDX). Its signing key is held as Shamir shares by independent partners and released only to the exact attested code image. Neither the operator nor anyone else can sign approvals outside the reviewed program. See [Key Management](/deep-dive/cofhe-components/key-management) for how shares are created and released. After a successful verification, the component stores the ciphertext bytes in the CT Server. It also archives the inputs and their proofs in Google Cloud Storage for independent auditing. |
There was a problem hiding this comment.
It also archives the inputs and their proofs in Google Cloud Storage for independent auditing.
I'd change it to ->>>>>>>
It also archives the inputs and their proofs in a public and immutable Google Cloud Storage bucket for independent auditing.
Do you think it worth having an example how to verify us? cuz I built one here - https://github.com/FhenixProtocol/zee-k-verifier/blob/main/zk-verifier/scripts/verify_stored_ct.rs
There was a problem hiding this comment.
Half applied. "public" is in, so the line now says a public Google Cloud Storage bucket.
I left "immutable" out. I could not find anything that enforces it in zee-k-verifier: no object versioning, no object lock, no retention policy. Immutability is a security guarantee, and our style rule says to describe a control as active only if it is enforced. Point me at the bucket policy and I will add the word.
On the verification example, yes, it is the right idea. It makes "independent auditing" something a reader can actually do. We cannot link it yet, because zee-k-verifier is a private repo, and an external reader would get a 404. Haim wants to wait until that repo is public, then add it.
Uh oh!
There was an error while loading. Please reload this page.
…tyle entry states its TEE
Uh oh!
There was an error while loading. Please reload this page.
Rewrites the whole Deep Dive tab to match the deployed system. One commit per page, so pages stay cherry-pickable.
Every technical claim is verified against source:
cofhe-contracts, thecofheservices,zee-k-verifier, and the published@cofhe/sdk@0.7.1package.Pages
New
compute-pipeline— the four offchain components that carry a task from onchain event to committed result: slim listener, FheOS, FHE Engine, blockchain poster. Replaces the old FheOS Server and Slim Listener pages.teecryptor— the current decryption architecture, replacing the Threshold Network page.key-management— how the FHE key is born, split, and released to attested enclaves.Retired, with redirects
threshold-network,result-processor,ct-registry,slim-listener,fheos-server,off-chain-decryption-flow, andfhe-engine. All seven resolve to their successors. 24 redirects total, none chained.Rewritten
overview,task-manager,acl,plaintext-storage,commitment-registry,zk-verifier, the three data flows (the two decryption pages merged into one),future-plans, andresearch-in-fhenix.What changed in the content
isAllowedWithPermissionis a live ACL function..withPermit()was renamed to.withACP()in0.7, so the decryption flow samples did not work against the pinned version.externalEuintinputs with a batch proof,setConsumingContract,batchVerifyInputs, ACP on the wire, and the batch digest format.Diagrams
Every stale SVG is replaced with in-page Mermaid, styled by a shared theme (
scripts/mermaid-theme.jsonplus a sync script). Eight diagrams total. The overview shows big blocks only and hides the pipeline internals; the detail lives on the Compute Pipeline page. All eight render clean and are queued for a design pass in DOC-59.Style guide
STYLE.mdgains canonical names for the compute pipeline and its four components, drops the retired FheOS Server entry, and states that the ZK Verifier runs in its own TEE. "Component" replaces "service" across the tab.Checks
Lint, Vale, the compatibility version check, and broken-links all pass. Zero errors and zero warnings across all 14 pages.
Follow-ups
.withPermit()samples outside this tab.zee-k-verifieris public.what-is-cofhestill calls the Threshold Network the current decryptor.