1 // Copyright 2014 The Go Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style
3 // license that can be found in the LICENSE file.
7 // This file provides functions for creating instances of the SHA-3
8 // and SHAKE hash functions, as well as utility functions for hashing
15 // New224 creates a new SHA3-224 hash.
16 // Its generic security strength is 224 bits against preimage attacks,
17 // and 112 bits against collision attacks.
18 func New224() hash.Hash {
19 if h := new224Asm(); h != nil {
22 return &state{rate: 144, outputLen: 28, dsbyte: 0x06}
25 // New256 creates a new SHA3-256 hash.
26 // Its generic security strength is 256 bits against preimage attacks,
27 // and 128 bits against collision attacks.
28 func New256() hash.Hash {
29 if h := new256Asm(); h != nil {
32 return &state{rate: 136, outputLen: 32, dsbyte: 0x06}
35 // New384 creates a new SHA3-384 hash.
36 // Its generic security strength is 384 bits against preimage attacks,
37 // and 192 bits against collision attacks.
38 func New384() hash.Hash {
39 if h := new384Asm(); h != nil {
42 return &state{rate: 104, outputLen: 48, dsbyte: 0x06}
45 // New512 creates a new SHA3-512 hash.
46 // Its generic security strength is 512 bits against preimage attacks,
47 // and 256 bits against collision attacks.
48 func New512() hash.Hash {
49 if h := new512Asm(); h != nil {
52 return &state{rate: 72, outputLen: 64, dsbyte: 0x06}
55 // NewLegacyKeccak256 creates a new Keccak-256 hash.
57 // Only use this function if you require compatibility with an existing cryptosystem
58 // that uses non-standard padding. All other users should use New256 instead.
59 func NewLegacyKeccak256() hash.Hash { return &state{rate: 136, outputLen: 32, dsbyte: 0x01} }
61 // NewLegacyKeccak512 creates a new Keccak-512 hash.
63 // Only use this function if you require compatibility with an existing cryptosystem
64 // that uses non-standard padding. All other users should use New512 instead.
65 func NewLegacyKeccak512() hash.Hash { return &state{rate: 72, outputLen: 64, dsbyte: 0x01} }
67 // Sum224 returns the SHA3-224 digest of the data.
68 func Sum224(data []byte) (digest [28]byte) {
75 // Sum256 returns the SHA3-256 digest of the data.
76 func Sum256(data []byte) (digest [32]byte) {
83 // Sum384 returns the SHA3-384 digest of the data.
84 func Sum384(data []byte) (digest [48]byte) {
91 // Sum512 returns the SHA3-512 digest of the data.
92 func Sum512(data []byte) (digest [64]byte) {