OHTTP keys should be rotated

This pr addresses #445. It implements OHTTP-key rotation to payjoin-mailroom
Mailroom operators can now decide the time interval for keys to be rotated.
Also if a key has expired, a 422 error is returned to clients. Clients can
handle they key-rotation via the cach-control header returned by the directory.

set rotation grace to 7 days

Author: zealsham

Cargo-minimal.lock

@@ -2860,6 +2860,7 @@ dependencies = [
  "hex-conservative 0.1.1",
  "http",
  "http-body-util",
+ "httpdate",
  "hyper",
  "hyper-rustls",
  "hyper-util",

Cargo-recent.lock

@@ -2954,6 +2954,7 @@ dependencies = [
  "hex-conservative 0.1.2",
  "http",
  "http-body-util",
+ "httpdate",
  "hyper",
  "hyper-rustls",
  "hyper-util",

payjoin-mailroom/Cargo.toml

@@ -40,6 +40,7 @@ futures = "0.3.21"
 hex = { package = "hex-conservative", version = "0.1.1" }
 http = "1.3.1"
 http-body-util = "0.1.3"
+httpdate = "1.0.3"
 hyper = { version = "1.8.0", features = ["http1", "http2", "server"] }
 hyper-rustls = { version = "0.27.7", default-features = false, features = [
   "webpki-roots",

payjoin-mailroom/src/config.rs

@@ -12,6 +12,8 @@ pub struct Config {
     pub storage_dir: PathBuf,
     #[serde(deserialize_with = "deserialize_duration_secs")]
     pub timeout: Duration,
+    #[serde(deserialize_with = "deserialize_key_epoch_duration_secs")]
+    pub ohttp_keys_max_age: Option<Duration>,
     #[serde(deserialize_with = "deserialize_duration_secs")]
     pub mailbox_ttl: Duration,
     pub v1: Option<V1Config>,
@@ -87,6 +89,7 @@ impl Default for Config {
             listener: "[::]:8080".parse().expect("valid default listener address"),
             storage_dir: PathBuf::from("./data"),
             timeout: Duration::from_secs(30),
+            ohttp_keys_max_age: None, //Some(Duration::from_secs(30)),
             mailbox_ttl: Duration::from_secs(60 * 60 * 24 * 7), // 1 week
             v1: None,
             #[cfg(feature = "telemetry")]
@@ -107,17 +110,42 @@ where
     Ok(Duration::from_secs(secs))
 }
 
+fn deserialize_key_epoch_duration_secs<'de, D>(
+    deserializer: D,
+) -> Result<Option<Duration>, D::Error>
+where
+    D: serde::Deserializer<'de>,
+{
+    let secs: Option<u64> = Option::deserialize(deserializer)?;
+    let minimum = crate::directory::ROTATION_GRACE.saturating_mul(2);
+    match secs {
+        None => Ok(None),
+        Some(s) => {
+            let duration = Duration::from_secs(s);
+            if duration <= minimum {
+                return Err(<D::Error as serde::de::Error>::custom(format!(
+                    "ohttp_keys_max_age must be greater than {} seconds when set",
+                    minimum.as_secs()
+                )));
+            }
+            Ok(Some(duration))
+        }
+    }
+}
+
 impl Config {
     pub fn new(
         listener: ListenerAddress,
         storage_dir: PathBuf,
         timeout: Duration,
+        ohttp_keys_max_age: Option<Duration>,
         v1: Option<V1Config>,
     ) -> Self {
         Self {
             listener,
             storage_dir,
             timeout,
+            ohttp_keys_max_age,
             mailbox_ttl: Duration::from_secs(60 * 60 * 24 * 7), // 1 week
             v1,
             #[cfg(feature = "telemetry")]