25 lines
1.1 KiB
Markdown
25 lines
1.1 KiB
Markdown
|
# sources.truenas.cloud/code/nistec
|
||
|
|
|
||
|
|
```
|
||
|
|
import "sources.truenas.cloud/code/nistec"
|
||
|
|
```
|
||
|
|
|
||
|
|
This package implements the NIST P elliptic curves, according to FIPS 186-4
|
||
|
|
and SEC 1, Version 2.0, exposing the necessary APIs to build a wide array of
|
||
|
|
higher-level primitives.
|
||
|
|
|
||
|
|
It's an exported version of `crypto/internal/fips140/nistec` in the standard library,
|
||
|
|
which powers `crypto/elliptic`, `crypto/ecdsa`, and `crypto/ecdh`.
|
||
|
|
The git history has been preserved, and new upstream changes are applied periodically.
|
||
|
|
|
||
|
|
This package uses fiat-crypto or specialized assembly and Go code for its
|
||
|
|
backend field arithmetic (not math/big) and exposes constant-time, heap
|
||
|
|
allocation-free, byte slice-based safe APIs. Group operations use modern and
|
||
|
|
safe complete addition formulas where possible. The point at infinity is
|
||
|
|
handled and encoded according to SEC 1, Version 2.0, and invalid curve points
|
||
|
|
can't be represented. This makes it particularly suitable to be used as a
|
||
|
|
prime order group implementation.
|
||
|
|
|
||
|
|
Use the `purego` build tag to exclude the assembly and rely entirely on formally
|
||
|
|
verified fiat-crypto arithmetic and complete addition formulas.
|