zebra-chain 6.0.2

Core Zcash data structures
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use chrono::Duration;
use proptest::prelude::*;

use crate::{
    block,
    chain_tip::{mock::MockChainTip, ChainTip},
    parameters::{Network, NetworkUpgrade},
    serialization::arbitrary::datetime_u32,
};

const NU_BEFORE_BLOSSOM: NetworkUpgrade = NetworkUpgrade::Sapling;

proptest! {
    /// Test network chain tip height estimation.
    ///
    /// Given a pair of block heights, estimate the time difference and use it with the lowest
    /// height to check if the estimation of the height is correct.
    #[test]
    fn network_chain_tip_height_estimation_is_correct(
        network in any::<Network>(),
        mut block_heights in any::<[block::Height; 2]>(),
        current_block_time in datetime_u32(),
        time_displacement_factor in 0.0..1.0_f64,
    ) {
        let (chain_tip, mock_chain_tip_sender) = MockChainTip::new();
        let blossom_activation_height = NetworkUpgrade::Blossom
            .activation_height(&network)
            .expect("Blossom activation height is missing");

        block_heights.sort();
        let current_height = block_heights[0];
        let network_height = block_heights[1];

        mock_chain_tip_sender.send_best_tip_height(current_height);
        mock_chain_tip_sender.send_best_tip_block_time(current_block_time);

        let estimated_time_difference =
            // Estimate time difference for heights before Blossom activation.
            estimate_time_difference(
                current_height.min(blossom_activation_height),
                network_height.min(blossom_activation_height),
                NU_BEFORE_BLOSSOM,
            )
            // Estimate time difference for heights after Blossom activation.
            + estimate_time_difference(
                current_height.max(blossom_activation_height),
                network_height.max(blossom_activation_height),
                NetworkUpgrade::Blossom,
            );

        let time_displacement = calculate_time_displacement(
            time_displacement_factor,
            NetworkUpgrade::current(&network, network_height),
        );

        let mock_local_time = current_block_time + estimated_time_difference + time_displacement;

        assert_eq!(
            chain_tip.estimate_network_chain_tip_height(&network, mock_local_time),
            Some(network_height)
        );
    }
}

/// Estimate the time necessary for the chain to progress from `start_height` to `end_height`,
/// assuming each block is produced at exactly the number of seconds of the target spacing for the
/// `active_network_upgrade`.
fn estimate_time_difference(
    start_height: block::Height,
    end_height: block::Height,
    active_network_upgrade: NetworkUpgrade,
) -> Duration {
    let spacing_seconds = active_network_upgrade.target_spacing().num_seconds();
    let height_difference = end_height - start_height;

    if height_difference > 0 {
        Duration::seconds(height_difference * spacing_seconds)
    } else {
        Duration::zero()
    }
}

/// Use `displacement` to get a displacement duration between zero and the target spacing of the
/// specified `network_upgrade`.
///
/// This is used to "displace" the time used in the test so that the test inputs aren't exact
/// multiples of the target spacing.
fn calculate_time_displacement(displacement: f64, network_upgrade: NetworkUpgrade) -> Duration {
    let target_spacing = network_upgrade.target_spacing();

    let nanoseconds = target_spacing
        .num_nanoseconds()
        .expect("Target spacing nanoseconds fit in a i64");

    let displaced_nanoseconds = (displacement * nanoseconds as f64)
        .round()
        .clamp(i64::MIN as f64, i64::MAX as f64) as i64;

    Duration::nanoseconds(displaced_nanoseconds)
}