feat: fork boltcards as TagID extension

- Rename extension ID: boltcards -> tagid
- Rename all routes, DB prefix, router names, template paths
- Update config.json and manifest.json for AxelHamburch/tagid_extension
- Add README in zapbox-extension style with feature documentation

Includes upstream features:
- feat: PIN limit protection per card (4-digit PIN, PBKDF2-SHA256 hash,
  auto-disable after 3 wrong attempts) [feature/pin-limit]
- fix: failed payments no longer count towards the daily limit
  [fix/daily-limit-failed-payments]

Author: AxelHamburch

README.md

@@ -1,4 +1,35 @@
-# Bolt Cards - <small>[LNbits](https://github.com/lnbits/lnbits) extension</small>
+# TagID Extension - <small>[LNbits](https://github.com/lnbits/lnbits) extension</small>
+
+> **Forked from [lnbits/boltcards](https://github.com/lnbits/boltcards)**  
+> Extended with PIN limit protection and failed-payment daily-limit fix.
+
+Self custody NFC Bolt Cards with one-time LNURLw links — now with optional PIN verification and accurate daily spend tracking.
+
+Check out [lnbits.com](https://lnbits.com) & join the Telegram support group [Makerbits](https://t.me/makerbits)
+
+`Original authors: dni, prusnak, talvasconcelos, arbadacarbaYK, gorrdy, arcbtc` / `TagID extension: AxelHamburch`
+
+Extension manifest source for LNbits: [https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/manifest.json](https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/manifest.json)
+
+---
+
+## Added Features
+
+### PIN Limit (optional per-card PIN protection)
+
+- Set a **PIN threshold (sat)**: any withdrawal at or above this amount requires the card holder to enter a 4-digit PIN.
+- The PIN is stored as a salted PBKDF2-SHA256 hash — never in plaintext.
+- After **3 wrong PIN attempts** across taps the card is automatically **disabled** and must be re-enabled by the wallet owner.
+- Attempt counter resets when the card is re-enabled or when a correct PIN is entered.
+
+### Failed-Payment Daily Limit Fix
+
+- Limit checks (tx limit & daily limit) now happen **before** the hit is marked as spent, so a rejected payment does not consume the daily budget.
+- When a payment fails after the invoice was accepted, the hit amount is zeroed so it does not count towards the daily limit.
+
+---
+
+
 
 <small>For more about LNBits extensions check [this tutorial](https://youtu.be/_sW7miqaXJc)</small>
 
@@ -74,14 +105,14 @@ The key #00, K0 (also know as auth key) is used as authentification key. It is n
 There's also a more [advanced guide](https://www.whitewolftech.com/articles/payment-card/) to set cards up manually with a card reader connected to your computer.
 Writing can also be done (without setting the keys) via the [TagWriter app by NXP](https://play.google.com/store/apps/details?id=com.nxp.nfc.tagwriter) on Android.
 
-The URI should be `lnurlw://YOUR_LNBITS_DOMAIN/boltcards/api/v1/scan/{YOUR_card_external_id}?p=00000000000000000000000000000000&c=0000000000000000`
+The URI should be `lnurlw://YOUR_LNBITS_DOMAIN/tagid/api/v1/scan/{YOUR_card_external_id}?p=00000000000000000000000000000000&c=0000000000000000`
 
 Then fill up the card parameters in the extension. Card Auth key (K0) can be filled in the extension just for the record. Initical counter can be 0.
 
 - If you don't know the card ID, use NXP TagInfo app to read it first.
 - Tap Write tags > New Data Set > Link
 - Set URI type to Custom URL
-- URL should look like `lnurlw://YOUR_LNBITS_DOMAIN/boltcards/api/v1/scan/{YOUR_card_external_id}?p=00000000000000000000000000000000&c=0000000000000000`
+- URL should look like `lnurlw://YOUR_LNBITS_DOMAIN/tagid/api/v1/scan/{YOUR_card_external_id}?p=00000000000000000000000000000000&c=0000000000000000`
 - click Configure mirroring options
 - Select Card Type NTAG 424 DNA
 - Check Enable SDM Mirroring

__init__.py

@@ -1,48 +1,48 @@
-import asyncio
+import asyncio
 
 from fastapi import APIRouter
 from loguru import logger
 
 from .crud import db
 from .tasks import wait_for_paid_invoices
-from .views import boltcards_generic_router
-from .views_api import boltcards_api_router
-from .views_lnurl import boltcards_lnurl_router
+from .views import tagid_generic_router
+from .views_api import tagid_api_router
+from .views_lnurl import tagid_lnurl_router
 
-boltcards_static_files = [
+tagid_static_files = [
     {
-        "path": "/boltcards/static",
-        "name": "boltcards_static",
+        "path": "/tagid/static",
+        "name": "tagid_static",
     }
 ]
 
-boltcards_ext: APIRouter = APIRouter(prefix="/boltcards", tags=["boltcards"])
-boltcards_ext.include_router(boltcards_generic_router)
-boltcards_ext.include_router(boltcards_api_router)
-boltcards_ext.include_router(boltcards_lnurl_router)
+tagid_ext: APIRouter = APIRouter(prefix="/tagid", tags=["tagid"])
+tagid_ext.include_router(tagid_generic_router)
+tagid_ext.include_router(tagid_api_router)
+tagid_ext.include_router(tagid_lnurl_router)
 
 scheduled_tasks: list[asyncio.Task] = []
 
 
-def boltcards_stop():
+def tagid_stop():
     for task in scheduled_tasks:
         try:
             task.cancel()
         except Exception as ex:
             logger.warning(ex)
 
 
-def boltcards_start():
+def tagid_start():
     from lnbits.tasks import create_permanent_unique_task
 
-    task = create_permanent_unique_task("ext_boltcards", wait_for_paid_invoices)
+    task = create_permanent_unique_task("ext_tagid", wait_for_paid_invoices)
     scheduled_tasks.append(task)
 
 
 __all__ = [
-    "boltcards_ext",
-    "boltcards_start",
-    "boltcards_static_files",
-    "boltcards_stop",
+    "tagid_ext",
+    "tagid_start",
+    "tagid_static_files",
+    "tagid_stop",
     "db",
 ]

config.json

@@ -1,10 +1,15 @@
 {
-  "name": "Bolt Cards",
-  "short_description": "Self custody Bolt Cards with one time LNURLw",
-  "tile": "/boltcards/static/image/boltcard.png",
+  "name": "TagID",
+  "short_description": "Self custody NFC Bolt Cards with one time LNURLw — with PIN limit and daily limit fixes",
+  "tile": "/tagid/static/image/boltcard.png",
   "version": "1.1.0",
   "min_lnbits_version": "1.3.0",
   "contributors": [
+    {
+      "name": "AxelHamburch",
+      "uri": "https://github.com/AxelHamburch",
+      "role": "Developer"
+    },
     {
       "name": "dni",
       "uri": "https://github.com/dni",
@@ -53,21 +58,21 @@
   ],
   "images": [
     {
-      "uri": "https://raw.githubusercontent.com/lnbits/boltcards/main/static/image/1.jpg",
+      "uri": "https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/static/image/1.jpg",
       "link": "https://www.youtube.com/embed/_sW7miqaXJc?si=UlFX7yU2A_LkC70r"
     },
     {
-      "uri": "https://raw.githubusercontent.com/lnbits/boltcards/main/static/image/2.jpg",
+      "uri": "https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/static/image/2.jpg",
       "link": "https://www.youtube.com/embed/wJ7QLFTRjK0?si=DRNH9ycKZrCLjFcx"
     },
     {
-      "uri": "https://raw.githubusercontent.com/lnbits/boltcards/main/static/image/1.png"
+      "uri": "https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/static/image/1.png"
     },
     {
-      "uri": "https://raw.githubusercontent.com/lnbits/boltcards/main/static/image/3.jpg"
+      "uri": "https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/static/image/3.jpg"
     }
   ],
-  "description_md": "https://raw.githubusercontent.com/lnbits/boltcards/main/description.md",
-  "terms_and_conditions_md": "https://raw.githubusercontent.com/lnbits/boltcards/main/toc.md",
+  "description_md": "https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/description.md",
+  "terms_and_conditions_md": "https://raw.githubusercontent.com/AxelHamburch/tagid_extension/main/toc.md",
   "license": "MIT"
 }