hashlib

Description:

hashlib

hashlib #








This library contains implementations of secure hash functions, checksum generators, and key derivation algorithms optimized for Dart.
Depencencies #
There is only 1 dependency used by this package:

hashlib_codecs

Features #
Block Hash Algorithms #



Algorithm
Available methods
Source




MD4
md4
RFC-1320


MD5
md5
RFC-1321


SHA-1
sha1
RFC-3174


SHA-2
sha224, sha256, sha384, sha512, sha512t224, sha512t256
RFC-6234


SHA-3
sha3_224, sha3_256, sha3_384, sha3_512
FIPS-202


SHAKE-128
Shake128, shake128, shake128_128, shake128_256
FIPS-202


SHAKE-256
Shake256, shake256, shake256_256, shake256_512
FIPS-202


Keccak
keccak224, keccak256, keccak384, keccak512
Team Keccak


Blake2b
blake2b160, blake2b256, blake2b384, blake2b512
RFC-7693


Blake2s
blake2s128, blake2s160, blake2s224, blake2s256
RFC-7693


xxHash-32
XXHash32,xxh32,xxh32code
Cyan4973


xxHash-64
XXHash64,xxh64,xxh64code
Cyan4973


xxHash3-64
XXH3, xxh3, xxh3code
Cyan4973


xxHash3-128
XXH128, xxh128, xxh128code
Cyan4973


RIPEMD
ripemd128, ripemd256, ripemd160, ripemd320
ISO/IEC 10118-3:2018


SM3
sm3
GB/T 32905-2016



Password / Key Derivation Algorithms #



Algorithm
Available methods
Source




Argon2
Argon2, argon2d, argon2i, argon2id, argon2Verify
RFC-9106


PBKDF2
PBKDF2, pbkdf2, #.pbkdf2
RFC-8081


scrypt
Scrypt, scrypt,
RFC-7914


bcrypt
Bcrypt, bcrypt, bcryptSalt, bcryptVerify, bcryptDigest




Message Authentication Code (MAC) Generators #



Algorithms
Available methods
Source




HMAC
HMAC, #.hmac
RFC-2104


Poly1305
Poly1305, poly1305, poly1305auth
RFC-8439



OTP generation for 2FA #



Algorithms
Available methods
Source




HOTP
HOTP
RFC-4226


TOTP
TOTP
RFC-6238



Other Hash Algorithms #



Algorithms
Available methods
Source




CRC
crc16, crc32, crc64
Wikipedia


Alder32
alder32
Wikipedia



Random Number Generation #
Available generators:

secure
system
keccak
sha256
md5
xxh64
sm3

Demo #
A demo application is available in Google Play Store featuring the capabilities of this package.


Getting Started #
The following import will give you access to all of the algorithms in this package.
import 'package:hashlib/hashlib.dart' as hashlib;
copied to clipboard
Check the API Reference for details.
Usage #
Examples can be found inside the example folder.
import 'package:hashlib/hashlib.dart';
import 'package:hashlib_codecs/hashlib_codecs.dart';

void main() {
var text = "Happy Hashing!";
var key = "password";
var pw = key.codeUnits;
var iv = "some salt".codeUnits;
print("text => $text");
print("key => $key");
print("salt => ${toHex(iv)}");
print('');

// Example of hash code generations
print('XXH32 => ${xxh32code(text)}');
print('CRC32 => ${crc32code(text)}');
print('Alder32 => ${alder32code(text)}');
print('CRC16 => ${crc16code(text)}');
print('');

// Examples of Hash generation
print('CRC64 => ${crc64sum(text)}');
print('XXH64 => ${xxh64sum(text)}');
print('XXH3 => ${xxh3sum(text)}');
print('XXH128 => ${xxh128sum(text)}');
print('MD4 => ${md4.string(text)}');
print('MD5 => ${md5.string(text)}');
print('SHA-1 => ${sha1.string(text)}');
print('SHA-224 => ${sha224.string(text)}');
print('SHA-256 => ${sha256.string(text)}');
print('SHA-384 => ${sha384.string(text)}');
print('SHA-512 => ${sha512.string(text)}');
print('SHA-512/224 => ${sha512t224.string(text)}');
print('SHA-512/256 => ${sha512t256.string(text)}');
print('SHA3-224 => ${sha3_224.string(text)}');
print('SHA3-256 => ${sha3_256.string(text)}');
print('SHA3-384 => ${sha3_384.string(text)}');
print('SHA3-512 => ${sha3_512.string(text)}');
print('Keccak-224 => ${keccak224.string(text)}');
print('Keccak-256 => ${keccak256.string(text)}');
print('Keccak-384 => ${keccak384.string(text)}');
print('Keccak-512 => ${keccak512.string(text)}');
print('SHAKE-128 => ${shake128.of(20).string(text)}');
print('SHAKE-256 => ${shake256.of(20).string(text)}');
print('BLAKE2s-256 => ${blake2s256.string(text)}');
print('BLAKE2b-512 => ${blake2b512.string(text)}');
print('SM3] => ${sm3.string(text)}');
print('');

// Examples of MAC generations
print('HMAC/MD5 => ${md5.hmac.by(pw).string(text)}');
print('HMAC/SHA1 => ${sha1.hmac.byString(text)}');
print('HMAC/SHA256 => ${sha256.hmac.byString(key).string(text)}');
print('HMAC/SHA3-256 => ${HMAC(sha3_256).by(pw).string(text)}');
print("HMAC/BLAKE2b-256 => ${blake2b512.hmac.by(pw).string(text)}");
print("BLAKE-2b-MAC/256 => ${blake2b256.mac.by(pw).string(text)}");
print("BLAKE-2b-MAC/224 => ${Blake2b(28).mac.by(pw).string(text)}");
print('');

// Examples of PBKDF2 key derivation
print("SHA256/HMAC/PBKDF2 => ${pbkdf2(pw, iv, 100).hex()}");
print("SHA1/HMAC/PBKDF2 => ${sha1.pbkdf2(iv, 100).hex(pw)}");
print("BLAKE2b-256/HMAC/PBKDF2 => ${blake2b256.pbkdf2(iv, 100).hex(pw)}");
print("BLAKE2b-256/MAC/PBKDF2 => ${blake2b256.mac.pbkdf2(iv, 100).hex(pw)}");
print('');

// Examples of OTP generation
int nw = DateTime.now().millisecondsSinceEpoch ~/ 30000;
var counter = fromHex(nw.toRadixString(16).padLeft(16, '0'));
print('TOTP[time=$nw] => ${TOTP(iv).value()}');
print('HOTP[counter=$nw] => ${HOTP(iv, counter: counter).value()}');
print('');

// Examples of Argon2 key derivation
var argon2Test = Argon2Security.test;
print("[Argon2i] => ${argon2i(pw, iv, security: argon2Test)}");
print("[Argon2d] => ${argon2d(pw, iv, security: argon2Test)}");
print("[Argon2id] => ${argon2id(pw, iv, security: argon2Test)}");

// Examples of scrypt key derivation
var scryptLittle = ScryptSecurity.little;
print("[scrypt] => ${scrypt(pw, iv, security: scryptLittle, dklen: 24)}");
print('');

// Examples of bcrypt key derivation
var bcryptLittle = BcryptSecurity.little;
print("[bcrypt] => ${bcrypt(pw, bcryptSalt(security: bcryptLittle))}");
print('');
}
copied to clipboard
Benchmarks #
Benchmarks #
Libraries:

Hashlib : https://pub.dev/packages/hashlib
Crypto : https://pub.dev/packages/crypto
PointyCastle : https://pub.dev/packages/pointycastle
Hash : https://pub.dev/packages/hash

With 5MB message (10 iterations):



Algorithms
hashlib
PointyCastle
crypto
hash




MD4
1.59 Gbps
836 Mbps 1.9x slow




MD5
1.42 Gbps
728 Mbps 1.95x slow
1.15 Gbps 1.23x slow
617 Mbps 2.3x slow


HMAC(MD5)
1.37 Gbps

1.13 Gbps 1.21x slow
615 Mbps 2.23x slow


SHA-1
1.25 Gbps
439 Mbps 2.84x slow
861 Mbps 1.45x slow
351 Mbps 3.55x slow


HMAC(SHA-1)
1.25 Gbps

858 Mbps 1.46x slow



SHA-224
823 Mbps
179 Mbps 4.59x slow
744 Mbps 1.11x slow
172 Mbps 4.78x slow


SHA-256
827 Mbps
181 Mbps 4.57x slow
746 Mbps 1.11x slow
172 Mbps 4.79x slow


HMAC(SHA-256)
819 Mbps

740 Mbps 1.11x slow



SHA-384
1.32 Gbps
46.07 Mbps 28.59x slow
445 Mbps 2.96x slow
151 Mbps 8.74x slow


SHA-512
1.32 Gbps
44.17 Mbps 29.77x slow
443 Mbps 2.97x slow
150 Mbps 8.74x slow


SHA3-224
823 Mbps
27.88 Mbps 29.52x slow




SHA3-256
826 Mbps
26.6 Mbps 31.06x slow




SHA3-384
1.31 Gbps
20.37 Mbps 64.17x slow




SHA3-512
1.31 Gbps
13.97 Mbps 93.79x slow




RIPEMD-128
1.77 Gbps
378 Mbps 4.69x slow




RIPEMD-160
559 Mbps
239 Mbps 2.34x slow

281 Mbps 1.99x slow


RIPEMD-256
1.91 Gbps
373 Mbps 5.11x slow




RIPEMD-320
543 Mbps
237 Mbps 2.29x slow




BLAKE-2s
1.2 Gbps





BLAKE-2b
1.38 Gbps
105 Mbps 13.12x slow




Poly1305
2.2 Gbps
1.24 Gbps 1.77x slow




XXH32
3.84 Gbps





XXH64
2.63 Gbps





XXH3
987 Mbps





XXH128
985 Mbps





SM3
637 Mbps
185 Mbps 3.44x slow





With 1KB message (5000 iterations):



Algorithms
hashlib
PointyCastle
crypto
hash




MD4
1.51 Gbps
795 Mbps 1.9x slow




MD5
1.34 Gbps
684 Mbps 1.96x slow
1.08 Gbps 1.24x slow
804 Mbps 1.67x slow


HMAC(MD5)
1.01 Gbps

886 Mbps 1.14x slow
608 Mbps 1.66x slow


SHA-1
1.16 Gbps
416 Mbps 2.79x slow
809 Mbps 1.44x slow
395 Mbps 2.93x slow


HMAC(SHA-1)
773 Mbps

578 Mbps 1.34x slow



SHA-224
763 Mbps
170 Mbps 4.49x slow
694 Mbps 1.1x slow
174 Mbps 4.39x slow


SHA-256
763 Mbps
170 Mbps 4.49x slow
692 Mbps 1.1x slow
174 Mbps 4.38x slow


HMAC(SHA-256)
519 Mbps

500 Mbps 1.04x slow



SHA-384
1.14 Gbps
40.79 Mbps 27.98x slow
391 Mbps 2.92x slow
165 Mbps 6.92x slow


SHA-512
1.14 Gbps
40.88 Mbps 27.87x slow
391 Mbps 2.92x slow
166 Mbps 6.87x slow


SHA3-224
767 Mbps
25.06 Mbps 30.59x slow




SHA3-256
767 Mbps
25.03 Mbps 30.66x slow




SHA3-384
1.14 Gbps
20.05 Mbps 56.82x slow




SHA3-512
1.14 Gbps
13.41 Mbps 85.04x slow




RIPEMD-128
1.63 Gbps
359 Mbps 4.56x slow




RIPEMD-160
535 Mbps
229 Mbps 2.34x slow

286 Mbps 1.87x slow


RIPEMD-256
1.77 Gbps
356 Mbps 4.96x slow




RIPEMD-320
509 Mbps
224 Mbps 2.28x slow




BLAKE-2s
1.18 Gbps





BLAKE-2b
1.34 Gbps
104 Mbps 12.91x slow




Poly1305
2.12 Gbps
1.23 Gbps 1.72x slow




XXH32
4.12 Gbps





XXH64
2.54 Gbps





XXH3
918 Mbps





XXH128
925 Mbps





SM3
599 Mbps
174 Mbps 3.43x slow





With 10B message (100000 iterations):



Algorithms
hashlib
PointyCastle
crypto
hash




MD4
261 Mbps
138 Mbps 1.89x slow




MD5
242 Mbps
118 Mbps 2.05x slow
125 Mbps 1.94x slow
66.64 Mbps 3.63x slow


HMAC(MD5)
35.22 Mbps

38.21 Mbps 1.08x fast
17.63 Mbps 2x slow


SHA-1
152 Mbps
64.91 Mbps 2.34x slow
97.82 Mbps 1.55x slow
42.4 Mbps 3.58x slow


HMAC(SHA-1)
19.18 Mbps

17.66 Mbps 1.09x slow



SHA-224
107 Mbps
27.04 Mbps 3.97x slow
81.07 Mbps 1.32x slow
22.87 Mbps 4.7x slow


SHA-256
107 Mbps
26.91 Mbps 3.98x slow
82.72 Mbps 1.3x slow
23.14 Mbps 4.63x slow


HMAC(SHA-256)
13.54 Mbps

14.94 Mbps 1.1x fast



SHA-384
81.51 Mbps
3.49 Mbps 23.36x slow
29.83 Mbps 2.73x slow
11.84 Mbps 6.89x slow


SHA-512
81 Mbps
3.52 Mbps 23.02x slow
29.68 Mbps 2.73x slow
11.94 Mbps 6.78x slow


SHA3-224
107 Mbps
1.9 Mbps 56.53x slow




SHA3-256
107 Mbps
1.9 Mbps 56.4x slow




SHA3-384
80.78 Mbps
1.9 Mbps 42.47x slow




SHA3-512
81.33 Mbps
1.9 Mbps 42.87x slow




RIPEMD-128
233 Mbps
60.55 Mbps 3.85x slow




RIPEMD-160
80.32 Mbps
36.69 Mbps 2.19x slow

34.53 Mbps 2.33x slow


RIPEMD-256
238 Mbps
58.04 Mbps 4.1x slow




RIPEMD-320
76.66 Mbps
34.48 Mbps 2.22x slow




BLAKE-2s
168 Mbps





BLAKE-2b
140 Mbps
7.71 Mbps 18.21x slow




Poly1305
572 Mbps
308 Mbps 1.86x slow




XXH32
840 Mbps





XXH64
656 Mbps





XXH3
82.46 Mbps





XXH128
83.76 Mbps





SM3
101 Mbps
28.19 Mbps 3.57x slow





Key derivator algorithm benchmarks on different security parameters:



Algorithms
little
moderate
good
strong




scrypt
1.589 ms
16.688 ms
91.663 ms
2937.545 ms


bcrypt
2.24 ms
17.077 ms
273.729 ms
2155.139 ms


pbkdf2
0.849 ms
17.091 ms
283.537 ms
3419.39 ms


argon2i
3.914 ms
16.474 ms
215.783 ms
2598.387 ms


argon2d
2.981 ms
16.98 ms
207.425 ms
2563.844 ms


argon2id
2.311 ms
16.491 ms
205.25 ms
2576.335 ms




All benchmarks are done on AMD Ryzen 7 5800X processor and 3200MHz RAM using compiled exe
Dart SDK version: 3.3.3 (stable) (Tue Mar 26 14:21:33 2024 +0000) on "windows_x64"