Update CARD_ANDROID.md

This commit is contained in:
Peter Rounce 2022-08-11 07:16:18 +01:00 committed by GitHub
parent 2435b73f02
commit 16dd3c0d5c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -2,30 +2,30 @@
## Introduction ## Introduction
Here we describe how to create your own bolt card. Here we describe how to create your own bolt cards with the Bolt Card Android app and the Bolt Card service.
## Resources ## Resources
- some `NXP DNA 424 NTAG` cards
- an Android device with NFC - an Android device with NFC
- the BoltCard app - a Bolt Card serice
- [app usage document](https://github.com/boltcard/bolt-nfc-android-app#usage) - [the Bolt Card app](https://github.com/boltcard/bolt-nfc-android-app)
- [the Bolt Card app usage document](https://github.com/boltcard/bolt-nfc-android-app#usage)
## Steps ## Steps
### Install the app ### Install the app
[Bolt Card Android app](https://github.com/boltcard/bolt-nfc-android-app) - install the app from source or apk
- install the app from source or apk
### Write to the card ### Write the URI template to the card
- open the app on the app
- select `Write NFC` - select `Write NFC`
- enter your domain and path in the text entry box given - enter your domain and path in the text entry box given
``` ```
card.yourdomain.com/ln card.yourdomain.com/ln
``` ```
- bring the card to the device for programming the URI template - bring the card to the device for programming the URI template
- select `Read NFC` - select `Read NFC`
- check that the URI looks correct - check that the URI looks correct
``` ```
@ -33,29 +33,28 @@ lnurlw://card.yourdomain.com/ln?c=...&p=...
``` ```
- note the UID value - note the UID value
### Get the keys from the host ### Write the key values to the card
- on the bolt card server on the bolt card server
- enter the `createboltcard` directory - enter the `createboltcard` directory
- `$ go build` - `$ go build`
- `./createboltcard` - `./createboltcard`
- this will give you a one use link in text and QR code form - this will give you a one use link in text and QR code form
- on the app on the app
- select `Key Management` - select `Key Management`
- click `scan QR code from console` - click `scan QR code from console`
- scan the QR code - scan the QR code
- bring the card to the device for programming the keys - bring the card to the device for programming the keys
### Update the host card record ### Update the card record on the server
- on the bolt card server on the bolt card server
- `$ psql card_db` - `$ psql card_db`
- `card_db=# select card_id, one_time_code from cards order by card_id desc limit 1;` - `card_db=# select card_id, one_time_code from cards order by card_id desc limit 1;`
- check that this is the correct record - check that this is the correct record (one_time_code matches from before)
- `card_db=# update cards set uid = '*UID value from before without the 0x prefix*' where card_id=*card_id from before*;` - `card_db=# update cards set uid = 'UID value from before without the 0x prefix' where card_id=card_id from before;`
- `card_db=# update cards set enabled = 'Y' where card_id=*card_id from before*;` - `card_db=# update cards set enabled = 'Y' where card_id=card_id from before;`
### Make a payment ### Make a payment
- monitor the bolt card service logs - monitor the bolt card service logs
- `$ journalctl -u boltcard.service -f` - `$ journalctl -u boltcard.service -f`
- use a PoS setup to read the bolt card, e.g. [Breez wallet](https://breez.technology/) - use a PoS setup to read the bolt card, e.g. [Breez wallet](https://breez.technology/)
- for more support options, see [Bolt card service installation](INSTALL.md)