livybolt (livybolt)

Accountless, self-custody, end-to-end-encrypted surveys over Lightning.

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

Install

npm i -g livybolt   # installs the `livybolt` command
livybolt --help

Requires Node.js ≥ 20.

Quick start

livybolt id new --keychain                             # self-custody key (macOS: password kept in Keychain)
#   or: livybolt id new --password "<a strong passphrase>"
livybolt create survey.json                            # → Lightning invoice + handle
#   ...pay the invoice with any wallet...
livybolt create --resume <handle> --preimage <hex>     # → public URL, sealed to your vault
livybolt balance --survey <id>                         # prepaid-pool accounting
livybolt vault read --survey <id>                       # pull + decrypt responses locally
livybolt unlock --survey <id> --count <n>              # pay to read overage responses

A minimal survey.json:

{
  "title": "Launch feedback",
  "expected_responses": 100,
  "per_response_sats": 50,
  "questions": [
    { "id": "q1", "text": "How did you hear about us?", "type": "short_text" },
    { "id": "q2", "text": "How likely are you to recommend us?", "type": "rating" }
  ]
}

Self-custody

Your keys live only in ~/.livybolt/. They are never sent to the server, which stores ciphertext and public keys only. Back up the seed words — run livybolt id backup in a terminal to see them once and confirm; until then every command reminds you with seed_backup=pending. There is no recovery without them.

Docs

• CLI reference: https://livybolt.com/docs/cli
• Running headless / as an LLM agent: see AGENTS.md in this package