| date | permalink | title | description | author | header_image | tags | |||
|---|---|---|---|---|---|---|---|---|---|
2019-11-06 |
/2019-11-06-explore-the-files-api-on-protoschool/ |
Explore the Files API on ProtoSchool |
Teri Chadbourne |
/protoschool-course-ipfs-code.jpg |
|
Today we're excited to announce the launch of a brand new ProtoSchool tutorial exploring the Regular Files API, built by the awesome Gil Domingues. 🎉
This new tutorial explores the methods at the top-level of js-ipfs (add, get, cat, etc.) that are custom-built for working with files. We refer to these methods as the Regular Files API to distinguish them from the Mutable File System (MFS). MFS mimics a more traditional file system interface with methods like files.cp and files.mkdir, but it hides the complexity of immutable content addressing in IPFS. Check out the first lesson of the new tutorial for more on the differences between these two approaches, as well as some important distinctions between the Files API and the DAG API.
If you're new to IPFS and finding CIDs to be challenging as a naming convention, keep an eye out in this tutorial for an explanation of how you can use the wrapWithDirectory option in the Regular Files API to create more human-readable paths and filenames.
Like most of our tutorials, this latest addition uses JavaScript coding challenges to teach IPFS methods, allowing you to explore them right from your web browser without installing anything or touching the command line. Check out our other code-based IPFS tutorials on ProtoSchool:
- The Mutable File System (MFS) (part of the Files API)
- The DAG API: P2P Data Links with Content Addressing
- The DAG API: Blogging on the Decentralized Web
Our Decentralized Data Structures tutorial offers a code-free look at important concepts like content addressing and hashing.
Find a ProtoSchool chapter near you and attend a live workshop.
We're constantly working to improve and grow our ProtoSchool curriculum, and have lots of new content planned for you in the months ahead. You can help us improve our offereings by sharing your feedback on existing tutorials (using the links provided a the bottom of each lesson) or by building a new tutorial. (Our platform currently supports browser-based JavaScript coding challenges, text-based lessons, and multiple-choice quizzes.)
If you'd like to dig a little deeper, we recommend checking out the Understanding How IPFS Deals with Files course offered at IPFS Camp 2019. (No coding required.) It offers a deep dive on key concepts like immutability, content addressing, hashing, the anatomy of CIDs, what the heck a Merkle DAG is, and how chunk size affects file imports. It also covers the joys and pitfalls of the Mutable File System (MFS), the layer of abstraction in IPFS that lets you work with immutable files and directories as if you were using a traditional name-based file system. As with all great talks, this one is enhanced by images of adorable poodles. 🐩 (12 / 10, would recommend.)
Watch the recording below or check out the slides!
Video: Understanding How IPFS Deals with Files
This course also introduces new visualization tools that you can use to see how IPFS addresses and manipulates files:
- Paste a Content Identifier (CID) into the CID Inspector to break down its anatomy
- Drag a file into the DAG Builder and adjust chunk size, DAG layouts, etc. to see how it affects the Merkle DAG