summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md12
-rw-r--r--docs/LIBS.md5
2 files changed, 12 insertions, 5 deletions
diff --git a/README.md b/README.md
index 0ec59b7..9dbffc3 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
# ECTester
-Tests support and behavior of smartcards with JavaCard platform with focus on Eliptic curves (`TYPE_EC_FP` and `TYPE_EC_F2M`).
+Tests support and behavior of elliptic curve cryptography implementations on JavaCards (`TYPE_EC_FP` and `TYPE_EC_F2M`) and on selected software libraries.
## Build
-ECTester uses ant.
+ECTester uses ant. There are three parts of ECTester, the JavaCard applet used for testing, the reader app which controls it and the standalone app which tests software libraries.
```bash
ant -f build-reader.xml package # To build the reader tool (jar).
ant -f build-standalone.xml package # To build the standalone tool (jar).
@@ -13,8 +13,10 @@ ant -f build-applet.xml build # To build the applet (cap).
## Usage
+### JavaCard testing
+
1. Upload `!uploader/ectester.cap` using your favorite tool (e.g., [GlobalPlatformPro tool](https://github.com/martinpaljak/GlobalPlatform))
-2. Run `java -jar dist/ECTester.jar -t -a`
+2. Run `java -jar dist/ECTesterReader.jar -t -a`
3. Inspect output log with annotated results
Following operations are tested:
@@ -25,9 +27,9 @@ Following operations are tested:
- Signature via ECDSA
- Behavior of card when invalid curves/points are provided (should fail)
-See `java -jar ECTester.jar -h` for more.
+See `java -jar ECTesterReader.jar -h` for more.
-### Options
+#### Options
```
-ln,--list-named <what> Print the list of supported named
diff --git a/docs/LIBS.md b/docs/LIBS.md
index 10001d6..3635fef 100644
--- a/docs/LIBS.md
+++ b/docs/LIBS.md
@@ -5,6 +5,11 @@ Libraries with at least some ECC support:
- [BouncyCastle](https://bouncycastle.org/java.html)
- Java
- [Botan](https://botan.randombit.net/)
+ - C++
+ - Uses blinded(randomized) Montgomery ladder.
+ - https://hyperelliptic.org/EFD/g1p/auto-shortw-jacobian-3.html#addition-add-1998-cmo-2
+ - https://hyperelliptic.org/EFD/g1p/auto-shortw-jacobian-3.html#doubling-dbl-1986-cc
+ - https://eprint.iacr.org/2015/657
- [Crypto++](https://cryptopp.com/)
- [libgcrypt](https://www.gnupg.org/related_software/libgcrypt/)
- [libtomcrypt](http://www.libtom.net/LibTomCrypt/)