Clarify RANDAO API description

ethereum · Sep 26, 2022 · cbc6958 · cbc6958
1 parent bfff1d8
commit cbc6958
Showing 1 changed file with 6 additions and 2 deletions.
diff --git a/apis/beacon/states/randao.yaml b/apis/beacon/states/randao.yaml
@@ -1,10 +1,14 @@
 get:
   operationId: "getStateRandao"
-  summary: "Get the RANDAO mix for some epoch."
+  summary: "Get the RANDAO mix for some epoch in a specified state."
   description: |
-    Fetch the RANDAO mix for a requested epoch from the state identified by `state_id`.
+    Fetch the RANDAO mix for the requested epoch from the state identified by `state_id`.
 
     If an epoch is not specified then the RANDAO mix for the state's current epoch will be returned.
+
+    By adjusting the `state_id` parameter you can query for any historic value of the RANDAO mix.
+    Ordinarily states from the same epoch will mutate the RANDAO mix for that epoch as blocks are
+    applied.
   tags:
     - Beacon
   parameters: