Summary

Add utilities for random nonces/salts and encoding.

Review Request #15173 — Created July 16, 2026 and submitted July 29, 2026, 7:48 p.m.

Information

Owner

chipx86

Repository

cryptozoology

Branch

master

Bugs

Depends On

Reviewers

Groups

beanbag-misc

People

Description

This introduces new cryptozoology.utils.encoding and
cryptozoology.utils.random modules.

encoding provides utilities for encoding to/decoding from URL-safe
Base64 with padding removed and type checking agdded. It also provides
encoding for length-prefixed strings, which is useful in AAD and HKDF
information.

random provides types and generation for nonces and salts of arbitrary
or common sizes.

Testing Done

Unit tests pass.

Made use of these in other changes.

Commits

Summary	ID
Add utilities for random nonces/salts and encoding. This introduces new `cryptozoology.utils.encoding` and `cryptozoology.utils.random` modules. `encoding` provides utilities for encoding to/decoding from URL-safe Base64 with padding removed and type checking agdded. It also provides encoding for length-prefixed strings, which is useful in AAD and HKDF information. `random` provides types and generation for nonces and salts of arbitrary or common sizes.	b54c644d47afd3d89c5283bac0245b52ba435fd6

Summary

Add utilities for random nonces/salts and encoding.

This introduces new `cryptozoology.utils.encoding` and `cryptozoology.utils.random` modules. `encoding` provides utilities for encoding to/decoding from URL-safe Base64 with padding removed and type checking agdded. It also provides encoding for length-prefixed strings, which is useful in AAD and HKDF information. `random` provides types and generation for nonces and salts of arbitrary or common sizes.

b54c644d47afd3d89c5283bac0245b52ba435fd6

Issues

Description	From	Last Updated
'struct' imported but unused Column: 1 Error code: F401	reviewbot	July 16, 2026, 4:18 p.m.
Missing "Version Added". Same for the other methods here.	david	July 21, 2026, 10:33 p.m.
Missing "Version Added"	david	July 21, 2026, 10:33 p.m.

flake8 failed.

JSHint passed.

flake8

cryptozoology/utils/tests/test_encoding.py (Diff revision 1)
The issue has been resolved. Show all issues
```
'struct' imported but unused

Column: 1
Error code: F401
```

Change Summary:


Removed an unused import.
Added the missing utils/__init__.py module.

Commits:

	Summary	ID
	Add utilities for random nonces/salts and encoding. This introduces new `cryptozoology.utils.encoding` and `cryptozoology.utils.random` modules. `encoding` provides utilities for encoding to/decoding from URL-safe Base64 with padding removed and type checking agdded. It also provides encoding for length-prefixed strings, which is useful in AAD and HKDF information. `random` provides types and generation for nonces and salts of arbitrary or common sizes.	60eb6b41097d6044ad48b00193a688b58cb6dcd3
	Add utilities for random nonces/salts and encoding. This introduces new `cryptozoology.utils.encoding` and `cryptozoology.utils.random` modules. `encoding` provides utilities for encoding to/decoding from URL-safe Base64 with padding removed and type checking agdded. It also provides encoding for length-prefixed strings, which is useful in AAD and HKDF information. `random` provides types and generation for nonces and salts of arbitrary or common sizes.	d0d17151f6f670421c80ea9db5d64f2f734aa3ca

Diff:

Revision 2 (+766)

Show changes

	cryptozoology/utils/__init__.py
	cryptozoology/utils/encoding.py
	cryptozoology/utils/random.py
	cryptozoology/utils/tests/__init__.py
	cryptozoology/utils/tests/test_encoding.py
	cryptozoology/utils/tests/test_random.py

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

cryptozoology/utils/random.py (Diff revision 2)
The issue has been resolved. Show all issues
```
Missing "Version Added". Same for the other methods here.
```
cryptozoology/utils/tests/test_encoding.py (Diff revision 2)
The issue has been resolved. Show all issues
```
Missing "Version Added"
```

Change Summary:

Added missing "Version Added" to docstrings.

Commits:

	Summary	ID
	Add utilities for random nonces/salts and encoding. This introduces new `cryptozoology.utils.encoding` and `cryptozoology.utils.random` modules. `encoding` provides utilities for encoding to/decoding from URL-safe Base64 with padding removed and type checking agdded. It also provides encoding for length-prefixed strings, which is useful in AAD and HKDF information. `random` provides types and generation for nonces and salts of arbitrary or common sizes.	d0d17151f6f670421c80ea9db5d64f2f734aa3ca
	Add utilities for random nonces/salts and encoding. This introduces new `cryptozoology.utils.encoding` and `cryptozoology.utils.random` modules. `encoding` provides utilities for encoding to/decoding from URL-safe Base64 with padding removed and type checking agdded. It also provides encoding for length-prefixed strings, which is useful in AAD and HKDF information. `random` provides types and generation for nonces and salts of arbitrary or common sizes.	b54c644d47afd3d89c5283bac0245b52ba435fd6

Diff:

Revision 3 (+798)

Show changes

	cryptozoology/utils/__init__.py
	cryptozoology/utils/encoding.py
	cryptozoology/utils/random.py
	cryptozoology/utils/tests/__init__.py
	cryptozoology/utils/tests/test_encoding.py
	cryptozoology/utils/tests/test_random.py

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

Ship it!

```
Ship It!
```

Status:: Completed
Change Summary:: Pushed to master (fb70106)