Prysm v4 - mark old endpoints for deprecation

proto/eth/service/beacon_chain_service.proto

@@ -53,7 +53,9 @@ service BeaconChain {
 
   // GetWeakSubjectivity is a new proposed endpoint to retrieve the details necessary to download
   // the ssz data needed to start a beacon node - checkpoint(epoch + block_root) and state_root
+  // DEPRECATED: GetWeakSubjectivity endpoint will no longer be supported
   rpc GetWeakSubjectivity(google.protobuf.Empty) returns (v1.WeakSubjectivityResponse) {
+    option deprecated = true;
     option (google.api.http) = { get: "/internal/eth/v1/beacon/weak_subjectivity" };
   }
 
@@ -186,6 +188,7 @@ service BeaconChain {
   //
   // Spec: https://ethereum.github.io/beacon-APIs/?urls.primaryName=v2.3.0#/Beacon/publishBlock
   rpc SubmitBlockSSZ(v2.SSZContainer) returns (google.protobuf.Empty) {
+    option deprecated = true;
     option (google.api.http) = {
       post: "/internal/eth/v1/beacon/blocks/ssz"
       body: "*"
@@ -240,7 +243,9 @@ service BeaconChain {
   // GetBlock retrieves block details for given block id.
   //
   // Spec: https://ethereum.github.io/beacon-APIs/?urls.primaryName=v2.3.0#/Beacon/getBlock
+  // DEPRECATED: GetBlock is deprecated in favor of GetBlockV2
   rpc GetBlock(v1.BlockRequest) returns (v1.BlockResponse) {
+    option deprecated = true;
     option (google.api.http) = {
       get: "/internal/eth/v1/beacon/blocks/{block_id}"
     };
@@ -249,7 +254,9 @@ service BeaconChain {
   // GetBlockSSZ returns the SSZ-serialized version of block details for given block id.
   //
   // Spec: https://ethereum.github.io/beacon-APIs/?urls.primaryName=v2.3.0#/Beacon/getBlock
+  // DEPRECATED: GetBlockSSZ is deprecated in favor of GetBlockV2SSZ
   rpc GetBlockSSZ(v1.BlockRequest) returns (v1.BlockSSZResponse) {
+    option deprecated = true;
     option (google.api.http) = {
       get: "/internal/eth/v1/beacon/blocks/{block_id}/ssz"
     };

proto/eth/v1/beacon_chain.proto

@@ -293,11 +293,15 @@ message DepositContract {
     string address = 2;
 }
 
+// DEPRECATED: GetWeakSubjectivity endpoint will no longer be supported
 message WeakSubjectivityResponse {
+    option deprecated = true;
 	WeakSubjectivityData data = 1;
 }
 
+// DEPRECATED: GetWeakSubjectivity endpoint will no longer be supported
 message WeakSubjectivityData {
+    option deprecated = true;
     ethereum.eth.v1.Checkpoint ws_checkpoint = 1;
     bytes state_root = 2;
 }

proto/prysm/v1alpha1/beacon_chain.proto

@@ -34,7 +34,6 @@ option php_namespace = "Ethereum\\Eth\\v1alpha1";
 //
 // The beacon chain API can be used to access data relevant to the Ethereum Beacon Chain.
 service BeaconChain {
-    // TODO(preston): Batch requests?
 
     // Retrieve attestations by block root, slot, or epoch.
     //
@@ -62,15 +61,19 @@ service BeaconChain {
 
     // Server-side stream of attestations as they are received by
     // the beacon chain node.
+    // DEPRECATED: This endpoint is superseded by the /eth/v1/events Beacon API endpoint, there is an internal GRPC endpoint /internal/eth/v1/events
     rpc StreamAttestations(google.protobuf.Empty) returns (stream Attestation) {
+        option deprecated = true;
         option (google.api.http) = {
             get: "/eth/v1alpha1/beacon/attestations/stream"
         };
     }
 
     // Server-side stream of indexed attestations as they are received by
     // the beacon chain node.
+    // DEPRECATED: This endpoint is superseded by the /eth/v1/events Beacon API endpoint, there is an internal GRPC endpoint /internal/eth/v1/events
     rpc StreamIndexedAttestations(google.protobuf.Empty) returns (stream IndexedAttestation) {
+        option deprecated = true;
         option (google.api.http) = {
             get: "/eth/v1alpha1/beacon/attestations/indexed/stream"
         };
@@ -106,7 +109,9 @@ service BeaconChain {
 
     // Server-side stream of all signed blocks as they are received by
     // the beacon chain node.
+    // DEPRECATED: This endpoint is superseded by the /eth/v1/events Beacon API endpoint, there is an internal GRPC endpoint /internal/eth/v1/events
     rpc StreamBlocks(StreamBlocksRequest) returns (stream SignedBeaconBlock) {
+        option deprecated = true;
         option (google.api.http) = {
             get: "/eth/v1alpha1/beacon/blocks/stream"
         };
@@ -117,7 +122,9 @@ service BeaconChain {
     //
     // This includes the head block slot and root as well as information about
     // the most recent finalized and justified slots.
+    // DEPRECATED: This endpoint is superseded by the /eth/v1/events Beacon API endpoint, there is an internal GRPC endpoint /internal/eth/v1/events
     rpc StreamChainHead(google.protobuf.Empty) returns (stream ChainHead) {
+        option deprecated = true;
         option (google.api.http) = {
             get: "/eth/v1alpha1/beacon/chainhead/stream"
         };
@@ -232,7 +239,9 @@ service BeaconChain {
     }
 
     // Server-side stream of validator information at each epoch.
+    // DEPRECATED: This endpoint is superseded by the /eth/v1/events Beacon API endpoint, there is an internal GRPC endpoint /internal/eth/v1/events
     rpc StreamValidatorsInfo(stream ValidatorChangeSet) returns (stream ValidatorInfo) {
+        option deprecated = true;
         option (google.api.http) = {
             get: "/eth/v1alpha1/beacon/validators/info/stream"
         };
@@ -271,7 +280,9 @@ enum SetAction {
 }
 
 // ValidatorChangeSet updates the server's list of keys on which to operate.
+// DEPRECATED: This message's endpoint is superseded by the /eth/v1/events Beacon API endpoint, there is an internal GRPC endpoint /internal/eth/v1/events
 message ValidatorChangeSet {
+    option deprecated = true;
     // Action (add/remove/set).
     SetAction action = 1;
 

proto/prysm/v1alpha1/debug.proto

@@ -52,7 +52,9 @@ service Debug {
         };
     }
     // Returns the inclusion slot of a given attester id and slot.
+    // DEPRECATED: This endpoint doesn't appear to be used and have been marked for deprecation.
     rpc GetInclusionSlot(InclusionSlotRequest) returns (InclusionSlotResponse) {
+        option deprecated = true;
         option (google.api.http) = {
             get: "/eth/v1alpha1/debug/inclusion"
         };