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.

Source Files ¶

cast.go hashes.go keccakf.go sha3.go sha3_amd64.go shake.go

Directories ¶