Change UnixFS dag-pb protobuf field ordering
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 35/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Tranquilla
- Ambito
- distributed-systems, documentation
Direzione di ricerca
Inizia leggendo la specifica collegata del formato di serializzazione dag-pb e i riferimenti alle pull request IPIP-499 e specs per comprendere il contesto di compatibilità e dei profili. Il lavoro è completato quando la proposta di ordinamento, le sue implicazioni per il wire format e qualsiasi percorso di aggiornamento a unixfs-v1-2026 sono chiaramente specificati e accettati.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
The .proto definition of a PBNode is this (spec):
message PBNode {
// refs to other objects
repeated PBLink Links = 2;
// opaque user data
optional bytes Data = 1;
}
Implementations are expected to write the repeated Links messages to the output buffer first, then the Data field, even though the field IDs are ordered the opposite way (not disallowed by the protobuf spec, though some off the shelf encoders will write in ID order).
When the PBNode represents a directory, the Links objects could be either flat directory entries, or HAMT shard entries - the information needed to ascertain this is contained in the Data field.
This means when processing an incoming PBNode message, we typically read all of the Links, and then use the Data to decide how to process them.
If we are performing a graph traversal, a streaming parser would let us process the PBNode message as it arrives, and to select the Link message we wish to traverse through or resolve to, however this is not currently possible since we need to process the Data field before we can return a Link. This can add significant overhead when there are many thousands of Links.
We should allow ordering the Data field first, this would enable the streaming use-case and help with IPFS code running in resource-constrained environments such as web browsers.
Since IPIP-499 we now have CID profiles which could be an upgrade path for the network. This proposal could be part of a unixfs-v1-2026 profile.
- Lingua principale
- HTML
- Stelle
- 1.2k
- Fork
- 250
- Metriche di merge delle PR
- Nessuna PR unita negli ultimi 30g
Preparare l'ambiente
Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di ipfs/specs
-
Simplify Spec StatusesApertaneed/triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
need/triage
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
-
dnslink:// URIsApertaneed/triage
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 35/100
-
need/triage
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
volcano-sh/volcano#6323 ·
I maintainer di solito rispondono entro 1 giorno
-
area: facilitator bug complexity: trivial
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
accensa/x402-facilitator-stellar#709 ·
I maintainer di solito rispondono entro 1 giorno
-
resiliency: ParseRetryConditionMatch fails when HTTPStatusCodes or GRPCStatusCodes contain whitespaceForse già presa @patelshivani2283-lab l’ha presa 1 giorno fa. Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno
-
[Bug] maxConcurrent{Activity,Workflow,Nexus}TaskPolls are accepted but never appliedForse già presa @pcbeingused333 l’ha presa 1 giorno fa. Apertasdk-typescript
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
temporalio/sdk-typescript#2693 ·
I maintainer di solito rispondono entro 1 giorno