opentitanlib/crypto/
sha256.rs

1// Copyright lowRISC contributors (OpenTitan project).
2// Licensed under the Apache License, Version 2.0, see LICENSE for details.
3// SPDX-License-Identifier: Apache-2.0
4
5use sha2::Digest;
6
7use crate::util::bigint::fixed_size_bigint;
8
9fixed_size_bigint!(Sha256Digest, at_most 256);
10
11pub fn sha256(data: impl AsRef<[u8]>) -> Sha256Digest {
12    let mut hasher = sha2::Sha256::new();
13    hasher.update(data);
14    Sha256Digest::from_be_bytes(hasher.finalize()).unwrap()
15}
16
17#[cfg(test)]
18mod tests {
19    use super::*;
20
21    #[test]
22    fn test_sha256() {
23        fn check(msg: &str, digest: &str) {
24            assert_eq!(sha256(msg.as_bytes()).to_string(), digest);
25        }
26        // The digests below can be obtained using `echo -n [msg] | shasum -a 256`.
27        // The digest for "abc" is also available at
28        // https://csrc.nist.gov/CSRC/media/Projects/Cryptographic-Standards-and-Guidelines/documents/examples/SHA256.pdf
29        check(
30            "",
31            "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
32        );
33        check(
34            "abc",
35            "0xba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad",
36        );
37        check(
38            "1111",
39            "0x0ffe1abd1a08215353c233d6e009613e95eec4253832a761af28ff37ac5a150c",
40        );
41    }
42}