Skip to content

docs(arch): Mermaid diagrams for DeRoT key issuance, VM upgrade, and trust verification#32

Open
Garandor wants to merge 1 commit intonextfrom
more-deployment-docs
Open

docs(arch): Mermaid diagrams for DeRoT key issuance, VM upgrade, and trust verification#32
Garandor wants to merge 1 commit intonextfrom
more-deployment-docs

Conversation

@Garandor
Copy link
Copy Markdown
Contributor

Summary

  • derot-key-issuance.md — sequence diagram: CVM boot → TDX attestation → Onchain KMS verifies quote + DstackKms OS whitelist + DstackApp compose-hash whitelist → keys issued
  • vm-code-upgrade.md — flowchart: build new image → compute compose-hash → governance tx to whitelist on DstackApp → deploy → new CVM boot → key issuance (blocked if whitelist not in place)
  • trust-stack-verification.md — two diagrams: (1) four-layer trust model overview (Application / Platform / Network / Governance), (2) detailed verifier sequence (fetch attestation from /.dstack/, Intel DCAP quote check, Base contract checks, TLS/evidence/CAA checks); plus the full VR-1–VR-4 checklist table

All diagrams reference existing requirements in planning/requirements.md and planning/PLAN.md.

Test plan

  • Render diagrams in GitHub PR preview to confirm Mermaid syntax is valid
  • Read through each diagram against the Phala docs to confirm flow accuracy

🤖 Generated with Claude Code

@cl4wb0t cl4wb0t force-pushed the more-deployment-docs branch 2 times, most recently from 2ae0294 to 9dbf34a Compare March 2, 2026 17:37
…and trust verification

Three new architecture docs in architectureDocs/deployment/:

- derot-key-issuance.md — sequence diagram of how a CVM obtains its keys
  from Onchain KMS (DstackApp + DstackKms contracts on Base)
- vm-code-upgrade.md — flowchart of the full upgrade lifecycle: build,
  governance whitelist approval, deploy, and key issuance for the new code
- trust-stack-verification.md — four-layer trust model (Application,
  Platform, Network, Governance) with both a layer overview diagram and a
  detailed verifier sequence diagram; includes the full VR-1–VR-4 checklist

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cl4wb0t cl4wb0t force-pushed the more-deployment-docs branch from 9dbf34a to 8c813fe Compare March 2, 2026 17:37
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