2025-04-15 20:19:33 +02:00
# Reticulum License
2025-03-13 20:11:44 +01:00
#
2025-04-15 20:19:33 +02:00
# Copyright (c) 2016-2025 Mark Qvist
2025-03-13 20:11:44 +01:00
#
# 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:
#
2025-04-15 20:19:33 +02:00
# - The Software shall not be used in any kind of system which includes amongst
# its functions the ability to purposefully do harm to human beings.
#
# - The Software shall not be used, directly or indirectly, in the creation of
# an artificial intelligence, machine learning or language model training
# dataset, including but not limited to any use that contributes to the
# training or development of such a model or algorithm.
#
# - The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
2025-03-13 20:11:44 +01:00
#
# 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.
2025-04-08 15:23:44 +02:00
import importlib . util
2022-06-08 21:03:58 +02:00
if importlib . util . find_spec ( ' hashlib ' ) != None :
import hashlib
else :
hashlib = None
if hasattr ( hashlib , " sha512 " ) :
from hashlib import sha512 as ext_sha512
else :
from . SHA512 import sha512 as ext_sha512
if hasattr ( hashlib , " sha256 " ) :
from hashlib import sha256 as ext_sha256
else :
from . SHA256 import sha256 as ext_sha256
2022-06-07 15:21:19 +02:00
2022-06-08 19:47:09 +02:00
"""
The SHA primitives are abstracted here to allow platform -
aware hardware acceleration in the future . Currently only
uses Python ' s internal SHA-256 implementation. All SHA-256
calls in RNS end up here .
"""
2022-06-07 15:21:19 +02:00
def sha256 ( data ) :
2022-06-08 21:03:58 +02:00
digest = ext_sha256 ( )
2022-06-07 15:21:19 +02:00
digest . update ( data )
2022-06-08 19:47:09 +02:00
return digest . digest ( )
def sha512 ( data ) :
2022-06-08 21:03:58 +02:00
digest = ext_sha512 ( )
2022-06-08 19:47:09 +02:00
digest . update ( data )
return digest . digest ( )
2026-05-07 14:11:49 +02:00
def file_sha256 ( file ) :
if not hashlib : raise SystemError ( " The hashlib module is not available on this system " )
2026-05-21 17:16:31 +02:00
# TODO: Could implement fallback for old snakes here
if not hasattr ( hashlib , " file_digest " ) : raise SystemError ( " The file_digest method is not available on this system. This functionality requires Python 3.11 or later. " )
2026-05-07 14:11:49 +02:00
else : return hashlib . file_digest ( file , " sha256 " ) . digest ( )