Skip to content

IsoApplet API Versions

Philip Wendland edited this page Jul 31, 2016 · 1 revision

The version of the applet itself consists of 3 numbers: Major-Minor-Micro. When the major version changes, fundamental changes have happened. Minor changes are new features and/or bugfixes without modifying the API in a way that the interaction of the driver and the applet becomes completely broken. Micro changes are bugfixes or refactorings that do not change the API at all.

The "API version" of the applet is returned when the applet is being selected. It consists of the major and minor version. For example, the applet v0.3.0 uses the API version 0.3. If only the minor version mismatches, it is not necessary to update the OpenSC driver or applet version. Changes in major versions indicate drastic changes - the applet or driver version needs to be updated. The driver may also behave differently, i.e. execute different code for different API versions instead of not matching for the applet.

It is my goal to keep everything interoperable that is newer than 00.05.

Changelog

Version (Major.Minor) Date Relevant changes
00.06 2015/03/25 Support for secp192k1 and secp256k1 curves, requesting secure random numbers from the smartcard
00.05 2014/11/20 Simplified RSA private key import
00.04 2014/10/28 ECC key-gen: host sends curve parameters
00.03 2014/10/17 Private key import
00.02 2014/09/29 ECC key-gen: better debugging if failed
00.01 2014/09/26 Added API version feature
00.00 2014/08/28 Initial version