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
75 Commits 1 Branch 4 Tags 479 KiB
Kotlin 100%
Go to file
Michele Balistreri 5650f448ec
improve wrong pairing password handling 		2020-10-22 16:21:48 +02:00
app improve wrong pairing password handling 2020-10-22 16:21:48 +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 spinner style 2020-10-15 11:33:23 +02:00
build.gradle add PIN/PUK/pairing validation/confirmation 2020-10-13 10:17:09 +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

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 Keycard, allowing things like changing PIN, initializing cards, changing seed etc.

Installation

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

Screenshots

Features

WalletConnect integration

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

  • eth_sendTransaction
  • eth_sendRawTransaction
  • eth_signTransaction
  • eth_sign
  • eth_signTypedData
  • 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

  • redesign the load/change key screen (more input validation)
  • implement mnemonic confirmation (now it is too easy to skip)
  • improve progress indication (especially relevant for long operations)
  • improve transaction screen to show ERC20 icon (when available)
  • improve sign message screen to display EIP-712 data nicely

Future plans (after 1.0)

  • show account balance
  • assign names to paired card

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.