Skip to content

Commit 104ede9

Browse files
committed
docs: changelog
1 parent 61e592a commit 104ede9

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

docs/changelogs/v0.35.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,11 @@ The WebUI, accessible at http://127.0.0.1:5001/webui/, now includes support for
4848
4949
#### Enhanced DAG-Shaping Controls for `ipfs add`
5050

51-
This release advances CIDv1 support by introducing fine-grained control over UnixFS DAG shaping during data ingestion with the `ipfs add` command. Kubo now allows users to customize the maximum number of links in per UnixFS block/chunk.
51+
This release advances CIDv1 support by introducing fine-grained control over UnixFS DAG shaping during data ingestion with the `ipfs add` command.
52+
53+
Wider DAG trees (more links per node, higher fanout, larger thresholds) are beneficial for large files and directories with many files, reducing tree depth and lookup latency in high-latency networks, but they increase node size, straining memory and CPU on resource-constrained devices. Narrower trees (lower link count, lower fanout, smaller thresholds) are preferable for smaller directories, frequent updates, or low-power clients, minimizing overhead and ensuring compatibility, though they may increase traversal steps for very large datasets.
54+
55+
Kubo now allows users to act on these tradeoffs and customize the width of the DAG created by `ipfs add` command.
5256

5357
##### New `ipfs add` Options
5458

@@ -69,13 +73,13 @@ You can set default values for these options using the following configuration s
6973

7074
##### Updated Configuration Profiles
7175

72-
The release updated configuration [profiles](https://github.com/ipfs/kubo/blob/master/docs/config.md#profile) to incorporate these new `Import.*` settings:
76+
The release updated configuration [profiles](https://github.com/ipfs/kubo/blob/master/docs/config.md#profiles) to incorporate these new `Import.*` settings:
7377
- Updated Profile: `test-cid-v1` now includes current defaults as explicit `Import.UnixFSFileMaxLinks=174`, `Import.UnixFSDirectoryMaxLinks=0`, `Import.UnixFSHAMTDirectoryMaxFanout=256` and `Import.UnixFSHAMTDirectorySizeThreshold=256KiB`
7478
- New Profile: `test-cid-v1-wide` adopts experimental directory DAG-shaping defaults, increasing the maximum file DAG width from 174 to 1024, HAMT fanout from 256 to 1024, and raising the HAMT directory sharding threshold from 256KiB to 1MiB, aligning with 1MiB file chunks.
7579
- Feedback: Try it out and share your thoughts at [discuss.ipfs.tech/t/should-we-profile-cids](https://discuss.ipfs.tech/t/should-we-profile-cids/18507) or [ipfs/specs#499](https://github.com/ipfs/specs/pull/499).
7680

7781
> [!TIP]
78-
> Apply the modern CIDv1 test profile with `ipfs config profile apply test-cid-v1-wide`.
82+
> Apply one of CIDv1 test [profiles](https://github.com/ipfs/kubo/blob/master/docs/config.md#profiles) with `ipfs config profile apply test-cid-v1[-wide]`.
7983
8084
#### 📦️ Important dependency updates
8185

0 commit comments

Comments
 (0)