Repository navigation
v0.37.0
Note
This release was brought to you by the Shipyard team.
What's Changed
Added
ipld/unixfs/io: addedSizeEstimationModefor configurable HAMT sharding threshold decisions. Supports legacy link-based estimation (SizeEstimationLinks), accurate block-based estimation (SizeEstimationBlock), or disabling size-based thresholds (SizeEstimationDisabled). #1088, IPIP-499ipld/unixfs/io: addedUnixFSProfilewithUnixFS_v0_2015andUnixFS_v1_2025presets for CID-deterministic file and directory DAG construction. #1088, IPIP-499files:NewSerialFileWithOptionsnow supports controlling whether symlinks are preserved or dereferenced before being added to IPFS. SeeSerialFileOptions.DereferenceSymlinks. #1088, IPIP-499
Changed
- 🛠
chunker,ipld/unixfs/importer/helpers: block size limits raised from 1MiB to 2MiB to match the bitswap spec. Max chunker size is2MiB - 256 bytesto leave room for protobuf framing when--raw-leaves=false. IPIP-499 profiles use lower chunk sizes (256KiB and 1MiB) and are not affected. - 🛠
chunker:DefaultBlockSizechanged fromconsttovarto allow runtime configuration via global profiles. #1088, IPIP-499 gateway: 🛠 ✨ IPIP-523?format=URL query parameter now takes precedence overAcceptHTTP header, ensuring deterministic HTTP cache behavior and allowing browsers to use?format=even when they sendAcceptheaders with specific content types. #1074gateway: 🛠 ✨ IPIP-524 codec conversions (e.g., dag-pb to dag-json, dag-json to dag-cbor) are no longer performed by default. Requesting a format that differs from the block's codec now returns HTTP 406 Not Acceptable with a hint to fetch raw blocks (?format=raw) and convert client-side. SetConfig.AllowCodecConversiontotrueto restore the old behavior. #1077gateway: compliance with gateway-conformance v0.10.0 (since v0.8: relaxed DAG-CBOR HTML preview cache headers, relaxed CAR 200/404 for missing paths, IPIP-523 format query precedence, IPIP-524 codec mismatch returns 406)- upgrade to
go-ipld-primev0.22.0 - upgrade to
go-libp2p-kad-dhtv0.38.0
Removed
tracing: opentelemetry zipkin exporter (go.opentelemetry.io/otel/exporters/zipkin) is deprecated and has been removed. It is recommended to switch to OTLP. Configure your application to send traces using OTLP and enable Zipkin’s OTLP ingestion support.
Fixed
- 🛠
ipld/unixfs/io: fixed HAMT sharding threshold comparison to use>instead of>=. A directory exactly at the threshold now stays as a basic (flat) directory, aligning behavior with code documentation and the JS implementation. This is a theoretical breaking change, but unlikely to impact real-world users as it requires a directory to be exactly at the threshold boundary. If you depend on the old behavior, adjustHAMTShardingSizeto be 1 byte lower. #1088, IPIP-499 ipld/unixfs/mod: fixed sparse file writes in MFS. Writing past the end of a file (e.g.,ipfs files write --offset 1000 /fileon a smaller file) would lose data becauseexpandSparsecreated the zero-padding node but didn't update the internal pointer. Subsequent writes went to the old unexpanded node.ipld/unixfs/io: fixed mode/mtime metadata loss during Basic<->HAMT directory conversions. Previously, directories withWithStat(mode, mtime)would lose this metadata when converting between basic and sharded formats, or when reloading a HAMT directory from disk.
Full Changelog: v0.36.0...v0.37.0
