Documentation

How Livybolt works

Livybolt is an accountless survey tool. You pay one Lightning invoice to create a survey, respondents answer for free, and every response is end-to-end encrypted to a key only you hold. There are no accounts, and the server can never read your data.

The model in one minute

Three roles, one server:

Two keys, and why it matters

The thing that trips people up: there are two different keys, and only one of them encrypts anything.

KeyRoleEncrypts responses?
Identity key (livybolt id)Locks your local vault file at rest. Never sent to the server.No — local storage lock only
Per-survey keyDerived from your seed, one per survey. Its public half is the encryption_pubkey; its private half decrypts responses and signs your reads.Yes — this is the one

In the CLI, the per-survey key is derived from your seed automatically — the vault only records which index each survey used, so the key itself never needs storing and re-derives on demand (even after a fresh vault rebuild).

End-to-end encryption is mandatory. Livybolt has no plaintext path. Every survey is sealed to a key you control; there is no option to collect readable answers.