nonce

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