status-im
/
keycard-connect
mirror of https://github.com/status-im/keycard-connect.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
Keycard + WalletConnect
46 Commits 1 Branch 4 Tags 479 KiB
Kotlin 100%
Go to file
Michele Balistreri 2de8b5caf2 remove calls to deprecated methods, optimize imports 2020-10-13 10:40:12 +02:00
app remove calls to deprecated methods, optimize imports 2020-10-13 10:40:12 +02:00
gradle/wrapper update deps 2020-10-09 13:55:00 +02:00
.gitignore initial import 2019-10-30 12:57:24 +03:00
LICENSE Create LICENSE 2019-10-30 12:59:28 +03:00
README.md add README 2020-06-08 13:31:31 +03:00
build.gradle update deps 2020-10-09 13:55:00 +02:00
gradle.properties initial import 2019-10-30 12:57:24 +03:00
gradlew Make gradlew executable 2019-11-28 18:32:58 +09:00
gradlew.bat initial import 2019-10-30 12:57:24 +03:00
settings.gradle initial import 2019-10-30 12:57:24 +03:00

README.md

Keycard Connect

NOTE: This app is a prototype. While it seems to work reasonably well and stable, the UI has not received any thought yet. It is fine to use but keep in mind that there isn't much error reporting, no progress indicators and some screens are crammed with info

Keycard Connect's main function is to enable using the Keycard with dApps outside of a web3 browser using WalletConnect. The dApp must of course support WalletConnect for this to work. Additionally, this app is a little toolbox for Keycardm allowing things like changing PIN, initializing cards, changing seed etc.

What works

WalletConnect integration

At the moment all dApps tested worked fine. The implemented functions are:

  • eth_sendTransaction
  • eth_sendRawTransaction
  • eth_signTransaction
  • eth_sign
  • personal_sign

Seed management

  • import a BIP39 mnemonic seed to a card
  • create a random BIP39 mnemonic seed and import it on a card
  • generate a random key on a card with no master key
  • change seed at any moment
  • remove seed

Keycard management

  • initialize an out-of-factory card with random PIN/PUK/pairing
  • pairing (to an already intialized car)
  • Unblock PIN with PUK
  • Change PIN
  • change PUK
  • change pairing password
  • unpair keycard tapped
  • unpair keycard tapped from other clients/devices
  • reinstall applet (destroys all data on card)
  • allow switching account (BIP32 path) on card and used network (for WalletConnect)

What needs to be done for 1.0

  • implement signedTypedData (WalletConnect integration)
  • design and implement a user-friendly UI

Future plans (after 1.0)

  • show account balance
  • assign names to paired card

Installation

Download the latest APK from the release pages and install on your phone.

Usage

Select the button for the function you need and follow the instructions. An important thing to know is that whenever you need to tap your card you will get a prompt. When you tap the card, this prompt will remain until you can remove the card. Don't remove the card until this screen disappears by itself.

WARNING: Reinstalling the applet over NFC is slower and more dangerous than doing it over USB. Do it only if you have no choice. Especially on JCOP3 cards, make extra sure you do not remove the card until the "Tap your card" screen disappears, because losing connection during certain operations can kill the card.