Skip to content
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

export ProofLeafNode and ProofInnerNode #205

Merged
merged 1 commit into from
Jan 31, 2020
Merged

export ProofLeafNode and ProofInnerNode #205

merged 1 commit into from
Jan 31, 2020

Conversation

tessr
Copy link
Contributor

@tessr tessr commented Jan 31, 2020

Closes #73.

@@ -92,18 +92,18 @@ func (pin proofInnerNode) Hash(childHash []byte) []byte {

//----------------------------------------

type proofLeafNode struct {
type ProofLeafNode struct {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now that we're exporting this, it should be documented as well.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree, and I started writing godoc for it, before I realized I didn't know enough about how these proofs work to write more than a cursory godoc. ("ProofLeafNode provides a merkle proof for a leaf node" is not terribly helpful.)

None of our proof types are documented anywhere at the moment, and this lack of clarity on my part was the motivation for opening #204. Godoc for proofs can either happen along with that issue or right after it.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, right. Sure, let's document it then.

@tessr tessr merged commit eb980bc into master Jan 31, 2020
@tessr tessr deleted the tessr/export branch January 31, 2020 14:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Proposal: export proofLeafNode
2 participants