@blockcast/mmt-container 1.0.1 → 2.0.0

package/test-vectors/catalog/README.md

@@ -35,15 +35,31 @@ The negatives:
   an endpoint `relayAddress` is retired and rejected (`multicast_relay_address`),
   not ignored.
 - `multicast-auth-*.json`, `multicast-endpoint-protocol-*.json`,
+  `multicast-endpoint-address-*.json`,
   `multicast-endpoint-foreign-namespace-track.json`: the
-  draft-ramadan-moq-multicast-01 4.1 / 7.2.6 rules (BLO-49770, draft pinned at
-  Blockcast/moqcast-draft@fd962fd73d21ed281b60219c11ea61cc9e4e91c4). Each is one
-  mutation of a positive. `src/catalog-schema.test.ts` pins the schema keyword
-  and the runtime code and path of each (`multicastRuntimeExpectations`), and
-  that the transport receiver ignores exactly the endpoint it names. Four of
-  them the schema cannot state and accepts: a repeated `kid`, a repeated
-  `firstEpoch`, a `manifestPort` equal to a port of its `(S, G)`, and a track
-  declaring a foreign namespace. `multicast-auth-root-dotted-key.json`,
+  draft-ramadan-moq-multicast-02 4.1 / 7.2.6 rules (BLO-51622, draft pinned at
+  Blockcast/moqcast-draft@5f49172). Each is one mutation of a positive.
+  `src/catalog-schema.test.ts` pins the schema keyword and the
+  `multicastCatalogIssues` code and path of each
+  (`multicastRuntimeExpectations`), that `validateCmsfMmtpCatalog` does not
+  throw on any of them (a receiver ignores the endpoint, or admits no multicast
+  data on a catalog-level fault, and MoQ unicast stays usable), and that the
+  transport receiver ignores exactly the endpoints it names. Records ride in
+  band on the flow's own `port` (7.2.3), so `multicast-auth-draft01-manifest-port.json`
+  is a draft -01 catalog whose endpoint `auth` still names its record port: an
+  unknown member, so the endpoint is ignored (libmmt policy, failing closed;
+  the posted 7.2.6 states no unknown-member rule). The schema cannot state, and
+  accepts: a repeated `kid`, a repeated `firstEpoch`, two protected endpoints
+  on one `(S, G, port)` (`multicast-auth-shared-sg-port.json`, spelled
+  differently, compared as addresses), the address-literal and address-family
+  rules (a leading-zero dec-octet in a dotted quad or an ls32 tail, a host
+  name, a zone id, mixed families, an IPv4-mapped source counting as IPv6),
+  and a track declaring a foreign namespace. A receiver clamps a
+  `maxAuthDelayMs` outside 50..1000 and reads a non-number as absent, so
+  `positive/multicast-auth-max-auth-delay-{below-min,above-max}-clamped.json`
+  and `positive/multicast-auth-max-auth-delay-string.json` are positives;
+  `positive/multicast-auth-asm-sender.json` is an ASM pair sharing G and port
+  with different `senderAddress`. `multicast-auth-root-dotted-key.json`,
   `multicast-auth-padded-key.json`, `multicast-auth-reused-track-format.json`
   and `multicast-auth-trailing-pad-bits.json` are draft -00 root-key blocks kept
   as negative controls: the root `"multicast.auth"` key itself is refused.

package/test-vectors/catalog/negative/multicast-auth-asm-missing-sender-address.json

@@ -51,7 +51,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 1
         }
       },
@@ -67,7 +66,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2,
           "senderAddress": "198.51.100.8"
         }

package/test-vectors/catalog/negative/{multicast-auth-manifest-port-equals-port.json → multicast-auth-draft01-manifest-port.json}

@@ -44,7 +44,7 @@
           }
         ],
         "auth": {
-          "manifestPort": 5004,
+          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-duplicate-first-epoch.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-duplicate-kid.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-endpoint-auth-without-object-auth.json

@@ -26,7 +26,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-endpoint-missing-bandwidth.json

@@ -43,7 +43,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-manifest-timer-out-of-range.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 0,

package/test-vectors/catalog/negative/multicast-auth-sender-address-on-ssm.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-shared-sg-port.json

@@ -0,0 +1,73 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "2001:db8::7",
+        "groupAddress": "ff3e::10:20:30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      },
+      {
+        "sourceAddress": "2001:DB8:0::0007",
+        "groupAddress": "FF3E:0::10:20:30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434398,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-auth-version-1.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-version-3.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-auth-version-missing.json

@@ -43,7 +43,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/negative/multicast-endpoint-address-family-mismatch.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "198.51.100.7",
+        "groupAddress": "ff3e::10:20:30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-endpoint-address-host-name.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "sender.example.net",
+        "groupAddress": "232.10.20.30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-endpoint-address-leading-zero.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "198.51.100.07",
+        "groupAddress": "232.10.20.30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-endpoint-address-ls32-leading-zero.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "::ffff:198.51.100.07",
+        "groupAddress": "ff3e::10:20:30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-endpoint-address-mapped-family-mismatch.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "::ffff:198.51.100.7",
+        "groupAddress": "232.10.20.30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/negative/multicast-endpoint-address-zone-id.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "fe80::7%eth0",
+        "groupAddress": "ff3e::10:20:30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": 200,
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/positive/multicast-auth-asm-sender.json

@@ -51,7 +51,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 1,
           "senderAddress": "198.51.100.7"
         }
@@ -68,7 +67,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2,
           "senderAddress": "198.51.100.8"
         }

package/test-vectors/catalog/{negative/multicast-auth-max-auth-delay-above-max.json → positive/multicast-auth-max-auth-delay-above-max-clamped.json}

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 1001,
           "manifestTimerMs": 20,

package/test-vectors/catalog/{negative/multicast-auth-max-auth-delay-below-min.json → positive/multicast-auth-max-auth-delay-below-min-clamped.json}

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 49,
           "manifestTimerMs": 20,

package/test-vectors/catalog/positive/multicast-auth-max-auth-delay-string.json

@@ -0,0 +1,55 @@
+{
+  "version": 1,
+  "streamingFormat": "mmtp",
+  "streamingFormatVersion": "draft-ramadan-moq-mmt-01",
+  "tracks": [
+    {
+      "name": "video",
+      "packaging": "mmtp",
+      "codec": "avc1.640028",
+      "mmtpMode": "mfu",
+      "timescale": 90000,
+      "groupDurationMs": 1000
+    }
+  ],
+  "multicast": {
+    "auth": {
+      "scheme": "bc-provenance",
+      "version": 2,
+      "sig": "ed25519",
+      "keys": [
+        {
+          "kid": 1,
+          "publicKey": "A6EHv_POEL4dcN0Y50vAmWfk1jCbpQ1fHdyGZBJVMbg",
+          "firstEpoch": 1
+        },
+        {
+          "kid": 2,
+          "publicKey": "mm4Ae7fTOTrOb2d_zK9mlXVV2YgeBBvBncabOQRh1Z4",
+          "firstEpoch": 17
+        }
+      ],
+      "minEpoch": 17
+    },
+    "endpoints": [
+      {
+        "sourceAddress": "198.51.100.7",
+        "groupAddress": "232.10.20.30",
+        "port": 5004,
+        "bandwidth": 100000000,
+        "tracks": [
+          {
+            "name": "video",
+            "packetId": 1
+          }
+        ],
+        "auth": {
+          "streamId": 2864434397,
+          "maxAuthDelayMs": "300",
+          "manifestTimerMs": 20,
+          "manifestTrack": "video/manifest"
+        }
+      }
+    ]
+  }
+}

package/test-vectors/catalog/positive/multicast-auth-rotation.json

@@ -44,7 +44,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,

package/test-vectors/catalog/positive/multicast-draft01-7-2-6-example.json

@@ -62,7 +62,6 @@
           }
         ],
         "auth": {
-          "manifestPort": 5005,
           "streamId": 2864434397,
           "maxAuthDelayMs": 200,
           "manifestTimerMs": 20,