[Enhancement] Add support for BBQr PSBT decoding

src/seedsigner/models/decode_qr.py

@@ -2,6 +2,7 @@
 import json
 import logging
 import re
+import zlib
 
 from binascii import a2b_base64, b2a_base64
 from enum import IntEnum
@@ -11,6 +12,7 @@
 from urtypes.crypto import PSBT as UR_PSBT
 from urtypes.crypto import Account, Output
 from urtypes.bytes import Bytes
+from base64 import b32encode, b32decode
 
 from seedsigner.helpers.ur2.ur_decoder import URDecoder
 from seedsigner.models.qr_type import QRType
@@ -74,6 +76,9 @@ def add_data(self, data):
             elif self.qr_type == QRType.PSBT__BASE43:
                 self.decoder = Base43PsbtQrDecoder() # Single Segment Base43
 
+            elif self.qr_type == QRType.PSBT__BBQR:
+                self.decoder = BBQRPsbtQrDecoder() # BBQr Decoder
+
             elif self.qr_type in [QRType.SEED__SEEDQR, QRType.SEED__COMPACTSEEDQR, QRType.SEED__MNEMONIC, QRType.SEED__FOUR_LETTER_MNEMONIC, QRType.SEED__UR2]:
                 self.decoder = SeedQrDecoder(wordlist_language_code=self.wordlist_language_code)          
 
@@ -229,7 +234,7 @@ def get_percent_complete(self, weight_mixed_frames: bool = False) -> int:
         if self.qr_type in [QRType.PSBT__UR2, QRType.OUTPUT__UR, QRType.ACCOUNT__UR, QRType.BYTES__UR]:
             return int(self.decoder.estimated_percent_complete(weight_mixed_frames=weight_mixed_frames) * 100)
 
-        elif self.qr_type in [QRType.PSBT__SPECTER]:
+        elif self.qr_type in [QRType.PSBT__SPECTER, QRType.PSBT__BBQR]:
             if self.decoder.total_segments == None:
                 return 0
             return int((self.decoder.collected_segments / self.decoder.total_segments) * 100)
@@ -262,6 +267,7 @@ def is_psbt(self) -> bool:
             QRType.PSBT__SPECTER,
             QRType.PSBT__BASE64,
             QRType.PSBT__BASE43,
+            QRType.PSBT__BBQR,
         ]
 
 
@@ -326,9 +332,6 @@ def extract_qr_data(image, is_binary:bool = False) -> str | None:
 
     @staticmethod
     def detect_segment_type(s, wordlist_language_code=None):
-        # print("-------------- DecodeQR.detect_segment_type --------------")
-        # print(type(s))
-        # print(len(s))
 
         try:
             # Convert to str data
@@ -338,6 +341,9 @@ def detect_segment_type(s, wordlist_language_code=None):
                 # TODO: Convert the test suite rather than handle here?
                 s = s.decode('utf-8')
 
+            logger.debug(f"segment string: {s}")
+            logger.debug(f"segment string length: {len(s)}")
+
             # PSBT
             if re.search("^UR:CRYPTO-PSBT/", s, re.IGNORECASE):
                 return QRType.PSBT__UR2
@@ -357,6 +363,9 @@ def detect_segment_type(s, wordlist_language_code=None):
             elif DecodeQR.is_base64_psbt(s):
                 return QRType.PSBT__BASE64
 
+            elif re.search(r"^B\$[2HZ]P[0-9A-Z]{4}", s): # https://github.com/coinkite/BBQr/blob/master/BBQr.md#spliting-the-data
+                return QRType.PSBT__BBQR
+
             # Wallet Descriptor
             desc_str = s.replace("\n","").replace(" ","")
             if re.search(r'^p(\d+)of(\d+) ', s, re.IGNORECASE):
@@ -654,8 +663,9 @@ def add(self, segment, qr_type=None):
         elif self.total_segments != self.total_segment_nums(segment):
             raise Exception('Segment total changed unexpectedly')
 
-        if self.segments[self.current_segment_num(segment) - 1] == None:
-            self.segments[self.current_segment_num(segment) - 1] = self.parse_segment(segment)
+        current_segment_num = self.current_segment_num(segment)
+        if self.segments[current_segment_num - 1] == None:
+            self.segments[current_segment_num - 1] = self.parse_segment(segment)
             self.collected_segments += 1
             if self.total_segments == self.collected_segments:
                 if self.is_valid:
@@ -704,6 +714,59 @@ def parse_segment(self, segment) -> str:
 
 
 
+class BBQRPsbtQrDecoder(BaseAnimatedQrDecoder):
+    """
+        Used to decode BBQR Animated PSBT encoding.
+    """
+    def __init__(self):
+        super().__init__()
+        self.encoding = None
+
+
+    def get_data(self) -> str:
+        logger.debug("BBQRPsbtQrDecoder get_data")
+        data = "".join(self.segments)
+        if self.complete and self.encoding:
+            if self.encoding == 'H':
+                return b''.join(bytes.fromhex(s) for s in self.segments)
+
+            # base32 decode, but insert padding for API
+            rv = b''
+            for p in self.segments:
+                padding = (8 - (len(p) % 8)) % 8
+                rv += b32decode(p + (padding*'='))
+
+            if self.encoding == 'Z':
+                # decompress
+                z = zlib.decompressobj(wbits=-10)
+                rv = z.decompress(rv)
+                rv += z.flush()
+
+            return rv
+
+        return None
+
+    def current_segment_num(self, segment) -> int:
+        current_segment = int(segment[6:8], 36) + 1
+        logger.debug(f"BBQRPsbtQrDecoder current_segment_num {current_segment}")
+        return current_segment
+
+
+    def total_segment_nums(self, segment) -> int:
+        total_segments = int(segment[4:6], 36)
+        logger.debug(f"BBQRPsbtQrDecoder total_segment_nums {total_segments}")
+        return total_segments
+
+
+    def parse_segment(self, segment) -> str:
+        self.encoding = segment[2]
+        file_type = segment[3]
+        data = segment[8:]
+
+        return data.strip()
+
+
+
 class Base64PsbtQrDecoder(BaseSingleFrameQrDecoder):
     """
         Decodes single frame base64 encoded qr image.

src/seedsigner/models/qr_type.py

@@ -6,6 +6,7 @@ class QRType:
     PSBT__SPECTER = "psbt__specter"
     PSBT__BASE43 = "psbt__base43"
     PSBT__UR2 = "psbt__ur2"
+    PSBT__BBQR = "psbt__bbqr"
 
     SEED__SEEDQR = "seed__seedqr"
     SEED__COMPACTSEEDQR = "seed__compactseedqr"