Umbral primary sources

Reviewed: 2026-05-14 UTC

Reference implementation and mechanism walkthrough

https://pyumbral.readthedocs.io/
- Best concise primary source in this pass.
- Used to confirm that pyUmbral is the reference implementation of Umbral and that the scheme is explicitly framed as threshold proxy re-encryption.
- Especially useful for the Alice / Bob / Ursula flow, kfrags / cfrags, and the separation between delegation, re-encryption, and final decryption.
https://github.com/nucypher/pyUmbral
- Best repository-level statement of what Umbral does in practice.
- Used to confirm the implementation’s role as the cryptographic engine behind NuCypher and to capture the concrete M-of-N delegation example in the README.
- Helpful for grounding the scheme in a maintained reference implementation rather than only in paper language.

https://github.com/nucypher/umbral-doc
- Best source for canonical-document lineage in this pass.
- Used to confirm that the dedicated repository hosts the Umbral specification/whitepaper (umbral-doc.pdf) and source TeX, and to note that the repository was archived in May 2025.
- That archived status is itself analytically useful because it suggests Umbral now functions mainly as a stable lower-layer cryptographic reference beneath later network products.

Umbral is best categorized as a threshold proxy re-encryption primitive, not merely a generic crypto library or a feature inside NuCypher/TACo.
The key reusable split is between delegator-authored re-encryption fragments, semi-trusted proxy execution, and recipient-side final activation/decryption.
Umbral is especially valuable in the corpus as the lower-layer baseline beneath later threshold-policy systems, because it preserves delegated decryption as a standalone control surface before cohort governance, external-state conditions, or threshold signing are layered on top.