Skip to main content

protocol/
service.rs

1//! Chord `parseServiceCall` (packages/chord/src/services/wire.ts): the server rejects any request whose
2//! opaque `call` is not a strict service call before routing it.
3
4use crate::cbor::Value;
5
6#[derive(Debug, Clone, PartialEq)]
7pub struct ServiceCall {
8    pub service_id: String,
9    /// Keyed instance address: `(key, generation)`.
10    pub instance: Option<(String, i64)>,
11    pub member: String,
12    pub args: Vec<Value>,
13}
14
15fn strict(value: &Value, required: &[&str], optional: &[&str]) -> bool {
16    let Value::Map(entries) = value else { return false };
17    entries
18        .iter()
19        .all(|(k, _)| required.contains(&k.as_str()) || optional.contains(&k.as_str()))
20        && required.iter().all(|k| value.get(k).is_some())
21}
22
23fn id(value: Option<&Value>) -> Option<String> {
24    value?.as_str().filter(|s| !s.is_empty()).map(str::to_owned)
25}
26
27fn generation(value: Option<&Value>) -> Option<i64> {
28    match value? {
29        Value::Int(n) if *n >= 1 => Some(*n),
30        _ => None,
31    }
32}
33
34pub fn parse_service_call(value: &Value) -> Option<ServiceCall> {
35    if !strict(value, &["serviceId", "member", "args"], &["instance"]) {
36        return None;
37    }
38    let Some(Value::Array(args)) = value.get("args") else {
39        return None;
40    };
41    let instance = match value.get("instance") {
42        None => None,
43        Some(address) => {
44            if !strict(address, &["key", "generation"], &[]) {
45                return None;
46            }
47            Some((id(address.get("key"))?, generation(address.get("generation"))?))
48        }
49    };
50    Some(ServiceCall {
51        service_id: id(value.get("serviceId"))?,
52        instance,
53        member: id(value.get("member"))?,
54        args: args.clone(),
55    })
56}