Jeroen van Rijn 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
..
_aes 655fab7227 Add core/hyperthread count for Windows and Linux (#5216) 4 months ago
_blake2 2f301e46dc core/crypto: Switch to using `ensure` 6 months ago
_chacha20 45219f240e Rename `SIMD_IS_EMULATED` to capability-affirmative `HAS_HARDWARE_SIMD` 4 months ago
_edwards25519 2f301e46dc core/crypto: Switch to using `ensure` 6 months ago
_fiat 2f301e46dc core/crypto: Switch to using `ensure` 6 months ago
_sha3 2f301e46dc core/crypto: Switch to using `ensure` 6 months ago
aead 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
aegis 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
aes 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
blake2b 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
blake2s 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
chacha20 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
chacha20poly1305 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
deoxysii 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
ed25519 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
hash 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
hkdf 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
hmac 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
kmac 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
legacy 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
pbkdf2 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
poly1305 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
ristretto255 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
sha2 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
sha3 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
shake 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
siphash 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
sm3 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
tuplehash 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
x25519 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
x448 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
README.md a43a5b053c core/crypto: Add more documentation about assumptions (NFC) 1 year ago
crypto.odin 7a9ea3ee6d Further overhaul of package line comments. 3 days ago
rand_bsd.odin 19f0127e55 Moved all packages in core, base, vendor, tests and examples to use new #+ file tag syntax. 1 year ago
rand_darwin.odin e296d6fb90 Fix loads of indentation issues with mixing spaces and tabs 1 year ago
rand_generic.odin e4892f1bb2 os/os2: wasi target support 8 months ago
rand_js.odin a6eb64df6c core/crypto: Add a `HAS_RAND_BYTES` constant 1 year ago
rand_linux.odin 3ff8952813 Replace `panic(fmt.tprintf(` antipattern with `fmt.panicf` 1 year ago
rand_wasi.odin e4892f1bb2 os/os2: wasi target support 8 months ago
rand_windows.odin 9f9abb8fb3 Use `union #shared_nil` for `os.Error` 1 year ago

README.md

crypto

A cryptography library for the Odin language.

Supported

This package offers various algorithms implemented in Odin, along with useful helpers such as access to the system entropy source, and a constant-time byte comparison.

Implementation considerations

  • The crypto packages are not thread-safe.
  • Best-effort is make to mitigate timing side-channels on reasonable architectures. Architectures that are known to be unreasonable include but are not limited to i386, i486, and WebAssembly.
  • Implementations assume a 64-bit architecture (64-bit integer arithmetic is fast, and includes add-with-carry, sub-with-borrow, and full-result multiply).
  • Hardware sidechannels are explicitly out of scope for this package. Notable examples include but are not limited to:
    • Power/RF side-channels etc.
    • Fault injection attacks etc.
    • Hardware vulnerabilities ("apply mitigations or buy a new CPU").
  • The packages attempt to santize sensitive data, however this is, and will remain a "best-effort" implementation decision. As Thomas Pornin puts it "In general, such memory cleansing is a fool's quest."
  • All of these packages have not received independent third party review.

License

This library is made available under the BSD-3 license.