Skip to content

Commit ae34255

Browse files
committed
ipip-402: remove mentions of ordered CARs for now
We have no spec for signaling this, we may add it as opt-in later #402 (comment) #402 (comment)
1 parent faf4a0b commit ae34255

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

src/http-gateways/path-gateway.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -594,10 +594,11 @@ The following response types require an explicit opt-in, can only be requested w
594594
- Raw Block (`?format=raw`)
595595
- Opaque bytes, see [application/vnd.ipld.raw](https://www.iana.org/assignments/media-types/application/vnd.ipld.raw).
596596
- CAR (`?format=car`)
597-
- A CAR file or a stream that contains all blocks required to trustless verify the expressed query, see [application/vnd.ipld.car](https://www.iana.org/assignments/media-types/application/vnd.ipld.car).
598-
- Must contain, as the very first block, the block that hashes to the content root CID
599-
- Must contain, immediately following the root block, all blocks encountered while traversing the expressed path in the order they were traversed
600-
- Must contain, immediately following traversed path blocks, appropriate blocks in depth first traversal order required to verify the query expressed at the terminus of the path in [query parameters](#query-parameters-for-car-requests)
597+
- A CAR file or a stream that contains all blocks required to trustlessly verify the requested content path query, see [application/vnd.ipld.car](https://www.iana.org/assignments/media-types/application/vnd.ipld.car) and :cite[trustless-gateway].
598+
- **Note:** by default, block order in CAR response is not deterministic,
599+
blocks can be returned in different order, depending on implementation
600+
choices (traversal, speed at which blocks arrive from the network, etc).
601+
An opt-in ordered CAR responses MAY be introduced in a future IPIP.
601602
- TAR (`?format=tar`)
602603
- Deserialized UnixFS files and directories as a TAR file or a stream, see :cite[ipip-0288].
603604
- IPNS Record

0 commit comments

Comments
 (0)