Mauri de Souza Meneguzzo
67b13616a5
Fixes golang/go#64897 Change-Id: I0c8c52d73a7d2df0f44fee36d407a87213f59bff Reviewed-on: https://go-review.googlesource.com/c/crypto/+/554435 TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: Cherry Mui <cherryyz@google.com> Reviewed-by: Filippo Valsorda <filippo@golang.org> Reviewed-by: Roland Shoemaker <roland@golang.org> Auto-Submit: Filippo Valsorda <filippo@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
102 lines
2.7 KiB
Go
102 lines
2.7 KiB
Go
// Copyright 2014 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package sha3
|
|
|
|
// This file provides functions for creating instances of the SHA-3
|
|
// and SHAKE hash functions, as well as utility functions for hashing
|
|
// bytes.
|
|
|
|
import (
|
|
"hash"
|
|
)
|
|
|
|
// New224 creates a new SHA3-224 hash.
|
|
// Its generic security strength is 224 bits against preimage attacks,
|
|
// and 112 bits against collision attacks.
|
|
func New224() hash.Hash {
|
|
return new224()
|
|
}
|
|
|
|
// New256 creates a new SHA3-256 hash.
|
|
// Its generic security strength is 256 bits against preimage attacks,
|
|
// and 128 bits against collision attacks.
|
|
func New256() hash.Hash {
|
|
return new256()
|
|
}
|
|
|
|
// New384 creates a new SHA3-384 hash.
|
|
// Its generic security strength is 384 bits against preimage attacks,
|
|
// and 192 bits against collision attacks.
|
|
func New384() hash.Hash {
|
|
return new384()
|
|
}
|
|
|
|
// New512 creates a new SHA3-512 hash.
|
|
// Its generic security strength is 512 bits against preimage attacks,
|
|
// and 256 bits against collision attacks.
|
|
func New512() hash.Hash {
|
|
return new512()
|
|
}
|
|
|
|
func new224Generic() *state {
|
|
return &state{rate: 144, outputLen: 28, dsbyte: 0x06}
|
|
}
|
|
|
|
func new256Generic() *state {
|
|
return &state{rate: 136, outputLen: 32, dsbyte: 0x06}
|
|
}
|
|
|
|
func new384Generic() *state {
|
|
return &state{rate: 104, outputLen: 48, dsbyte: 0x06}
|
|
}
|
|
|
|
func new512Generic() *state {
|
|
return &state{rate: 72, outputLen: 64, dsbyte: 0x06}
|
|
}
|
|
|
|
// NewLegacyKeccak256 creates a new Keccak-256 hash.
|
|
//
|
|
// Only use this function if you require compatibility with an existing cryptosystem
|
|
// that uses non-standard padding. All other users should use New256 instead.
|
|
func NewLegacyKeccak256() hash.Hash { return &state{rate: 136, outputLen: 32, dsbyte: 0x01} }
|
|
|
|
// NewLegacyKeccak512 creates a new Keccak-512 hash.
|
|
//
|
|
// Only use this function if you require compatibility with an existing cryptosystem
|
|
// that uses non-standard padding. All other users should use New512 instead.
|
|
func NewLegacyKeccak512() hash.Hash { return &state{rate: 72, outputLen: 64, dsbyte: 0x01} }
|
|
|
|
// Sum224 returns the SHA3-224 digest of the data.
|
|
func Sum224(data []byte) (digest [28]byte) {
|
|
h := New224()
|
|
h.Write(data)
|
|
h.Sum(digest[:0])
|
|
return
|
|
}
|
|
|
|
// Sum256 returns the SHA3-256 digest of the data.
|
|
func Sum256(data []byte) (digest [32]byte) {
|
|
h := New256()
|
|
h.Write(data)
|
|
h.Sum(digest[:0])
|
|
return
|
|
}
|
|
|
|
// Sum384 returns the SHA3-384 digest of the data.
|
|
func Sum384(data []byte) (digest [48]byte) {
|
|
h := New384()
|
|
h.Write(data)
|
|
h.Sum(digest[:0])
|
|
return
|
|
}
|
|
|
|
// Sum512 returns the SHA3-512 digest of the data.
|
|
func Sum512(data []byte) (digest [64]byte) {
|
|
h := New512()
|
|
h.Write(data)
|
|
h.Sum(digest[:0])
|
|
return
|
|
}
|