How thesourcebuild/cipherworkbench works
Cipher Workbench is a local-first cryptography suite for browser and Electron users. The main workflow is selecting a tool, supplying and configuring input, running a tool-family computation, then inspecting or verifying the result. Its architecture combines a shared tool registry and execution engine with algorithm packages, specialized certificate/PKI operations, and platform adapters. The README documents the broad tool families and offline execution; edges based on unsampled subsystems are included only where that documentation supports the relationship.
Main entry points: tool-workbench.tsx Tool workbench · app-shell.tsx Workbench shell · compute.ts Certificate operations · chain-verifier.ts Chain verification
Components 21
Workbench experience
- Workbench shell
apps/web/app/app-shell.tsx - Tool navigation
apps/web/app/sidebar.tsx - Tool workbench
apps/web/app/tool-workbench.tsx - Input and options
apps/web/app/input-panel.tsx - Results and verification
apps/web/app/result-panel.tsx
Shared runtime
- Tool registry
packages/cipher-registry/src/index.ts - Tool definitions
packages/cipher-engine/src/tool-definition.ts - Input codecs
packages/cipher-engine/src/codec/bytes.ts - Text encodings
packages/cipher-engine/src/codec/text.ts - Platform adapter
packages/platform/src/web.ts
Tool families
- Hashes, ciphers, KDFs
packages/tools/hash/src/bindings.ts - Other tool families
packages/tools/asymmetric/src/compute.ts - CRC computation
packages/algos/src/crc/engine.ts
Certificates and PKI
- Certificate operations
packages/tools/certificates/src/compute.ts - ASN.1 parsing
packages/tools/certificates/src/asn1/asn1.ts - X.509 parsing
packages/tools/certificates/src/asn1/x509.ts - Chain verification
packages/tools/certificates/src/asn1/chain-verifier.ts
Platform shells
- Web app
apps/web/app/page.tsx - Electron shell
apps/desktop/src/main/index.ts - App protocol
apps/desktop/src/main/protocol.ts
Other components
- Developer
Connections 24
- Developer → Web app: opens suite
- Web app → Workbench shell: renders
apps/web/app/page.tsx - Workbench shell → Tool navigation: shows navigation
apps/web/app/app-shell.tsx - Workbench shell → Tool workbench: shows selected tool
apps/web/app/app-shell.tsx - Tool navigation → Workbench shell: selects tool
apps/web/app/app-shell.tsx - Tool workbench → Input and options: collects input
- Tool workbench → Tool registry: loads tool
- Tool registry → Tool definitions: uses manifests
- Input and options → Input codecs: encodes input
- Input codecs → Text encodings: decodes text
packages/cipher-engine/src/codec/bytes.ts - Tool workbench → Hashes, ciphers, KDFs: runs operation
- Tool workbench → Other tool families: runs operation
- Tool workbench → CRC computation: runs operation
- Tool workbench → Certificate operations: runs operation
- Tool workbench → Results and verification: presents result
- Certificate operations → ASN.1 parsing: parses artifacts
packages/tools/certificates/src/compute.ts - Certificate operations → X.509 parsing: uses X.509 tools
packages/tools/certificates/src/compute.ts - Certificate operations → Chain verification: verifies chains
packages/tools/certificates/src/compute.ts - Chain verification → ASN.1 parsing: parses DER
packages/tools/certificates/src/asn1/chain-verifier.ts - Chain verification → X.509 parsing: parses certificates
packages/tools/certificates/src/asn1/chain-verifier.ts - Workbench shell → Platform adapter: uses adapter
apps/web/app/app-shell.tsx - Developer → Electron shell: opens suite
- Electron shell → App protocol: serves app origin
apps/desktop/src/main/index.ts - Electron shell → Web app: loads shared UI