Skip to content

Index

diapason.mesh

Device Mesh — this Diapason installation among the user's other devices.

The mesh sits ABOVE the domain, never inside it: Succès remains the single source of truth for tasks, projects and notes (spec §34), and the mesh only answers three questions the domain cannot — which devices exist, which are reachable, and what may be asked of them.

Layers, built in this order: * identity — this device's Ed25519 key pair and derived device id. * (next) registry — the devices this one has paired with. * (next) presence / commands — reachability and the signed bus.

DeviceIdentity dataclass

This device, as the rest of the mesh may know it.

to_public_dict()

Everything shareable — and nothing else. No private key, ever.

device_identity(*, name='')

This device's identity, creating the key pair on first call.

Idempotent: subsequent calls read what the first one wrote. The private key is generated once and never regenerated silently — a device whose key changed would be, to every peer, a different device.

public_identity()

What this device may publish about itself.

sign_envelope(payload)

Sign payload with this device's private key. Returns base64.

verify_envelope(payload, signature_b64, public_key)

True when signature_b64 is this payload, signed by public_key.