use serde::{Deserialize, Serialize};
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct FingerprintTarget {
pub label: &'static str,
pub ja3: &'static str,
pub ja4: &'static str,
pub akamai_h2: &'static str,
pub peet_h2: &'static str,
}
pub const FINGERPRINT_TARGETS: &[FingerprintTarget] = &[
FingerprintTarget {
label: "chrome-130-win",
ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513-21,29-23-24,0",
ja4: "t13d1517h2_8daaf6152771_b1ff8ab2d16f",
akamai_h2: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p",
peet_h2: "85a51e4cca7d6d7c1a9d3f54bbb9c3a1",
},
FingerprintTarget {
label: "chrome-130-mac",
ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513-21,29-23-24,0",
ja4: "t13d1517h2_8daaf6152771_b1ff8ab2d16f",
akamai_h2: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p",
peet_h2: "85a51e4cca7d6d7c1a9d3f54bbb9c3a1",
},
FingerprintTarget {
label: "firefox-131-linux",
ja3: "771,4865-4867-4866-49195-49199-52393-52392-49196-49200-49162-49161-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-34-51-43-13-45-28-65037,29-23-24-25-256-257,0",
ja4: "t13d1717h2_5b57614c22b0_3d5424432f57",
akamai_h2: "1:65536;4:131072;5:16384|12517377|3:0:0:201|m,p,a,s",
peet_h2: "5e6b2c9f4a1d8c3b7e9a4f2d6c8b1e3a",
},
FingerprintTarget {
label: "chrome-131-win-pq",
ja3: "771,4865-4866-4867-49195-49199-49196-49200-52393-52392-49171-49172-156-157-47-53,0-23-65281-10-11-35-16-5-13-18-51-45-43-27-17513-21,4588-29-23-24,0",
ja4: "t13d1517h2_8daaf6152771_b1ff8ab2d16f",
akamai_h2: "1:65536;3:1000;4:6291456;6:262144|15663105|0|m,a,s,p",
peet_h2: "85a51e4cca7d6d7c1a9d3f54bbb9c3a1",
},
FingerprintTarget {
label: "safari-17-mac",
ja3: "771,4865-4867-4866-49196-49200-52393-52392-49195-49199-49188-49192-49162-49172-49187-49191-49161-49171-156-157-61-60-53-47-49160-49170-10,0-65281-10-11-13-16-23-43-45-51,29-23-24-25,0",
ja4: "t13d1715h2_5b57614c22b0_eedb19c98e96",
akamai_h2: "2:0;4:4194304;3:100|10485760|0|m,s,p,a",
peet_h2: "9c2a4d8b6e1f5a3c7d9b2e4f6a8c1d3e",
},
];
#[must_use]
pub fn lookup(label: &str) -> Option<&'static FingerprintTarget> {
FINGERPRINT_TARGETS.iter().find(|t| t.label == label)
}
#[must_use]
pub fn all_labels() -> Vec<&'static str> {
FINGERPRINT_TARGETS.iter().map(|t| t.label).collect()
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn ships_at_least_four_targets() {
assert!(
FINGERPRINT_TARGETS.len() >= 4,
"fingerprint catalogue regressed below the 4-target baseline"
);
}
#[test]
fn every_label_resolves_via_lookup() {
for target in FINGERPRINT_TARGETS {
let resolved = lookup(target.label).expect("label must round-trip");
assert_eq!(resolved, target);
}
}
#[test]
fn lookup_returns_none_for_unknown_label() {
assert!(lookup("internet-explorer-6").is_none());
assert!(lookup("").is_none());
assert!(
lookup("CHROME-130-WIN").is_none(),
"lookup is case-sensitive"
);
}
#[test]
fn every_target_has_non_empty_fields() {
for target in FINGERPRINT_TARGETS {
assert!(!target.label.is_empty(), "target label empty");
assert!(!target.ja3.is_empty(), "{}: empty JA3", target.label);
assert!(!target.ja4.is_empty(), "{}: empty JA4", target.label);
assert!(
!target.akamai_h2.is_empty(),
"{}: empty akamai_h2",
target.label
);
assert!(
!target.peet_h2.is_empty(),
"{}: empty peet_h2",
target.label
);
}
}
#[test]
fn all_labels_lists_every_target_in_order() {
let labels = all_labels();
assert_eq!(labels.len(), FINGERPRINT_TARGETS.len());
for (index, target) in FINGERPRINT_TARGETS.iter().enumerate() {
assert_eq!(labels[index], target.label);
}
}
#[test]
fn ja3_format_starts_with_tls_version_771() {
for target in FINGERPRINT_TARGETS {
assert!(
target.ja3.starts_with("771,"),
"{}: JA3 must start with 771, got {}",
target.label,
&target.ja3[..target.ja3.len().min(20)]
);
}
}
#[test]
fn ja4_format_starts_with_t13d_for_tls_13_targets() {
for target in FINGERPRINT_TARGETS {
assert!(
target.ja4.starts_with("t13d"),
"{}: JA4 must start with t13d, got {}",
target.label,
&target.ja4[..target.ja4.len().min(8)]
);
}
}
#[test]
fn akamai_h2_has_pipe_separated_four_part_format() {
for target in FINGERPRINT_TARGETS {
let parts: Vec<&str> = target.akamai_h2.split('|').collect();
assert_eq!(
parts.len(),
4,
"{}: akamai_h2 must have 4 pipe-separated parts, got {}",
target.label,
parts.len()
);
}
}
}