From fcb3c236db46cdcb3ba5bba88e9d2b6ec7cd56be Mon Sep 17 00:00:00 2001 From: Marcin Rataj Date: Fri, 6 Feb 2026 01:37:41 +0100 Subject: [PATCH] docs: add IPLD Logical Format note to AllowCodecConversion --- docs/config.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/config.md b/docs/config.md index a938774d1..4d3a44bb8 100644 --- a/docs/config.md +++ b/docs/config.md @@ -1152,9 +1152,13 @@ When disabled (the default), the gateway returns `406 Not Acceptable` for codec mismatches, following behavior specified in [IPIP-524](https://github.com/ipfs/specs/pull/524). -**Recommended approach**: Instead of relying on gateway-side conversion, -fetch the raw block using `?format=raw` (`application/vnd.ipld.raw`) and -perform conversion client-side. This approach: +Most users should keep this disabled unless legacy +[IPLD Logical Format](https://web.archive.org/web/20260204204727/https://ipld.io/specs/codecs/dag-pb/spec/#logical-format) +support is needed as a stop-gap while switching clients to `?format=raw` +and converting client-side. + +Instead of relying on gateway-side conversion, fetch the raw block using +`?format=raw` (`application/vnd.ipld.raw`) and convert client-side. This: - Allows clients to use any codec without waiting for gateway support - Enables ecosystem innovation without gateway operator coordination