Extra Javadocs

convex-core/src/main/java/convex/core/crypto/BIP39.java

@@ -251,7 +251,7 @@ public static AKeyPair seedToKeyPair(Blob seed) {
 	 * Note: longer term users may want hierarchical deterministic wallet generation
 	 * 
 	 * @param seed BIP39 seed
-	 * @return
+	 * @return Ed25519 seed as a Blob
 	 */
 	public static Blob seedToEd25519Seed(Blob seed) {
 		long n=seed.count();
@@ -317,9 +317,9 @@ public static String createSecureMnemonic(int numWords) {
 
 	/**
 	 * Create a list of random mnemonic words given a random number generator
-	 * @param r
-	 * @param n
-	 * @return
+	 * @param r Random number generator instance
+	 * @param n Number of words to generate
+	 * @return List of words
 	 */
 	public static List<String> createWords(SecureRandom r, int n) {
 		ArrayList<String> al=new ArrayList<>(n);
@@ -360,8 +360,8 @@ public static String normalise(String s) {
 
 	/**
 	 * Create a mnemonic String from a list of words, separated by spaces
-	 * @param words
-	 * @return
+	 * @param words  List of words for mnemonic
+	 * @return Combined mnemonic string
 	 */
 	public static String mnemonic(List<String> words) {
 		StringBuilder sb=new StringBuilder();

convex-core/src/main/java/convex/core/crypto/wallet/AWalletEntry.java

@@ -13,7 +13,7 @@ public void unlock(char[] password) {
 
 	/**
 	 * Returns the data to be used for a wallet identicon. Should be the public account key
-	 * @return
+	 * @return Data to be used for an identicon
 	 */
 	public abstract AArrayBlob getIdenticonData();
 

convex-core/src/main/java/convex/core/data/ABlobLike.java

@@ -166,8 +166,8 @@ protected boolean appendHex(BlobBuilder bb, long length) {
 	/**
 	 * Convert this BlobLike object to an ABlob instance, in the most efficient way. 
 	 * 
-	 * May return `this`. Result might not be a regular Blob (e.g. Address)
-	 * @return
+	 * May return `this`. 
+	 * @return Blob instance
 	 */
 	public abstract ABlob toBlob();
 

convex-core/src/main/java/convex/core/data/prim/AInteger.java

@@ -176,8 +176,9 @@ public static AInteger create(Number value) {
 	public abstract ABlob toBlob();
 
 	/**
-	 * Return true if this value is a precisely equal to a valid 64-bit long integer
-	 * @return
+	 * Return true if this value is a valid 64-bit long integer
+	 * 
+	 * @return true if this integer fits in a 64-bit long
 	 */
 	public abstract boolean isLong();