refactor: change encryptPassword to encryptPoint

backend/src/cryptography.cpp

@@ -27,7 +27,7 @@ namespace cryptography
         return result;
     }
 
-    std::string encryptPassword(const unsigned char *point, unsigned char *b)
+    std::string encryptPoint(const unsigned char *point, unsigned char *b)
     {
         // multiply by b
         unsigned char encryptedPassword[crypto_core_ristretto255_BYTES];

backend/src/cryptography.hpp

@@ -13,6 +13,16 @@ namespace cryptography
      */
     std::vector<std::string> encrypt(const std::unordered_set<std::string> &passwords,
                                      unsigned char *b);
-    // TODO add documentation
-    std::string encryptPassword(const unsigned char *, unsigned char *b);
+
+    /**
+     * @brief Encrypt the provided point using secret key b.
+     *
+     * @param password the point to encrypt
+     * @param b the secret key
+     * @return std::string the encrypted password
+     *
+     * @warning The password must be hashed to a point before being passed to this function.
+     * @warning The result of this function is not a string, but a vector of bytes (excluding the null terminator).
+     */
+    std::string encryptPoint(const unsigned char *password, unsigned char *b);
 }

backend/src/server.cpp

@@ -69,7 +69,7 @@ namespace server
             return response;
         }
 
-        std::string password = cryptography::encryptPassword(reinterpret_cast<const unsigned char*>(user_password.data()), b);
+        std::string password = cryptography::encryptPoint(reinterpret_cast<const unsigned char*>(user_password.data()), b);
         response["status"] = "success";
         response["userPassword"] = password;
         response["breachedPasswords"] = passwords;

backend/test/cryptography.cpp

@@ -47,7 +47,7 @@ TEST_CASE("Test encryptPassword")
         crypto_core_ristretto255_from_hash(point, hash);
 
         // encrypt password
-        std::string encryptedPasswordStr = cryptography::encryptPassword(point, b);
+        std::string encryptedPasswordStr = cryptography::encryptPoint(point, b);
         unsigned char encryptedPassword[crypto_core_ristretto255_BYTES];
         std::memcpy(encryptedPassword, encryptedPasswordStr.data(), crypto_core_ristretto255_BYTES);