# =================================================================== # # Copyright (c) 2021, Legrandin <helderijs@gmail.com> # All rights reserved. # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in # the documentation and/or other materials provided with the # distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS # FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, # INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, # BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER # CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN # ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. # =================================================================== from Crypto.Util.py3compat import bchr from Crypto.Util._raw_api import (VoidPointer, SmartPointer, create_string_buffer, get_raw_buffer, c_size_t, c_uint8_ptr, c_ubyte) from Crypto.Util.number import long_to_bytes from Crypto.Hash.keccak import _raw_keccak_lib def _left_encode(x): """Left encode function as defined in NIST SP 800-185""" assert (x < (1 << 2040) and x >= 0) # Get number of bytes needed to represent this integer. num = 1 if x == 0 else (x.bit_length() + 7) // 8 return bchr(num) + long_to_bytes(x) def _right_encode(x): """Right encode function as defined in NIST SP 800-185""" assert (x < (1 << 2040) and x >= 0) # Get number of bytes needed to represent this integer. num = 1 if x == 0 else (x.bit_length() + 7) // 8 return long_to_bytes(x) + bchr(num) def _encode_str(x): """Encode string function as defined in NIST SP 800-185""" bitlen = len(x) * 8 if bitlen >= (1 << 2040): raise ValueError("String too large to encode in cSHAKE") return _left_encode(bitlen) + x def _bytepad(x, length): """Zero pad byte string as defined in NIST SP 800-185""" to_pad = _left_encode(length) + x # Note: this implementation works with byte aligned strings, # hence no additional bit padding is needed at this point. npad = (length - len(to_pad) % length) % length return to_pad + b'\x00' * npad class cSHAKE_XOF(object): """A cSHAKE hash object. Do not instantiate directly. Use the :func:`new` function. """ def __init__(self, data, custom, capacity, function): state = VoidPointer() if custom or function: prefix_unpad = _encode_str(function) + _encode_str(custom) prefix = _bytepad(prefix_unpad, (1600 - capacity)//8) self._padding = 0x04 else: prefix = None self._padding = 0x1F # for SHAKE result = _raw_keccak_lib.keccak_init(state.address_of(), c_size_t(capacity//8), c_ubyte(24)) if result: raise ValueError("Error %d while instantiating cSHAKE" % result) self._state = SmartPointer(state.get(), _raw_keccak_lib.keccak_destroy) self._is_squeezing = False if prefix: self.update(prefix) if data: self.update(data) def update(self, data): """Continue hashing of a message by consuming the next chunk of data. Args: data (byte string/byte array/memoryview): The next chunk of the message being hashed. """ if self._is_squeezing: raise TypeError("You cannot call 'update' after the first 'read'") result = _raw_keccak_lib.keccak_absorb(self._state.get(), c_uint8_ptr(data), c_size_t(len(data))) if result: raise ValueError("Error %d while updating %s state" % (result, self.name)) return self def read(self, length): """ Compute the next piece of XOF output. .. note:: You cannot use :meth:`update` anymore after the first call to :meth:`read`. Args: length (integer): the amount of bytes this method must return :return: the next piece of XOF output (of the given length) :rtype: byte string """ self._is_squeezing = True bfr = create_string_buffer(length) result = _raw_keccak_lib.keccak_squeeze(self._state.get(), bfr, c_size_t(length), c_ubyte(self._padding)) if result: raise ValueError("Error %d while extracting from %s" % (result, self.name)) return get_raw_buffer(bfr) def _new(data, custom, function): # Use Keccak[256] return cSHAKE_XOF(data, custom, 256, function) def new(data=None, custom=None): """Return a fresh instance of a cSHAKE128 object. Args: data (bytes/bytearray/memoryview): Optional. The very first chunk of the message to hash. It is equivalent to an early call to :meth:`update`. custom (bytes): Optional. A customization bytestring (``S`` in SP 800-185). :Return: A :class:`cSHAKE_XOF` object """ # Use Keccak[256] return cSHAKE_XOF(data, custom, 256, b'')
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
__pycache__ | Folder | 0755 |
|
|
BLAKE2b.py | File | 9.2 KB | 0644 |
|
BLAKE2b.pyi | File | 906 B | 0644 |
|
BLAKE2s.py | File | 9.21 KB | 0644 |
|
BLAKE2s.pyi | File | 739 B | 0644 |
|
CMAC.py | File | 10.11 KB | 0644 |
|
CMAC.pyi | File | 822 B | 0644 |
|
HMAC.py | File | 6.86 KB | 0644 |
|
HMAC.pyi | File | 624 B | 0644 |
|
KMAC128.py | File | 5.81 KB | 0644 |
|
KMAC128.pyi | File | 903 B | 0644 |
|
KMAC256.py | File | 2.84 KB | 0644 |
|
KMAC256.pyi | File | 226 B | 0644 |
|
KangarooTwelve.py | File | 8.82 KB | 0644 |
|
KangarooTwelve.pyi | File | 572 B | 0644 |
|
MD2.py | File | 5.97 KB | 0644 |
|
MD2.pyi | File | 492 B | 0644 |
|
MD4.py | File | 6.43 KB | 0644 |
|
MD4.pyi | File | 532 B | 0644 |
|
MD5.py | File | 6.46 KB | 0644 |
|
MD5.pyi | File | 492 B | 0644 |
|
Poly1305.py | File | 7.88 KB | 0644 |
|
Poly1305.pyi | File | 665 B | 0644 |
|
RIPEMD.py | File | 1.17 KB | 0644 |
|
RIPEMD.pyi | File | 94 B | 0644 |
|
RIPEMD160.py | File | 6.25 KB | 0644 |
|
RIPEMD160.pyi | File | 516 B | 0644 |
|
SHA.py | File | 1.12 KB | 0644 |
|
SHA.pyi | File | 161 B | 0644 |
|
SHA1.py | File | 6.53 KB | 0644 |
|
SHA1.pyi | File | 536 B | 0644 |
|
SHA224.py | File | 6.74 KB | 0644 |
|
SHA224.pyi | File | 544 B | 0644 |
|
SHA256.py | File | 6.74 KB | 0644 |
|
SHA256.pyi | File | 612 B | 0644 |
|
SHA384.py | File | 6.74 KB | 0644 |
|
SHA384.pyi | File | 544 B | 0644 |
|
SHA3_224.py | File | 6.03 KB | 0644 |
|
SHA3_224.pyi | File | 605 B | 0644 |
|
SHA3_256.py | File | 6.03 KB | 0644 |
|
SHA3_256.pyi | File | 605 B | 0644 |
|
SHA3_384.py | File | 6.13 KB | 0644 |
|
SHA3_384.pyi | File | 605 B | 0644 |
|
SHA3_512.py | File | 5.99 KB | 0644 |
|
SHA3_512.pyi | File | 605 B | 0644 |
|
SHA512.py | File | 7.54 KB | 0644 |
|
SHA512.pyi | File | 622 B | 0644 |
|
SHAKE128.py | File | 4.65 KB | 0644 |
|
SHAKE128.pyi | File | 437 B | 0644 |
|
SHAKE256.py | File | 4.65 KB | 0644 |
|
SHAKE256.pyi | File | 437 B | 0644 |
|
TupleHash128.py | File | 4.61 KB | 0644 |
|
TupleHash128.pyi | File | 652 B | 0644 |
|
TupleHash256.py | File | 2.84 KB | 0644 |
|
TupleHash256.pyi | File | 144 B | 0644 |
|
_BLAKE2b.abi3.so | File | 26.78 KB | 0755 |
|
_BLAKE2s.abi3.so | File | 26.32 KB | 0755 |
|
_MD2.abi3.so | File | 22.59 KB | 0755 |
|
_MD4.abi3.so | File | 26.55 KB | 0755 |
|
_MD5.abi3.so | File | 31.26 KB | 0755 |
|
_RIPEMD160.abi3.so | File | 59.3 KB | 0755 |
|
_SHA1.abi3.so | File | 70.38 KB | 0755 |
|
_SHA224.abi3.so | File | 44.7 KB | 0755 |
|
_SHA256.abi3.so | File | 44.76 KB | 0755 |
|
_SHA384.abi3.so | File | 52.89 KB | 0755 |
|
_SHA512.abi3.so | File | 52.93 KB | 0755 |
|
__init__.py | File | 1.21 KB | 0644 |
|
__init__.pyi | File | 0 B | 0644 |
|
_ghash_clmul.abi3.so | File | 57.01 KB | 0755 |
|
_ghash_portable.abi3.so | File | 24.44 KB | 0755 |
|
_keccak.abi3.so | File | 40.66 KB | 0755 |
|
_poly1305.abi3.so | File | 32.64 KB | 0755 |
|
cSHAKE128.py | File | 6.17 KB | 0644 |
|
cSHAKE128.pyi | File | 499 B | 0644 |
|
cSHAKE256.py | File | 2.15 KB | 0644 |
|
cSHAKE256.pyi | File | 231 B | 0644 |
|
keccak.py | File | 7.37 KB | 0644 |
|
keccak.pyi | File | 741 B | 0644 |
|