Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions core/sequencer/sequencing.go
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The comment should refer to the 'target chain' for clarity.

It's important to be specific in documentation to avoid ambiguity.

Suggested change
// Id is the unique identifier for the target chain
// GetNextBatch returns the next batch of transactions from sequencer to
// 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
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The comment should refer to the 'target chain' for clarity.

It's important to be specific in documentation to avoid ambiguity.

Suggested change
// Id is the unique identifier for the target chain
// VerifyBatch verifies a batch of transactions received from the sequencer
// Id is the unique identifier for the target chain

// 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)
Expand Down
6 changes: 3 additions & 3 deletions docs/learn/sequencing/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The comment should refer to the 'target chain' for clarity.

It's important to be specific in documentation to avoid ambiguity.

Suggested change
// Id is the unique identifier for the target chain
// GetNextBatch returns the next batch of transactions from sequencer to
// 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
Copy link
Contributor

Choose a reason for hiding this comment

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

medium

The comment should refer to the 'target chain' for clarity.

It's important to be specific in documentation to avoid ambiguity.

Suggested change
// Id is the unique identifier for the target chain
// VerifyBatch verifies a batch of transactions received from the sequencer
// Id is the unique identifier for the target chain

// 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)
Expand Down
Loading