Skip to content

IPFS Pinning

Jump to bottom
Violet Forest edited this page Jun 22, 2021 · 40 revisions

Your OBJKTs are uploaded to The Interplanetary File System, or IPFS. The tezos contract stores the IPFS hash and a reference to IPFS metadata with information like title and description (example).

What is IPFS and why is IPFS pinning important?

"The Interplanetary File System, or IPFS, is a distributed storage network made up of “nodes” or computers all over the world where people and apps are storing and sharing data. When an IPFS node retrieves data from the network it keeps a local cache of that data for future usage, taking up space on that particular IPFS node. IPFS nodes frequently clear this cache out in order to make room for new content..." —source

Why does data on IPFS need to be pinned?

According to IPFS, "IPFS has a fairly aggressive caching mechanism that will keep an object local for a short time after you perform any IPFS operation on it, but these objects may get garbage-collected regularly. To prevent that garbage collection, simply pin the CID you care about". —source

Does H=N pin my OBJKTs for me?

Metadata & OBJKT files are uploaded with Infura (see github code here), Infura automatically pins the data (source), then they're downloaded from ipfs.io, cloudflare or pinata public gateways (see github code here).

Do I need to pin my own OBJKTs?

This is a personal decision. Since H=N pins content for you, you could say that it is safe, but some people would prefer to be in control of their data. For the very long-term, it is important to understand that you are responsible for the artwork as an artist and/or collector. It is also important to keep in mind the idea of "content persistence". You can read a good article regarding content persistence by Filecoin blog here.

"When you “pin” data on an IPFS node, you are telling that node that the data is important and it should be saved. Pinning prevents important data from being deleted from your node when the clearing process happens. However, you can only control and pin data on your node(s). You can not force other nodes on the IPFS network to pin your content for you. So, to guarantee your content stays pinned, you have to run your own IPFS nodes." — source

To run your own node, you can use the following Tools/Guides:

IPFS Pinning

Further Reading

Please use the sidebar to navigate (on mobile its at the bottom of the page)

Want to contribute to the wiki? Please see How to contribute to the Wiki?

Minting Guide

FAQs

Misc

Clone this wiki locally