Summary

Add utilities for random nonces/salts and encoding.

Review Request #15173 — Created July 16, 2026 and updated July 16, 2026, 4:49 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.	d0d17151f6f670421c80ea9db5d64f2f734aa3ca

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.

d0d17151f6f670421c80ea9db5d64f2f734aa3ca

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 16, 2026, 4:49 p.m.
Missing "Version Added"	david	July 16, 2026, 4:49 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.

Fix it!

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