v0.5.0

What's new

• L402 paywall support — ln.l402.createChallenge(), ln.l402.verify(), ln.l402.pay()
• Get/watch by payment hash — ln.invoices.get() and ln.payments.get() now accept number | string
• Removed ln.keys.list() — server endpoint removed (key listing is a local CLI operation)

Breaking changes

• keys.list() removed
• ApiKeyResponse type removed

v0.4.0

What's new

• Wallet event stream: events.stream() — real-time SSE stream of all wallet activity
• preimage field added to InvoiceResponse and PaymentResponse
• serviceFee field added to PaymentResponse
• New types: WalletEvent, WalletEventType, EventsResource

v0.3.0

What's new

• Payment watch: payments.watch() SSE stream for real-time payment events (settled/failed)
• Unauthenticated invoice creation: invoices.createForWallet() and invoices.createForAddress() — no API key required
• LNURL support: payments.create() now accepts LNURL targets alongside Lightning addresses and BOLT11 invoices
• New types: PaymentEvent, CreateInvoiceForWalletRequest, CreateInvoiceForAddressRequest, AddressInvoiceResponse

v0.1.1

Initial release

Official TypeScript SDK for the LnBot Lightning Network API.

Highlights

• Wallet creation, balance, and management
• Create and pay BOLT11 invoices
• Lightning address support (create, delete, transfer)
• Real-time invoice settlement via SSE
• Webhook management
• Backup and restore (recovery passphrase + passkey)
• Typed errors (BadRequestError, NotFoundError, ConflictError)
• Zero dependencies, ESM + CJS, full TypeScript types

Install

npm install @lnbot/sdk

Documentation · npm