Include IPNS Record in Gateway CAR responses
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
- Issue 类型
- 功能
- 描述清晰度
- 需要澄清
- 活跃度
- 停滞
调研方向
先从 Trustless Gateway 规范以及链接的 IPIP-351、IPIP-402 和 IPIP-412 材料开始,然后审查 issue 中提议的 record-first CAR 结构。解决有关 CAR roots 和 request signaling 的未决问题,并定义 Trustless Gateway 和 Kubo 所需的 content-path import/export 行为;当规范和实现范围不再含糊时,即视为完成。
由索引模型根据 Issue 内容生成。
描述
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.
- 主要语言
- HTML
- 星标
- 1.2k
- 派生
- 250
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
ipfs/specs 的其他 Issue
-
need/triage
难度 2/5 1-3 小时 新手友好度 68/100
-
need/triage
难度 5/5 一周以上 新手友好度 30/100
-
dnslink:// URIs未关闭need/triage
难度 5/5 一周以上 新手友好度 30/100
-
难度 5/5 一周以上 新手友好度 35/100
-
need/triage
难度 3/5 1-2 天 新手友好度 55/100
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 85/100
ash-project/ash#3127 ·
维护者通常 1 天内回复
-
bug(core): JsonOutputKeyToolsParser ignores returnId: true可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭bug
难度 2/5 1-3 小时 新手友好度 68/100
langchain-ai/langchainjs#12239 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
paperclipai/paperclip#21837 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 66/100
sio2project/oioioi#981 · 1 个 reaction ·
维护者通常 1 天内回复
-
good first issue
难度 1/5 1-3 小时 新手友好度 88/100
ImFelipeOliveira/standcast#217 ·
维护者通常 1 天内回复