docs: WebTransport and CircuitV2

Question

docs: WebTransport and CircuitV2

Winterhuman opened this issue 2 years ago · 10 comments

I was reading https://github.com/libp2p/specs/tree/master/webtransport when I saw:

"The WebTransport URL of a WebTransport server advertising /ip4/192.0.2.0/udp/1443/quic/webtransport/ would be https://192.0.2.0:1443/.well-known/libp2p-webtransport?type=noise."

If the URL is what's actually being tried, doesn't that mean you can't use WebTransport only with CircuitV2 to establish a connection from a browser to a node behind NAT? Should this be documented if so?

Answer 1 · 2023-02-22T22:11:17.000Z

WebTransport runs on top of HTTP/3, so there's no way around this.

Answer 2 · 2023-02-22T23:11:13.000Z

Thanks for confirming. Do you think it's worth noting somewhere in the documentation that HTTP-based transports are incompatible with CircuitV2?

Answer 3 · 2023-02-22T23:12:50.000Z

That applies to all non-TCP transports, doesn't it?

Answer 4 · 2023-02-22T23:14:30.000Z

QUIC & WebSocket work don't they?

Answer 5 · 2023-02-22T23:16:23.000Z

Ah no, WebSocket wouldn't either since that needs a URL too

Answer 6 · 2023-02-22T23:20:40.000Z

I see what you mean now, anything that isn't TCP or QUIC is incompatible with CircuitV2, there would be too many transports to list them all; it's an inherit property of web-available transports. Closing issue

EDIT: Or not? See discussion after

Answer 7 · 2023-02-22T23:25:56.000Z

A relayed connection is a single, bidirectional byte stream, so all you can is upgrade that byte stream with a security and muxer protocol, analogous to what you do with a TCP connection.

For the connection to the relay, you can use any transport you like, including WebRTC and WebTransport.

Answer 8 · 2023-02-24T12:52:03.000Z

@marten-seemann I'm confused. Just to ask plainly, if there are two nodes, A and B, who are both behind non-symmetric NATs, and who only use WebTransport, can CircuitV2 allow a direct connection between A and B to form? If not, would A having transports other than WebTransport available, but not B, make this work instead?

This is assuming node B is running in a browser, and is subject to the browser's WebTransport API

Answer 9 · 2023-02-24T23:10:07.000Z

Circuitv2 doesn't allow direct connection, it allows relayed connections. It is a prerequisite for hole punching though, which then would give you a direct connection.

This should answer you question:

For the connection to the relay, you can use any transport you like, including WebRTC and WebTransport.

Answer 10 · 2023-02-24T23:47:22.000Z

No, I'm still confused, you're saying CircuitV2 can give you a direct connection after the holepunching packets are sent, but you also said "WebTransport runs on top of HTTP/3, so there's no way around this." implying WebTransport can't use the holepunched ports?

I'll leave the discussion here though, it's better if I wait until CircuitV2 support is merged in js-libp2p to actually test this