package chacha20poly1305

Import Path
	vendor/golang.org/x/crypto/chacha20poly1305 (on go.dev)

Dependency Relation
	imports 7 packages, and imported by one package

Involved Source Files Package chacha20poly1305 implements the ChaCha20-Poly1305 AEAD and its extended nonce variant XChaCha20-Poly1305, as specified in RFC 8439 and draft-irtf-cfrg-xchacha-01. chacha20poly1305_amd64.go chacha20poly1305_generic.go xchacha20poly1305.go chacha20poly1305_amd64.s
Package-Level Type Names (total 2, neither is exported)
/* sort exporteds by: | */
Package-Level Functions (total 8, in which 2 are exported)
New returns a ChaCha20-Poly1305 AEAD that uses the given 256-bit key.
NewX returns a XChaCha20-Poly1305 AEAD that uses the given 256-bit key. XChaCha20-Poly1305 is a ChaCha20-Poly1305 variant that takes a longer nonce, suitable to be generated randomly without risk of collisions. It should be preferred when nonce uniqueness cannot be trivially ensured, or whenever nonces are randomly generated.
Package-Level Variables (total 2, neither is exported)
Package-Level Constants (total 4, all are exported)
KeySize is the size of the key used by this AEAD, in bytes.
NonceSize is the size of the nonce used with the standard variant of this AEAD, in bytes. Note that this is too short to be safely generated at random if the same key is reused more than 2³² times.
NonceSizeX is the size of the nonce used with the XChaCha20-Poly1305 variant of this AEAD, in bytes.
Overhead is the size of the Poly1305 authentication tag, and the difference between a ciphertext length and its plaintext.