Accessing a Random Seed with a Smart Contract

Omni Bridge xDai Bridge Gnosis Beacon Chain Docs Block Explorer
Search…
The RandomAura contract allows smart contracts to access a random number generated on-chain by the protocol.
Public getters:
currentSeed: access the network's random seed.
collectRoundLength: length in blocks for each collection round (commit + reveal phases)
isCommitPhase: returns true if current block is in commit phase
nextCommitPhaseStartBlock : retrieve block number of first block in next commit phase.
nextRevealPhaseStartBlock : retrieve block number of first block in next reveal phase.
The public getter currentSeed is used to access the network's random seed. Its value is only updated when the revealNumber function is called. This should occur at least once per collection round. The length in blocks of each collection round can be retrieved with the collectRoundLength public getter.
There are two phases in each round, a commit phase and a reveal phase. Since the revealing validator always knows the next random number before sending it, a DApp should prohibit business logic actions that depend on a random value during the reveal phase. 
For example, a gambling application that relies on a random value should only allow bets to be placed during the commit phase. This type of application must prevent users from placing new bets during the entire reveal phase.
To determine the current phase, use the isCommitPhase public getter: it returns true if the current block is in the commit phase and false if the block is in the reveal phase. 
To retrieve the number of the first block of the next commit phase, use the nextCommitPhaseStartBlock public getter. To do the same for the reveal phase, use the nextRevealPhaseStartBlock public getter.

Random numbers are updated during the reveal phase when validators produce block for the first time.  For example, there can be 17 validators, but the reveal phase length is 38 blocks. So, during the reveal phase, the current seed will only be updated 17 times.
The commit & reveal phases have lengths of 38 blocks each. The total collection round (commit phase + reveal phase) has 76 blocks (38+38).
Example code to retrieve a random seed
pragma solidity 0.5.16;
​
​
interface IPOSDAORandom {
    function collectRoundLength() external view returns(uint256);
    function currentSeed() external view returns(uint256);
}
​
contract Example {
    IPOSDAORandom private _posdaoRandomContract; // address of RandomAuRa contract
    uint256 private _seed;
    uint256 private _seedLastBlock;
    uint256 private _updateInterval;
​
    constructor(IPOSDAORandom _randomContract) public {
        require(_randomContract != IPOSDAORandom(0));
        _posdaoRandomContract = _randomContract;
        _seed = _randomContract.currentSeed();
        _seedLastBlock = block.number;
        _updateInterval = _randomContract.collectRoundLength();
        require(_updateInterval != 0);
    }
​
    function useSeed() public {
        if (_wasSeedUpdated()) {
            // using updated _seed ...
        } else {
            // using _seed ...
        }
    }
​
    function _wasSeedUpdated() private returns(bool) {
        if (block.number - _seedLastBlock <= _updateInterval) {
            return false;
        }
​
        _updateInterval = _posdaoRandomContract.collectRoundLength();
​
        uint256 remoteSeed = _posdaoRandomContract.currentSeed();
        if (remoteSeed != _seed) {
            _seed = remoteSeed;
            _seedLastBlock = block.number;
            return true;
        }
        return false;
    }
}
RandomAura RNG Explainer
Randomness FAQs
Last modified 3mo ago
Copy link
Outline
Example code to retrieve a random seed