add app doc
This commit is contained in:
parent
ff1fa2b6e3
commit
1e1e652aa1
1 changed files with 61 additions and 0 deletions
61
docs/CARD_ANDROID.md
Normal file
61
docs/CARD_ANDROID.md
Normal file
|
|
@ -0,0 +1,61 @@
|
||||||
|
# Steps for making a bolt card with the Android app
|
||||||
|
|
||||||
|
## Introduction
|
||||||
|
|
||||||
|
Here we describe how to create your own bolt card.
|
||||||
|
|
||||||
|
## Resources
|
||||||
|
|
||||||
|
- an Android device with NFC
|
||||||
|
- the BoltCard app
|
||||||
|
- [app usage document](https://github.com/boltcard/bolt-nfc-android-app#usage)
|
||||||
|
|
||||||
|
## Steps
|
||||||
|
|
||||||
|
### Install the app
|
||||||
|
|
||||||
|
[Bolt Card Android app](https://github.com/boltcard/bolt-nfc-android-app)
|
||||||
|
- install the app from source or apk
|
||||||
|
|
||||||
|
### Write to the card
|
||||||
|
- open the app
|
||||||
|
- select `Write NFC`
|
||||||
|
- enter your domain and path in the text entry box given
|
||||||
|
```
|
||||||
|
card.yourdomain.com/ln
|
||||||
|
```
|
||||||
|
- bring the card to the device for programming the URI template
|
||||||
|
|
||||||
|
- select `Read NFC`
|
||||||
|
- check that the URI looks correct
|
||||||
|
```
|
||||||
|
lnurlw://card.yourdomain.com/ln?c=...&p=...
|
||||||
|
```
|
||||||
|
- note the UID value
|
||||||
|
|
||||||
|
### Get the keys from the host
|
||||||
|
- on the bolt card server
|
||||||
|
- enter the `createboltcard` directory
|
||||||
|
- `$ go build`
|
||||||
|
- `./createboltcard`
|
||||||
|
- this will give you a one use link in text and QR code form
|
||||||
|
|
||||||
|
- on the app
|
||||||
|
- select `Key Management`
|
||||||
|
- click `scan QR code from console`
|
||||||
|
- scan the QR code
|
||||||
|
- bring the card to the device for programming the keys
|
||||||
|
|
||||||
|
### Update the host card record
|
||||||
|
- on the bolt card server
|
||||||
|
- `$ psql card_db`
|
||||||
|
- `card_db=# select card_id, one_time_code from cards order by card_id desc limit 1;`
|
||||||
|
- check that this is the correct record
|
||||||
|
- `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*;`
|
||||||
|
|
||||||
|
### Make a payment
|
||||||
|
- monitor the bolt card service logs
|
||||||
|
- `$ journalctl -u boltcard.service -f`
|
||||||
|
- 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)
|
||||||
Loading…
Add table
Add a link
Reference in a new issue