From cbc69587ff04d66b0fa424e6f06370ca38e9b038 Mon Sep 17 00:00:00 2001 From: Michael Sproul Date: Mon, 26 Sep 2022 10:09:21 +1000 Subject: [PATCH] Clarify RANDAO API description --- apis/beacon/states/randao.yaml | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/apis/beacon/states/randao.yaml b/apis/beacon/states/randao.yaml index f137b0e6..b32b1352 100644 --- 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: