Crypto specification for temporary secret handoffs.
This guide documents the product crypto boundary Shhhs exposes publicly: supported secret content is encrypted before upload, key material stays out of server-readable URLs, and operational systems work with ciphertext plus metadata.
01
Client-side boundary
Secret creation flows encrypt in the browser, CLI, or local MCP adapter before upload. The Worker stores ciphertext, IVs, lifecycle metadata, and access-state metadata, not plaintext secret content.
Browser encryption
CLI local encryption
MCP local adapter
02
URL fragment key placement
Private key material belongs in the URL fragment or local client state, not in query strings, paths, analytics, logs, social previews, or server-readable storage.
Fragment is client-side
No key in query params
Preview-safe no-fragment pages
03
Envelope model
Encrypted handoffs use payload envelopes that include algorithm/version metadata, ciphertext, IV/nonce material, and safe lifecycle data needed to enforce TTL, views, burn, and owner-only reveal.
Versioned envelopes
Lifecycle metadata
No plaintext metadata derived from the secret
04
Request links and submissions
Request flows separate the owner link, recipient submission, gate validation, and owner-only reveal. The recipient submits encrypted content; the owner reveals from the console.
Owner-only reveal
Gate validation
Submission lifecycle
05
Private Rooms
Private Rooms store encrypted messages and participant metadata. Invite rooms keep room key material in the browser fragment; direct token rooms wrap room access for known account tokens.
Invite room fragment
Direct token wrapping
No message plaintext in admin
06
Non-goals
This page is not an external audit, formal proof, certification, or promise that every future integration has identical properties. Changes to cryptographic algorithms require governance, tests, migration notes, and review.
No certification claim
No secret recovery
No unsupported E2EE claim
FAQ
Can this guide include private links?
No. Public guides never include secret identifiers, room ids, full private URLs, fragments, filenames, or payload-derived text.
Is this a certification or audit?
No. It is product documentation for deployed boundaries. External audits, DPAs, SLAs, and certifications require separate evidence and review.
Does Shhhs recover secrets?
No. Shhhs support can help with billing and metadata-only support, but cannot decrypt or recover secret content.