Mycelium Bitcoin Wallet for Android
Java Kotlin Other
Latest commit ac92d40 Aug 10, 2018
Permalink
Failed to load latest commit information.
LVL #472 TestNet app force closes on try to open "Buy bitcoin with credit… Feb 1, 2018
backuputil changed bitcoincashj from mavenLocal to gradle Mar 22, 2018
bitcoincashj @ df6a748 module commit update Apr 20, 2018
bitlib Merge branch 'master' into wapiClientUsingElectrumX Jun 22, 2018
btchip Prevented nullptr exception Jul 26, 2018
coinapult Merge branch 'master' into masterCleanup May 28, 2018
gradle/wrapper versionCode 2100600 Jun 11, 2018
libs zxing wrapper changed Jul 31, 2018
lt-api fixed release build, updated libraries Mar 22, 2018
mbw versionCode 2110115 Aug 9, 2018
mbwlib added new endpoint. Now endpoint could have port Jun 19, 2018
modulespvbch @ f2249fc new bch module version Aug 3, 2018
modulespvcontract @ 94f7593 small fix: Jun 26, 2018
myceliummodularizationtools Updated communication manager api version Aug 3, 2018
trezor Merge branch 'master' into masterCleanup May 28, 2018
view Module update layout fixed Jul 24, 2018
wapi Merge branch 'master' into bug1170 Aug 1, 2018
.gitignore version updates and cleanup Nov 14, 2017
.gitlab-ci.yml keep artifacts on failure Jul 9, 2017
.gitmodules added bitcoincashj submodule Mar 6, 2018
Dockerfile fixed the procecure a bit and markdownified the readme Jul 10, 2017
LICENSE v2.1.0 - BETA1 Nov 21, 2014
README.md Merge branch 'develop' of github.com:mycelium-com/wallet-android into… Jun 6, 2018
build.gradle fixed release build, updated libraries Mar 22, 2018
debug.keystore common debug keystore Sep 7, 2017
ext_settings.gradle #1066 ANR happens every time wallet started with BCH installed Jun 29, 2018
gradlew more changes lumped together Mar 24, 2017
gradlew.bat more changes lumped together Mar 24, 2017
settings.gradle zxing wrapper changed Jul 31, 2018
tools.gradle more changes lumped together Mar 24, 2017

README.md

Beta channel

In order to receive updates quicker than others, you need to do two things:

  1. Join the G+ group so you are eligible for testing
  2. Then explicitly enable beta versions of the software in Google Play

As beta testers, please make sure you have a recent backup of the masterseed and all private keys inside Mycelium. Beta testers will experience many bugs. So far, restoring the wallet from masterseed has never been necessary, but we offer no guarantees.

Building

To build everything from source, simply checkout the source and build using gradle on the build system you need:

  • JDK 1.7

Then you need to use the Android SDK manager to install the following components:

  • ANDROID_HOME environment variable pointing to the directory where the SDK is installed
  • Android SDK Tools 22.6.4
  • SDK Platform Tools 19.0.2
  • Android SDK build Tools 19.1.0
  • Android 4.4.2 (API 19) (at least SDK Platform Rev. 3)
  • Android Extras:
    • Android Support Repository rev 5
    • Android Support Library rev 19.1
    • Google Play services for Froyo rev 12
    • Google Play services rev 17
    • Google Repository rev 8

The project layout is designed to be used with a recent version of Android Studio (currently 1.1.0)

Build commands

On the console type:

git clone https://github.com/mycelium-com/wallet-android.git
cd wallet-android
git submodule update --init --recursive

Linux/Mac type:

./gradlew clean test mbw::asProdRel mbw::asBtRel

Windows type:

gradlew.bat clean test mbw::asProdRel mbw::asBtRel
  • Voila, look into mbw/build/outputs/apk/ to see the generated apk. There are versions for both prodnet and testnet.

Alternatively you can install the latest version from the Play Store.

If you cannot access the Play store, you can obtain the apk directly from https://mycelium.com/bitcoinwallet

Deterministic builds

To validate the Mycelium image you obtain from Google Play Store, you can rebuild the Mycelium wallet yourself using Docker and compare both images following these steps:

  • Create your own Docker image

      $ docker build . --tag mycelium-wallet .
    

    Check that this step succeeds by listing the available docker images:

      $ docker images
    
  • Build Mycelium using Docker

      $ docker run --rm -v $(pwd):/project -w /project mycelium-wallet ./gradlew mbw::clean mbw::assembleProdnetRelease
    

    After this step succeeds, the mycelium unsigned apk is in mbw/builds/outputs/apk. You may need to create a gradle.properties file and set

      org.gradle.jvmargs = -Xmx5120m
    
  • Retrieve Google Play Mycelium APK from your phone Gets package path:

      $ adb shell pm path com.mycelium.wallet
      package:/data/app/com.mycelium.wallet-1/base.apk
    

    Retrieve file:

      $ adb pull /data/app/com.mycelium.wallet-1/base.apk mycelium-signed.apk
    
  • Compare signed apk with unsigned locally built apk using Signal apkdiff

      $ wget https://raw.githubusercontent.com/WhisperSystems/Signal-Android/master/apkdiff/apkdiff.py
      python apkdiff.py mycelium-signed.apk mbw/build/outputs/apk/.....your-prodnet.apk
    
  • You might have to sudo chown -R $USER:$USER . as the docker user might create files that you have no access to under your normal user.

This work is based on WhisperSystems Signal reproducible builds:

Features

With the Mycelium Bitcoin Wallet you can send and receive Bitcoins using your mobile phone.

  • HD enabled - manage multiple accounts and never reuse addresses (Bip32/Bip44 compatible)
  • Masterseed based - make one backup and be safe for ever. (Bip39)
  • 100% control over your private keys, they never leave your device unless you export them
  • No block chain download - install and run in seconds
  • Ultra fast connection to the Bitcoin network through our super nodes
  • For enhanced privacy and availability you can connect to our super nodes via a tor-hidden service ( .onion address)
  • Watch-only addresses (single or xPub) & private key (single or xPriv) import for secure cold-storage integration
  • Directly spend from paper wallets (single key, xPriv or master seed)
  • Trezor enabled - directly spend from trezor-secured accounts.
  • Mycelium Entropy compatible Shamir-Secret-Shared 2-out-of-3 keys spending
  • Secure your wallet with a PIN
  • Compatible with other bitcoin services through the bitcoin: URI scheme

Please note that bitcoin is still experimental and this app comes with no warranty - while we make sure to adhere to the highest standards of software craftsmanship we can not exclude that the software contains bugs. Please make sure you have backups of your private keys and do not use this for more than you are willing to lose.

This application's source is published at https://github.com/mycelium-com/wallet We need your feedback. If you have a suggestion or a bug to report create an issue.

More features:

  • Sources available for review
  • Multiple HD accounts, private keys, external xPub or xPriv accounts
  • Multiple Bitcoin denominations: BTC, mBTC, bits and uBTC
  • View your balance in multiple fiat currencies: USD, AUD, CAD, CHF, CNY, DKK, EUR, GBP, HKD, JPY, NZD, PLN, RUB, SEK, SGD, THB, and many more
  • Send and receive by specifying an amount in fiat and switch between fiat and BTC while entering the amount
  • Address book for commonly used addresses
  • Transaction history with detailed information and local stored comments
  • Import private keys using SIPA (the ones beginning with a 5) and mini private key format (Casascius private keys) from QR-codes or clipboard
  • Export private-, xPub- or xPriv-keys as QR-codes, on clipboard or share with other applications
  • Share your bitcoin address using Twitter, Facebook, email and more.
  • Integrated QR-code scanner
  • Client side load balancing between three 100% redundant server nodes located in different data centers.
  • Sign Messages using your private keys (compatible with bitcoin-qt)

Authors

Credits

Thanks to all collaborators who provided us with code or helped us with integrations! Just to name a few:

  • Nicolas Bacca from Ledger
  • Sipa, Marek and others from Trezor
  • Jani and Aleš from Cashila
  • Kalle Rosenbaum, Bip120/121
  • David and Alex from Glidera
  • Wiz for helping us with KeepKey
  • Tom Bitton and Asa Zaidman from Simplex
  • (if you think you should be mentioned here, just notify us)

Thanks to Jethro for tirelessly testing the app during beta development.

Thanks to our numerous volunteer translators who provide high-quality translations in many languages. Your name should be listed here, please contact me so I know you want to be included.

Thanks to Johannes Zweng for his testing and providing pull requests for fixes.

Thanks to all beta testers to provide early feedback.