search

ipld / specs

Content-addressed, authenticated, immutable data structures
Other
592 stars 108 forks source link

Docs: clarify Node addressing and multi-node blocks in FOUNDATIONS.md #285

Closed burdiyan closed 3 years ago

burdiyan commented 3 years ago

https://github.com/ipld/specs/blob/master/FOUNDATIONS.md says that Blocks have CID, and that Link is a type of Node that points to other Node. But it never specifies how Nodes are actually addressed (please correct me if I'm wrong).

I've read some things about the idea of storing multiple IPLD Nodes in a single Block, but as of right now looks like it's not the reality, since everywhere in IPFS and existing libraries Blocks and Nodes are more or less interchangeable, besides the fact that Blocks are just bytes, and Nodes are structured objects.

I suggest to add some clarification in FOUNDATIONS.md about the way IPLD Nodes are addressed, how multiple IPLD Nodes are laid out in a single Block, and how IPLD Nodes can link across Multi-Node Blocks.

burdiyan commented 3 years ago

I don't know how could I have missed this in FOUNDATIONS.md:

"NOTE: We don't currently support arbitrary paths but, in the context of programming, we really need to."