- 
                Notifications
    You must be signed in to change notification settings 
- Fork 233
chore: fix some comments #2762
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
chore: fix some comments #2762
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||
|---|---|---|---|---|---|---|---|---|
|  | @@ -10,20 +10,20 @@ import ( | |||||||
| // Sequencer is a generic interface for a sequencer | ||||||||
| type Sequencer interface { | ||||||||
| // SubmitBatchTxs submits a batch of transactions from to sequencer | ||||||||
| // Id is the unique identifier for the chain | ||||||||
| // Id is the unique identifier for the target chain | ||||||||
| // Batch is the batch of transactions to submit | ||||||||
| // returns an error if any from the sequencer | ||||||||
| SubmitBatchTxs(ctx context.Context, req SubmitBatchTxsRequest) (*SubmitBatchTxsResponse, error) | ||||||||
|  | ||||||||
| // GetNextBatch returns the next batch of transactions from sequencer to | ||||||||
| // Id is the unique identifier for the chain | ||||||||
| // Id is the unique identifier for the target chain | ||||||||
| // LastBatchHash is the cryptographic hash of the last batch received by the | ||||||||
| // MaxBytes is the maximum number of bytes to return in the batch | ||||||||
| // returns the next batch of transactions and an error if any from the sequencer | ||||||||
| GetNextBatch(ctx context.Context, req GetNextBatchRequest) (*GetNextBatchResponse, error) | ||||||||
|  | ||||||||
| // VerifyBatch verifies a batch of transactions received from the sequencer | ||||||||
| // Id is the unique identifier for the chain | ||||||||
| // Id is the unique identifier for the target chain | ||||||||
| There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The comment should refer to the 'target chain' for clarity. It's important to be specific in documentation to avoid ambiguity. 
        Suggested change
       
 | ||||||||
| // BatchHash is the cryptographic hash of the batch to verify | ||||||||
| // returns a boolean indicating if the batch is valid and an error if any from the sequencer | ||||||||
| VerifyBatch(ctx context.Context, req VerifyBatchRequest) (*VerifyBatchResponse, error) | ||||||||
|  | ||||||||
| Original file line number | Diff line number | Diff line change | ||||||
|---|---|---|---|---|---|---|---|---|
|  | @@ -10,20 +10,20 @@ | |||||||
| // Sequencer is a generic interface for a sequencer | ||||||||
| type Sequencer interface { | ||||||||
| // SubmitBatchTxs submits a batch of transactions to sequencer | ||||||||
| // Id is the unique identifier for the chain | ||||||||
| // Id is the unique identifier for the target chain | ||||||||
| // Batch is the batch of transactions to submit | ||||||||
| // returns an error if any from the sequencer | ||||||||
| SubmitBatchTxs(ctx context.Context, req SubmitBatchTxsRequest) (*SubmitBatchTxsResponse, error) | ||||||||
|  | ||||||||
| // GetNextBatch returns the next batch of transactions from sequencer to | ||||||||
| // Id is the unique identifier for the chain | ||||||||
| // Id is the unique identifier for the target chain | ||||||||
| There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The comment should refer to the 'target chain' for clarity. It's important to be specific in documentation to avoid ambiguity. 
        Suggested change
       
 | ||||||||
| // LastBatchHash is the cryptographic hash of the last batch received by the | ||||||||
| // MaxBytes is the maximum number of bytes to return in the batch | ||||||||
| // returns the next batch of transactions and an error if any from the sequencer | ||||||||
| GetNextBatch(ctx context.Context, req GetNextBatchRequest) (*GetNextBatchResponse, error) | ||||||||
|  | ||||||||
| // VerifyBatch verifies a batch of transactions received from the sequencer | ||||||||
| // Id is the unique identifier for the chain | ||||||||
| // Id is the unique identifier for the target chain | ||||||||
| There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The comment should refer to the 'target chain' for clarity. It's important to be specific in documentation to avoid ambiguity. 
        Suggested change
       
 | ||||||||
| // BatchHash is the cryptographic hash of the batch to verify | ||||||||
| // returns a boolean indicating if the batch is valid and an error if any from the sequencer | ||||||||
| VerifyBatch(ctx context.Context, req VerifyBatchResponse) (*VerifyBatchResponse, error) | ||||||||
|  | ||||||||
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.
The comment should refer to the 'target chain' for clarity.
It's important to be specific in documentation to avoid ambiguity.