Skip to content

Add guide about content addressing data sets#2262

Open
2color wants to merge 18 commits intomainfrom
content-addressing-folders
Open

Add guide about content addressing data sets#2262
2color wants to merge 18 commits intomainfrom
content-addressing-folders

Conversation

@2color
Copy link
Member

@2color 2color commented Mar 6, 2026

Describe your changes

This is a new comparison guide of UnixFS, iroh collections, and DASL/MASL for content addressing directories of files, covering overhead, determinism, subsetting, and ecosystem support.

After spending a lot of time comparing the three for a different use case, I thought it would be useful to share these insights, and embrace the plurality of the IPFS ecosystem.

Checklist before merging

  • Passing all required checks (The beta Check Markdown links for modified files check is not required)

@github-actions
Copy link
Contributor

github-actions bot commented Mar 6, 2026

🚀 Build Preview on IPFS ready

@2color 2color force-pushed the content-addressing-folders branch from 41b88fb to 38077b0 Compare March 6, 2026 13:36
@2color
Copy link
Member Author

2color commented Mar 6, 2026

  • Add more references to other pages like the lifecycle
  • add a whole opening section about the more abstract notion of a Merkle proof with link to protoschool. Use analogy of club bouncer who has the root hash and each person who has proof of name with real world ID, and the Merkle path to the root.

@2color 2color requested review from lidel and vmx March 6, 2026 18:53
@2color 2color changed the title Add guide about content addressing folder Add guide about content addressing data sets Mar 18, 2026
**[MASL](https://dasl.ing/masl.html)** is a CBOR-based metadata system built on DRISL, designed for content-addressed and decentralized systems. It operates in two modes:

- **Single mode** (`src`): wraps one resource with metadata (content type, etc.)
- **Bundle mode** (`resources`): maps file paths to resource CIDs with per-file metadata — essentially a directory representation
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **Bundle mode** (`resources`): maps file paths to resource CIDs with per-file metadata — essentially a directory representation
- **Bundle mode** (`resources`): maps file paths to resource CIDs with per-file metadata — essentially a logical unit representation, i.e. all the paths on a given domain apex (including nested ones)

not exactly a directory, can contain many directories included nested ones or none. more like a map of [pathed] relrefs to resources.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I edited it. See the latest version

Copy link
Collaborator

@bumblefudge bumblefudge left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

modulo tweaks

2color and others added 5 commits March 18, 2026 18:07
Co-authored-by: Bumblefudge <bumblefudge@learningproof.xyz>
Co-authored-by: Mosh <1306020+mishmosh@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants