james-alex/nonce

nonce

pub package

[Nonce] contains a static generator that generates random alphanumeric strings, and can be constructed as an object containing a generated string.

Usage

import 'package:nonce/nonce.dart';

Generator

The static method [generate] can be used to generate random alphanumeric strings.

[generate] has 2 optional parameters, [length] which defines how many characters to generate, and [random] which allows you provide a [Random] to use to generate the characters.

// Generate a string 32 characters long.
print(Nonce.generate()); // Osp54up7WU6P3U97Jz92p9j892n9LP7z

// Generate a string 64 characters long.
print(Nonce.generate(64)); // LDwpr1H74qm894jbd15Lj63wF5RUL07r4L9XOY7zVMz7fLbBCXa68Y6oPw0N9XgV

// Generate a nonce using a secure [Random].
print(Nonce.generate(32, Random.secure()));

generate() does not rely on Base64 encoding, instead it generates ASCII character codes directly.

Constructors

[Nonce]'s default constructor constructs a [Nonce] of the specified length; 32 characters by default.

Nonce();
Nonce(64);

unique

[Nonce]'s [unique] constructor references a global set of every nonce generated by it, and ensures that every nonce returned by it is unique.

Nonce.unique();
Nonce.unique(64);

secure

[Nonce]'s [secure] constructor generates a unique nonce using a secure [Random].

Nonce.secure();
Nonce.secure(64);

key

The [key] constructor is shorthand to generate a [unique] nonce 16 characters in length.

Nonce.key(); // Osp54up7WU6P3U97