SHARE
TWEET

Untitled

a guest Oct 21st, 2019 85 Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
  1. # Basic information around IPFS pinning APIs
  2.  
  3. Braindump from @hsanjuan
  4.  
  5. -----
  6.  
  7. Data around pins (depending on where you are pinning, a pin has additional data attached):
  8.  
  9. - The root CID (always)
  10. - Type
  11. - Name or description? (Cluster for example)
  12. - Replication factors and other options (Cluster)
  13. - Duration / Cost / Submitted (I guess pinning services track how long something was pinned to bill the cost)
  14. - Any metadata/tags (Cluster, Pinata I think too)
  15. - Status (pinning/error/pinned)
  16. - Progress (in number of DAG nodes pinned, as there is no general way to know the total % of a DAG (in unixfs DAGs yes, but this is not used))
  17.  
  18. ------
  19.  
  20. Pinning process:
  21.  
  22. - Sync: the user needs to wait until it is pinned (ipfs)
  23. - Async: the user submits the pin (cluster, other pinning services?) and the service pins in the background (potential callback informs the user when process done (i.e. in pinbots))
  24.  
  25. -----
  26.  
  27. Pin types:
  28.  
  29. * ipfs has 3 pin types: recursive, direct, indirect
  30. * The users mostly use/worry about recursive and that's what most tools do (pinning services, pinbots etc)
  31. * Cluster has a few types of pins (the normal one translates to a recursive one on IPFS, but there are also other to support sharded pins)
  32.  
  33. -----
  34.  
  35. Pin meaning:
  36.  
  37. - In IPFS it is a DAG (recursive-pins, as identified by its root CID) or a block (direct pins), to not be removed during Garbage Collection (GC)
  38. - Anywhere else it is a DAG to be "stored". Out of all the things that pin, the only one that has GC is IPFS. Thus a pin has just mostly come to mean "Merkle-DAG". List my pins ~=~ List my Merkle-DAGs.
  39. - The PINSET would be the list of pins.
  40.  
  41. -----
  42.  
  43. Common questions when pinning that ipfs ecosystem is bad at answering:
  44.  
  45. - Is it pinned?
  46. - How long will it take?
  47. - How big is this pin?
  48.  
  49. -----
RAW Paste Data
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy. OK, I Understand
 
Top