filecoin-project/filecoin-pin

feat: add `filecoin-pin get` retrieval command

Open

#575 geöffnet am 15. Juni 2026

Auf GitHub ansehen
 (8 Kommentare) (1 Reaktion) (1 zugewiesene Person)TypeScript (18 Forks)github user discovery
CLIenhancementhelp wantedready-for-workteam/filecoin-pinteam/fs-wg

Repository-Metriken

Stars
 (22 Stars)
PR-Merge-Metriken
 (PR-Metriken ausstehend)

Beschreibung

Description

After a successful upload, filecoin-pin gives the user a CID and retrieval URLs but has no way to fetch content itself. Users must switch to Kubo, a browser, or curl to retrieve what they just stored. This breaks the upload-store-retrieve loop. A tool that can pin should also be able to retrieve. SP retrieval URLs work over plain HTTP and don't require IPFS routing, so a get command doesn't depend on IPNI being ready.

Proposed solution

Add filecoin-pin get <cid>/<pieceCid> that fetches content from the SP retrieval URL. Support -O <filename> to write output to a file (mirroring curl -O). Accept both IPFS CID and Piece CID. Default to stdout so it composes with pipes.

Done criteria

  • filecoin-pin get <ipfs-cid> streams file content from the SP retrieval URL
  • filecoin-pin get <cid> -O <filename> writes output to disk
  • Works without IPNI being ready (fetches directly from SP, not via gateway)
  • Piece CID accepted as an alternative to IPFS CID
  • Error message is actionable when CID is not retrievable

Notes

  • Implementation: wrap verified-fetch

Contributor Guide

Research-Richtung
Untersuche die vorhandene filecoin pin Codebasis, insbesondere wie der Upload funktioniert und wie verified fetch verwendet wird. Verstehe das Format der SP Abruf URL und implementiere einen get Befehl, der Inhalte auf stdout oder in eine Datei streamt. Siehe die verified fetch Dokumentation zum Abrufen von Inhalten.
Tech Stack
typescript
Domain
backendcli
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Halber Tag
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Aktiv
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
GitTypeScriptIPFS/Filecoin basics
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
60