ℹ️ 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: https://github.com/ACINQ/phoenix/compare/android-v2.2.4...android-v2.3.1
• lightning-kmp: https://github.com/ACINQ/lightning-kmp/compare/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