commit 65a8d78bc9b0db5e09305cef5e3abc50eb412328
parent 12480f43b0aafe60756f3ec10106d05d9e98430c
Author: Christian Grothoff <grothoff@gnunet.org>
Date: Sun, 19 Jul 2026 23:21:31 +0200
clarify meaning of exhausted
Diffstat:
2 files changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/challengerdb/challenger_do_validate_and_solve_pin.sql b/src/challengerdb/challenger_do_validate_and_solve_pin.sql
@@ -20,7 +20,7 @@ CREATE FUNCTION challenger_do_validate_and_solve_pin (
IN in_new_pin INT4,
IN in_now INT8,
OUT out_not_found BOOLEAN,
- OUT out_exhausted BOOLEAN,
+ OUT out_exhausted BOOLEAN, -- set to TRUE if attempts were already exhausted
OUT out_no_challenge BOOLEAN,
OUT out_solved BOOLEAN,
OUT out_state TEXT,
diff --git a/src/include/challenger-database/validate_solve_pin.h b/src/include/challenger-database/validate_solve_pin.h
@@ -34,7 +34,7 @@
* @param nonce unique nonce to use to identify the validation
* @param new_pin the PIN the user entered
* @param[out] solved set to true if the PIN was correct
- * @param[out] exhausted set to true if the number of attempts to enter the correct PIN has been exhausted
+ * @param[out] exhausted set to true if the number of attempts to enter the correct PIN was exhausted before this call and @a new_pin was not evaluated
* @param[out] no_challenge set to true if we never even issued a challenge
* @param[out] state set to client's OAuth2 state if available
* @param[out] addr_left set to number of address changes remaining
