Include IPNS Record in Gateway CAR responses
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 25/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Necesita aclaración
- Estado de actividad
- Estancado
Línea de trabajo
Comienza con la especificación de Trustless Gateway y los materiales enlazados de IPIP-351, IPIP-402 e IPIP-412; después, revisa la estructura de CAR propuesta en el issue, basada primero en records. Resuelve las preguntas abiertas sobre las raíces de CAR y la señalización de requests, y define el comportamiento requerido de Trustless Gateway y Kubo para la importación y exportación de content-paths; el trabajo estará terminado cuando la especificación y el alcance de la implementación ya no sean ambiguos.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
IPIP-351: IPNS Signed Records Response Format on HTTP Gateways will return a raw IPNS record, allowing a custom light client to verify IPNS without having to run DHT client.
Users asked for the ability to export both CIDs and IPNS record into a CAR, transport over sneakernet and load this on airgapped node, which is a good use case.
Another use case is Decentralized Gateway WG, which could benefit from the ability to have a single round-trip that includes full or partial CAR with content + ipns-record.
Broad strokes UX we want to accommodate:
$ curl http://gateway.foo/ipns/{id}?format=car&something > ipns-site-dump.car
$ ipfs import ipns-site-dump.car # imaginary command that goes beyond DAGs
$ ipfs resolve /ipns/{id} # works, even in offline mode
$ ipfs dag stat /ipns/{id} # works, even in offline mode
Initial notes / subtasks
- need to add a new
ipns-recordcodec, to indicate special meaning of this additional block. Done: https://github.com/multiformats/multicodec/pull/312 - Extend Trustless Gateway spec to support verifiable responses of
/ipns/{libp2p-key}paths: decide if returned CAR should include two roots. One for data, second foripns-recordblock. Specify if ipfs-records should be at the beginning of the CAR returned by/ipns/{id}?format=car[&something?]- to allow quick validation of response without wasting time for hashing invalid blocks that do not belong to CID in IPNS record.-
?format=ipns-recordon/ipns/{key}landed in IPIP-351 (spec) - record inside the CAR response
-
- Kubo CLI should have top level
import/exportthat operates on content paths (instead of raw dags likeipfs dagversions), include all parent blocks and not just the final terminating element recursively, and be smart enough to useipns-recordand import it to local namesys cache if a block with ipns-record codec is present in a CAR
Status as of 2026Q3
Nobody is working on this. Summary of what exists and what is missing, so it can be picked up.
Trustless two-step retrieval works today, over plain HTTP:
GET /ipns/{name}?format=ipns-record(IPIP-351): the client verifies the signature and resolves the record to/ipfs/{cid}, or stops on mismatch.GET /ipfs/{cid}?format=carwithdag-scope,entity-bytesandorder=dfs(IPIP-402): the client verifies each block as it arrives and drops the connection on the first block that fails its hash or is not expected in the DAG.
What is missing is the single round trip. GET /ipns/{name}?format=car today returns the CAR of the resolved content without the record, so the client cannot verify the IPNS step from that response alone. The smallest useful shape: a CAR with the ipns-record block (codec 0x0300) first, then the IPIP-402 stream from the root the record points at. The client checks the record before hashing anything else and can drop the connection after the first bad block. Plain HTTP, no new protocol or transport needed.
Open questions, unchanged from the list above:
- CAR roots: only the record, only the data root, or both.
- Request signal: an explicit
formatvalue or a CAR content-type parameter (IPIP-412 style), so a client can tell a record-first CAR from a plain one served by an older gateway.
Kubo side: no content-path import/export exists, and ipfs dag import does not know the ipns-record codec.
- Lenguaje dominante
- HTML
- Estrellas
- 1.2k
- Forks
- 250
- Métricas de merge de PR
- Sin PR fusionados en 30 d
Preparar el entorno
Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de ipfs/specs
-
Simplify Spec StatusesAbiertoneed/triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
-
Revise steward and editor rolesAbiertoneed/triage
Dificultad 5/5 Más de una semana Aptitud para principiantes 30/100
-
dnslink:// URIsAbiertoneed/triage
Dificultad 5/5 Más de una semana Aptitud para principiantes 30/100
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
-
need/triage
Dificultad 3/5 1-2 días Aptitud para principiantes 55/100
Todos los issues de ipfs/specs
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 85/100
ash-project/ash#3127 ·
Los mantenedores suelen responder en 1 día
-
bug(core): JsonOutputKeyToolsParser ignores returnId: truePosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abiertobug
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
langchain-ai/langchainjs#12239 ·
Los mantenedores suelen responder en 1 día
-
Board view: the Monitoring column is always empty because compact issue rows drop displayStatusAbierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
paperclipai/paperclip#21837 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
sio2project/oioioi#981 · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
good first issue
Dificultad 1/5 1-3 horas Aptitud para principiantes 88/100
ImFelipeOliveira/standcast#217 ·
Los mantenedores suelen responder en 1 día