Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Already on GitHub? Sign in to your account

Update protocol section of docs to reflect v70003 #958

Closed
drazisil opened this Issue Jul 11, 2015 · 11 comments

Comments

Projects
None yet
3 participants
Contributor

drazisil commented Jul 11, 2015

https://bitcoin.org/en/developer-reference#protocol-versions

Does not list protocol version 70003 as latest, appears to have not been updated from core v0.9.0

Unsure what changes have taken place.

Contributor

harding commented Jul 11, 2015

@drazisil My 0.11.0-pre node is still at 70002, and I think master is too. Where do you see 70003?

Contributor

luke-jr commented Jul 11, 2015

It's a design flaw in BIP 64 / getutxos.

Contributor

drazisil commented Jul 11, 2015

Bitcoin XT 0.10.2 - getnetworkinfo

{u'localservices': u'0000000000000003', u'connections': 33, u'subversion': u'/Bitcoin XT:0.10.2/', u'version': 100200, u'relayfee': 0.00011, u'protocolversion': 70003, u'timeoffset': -1, u'localaddresses': [{u'score': 1, u'port': 8333, u'address': u'2002:6cb7:7be6:1:76d4:35ff:fe1d:45b'}], u'networks': [{u'limited': False, u'reachable': True, u'name': u'ipv4', u'proxy': u''}, {u'limited': False, u'reachable': True, u'name': u'ipv6', u'proxy': u''}, {u'limited': False, u'reachable': False, u'name': u'onion', u'proxy': u''}]}

Contributor

harding commented Jul 11, 2015

Oh. The first paragraph of the P2P Network section says:

This section describes the Bitcoin P2P network protocol (but it is not a specification). It does not describe [...] any network protocol never implemented in an official version of Bitcoin Core.

For the sake of pedantry, I know getutxos/70003 was briefly implemented in Bitcoin Core master before being reverted a few hours later, but I don't feel that really qualifies as being implemented in an official version. So I don't think this part of the docs is the appropriate place to describe 70003.

Contributor

luke-jr commented Jul 11, 2015

I don't think it's appropriate for the dev docs to focus on a single p2p protocol implementation. OTOH, if XT is going to altcoinfork off in a few days/weeks anyway, maybe not worth the trouble to add it here.

Contributor

harding commented Jul 11, 2015

@luke-jr I don't have any problem with someone adding alternative protocols (there are several I'd like to describe myself, given enough time). I do think that for simplicity the section that @drazisil linked to should be dedicated to the protocol that Bitcoin Core implements for as long as Bitcoin Core is the reference client.

Contributor

drazisil commented Jul 11, 2015

Understood. I was not aware that 70003 was just XT, I thought it was for all .10.x clients, since it listed Bitcoin Core 0.9.0 as the implementation.

I rephrase my suggestion to update the docs to reflect the current version. Then again, I'm not sure how far away 0.11x is, so may want to hold off.

Contributor

harding commented Jul 11, 2015

@drazisil oh, I think there's some confusion. I meant "implementation" to mean "first implemented in". What if I change the header of the table to "Initial Release"? E.g.:

screenshot-btcorg localhost 2015-07-11 11-46-07

Contributor

drazisil commented Jul 11, 2015

@harding it would. The confusion mainly stemmed from it looks like each version of core, recently at least, has an updated protocol version to match. So i assumed 0.10 would be 70003 and it just wasn't current.

@harding harding closed this in ee554df Jul 11, 2015

Contributor

harding commented Jul 11, 2015

@drazisil added in ee554df plus an extra sentence to help make it even more clear. It should appear on the website within 15 minutes. Thanks!

Contributor

drazisil commented Jul 11, 2015

@harding looks perfect in the commit. Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment