bip-utils 2.12.2__tar.gz → 2.12.3__tar.gz

{bip_utils-2.12.2/bip_utils.egg-info → bip_utils-2.12.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bip_utils
-Version: 2.12.2
+Version: 2.12.3
 Summary: Generation of mnemonics, seeds, private/public keys and addresses for different types of cryptocurrencies
 Author-email: Emanuele Bellocchia <ebellocchia@gmail.com>
 Maintainer-email: Emanuele Bellocchia <ebellocchia@gmail.com>
@@ -32,7 +32,6 @@ Requires-Dist: coincurve>=16.0.0; python_version == "3.10"
 Requires-Dist: coincurve>=18.0.0; python_version == "3.11"
 Requires-Dist: coincurve>=19.0.1; python_version >= "3.12"
 Requires-Dist: coincurve>=21.0.0; python_version >= "3.13"
-Requires-Dist: crcmod~=1.7
 Requires-Dist: ecdsa~=0.17
 Requires-Dist: ed25519-blake2b-fork<2.0.0,>=1.4.2
 Requires-Dist: pycryptodome~=3.15
@@ -101,7 +100,6 @@ Other implemented functionalities:
 
 Package dependencies:
 - [cbor2](https://pypi.org/project/cbor2/) for CBOR encoding/decoding
-- [crcmod](https://pypi.org/project/crcmod/) for CRC computation
 - [pycryptodome](https://pypi.org/project/pycryptodome/) for cryptographic functions
 - [coincurve](https://pypi.org/project/coincurve/) for secp256k1 curve
 - [ecdsa](https://pypi.org/project/ecdsa/) for nist256p1 and secp256k1 curves

{bip_utils-2.12.2 → bip_utils-2.12.3}/README.md

@@ -46,7 +46,6 @@ Other implemented functionalities:
 
 Package dependencies:
 - [cbor2](https://pypi.org/project/cbor2/) for CBOR encoding/decoding
-- [crcmod](https://pypi.org/project/crcmod/) for CRC computation
 - [pycryptodome](https://pypi.org/project/pycryptodome/) for cryptographic functions
 - [coincurve](https://pypi.org/project/coincurve/) for secp256k1 curve
 - [ecdsa](https://pypi.org/project/ecdsa/) for nist256p1 and secp256k1 curves

bip_utils-2.12.3/bip_utils/_version.py

@@ -0,0 +1 @@
+__version__: str = "2.12.3"

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils/algorand/mnemonic/algorand_mnemonic_decoder.py

@@ -32,7 +32,7 @@ from bip_utils.algorand.mnemonic.algorand_mnemonic import AlgorandLanguages, Alg
 from bip_utils.algorand.mnemonic.algorand_mnemonic_utils import AlgorandMnemonicUtils
 from bip_utils.bip.bip39.bip39_mnemonic_utils import Bip39WordsListFinder, Bip39WordsListGetter
 from bip_utils.utils.misc import BytesUtils
-from bip_utils.utils.mnemonic import Mnemonic, MnemonicChecksumError, MnemonicDecoderBase, MnemonicWordsList
+from bip_utils.utils.mnemonic import Mnemonic, MnemonicChecksumError, MnemonicDecoderBase
 
 
 class AlgorandMnemonicDecoder(MnemonicDecoderBase):
@@ -98,28 +98,23 @@ class AlgorandMnemonicDecoder(MnemonicDecoderBase):
         entropy_bytes = BytesUtils.FromList(entropy_list)[:-1]
 
         # Validate checksum
-        self.__ValidateChecksum(entropy_bytes, word_indexes[-1], words_list)
+        self.__ValidateChecksum(entropy_bytes, word_indexes[-1])
 
         return entropy_bytes
 
     @staticmethod
     def __ValidateChecksum(entropy_bytes: bytes,
-                           chksum_word_idx_exp: int,
-                           words_list: MnemonicWordsList) -> None:
+                           chksum_word_idx_exp: int) -> None:
         """
         Validate a mnemonic checksum.
 
         Args:
-            entropy_bytes (bytes)         : Entropy bytes
-            chksum_word_idx_exp (int)     : Expected checksum word index
-            words_list (MnemonicWordsList): Words list
+            entropy_bytes (bytes)    : Entropy bytes
+            chksum_word_idx_exp (int): Expected checksum word index
 
         Raises:
             MnemonicChecksumError: If checksum is not valid
         """
         chksum_word_idx = AlgorandMnemonicUtils.ComputeChecksumWordIndex(entropy_bytes)
         if chksum_word_idx != chksum_word_idx_exp:
-            raise MnemonicChecksumError(
-                f"Invalid checksum (expected {words_list.GetWordAtIdx(chksum_word_idx)}, "
-                f"got {words_list.GetWordAtIdx(chksum_word_idx_exp)})"
-            )
+            raise MnemonicChecksumError("Invalid checksum")

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils/bip/bip39/bip39_mnemonic_decoder.py

@@ -132,9 +132,7 @@ class Bip39MnemonicDecoder(MnemonicDecoderBase):
         checksum_bin_str_got = self.__ComputeChecksumBinaryStr(mnemonic_bin_str)
 
         if checksum_bin_str != checksum_bin_str_got:
-            raise MnemonicChecksumError(
-                f"Invalid checksum (expected {checksum_bin_str}, got {checksum_bin_str_got})"
-            )
+            raise MnemonicChecksumError("Invalid checksum")
 
         return mnemonic_bin_str
 

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils/monero/mnemonic_legacy/monero_mnemonic_decoder.py

@@ -120,4 +120,4 @@ class MoneroMnemonicDecoder(MnemonicDecoderBase):
         if len(words) in MoneroMnemonicConst.MNEMONIC_WORD_NUM_CHKSUM:
             chksum_word = MoneroMnemonicUtils.ComputeChecksum(words[:-1], lang)
             if words[-1] != chksum_word:
-                raise MnemonicChecksumError(f"Invalid checksum (expected {chksum_word}, got {words[-1]})")
+                raise MnemonicChecksumError("Invalid checksum")

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils/ton/mnemonic/ton_seed_generator.py

@@ -67,7 +67,7 @@ class TonSeedGenerator:
         """
         mnemonic_str = mnemonic if isinstance(mnemonic, str) else mnemonic.ToStr()
         if not TonMnemonicValidator(lang).IsValid(mnemonic_str, passphrase):
-            raise ValueError(f"Invalid mnemonic {mnemonic_str}")
+            raise ValueError("Invalid mnemonic")
         self.m_mnemonic = mnemonic_str
         self.m_passphrase = passphrase
 

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils/utils/crypto/crc.py

@@ -24,15 +24,9 @@
 import binascii
 from typing import Union
 
-import crcmod.predefined
-
 from bip_utils.utils.misc import AlgoUtils, IntegerUtils
 
 
-# Get the class only once for efficiency
-XMODEM_CRC = crcmod.predefined.Crc("xmodem")
-
-
 class Crc32:
     """
     CRC32 class.
@@ -63,7 +57,7 @@ class Crc32:
         Returns:
             int: Computed digest
         """
-        return binascii.crc32(AlgoUtils.Encode(data))   # Much faster than crcmod
+        return binascii.crc32(AlgoUtils.Encode(data))
 
     @staticmethod
     def DigestSize() -> int:
@@ -93,7 +87,9 @@ class XModemCrc:
         Returns:
             bytes: Computed digest
         """
-        return XMODEM_CRC.new(AlgoUtils.Encode(data)).digest()
+        # crc_hqx is MSB-first with polynomial 0x1021 and no final XOR: with initial value zero, it is XMODEM-CRC
+        crc = binascii.crc_hqx(AlgoUtils.Encode(data), 0)
+        return IntegerUtils.ToBytes(crc, bytes_num=XModemCrc.DigestSize())
 
     @staticmethod
     def DigestSize() -> int:
@@ -103,4 +99,4 @@ class XModemCrc:
         Returns:
             int: Digest size in bytes
         """
-        return XMODEM_CRC.digest_size
+        return 2

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils/utils/mnemonic/mnemonic_utils.py

@@ -136,10 +136,11 @@ class MnemonicWordsList:
         Raises:
             ValueError: If the word is not found
         """
-        try:
-            return self.m_words_to_idx[word]
-        except KeyError as ex:
-            raise ValueError(f"Unable to find word {word}") from ex
+        word_idx = self.m_words_to_idx.get(word)
+        # Not raised from a KeyError, which would hold the word and stay chained to the ValueError
+        if word_idx is None:
+            raise ValueError("Unable to find word")
+        return word_idx
 
     def GetWordAtIdx(self,
                      word_idx: int) -> str:
@@ -319,4 +320,4 @@ class MnemonicWordsListFinderBase(ABC):
                 continue
 
         # Language not found
-        raise ValueError(f"Invalid language for mnemonic '{mnemonic.ToStr()}'")
+        raise ValueError("Invalid language for mnemonic")

{bip_utils-2.12.2 → bip_utils-2.12.3/bip_utils.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bip_utils
-Version: 2.12.2
+Version: 2.12.3
 Summary: Generation of mnemonics, seeds, private/public keys and addresses for different types of cryptocurrencies
 Author-email: Emanuele Bellocchia <ebellocchia@gmail.com>
 Maintainer-email: Emanuele Bellocchia <ebellocchia@gmail.com>
@@ -32,7 +32,6 @@ Requires-Dist: coincurve>=16.0.0; python_version == "3.10"
 Requires-Dist: coincurve>=18.0.0; python_version == "3.11"
 Requires-Dist: coincurve>=19.0.1; python_version >= "3.12"
 Requires-Dist: coincurve>=21.0.0; python_version >= "3.13"
-Requires-Dist: crcmod~=1.7
 Requires-Dist: ecdsa~=0.17
 Requires-Dist: ed25519-blake2b-fork<2.0.0,>=1.4.2
 Requires-Dist: pycryptodome~=3.15
@@ -101,7 +100,6 @@ Other implemented functionalities:
 
 Package dependencies:
 - [cbor2](https://pypi.org/project/cbor2/) for CBOR encoding/decoding
-- [crcmod](https://pypi.org/project/crcmod/) for CRC computation
 - [pycryptodome](https://pypi.org/project/pycryptodome/) for cryptographic functions
 - [coincurve](https://pypi.org/project/coincurve/) for secp256k1 curve
 - [ecdsa](https://pypi.org/project/ecdsa/) for nist256p1 and secp256k1 curves

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils.egg-info/SOURCES.txt

@@ -570,6 +570,7 @@ tests/ton/mnemonic/__init__.py
 tests/ton/mnemonic/test_ton_mnemonic.py
 tests/utils/__init__.py
 tests/utils/test_cbor_indefinite_len_array.py
+tests/utils/test_crc.py
 tests/utils/test_data_bytes.py
 tests/wif/__init__.py
 tests/wif/test_wif.py

{bip_utils-2.12.2 → bip_utils-2.12.3}/bip_utils.egg-info/requires.txt

@@ -1,4 +1,3 @@
-crcmod~=1.7
 ecdsa~=0.17
 ed25519-blake2b-fork<2.0.0,>=1.4.2
 pycryptodome~=3.15

{bip_utils-2.12.2 → bip_utils-2.12.3}/requirements.txt

@@ -6,7 +6,6 @@ coincurve>=16.0.0; python_version == '3.10'
 coincurve>=18.0.0; python_version == '3.11'
 coincurve>=19.0.1; python_version >= '3.12'
 coincurve>=21.0.0; python_version >= '3.13'
-crcmod~=1.7
 ecdsa~=0.17
 ed25519-blake2b-fork>=1.4.2,<2.0.0
 pycryptodome~=3.15

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/algorand/mnemonic/test_algorand_mnemonic.py

@@ -20,6 +20,7 @@
 
 # Imports
 import binascii
+import re
 import unittest
 
 from bip_utils import (
@@ -118,11 +119,11 @@ TEST_VECT_MNEMONIC_INVALID = [
     },
     # Not existent word
     {
-        "mnemonic": "abandon abandon notexistent abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon invest",
+        "mnemonic": "abandon abandon notexistent abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon invest",
         "exception": ValueError,
     },
     {
-        "mnemonic": "abandon abandon notexistent abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon invest",
+        "mnemonic": "abandon abandon notexistent abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon invest",
         "lang": None,
         "exception": ValueError,
     },
@@ -214,7 +215,14 @@ class AlgorandMnemonicTests(unittest.TestCase):
 
             self.assertFalse(AlgorandMnemonicValidator(lang).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], AlgorandMnemonicValidator(lang).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], AlgorandSeedGenerator, test["mnemonic"], lang)
+            with self.assertRaises(test["exception"]) as ctx:
+                AlgorandSeedGenerator(test["mnemonic"], lang)
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/bip/bip39/test_bip39.py

@@ -20,6 +20,7 @@
 
 # Imports
 import binascii
+import re
 import unittest
 
 from bip_utils import (
@@ -433,7 +434,14 @@ class Bip39Tests(unittest.TestCase):
 
             self.assertFalse(Bip39MnemonicValidator(lang).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], Bip39MnemonicValidator(lang).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], Bip39SeedGenerator, test["mnemonic"], lang)
+            with self.assertRaises(test["exception"]) as ctx:
+                Bip39SeedGenerator(test["mnemonic"], lang)
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/electrum/mnemonic/test_electrum_v1_mnemonic.py

@@ -20,6 +20,7 @@
 
 # Imports
 import binascii
+import re
 import unittest
 
 from bip_utils import (
@@ -219,7 +220,14 @@ class ElectrumV1MnemonicTests(unittest.TestCase):
 
             self.assertFalse(ElectrumV1MnemonicValidator(lang).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], ElectrumV1MnemonicValidator(lang).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], ElectrumV1SeedGenerator, test["mnemonic"], lang)
+            with self.assertRaises(test["exception"]) as ctx:
+                ElectrumV1SeedGenerator(test["mnemonic"], lang)
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/electrum/mnemonic/test_electrum_v2_mnemonic.py

@@ -21,6 +21,7 @@
 # Imports
 import binascii
 import math
+import re
 import unittest
 
 from bip_utils import (
@@ -259,7 +260,14 @@ class ElectrumV2MnemonicTests(unittest.TestCase):
 
             self.assertFalse(ElectrumV2MnemonicValidator(lang=lang).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], ElectrumV2MnemonicValidator(lang=lang).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], ElectrumV2SeedGenerator, test["mnemonic"], lang)
+            with self.assertRaises(test["exception"]) as ctx:
+                ElectrumV2SeedGenerator(test["mnemonic"], lang)
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/monero/mnemonic_legacy/test_monero_mnemonic.py

@@ -20,6 +20,7 @@
 
 # Imports
 import binascii
+import re
 import unittest
 
 from bip_utils import (
@@ -361,7 +362,14 @@ class MoneroMnemonicTests(unittest.TestCase):
 
             self.assertFalse(MoneroMnemonicValidator(lang).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], MoneroMnemonicValidator(lang).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], MoneroSeedGenerator, test["mnemonic"], lang)
+            with self.assertRaises(test["exception"]) as ctx:
+                MoneroSeedGenerator(test["mnemonic"], lang)
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/monero/mnemonic_polyseed/test_monero_polyseed_mnemonic.py

@@ -20,6 +20,7 @@
 
 # Imports
 import binascii
+import re
 import unittest
 
 from bip_utils import (
@@ -333,7 +334,14 @@ class MoneroPolyseedMnemonicTests(unittest.TestCase):
 
             self.assertFalse(MoneroPolyseedMnemonicValidator(coin).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], MoneroPolyseedMnemonicValidator(coin).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], MoneroPolyseedMnemonicDecoder(coin).Decode, test["mnemonic"])
+            with self.assertRaises(test["exception"]) as ctx:
+                MoneroPolyseedMnemonicDecoder(coin).Decode(test["mnemonic"])
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

{bip_utils-2.12.2 → bip_utils-2.12.3}/tests/ton/mnemonic/test_ton_mnemonic.py

@@ -20,6 +20,7 @@
 
 # Imports
 import binascii
+import re
 import unittest
 
 from bip_utils import (
@@ -145,7 +146,14 @@ class TonMnemonicTests(unittest.TestCase):
 
             self.assertFalse(TonMnemonicValidator(lang).IsValid(test["mnemonic"]))
             self.assertRaises(test["exception"], TonMnemonicValidator(lang).Validate, test["mnemonic"])
-            self.assertRaises(test["exception"], TonSeedGenerator, test["mnemonic"], "", lang)
+            with self.assertRaises(test["exception"]) as ctx:
+                TonSeedGenerator(test["mnemonic"], "", lang)
+            # The mnemonic words shall not be in the exception message, nor in a chained exception
+            self.assertIsNone(ctx.exception.__cause__)
+            self.assertIsNone(ctx.exception.__context__)
+            ex_words = re.findall(r"\w+", str(ctx.exception))
+            for word in test["mnemonic"].split(" "):
+                self.assertNotIn(word, ex_words)
 
     # Tests invalid parameters
     def test_invalid_params(self):

bip_utils-2.12.3/tests/utils/test_crc.py

@@ -0,0 +1,71 @@
+# Copyright (c) 2026 Emanuele Bellocchia
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+# Imports
+import binascii
+import unittest
+
+from bip_utils import XModemCrc
+
+
+# Test vector for XMODEM-CRC
+TEST_VECT_XMODEM = [
+    {
+        "data": b"",
+        "digest": b"0000",
+    },
+    # Standard check value
+    {
+        "data": b"123456789",
+        "digest": b"31c3",
+    },
+    # Same as before, but with data as string
+    {
+        "data": "123456789",
+        "digest": b"31c3",
+    },
+    # Digest whose most significant byte is zero
+    {
+        "data": b"cr",
+        "digest": b"00ac",
+    },
+    {
+        "data": b"The quick brown fox jumps over the lazy dog",
+        "digest": b"f0c8",
+    },
+    {
+        "data": bytes(range(256)),
+        "digest": b"7e55",
+    },
+]
+
+
+#
+# Tests
+#
+class XModemCrcTests(unittest.TestCase):
+    # Run all tests in test vector
+    def test_vector(self):
+        for test in TEST_VECT_XMODEM:
+            self.assertEqual(binascii.unhexlify(test["digest"]), XModemCrc.QuickDigest(test["data"]))
+
+    # Test digest size
+    def test_digest_size(self):
+        self.assertEqual(2, XModemCrc.DigestSize())

bip_utils-2.12.2/bip_utils/_version.py

@@ -1 +0,0 @@
-__version__: str = "2.12.2"