2023-03-28 23:55:57 +03:00
|
|
|
// Copyright (c) 2019-2023 Alexander Medvednikov. All rights reserved.
|
2019-11-14 10:00:22 +03:00
|
|
|
// Use of this source code is governed by an MIT license
|
|
|
|
// that can be found in the LICENSE file.
|
|
|
|
// Package sha256 implements the SHA224 and SHA256 hash algorithms as defined
|
|
|
|
// in FIPS 180-4.
|
|
|
|
// Based off: https://github.com/golang/go/tree/master/src/crypto/sha256
|
|
|
|
// Last commit: https://github.com/golang/go/commit/3ce865d7a0b88714cc433454ae2370a105210c01
|
|
|
|
module sha256
|
|
|
|
|
|
|
|
import encoding.binary
|
|
|
|
|
2019-12-06 15:24:53 +03:00
|
|
|
pub const (
|
2019-11-14 10:00:22 +03:00
|
|
|
// The size of a SHA256 checksum in bytes.
|
2020-12-20 18:08:56 +03:00
|
|
|
size = 32
|
2019-11-14 10:00:22 +03:00
|
|
|
// The size of a SHA224 checksum in bytes.
|
2020-12-20 18:08:56 +03:00
|
|
|
size224 = 28
|
2019-11-14 10:00:22 +03:00
|
|
|
// The blocksize of SHA256 and SHA224 in bytes.
|
|
|
|
block_size = 64
|
|
|
|
)
|
|
|
|
|
|
|
|
const (
|
|
|
|
chunk = 64
|
|
|
|
init0 = 0x6A09E667
|
2022-11-06 08:22:28 +03:00
|
|
|
init1 = u32(0xBB67AE85)
|
2019-11-14 10:00:22 +03:00
|
|
|
init2 = 0x3C6EF372
|
2022-11-06 08:22:28 +03:00
|
|
|
init3 = u32(0xA54FF53A)
|
2019-11-14 10:00:22 +03:00
|
|
|
init4 = 0x510E527F
|
2022-11-06 08:22:28 +03:00
|
|
|
init5 = u32(0x9B05688C)
|
2019-11-14 10:00:22 +03:00
|
|
|
init6 = 0x1F83D9AB
|
|
|
|
init7 = 0x5BE0CD19
|
2022-11-06 08:22:28 +03:00
|
|
|
init0_224 = u32(0xC1059ED8)
|
2019-11-14 10:00:22 +03:00
|
|
|
init1_224 = 0x367CD507
|
|
|
|
init2_224 = 0x3070DD17
|
2022-11-06 08:22:28 +03:00
|
|
|
init3_224 = u32(0xF70E5939)
|
|
|
|
init4_224 = u32(0xFFC00B31)
|
2019-11-14 10:00:22 +03:00
|
|
|
init5_224 = 0x68581511
|
|
|
|
init6_224 = 0x64F98FA7
|
2022-11-06 08:22:28 +03:00
|
|
|
init7_224 = u32(0xBEFA4FA4)
|
2019-11-14 10:00:22 +03:00
|
|
|
)
|
|
|
|
|
|
|
|
// digest represents the partial evaluation of a checksum.
|
|
|
|
struct Digest {
|
|
|
|
mut:
|
|
|
|
h []u32
|
2022-04-15 15:35:35 +03:00
|
|
|
x []u8
|
2019-11-14 10:00:22 +03:00
|
|
|
nx int
|
|
|
|
len u64
|
|
|
|
is224 bool // mark if this digest is SHA-224
|
|
|
|
}
|
|
|
|
|
2023-01-16 14:23:46 +03:00
|
|
|
// free the resources taken by the Digest `d`
|
|
|
|
[unsafe]
|
|
|
|
pub fn (mut d Digest) free() {
|
|
|
|
$if prealloc {
|
|
|
|
return
|
|
|
|
}
|
|
|
|
unsafe {
|
|
|
|
d.x.free()
|
|
|
|
d.h.free()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fn (mut d Digest) init() {
|
2020-12-20 18:08:56 +03:00
|
|
|
d.h = []u32{len: (8)}
|
2022-04-15 15:35:35 +03:00
|
|
|
d.x = []u8{len: sha256.chunk}
|
2023-01-16 18:30:40 +03:00
|
|
|
d.reset()
|
2023-01-16 14:23:46 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
// reset the state of the Digest `d`
|
|
|
|
pub fn (mut d Digest) reset() {
|
2019-11-14 10:00:22 +03:00
|
|
|
if !d.is224 {
|
2021-05-08 13:32:29 +03:00
|
|
|
d.h[0] = u32(sha256.init0)
|
|
|
|
d.h[1] = u32(sha256.init1)
|
|
|
|
d.h[2] = u32(sha256.init2)
|
|
|
|
d.h[3] = u32(sha256.init3)
|
|
|
|
d.h[4] = u32(sha256.init4)
|
|
|
|
d.h[5] = u32(sha256.init5)
|
|
|
|
d.h[6] = u32(sha256.init6)
|
|
|
|
d.h[7] = u32(sha256.init7)
|
2019-11-14 10:00:22 +03:00
|
|
|
} else {
|
2021-05-08 13:32:29 +03:00
|
|
|
d.h[0] = u32(sha256.init0_224)
|
|
|
|
d.h[1] = u32(sha256.init1_224)
|
|
|
|
d.h[2] = u32(sha256.init2_224)
|
|
|
|
d.h[3] = u32(sha256.init3_224)
|
|
|
|
d.h[4] = u32(sha256.init4_224)
|
|
|
|
d.h[5] = u32(sha256.init5_224)
|
|
|
|
d.h[6] = u32(sha256.init6_224)
|
|
|
|
d.h[7] = u32(sha256.init7_224)
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
|
|
|
d.nx = 0
|
|
|
|
d.len = 0
|
|
|
|
}
|
|
|
|
|
|
|
|
// new returns a new Digest (implementing hash.Hash) computing the SHA256 checksum.
|
|
|
|
pub fn new() &Digest {
|
|
|
|
mut d := &Digest{}
|
2023-01-16 14:23:46 +03:00
|
|
|
d.init()
|
2019-11-14 10:00:22 +03:00
|
|
|
return d
|
|
|
|
}
|
|
|
|
|
|
|
|
// new224 returns a new Digest (implementing hash.Hash) computing the SHA224 checksum.
|
|
|
|
pub fn new224() &Digest {
|
|
|
|
mut d := &Digest{}
|
|
|
|
d.is224 = true
|
2023-01-16 14:23:46 +03:00
|
|
|
d.init()
|
2019-11-14 10:00:22 +03:00
|
|
|
return d
|
|
|
|
}
|
|
|
|
|
2021-01-23 15:33:49 +03:00
|
|
|
// write writes the contents of `p_` to the internal hash representation.
|
2022-10-20 22:14:33 +03:00
|
|
|
pub fn (mut d Digest) write(p_ []u8) !int {
|
2020-12-20 18:08:56 +03:00
|
|
|
unsafe {
|
|
|
|
mut p := p_
|
|
|
|
nn := p.len
|
|
|
|
d.len += u64(nn)
|
|
|
|
if d.nx > 0 {
|
2022-03-09 21:26:00 +03:00
|
|
|
n := copy(mut d.x[d.nx..], p)
|
2020-12-20 18:08:56 +03:00
|
|
|
d.nx += n
|
2021-05-08 13:32:29 +03:00
|
|
|
if d.nx == sha256.chunk {
|
2020-12-20 18:08:56 +03:00
|
|
|
block(mut d, d.x)
|
|
|
|
d.nx = 0
|
|
|
|
}
|
|
|
|
if n >= p.len {
|
|
|
|
p = []
|
|
|
|
} else {
|
|
|
|
p = p[n..]
|
|
|
|
}
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
2021-05-08 13:32:29 +03:00
|
|
|
if p.len >= sha256.chunk {
|
|
|
|
n := p.len & ~(sha256.chunk - 1)
|
2020-12-20 18:08:56 +03:00
|
|
|
block(mut d, p[..n])
|
|
|
|
if n >= p.len {
|
|
|
|
p = []
|
|
|
|
} else {
|
|
|
|
p = p[n..]
|
|
|
|
}
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
2020-12-20 18:08:56 +03:00
|
|
|
if p.len > 0 {
|
2022-03-09 21:26:00 +03:00
|
|
|
d.nx = copy(mut d.x, p)
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
2020-12-20 18:08:56 +03:00
|
|
|
return nn
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-12-04 21:16:44 +03:00
|
|
|
// sum returns the SHA256 or SHA224 checksum of digest with the data.
|
2022-04-15 15:35:35 +03:00
|
|
|
pub fn (d &Digest) sum(b_in []u8) []u8 {
|
2019-11-14 10:00:22 +03:00
|
|
|
// Make a copy of d so that caller can keep writing and summing.
|
|
|
|
mut d0 := *d
|
|
|
|
hash := d0.checksum()
|
|
|
|
mut b_out := b_in.clone()
|
|
|
|
if d0.is224 {
|
2021-05-08 13:32:29 +03:00
|
|
|
for b in hash[..sha256.size224] {
|
2019-11-14 10:00:22 +03:00
|
|
|
b_out << b
|
|
|
|
}
|
|
|
|
} else {
|
|
|
|
for b in hash {
|
|
|
|
b_out << b
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return b_out
|
|
|
|
}
|
|
|
|
|
2022-04-15 08:56:01 +03:00
|
|
|
// checksum returns the current byte checksum of the Digest.
|
2022-04-15 15:35:35 +03:00
|
|
|
pub fn (mut d Digest) checksum() []u8 {
|
2019-11-14 10:00:22 +03:00
|
|
|
mut len := d.len
|
|
|
|
// Padding. Add a 1 bit and 0 bits until 56 bytes mod 64.
|
2022-04-15 15:35:35 +03:00
|
|
|
mut tmp := []u8{len: (64)}
|
2019-11-14 10:00:22 +03:00
|
|
|
tmp[0] = 0x80
|
2020-12-20 18:08:56 +03:00
|
|
|
if int(len) % 64 < 56 {
|
2021-03-01 02:18:14 +03:00
|
|
|
d.write(tmp[..56 - int(len) % 64]) or { panic(err) }
|
2019-11-14 10:00:22 +03:00
|
|
|
} else {
|
2021-03-01 02:18:14 +03:00
|
|
|
d.write(tmp[..64 + 56 - int(len) % 64]) or { panic(err) }
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
|
|
|
// Length in bits.
|
|
|
|
len <<= u64(3)
|
|
|
|
binary.big_endian_put_u64(mut tmp, len)
|
2021-03-01 02:18:14 +03:00
|
|
|
d.write(tmp[..8]) or { panic(err) }
|
2019-11-14 10:00:22 +03:00
|
|
|
if d.nx != 0 {
|
|
|
|
panic('d.nx != 0')
|
|
|
|
}
|
2022-04-15 15:35:35 +03:00
|
|
|
mut digest := []u8{len: sha256.size}
|
2019-11-14 10:00:22 +03:00
|
|
|
binary.big_endian_put_u32(mut digest, d.h[0])
|
|
|
|
binary.big_endian_put_u32(mut digest[4..], d.h[1])
|
|
|
|
binary.big_endian_put_u32(mut digest[8..], d.h[2])
|
|
|
|
binary.big_endian_put_u32(mut digest[12..], d.h[3])
|
|
|
|
binary.big_endian_put_u32(mut digest[16..], d.h[4])
|
|
|
|
binary.big_endian_put_u32(mut digest[20..], d.h[5])
|
|
|
|
binary.big_endian_put_u32(mut digest[24..], d.h[6])
|
|
|
|
if !d.is224 {
|
|
|
|
binary.big_endian_put_u32(mut digest[28..], d.h[7])
|
|
|
|
}
|
|
|
|
return digest
|
|
|
|
}
|
|
|
|
|
2021-01-23 15:33:49 +03:00
|
|
|
// sum returns the SHA256 checksum of the bytes in `data`.
|
|
|
|
// Example: assert sha256.sum('V'.bytes()).len > 0 == true
|
2022-04-15 15:35:35 +03:00
|
|
|
pub fn sum(data []u8) []u8 {
|
2019-11-14 10:00:22 +03:00
|
|
|
return sum256(data)
|
|
|
|
}
|
|
|
|
|
|
|
|
// sum256 returns the SHA256 checksum of the data.
|
2022-04-15 15:35:35 +03:00
|
|
|
pub fn sum256(data []u8) []u8 {
|
2019-11-14 10:00:22 +03:00
|
|
|
mut d := new()
|
2021-03-01 02:18:14 +03:00
|
|
|
d.write(data) or { panic(err) }
|
2019-11-14 10:00:22 +03:00
|
|
|
return d.checksum()
|
|
|
|
}
|
|
|
|
|
|
|
|
// sum224 returns the SHA224 checksum of the data.
|
2022-04-15 15:35:35 +03:00
|
|
|
pub fn sum224(data []u8) []u8 {
|
2019-11-14 10:00:22 +03:00
|
|
|
mut d := new224()
|
2021-03-01 02:18:14 +03:00
|
|
|
d.write(data) or { panic(err) }
|
2019-11-14 10:00:22 +03:00
|
|
|
sum := d.checksum()
|
2022-04-15 15:35:35 +03:00
|
|
|
mut sum224 := []u8{len: sha256.size224}
|
2022-03-09 21:26:00 +03:00
|
|
|
copy(mut sum224, sum[..sha256.size224])
|
2019-11-14 10:00:22 +03:00
|
|
|
return sum224
|
|
|
|
}
|
|
|
|
|
2022-04-15 15:35:35 +03:00
|
|
|
fn block(mut dig Digest, p []u8) {
|
2019-11-14 10:00:22 +03:00
|
|
|
// For now just use block_generic until we have specific
|
|
|
|
// architecture optimized versions
|
|
|
|
block_generic(mut dig, p)
|
|
|
|
}
|
|
|
|
|
2021-01-23 15:33:49 +03:00
|
|
|
// size returns the size of the checksum in bytes.
|
2019-11-14 10:00:22 +03:00
|
|
|
pub fn (d &Digest) size() int {
|
|
|
|
if !d.is224 {
|
2021-05-08 13:32:29 +03:00
|
|
|
return sha256.size
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
2021-05-08 13:32:29 +03:00
|
|
|
return sha256.size224
|
2019-11-14 10:00:22 +03:00
|
|
|
}
|
|
|
|
|
2021-01-23 15:33:49 +03:00
|
|
|
// block_size returns the block size of the checksum in bytes.
|
2020-12-20 18:08:56 +03:00
|
|
|
pub fn (d &Digest) block_size() int {
|
2021-05-08 13:32:29 +03:00
|
|
|
return sha256.block_size
|
2020-12-20 18:08:56 +03:00
|
|
|
}
|
2019-11-14 10:00:22 +03:00
|
|
|
|
2021-01-23 15:33:49 +03:00
|
|
|
// hexhash returns a hexadecimal SHA256 hash sum `string` of `s`.
|
|
|
|
// Example: assert sha256.hexhash('V') == 'de5a6f78116eca62d7fc5ce159d23ae6b889b365a1739ad2cf36f925a140d0cc'
|
2020-12-20 18:08:56 +03:00
|
|
|
pub fn hexhash(s string) string {
|
|
|
|
return sum256(s.bytes()).hex()
|
|
|
|
}
|
|
|
|
|
2021-01-23 15:33:49 +03:00
|
|
|
// hexhash_224 returns a hexadecimal SHA224 hash sum `string` of `s`.
|
2020-12-20 18:08:56 +03:00
|
|
|
pub fn hexhash_224(s string) string {
|
|
|
|
return sum224(s.bytes()).hex()
|
|
|
|
}
|