From 0b74b8dff27c0b1f55ee651290533852a228d9d2 Mon Sep 17 00:00:00 2001 From: Dominic Reed Date: Thu, 20 Nov 2025 13:24:16 -0800 Subject: [PATCH 1/2] max manifest docs --- schema/OpenTDF/manifest.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/schema/OpenTDF/manifest.md b/schema/OpenTDF/manifest.md index c9ce227..5b580df 100644 --- a/schema/OpenTDF/manifest.md +++ b/schema/OpenTDF/manifest.md @@ -15,6 +15,10 @@ The manifest object contains the following top-level properties: | `encryptionInformation` | Object | Contains details about encryption, key access, integrity, and policy. See [Encryption Information Object](./encryption_information.md). | Yes | | `assertions` | Array | Optional array of verifiable statements about the TDF or payload. See [Assertions Array](./assertion.md). | No | +### Manifest Size Considerations + +The number of entries in the `integrityInformation.segments` array directly determines the manifest size. As segment count increases, manifest size grows proportionally. For example, a 1 TB TDF file with 1 MB segments will result in approximately one million segment entries in the manifest, which can make the manifest extremely large. To manage manifest size, you can either increase the segment size to reduce the number of segments, or adjust the maximum allowed manifest size in your implementation or SDK configuration. + ## Full Manifest Example This example illustrates a complete `manifest.json` structure. Links point to detailed descriptions of each major section. @@ -102,4 +106,4 @@ This example illustrates a complete `manifest.json` structure. Links point to de } } ] -} \ No newline at end of file +} From eb9b24874fc8f8f0f62a94bc9bbfc978ef00aa0b Mon Sep 17 00:00:00 2001 From: dominic reed Date: Fri, 21 Nov 2025 09:50:01 -0800 Subject: [PATCH 2/2] Update schema/OpenTDF/manifest.md Co-authored-by: Dave Mihalcik --- schema/OpenTDF/manifest.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/schema/OpenTDF/manifest.md b/schema/OpenTDF/manifest.md index 5b580df..024707c 100644 --- a/schema/OpenTDF/manifest.md +++ b/schema/OpenTDF/manifest.md @@ -17,7 +17,7 @@ The manifest object contains the following top-level properties: ### Manifest Size Considerations -The number of entries in the `integrityInformation.segments` array directly determines the manifest size. As segment count increases, manifest size grows proportionally. For example, a 1 TB TDF file with 1 MB segments will result in approximately one million segment entries in the manifest, which can make the manifest extremely large. To manage manifest size, you can either increase the segment size to reduce the number of segments, or adjust the maximum allowed manifest size in your implementation or SDK configuration. +For larger payloads, the number of entries in the `integrityInformation.segments` array directly determines the manifest size. As segment count increases, the `integrityInformation` length grows proportionally. With the default settings, a 1 TB TDF file with 1 MB segments will result in approximately one million segment entries in the manifest. Some SDKs impose maximum length limits on the manifest. To avoid problems with very large payloads, either configure your client to allow larger manifest sizes or to encrypt with larger segment lengths. ## Full Manifest Example