comment regarding the salt generator

Signed-off-by: Berend Sliedrecht <[email protected]>

src/createDecoys.ts

@@ -2,7 +2,19 @@ import { Hasher } from './sdJwt'
 import { OrPromise } from './types'
 
 /**
- * Key should not be used to generate the salt as it needs to be unique. It is used for testing here
+ * Function which returns a salt generated by a CSPRNG.
+ *
+ * Recommended size is 128 bits (i.e. 16 bytes).
+ *
+ * Salts will not be seeded and a new one will be used for each claim.
+ *
+ * @example
+ *
+ * Node.js: `crypto.randomBytes(128 / 8)`
+ *
+ * React Native: `expo-standard-web-crypto`
+ *
+ * Browser: `crypto.getRandomValues(new Uint8Array(128 / 8))`
  */
 export type SaltGenerator = () => OrPromise<string>
 
@@ -16,7 +28,7 @@ const createDecoy = async (saltGenerator: SaltGenerator, hasher: Hasher) => {
 export const createDecoys = async (
     count: number,
     saltGenerator: SaltGenerator,
-    hasher: Hasher,
+    hasher: Hasher
 ) => {
     const decoys: Array<string> = []
     for (let i = 0; i < count; i++) {