Move subprotocol specs into this repo

ethereum / devp2p

Ethereum peer-to-peer networking specifications

999 stars 277 forks source link

Move subprotocol specs into this repo #47

Closed fjl closed 4 years ago

fjl commented 6 years ago

I would like to have all known subprotocol specs in one place. Protocols I know of are

eth: everyone implements this one
les: geth and a few others have it
shh: many versions, it's unclear to me which one is canonical
bzz, hive, discovery, stream: part of swarm

bobsummerwill commented 6 years ago

on shh see Reddit thread, CC @5chdn.

5chdn commented 6 years ago

par (unsure what this is used for, parity snapshotting?)
pip the parity light protocol

fjl commented 6 years ago

@5chdn do you have specs for those somewhere?

gumb0 commented 6 years ago

par is described in https://wiki.parity.io/Warp-Sync

5chdn commented 6 years ago

pip in https://wiki.parity.io/The-Parity-Light-Protocol-(PIP)

fjl commented 6 years ago

Thank you! I hope you don't mind if I copy those specs to this repo.

5chdn commented 6 years ago

I don't mind. It's all CC-BY-SA, but should be CC-0 really for the specs.

Source MDs at https://github.com/paritytech/wiki

FrankSzendzielarz commented 5 years ago

Note that protocol names like 'stream' are inconsistent with the protocol spec ("cap1: B_3")

FrankSzendzielarz commented 5 years ago

@fjl I ran a stabilized version of that crawler yesterday evening. I processed the output to show what caps and versions I got by crawling AND establishing handshake successfully. This is the result of about 5000 nodes found: adh - 62 adh - 63 anr - 62 anr - 63 bzz - 0 bzz - 7 ctxc - 62 ctxc - 63 dbix - 62 dbix - 63 ddm - 62 ddm - 63 ele - 62 ele - 63 etf - 62 etf - 63 eth - 62 eth - 63 etrue - 62 etrue - 63 etz - 62 etz - 63 etz - 64 exp - 62 exp - 63 glx - 62 glx - 63 hive - 6 istanbul - 64 laz - 62 laz - 63 les - 1 les - 2 mc - 62 mc - 63 okc - 62 okc - 63 par - 1 par - 2 par - 3 pchain - 64 pip - 1 pss - 2 pwh - 6 shh - 2 shh - 5 shh - 6 stream - 7 stream - 8 ur - 62 ur - 63 wolk - 66 wsh - 62 wsh - 63

fjl commented 5 years ago

We should remove the three-letter restriction from the spec.

fjl commented 5 years ago

PR to add eth/63: https://github.com/ethereum/devp2p/pull/62

fjl commented 5 years ago

PR to add les/2: #64

fjl commented 5 years ago

Assigned @gballet because he agreed to move the whisper spec.

FrankSzendzielarz commented 5 years ago

I am looking into light stuff at the mo, I'll check the licensing and throw the parity light stuff in here too later

fjl commented 4 years ago

Whisper will not move here, and I think we have everything. It would be nice to get waku in here, since it uses RLPx for now.

@decanus if you want the RLPx version of waku in this repo, and you're willing to put up with the markdown linter we have on here, go ahead and add it :).