update README

This commit is contained in:
2025-12-13 23:51:23 +01:00
parent d4be1689e2
commit 20d031fba6

View File

@@ -1,18 +1,21 @@
# Kotlin OTP # prng-kt
This library provides various [Pseudorandom Number Generator](https://en.wikipedia.org/wiki/Pseudorandom_number_generator) `prng-kt` is a Kotlin Multiplatform library that provides common pseudorandom number generators.
implementations in Kotlin Multiplatform.
## Features Supported hash functions:
- PRNG
- LCG
- CSPRNG
- HMAC DRBG
* Generate random numbers using Kotlin's Random interface. ## Targets
* Seed the PRNGs to receive predictable results.
* Reseed the PRNGs to add entropy to the following results. | Target | Status |
* [HMAC DRBG](https://en.wikipedia.org/wiki/NIST_SP_800-90A#Hash_DRBG_and_HMAC_DRBG) |------------------|---------------|
* Multiplatform support | JVM | Supported |
* JVM | JavaScript | Supported |
* JavaScript | Native (Linux) | Supported |
* Native (Linux) | Native (Windows) | Not Supported |
## Installation ## Installation
@@ -24,19 +27,19 @@ repositories {
} }
dependencies { dependencies {
implementation("com.infendro:random:1.1.0") implementation("com.infendro:prng:1.2.0")
} }
``` ```
## Usage ## Usage
```kotlin ```kotlin
import com.infendro.hash.SHA256 import com.infendro.hash.sha2.`SHA-256`
import com.infendro.random.PRNG import com.infendro.random.csprng.CSPRNG
fun main() { fun main() {
// create a PRNG instance // create a PRNG instance
val rng = PRNG.HMAC(SHA256) val rng = CSPRNG.HMAC(`SHA-256`)
// seed the PRNG to receive predictable results // seed the PRNG to receive predictable results
rng.seed(/* some seed */) rng.seed(/* some seed */)