Include IPNS Record in Gateway CAR responses
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 25/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Cần làm rõ
- Mức độ hoạt động
- Đình trệ
- Lĩnh vực
- backend-api-design, documentation
Hướng nghiên cứu
Bắt đầu với đặc tả Trustless Gateway và các tài liệu IPIP-351, IPIP-402 và IPIP-412 được liên kết, sau đó xem xét dạng CAR record-first được đề xuất trong issue. Giải quyết các câu hỏi còn bỏ ngỏ về các CAR root và request signaling, đồng thời xác định hành vi import/export content-path bắt buộc của Trustless Gateway và Kubo; công việc được xem là hoàn tất khi đặc tả và phạm vi triển khai không còn mơ hồ.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
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.
- Ngôn ngữ chính
- HTML
- Star
- 1.2k
- Fork
- 250
- Chỉ số merge pull request
- Không có pull request nào được merge trong 30 ngày
Chuẩn bị môi trường
Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của ipfs/specs
-
Simplify Spec StatusesĐang mởneed/triage
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
-
Revise steward and editor rolesĐang mởneed/triage
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 30/100
-
dnslink:// URIsĐang mởneed/triage
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 30/100
-
Độ khó 5/5 Hơn một tuần Mức phù hợp với người mới 35/100
-
need/triage
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 55/100
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 85/100
ash-project/ash#3127 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug(core): JsonOutputKeyToolsParser ignores returnId: trueCó thể đã có người làm Có pull request liên kết đang mở hoặc đã được merge. Đang mởbug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
langchain-ai/langchainjs#12239 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Board view: the Monitoring column is always empty because compact issue rows drop displayStatusĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 88/100
paperclipai/paperclip#21837 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 66/100
sio2project/oioioi#981 · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 88/100
ImFelipeOliveira/standcast#217 ·
Maintainer thường phản hồi trong vòng 1 ngày