package chacha20poly1305

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

Dependency Relation
	imports 7 packages, and imported by 2 packages

Involved Source Files

	  d chacha20poly1305.go
		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 Functions (total 2)

	 func New(key []byte) (cipher.AEAD, error)
		New returns a ChaCha20-Poly1305 AEAD that uses the given 256-bit key.

	 func NewX(key []byte) (cipher.AEAD, error)
		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 Constants (total 4)

	const KeySize = 32
		KeySize is the size of the key used by this AEAD, in bytes.

	const NonceSize = 12
		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.

	const NonceSizeX = 24
		NonceSizeX is the size of the nonce used with the XChaCha20-Poly1305
		variant of this AEAD, in bytes.

	const Overhead = 16
		Overhead is the size of the Poly1305 authentication tag, and the
		difference between a ciphertext length and its plaintext.

The pages are generated with Golds v0.7.0-preview. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @zigo_101 (reachable from the left QR code) to get the latest news of Golds.