You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: http/README.md
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -65,7 +65,7 @@ graph TB
65
65
defined in terms of HTTP semantics and encodes it into a form that can be sent
66
66
over the wire.
67
67
68
-
-*HTTP transport* is the thing that takes your encoded reqeust/response and
68
+
-*HTTP transport* is the thing that takes your encoded request/response and
69
69
sends it over the wire. For HTTP/1.1 and HTTP/2, this is a TCP+TLS connection.
70
70
For HTTP/3, this is a QUIC connection.
71
71
@@ -81,7 +81,7 @@ Nodes MUST use HTTPS (i.e., they MUST NOT use plaintext HTTP). It is RECOMMENDE
81
81
82
82
Nodes signal support for their HTTP transport using the `/http` component in
83
83
their multiaddr. E.g., `/dns4/example.com/tls/http`. See the [HTTP multiaddr
84
-
component spec](https://github.com/libp2p/specs/pull/550) for more details.
84
+
component spec](https://github.com/libp2p/specs/blob/master/http/transport-component.md) for more details.
85
85
86
86
## Namespace
87
87
@@ -130,6 +130,6 @@ HTTP/1.1 is chosen as the minimum bar for interoperability, but other encodings
130
130
131
131
This document has focused on using HTTP semantics, but HTTP may not be the common divisor amongst all transports (current and future). It may be desirable to use some other request-response semantics for your application-level protocol, perhaps something like rust-libp2p’s [request-response](https://docs.rs/libp2p/0.52.1/libp2p/request_response/index.html) abstraction. Nothing specified in this document prohibits mapping other semantics onto HTTP semantics to keep the benefits of using an HTTP transport.
132
132
133
-
As a simple example, to support the simple request-response semantics, the request MUST be encoded within a `POST` request to the proper URL (as defined in the Namespace section). The response is read from the body of the HTTP response. The client MUST authenticate the server and itself **before** making the request. The reason to chose `POST` is because this mapping makes no assumptions on whether the request is cacheable. If HTTP caching is desired users should either build on HTTP semantics or chose another mapping with different assumptions.
133
+
As a simple example, to support the simple request-response semantics, the request MUST be encoded within a `POST` request to the proper URL (as defined in the [Namespace](#namespace) section). The response is read from the body of the HTTP response. The client MUST authenticate the server and itself **before** making the request. The reason to chose `POST` is because this mapping makes no assumptions on whether the request is cacheable. If HTTP caching is desired users should either build on HTTP semantics or chose another mapping with different assumptions.
134
134
135
135
Other mappings may also be valid and as long as nodes agree.
0 commit comments