docs: quorum number requirement for payment method (#1196)

Layr-Labs · Feb 5, 2025 · 324002c · 324002c
1 parent 545f0d3
commit 324002c
Show file tree

Hide file tree

Showing 6 changed files with 30 additions and 14 deletions.
diff --git a/api/docs/common_v2.html b/api/docs/common_v2.html
diff --git a/api/docs/common_v2.md b/api/docs/common_v2.md
diff --git a/api/docs/eigenda-protos.html b/api/docs/eigenda-protos.html
diff --git a/api/docs/eigenda-protos.md b/api/docs/eigenda-protos.md
diff --git a/api/grpc/common/v2/common_v2.pb.go b/api/grpc/common/v2/common_v2.pb.go
diff --git a/api/proto/common/v2/common_v2.proto b/api/proto/common/v2/common_v2.proto
@@ -11,11 +11,14 @@ message BlobHeader {
   // blob's availability.
   uint32 version = 1;
   // quorum_numbers is the list of quorum numbers that the blob is part of.
-  // All quorums must be specified (including required quorums).
+  // Each quorum will store the data, hence adding quorum numbers adds redundancy, making the blob more likely to be retrievable. Each quorum requires separate payment.
   //
-  // The following quorums are currently required:
+  // On-demand dispersal is currently limited to using a subset of the following quorums:
   // - 0: ETH
   // - 1: EIGEN
+  // 
+  // Reserved-bandwidth dispersal is free to use multiple quorums, however those must be reserved ahead of time. The quorum_numbers specified here must be a subset of the ones allowed by the on-chain reservation. 
+  // Check the allowed quorum numbers by looking up reservation struct: https://github.com/Layr-Labs/eigenda/blob/1430d56258b4e814b388e497320fd76354bfb478/contracts/src/interfaces/IPaymentVault.sol#L10
   repeated uint32 quorum_numbers = 2;
   // commitment is the KZG commitment to the blob
   common.BlobCommitment commitment = 3;