package

sha3

crypto/internal/fips140/v1.26.0-cd900eea/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.

type Digest source

type Digest struct {
	// contains filtered or unexported fields
}

Constructors

New224source

func New224() *Digest

New224 returns a new Digest computing the SHA3-224 hash.

New256source

func New256() *Digest

New256 returns a new Digest computing the SHA3-256 hash.

New384source

func New384() *Digest

New384 returns a new Digest computing the SHA3-384 hash.

New512source

func New512() *Digest

New512 returns a new Digest computing the SHA3-512 hash.

NewLegacyKeccak256source

func NewLegacyKeccak256() *Digest

NewLegacyKeccak256 returns a new Digest computing the legacy, non-standard Keccak-256 hash.

NewLegacyKeccak512source

func NewLegacyKeccak512() *Digest

NewLegacyKeccak512 returns a new Digest computing the legacy, non-standard Keccak-512 hash.

Methods

BlockSizesource

func (d *Digest) BlockSize() int

BlockSize returns the rate of sponge underlying this hash function.

Resetsource

func (d *Digest) Reset()

Reset resets the Digest to its initial state.

Sizesource

func (d *Digest) Size() int

Size returns the output size of the hash function in bytes.

Sumsource

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.

Writesource

func (d *Digest) Write(p []byte) (n int, err error)

Write absorbs more data into the hash's state.

type SHAKE source

type SHAKE struct {
	// contains filtered or unexported fields
}

Constructors

NewCShake128source

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.

NewCShake256source

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.

Methods

Clonesource

func (s *SHAKE) Clone() *SHAKE

Clone returns a copy of the SHAKE context in its current state.

Readsource

func (s *SHAKE) Read(out []byte) (n int, err error)

Resetsource

func (s *SHAKE) Reset()

Reset resets the hash to initial state.

Sumsource

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.

Writesource

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.