ebellocchia · ebellocchia · Feb 27, 2026 · Feb 25, 2026 · Feb 25, 2026 · Feb 25, 2026
diff --git a/.github/workflows/code-analysis.yml b/.github/workflows/code-analysis.yml
@@ -31,7 +31,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.13
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.13"
     - name: Install dependencies

diff --git a/.github/workflows/code-coverage.yml b/.github/workflows/code-coverage.yml
@@ -31,7 +31,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.13
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.13"
     - name: Install dependencies

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -38,7 +38,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -68,7 +68,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -98,7 +98,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies
@@ -126,7 +126,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies

diff --git a/.github/workflows/test_min_reqs.yml b/.github/workflows/test_min_reqs.yml
@@ -37,7 +37,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.7
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v5
       with:
         python-version: "3.7"
     - name: Install minimum dependencies
@@ -52,6 +52,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.1.3
+        pip install pytoniq-core-fork==0.1.47
         pip install typing_extensions
     - name: Run tests
       run: |
@@ -69,7 +70,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.8
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5
       with:
         python-version: "3.8"
     - name: Install minimum dependencies
@@ -84,6 +85,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.1.3
+        pip install pytoniq-core-fork==0.1.47
     - name: Run tests
       run: |
         pytest
@@ -100,7 +102,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.9
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5
       with:
         python-version: "3.9"
     - name: Install minimum dependencies
@@ -115,6 +117,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.1.3
+        pip install pytoniq-core-fork==0.1.47
     - name: Run tests
       run: |
         pytest
@@ -132,7 +135,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.10
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5
       with:
         python-version: "3.10"
     - name: Install minimum dependencies
@@ -147,6 +150,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.1.4
+        pip install pytoniq-core-fork==0.1.47
     - name: Run tests
       run: |
         pytest
@@ -163,7 +167,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.11
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5
       with:
         python-version: "3.11"
     - name: Install minimum dependencies
@@ -178,6 +182,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.2.0
+        pip install pytoniq-core-fork==0.1.47
     - name: Run tests
       run: |
         pytest
@@ -194,7 +199,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.12
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5
       with:
         python-version: "3.12"
     - name: Install minimum dependencies
@@ -209,6 +214,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.2.0
+        pip install pytoniq-core-fork==0.1.47
     - name: Run tests
       run: |
         pytest
@@ -225,7 +231,7 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python 3.13
-      uses: actions/setup-python@v3
+      uses: actions/setup-python@v5
       with:
         python-version: "3.13"
     - name: Install minimum dependencies
@@ -240,6 +246,7 @@ jobs:
         pip install pycryptodome==3.15
         pip install pynacl==1.5
         pip install py-sr25519-bindings==0.2.2
+        pip install pytoniq-core-fork==0.1.47
     - name: Run tests
       run: |
         pytest
diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Emanuele Bellocchia
+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:
 

diff --git a/README.md b/README.md
@@ -53,6 +53,7 @@ Package dependencies:
 - [ed25519-blake2b](https://pypi.org/project/ed25519-blake2b/) for ed25519-blake2b curve
 - [pynacl](https://pypi.org/project/PyNaCl/) for ed25519 curve
 - [py-sr25519-bindings](https://pypi.org/project/py-sr25519-bindings/) for sr25519 curve
+- [pytoniq-core-fork](https://github.com/ebellocchia/pytoniq-core) for TON primitives (my fork to extend compatibility to Python >= 3.7)
 
 Please note that, for the py-sr25519-bindings library, Rust is required to be installed.
 
@@ -120,6 +121,7 @@ Supported BIP coins:
 - Terra
 - Tezos
 - Theta Network
+- Ton
 - Tron
 - VeChain
 - Verge
@@ -198,6 +200,7 @@ To run code analysis:
 - [Electrum](https://github.com/ebellocchia/bip_utils/tree/master/readme/electrum.md)
 - [Monero](https://github.com/ebellocchia/bip_utils/tree/master/readme/monero.md)
 - [Substrate](https://github.com/ebellocchia/bip_utils/tree/master/readme/substrate.md)
+- [Ton](https://github.com/ebellocchia/bip_utils/tree/master/readme/ton.md)
 - [Utility libraries](https://github.com/ebellocchia/bip_utils/tree/master/readme/utility_libs.md)
 
 ## Documentation

diff --git a/benchmark/benchmark.py b/benchmark/benchmark.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/benchmark_tests_base.py b/benchmark/tests/benchmark_tests_base.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/bip44_tests.py b/benchmark/tests/bip44_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/ed25519_blake2b_tests.py b/benchmark/tests/ed25519_blake2b_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/ed25519_kholaw_tests.py b/benchmark/tests/ed25519_kholaw_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/ed25519_tests.py b/benchmark/tests/ed25519_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/monero_tests.py b/benchmark/tests/monero_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/nist256p1_tests.py b/benchmark/tests/nist256p1_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/secp256k1_tests.py b/benchmark/tests/secp256k1_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/benchmark/tests/substrate_tests.py b/benchmark/tests/substrate_tests.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/__init__.py b/bip_utils/__init__.py
@@ -116,6 +116,8 @@
     SuiAddr,
     SuiAddrDecoder,
     SuiAddrEncoder,
+    TonAddr,
+    TonAddrEncoder,
     TrxAddr,
     TrxAddrDecoder,
     TrxAddrEncoder,
@@ -384,6 +386,30 @@
     SubstrateScaleU256Encoder,
 )
 
+# TON
+from bip_utils.ton import (
+    Ton,
+    TonKeyError,
+    TonPrivateKey,
+    TonPublicKey,
+)
+from bip_utils.ton.addr import (
+    TonAddrVersions,
+    TonV3R1AddrEncoder,
+    TonV3R2AddrEncoder,
+    TonV4AddrEncoder,
+    TonV5R1AddrEncoder,
+)
+from bip_utils.ton.mnemonic import (
+    TonLanguages,
+    TonMnemonic,
+    TonMnemonicGenerator,
+    TonMnemonicValidator,
+    TonSeedGenerator,
+    TonSeedTypes,
+    TonWordsNum,
+)
+
 # Utils
 from bip_utils.utils.crypto import (
     AesEcbDecrypter,
@@ -412,6 +438,8 @@
     AlgoUtils,
     Base32Decoder,
     Base32Encoder,
+    Base64Decoder,
+    Base64Encoder,
     BitUtils,
     BytesUtils,
     DataBytes,

diff --git a/bip_utils/addr/P2PKH_addr.py b/bip_utils/addr/P2PKH_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/P2SH_addr.py b/bip_utils/addr/P2SH_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/P2TR_addr.py b/bip_utils/addr/P2TR_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/P2WPKH_addr.py b/bip_utils/addr/P2WPKH_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/__init__.py b/bip_utils/addr/__init__.py
@@ -76,6 +76,7 @@
     SubstrateSr25519AddrEncoder,
 )
 from bip_utils.addr.sui_addr import SuiAddr, SuiAddrDecoder, SuiAddrEncoder
+from bip_utils.addr.ton_addr import TonAddr, TonAddrEncoder
 from bip_utils.addr.trx_addr import TrxAddr, TrxAddrDecoder, TrxAddrEncoder
 from bip_utils.addr.xlm_addr import XlmAddr, XlmAddrDecoder, XlmAddrEncoder, XlmAddrTypes
 from bip_utils.addr.xmr_addr import (

diff --git a/bip_utils/addr/ada_byron_addr.py b/bip_utils/addr/ada_byron_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2022 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/ada_shelley_addr.py b/bip_utils/addr/ada_shelley_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2022 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/addr_dec_utils.py b/bip_utils/addr/addr_dec_utils.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/addr_key_validator.py b/bip_utils/addr/addr_key_validator.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/algo_addr.py b/bip_utils/addr/algo_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/aptos_addr.py b/bip_utils/addr/aptos_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/atom_addr.py b/bip_utils/addr/atom_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/avax_addr.py b/bip_utils/addr/avax_addr.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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

diff --git a/bip_utils/addr/bch_addr_converter.py b/bip_utils/addr/bch_addr_converter.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Emanuele Bellocchia
+# 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