Crypto specification

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.