Struct JoinKey 

pub struct JoinKey {

    pub host: String,
    pub workload: Workload,
    pub band: u32,
    pub model: String,
    pub quant: String,
    pub tokenization: TokenCountingMethod,
    pub window_ms: u64,
    pub replicates: u32,
    pub interleaved: bool,
    pub n_ctx_slot: Option<u32>,
    pub kv_type: Option<String>,
    pub fa: Option<bool>,
    pub n_batch: Option<u32>,
    pub n_predict: u32,
}

PP-22 — the fourteen fields two bands must agree on before their numbers may be divided.

Each field is a way two measurements can look comparable and not be. c=4 against c=16 compares different offered loads; a 30 s window against a 60 s one compares different amounts of thermal drift; n_batch = 1 against a served comparator compares a working server against a crippled one.

Fields

host: String

Which host.

workload: Workload

Which workload.

band: u32

The band’s concurrency c.

model: String

Which model.

quant: String

Which quantization.

tokenization: TokenCountingMethod

How tokens were counted (§4.4.6).

window_ms: u64

The measurement window, in milliseconds.

replicates: u32

Replicates run.

interleaved: bool

Whether those replicates alternated.

n_ctx_slot: Option<u32>

Comparator -c per slot. None when the lane did not report one.

kv_type: Option<String>

KV cache type, e.g. f16.

fa: Option<bool>

Flash attention.

n_batch: Option<u32>

Comparator -b. Some(1) is refused outright (§5.3).

n_predict: u32

Generated tokens per request.

Implementations

impl JoinKey

pub fn of(receipt: &ReceiptInput, band: &BandInput) -> Self

Build the key for one band of one receipt.

pub fn refuse_cripple(&self) -> Result<(), String>

§5.3 — a comparator serving one request at a time is not serving the band. Checked on its own so a key can be rejected before it is compared with anything.

Errors

When n_batch == Some(1).

pub fn refuse_mismatch(&self, other: &Self) -> Result<(), String>

PP-22 — refuse the join, naming every differing field.

All of them, not the first: a caller told only “band differs” re-runs, discovers the window differs too, and re-runs again. Both keys are also checked for the -b 1 cripple.

Errors

When any field differs, or when either key is a -b 1 comparator.

Trait Implementations

impl Clone for JoinKey

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JoinKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JoinKey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for JoinKey

impl Hash for JoinKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for JoinKey

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for JoinKey

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for JoinKey