github.com/zignig/go-ipfs@v0.0.0-20141111235910-c9e5fdf55a52/net/handshake/doc.go (about) 1 /* 2 package handshake implements the ipfs handshake protocol 3 4 IPFS Handshake 5 6 The IPFS Protocol Handshake is divided into three sequential steps 7 8 1. Version Handshake (`Hanshake1`) 9 10 2. Secure Channel (`NewSecureConn`) 11 12 3. Services (`Handshake3`) 13 14 Currently these parts currently happen sequentially (costing an awful 5 RTT), 15 but can be optimized to 2 RTT. 16 17 Version Handshake 18 19 The Version Handshake ensures that nodes speaking to each other can interoperate. 20 They send each other protocol versions and ensure there is a match on the major 21 version (semver). 22 23 Secure Channel 24 25 The second part exchanges keys and establishes a secure comm channel. This 26 follows ECDHE TLS, but *isn't* TLS. (why will be written up elsewhere). 27 28 Services 29 30 The Services portion sends any additional information on nodes needed 31 by the nodes, e.g. Listen Address (the received address could be a Dial addr), 32 and later on can include Service listing (dht, exchange, ipns, etc). 33 */ 34 package handshake