-
Notifications
You must be signed in to change notification settings - Fork 47
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
blockchain app content #335
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I have a few suggestions, but this looks good to me otherwise
@@ -1,5 +1,5 @@ | |||
defmodule Blockchain.Application do | |||
# See http://elixir-lang.org/docs/stable/elixir/Application.html | |||
# See https://elixir-lang.org/getting-started/mix-otp/supervisor-and-application.html |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we can remove the comments from this module. They are auto-generated when created the mix
project.
@@ -32,7 +32,7 @@ defmodule Blockchain.Application do | |||
# worker(Blockchain.Worker, [arg1, arg2, arg3]), | |||
] | |||
|
|||
# See http://elixir-lang.org/docs/stable/elixir/Supervisor.html | |||
# See https://elixir-lang.org/getting-started/mix-otp/supervisor-and-application.html |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same with this one. I think we should remove them since they're auto-generated.
@moduledoc """ | ||
When a block is generated or verified, the contract addresses and fields from the generated logs are added to a bloom filter. This is included in the block header. | ||
|
||
_From Yellow Paper 4.3.1. Transaction Receipt_: The transaction receipt is a tuple of four items comprising the post-transaction state, R, the cumulative gas used in the block containing the transaction receipt as of immediately after the transaction has happened, Ru, the set of logs created through execution of the transaction, Rl and the Bloom filter composed from information in those logs, Rb: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What do you think about breaking this paragraph (and the previous one) into multiple lines? It makes it a bit hard to read like this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I also noticed that this ends with Rb:
. Is there supposed to be something after that or is the colon supposed to be a period?
@@ -1,4 +1,17 @@ | |||
defmodule Blockchain.Bloom do | |||
@moduledoc """ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@ayrat555 I see you wrote a post on the bloom filter - adding any of those comments or examples to this file may be useful, or at least a link to the article. http://www.badykov.com/ethereum/2017/10/29/ethereum-bloom-filter/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@andogro good idea
@andogro @germsvel @masonforest currently, credo check for required module documentations is turned off. should we turn it on? https://github.com/poanetwork/mana/blob/master/.credo.exs#L89 |
@ayrat555 I think that would make sense. |
@andogro we should also delete old licenses from |
Includes typo fixes, README modifications and content additions for some of the blockchain modules. I will continue with this process but wanted to update with incremental progress.
-Blockchain.Bloom was missing documentation - I added some related information from yellow paper but unsure if it covers module processes