vrf-wasm 0.9.1

VRF for WASM environments
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192

pub mod ristretto255_tests;
pub mod vrf_tests;
pub mod test_helpers;

#[cfg(test)]
mod conditional_compilation_tests {
    use crate::rng;
    use rand_core::RngCore;

    #[test]
    fn test_rng_implementation_selection() {
        let implementation = rng::get_rng_implementation();

        // Test the priority system:
        // 1. browser feature takes priority when both are enabled (or is default)
        // 2. near feature is used only when browser is explicitly disabled

        #[cfg(all(feature = "browser", feature = "near"))]
        assert_eq!(implementation, "browser", "Browser should take priority when both features are enabled");

        #[cfg(all(feature = "browser", not(feature = "near")))]
        assert_eq!(implementation, "browser", "Browser should be used when only browser feature is enabled");

        #[cfg(all(feature = "near", not(feature = "browser")))]
        assert_eq!(implementation, "near", "NEAR should be used when only near feature is enabled");

        println!("Using RNG implementation: {}", implementation);
    }

    #[test]
    fn test_rng_functionality() {

        // Create RNG instance based on the implementation
        #[cfg(feature = "browser")]
        let mut rng = rng::WasmRng;

        // NOTE: defaults to browser based RNG for tests even when near feature is enabled
        // We don't have near_workspace dependency added, so near testes would fail annyway
        #[cfg(feature = "near")]
        let mut rng = rng::WasmRng::default();

        // Test that we can generate different values
        let val1 = rng.next_u32();
        let val2 = rng.next_u32();

        // Very unlikely to be equal (though theoretically possible)
        // This is just a basic smoke test
        println!("Generated values: {} and {}", val1, val2);

        // Test fill_bytes
        let mut buffer = [0u8; 16];
        rng.fill_bytes(&mut buffer);

        // Should not be all zeros (extremely unlikely)
        assert_ne!(buffer, [0u8; 16]);
        println!("Generated bytes: {:?}", buffer);
    }

    #[test]
    fn test_seeded_rng() {
        use rand_core::SeedableRng;

        let seed = [42u8; 32];
        let mut rng1 = rng::WasmRngFromSeed::from_seed(seed);
        let mut rng2 = rng::WasmRngFromSeed::from_seed(seed);

        // Same seed should produce same values
        assert_eq!(rng1.next_u32(), rng2.next_u32());
        assert_eq!(rng1.next_u64(), rng2.next_u64());

        println!("Seeded RNG test passed for implementation: {}", rng::get_rng_implementation());
    }
}

#[cfg(test)]
mod vrf_component_tests {
    use crate::vrf::ecvrf::{ECVRFKeyPair, ECVRFProof};
    use crate::vrf::{VRFKeyPair, VRFProof};
    use crate::serde_helpers::ToFromByteArray;
    use crate::rng;

    #[test]
    fn test_component_extraction() {

        // Create RNG instance based on the implementation
        #[cfg(feature = "browser")]
        let mut rng = rng::WasmRng;

        // NOTE: defaults to browser based RNG for tests even when near feature is enabled
        // We don't have near_workspace dependency added, so near testes would fail annyway
        #[cfg(feature = "near")]
        let mut rng = rng::WasmRng::default();

        // Generate a keypair and proof
        let keypair = ECVRFKeyPair::generate(&mut rng);
        let input = b"test input for component extraction";
        let proof = keypair.prove(input);

        // Extract components using new methods
        let gamma_bytes = proof.gamma_bytes();
        let challenge_bytes = proof.challenge_bytes();
        let scalar_bytes = proof.scalar_bytes();

        // Extract all components at once
        let (gamma_all, challenge_all, scalar_all) = proof.to_components();

        // Verify individual extractions match bulk extraction
        assert_eq!(gamma_bytes, gamma_all);
        assert_eq!(challenge_bytes, challenge_all);
        assert_eq!(scalar_bytes, scalar_all);

        // Verify expected lengths
        assert_eq!(gamma_bytes.len(), 32);
        assert_eq!(challenge_bytes.len(), 16);
        assert_eq!(scalar_bytes.len(), 32);

        println!("✓ Component extraction works correctly");
        println!("  Gamma: {} bytes", gamma_bytes.len());
        println!("  Challenge: {} bytes", challenge_bytes.len());
        println!("  Scalar: {} bytes", scalar_bytes.len());
    }

    #[test]
    fn test_proof_reconstruction() {

        // Create RNG instance based on the implementation
        #[cfg(feature = "browser")]
        let mut rng = rng::WasmRng;

        // NOTE: defaults to browser based RNG for tests even when near feature is enabled
        // We don't have near_workspace dependency added, so near testes would fail annyway
        #[cfg(feature = "near")]
        let mut rng = rng::WasmRng::default();

        // Generate a keypair and proof
        let keypair = ECVRFKeyPair::generate(&mut rng);
        let input = b"test input for proof reconstruction";
        let original_proof = keypair.prove(input);

        // Extract components
        let (gamma_bytes, challenge_bytes, scalar_bytes) = original_proof.to_components();

        // Reconstruct proof from components
        let reconstructed_proof = ECVRFProof::from_components(
            &gamma_bytes,
            &challenge_bytes,
            &scalar_bytes,
        ).expect("Failed to reconstruct proof from components");

        // Verify reconstructed proof works
        assert!(reconstructed_proof.verify(input, &keypair.pk).is_ok());

        // Verify proofs are equivalent
        assert_eq!(original_proof.gamma_bytes(), reconstructed_proof.gamma_bytes());
        assert_eq!(original_proof.challenge_bytes(), reconstructed_proof.challenge_bytes());
        assert_eq!(original_proof.scalar_bytes(), reconstructed_proof.scalar_bytes());

        // Verify they produce the same hash
        assert_eq!(original_proof.to_hash(), reconstructed_proof.to_hash());

        println!("✓ Proof reconstruction from components works correctly");
        println!("  Original and reconstructed proofs are functionally identical");
    }

    #[test]
    fn test_direct_field_access() {
        // Create RNG instance based on the implementation
        #[cfg(feature = "browser")]
        let mut rng_instance = rng::WasmRng;

        #[cfg(feature = "near")]
        let mut rng_instance = rng::WasmRng::default();

        // Generate a keypair and proof
        let keypair = ECVRFKeyPair::generate(&mut rng_instance);
        let input = b"test input for direct field access";
        let proof = keypair.prove(input);

        // Test that we can directly access the public fields
        let _gamma = proof.gamma;
        let _challenge = proof.c;
        let _scalar = proof.s;

        // Test that direct access gives same results as helper methods
        assert_eq!(proof.gamma.compress(), proof.gamma_bytes());
        assert_eq!(proof.c.0, proof.challenge_bytes());
        assert_eq!(proof.s.to_byte_array(), proof.scalar_bytes());

        println!("✓ Direct field access works correctly");
        println!("  Public fields are accessible and consistent with helper methods");
    }
}