Add comments

world-federation-of-advertisers · Feb 7, 2024 · c574f0f · c574f0f
1 parent f12287f
commit c574f0f
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/src/main/proto/wfa/measurement/api/v2alpha/protocol_config.proto b/src/main/proto/wfa/measurement/api/v2alpha/protocol_config.proto
@@ -237,6 +237,11 @@ message ProtocolConfig {
       ReachOnlyLiquidLegionsV2 reach_only_liquid_legions_v2 = 3;
 
       // Honest Majority Shuffle Based Secret Sharing protocol.
+      //
+      // `Requisition`s using this protocol can be fulfilled by calling
+      // RequisitionFulfillment/FulfillRequisition with a sketch and a secret
+      // seed. The Requisition should be fulfilled at the Duchy specified by
+      // Requisition/fulfilling_duchy.
       HonestMajorityShareShuffle honest_majority_share_shuffle = 4;
     }
   }

diff --git a/src/main/proto/wfa/measurement/api/v2alpha/requisition.proto b/src/main/proto/wfa/measurement/api/v2alpha/requisition.proto
@@ -168,6 +168,14 @@ message Requisition {
     (google.api.field_behavior) = IMMUTABLE
   ];
 
+  // The `resource` name of the Duchy to fulfill the requisition at.
+  //
+  // If present, must fulfill the requisition at the target Duchy.
+  string fulfilling_duchy = 16 [
+    (google.api.resource_reference).type = "halo.wfanet.org/Duchy",
+    (google.api.field_behavior) = OUTPUT_ONLY
+  ];
+
   // State of a `Requisition`.
   enum State {
     // Default value if state is omitted. Should never be used.