darkbio-wire 0.17.1

Encrypted protocol between Ark and host
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

// wire-rs: encrypted protocol between Ark and host
// Copyright 2026 Dark Bio AG. All rights reserved.
//
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

//! Encodes protocol scenarios and raw envelopes for their fuzz targets.
//!
//! Action encodings are checked against their `Arbitrary` decoders; envelope
//! inputs are already wire bytes prefixed by a direction byte. The shared writer
//! saves them under `WIRE_SEEDS/<target>`. Action inputs come from
//! `session/fuzz_tests.rs` and `connection/fuzz_tests.rs`, envelope inputs from
//! `envelope/tests.rs` and `session/tests.rs`. `make fuzz-seeds` regenerates
//! them alongside the transport seeds.

use super::{connection, session};
use crate::transport::mock::seed::{Seed, Seedable};

pub(super) use crate::transport::mock::seed::seed;

/// Session lifecycle target, driven by the model's integer clock.
///
/// Must match its binary name in `fuzz/Cargo.toml`.
pub const SESSION_TARGET: &str = "protocol-session";

/// Connection target, driven through live encrypted streams.
///
/// Must match its binary name in `fuzz/Cargo.toml`.
pub const CONNECTION_TARGET: &str = "protocol-connection";

/// Envelope decoder target, driven directly with peer bytes.
///
/// Must match its binary name in `fuzz/Cargo.toml`.
pub const ENVELOPE_TARGET: &str = "protocol-envelope";

impl Seedable for session::Action {
    fn seed(&self, seed: &mut Seed) {
        /// Number of session action kinds, which scales the encoded kind index.
        const COUNT: u32 = 20;
        seed.variant(self.kind as u32, COUNT);
        seed.byte(self.slot);
        seed.byte(self.value);
        seed.byte(self.budget);
    }
}

impl Seedable for connection::Action {
    fn seed(&self, seed: &mut Seed) {
        /// Number of connection action kinds, which scales the encoded kind index.
        const COUNT: u32 = 23;
        seed.variant(self.kind as u32, COUNT);
        seed.byte(self.slot);
        seed.byte(self.value);
        seed.byte(self.budget);
    }
}

/// Saves an envelope input unchanged as a seed of [`ENVELOPE_TARGET`], when
/// `WIRE_SEEDS` is set.
pub(super) fn envelope(input: &[u8]) {
    crate::transport::mock::seed::write(ENVELOPE_TARGET, || input.to_vec());
}