* [Bitcoin-development] Bitcoin Protocol Specification
@ 2014-06-26 11:30 Krzysztof Okupski
2014-07-03 1:21 ` Isidor Zeuner
0 siblings, 1 reply; 21+ messages in thread
From: Krzysztof Okupski @ 2014-06-26 11:30 UTC (permalink / raw)
To: bitcoin-development
Dear all,
a while ago I've posted a work of mine, namely the Bitcoin Protocol
Specification,
that should by now ring a bell to some of you. Ever since I've received
plenty of
comments from Bitcoin Core developers, Bitcoin enthusiasts and many others.
For the encouraging words and improvement proposals I'm very grateful. I
tried
to incorporate to the best of my abilities and am happy to present a
revised version.
As before, it can be found under:
http://enetium.com/resources/Bitcoin.pdf
I hope it will prove useful to the community and thank in advance for
any further
improvement proposals.
Kind regards,
Krzysztof
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
@ 2014-07-14 14:44 Krzysztof Okupski
2014-07-14 17:16 ` Jeff Garzik
0 siblings, 1 reply; 21+ messages in thread
From: Krzysztof Okupski @ 2014-07-14 14:44 UTC (permalink / raw)
To: bitcoin-development
[-- Attachment #1: Type: text/plain, Size: 1081 bytes --]
I've renamed it to "Bitcoin Developer Specification" a little while ago.
Maybe it should rather be named "Bitcoin Developer Reference"? Either
way, creating a good description of Bitcoin is an incremental process
and there are certainly many quirks I'm not aware of. I hope that
together we will soon be able to fill in the missing gaps.
Warm greetings,
Krzysztof Okupski
On 07/14/2014 01:26 PM, Mike Hearn wrote:
> Nice work, but please don't call it the "Bitcoin protocol spec". Your
> document is not a spec. It is an attempt to describe in English the Bitcoin
> protocol, but anyone who implemented it based on your description would get
> it wrong. For example you didn't mention the SIGHASH_SINGLE bug and many
> other important areas like the difficulty transitions are also left
> unspecified.
>
> As a loose description of the protocol for newbies it's an invaluable
> resource and perhaps we should link to it from the developer guide. As
> something that claims to be a specification it is quite possibly dangerous
> - the only spec that matters is the C++ original.
[-- Attachment #2: Type: text/html, Size: 1504 bytes --]
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 14:44 Krzysztof Okupski
@ 2014-07-14 17:16 ` Jeff Garzik
0 siblings, 0 replies; 21+ messages in thread
From: Jeff Garzik @ 2014-07-14 17:16 UTC (permalink / raw)
To: Krzysztof Okupski; +Cc: Bitcoin Dev
On Mon, Jul 14, 2014 at 10:44 AM, Krzysztof Okupski
<k.okupski@googlemail.com> wrote:
> I've renamed it to "Bitcoin Developer Specification" a little while ago.
> Maybe it should rather be named "Bitcoin Developer Reference"? Either
> way, creating a good description of Bitcoin is an incremental process
> and there are certainly many quirks I'm not aware of. I hope that
> together we will soon be able to fill in the missing gaps.
Firstly, it is an excellent document, and it should be useful in
educating others.
I do agree that "specification" is not a good word to use.
--
Jeff Garzik
Bitcoin core developer and open source evangelist
BitPay, Inc. https://bitpay.com/
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
@ 2014-07-14 9:54 Krzysztof Okupski
2014-07-14 10:41 ` sickpig
2014-07-14 11:26 ` Mike Hearn
0 siblings, 2 replies; 21+ messages in thread
From: Krzysztof Okupski @ 2014-07-14 9:54 UTC (permalink / raw)
To: bitcoin-development
[-- Attachment #1: Type: text/plain, Size: 286 bytes --]
Dear all,
thank you for your invaluable feedback. As requested, the spec
will from now on be under version control. It can be found under:
https://github.com/minium/Bitcoin-Spec
The old link to the PDF will be, just in case, kept updated as well.
Warm greetings,
Krzysztof Okupski
[-- Attachment #2: Type: text/html, Size: 712 bytes --]
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 9:54 Krzysztof Okupski
@ 2014-07-14 10:41 ` sickpig
2014-07-14 11:26 ` Mike Hearn
1 sibling, 0 replies; 21+ messages in thread
From: sickpig @ 2014-07-14 10:41 UTC (permalink / raw)
To: Krzysztof Okupski; +Cc: Bitcoin Dev
On Mon, Jul 14, 2014 at 11:54 AM, Krzysztof Okupski
<k.okupski@googlemail.com> wrote:
> Dear all,
>
> thank you for your invaluable feedback. As requested, the spec
> will from now on be under version control. It can be found under:
>
> https://github.com/minium/Bitcoin-Spec
>
> The old link to the PDF will be, just in case, kept updated as well.
>
>
> Warm greetings,
> Krzysztof Okupski
many many thanks Krzysztof.
This was badly needed.
This is a way to get more people to understand
the whole system, hence increasing the number
of bitcoin devs on the long term.
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 9:54 Krzysztof Okupski
2014-07-14 10:41 ` sickpig
@ 2014-07-14 11:26 ` Mike Hearn
2014-07-14 11:41 ` Wladimir
2014-07-14 12:25 ` sickpig
1 sibling, 2 replies; 21+ messages in thread
From: Mike Hearn @ 2014-07-14 11:26 UTC (permalink / raw)
To: Krzysztof Okupski; +Cc: Bitcoin Dev
[-- Attachment #1: Type: text/plain, Size: 1630 bytes --]
Nice work, but please don't call it the "Bitcoin protocol spec". Your
document is not a spec. It is an attempt to describe in English the Bitcoin
protocol, but anyone who implemented it based on your description would get
it wrong. For example you didn't mention the SIGHASH_SINGLE bug and many
other important areas like the difficulty transitions are also left
unspecified.
As a loose description of the protocol for newbies it's an invaluable
resource and perhaps we should link to it from the developer guide. As
something that claims to be a specification it is quite possibly dangerous
- the only spec that matters is the C++ original.
On Mon, Jul 14, 2014 at 11:54 AM, Krzysztof Okupski <
k.okupski@googlemail.com> wrote:
> Dear all,
>
> thank you for your invaluable feedback. As requested, the spec
> will from now on be under version control. It can be found under:
>
> https://github.com/minium/Bitcoin-Spec
>
> The old link to the PDF will be, just in case, kept updated as well.
>
>
> Warm greetings,
> Krzysztof Okupski
>
>
> ------------------------------------------------------------------------------
> Want fast and easy access to all the code in your enterprise? Index and
> search up to 200,000 lines of code with a free copy of Black Duck®
> Code Sight™ - the same software that powers the world's largest code
> search on Ohloh, the Black Duck Open Hub! Try it now.
> http://p.sf.net/sfu/bds
> _______________________________________________
> Bitcoin-development mailing list
> Bitcoin-development@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/bitcoin-development
>
>
[-- Attachment #2: Type: text/html, Size: 2470 bytes --]
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 11:26 ` Mike Hearn
@ 2014-07-14 11:41 ` Wladimir
2014-07-14 11:49 ` Mike Hearn
2014-07-14 12:25 ` sickpig
1 sibling, 1 reply; 21+ messages in thread
From: Wladimir @ 2014-07-14 11:41 UTC (permalink / raw)
To: Mike Hearn; +Cc: Bitcoin Dev, Krzysztof Okupski
> As a loose description of the protocol for newbies it's an invaluable
> resource and perhaps we should link to it from the developer guide.
It has already been linked from the developer guide for quite a while,
under Additional Resources.
Wladimir
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 11:41 ` Wladimir
@ 2014-07-14 11:49 ` Mike Hearn
0 siblings, 0 replies; 21+ messages in thread
From: Mike Hearn @ 2014-07-14 11:49 UTC (permalink / raw)
To: Wladimir; +Cc: Bitcoin Dev, Krzysztof Okupski
[-- Attachment #1: Type: text/plain, Size: 424 bytes --]
Ah, that's great. Still, it would be good to be careful with the word
"specification".
On Mon, Jul 14, 2014 at 1:41 PM, Wladimir <laanwj@gmail.com> wrote:
> > As a loose description of the protocol for newbies it's an invaluable
> > resource and perhaps we should link to it from the developer guide.
>
> It has already been linked from the developer guide for quite a while,
> under Additional Resources.
>
> Wladimir
>
[-- Attachment #2: Type: text/html, Size: 842 bytes --]
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 11:26 ` Mike Hearn
2014-07-14 11:41 ` Wladimir
@ 2014-07-14 12:25 ` sickpig
2014-07-14 12:37 ` Mike Hearn
1 sibling, 1 reply; 21+ messages in thread
From: sickpig @ 2014-07-14 12:25 UTC (permalink / raw)
To: Mike Hearn; +Cc: Bitcoin Dev, Krzysztof Okupski
On Mon, Jul 14, 2014 at 1:26 PM, Mike Hearn <mike@plan99.net> wrote:
> Nice work, but please don't call it the "Bitcoin protocol spec". Your
> document is not a spec.
fair objection, fwiw.
> It is an attempt to describe in English the Bitcoin
> protocol, but anyone who implemented it based on your description would get
> it wrong. For example you didn't mention the SIGHASH_SINGLE bug and many
> other important areas like the difficulty transitions are also left
> unspecified.
at the end of the day it's opensource so it could always be improved via pull
request on github.
Krzysztof, in that regard I would add a licence file to make
integration of changes
made by others smoother.
> As a loose description of the protocol for newbies it's an invaluable
> resource and perhaps we should link to it from the developer guide. As
> something that claims to be a specification it is quite possibly dangerous -
> the only spec that matters is the C++ original.
just out of curiosity, do you think it will be possible to create any
other proper
protocol specifications rather than the C++ original?
> On Mon, Jul 14, 2014 at 11:54 AM, Krzysztof Okupski
> <k.okupski@googlemail.com> wrote:
>>
>> Dear all,
>>
>> thank you for your invaluable feedback. As requested, the spec
>> will from now on be under version control. It can be found under:
>>
>> https://github.com/minium/Bitcoin-Spec
>>
>> The old link to the PDF will be, just in case, kept updated as well.
>>
>>
>> Warm greetings,
>> Krzysztof Okupski
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 12:25 ` sickpig
@ 2014-07-14 12:37 ` Mike Hearn
2014-07-14 20:51 ` sickpig
0 siblings, 1 reply; 21+ messages in thread
From: Mike Hearn @ 2014-07-14 12:37 UTC (permalink / raw)
To: sickpig; +Cc: Bitcoin Dev, Krzysztof Okupski
[-- Attachment #1: Type: text/plain, Size: 504 bytes --]
>
> just out of curiosity, do you think it will be possible to create any
> other proper protocol specifications rather than the C++ original?
Well it's a finite code base so yes, it should be possible.
The only problem is .... so far everyone who tried it, didn't succeed :)
Heck even people who tried to reimplement it by reading the code keep
getting subtle details wrong.
So it should definitely be possible one day, assuming Bitcoin doesn't
become radically more complex, but it's a minefield.
[-- Attachment #2: Type: text/html, Size: 815 bytes --]
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-07-14 12:37 ` Mike Hearn
@ 2014-07-14 20:51 ` sickpig
0 siblings, 0 replies; 21+ messages in thread
From: sickpig @ 2014-07-14 20:51 UTC (permalink / raw)
To: Mike Hearn; +Cc: Bitcoin Dev, Krzysztof Okupski
[-- Attachment #1: Type: text/plain, Size: 619 bytes --]
On Mon, Jul 14, 2014 at 2:37 PM, Mike Hearn <mike@plan99.net> wrote:
> just out of curiosity, do you think it will be possible to create any
>> other proper protocol specifications rather than the C++ original?
>
>
> Well it's a finite code base so yes, it should be possible.
>
> The only problem is .... so far everyone who tried it, didn't succeed :)
> Heck even people who tried to reimplement it by reading the code keep
> getting subtle details wrong.
>
> So it should definitely be possible one day, assuming Bitcoin doesn't
> become radically more complex, but it's a minefield.
>
thank for the frank reply
[-- Attachment #2: Type: text/html, Size: 1258 bytes --]
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
@ 2014-07-09 9:34 Krzysztof Okupski
0 siblings, 0 replies; 21+ messages in thread
From: Krzysztof Okupski @ 2014-07-09 9:34 UTC (permalink / raw)
To: bitcoin-development
Dear all,
thank you for your words of encouragement. I'll upload
the raw .tex files on github shortly. If you have any other
proposals, please let me know. Especially if there are any
suggestions on how the signature section can be revised.
More information on network functionality can be found on:
https://en.bitcoin.it/wiki/Network
Details can be found here:
https://en.bitcoin.it/wiki/Satoshi_Client_Block_Exchange
https://en.bitcoin.it/wiki/Satoshi_Client_Transaction_Exchange
https://en.bitcoin.it/wiki/Satoshi_Client_Initialization_and_Startup
https://en.bitcoin.it/wiki/Satoshi_Client_Node_Discovery
https://en.bitcoin.it/wiki/Satoshi_Client_Node_Connectivity
https://en.bitcoin.it/wiki/Satoshi_Client_Sockets_and_Messages
Warm greetings,
Krzysztof
^ permalink raw reply [flat|nested] 21+ messages in thread
* [Bitcoin-development] Bitcoin Protocol Specification
@ 2014-05-18 13:35 Krzysztof Okupski
2014-05-18 14:38 ` Adam Back
0 siblings, 1 reply; 21+ messages in thread
From: Krzysztof Okupski @ 2014-05-18 13:35 UTC (permalink / raw)
To: bitcoin-development
Dear all,
I'd like to kindly ask, those of you that have a bit of spare time, to
take a look at a Bitcoin protocol specification I've written. It is still
in development and, as some of you have already indicated, needs
improvement. I'd be very thankful if some of you could take the
time to review it. If there are any errors or suggestions from your
side, I'd gladly hear them. My e-mail can be found on the front page
of the document:
http://enetium.com/resources/Bitcoin.pdf
Warm greetings,
Chris
^ permalink raw reply [flat|nested] 21+ messages in thread
* Re: [Bitcoin-development] Bitcoin Protocol Specification
2014-05-18 13:35 Krzysztof Okupski
@ 2014-05-18 14:38 ` Adam Back
0 siblings, 0 replies; 21+ messages in thread
From: Adam Back @ 2014-05-18 14:38 UTC (permalink / raw)
To: Krzysztof Okupski; +Cc: bitcoin-development
Suggestion: maybe you want to write and post here a paragraph summarizing
the topic of your paper so people can know if they feel qualified and if
they need to review it from their interests.
Adam
On Sun, May 18, 2014 at 03:35:33PM +0200, Krzysztof Okupski wrote:
>Dear all,
>
>I'd like to kindly ask, those of you that have a bit of spare time, to
>take a look at a Bitcoin protocol specification I've written. It is still
>in development and, as some of you have already indicated, needs
>improvement. I'd be very thankful if some of you could take the
>time to review it. If there are any errors or suggestions from your
>side, I'd gladly hear them. My e-mail can be found on the front page
>of the document:
>
>http://enetium.com/resources/Bitcoin.pdf
>
>Warm greetings,
>Chris
>
>
>------------------------------------------------------------------------------
>"Accelerate Dev Cycles with Automated Cross-Browser Testing - For FREE
>Instantly run your Selenium tests across 300+ browser/OS combos.
>Get unparalleled scalability from the best Selenium testing platform available
>Simple to use. Nothing to install. Get started now for free."
>http://p.sf.net/sfu/SauceLabs
>_______________________________________________
>Bitcoin-development mailing list
>Bitcoin-development@lists.sourceforge.net
>https://lists.sourceforge.net/lists/listinfo/bitcoin-development
^ permalink raw reply [flat|nested] 21+ messages in thread
end of thread, other threads:[~2014-07-14 20:52 UTC | newest]
Thread overview: 21+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-06-26 11:30 [Bitcoin-development] Bitcoin Protocol Specification Krzysztof Okupski
2014-07-03 1:21 ` Isidor Zeuner
[not found] ` <CANVdSAqEyqavSHea3uhzVWGKQU0UHGZDVqEiF3Ox2XkhwM=zpA@mail.gmail.com>
2014-07-07 17:57 ` JMOlmos GMail
2014-07-08 15:29 ` Chris D'Costa
2014-07-08 20:04 ` Matt Whitlock
2014-07-08 21:08 ` Aaron Voisine
2014-07-08 22:40 ` Jorge Timón
2014-07-09 11:57 ` Mike Hearn
-- strict thread matches above, loose matches on Subject: below --
2014-07-14 14:44 Krzysztof Okupski
2014-07-14 17:16 ` Jeff Garzik
2014-07-14 9:54 Krzysztof Okupski
2014-07-14 10:41 ` sickpig
2014-07-14 11:26 ` Mike Hearn
2014-07-14 11:41 ` Wladimir
2014-07-14 11:49 ` Mike Hearn
2014-07-14 12:25 ` sickpig
2014-07-14 12:37 ` Mike Hearn
2014-07-14 20:51 ` sickpig
2014-07-09 9:34 Krzysztof Okupski
2014-05-18 13:35 Krzysztof Okupski
2014-05-18 14:38 ` Adam Back
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox