Updated on 2026-08-14

tangemcard-common/src/main/java/com/tangem/tangemcard/data/external/CardDataSubstitutionProvider.java

@@ -2,6 +2,11 @@ package com.tangem.tangemcard.data.external;
 
 import com.tangem.tangemcard.data.TangemCard;
 
+
+/**
+ * This interface provide method to make substitution of read card data (token symbol, contract address)
+ * if they was unknown when the card was produced
+ */
 public interface CardDataSubstitutionProvider {
     void applySubstitution(TangemCard card);
 }

tangemcard-common/src/main/java/com/tangem/tangemcard/data/external/FirmwaresDigestsProvider.java

@@ -1,5 +1,9 @@
 package com.tangem.tangemcard.data.external;
 
+/**
+ * This interfaces provide function to randomly select parameters to run one VerifyCode command, check answer and
+ * state that card is genuine or not
+ */
 public interface FirmwaresDigestsProvider {
     VerifyCodeRecord selectRandomVerifyCodeBlock(String firmwareVersion);
 

tangemcard-common/src/main/java/com/tangem/tangemcard/data/external/PINsProvider.java

@@ -2,10 +2,29 @@ package com.tangem.tangemcard.data.external;
 
 import java.util.List;
 
+/**
+ * Interface of PINsProvider - object that know some list of PINs (used when start first time read), PIN2 (used for protected operation) and store last used PIN
+ * to use it in following operations
+ */
 public interface PINsProvider {
+
+    /**
+     * @return list of known PINs
+     * This PINs used when start reading of card
+     * When start reading a PINs from this list used sequential in search PIN algorithm until right PIN found
+     */
+    List<String> getPINs();
+
+    /**
+     * @return PIN2 for protected operations
+     */
     String getPIN2();
 
+
+    /**
+     * Call after successful first time reading of card to store founded PIN (normally this PIN must be returned in next time {@see getPINs} at first position)
+     * @param pin
+     */
     void setLastUsedPIN(String pin);
 
-    List<String> getPINs();
 }