Given at least 624 outputs of a Mersenne Twister PNRG we can restore its internal state.
Clone or download
Latest commit 82a6e4d Jul 25, 2015
Type Name Latest commit message Commit time
Failed to load latest commit information. style Jul 25, 2015 style Jul 25, 2015 Update Jul 25, 2015


Given at least 624 outputs of a Mersenne Twister we can restore its internal state. The Mersenne Twister is used as PRNG in many programming languages such as PHP, Python, Ruby, etc. Please refer to Mersenne Twister for detailed descriptions.


Simply pass a list of observed outputs to the go() method:

  r1 = random.Random(31337)
  outputs = [r1.getrandbits(32) for _ in range(625)]
  mtr = MT19937Recover()
  r2 = mtr.go(outputs)
  assert r1.getrandbits(32) == r2.getrandbits(32)

Internal State

The internal state of a Mersenne Twister consists of 624 integers and an index. Whenever a random number is requested, a tempering function is applied to the integer to which the index is currently pointing and the index is incremented. When the index reaches 624, a new set of 624 integers is generated, which is called the twist.

Recovering internal state

Recovering the internal state is done by applying the inverse of the tampering function to each observed output, which will yield the internal 624 integers. However, if the observed 624 integers were not generated directly after a twist, another observed output is required to recover the correct index.