hasherkawpow-sys 0.1.0

Low-level Rust bindings for KawPow hashing and verification.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

/* ethash: C/C++ implementation of Ethash, the Ethereum Proof of Work algorithm.
 * Copyright 2018-2019 Pawel Bylica.
 * Licensed under the Apache License, Version 2.0.
 */

#pragma once

#include "../support/attributes.h"
#include <stdint.h>

/**
 * KISS PRNG by the spec from 1999.
 *
 * The implementation of KISS pseudo-random number generator
 * by the specification published on 21 Jan 1999 in
 * http://www.cse.yorku.ca/~oz/marsaglia-rng.html.
 * The KISS is not versioned so here we are using `kiss99` prefix to indicate
 * the version from 1999.
 *
 * The specification uses `unsigned long` type with the intention for 32-bit
 * values. Because in GCC/clang for 64-bit architectures `unsigned long` is
 * 64-bit size type, here the explicit `uint32_t` type is used.
 *
 * @defgroup kiss99 KISS99
 * @{
 */

/**
 * The KISS generator.
 */
class kiss99
{
    uint32_t z = 362436069;
    uint32_t w = 521288629;
    uint32_t jsr = 123456789;
    uint32_t jcong = 380116160;

public:
    /** Creates KISS generator state with default values provided by the specification. */
    kiss99() noexcept = default;

    /** Creates KISS generator state with provided init values.*/
    kiss99(uint32_t _z, uint32_t _w, uint32_t _jsr, uint32_t _jcong) noexcept
      : z{_z}, w{_w}, jsr{_jsr}, jcong{_jcong}
    {}

    /** Generates next number from the KISS generator. */
    NO_SANITIZE("unsigned-integer-overflow")
    uint32_t operator()() noexcept
    {
        z = 36969 * (z & 0xffff) + (z >> 16);
        w = 18000 * (w & 0xffff) + (w >> 16);

        jcong = 69069 * jcong + 1234567;

        jsr ^= (jsr << 17);
        jsr ^= (jsr >> 13);
        jsr ^= (jsr << 5);

        return (((z << 16) + w) ^ jcong) + jsr;
    }
};

/** @} */