v0.14.2

0.14.2

Added

• cdk-ffi: Add Payment Requests support ([thesimplekid]).
• cdk-ffi: Add multimint melt with mint functionality ([thesimplekid]).
• cdk-ffi: Add get wallets functionality ([thesimplekid]).
• cdk: Add MultiMintWallet function to check proofs state ([thesimplekid]).
• cdk: Add get_token_data and get_mint_keysets to MultiMintWallet ([thesimplekid]).
• cdk: Melt external support ([thesimplekid]).

Changed

• cdk: Swap before melt ([thesimplekid]).
• cdk: Use try proof in swap within melt ([thesimplekid]).

Fixed

• cdk-ffi: Check melt quote in FFI ([thesimplekid]).
• cdk: Use the client id from mint configuration ([lescuer97]).
• cdk: Fix proof selection with fees to ensure net amount meets target ([thesimplekid]).
• cdk: Do not remove melt quote ([thesimplekid]).
• cdk: Return TransactionUnbalanced error for empty swap inputs/outputs ([thesimplekid]).
• cdk: Fix connection pool resource initialization and path validation ([thesimplekid]).
• cdk: Fix WASM use web_time ([thesimplekid]).

v0.14.2-rc.5

Added

• cdk-ffi: Add Payment Requests support ([thesimplekid]).
• cdk-ffi: Add multimint melt with mint functionality ([thesimplekid]).
• cdk-ffi: Add get wallets functionality ([thesimplekid]).
• cdk: Add MultiMintWallet function to check proofs state ([thesimplekid]).
• cdk: Add get_token_data and get_mint_keysets to MultiMintWallet ([thesimplekid]).
• cdk: Melt external support ([thesimplekid]).

Changed

• cdk: Swap before melt ([thesimplekid]).
• cdk: Use try proof in swap within melt ([thesimplekid]).

Fixed

• cdk-ffi: Check melt quote in FFI ([thesimplekid]).
• cdk: Use the client id from mint configuration ([lescuer97]).
• cdk: Fix proof selection with fees to ensure net amount meets target ([thesimplekid]).
• cdk: Do not remove melt quote ([thesimplekid]).
• cdk: Return TransactionUnbalanced error for empty swap inputs/outputs ([thesimplekid]).
• cdk: Fix connection pool resource initialization and path validation ([thesimplekid]).
• cdk: Fix WASM use web_time ([thesimplekid]).

v0.14.2-rc.3

Added
cdk-ffi: Add multimint melt with mint functionality (thesimplekid).
cdk-ffi: Add get wallets functionality (thesimplekid).

Changed

cdk: Remove swap before melt (thesimplekid).

Fixed
cdk-ffi: Check melt quote in FFI (thesimplekid).
cdk: Use the client id from mint configuration ([lescuer97]).
cdk: Fix proof selection with fees to ensure net amount meets target (thesimplekid).
cdk: Do not remove melt quote (thesimplekid).

v0.14.1

0.14.1

Added

• cdk: Add MultiMintWallet human-readable address melt quote support (BIP353 and Lightning address) ([thesimplekid]).
• cdk-ffi: Add metadata cache TTL configuration methods ([thesimplekid]).

Changed

• cdk: Ensure mint info is loaded before quote operations ([thesimplekid]).
• cdk: Replace deferred database persistence with synchronous writes in mint metadata cache ([thesimplekid]).

Fixed

• cdk-ldk-node: Account for Lightning fee ([thesimplekid]).
• cdk-ffi: Fix postgres feature support ([thesimplekid]).
• cdk: Revert database contention prevention that caused issues ([thesimplekid]).

v0.14.0

0.14.0

Summary

This release focuses on reliability and robustness improvements across the codebase. The mint now implements saga patterns for both melt and swap operations, providing better error recovery and state consistency during these critical operations. Async melt processing has been added for improved throughput. The wallet gains a new Tor mint connector with isolated circuits support for enhanced privacy when communicating with mints, along with a MintMetadataCache that delivers significant performance improvements for key and metadata management. A new proof recovery mechanism automatically handles failed wallet operations. MultiMintWallet receives improvements including the ability to check and wait for mint quotes and configure internal wallets. NUT-11 SIG_ALL message aggregation has been updated to match the latest specification. On the infrastructure side, a generic pubsub module has been introduced in cdk-common, and cdk-ffi adds postgres support. Additional highlights include keyset amount tracking and SQL balance calculation optimization for improved performance, wallet functions to pay human readable addresses (BIP353 and Lightning address), invoice decoding for BOLT11 and BOLT12 in the FFI bindings, and a mutation testing infrastructure to ensure security-critical code coverage. The release also brings numerous bug fixes addressing database contention, HTLC witness handling, and quote state management.

⚠️ Important Migration Note
Be sure to backup your mint db before migration, as this update includes database schema changes.

Added

• cdk: Add wallet functions to pay human readable addresses (BIP353 and Lightning address) (thesimplekid).
• cdk-ffi: Add invoice decoding for bolt11 and bolt12 (thesimplekid).
• cdk: Add keyset_amounts table to track issued and redeemed amounts for improved performance (crodas).
• cdk: Add melt quote state transition validation (thesimplekid).
• cdk: Add payment request and proof to transaction records (thesimplekid).
• cdk: Add WebSocket authentication support (thesimplekid).
• cdk: Add proof recovery mechanism for failed wallet operations (crodas).
• cdk-ffi: Added postgres support (asmo).
• cdk: Optimize SQL balance calculation (vnprc).
• cdk: Add tor mint connector for wallet with isolated circuits support (lollerfirst).
• cdk-common: Introduce a generic pubsub module (crodas).
• cdk: Add MultiMintWallet check and wait for mint quotes (davidcaseria).
• cdk: Allow passing metadata to a melt (benthecarman).
• cashu: Include supported amounts instead of assuming the power of 2 (crodas).
• test: Add mutation testing infrastructure and security-critical coverage (thesimplekid).

Changed

• cdk: Introduce MintMetadataCache for efficient key and metadata management (crodas).
• cdk: Implement saga pattern for melt operations (thesimplekid).
• cdk: Implement saga pattern for swap operations (thesimplekid).
• cdk: Async melt processing (thesimplekid).
• cdk: Extract keyset key loading into helper method (thesimplekid).
• cdk: Update Wallet::fetch_mint_info (crodas).
• cdk-ffi: Update FFI Database Objects to Records (davidcaseria).
• cdk: Redesign Lightning invoice creation and display with better UX and status handling (erik).
• cdk: Configure internal Wallets of a MultiMintWallet (davidcaseria).
• cdk-ffi: Split uniffi types into multiple mods (davidcaseria).
• cdk-ffi: Make Uniffi Records Codable in Swift (davidcaseria).
• cdk: Replace proof swap with state check in error recovery (crodas).
• cdk: Simplify mint addition in MultiMintWallet (thesimplekid).
• cdk: Update NUT-11 SIG_ALL message aggregation per spec (SatsAndSports).
• cdk: Remove delete functions for quotes (thesimplekid).

Fixed

• cdk: Enable pure environment variable configuration for Lightning backends (thesimplekid).
• cdk: Prevent database contention in metadata cache load operations (crodas).
• cdk: Allow starting insecure mint server (thesimplekid).
• cdk: Load keyset keys from database to prevent duplicate insertions (thesimplekid).
• cdk: Fix missing try_proof_operation_or_reclaim wrapping of a swap (crodas).
• cdk: Don't read keys from the database unnecessarily (crodas).
• cdk: Return actual error from get_payment_quote (gudnuf).
• cdk: Require 0 signatures for HTLC with no pubkeys specified (thesimplekid).
• cdk: Fix NUT-14 disabled in info (thesimplekid).
• cdk: Check the removed_ys argument before creating the delete query (asmo).
• cdk: Add parent directory validation before database creation (thesimplekid).
• cashu: Skip serializing empty NUT15 settings in mint info (thesimplekid).
• cdk: Fix bug with websocket close (crodas).
• cdk: Fix htlc witness deserialization (stefanbitcr).
• cdk-lnbits: Fix msats error handling (thesimplekid).
• cdk: Handle fiat melt amount conversions (gudnuf).
• cdk: Only settle same unit quote internally (gudnuf).
• cdk: Revert redis cache removal (thesimplekid).
• cdk: Improve add transaction handling (thesimplekid).
• cdk: Read the latest mint quote status in a transaction to avoid race conditions (crodas).
• cdk: Fix websocket issues and mint quotes (crodas).
• cashu: Fix PreMintSecrets into_iter() (codingpeanut157).

v0.13.4

0.13.4

Fixed

• cdk-lnbits: Fix lnbits ws ([thesimplekid]).

v0.13.3

0.13.3

Fixed

• cdk-lnbits: Fix lnbits fee calc ([thesimplekid]).

v0.13.2

0.13.2

Added

• cashu: Add spending-condition inspection helpers and token_secrets() ([lollerfirst]).

Changed

• cdk: Make sorting Transactions a stable sort ([benthecarman]).
• Updated stable Rust to 1.85.0 ([thesimplekid]).

Fixed

• cdk-lnbits: Add websocket reconnection with exponential backoff ([thesimplekid]).
• cdk: Add parent directory validation before database creation ([thesimplekid]).
• cashu: Skip serializing empty NUT15 settings in mint info ([lollerfirst]).
• cdk: Improve Melted error handling and add debug logging ([thesimplekid]).
• cdk: Read the latest mint quote status in a transaction to avoid race conditions ([crodas]).

v0.13.1

0.13.1

Fixed

• cdk: Only settle same unit quote internally (gudnuf).
• cdk-cli: Show amounts correctly (thesimplekid).
• cdk-lnbits: Fix msats error handling (thesimplekid).
• cashu: Fix HTLC witness deserialization by adding prior signatures if they exist (stefanbitcr).

Changed

• cdk: Simplify mint addition in MultiMintWallet by removing unnecessary mint info fetching and keyset refresh (thesimplekid).
• cdk-ffi: Make UniFFI Records Codable in Swift (davidcaseria).

v0.13.0

Summary

Version 0.13.0 marks a major milestone for mobile development with the introduction of comprehensive native mobile bindings that enable building Cashu wallets for iOS and Android using Swift and Kotlin. The release introduces cdk-ffi, a new Foreign Function Interface crate that provides UniFFI-based bindings for Swift and Kotlin, with full wallet functionality including multi-mint support, BOLT12 payments, BIP-353 address resolution, and advanced features like P2PK conditions and authentication. Mobile bindings are distributed through dedicated repositories at https://github.com/cashubtc/cdk-kotlin and https://github.com/cashubtc/cdk-swift that provide native package management for Android/JVM and iOS/macOS platforms respectively. The release also delivers significant infrastructure improvements including an event-driven payment architecture with real-time notifications, enhanced database layer with generic key-value storage, improved HTTP transport with proxy support and BIP-353 DNS resolution, and new operational features like Prometheus metrics collection and dedicated authentication database support.

Added

• cdk-common: New Event enum for payment event handling with PaymentReceived variant (thesimplekid).
• cdk-common: Added payment_method field to MeltQuote struct for tracking payment method type (thesimplekid).
• cdk-sql-common: Database migration to add payment_method column to melt_quote table for SQLite and PostgreSQL (thesimplekid).
• cdk-common: New MintKVStoreDatabase trait providing generic key-value storage functionality for mint databases (thesimplekid).
• cdk-common: Added KVStoreTransaction trait for transactional key-value operations with read, write, remove, and list capabilities (thesimplekid).
• cdk-common: Added validation functions for KV store namespace and key parameters with ASCII character and length restrictions (thesimplekid).
• cdk-common: Added comprehensive test module for KV store functionality with transaction and isolation testing (thesimplekid).
• cdk-sql-common: Database migration to add kv_store table for generic key-value storage in SQLite and PostgreSQL (thesimplekid).
• cdk-sql-common: Implementation of MintKVStoreDatabase trait for SQL-based databases with namespace support (thesimplekid).
• cdk-common: Added quote_id field to Transaction struct for tracking associated mint or melt quote IDs (thesimplekid).
• cdk-sql-common: Database migration to add quote_id column to transactions table for SQLite and PostgreSQL (thesimplekid).
• cdk: Added amount_mintable() helper and stricter mint quote validation (thesimplekid).
• cdk-sql-common: Added persistent melt_request storage with associated blinded messages; new migrations for SQLite and PostgreSQL (thesimplekid).
• cdk-cln: Persist last pay_index in the mint KV store to avoid missed events across restarts (thesimplekid).
• cdk: HTTP subscriptions emit BOLT12 notifications per NUT-17 (crodas).
• cdk: DNS TXT resolution in HttpTransport and MintConnector for BIP‑353 lookups (crodas).
• cdk-ffi: Wallet FFI bindings and async constructors (davidcaseria).
• cdk-prometheus: New metrics crate and optional embedded Prometheus server; integrated metrics across HTTP, database, payments, and mint (feature: prometheus) (asmo).
• cdk-mintd: Optional Prometheus metrics server with configurable address/port via config and env vars (feature: prometheus) (thesimplekid).
• cdk-ldk-node: Web UI improvements (dynamic status, navigation, mobile support) (erik).
• cdk-postgres: Dedicated auth database support with separate schema and migrations when auth is enabled (thesimplekid/asmo).

Changed

• cdk-common: Refactored MintPayment trait method wait_any_incoming_payment to wait_payment_event with event-driven architecture (thesimplekid).
• cdk-common: Updated wait_payment_event return type to stream Event enum instead of WaitPaymentResponse directly (thesimplekid).
• cdk: Updated mint payment handling to process payment events through new Event enum pattern (thesimplekid).
• cashu: Updated BOLT12 payment method specification from NUT-24 to NUT-25 (thesimplekid).
• cdk: Updated BOLT12 import references from nut24 to nut25 module (thesimplekid).
• cdk: Do not fallback from WebSocket to HTTP on first error in subscriptions; retry only when appropriate (crodas).
• cdk: Abstracted HTTP Transport; centralized pay_request logic into the cdk library (lollerfirst).
• cdk: MultiMintWallet refactor for clearer APIs and behavior when managing multiple mints (davidcaseria/thesimplekid).
• cdk: Treat None proxy host matcher as "apply to all hosts" for HTTP transport (lollerfirst).
• cdk: QuoteId handling unified as string in APIs and storage (thesimplekid).
• cdk-axum: Close WebSocket connections sooner on shutdown/errors to avoid dangling clients (crodas).
• cdk-sql-common: Consistent ordering for SQL migrations and build uses OUT_DIR for embedded migration files (vnprc).
• cdk-signatory: Updated protobuf to latest spec and added signatory-related DB migrations (crodas).
• cdk-redb: Bumped dependency version (thesimplekid).

Fixed

• cdk: Wallet melt track and use payment method from quote for BOLT11/BOLT12 routing (thesimplekid).
• cdk: Improve error response details and mapping across HTTP/WS paths (thesimplekid).
• cdk: Fix config being overwritten on startup in certain scenarios (thesimplekid).
• cdk: WASM compatibility fixes for HTTP subscriptions and time handling (use instant) (gudnuf).
• cdk-postgres: Fix reconnection in connection pool and migration prefixes.
• cdk: Check keyset max order when generating/using keysets (thesimplekid).
• cdk: Correct error code returned for duplicate signature conditions (lollerfirst).
• cdk: Ensure all mint quotes are returned in listings (thesimplekid).
• cdk-axum: Improve error response detail structure (thesimplekid).