diff --git a/proto/composerapis/astria/auctioneer/v1alpha1/bundle.proto b/proto/composerapis/astria/auctioneer/v1alpha1/bundle.proto index 26a95b84e0..e039b47c29 100644 --- a/proto/composerapis/astria/auctioneer/v1alpha1/bundle.proto +++ b/proto/composerapis/astria/auctioneer/v1alpha1/bundle.proto @@ -2,38 +2,38 @@ syntax = "proto3"; package astria.auctioneer.v1alpha1; -import "google/protobuf/timestamp.proto"; -import "google/protobuf/empty.proto"; -import "astria/execution/v1alpha2/execution.proto"; import "astria/auctioneer/v1alpha1/optimistic_block.proto"; +import "astria/execution/v1alpha2/execution.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/timestamp.proto"; // Information for the bundle submitter to know how to submit the bundle. // The fee and base_sequencer_block_hash are not necessarily strictly necessary // it allows for the case where the server doesn't always send the highest fee // bundles after the previous but could just stream any confirmed bundles. message Bundle { - // The fee that can be expected to be received for submitting this bundle. - // This allows the bundle producer to stream any confirmed bundles they would be ok - // with submitting. Used to avoid race conditions in received bundle packets. Could - // also be used by a bundle submitter to allow multiple entities to submit bundles. - uint64 fee = 1; - // The byte list of transactions to be included. - repeated bytes transactions = 2; - // The base_sequencer_block_hash is the hash from the base block this bundle - // is based on. This is used to verify that the bundle is based on the correct - // Sequencer block. - bytes base_sequencer_block_hash = 3; - // The hash of previous rollup block, on top of which the bundle will be executed as ToB. - bytes prev_rollup_block_hash = 4; + // The fee that can be expected to be received for submitting this bundle. + // This allows the bundle producer to stream any confirmed bundles they would be ok + // with submitting. Used to avoid race conditions in received bundle packets. Could + // also be used by a bundle submitter to allow multiple entities to submit bundles. + uint64 fee = 1; + // The byte list of transactions to be included. + repeated bytes transactions = 2; + // The base_sequencer_block_hash is the hash from the base block this bundle + // is based on. This is used to verify that the bundle is based on the correct + // Sequencer block. + bytes base_sequencer_block_hash = 3; + // The hash of previous rollup block, on top of which the bundle will be executed as ToB. + bytes prev_rollup_block_hash = 4; } // Geth will serve this to the Auctioneer service BundleService { - // Stream blocks from the Auctioneer to Geth for optimistic execution. Geth will stream back - // metadata from the executed blocks. - rpc ExecuteOptimisticBlocks(stream BaseBlock) returns (stream astria.execution.v1alpha2.Block); - // A bundle submitter requests bundles given a new optimistic Sequencer block, - // and receives a stream of potential bundles for submission, until either a timeout - // or the connection is closed by the client. - rpc StreamBundles(google.protobuf.Empty) returns (stream Bundle); + // Stream blocks from the Auctioneer to Geth for optimistic execution. Geth will stream back + // metadata from the executed blocks. + rpc ExecuteOptimisticBlocks(stream BaseBlock) returns (stream astria.execution.v1alpha2.Block); + // A bundle submitter requests bundles given a new optimistic Sequencer block, + // and receives a stream of potential bundles for submission, until either a timeout + // or the connection is closed by the client. + rpc StreamBundles(google.protobuf.Empty) returns (stream Bundle); } diff --git a/proto/sequencerblockapis/astria/sequencerblock/v1alpha1/optimistic_block.proto b/proto/sequencerblockapis/astria/sequencerblock/v1alpha1/optimistic_block.proto index 33b250f87f..8dd64aefee 100644 --- a/proto/sequencerblockapis/astria/sequencerblock/v1alpha1/optimistic_block.proto +++ b/proto/sequencerblockapis/astria/sequencerblock/v1alpha1/optimistic_block.proto @@ -2,46 +2,46 @@ syntax = "proto3"; package astria.auctioneer.v1alpha1; -import "google/protobuf/timestamp.proto"; -import "google/protobuf/empty.proto"; import "astria/execution/v1alpha2/execution.proto"; -import "astria/sequencerblock/v1alpha1/block.proto"; import "astria/primitive/v1/types.proto"; +import "astria/sequencerblock/v1alpha1/block.proto"; +import "google/protobuf/empty.proto"; +import "google/protobuf/timestamp.proto"; // The "BaseBlock" is the information needed to simulate bundles on top of // a Sequencer block which may not have been committed yet. message BaseBlock { - // This is the block hash for the proposed block. - bytes sequencer_block_hash = 1; - // List of transactions to include in the new block. - repeated astria.sequencerblock.v1alpha1.RollupData transactions = 2; - // Timestamp to be used for new block. - google.protobuf.Timestamp timestamp = 3; + // This is the block hash for the proposed block. + bytes sequencer_block_hash = 1; + // List of transactions to include in the new block. + repeated astria.sequencerblock.v1alpha1.RollupData transactions = 2; + // Timestamp to be used for new block. + google.protobuf.Timestamp timestamp = 3; } // Identifying metadata for blocks that have been successfully committed in the Sequencer. message BlockCommit { - // Height of the sequencer block that was committed. - uint64 height = 1; - // Hash of the sequencer block that was committed. - bytes block_hash = 2; + // Height of the sequencer block that was committed. + uint64 height = 1; + // Hash of the sequencer block that was committed. + bytes block_hash = 2; } message StreamOptimisticBlockRequest { - // The rollup id for which the Sequencer block is being streamed. - astria.primitive.v1.RollupId rollup_id = 1; + // The rollup id for which the Sequencer block is being streamed. + astria.primitive.v1.RollupId rollup_id = 1; } message StreamOptimisticBlockResponse { - // The optimistic Sequencer block that is being streamed, filtered for the provided rollup id. - astria.sequencerblock.v1alpha1.FilteredSequencerBlock block = 1; + // The optimistic Sequencer block that is being streamed, filtered for the provided rollup id. + astria.sequencerblock.v1alpha1.FilteredSequencerBlock block = 1; } // The Sequencer will serve this to the aucitoneer service OptimisticBlockService { - // The Sequencer will stream the optimistic Sequencer block (filtered for the provided - // rollup id) to the Auctioneer. - rpc StreamOptimisticBlock(StreamOptimisticBlockRequest) returns (stream StreamOptimisticBlockResponse); - // The Sequencer will stream the block commits to the Auctioneer. - rpc StreamBlockCommitments(google.protobuf.Empty) returns (stream BlockCommit); + // The Sequencer will stream the optimistic Sequencer block (filtered for the provided + // rollup id) to the Auctioneer. + rpc StreamOptimisticBlock(StreamOptimisticBlockRequest) returns (stream StreamOptimisticBlockResponse); + // The Sequencer will stream the block commits to the Auctioneer. + rpc StreamBlockCommitments(google.protobuf.Empty) returns (stream BlockCommit); }