Skip to main content

dpp/shielded/
identity_create_denomination.rs

1use platform_version::version::PlatformVersion;
2
3/// Whether `denomination` is a member of `platform_version`'s exit-denomination set for
4/// `IdentityCreateFromShieldedPool`.
5///
6/// The single definition of an allowed identity-create exit: transition structure validation,
7/// the transition builder and wallet preflights all call it. Consensus-critical — the set is
8/// versioned in the tables, so a new rule is a table change, never an edit here. Every member is
9/// positive, so zero is never allowed; versions without the shielded pool allow nothing.
10pub fn is_allowed_identity_create_denomination(
11    denomination: u64,
12    platform_version: &PlatformVersion,
13) -> bool {
14    platform_version
15        .drive_abci
16        .validation_and_processing
17        .event_constants
18        .shielded_identity_create_denominations
19        .contains(&denomination)
20}
21
22#[cfg(test)]
23mod tests {
24    use super::*;
25
26    /// 0.1 DASH in credits — a member of every shipped exit-denomination set.
27    const ONE_TENTH_DASH: u64 = 10_000_000_000;
28
29    #[test]
30    fn should_allow_a_member_denomination() {
31        assert!(is_allowed_identity_create_denomination(
32            ONE_TENTH_DASH,
33            PlatformVersion::latest()
34        ));
35    }
36
37    #[test]
38    fn should_reject_zero_and_non_member_denominations() {
39        for denomination in [0, 12_345, ONE_TENTH_DASH + 1, u64::MAX] {
40            assert!(
41                !is_allowed_identity_create_denomination(denomination, PlatformVersion::latest()),
42                "denomination {denomination} must not be allowed"
43            );
44        }
45    }
46
47    #[test]
48    fn should_reject_every_denomination_before_the_shielded_pool_exists() {
49        assert!(!is_allowed_identity_create_denomination(
50            ONE_TENTH_DASH,
51            PlatformVersion::first()
52        ));
53    }
54}