LNCurl primary sources — 2026-05-03

Project status in this pass

  • No canonical standalone LNCurl whitepaper or litepaper surfaced.
  • The clearest current source of truth is the official site, the canonical GitHub README, the machine-readable llms.txt, the public skill doc, and the live stats endpoint.
  • The project is best understood as a disposable agent-wallet bootstrap layer built on NWC rather than as a conventional wallet app.

Primary-source snapshots

1) Canonical repository / README

  • URL: https://raw.githubusercontent.com/rolznz/lncurl/master/README.md
  • Key excerpt:
    • The README says “Lightning wallets for agents. One curl. That’s it.”
    • It says the service is an “agent-first custodial Lightning wallet service” where a wallet is created with one HTTP call.
    • It also says wallets cost 1 sat per hour to maintain and are deleted when they can’t pay.

2) Official machine-readable docs

  • URL: https://lncurl.lol/llms.txt
  • Key excerpt:
    • The llms.txt file says the wallet starts at 0 sats, costs 1 sat per hour, is rate-limited to 10 wallets per hour per IP, and is permanently deleted when it can’t pay the hourly charge.
    • It documents POST /api/wallet and POST / as wallet-creation endpoints that return an NWC URI.
    • It also explicitly calls the product custodial and says it is ideal for quick tests rather than large balances.

3) Agent skill doc

  • URL: https://raw.githubusercontent.com/rolznz/lncurl/master/frontend/public/SKILL.md
  • Key excerpt:
    • The skill file frames LNCurl as “Disposable Lightning wallets” for temporary wallets, testing, and bootstrapping child agents.
    • It repeats the no-signup, no-KYC positioning and the 1 sat per hour maintenance cost.
    • It also explains that the returned NWC URI contains a lud16 field for receiving sats and a secret for NWC operations.

4) Operational telemetry

  • URL: https://lncurl.lol/api/stats
  • Key excerpt:
    • The live stats endpoint exposed active operational metrics during this pass, including total wallets created, wallets that had died, total charges collected, peak concurrent wallets, current live wallets, node liquidity, and node alias/pubkey.
    • That telemetry materially strengthens the interpretation of LNCurl as a running wallet service rather than a documentation-only experiment.

5) Official landing page

  • URL: https://lncurl.lol/
  • Key excerpt:
    • The page title describes LNCurl as “Bitcoin lightning wallets for agents,” reinforcing the machine-first product framing presented in the README and llms.txt.

Working conclusion

LNCurl is best cataloged as agent-first Lightning wallet bootstrap infrastructure. The deciding evidence in this pass was the combination of one-call wallet creation, NWC URI output, disposable economics built around hourly wallet decay, explicit temporary-use guidance, and public operational telemetry.