Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This is the repository of the BitNFC project, the BitNFC project is archived, 3itcoin-wallet and makevoid/xdai-wallet thou are actively in development now (cordova but not ionic based, onsen UI):

GH repos (onsen based wallets, html generated via haml, js vanilla "ES2020"):

check them out!



Download the APK from

Known Bugs

1. After the NFC tag is written, alert the user to stay away from the bug

[There is a bug after you write the tag, the nfc provider should deregister itself for few seconds]

The problem can be fixed in many ways - see github issues for the full discussion :)

The error happens also on very bad networking, but it's usually a rare occasion.

2. New empty tag > OK (Send) - The focus should happen on the field!

UX problem (now it requires 2 click to select the field, it should automatically .focus() when the [OK] button from the popup has been pressed)

3. Save the phone wallet private key in the device

Save the phone wallet private key in the device, instead that in localStorage (in the app data), otherwise if you uninstall the app, your private key is lost!

4. see github issues for more

Please report as many bugs as you can, we'll try to fix them asap (remember we can't publish a new version until the hackathon is finished)

For other known bugs - see the Github Issues section

Moar Features

  • Better errors > show confirmation count (e.g. in sweep)
  • Ability to Copy (Clone the tag) (Backup)
  • Settings > Denominations (other than millibits: BTCs, bits)
  • Settings > Export private key
  • support for other cryptocurrencies
  • whitelabel version
  • BIP38 version
  • HD Wallet version
  • embed link to url as other NFC record or dedicated url like bitnfc:// or bitcoin://import/pvtkey
  • integrate qr.js library
  • scan qr code to send payment
  • export private key via SMS !!! <<<< this is awesome
  • use password protected nfc tokens
  • use BIP38 password protected private keys
  • embed the link for the app
  • copy tag (clone tag)
  • you name one!
  • many more features!!!



You need Android Studio SDK with SDK v.22


download the project (or git clone it)

enter the dir

npm install cordova ionic -g

npm install && bower install && ionic state reset

ionic run android # to run it on device (or simulator)


ionic serve # to run it locally on a browser (of course NFC will not work)

NFC Format SMS (the only one that is copy-pastable)

This is the format we are using to encode the tag with:

(we chose sms url)


It's actually an SMS format:

Does it resemble something?



that like an url has variables


on standard Mifare tags usually there is space for another NFC Record

we can also embed a link to the app's google play store page so an user can just scan the nfc tag, click & download :)


Create a keystore (only the first time):

keytool -genkey -v -keystore BitNFC.keystore -alias BitNFC -keyalg RSA -keysize 2048 -validity 10000;

build the project in release mode:

cordova plugin rm org.apache.cordova.console && cordova build --release android

sign the two apk generated:

jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore BitNFC.keystore platforms/android/build/outputs/apk/android-x86-release-unsigned.apk BitNFC && jarsigner -verbose -sigalg SHA1withRSA -digestalg SHA1 -keystore BitNFC.keystore platforms/android/build/outputs/apk/android-armv7-release-unsigned.apk BitNFC

use zipaling to slim the apks:

zipalign -v 4 platforms/android/build/outputs/apk/android-x86-release-unsigned.apk BitNFC-x86.apk && zipalign -v 4 platforms/android/build/outputs/apk/android-armv7-release-unsigned.apk BitNFC-armv7.apk

Unlincensed under #The_Unlicense

Terms of Use

Prior to using our wallet software, you acknowledge and agree that:

Bitcoin is a dynamic digital currency, and there may be risk of loss when trading, holding, and transacting with bitcoin.

BitNFC and 720kb are not responsible for any loss of your bitcoin due to mishandling, theft, or any other factor outside of their direct control.



Bitcoin NFC Android Mobile Wallet - JS + Ionic + Cordova + Bitcore + API + Cordova NFC plugin







No releases published


No packages published