From f8d4c39b1e2a417cbc51d789ecd15ab3e2ab01d8 Mon Sep 17 00:00:00 2001
From: iWarpBTC <iwarp@tuta.io>
Date: Sun, 17 Jul 2022 14:21:09 +0200
Subject: [PATCH] basic readme

---
 lnbits/extensions/boltcards/README.md         | 22 +++++++++++++------
 .../templates/boltcards/_api_docs.html        |  4 +---
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/lnbits/extensions/boltcards/README.md b/lnbits/extensions/boltcards/README.md
index 7b9bd721..e9d1d9cc 100644
--- a/lnbits/extensions/boltcards/README.md
+++ b/lnbits/extensions/boltcards/README.md
@@ -1,11 +1,19 @@
-<h1>boltcards Extension</h1>
-<h2>*tagline*</h2>
-This is an boltcards extension to help you organise and build you own.
+<h1>Bolt cards (NXP NTAG) Extension</h1>
 
-Try to include an image
-<img src="https://i.imgur.com/9i4xcQB.png">
+This extension allows you to link your Bolt card with a LNbits instance and use it more securely then just with a static LNURLw on it. A technology called [Secure Unique NFC](https://mishka-scan.com/blog/secure-unique-nfc) is utilized in this workflow. 
 
+**In order to use this extension you need to be able setup your card first.** There's a [guide](https://www.whitewolftech.com/articles/payment-card/) to set it up with your computer. Hopefully a mobile app is to come to do this. 
 
-<h2>If your extension has API endpoints, include useful ones here</h2>
+<h2>Setting the outside the extension</h2>
 
-<code>curl -H "Content-type: application/json" -X POST https://YOUR-LNBITS/YOUR-EXTENSION/api/v1/boltcards -d '{"amount":"100","memo":"boltcards"}' -H "X-Api-Key: YOUR_WALLET-ADMIN/INVOICE-KEY"</code>
+The URI should be `lnurlw://YOUR-DOMAIN.COM/boltcards/api/v1/scane/?e=00000000000000000000000000000000&c=0000000000000000`
+
+(At this point the link is common to all cards. So the extension grabs one by one every added card's key and tries to decrypt the e parameter until there's a match.)
+
+Choose and note your Meta key and File key. 
+
+<h2>Adding the into the extension</h2>
+
+Create a withdraw link within the LNURLw extension before adding a card. Enable the `Use unique withdraw QR codes to reduce 'assmilking'` option. 
+
+The card UID can be retrieve with `NFC TagInfo` mobile app or from `NXP TagXplorer` log. Use the keys you've set before. You can leave the counter zero, it gets synchronized with the first use. 
diff --git a/lnbits/extensions/boltcards/templates/boltcards/_api_docs.html b/lnbits/extensions/boltcards/templates/boltcards/_api_docs.html
index f4939255..26d37a73 100644
--- a/lnbits/extensions/boltcards/templates/boltcards/_api_docs.html
+++ b/lnbits/extensions/boltcards/templates/boltcards/_api_docs.html
@@ -6,9 +6,7 @@
 >
   <q-card>
     <q-card-section>
-      <h5 class="text-subtitle1 q-my-none">
-        Be your own card association
-      </h5>
+      <h5 class="text-subtitle1 q-my-none">Be your own card association</h5>
       <p>
         Manage your Bolt Cards self custodian way<br />