39 lines
1.2 KiB
C
39 lines
1.2 KiB
C
/*
|
|
* Argon2id (RFC 9106)
|
|
* Copyright (c) 2026 Cristian Cezar Moisés
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*
|
|
* Memory-hard password hashing function. Reference implementation
|
|
* (single-lane focus), verified against RFC 9106 §5 test vectors.
|
|
*/
|
|
#ifndef ZSDK_ARGON2ID_H
|
|
#define ZSDK_ARGON2ID_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
/* Returns 0 on success, -1 on parameter validation failure or alloc fail.
|
|
*
|
|
* passwd, passwd_len the password (any length)
|
|
* salt, salt_len random salt (>= 8 bytes recommended; >= 16 standard)
|
|
* memory_kib memory cost in KiB (>= 8 * lanes; we require >= 19456)
|
|
* iterations time cost (>= 1; we require >= 2)
|
|
* lanes parallelism (>= 1, <= 4 here)
|
|
* out, out_len output buffer (>= 4 bytes; typically 32)
|
|
*/
|
|
int zsdk_argon2id(const uint8_t *passwd, size_t passwd_len,
|
|
const uint8_t *salt, size_t salt_len,
|
|
uint32_t memory_kib,
|
|
uint32_t iterations,
|
|
uint32_t lanes,
|
|
uint8_t *out, size_t out_len);
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|