Added some comments re: sequence size in ScaledEntropyCallback. (#19)

Co-authored-by: Brian Weickmann <[email protected]>

Author: bweick

contracts/ScaledEntropyProvider.sol

@@ -106,7 +106,9 @@ contract ScaledEntropyProvider is Ownable, IScaledEntropyProvider, IEntropyConsu
     /**
      * @notice Requests scaled random numbers from Pyth Network with callback delivery
      * @dev Submits entropy request to Pyth Network and stores callback details for async delivery.
-     *      The callback will receive scaled random numbers according to the specified requests.
+     *      The callback will receive scaled random numbers according to the specified requests. Developer
+     *      needs to ensure that the range is not too large to be able to build an array of the appropriate
+     *      size in memory in order to avoid out of gas errors during Fisher-Yates sampling.
      *      IMPORTANT: The callback address is automatically set to msg.sender (the calling contract).
      * @param _gasLimit Gas limit for the entropy callback execution
      * @param _requests Array of SetRequest structs defining random number requirements

contracts/lib/FisherYatesWithRejection.sol

@@ -22,7 +22,9 @@ library FisherYatesRejection {
      *      2. Using Fisher-Yates shuffle with rejection sampling to avoid modulo bias
      *      3. Selecting the first 'count' numbers from the shuffled pool
      *      The rejection sampling ensures uniform distribution by rejecting random values
-     *      that would create bias when reduced to the required range.
+     *      that would create bias when reduced to the required range. Developer needs to ensure
+     *      that the range is not too large to be able to build an array of the appropriate size
+     *      in memory.
      * @param minRange Minimum value in the selection range (inclusive)
      * @param maxRange Maximum value in the selection range (inclusive)
      * @param count Number of unique values to select