licel · slomo · Oct 25, 2013 · Oct 25, 2013 · Oct 28, 2013 · Oct 28, 2013
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,15 @@
+/target/
+# IDEA
+.idea/
+/*.iml
+# Netbeans
+nbproject/private/
+build/
+nbbuild/
+dist/
+nbdist/
+nbactions.xml
+nb-configuration.xml
+# Eclipse
+.metadata
+.settings/
diff --git a/README.md b/README.md
@@ -0,0 +1,94 @@
+jCardSim (Official repo of the [jCardSim](http://jcardsim.org) project)
+========
+
+### Congratulations! jCardSim has won [Duke's Choice 2013 Award](https://www.java.net//dukeschoice)!
+
+![alt text](https://licel.ru/wp-content/uploads/DCA2013_Badge_Winner.jpg "jCardSim is a winner of Duke's Choice 2013")
+
+**Please note** that we moved our code repository from Google Code to GitHub.
+
+jCardSim is an open source simulator for Java Card, v.2.2.1/2:
+
+* `javacard.framework.*`
+* `javacard.framework.security.*`
+* `javacardx.crypto.*`
+
+Key Features:
+
+* Rapid application prototyping
+* Simplifies unit testing (5 lines of code)
+
+```java
+// 1. create simulator
+CardSimulator simulator = new CardSimulator();
+
+// 2. install applet
+AID appletAID = AIDUtil.create("F000000001");
+simulator.installApplet(appletAID, HelloWorldApplet.class);
+
+// 3. select applet
+simulator.selectApplet(appletAID);
+
+// 4. send APDU
+CommandAPDU commandAPDU = new CommandAPDU(0x00, 0x01, 0x00, 0x00);
+ResponseAPDU response = simulator.transmitCommand(commandAPDU);
+
+// 5. check response
+assertEquals(0x9000, response.getSW());
+```
+
+* Emulation of Java Card Terminal, ability to use `javax.smartcardio`
+* APDU scripting (scripts are compatible with `apdutool` from Java Card Development Kit)
+* Simplifies verification tests creation (Common Criteria)
+
+*JavaDoc*: https://jcardsim.googlecode.com/svn/trunk/javadoc/index.html
+
+*Latest stable release 2.2.1*: https://github.com/licel/jcardsim/raw/master/jcardsim-2.2.1-all.jar
+
+*Latest stable release 2.2.2*: https://github.com/licel/jcardsim/raw/master/jcardsim-2.2.2-all.jar
+
+*Maven Central Repository*
+```xml
+<dependency>
+  <groupId>com.licel</groupId>
+  <artifactId>jcardsim</artifactId>
+  <version>2.2.1</version>
+</dependency>
+```
+```xml
+<dependency>
+  <groupId>com.licel</groupId>
+  <artifactId>jcardsim</artifactId>
+  <version>2.2.2</version>
+</dependency>
+```
+
+### What is the difference from Oracle Java Card Development Kit simulator?
+
+* **Implementation of javacard.security.***
+
+One of the main differences is the implementation of `javacard.security.*`: the current version is analogous to an NXP JCOP 31/36k card. For example, in jCardSim we have support for on-card `KeyPair.ALG_EC_F2M/ALG_RSA_CRT` key generation. Oracle's simulator only supports `KeyPair.ALG_RSA` and `KeyPair.ALG_EC_FP`, which are not supported by real cards.
+
+* **Execution of Java Card applications without converting into CAP**
+
+jCardSim can work with class files without any conversions. This allows us to simplify and accelerate the development and writing of unit tests.
+
+* **Simulator API**
+
+jCardSim has a simple and usable API, which also allows you to work with the simulator using `javax.smartcardio.*`.
+
+* **Cross-platform**
+
+jCardSim is completely written in Java and can therefore be used on all platforms which support Java (Windows, Linux, MacOS, etc).
+
+### How to help jCardSim?
+
+* Join the team of jCardSim developers.
+* Try out [DexProtector](http://dexprotector.com). The product is designed for strong and robust protection of Android applications against reverse engineering and modification.
+* Licel has one more product you may be interested in - [Stringer Java Obfuscator](https://jfxstore.com/stringer). This tool provides all the features you need to comprehensively protect your Java applications.
+
+**License**: [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0)
+
+**Third-party libraries**: [Legion of the Bouncy Castle Java](http://www.bouncycastle.org/java.html)
+
+**Trademarks**: Oracle, Java and Java Card are trademarks of Oracle Corporation.
diff --git a/javadoc/allclasses-frame.html b/javadoc/allclasses-frame.html
@@ -2,13 +2,13 @@
 <!--NewPage-->
 <HTML>
 <HEAD>
-<!-- Generated by javadoc (build 1.6.0_51) on Wed Jul 17 16:16:50 MSK 2013 -->
+<!-- Generated by javadoc (build 1.6.0_65) on Thu Dec 12 16:38:41 MSK 2013 -->
 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <TITLE>
 All Classes (Java Card Runime Environment Simulator 2.2.1-SNAPSHOT API)
 </TITLE>
 
-<META NAME="date" CONTENT="2013-07-17">
+<META NAME="date" CONTENT="2013-12-12">
 
 <LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
 
@@ -22,11 +22,7 @@
 
 <TABLE BORDER="0" WIDTH="100%" SUMMARY="">
 <TR>
-<TD NOWRAP><FONT CLASS="FrameItemFont"><A HREF="com/licel/jcardsim/samples/odSample/packageA/A.html" title="class in com.licel.jcardsim.samples.odSample.packageA" target="classFrame">A</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/ChannelsDemo/AccountAccessor.html" title="class in com.licel.jcardsim.samples.ChannelsDemo" target="classFrame">AccountAccessor</A>
-<BR>
-<A HREF="javacard/security/AESKey.html" title="interface in javacard.security" target="classFrame"><I>AESKey</I></A>
+<TD NOWRAP><FONT CLASS="FrameItemFont"><A HREF="javacard/security/AESKey.html" title="interface in javacard.security" target="classFrame"><I>AESKey</I></A>
 <BR>
 <A HREF="javacard/framework/AID.html" title="class in javacard.framework" target="classFrame">AID</A>
 <BR>
@@ -44,20 +40,16 @@
 <BR>
 <A HREF="com/licel/jcardsim/crypto/AsymmetricSignatureImpl.html" title="class in com.licel.jcardsim.crypto" target="classFrame">AsymmetricSignatureImpl</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/odSample/packageA/ATreeNode.html" title="class in com.licel.jcardsim.samples.odSample.packageA" target="classFrame">ATreeNode</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/odSample/packageB/B.html" title="class in com.licel.jcardsim.samples.odSample.packageB" target="classFrame">B</A>
-<BR>
 <A HREF="javacard/framework/service/BasicService.html" title="class in javacard.framework.service" target="classFrame">BasicService</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/odSample/packageB/BTreeNode.html" title="class in com.licel.jcardsim.samples.odSample.packageB" target="classFrame">BTreeNode</A>
-<BR>
 <A HREF="com/licel/jcardsim/crypto/ByteContainer.html" title="class in com.licel.jcardsim.crypto" target="classFrame">ByteContainer</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/odSample/libPackageC/C.html" title="class in com.licel.jcardsim.samples.odSample.libPackageC" target="classFrame">C</A>
+<A HREF="com/licel/jcardsim/io/CAD.html" title="class in com.licel.jcardsim.io" target="classFrame">CAD</A>
 <BR>
 <A HREF="javacard/framework/CardException.html" title="class in javacard.framework" target="classFrame">CardException</A>
 <BR>
+<A HREF="com/licel/jcardsim/io/CardInterface.html" title="interface in com.licel.jcardsim.io" target="classFrame"><I>CardInterface</I></A>
+<BR>
 <A HREF="javacard/framework/service/CardRemoteObject.html" title="class in javacard.framework.service" target="classFrame">CardRemoteObject</A>
 <BR>
 <A HREF="javacard/framework/CardRuntimeException.html" title="class in javacard.framework" target="classFrame">CardRuntimeException</A>
@@ -66,16 +58,12 @@
 <BR>
 <A HREF="javacardx/crypto/Cipher.html" title="class in javacardx.crypto" target="classFrame">Cipher</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/ChannelsDemo/ConnectionManager.html" title="class in com.licel.jcardsim.samples.ChannelsDemo" target="classFrame">ConnectionManager</A>
-<BR>
 <A HREF="com/licel/jcardsim/crypto/CRC16.html" title="class in com.licel.jcardsim.crypto" target="classFrame">CRC16</A>
 <BR>
 <A HREF="com/licel/jcardsim/crypto/CRC32.html" title="class in com.licel.jcardsim.crypto" target="classFrame">CRC32</A>
 <BR>
 <A HREF="javacard/security/CryptoException.html" title="class in javacard.security" target="classFrame">CryptoException</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/JavaPurseCrypto/CyclicFile.html" title="class in com.licel.jcardsim.samples.JavaPurseCrypto" target="classFrame">CyclicFile</A>
-<BR>
 <A HREF="javacard/security/DESKey.html" title="interface in javacard.security" target="classFrame"><I>DESKey</I></A>
 <BR>
 <A HREF="javacard/framework/service/Dispatcher.html" title="class in javacard.framework.service" target="classFrame">Dispatcher</A>
@@ -110,11 +98,15 @@
 <BR>
 <A HREF="javacard/framework/ISOException.html" title="class in javacard.framework" target="classFrame">ISOException</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/JavaLoyalty/JavaLoyalty.html" title="class in com.licel.jcardsim.samples.JavaLoyalty" target="classFrame">JavaLoyalty</A>
+<A HREF="com/licel/jcardsim/io/JavaCardInterface.html" title="interface in com.licel.jcardsim.io" target="classFrame"><I>JavaCardInterface</I></A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/SampleLibrary/JavaLoyaltyInterface.html" title="interface in com.licel.jcardsim.samples.SampleLibrary" target="classFrame"><I>JavaLoyaltyInterface</I></A>
+<A HREF="com/licel/jcardsim/remote/JavaCardRemoteClient.html" title="class in com.licel.jcardsim.remote" target="classFrame">JavaCardRemoteClient</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/JavaPurse/JavaPurse.html" title="class in com.licel.jcardsim.samples.JavaPurse" target="classFrame">JavaPurse</A>
+<A HREF="com/licel/jcardsim/remote/JavaCardRemoteInterface.html" title="interface in com.licel.jcardsim.remote" target="classFrame"><I>JavaCardRemoteInterface</I></A>
+<BR>
+<A HREF="com/licel/jcardsim/remote/JavaCardRemoteServer.html" title="class in com.licel.jcardsim.remote" target="classFrame">JavaCardRemoteServer</A>
+<BR>
+<A HREF="com/licel/jcardsim/io/JavaxSmartCardInterface.html" title="class in com.licel.jcardsim.io" target="classFrame">JavaxSmartCardInterface</A>
 <BR>
 <A HREF="com/licel/jcardsim/smartcardio/JCardSimProvider.html" title="class in com.licel.jcardsim.smartcardio" target="classFrame">JCardSimProvider</A>
 <BR>
@@ -148,58 +140,26 @@
 <BR>
 <A HREF="com/licel/jcardsim/crypto/KeyWithParameters.html" title="interface in com.licel.jcardsim.crypto" target="classFrame"><I>KeyWithParameters</I></A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/ServiceDemo/Main.html" title="class in com.licel.jcardsim.samples.ServiceDemo" target="classFrame">Main</A>
-<BR>
 <A HREF="javacard/security/MessageDigest.html" title="class in javacard.security" target="classFrame">MessageDigest</A>
 <BR>
 <A HREF="com/licel/jcardsim/crypto/MessageDigestImpl.html" title="class in com.licel.jcardsim.crypto" target="classFrame">MessageDigestImpl</A>
 <BR>
 <A HREF="javacard/framework/MultiSelectable.html" title="interface in javacard.framework" target="classFrame"><I>MultiSelectable</I></A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/SecureRMIDemo/MySecurityService.html" title="class in com.licel.jcardsim.samples.SecureRMIDemo" target="classFrame">MySecurityService</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/NullApp/NullApp.html" title="class in com.licel.jcardsim.samples.NullApp" target="classFrame">NullApp</A>
-<BR>
 <A HREF="javacard/framework/OwnerPIN.html" title="class in javacard.framework" target="classFrame">OwnerPIN</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/JavaPurseCrypto/ParametersFile.html" title="class in com.licel.jcardsim.samples.JavaPurseCrypto" target="classFrame">ParametersFile</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/photocard/PhotoCard.html" title="interface in com.licel.jcardsim.samples.photocard" target="classFrame"><I>PhotoCard</I></A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/photocard/PhotoCardApplet.html" title="class in com.licel.jcardsim.samples.photocard" target="classFrame">PhotoCardApplet</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/photocard/PhotoCardImpl.html" title="class in com.licel.jcardsim.samples.photocard" target="classFrame">PhotoCardImpl</A>
-<BR>
 <A HREF="javacard/framework/PIN.html" title="interface in javacard.framework" target="classFrame"><I>PIN</I></A>
 <BR>
 <A HREF="javacard/framework/PINException.html" title="class in javacard.framework" target="classFrame">PINException</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/ServiceDemo/PostProcess.html" title="class in com.licel.jcardsim.samples.ServiceDemo" target="classFrame">PostProcess</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/ServiceDemo/PreProcess.html" title="class in com.licel.jcardsim.samples.ServiceDemo" target="classFrame">PreProcess</A>
-<BR>
 <A HREF="javacard/security/PrivateKey.html" title="interface in javacard.security" target="classFrame"><I>PrivateKey</I></A>
 <BR>
 <A HREF="javacard/security/PublicKey.html" title="interface in javacard.security" target="classFrame"><I>PublicKey</I></A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/RMIDemo/Purse.html" title="interface in com.licel.jcardsim.samples.RMIDemo" target="classFrame"><I>Purse</I></A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/SecureRMIDemo/Purse.html" title="interface in com.licel.jcardsim.samples.SecureRMIDemo" target="classFrame"><I>Purse</I></A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/RMIDemo/PurseApplet.html" title="class in com.licel.jcardsim.samples.RMIDemo" target="classFrame">PurseApplet</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/RMIDemo/PurseImpl.html" title="class in com.licel.jcardsim.samples.RMIDemo" target="classFrame">PurseImpl</A>
-<BR>
 <A HREF="javacard/security/RandomData.html" title="class in javacard.security" target="classFrame">RandomData</A>
 <BR>
 <A HREF="com/licel/jcardsim/crypto/RandomDataImpl.html" title="class in com.licel.jcardsim.crypto" target="classFrame">RandomDataImpl</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/JavaPurseCrypto/Record.html" title="class in com.licel.jcardsim.samples.JavaPurseCrypto" target="classFrame">Record</A>
-<BR>
-<A HREF="java/rmi/Remote.html" title="interface in java.rmi" target="classFrame"><I>Remote</I></A>
-<BR>
-<A HREF="java/rmi/RemoteException.html" title="class in java.rmi" target="classFrame">RemoteException</A>
-<BR>
 <A HREF="javacard/framework/service/RemoteService.html" title="interface in javacard.framework.service" target="classFrame"><I>RemoteService</I></A>
 <BR>
 <A HREF="javacard/framework/service/RMIService.html" title="class in javacard.framework.service" target="classFrame">RMIService</A>
@@ -216,12 +176,10 @@
 <BR>
 <A HREF="javacard/security/SecretKey.html" title="interface in javacard.security" target="classFrame"><I>SecretKey</I></A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/SecureRMIDemo/SecurePurseApplet.html" title="class in com.licel.jcardsim.samples.SecureRMIDemo" target="classFrame">SecurePurseApplet</A>
-<BR>
-<A HREF="com/licel/jcardsim/samples/SecureRMIDemo/SecurePurseImpl.html" title="class in com.licel.jcardsim.samples.SecureRMIDemo" target="classFrame">SecurePurseImpl</A>
-<BR>
 <A HREF="javacard/framework/service/SecurityService.html" title="interface in javacard.framework.service" target="classFrame"><I>SecurityService</I></A>
 <BR>
+<A HREF="com/licel/jcardsim/remote/SerializableAID.html" title="class in com.licel.jcardsim.remote" target="classFrame">SerializableAID</A>
+<BR>
 <A HREF="javacard/framework/service/Service.html" title="interface in javacard.framework.service" target="classFrame"><I>Service</I></A>
 <BR>
 <A HREF="javacard/framework/service/ServiceException.html" title="class in javacard.framework.service" target="classFrame">ServiceException</A>
@@ -244,20 +202,14 @@
 <BR>
 <A HREF="javacard/framework/SystemException.html" title="class in javacard.framework" target="classFrame">SystemException</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/ServiceDemo/TestService.html" title="class in com.licel.jcardsim.samples.ServiceDemo" target="classFrame">TestService</A>
-<BR>
 <A HREF="javacard/framework/TransactionException.html" title="class in javacard.framework" target="classFrame">TransactionException</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/odSample/packageA/TransientArrayElement.html" title="class in com.licel.jcardsim.samples.odSample.packageA" target="classFrame">TransientArrayElement</A>
-<BR>
 <A HREF="com/licel/jcardsim/base/TransientMemory.html" title="class in com.licel.jcardsim.base" target="classFrame">TransientMemory</A>
 <BR>
 <A HREF="javacard/framework/UserException.html" title="class in javacard.framework" target="classFrame">UserException</A>
 <BR>
 <A HREF="javacard/framework/Util.html" title="class in javacard.framework" target="classFrame">Util</A>
 <BR>
-<A HREF="com/licel/jcardsim/samples/wallet/Wallet.html" title="class in com.licel.jcardsim.samples.wallet" target="classFrame">Wallet</A>
-<BR>
 </FONT></TD>
 </TR>
 </TABLE>