v1.0.0

v1.0.0 — Wallet-scoped API

Breaking changes

• All wallet operations now go through client.Wallet(walletId) instead of top-level methods
• CreateWalletRequest removed — Wallets.CreateAsync() takes no parameters
• Wallets.CurrentAsync() removed — use client.Wallet("current").GetAsync() with a wallet key
• Wallets.UpdateAsync() moved to client.Wallet(id).UpdateAsync()

New features

• Wallet-scoped API — client.Wallet(id) returns a typed WalletScope with sub-resources
• Account registration — client.RegisterAsync()
• Identity check — client.MeAsync()
• Wallet key management — wallet.Key.CreateAsync(), .GetAsync(), .DeleteAsync(), .RotateAsync()
• Public invoice creation — client.Invoices.CreateForWalletAsync(), .CreateForAddressAsync()
• Payment target resolution — wallet.Payments.ResolveAsync(target)

Testing

• 90 unit tests
• 56 integration tests

v0.5.0

What's new

• L402 paywall support — client.L402.CreateChallengeAsync(), client.L402.VerifyAsync(), client.L402.PayAsync()
• Removed client.Keys.ListAsync() — server endpoint removed (key listing is a local CLI operation)

Breaking changes

• Keys.ListAsync() removed
• ApiKeyResponse type removed

v0.4.0

Initial release of the official .NET SDK for LnBot — Bitcoin for AI Agents.

Features

• Zero dependencies — System.Net.Http + System.Text.Json only
• Async-first — every method returns Task<T> with CancellationToken support
• Typed exceptions — BadRequestException, NotFoundException, ConflictException, UnauthorizedException, ForbiddenException
• SSE support — WatchAsync returns IAsyncEnumerable<T> for real-time events
• Nullable reference types — fully annotated

Install

dotnet add package LnBot

Resources

• Wallets — create, get, update
• Invoices — create, list, get, watch (SSE)
• Payments — create, list, get, watch (SSE)
• Addresses — create, list, delete, transfer
• Transactions — list with pagination
• Webhooks — create, list, delete
• API Keys — list, rotate
• Events — real-time wallet event stream
• Backup — recovery passphrase, passkey
• Restore — recovery passphrase, passkey