{
  "scenario": "valid",
  "title": "Valid signed request",
  "blurb": "Everything done correctly. Walk through this first — every other scenario is this one with a single thing broken.",
  "expect": "accept",
  "note": null,
  "request": {
    "method": "POST",
    "url": "https://ai.abhinava.xyz/api/merchant/checkout",
    "headers": {
      "content-type": "application/json",
      "Signature-Agent": "\"https://ai.abhinava.xyz\"",
      "Signature-Input": "sig1=(\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\"",
      "Signature": "sig1=:2XdQRjvbviRFcw0qgxGWFsLaT1/KCUczghH4IFuNE1I2zHKE8cW6dEEQ9ZaDilBGt6hfa80y8Jd+qsgxZj4iDw==:",
      "Content-Digest": "sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:"
    },
    "body": "{\n  \"order_id\": \"NW-48201\",\n  \"buyer\": \"agent://shopping-assistant\",\n  \"items\": [\n    {\n      \"sku\": \"NW-COFFEE-1KG\",\n      \"qty\": 2,\n      \"unit_price_cents\": 1850\n    }\n  ],\n  \"total_cents\": 3700,\n  \"currency\": \"USD\"\n}",
    "wireFormat": "POST /api/merchant/checkout HTTP/1.1\nHost: ai.abhinava.xyz\nContent-Type: application/json\nSignature-Agent: \"https://ai.abhinava.xyz\"\nSignature-Input: sig1=(\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\"\nSignature: sig1=:2XdQRjvbviRFcw0qgxGWFsLaT1/KCUczghH4IFuNE1I2zHKE8cW6dEEQ9ZaDilBGt6hfa80y8Jd+qsgxZj4iDw==:\nContent-Digest: sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:\n\n{\n  \"order_id\": \"NW-48201\",\n  \"buyer\": \"agent://shopping-assistant\",\n  \"items\": [\n    {\n      \"sku\": \"NW-COFFEE-1KG\",\n      \"qty\": 2,\n      \"unit_price_cents\": 1850\n    }\n  ],\n  \"total_cents\": 3700,\n  \"currency\": \"USD\"\n}"
  },
  "signing": {
    "signatureBase": "\"@method\": POST\n\"@authority\": ai.abhinava.xyz\n\"@path\": /api/merchant/checkout\n\"content-digest\": sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:\n\"signature-agent\": \"https://ai.abhinava.xyz\"\n\"@signature-params\": (\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\"",
    "components": [
      "@method",
      "@authority",
      "@path",
      "content-digest",
      "signature-agent"
    ],
    "params": {
      "created": 1795288871,
      "expires": 1795289171,
      "keyid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
      "alg": "ed25519",
      "nonce": "BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==",
      "tag": "web-bot-auth"
    },
    "signatureB64": "2XdQRjvbviRFcw0qgxGWFsLaT1/KCUczghH4IFuNE1I2zHKE8cW6dEEQ9ZaDilBGt6hfa80y8Jd+qsgxZj4iDw=="
  },
  "verification": {
    "ok": true,
    "reason": "verified",
    "steps": [
      {
        "name": "Headers present",
        "ok": true,
        "detail": "Signature-Agent, Signature-Input and Signature were all supplied.",
        "data": {
          "signature-agent": "\"https://ai.abhinava.xyz\"",
          "signature-input": "sig1=(\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\"",
          "signature": "sig1=:2XdQRjvbviRFcw0qgxGWFsLaT1/KCUczghH4IFuNE1I2zHKE8cW6dEEQ9ZaDilBGt6hfa80y8Jd+qsgxZj4iDw==:"
        }
      },
      {
        "name": "Parse Signature-Input",
        "ok": true,
        "detail": "Label \"sig1\" covering 5 component(s).",
        "data": {
          "components": [
            "@method",
            "@authority",
            "@path",
            "content-digest",
            "signature-agent"
          ],
          "params": {
            "created": 1795288871,
            "expires": 1795289171,
            "keyid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
            "alg": "ed25519",
            "nonce": "BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==",
            "tag": "web-bot-auth"
          }
        }
      },
      {
        "name": "Tag is web-bot-auth",
        "ok": true,
        "detail": "The signature was explicitly created for bot authentication, so it cannot be replayed from some other signing context.",
        "data": {
          "tag": "web-bot-auth"
        }
      },
      {
        "name": "Required components covered",
        "ok": true,
        "detail": "Covered: @method, @authority, @path, content-digest, signature-agent. Each of these is bound by the signature and cannot be changed without detection.",
        "data": {
          "covered": [
            "@method",
            "@authority",
            "@path",
            "content-digest",
            "signature-agent"
          ]
        }
      },
      {
        "name": "Freshness window",
        "ok": true,
        "detail": "Valid for another 300s (created=1795288871, expires=1795289171). Narrow windows limit how long a stolen request stays useful.",
        "data": {
          "created": 1795288871,
          "expires": 1795289171,
          "now": 1795288871,
          "remainingSeconds": 300
        }
      },
      {
        "name": "Nonce unused",
        "ok": true,
        "detail": "First time this nonce has been seen, so this is not a replay.",
        "data": {
          "nonce": "BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw=="
        }
      },
      {
        "name": "Resolve Signature-Agent",
        "ok": true,
        "detail": "The agent says its keys live at https://ai.abhinava.xyz. The merchant derives the well-known directory URL from that.",
        "data": {
          "agentUrl": "https://ai.abhinava.xyz",
          "directoryUrl": "https://ai.abhinava.xyz/.well-known/http-message-signatures-directory"
        }
      },
      {
        "name": "Fetch key directory",
        "ok": true,
        "detail": "Downloaded 1 public key(s) over TLS. Only public keys are ever published — the private key never leaves the agent.",
        "data": {
          "directoryUrl": "https://ai.abhinava.xyz/.well-known/http-message-signatures-directory",
          "keys": [
            {
              "kty": "OKP",
              "crv": "Ed25519",
              "x": "f3UghwVs1xi7L3KwdMrADqOJIkLUUqEYkzxF2I2PvPQ",
              "kid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
              "use": "sig",
              "nbf": 1794252051,
              "exp": 1825788051
            }
          ]
        }
      },
      {
        "name": "Match keyid to a published key",
        "ok": true,
        "detail": "keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\" equals the RFC 7638 SHA-256 thumbprint of a published key. The merchant recomputes this hash itself, so the agent cannot simply assert an identity — the key id is derived from the key material.",
        "data": {
          "keyid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
          "examined": [
            {
              "kid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
              "computedThumbprint": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
              "canonical": "{\"crv\":\"Ed25519\",\"kty\":\"OKP\",\"x\":\"f3UghwVs1xi7L3KwdMrADqOJIkLUUqEYkzxF2I2PvPQ\"}",
              "matches": true
            }
          ],
          "matchedJwk": {
            "kty": "OKP",
            "crv": "Ed25519",
            "x": "f3UghwVs1xi7L3KwdMrADqOJIkLUUqEYkzxF2I2PvPQ",
            "kid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
            "use": "sig",
            "nbf": 1794252051,
            "exp": 1825788051
          }
        }
      },
      {
        "name": "Body matches Content-Digest",
        "ok": true,
        "detail": "The received body hashes to sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:, matching the signed header. The merchant can now treat the order payload as authentic.",
        "data": {
          "received": "sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:",
          "recomputed": "sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:"
        }
      },
      {
        "name": "Reconstruct signature base",
        "ok": true,
        "detail": "The merchant rebuilds the signed bytes from the request as received — it never trusts a base supplied by the agent. If any covered value differs by one byte, the signature will not verify.",
        "data": {
          "signatureBase": "\"@method\": POST\n\"@authority\": ai.abhinava.xyz\n\"@path\": /api/merchant/checkout\n\"content-digest\": sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:\n\"signature-agent\": \"https://ai.abhinava.xyz\"\n\"@signature-params\": (\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\""
        }
      },
      {
        "name": "Verify Ed25519 signature",
        "ok": true,
        "detail": "Ed25519 verification PASSED. Only the holder of the private key matching this published public key could have produced this signature over these exact bytes.",
        "data": {
          "signatureBase": "\"@method\": POST\n\"@authority\": ai.abhinava.xyz\n\"@path\": /api/merchant/checkout\n\"content-digest\": sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:\n\"signature-agent\": \"https://ai.abhinava.xyz\"\n\"@signature-params\": (\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\"",
          "signatureB64": "2XdQRjvbviRFcw0qgxGWFsLaT1/KCUczghH4IFuNE1I2zHKE8cW6dEEQ9ZaDilBGt6hfa80y8Jd+qsgxZj4iDw=="
        }
      }
    ],
    "keyid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
    "jwk": {
      "kty": "OKP",
      "crv": "Ed25519",
      "x": "f3UghwVs1xi7L3KwdMrADqOJIkLUUqEYkzxF2I2PvPQ",
      "kid": "Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4",
      "use": "sig",
      "nbf": 1794252051,
      "exp": 1825788051
    },
    "agentUrl": "https://ai.abhinava.xyz",
    "directoryUrl": "https://ai.abhinava.xyz/.well-known/http-message-signatures-directory",
    "signatureBase": "\"@method\": POST\n\"@authority\": ai.abhinava.xyz\n\"@path\": /api/merchant/checkout\n\"content-digest\": sha-256=:LoJSigNwFOJWxdeVRvO+cUjG0mmjmCyMuxixoJJD0GE=:\n\"signature-agent\": \"https://ai.abhinava.xyz\"\n\"@signature-params\": (\"@method\" \"@authority\" \"@path\" \"content-digest\" \"signature-agent\");created=1795288871;expires=1795289171;keyid=\"Jefhp3Z9WcgR00fzrDaWOlMPpx_A2eVwgNiis-wlfO4\";alg=\"ed25519\";nonce=\"BZbmbuZRDVVLuCYCo23FDOHjziDHQTVRUPImVFtqHr2APzlUbmFbQJMKUksLnRklGkcp4la9kfsXWAkzBlO7xw==\";tag=\"web-bot-auth\""
  }
}