web/boltcard
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions

update document for the new create card flow

Browse source
This commit is contained in:
Peter Rounce 2022-08-31 21:17:01 +01:00 • committed by GitHub
parent c1c88e392a
commit d8dafb1d2e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

38
docs/CARD_ANDROID.md
View file

@ -2,7 +2,7 @@
## Introduction ## Introduction
Here we describe how to create your own bolt cards with the Bolt Card Android app and the Bolt Card service. Here we describe how to create your own bolt cards with the Bolt Card service and the Bolt Card Android app.
## Resources ## Resources
@ -16,46 +16,26 @@ Here we describe how to create your own bolt cards with the Bolt Card Android ap
### Install the app ### Install the app
- install the app from source or apk - install the app from
- source
### Write the URI template to the card - apk
on the app - Google Play Store [Boltcard NFC Card Creator](https://play.google.com/store/apps/details?id=com.lightningnfcapp)
- 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
### Write the key values to the card ### Write the key values to the card
on the bolt card server on the bolt card server
- ensure the environment variables for the database connection are set up (see `boltcard.service`) - ensure the environment variables for the database connection are set up (see `boltcard.service`)
- enter the `createboltcard` directory - enter the `createboltcard` directory
- `$ go build` - `$ go build`
- `./createboltcard` to create a card - run the creation program
- `./createboltcard -help` to see options - `./createboltcard -help` to see options
- `./createboltcard -enable -tx_max=1000 -day_max=10000 -name=card_1` for example - `./createboltcard -enable -tx_max=1000 -day_max=10000 -name=card_1` for example
- this will give you a one-time link in text and QR code form - this will give you a one-time link in text and QR code form
on the app on the app
- select `Key Management` - click `scan QR code`
- click `scan QR code from console`
- scan the QR code - scan the QR code
- bring the card to the device for programming the keys - the app will prompt you to hold the card for programming
- the app will test the card and show you the results
### Update the card record on the server
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 (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 enable_flag = '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