Architecture

Direct enough to use.
Documented enough to inspect.

Pastey combines local encrypted payload storage, UDP LAN discovery, temporary HTTP transfer endpoints, and a binary chunk transport.

01

Discover

Nearby devices advertise and discover active sessions on the same LAN. An 8-digit room code remains the manual fallback.

02

Encrypt

Text becomes bytes. Files and images remain generic binary data. Payload encryption and decryption happen locally.

03

Schedule

The frontend plans the ordinary file queue; one Rust capacity boundary admits both ordinary and managed transfers before the established single-file path.

04

Transfer

Binary-v1 encrypts, chunks, streams, acknowledges, and finalizes files over the local peer endpoint. JSON/base64 remains a compatibility fallback.

Current boundaries

Clear about what exists now.

Implemented: encrypted local storage, LAN discovery, nearby join, binary-v1 transfer, compatibility fallback, and validation tooling.

Experimental or diagnostic: planner shadow diagnostics and broader device-capability work.

Not current: cloud relay, remote storage, bundle transfer, binary-v2, substream multiplexing, or a second transfer stack.