notbefore

Consumer CLI for the public qrng-beacon-log — an hourly, commit-then-reveal, host-attested randomness log anchored to drand quicknet, RFC 3161 timestamps, Rekor and OpenTimestamps. Spec: NOTBEFORE.md (draft 0.2) in https://github.com/docdailey/qrng-beacon-log.

What it proves: the 32-byte attested value (V) of hour (N) was fixed before drand round (R) and not selected after (R) existed. What it does not prove: that the bits are quantum, secret, certified, or unique. This is not a certification of anything; see CLAIMS.md in the log repository.

pip install notbefore            # PyPI, 0.2.0; needs git and openssl on PATH; add [anchors] for OpenTimestamps proofs
notbefore verify 41              # commit 40 + reveal 41: signatures (pinned keys), drand BLS offline, RFC 3161, Rekor anchors
notbefore value 41               # V, only if verify passes
notbefore seed 41 --purpose clinic-qi-roster-2026-09-12       # S = SHA256("notbefore/derive/v1" || V || purpose)
notbefore shuffle 41 --purpose split:iris-csv:v3 rows.txt      # deterministic shuffle of the lines of rows.txt
notbefore split 41 --purpose split:iris-csv:v3 --frac 0.8 rows.txt

seed, shuffle and split write a transcript JSON (notbefore-<seq>-<purpose>.json) — the engineering artifact that lets anyone reproduce the result from the public log.

Trust model. The verifier, the signing keys, the drand group key, the Rekor log key, the freetsa CA and the expected host configuration are vendored inside this package, pinned at a named commit of the log repository (notbefore --version prints it). The CLI executes only those files; the log is read as data. Updating the verifier means updating the package — deliberately.

Eligible pairs start at 0020/0021 (0026/0027 preferred, execution enforced). verify 19 fails by design (ERR-007). Pulses 0001–0041 carry retroactive anchors (2026-09-12 12:47 UTC); from 0042 anchors are contemporaneous.

MIT. Data in the log: CC BY 4.0.

Releasing (operators): RELEASING.md — every change to the verifier or keys needs a new package, and the flow there is the only way one gets made.

Development Status
- 3 - Alpha
Environment
- Console
Intended Audience
- Developers
- Science/Research
License
- OSI Approved :: MIT License
Programming Language
- Python :: 3
Topic
- Security :: Cryptography

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

notbefore-0.3.0.tar.gz (46.3 kB view details)

Uploaded Sep 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

notbefore-0.3.0-py3-none-any.whl (55.9 kB view details)

Uploaded Sep 12, 2026 Python 3

File details

Details for the file notbefore-0.3.0.tar.gz.

File metadata

Download URL: notbefore-0.3.0.tar.gz
Upload date: Sep 12, 2026
Size: 46.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for notbefore-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`8cdf03bb46eb2c28849c33aeec277af6a258833c7ee956c6a85f42cf8cbcf1a0`
MD5	`512553bfd6caad3c4f41aea36b6fd790`
BLAKE2b-256	`875e22f26bc721338bdf19abdcb50e6010fc904873934e67d2625c84bc48d6c0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for notbefore-0.3.0.tar.gz:

Publisher: cli.yml on docdailey/qrng-beacon-log

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: notbefore-0.3.0.tar.gz
- Subject digest: 8cdf03bb46eb2c28849c33aeec277af6a258833c7ee956c6a85f42cf8cbcf1a0
- Sigstore transparency entry: 2808940208
- Sigstore integration time: Sep 12, 2026
Source repository:
- Permalink: docdailey/qrng-beacon-log@21919de8b2a43fd730ab8fb1fd50d2a54612e980
- Branch / Tag: refs/tags/cli-v0.3.0
- Owner: https://github.com/docdailey
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: cli.yml@21919de8b2a43fd730ab8fb1fd50d2a54612e980
- Trigger Event: push