Network protocol structure

semtexzv · October 17, 2020, 10:50am

Hi there, I’m working on an alternative green-field implementation of lib2p for internal project ( Specific requrirements, nothing fits). And I’d like to know more about how the network protocol works.

I’m interested how to stream muxing & encryption play together.

Is the stream encryption in a special place ( each muxed stream always running on top of encrypted stream). OR
Raw connection (TCP) is muxed, one of the streams on top of it is the noise protocol, and on top of noise protocol is another muxer switching between individual app streams ?

Basically , I need to know whats the composition structure of all the muxers and different protocols, and what’s the negotiation tactic. I’ve been able to find a lot of materials for user defined streams, but not a lot for this part of the code.

stebalien · October 19, 2020, 5:08pm

If the base connection doesn’t provide builtin encryption & authentication, it’s encrypted & authenticated using Noise or TLS. The multiplexer is then run on top of the encrypted stream.

Basically, encryption is always the first “upgrade”. The entire process can be found in:

github.com

libp2p/go-libp2p-transport-upgrader/blob/0c577bb483255c5046677a49624fb45c862d616b/upgrader.go#L68-L112


func (u *Upgrader) upgrade(ctx context.Context, t transport.Transport, maconn manet.Conn, p peer.ID, dir network.Direction) (transport.CapableConn, error) {
	var conn net.Conn = maconn
	if u.PSK != nil {
		pconn, err := pnet.NewProtectedConn(u.PSK, conn)
		if err != nil {
			conn.Close()
			return nil, fmt.Errorf("failed to setup private network protector: %s", err)
		}
		conn = pconn
	} else if ipnet.ForcePrivateNetwork {
		log.Error("tried to dial with no Private Network Protector but usage" +
			" of Private Networks is forced by the enviroment")
		return nil, ipnet.ErrNotInPrivateNetwork
	}

	sconn, err := u.setupSecurity(ctx, conn, p)
	if err != nil {
		conn.Close()
		return nil, fmt.Errorf("failed to negotiate security protocol: %s", err)
	}

This file has been truncated. show original

semtexzv · October 19, 2020, 8:47pm

Thank you, I found some docs got the information I needed

Topic		Replies	Views
FAQs about libp2p Users and Developers	20	5611	August 31, 2021
Flexible protocol negotiation Users and Developers	1	308	September 6, 2022
Is libp2p suitable to build a node for a existing non-libp2p network? Users and Developers	2	449	January 6, 2023
Advice on writing a transport Implementers and Contributors	2	681	May 10, 2019
Go-libp2p, gating handshakes Users and Developers	1	282	September 7, 2023

Network protocol structure

Related topics