ℹ️ Migration for existing Android legacy wallets (v1.x)
Users upgrading from the legacy Android app (1.x) to 2.x will need to migrate to be able to use 2.x features. See the 2.0.0 release notes for details about the migration process. You can see what version you are currently using in Settings > About.
Changes
Add support for BOLT12 offers
Offers are the Lightning equivalent to a Bitcoin address: it's a reusable, static payment request that can be used for donation use cases, or to easily pay/get paid by your friends.
Since BOLT12 is not yet well supported, Phoenix will keep displaying a BOLT11 invoice by default.
Custom messages
When paying an offer, the user can attach a custom message (max 64 chars) that will be delivered to the offer's recipient along with the funds.
Background processing limitation
Since offers are typically paid without the recipient being active on his device, a few warnings have been added so that users are made aware of limitations.
For example, Phoenix relies on Google FCM to deliver wake-up notifications to the recipient. If FCM is disabled or unavailable on the device (for example, on a GrapheneOS fresh installation), then the user will not be able to receive payments in the background. Same for Tor.
Contacts UI (Android only for now)
A new UI has been added to create, list and manage contacts, which are a way for Phoenix to attach an offer to a name. See #575 for screenshots.
Note : These contacts are isolated from the device's system contacts. If there's demand for it, a later update could let Phoenix link offers to the device's contacts, provided the user grants permissions.
Full changelog
- phoenix: android-v2.2.4...android-v2.3.1
- lightning-kmp: ACINQ/lightning-kmp@v1.6.3...v1.7.0
Verifying signatures
You will need gpg
and our release signing key 7A73FE77DE2C4027. Note that you can get it:
- from our website: https://acinq.co/pgp/drouinf.asc
- from github user @sstone, a committer on eclair: https://api.github.com/users/sstone/gpg_keys
To import our signing key:
$ gpg --import drouinf.asc
To verify the release file checksums and signatures:
$ gpg -d SHA256SUMS.asc > SHA256SUMS.stripped
$ sha256sum -c SHA256SUMS.stripped