phoenix: A C repository from ACINQ

Phoenix is a Bitcoin wallet developed by ACINQ, that allows you to send and receive bitcoins securely over the Lightning Network. It is self-custodial, which means that you hold the keys of the wallet. It provides a simple and clean UX. Thanks to native Lightning support, payments are faster and cheaper.

🚨 This wallet is self-custodial. It means that, when creating a new wallet, a 12-words recovery phrase is generated. Only you have it. It is your responsibility to make a backup of that recovery phrase. It gives full access to your funds, so do not share it with anyone. If you lose the recovery phrase, your funds are lost.

Head to our website for more information:

Download

Phoenix is available for Android and iOS:

for iOS: on the App Store - requires iOS 15+.
for Android: on Google Play, or get the APK from the releases - requires Android 8+.

Build and test Phoenix

Phoenix is separated in 3 modules:

phoenix-shared: business logic written in Kotlin, shared between the iOS and the Android applications. Uses lightning-kmp for everything Lightning/Bitcoin related.
phoenix-android: the UI for the new Android application, written in Kotlin and Jetpack Compose.
phoenix-ios: the UI for the iOS application, written in Swift.

Instructions to build the iOS and the Android apps are provided here.

Deprecated module:

phoenix-legacy: contains the old, legacy Android application (version 1.x), using eclair-core for Lightning, which has been replaced by phoenix-android. However, this legacy app is still embedded in the new production application for migration purposes so the code remains. It will be removed eventually.

Contribute

We use GitHub for bug tracking. Search the existing issues for your bug and create a new one if needed.

You can also contribute to the project by submitting pull requests to improve the codebase or bring new features. Pull requests will be reviewed by members of the ACINQ team.

To contribute to Lightning in general, take a look at the Eclair repository for routing nodes, or the lightning-kmp repository for mobile nodes.

Translate the app

If you want to contribute to the translation effort, consult the guidelines provided in TRANSLATION.md

Support

For troubleshooting and questions, visit our support page.

License