SDK release notes can be found at breez-sdk/releases
- Breaking Update Dart SDK range to be compatible with Flutter 3.19
- Breaking Replace parameters of
connect
withConnectRequest
. - Breaking
serviceHealthCheck
API now requires anapiKey
which properly conducts a health check when services are offline. - Deprecation
sendOnchain
is now deprecated. UsepayOnchain
instead. - Deprecation
inProgressReverseSwaps
is now deprecated. UseinProgressOnchainPayments
instead. - Deprecation
fetchReverseSwapFees
is now deprecated. UseprepareOnchainPayment
instead. - Introduce
swapEventsStream
to listen in on swap events. - Introduce
rescanSwaps
API to iterate all historical swap addresses and fetch their current status from the blockchain. - Introduce
configureNode
API to configure an optional address to send funds to during a mutual channel close. - Introduce
onchainPaymentLimits
API to fetch latest on-chain payment limits. - Notification Service plugins are now bundled with the Flutter package. Setup guide.
- Various improvements to Notification Service plugins:
- Set log stream natively on Android.
- Allow setting channel setup fee limit through
ServiceConfig
that will be used to accept or decline LNURL-Payments that require a channel opening. - Notifications on iOS are now grouped.
- Improved resource management.
- Notification Service is no longer attempted to start without permissions to show notifications on Android, which lead to an application crash.
- Introduce
generateDiagnosticData
API to generate diagnostic data. - Fix swap confirmed block to be the earliest.
- Signer connects immediately on startup (fixes 30 seconds delay).
- Adapt signer policy to allow paying zero amount invoice.
- Update signer keep alive.
- Fix swap
INVOICE_AMOUNT_MISMATCH
. - Defer signer start to increase overall startup time.
- Improve performance by reusing Breez server grpc connection.
- Upgrade to VLS 0.11.
- Fixed a signer crash.
- Support notifications via a webhook after a swap transaction confirms.
- Reduced package size by not bundling pre-built binaries.
- Fixes compatibility issues ith
bdk-flutter
plugin. - Introduce
rescanSwap
API to rescan swap addresses. - Introduce
configureNode
API to configure an address to send funds to during a mutual channel close. - Introduce
setPaymentMetadata
API to set the external metadata of a payment as a valid JSON string. - Add optional
chainnotifierUrl
toConfig
. - Include
openChannelBolt11
,lnurlPayDomain
,reverseSwapInfo
inLnPaymentDetails
.openChannelBolt11
for received payments which required to open a channel.lnurlPayDomain
for sent payments that are not to a Lightning Address.reverseSwapInfo
for payments that were sent in the context of a reverse swap.
- This is a hotfix release that fixes a critical issue from previous release.
- Breaking Rename
sweep
toredeemOnchainFunds
. -
- Updates
flutter_rust_bridge
tov1.82.6
.
- Updates
- Introduce
registerWebhook
API to receive payments via mobile notifications. More information here. - Allow
RegisterWebhook
command to be executed throughexecuteCommand
API. - Add expiry time to pending payments.
Add optionalpendingExpirationBlock
toLnPaymentDetails
. - Add extra TLVs to send spontaneous payment.
Add optionalextraTlvs
toSendSpontaneousPaymentRequest
. - Support custom payment metadata.
Add optionalmetadataFilters
toListPaymentsRequest
.
- Allow native access to SDK from flutter (Kotlin & Swift).
- Updates
flutter_rust_bridge
tov1.82.4
.
- Breaking Replace parameters of
prepareSweep
withPrepareSweepRequest
. - Amount is now populated in failed payments.
- Introduce
reportIssue
API to report payment failures. - Introduce
serviceHealthCheck
API to get service health status. - Include
Payment
information onInvoicePaid
event.
- Requires Dart 3.0 or later.
- Migrate to null safety.
- Breaking
filter
field ofListPaymentsRequest
is deprecated and must be replaced with the optionalfilters
field. - Breaking
PaymentTypeFilter.All
is removed. Unfiltered payment list will be retrieved iffilters
fields ofListPaymentsRequest
is left empty(or is a list that contains allPaymentTypeFilter
types). - Introduce
prepareRefund
API to estimate the refund transaction fee. - Introduce
prepareSweep
API to estimate the sweep transaction fee. - Introduce
maxReverseSwapAmount
API to allow draining all channels when sending on-chain. ClosedChannel
transactions can now be filtered by addingPaymentTypeFilter.ClosedChannels
to thefilters
list.- Include
swapInfo
inPayment
. - Include
paymentHash
inLnUrlPayResult
.
- Breaking All APIs which previously allowed multiple parameters to be
passed now require their corresponding
Request
object.
These APIs include:sendOnchain
,sendPayment
,sendSpontaneousPayment
,refund
,lnurlPay
,lnurlWithdraw
. - Breaking All
request
params is renamed toreq
. - Breaking All
reqData
params that belong to areq
object(lnurlPay, lnurlWithdraw except lnurlAuth) is renamed todata
. - Breaking Use millisatoshi instead of satoshi for lightning amounts.
ReceivePaymentRequest
,SendPaymentRequest
,SendSpontaneousPaymentRequest
now useamount_msat
instead ofamount_sat
. - Support pagination in
listPayments
. - Add optional
claimTxid
andlockTxid
toReverseSwapInfo
. - Add
closingTxid
to closed channels received in payments list. - Allow
GetInfo
command to be executed throughexecuteCommand
API.