Skip to content

Commit

Permalink
ipip-402: remove mentions of ordered CARs for now
Browse files Browse the repository at this point in the history
We have no spec for signaling this, we may add it as opt-in later
#402 (comment)
#402 (comment)
  • Loading branch information
lidel committed Jul 6, 2023
1 parent faf4a0b commit ae34255
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions src/http-gateways/path-gateway.md
Expand Up @@ -594,10 +594,11 @@ The following response types require an explicit opt-in, can only be requested w
- Raw Block (`?format=raw`)
- Opaque bytes, see [application/vnd.ipld.raw](https://www.iana.org/assignments/media-types/application/vnd.ipld.raw).
- CAR (`?format=car`)
- 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).
- Must contain, as the very first block, the block that hashes to the content root CID
- Must contain, immediately following the root block, all blocks encountered while traversing the expressed path in the order they were traversed
- 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)
- 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].
- **Note:** by default, block order in CAR response is not deterministic,
blocks can be returned in different order, depending on implementation
choices (traversal, speed at which blocks arrive from the network, etc).
An opt-in ordered CAR responses MAY be introduced in a future IPIP.
- TAR (`?format=tar`)
- Deserialized UnixFS files and directories as a TAR file or a stream, see :cite[ipip-0288].
- IPNS Record
Expand Down

0 comments on commit ae34255

Please sign in to comment.