random

package

v0.2.0 Latest Latest Go to latest Published: Nov 7, 2026 License: MIT Imports: 6 Imported by: 0

Details

Package random provides cryptographically secure random helpers.

This section is empty.

View Source

var ErrInvalidLength = errors.New("random: length must be non-negative")

ErrInvalidLength is returned when a requested length is negative.

func Bytes(n int) ([]byte, error)

Bytes returns n cryptographically random bytes.

func MustToken(n int) string

MustToken returns n random hex characters and panics if the CSPRNG fails or n is negative. Intended for request IDs where failure is unrecoverable.

func NumCode() (string, error)

NumCode returns a cryptographically random six-digit numeric string.

func Shuffle[T any](sli []T)

Shuffle permutes sli in place using the auto-seeded math/rand/v2 generator. It is NOT cryptographically secure; do not use it for secrets.

func UUID() (string, error)

UUID returns 32 lowercase hex characters (128 random bits).

func UUIDWithLen(n int) (string, error)

UUIDWithLen returns exactly n lowercase hex characters from the CSPRNG.

This section is empty.