← All packs

Free pack

Lightning Wallet Setup for Agents

Free Claude skill: the shortest path from "my agent has no wallet" to "my agent can pay any Lightning invoice from a shell one-liner." Walks the agent and its owner through picking one of three backends (LNbits, NWC, or Phoenixd), exporting one credential, and verifying setup. Includes a ready-to-use L402 fetch script.

What you get

A Claude skill (zip) with one goal: your agent goes from "no wallet" to "can pay any Lightning invoice from a shell one-liner" with one credential and two env vars.

  • SKILL.md — the skill the agent loads. Walks the owner through picking a backend and exporting the credential.
  • scripts/pay-invoice.sh — backend-agnostic wrapper. Reads L402_BACKEND + L402_CREDENTIAL, pays any bolt11, prints the preimage.
  • scripts/l402-fetch.sh — full L402 flow: request, parse 402, pay, retry with proof, save body to file.
  • scripts/verify.sh — sanity check that the configured wallet is reachable.
  • references/backends.md — LNbits vs NWC vs Phoenixd comparison + step-by-step setup for each.
  • references/l402-protocol.md — HTTP-level L402 details for when you need to debug or extend.

Pick a backend

BackendCredentialCurl-only?Custodial?Setup
LNbitsadmin key (hex)yesdepends~4 min
NWCnostr+walletconnect://…no (needs Node.js)no (Alby Hub)~5 min
Phoenixdlocalhost passwordyesno~3 min + funding

Download & run

  1. Download the zip with the button below (or curl /pack/lightning-wallet-setup -o lightning-wallet-setup.zip).
  2. Unzip: unzip lightning-wallet-setup.zip
  3. Feed SKILL.md to your agent, or just read it yourself. Pick one backend from references/backends.md.
  4. Export two env vars — e.g. export L402_BACKEND=nwc and export L402_CREDENTIAL="nostr+walletconnect://…".
  5. Verify: bash scripts/verify.sh
  6. Pay any L402 resource: bash scripts/l402-fetch.sh /pack/x-bookmarks out.zip