package sha3
import "crypto/internal/fips140/sha3"
Package sha3 implements the SHA-3 fixed-output-length hash functions and the SHAKE variable-output-length functions defined by FIPS 202, as well as the cSHAKE extendable-output-length functions defined by SP 800-185.
Index
-
type Digest
- func New224() *Digest
- func New256() *Digest
- func New384() *Digest
- func New512() *Digest
- func NewLegacyKeccak256() *Digest
- func NewLegacyKeccak512() *Digest
- func (d *Digest) AppendBinary(b []byte) ([]byte, error)
- func (d *Digest) BlockSize() int
- func (d *Digest) Clone() *Digest
- func (d *Digest) MarshalBinary() ([]byte, error)
- func (d *Digest) Reset()
- func (d *Digest) Size() int
- func (d *Digest) Sum(b []byte) []byte
- func (d *Digest) UnmarshalBinary(b []byte) error
- func (d *Digest) Write(p []byte) (n int, err error)
-
type SHAKE
- func NewCShake128(N, S []byte) *SHAKE
- func NewCShake256(N, S []byte) *SHAKE
- func NewShake128() *SHAKE
- func NewShake256() *SHAKE
- func (s *SHAKE) AppendBinary(b []byte) ([]byte, error)
- func (s *SHAKE) BlockSize() int
- func (s *SHAKE) Clone() *SHAKE
- func (s *SHAKE) MarshalBinary() ([]byte, error)
- func (s *SHAKE) Read(out []byte) (n int, err error)
- func (s *SHAKE) Reset()
- func (s *SHAKE) Size() int
- func (s *SHAKE) Sum(in []byte) []byte
- func (s *SHAKE) UnmarshalBinary(b []byte) error
- func (s *SHAKE) Write(p []byte) (n int, err error)
Types
type Digest
type Digest struct { // contains filtered or unexported fields }
func New224
func New224() *Digest
New224 returns a new Digest computing the SHA3-224 hash.
func New256
func New256() *Digest
New256 returns a new Digest computing the SHA3-256 hash.
func New384
func New384() *Digest
New384 returns a new Digest computing the SHA3-384 hash.
func New512
func New512() *Digest
New512 returns a new Digest computing the SHA3-512 hash.
func NewLegacyKeccak256
func NewLegacyKeccak256() *Digest
NewLegacyKeccak256 returns a new Digest computing the legacy, non-standard Keccak-256 hash.
func NewLegacyKeccak512
func NewLegacyKeccak512() *Digest
NewLegacyKeccak512 returns a new Digest computing the legacy, non-standard Keccak-512 hash.
func (*Digest) AppendBinary
func (d *Digest) AppendBinary(b []byte) ([]byte, error)
func (*Digest) BlockSize
func (d *Digest) BlockSize() int
BlockSize returns the rate of sponge underlying this hash function.
func (*Digest) Clone
func (d *Digest) Clone() *Digest
func (*Digest) MarshalBinary
func (d *Digest) MarshalBinary() ([]byte, error)
func (*Digest) Reset
func (d *Digest) Reset()
Reset resets the Digest to its initial state.
func (*Digest) Size
func (d *Digest) Size() int
Size returns the output size of the hash function in bytes.
func (*Digest) Sum
func (d *Digest) Sum(b []byte) []byte
Sum appends the current hash to b and returns the resulting slice. It does not change the underlying hash state.
func (*Digest) UnmarshalBinary
func (d *Digest) UnmarshalBinary(b []byte) error
func (*Digest) Write
func (d *Digest) Write(p []byte) (n int, err error)
Write absorbs more data into the hash's state.
type SHAKE
type SHAKE struct { // contains filtered or unexported fields }
func NewCShake128
func NewCShake128(N, S []byte) *SHAKE
NewCShake128 creates a new cSHAKE128 XOF.
N is used to define functions based on cSHAKE, it can be empty when plain cSHAKE is desired. S is a customization byte string used for domain separation. When N and S are both empty, this is equivalent to NewShake128.
func NewCShake256
func NewCShake256(N, S []byte) *SHAKE
NewCShake256 creates a new cSHAKE256 XOF.
N is used to define functions based on cSHAKE, it can be empty when plain cSHAKE is desired. S is a customization byte string used for domain separation. When N and S are both empty, this is equivalent to NewShake256.
func NewShake128
func NewShake128() *SHAKE
NewShake128 creates a new SHAKE128 XOF.
func NewShake256
func NewShake256() *SHAKE
NewShake256 creates a new SHAKE256 XOF.
func (*SHAKE) AppendBinary
func (s *SHAKE) AppendBinary(b []byte) ([]byte, error)
func (*SHAKE) BlockSize
func (s *SHAKE) BlockSize() int
func (*SHAKE) Clone
func (s *SHAKE) Clone() *SHAKE
Clone returns a copy of the SHAKE context in its current state.
func (*SHAKE) MarshalBinary
func (s *SHAKE) MarshalBinary() ([]byte, error)
func (*SHAKE) Read
func (s *SHAKE) Read(out []byte) (n int, err error)
func (*SHAKE) Reset
func (s *SHAKE) Reset()
Reset resets the hash to initial state.
func (*SHAKE) Size
func (s *SHAKE) Size() int
func (*SHAKE) Sum
func (s *SHAKE) Sum(in []byte) []byte
Sum appends a portion of output to b and returns the resulting slice. The output length is selected to provide full-strength generic security: 32 bytes for SHAKE128 and 64 bytes for SHAKE256. It does not change the underlying state. It panics if any output has already been read.
func (*SHAKE) UnmarshalBinary
func (s *SHAKE) UnmarshalBinary(b []byte) error
func (*SHAKE) Write
func (s *SHAKE) Write(p []byte) (n int, err error)
Write absorbs more data into the hash's state. It panics if any output has already been read.