aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: c4b82ae0df8fa57038fcd1834b6234aafa42e626 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
## ecgen

Tool for generating Elliptic curve domain parameters.

### Usage

#### ecgen
The main binary of the tool, does the hard work.

`
ecgen --fp/--f2m -r -p BITS
`

 - `--fp`/`--f2m` specifies the field type (prime/binary).
 - `-r/--random` requests a random curve to be generated.
 - `-p/--prime` requests the curve order to be prime.
 - `-s/--seed=[SEED]` requests to generate a curve based on the ANSI X9.62 generation process and seed `SEED`.
 - `-o/--output=FILE` writes output to `FILE`.
 - `-f/--input=FILE` reads input from `FILE`.
 - `-a/--append` appends to output file (doesn't overwrite it).
 - `-d/--datadir=DIR` specifies the PARI/GP datadir containing the `seadata` package.

### Build

`
git clone https://github.com/J08nY/ecgen.git
cd ecgen
make
`

### Requirements

 - PARI/GP
 - parson

ecgen uses the [PARI/GP](http://pari.math.u-bordeaux.fr/) library for elliptic
curve arithmetic and it's SEA point counting algorithm implementation. It also requires the 
additional [seadata](http://pari.math.u-bordeaux.fr/packages.html) package (seadata and seadata-big recommended for large curves).

[parson](https://github.com/kgabis/parson) is used to output curve parameters in JSON format.

### License

`
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
`

*© Eastern Seaboard Phishing Authority*