fair 0.0.13

CLI tool and library for verifying provably fair games (baccarat, etc.).
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

//! # provably fair dice game
//!

/*
The game event number is calculated by multiplying the float by the possible outcomes in the reel.
The first 4 reels have a length of 30 possible outcomes, whilst the last reel has 41. The game
event determines the central stop position for each reel. This game consists of 5 game event
numbers, until the case of a bonus round, where more are generated.
*/

pub use crate::rng::{ProvablyFairConfig, ProvablyFairRNG};
use std::fmt;

#[derive(Debug)]

// There are 5 reels
// One outcome per reel (an index into the reel's outcomesl)
// First 4 reels have 30 possible outcomes
// 5th reel has 41 possible outcomes
pub struct SimulationResult {
    pub outcomes: [usize; 5],
}

impl fmt::Display for SimulationResult {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "{:?}", self.outcomes)
    }
}

pub fn simulate(config: ProvablyFairConfig, round: usize) -> SimulationResult {
    let mut rng: ProvablyFairRNG<f64> = ProvablyFairRNG::from_config(config);
    // skip previous rounds...
    for _ in 0..round {
        for _ in 0..5 {
            rng.next();
        }
    }
    let reel1 = rng.range(0, 30);
    let reel2 = rng.range(0, 30);
    let reel3 = rng.range(0, 30);
    let reel4 = rng.range(0, 30);
    let reel5 = rng.range(0, 41);
    SimulationResult {
        outcomes: [reel1, reel2, reel3, reel4, reel5],
    }
}

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    fn simulate_slots() {
        let config = ProvablyFairConfig::new("client seed", "server seed", 1);
        let result = simulate(config, 0);
        assert_eq!(result.outcomes, [22, 19, 7, 27, 23]);
        let config = ProvablyFairConfig::new("client seed", "server seed", 1);
        let result = simulate(config, 1);
        assert_eq!(result.outcomes, [26, 20, 19, 28, 5]);
    }
}