mixnet 0.7.0

A mix network based on Loopix
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

// Copyright 2022 Parity Technologies (UK) Ltd.
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.

//! Mixnet cover packet generation.

use super::{
	packet_queues::AddressedPacket,
	sphinx::build_cover_packet,
	topology::{NetworkStatus, RouteGenerator, RouteKind, Topology, TopologyErr},
	util::default_boxed_array,
};
use arrayvec::ArrayVec;
use rand::{CryptoRng, Rng};

#[derive(PartialEq, Eq)]
pub enum CoverKind {
	Drop,
	Loop,
}

pub fn gen_cover_packet<X>(
	rng: &mut (impl Rng + CryptoRng),
	topology: &Topology<X>,
	ns: &dyn NetworkStatus,
	kind: CoverKind,
	num_hops: usize,
) -> Result<AddressedPacket, TopologyErr> {
	// Generate route
	let route_generator = RouteGenerator::new(topology, ns);
	let route_kind = match kind {
		CoverKind::Drop => RouteKind::ToMixnode(route_generator.choose_destination_index(rng)?),
		CoverKind::Loop => RouteKind::Loop,
	};
	let mut targets = ArrayVec::new();
	let mut their_kx_publics = ArrayVec::new();
	let first_mixnode_index = route_generator.gen_route(
		&mut targets,
		&mut their_kx_publics,
		rng,
		route_kind,
		num_hops,
	)?;
	let peer_id = topology.mixnode_index_to_peer_id(first_mixnode_index)?;

	// Build packet
	let mut packet = default_boxed_array();
	build_cover_packet(&mut packet, rng, &targets, &their_kx_publics, None);

	Ok(AddressedPacket { peer_id, packet })
}