Author [EN] [ZH] [ES] [PT] [IT] [DE] [FR] [NL] [TR] [SR] [AR] [RU] [EN] [ZH] [ES] [PT] [IT] [DE] [FR] [NL] [TR] [SR] [AR] [RU] [EN] [ZH] [ES] [PT] [IT] [DE] [FR] [NL] [TR] [SR] [AR] [RU] Topic: [$5000 worth in PTS] BitShares Blockchain Technical Specification [PENDING]  (Read 2200 times)

0 Members and 1 Guest are viewing this topic.

Offline bytemaster


So far BitShares has been developed with a cowboy coding mentality.  I would design, document, and implement as I went.  We are now looking to grow this into something that can be maintained by the community and understood by all.  To this end I would like to produce a professional quality design document that is maintained as a website that can be updated by accepting pull requests via Github.    This document should be content focused and built for clarity.   Someone should be able to take this specification and implement a working BitShares blockchain with a high degree of compatibility with other independent implementations.

I have already defined the blockchain and many unit tests and there exists documentation embedded in the code right now.  I would like to capture the ideas expressed in the code and make them available and accessible to everyone.   I will be available to answer questions here in the forum about anything that is unclear.

Because BitShares has not been finalized at this point, the process of documenting the current design should help us explore undiscovered corner cases.   

This is a cooperative bounty and all submissions must be developed publicly.  I want to encourage cooperation so if you copy contributions from other members be sure to agree on how to split the bounty. If the accepted design document has any disputes about how the bounty is to be divided then Invictus will decide and take a 25% cut.  In other words, it is in everyones interest to fairly access their own contribution and resolve disputes.

This bounty is PENDING until all questions regarding the scope and requirements of this bounty can be settled.  At that point we will lock in the terms and begin the bounty.  Of course, getting a head start will benefit all.

There is also a referral bounty paid to the individual who refers anyone who wins the bounty. 

https://github.com/InvictusInnovations/BitShares/blob/master/include/bts/blockchain/block.hpp
https://github.com/InvictusInnovations/BitShares/blob/master/include/bts/blockchain/outputs.hpp

« Last Edit: August 12, 2014, 10:37:43 AM by cass »
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline bytemaster

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #1 on: December 29, 2013, 01:13:59 AM »
I referred forum member naturalog to this bounty.
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline naturalog

  • Newbie
  • *
  • Posts: 13
    • View Profile
Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #2 on: December 29, 2013, 01:19:52 AM »
Interesting job. I'm starting to work on it.
How do you imagine the document?
Explaining in fluent English the classes and their relations, or more a reference-type document giving details on every class?
Initial version can be found here https://github.com/naturalog/BitShares/blob/master/doc/BitSharesBlockchainDesign.html
« Last Edit: December 29, 2013, 01:48:46 AM by naturalog »

Offline bytemaster

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #3 on: December 29, 2013, 02:14:38 AM »
I would like the spec to be language independent.    Talk about the data format and meaning rather than class names. 




Sent from my iPhone using Tapatalk
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline toast

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #4 on: December 29, 2013, 02:20:47 AM »
Interesting job. I'm starting to work on it.
How do you imagine the document?
Explaining in fluent English the classes and their relations, or more a reference-type document giving details on every class?
Initial version can be found here https://github.com/naturalog/BitShares/blob/master/doc/BitSharesBlockchainDesign.html

Ack. May I suggest using markdown instead of HTML? There are plenty render-md-as-html tools, and in the meantime we can have a readable format which github will render nicely for us.
Do not use this post as information for making any important decisions. The only agreements I ever make are informal and non-binding. Take the same precautions as when dealing with a compromised account, scammer, sockpuppet, etc.

Offline bytemaster

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #5 on: December 29, 2013, 02:23:28 AM »
The more professional the look the better.  The easier to maintain the better.  Must work well with version control and images.


Sent from my iPhone using Tapatalk
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline naturalog

  • Newbie
  • *
  • Posts: 13
    • View Profile
Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #6 on: December 29, 2013, 02:26:05 AM »
Ack. May I suggest using markdown instead of HTML? There are plenty render-md-as-html tools, and in the meantime we can have a readable format which github will render nicely for us.

Sounds like a great idea, admits all requirements as can be seen here https://help.github.com/articles/github-flavored-markdown
« Last Edit: December 29, 2013, 02:57:58 AM by naturalog »

Offline bytemaster

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #7 on: December 31, 2013, 05:57:02 PM »
Ack. May I suggest using markdown instead of HTML? There are plenty render-md-as-html tools, and in the meantime we can have a readable format which github will render nicely for us.

Sounds like a great idea, admits all requirements as can be seen here https://help.github.com/articles/github-flavored-markdown

I would expect there to be regular questions and a place where you are publishing your work?
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline toast

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #8 on: January 01, 2014, 12:04:45 AM »
Hijack!

I have ported what naturalog has written so far to markdown and put it on github ("spec" branch). I'm gonna be working on this / BTS explorer tonight and didn't have access to the repo. Also I added naturalog as a contributor (both "naturalog" and "ohadasor").

https://github.com/nmushegian/BitShares/blob/spec/doc/spec.md

bitshare explorer bounty thread
https://bitsharestalk.org/index.php?topic=1829.0;topicseen


edit: bytemaster, since this is a separate branch, want to just pull it into the II/BitShares repo right now?
edit 2: nvm then you need to grant repo permissions
« Last Edit: January 01, 2014, 12:08:20 AM by toast »
Do not use this post as information for making any important decisions. The only agreements I ever make are informal and non-binding. Take the same precautions as when dealing with a compromised account, scammer, sockpuppet, etc.

Offline bytemaster

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #9 on: January 01, 2014, 01:18:39 AM »
Hijack!

I have ported what naturalog has written so far to markdown and put it on github ("spec" branch). I'm gonna be working on this / BTS explorer tonight and didn't have access to the repo. Also I added naturalog as a contributor (both "naturalog" and "ohadasor").

https://github.com/nmushegian/BitShares/blob/spec/doc/spec.md

bitshare explorer bounty thread
https://bitsharestalk.org/index.php?topic=1829.0;topicseen


edit: bytemaster, since this is a separate branch, want to just pull it into the II/BitShares repo right now?
edit 2: nvm then you need to grant repo permissions

I am going to make this my priority task once I get Keyhotee ID registration done.
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline naturalog

  • Newbie
  • *
  • Posts: 13
    • View Profile
Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #10 on: January 02, 2014, 12:05:19 PM »
bytemaster, can you please supply some explanation about the block state structure?
toast, do you plan working on this doc? Otherwise I'll work on my fork.
see my work so far here
https://github.com/naturalog/BitShares/blob/master/doc/BitSharesBlockchainDesign.md
« Last Edit: January 02, 2014, 12:14:43 PM by naturalog »

Offline toast

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #11 on: January 02, 2014, 07:32:15 PM »
I saw the doc but it barely had anything at the time. Let's pick one repo and work there. I'm fine with using yours if you do the work of merging (but you should check out a new branch IMO, not use master). Conversely, I'll gladly do the merge if we want to work in my branch.

https://github.com/nmushegian/BitShares/blob/spec/doc/spec.md
Do not use this post as information for making any important decisions. The only agreements I ever make are informal and non-binding. Take the same precautions as when dealing with a compromised account, scammer, sockpuppet, etc.

Offline bytemaster

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #12 on: January 02, 2014, 07:47:31 PM »
Hey, today I want to help bootstrap this process some. 
For the latest updates checkout my blog: http://bytemaster.bitshares.org
Anything said on these forums does not constitute an intent to create a legal obligation or contract between myself and anyone else.   These are merely my opinions and I reserve the right to change them at any time.

Offline toast

Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #13 on: January 02, 2014, 07:48:13 PM »
getting on irc [email protected]
Do not use this post as information for making any important decisions. The only agreements I ever make are informal and non-binding. Take the same precautions as when dealing with a compromised account, scammer, sockpuppet, etc.

Offline naturalog

  • Newbie
  • *
  • Posts: 13
    • View Profile
Re: 500 PTS BitShares Blockchain Technical Specification [PENDING]
« Reply #14 on: January 03, 2014, 12:37:05 PM »
Conversely, I'll gladly do the merge if we want to work in my branch.

https://github.com/nmushegian/BitShares/blob/spec/doc/spec.md

please do :) i'm new to github..

 

Google+