docs: remove application/json and custom headers from ipip

Author: hacdias

src/ipips/ipip-0379.md

@@ -18,9 +18,6 @@ order: 379
 tags: ['ipips']
 ---
 
-- Start Date: 2023-02-13
-- Related Issues:
-
 ## Summary
 
 This IPIP specifies a set of HTTP APIs to offload naming system onto another process or server.
@@ -30,7 +27,7 @@ This IPIP specifies a set of HTTP APIs to offload naming system onto another pro
 Expanding on the motivations of :cite[ipip-0337], the work here concentrates on delegation of _naming system_ over HTTP APIs. Naming is part of the core IPFS DHT functionality.
 The performance of naming system over the IPFS DHT can suffer from long delays due to churn of records and quorum requirements.
 
-## HTTP API Specification
+## Detailed design
 
 See :cite[http-routing-v1] specification.
 
@@ -40,11 +37,7 @@ The rationale for delegated IPNS over HTTP APIs closely follows the reasoning li
 
 The document proposes the following:
 - Use of HTTP semantics for publication and resolution of naming records.
-- Preference for human-readable request and response encoding, such as JSON format
-- Mandatory support for the existing :ref[IPNS Record] serialization format using `Content-Type: application/vnd.ipfs.ipns-record`
-- Use of extra headers in `OPTIONS` response to communicate the supported capabilities and limitations, namely:
-  - `X-Ipns-Allow-Max-Size` -- to signal maximum supported IPNS record size
-  - `X-Ipns-Allow-Protobuf` -- to signal whether the server supports ProtocolBuffer formatted records.
+- Use of existing :ref[IPNS Record] serialization format through `Content-Type: application/vnd.ipfs.ipns-record`.
 - Streaming interaction is not supported.
 
 ### User benefit
@@ -53,37 +46,30 @@ The ability of offload naming onto another process or server via an idiomatic an
 
 ### Compatibility
 
-#### Backwards Compatibility
+See "Compatibility" section of :cite[ipip-0337].
 
-##### Serialization Format
+#### Serialization Format
 
-:cite[ipns-record] use `application/vnd.ipfs.ipns-record` protobuf serialization format.
+:cite[ipns-record] uses `application/vnd.ipfs.ipns-record` protobuf serialization format.
 This format is widely in use in IPNS over PubSub and DHT routing systems.
 One of the motivations of this document is to introduce simple to use HTTP APIs and ultimately reduce barrier for interaction across alternative systems.
 Further, interoperability across the existing and HTTP APIs is also desirable in order to reduce the barrier for adoption of the delegated HTTP APIs.
 
-The specification here maintains backwards compatibility in terms of record serialisation, with preference for human-readable formats such as JSON.
 To maximize interoperability with existing ecosystem, the canonical IPNS record serialization format :cite[ipns-record] (`0x0300`) can be requested with content type `application/vnd.ipfs.ipns-record`.
 
-#### Compatibility
-
-See "Compatibility" section of :cite[ipip-0337].
-
 ### Security
 
 All interaction over the APIs should use TLS to protect against third-party observation and tampering.
 Additionally, the IPNS records must be validated according to the rules stated in :cite[ipns-record] before further processing.
 
-To avoid Denial of Service attack, [maximum IPNS record size defined in IPNS spec](https://specs.ipfs.tech/ipns/ipns-record/#record-size-limit) applies.
-Implements are permitted to set a lower limit. If lower than the default maximum, the limit should be discoverable via `OPTIONS` request with header key `X-Ipns-Allow-Max-Size` with value specified as the number of bytes.
-
-Similarly, a client may check if a server supports ProtocolBuffer formatted records by checking the `X-Ipns-Allow-Protobuf` header key in response to `OPTIONS` request. If present the header value must be either `true` or `false` the absence of the header indicates that ProtocolBuffer formatted records are not supported.
+To avoid Denial of Service attack, maximum IPNS record size defined in :cite[ipns-record] applies.
 
 Privacy in delegated IPNS is out of scope for this work.
 
 ### Alternatives
 
 See:
+
 - [Libp2p-based IPNS](https://github.com/ipfs/go-ipns).
 - Reframe; it was deprecated and now removed. Historical reasons can be found in :cite[ipip-0337].