37 lines
1.3 KiB
Python
37 lines
1.3 KiB
Python
"""Deterministic per-chunk seed derivation."""
|
|
|
|
from __future__ import annotations
|
|
|
|
_MASK64 = (1 << 64) - 1
|
|
_GOLDEN = 0x9E3779B97F4A7C15
|
|
_MIX_A = 0xBF58476D1CE4E5B9
|
|
_MIX_B = 0x94D049BB133111EB
|
|
|
|
|
|
def _splitmix64(value: int) -> int:
|
|
value = (value + _GOLDEN) & _MASK64
|
|
value = ((value ^ (value >> 30)) * _MIX_A) & _MASK64
|
|
value = ((value ^ (value >> 27)) * _MIX_B) & _MASK64
|
|
return (value ^ (value >> 31)) & _MASK64
|
|
|
|
|
|
def derive_chunk_seed(base_seed: int, chunk_index: int, reroll_nonce: int = 0) -> int:
|
|
"""Return a stable 64-bit seed for a zero-based chunk index.
|
|
|
|
The index and reroll nonce are mixed independently so rerolling chunk N does
|
|
not alter accepted chunks before N.
|
|
"""
|
|
|
|
if isinstance(base_seed, bool) or isinstance(chunk_index, bool) or isinstance(reroll_nonce, bool):
|
|
raise TypeError("seed inputs must be integers, not booleans")
|
|
chunk_index = int(chunk_index)
|
|
reroll_nonce = int(reroll_nonce)
|
|
if chunk_index < 0:
|
|
raise ValueError("chunk_index must be non-negative")
|
|
if reroll_nonce < 0:
|
|
raise ValueError("reroll_nonce must be non-negative")
|
|
value = int(base_seed) & _MASK64
|
|
value ^= _splitmix64(chunk_index + 1)
|
|
value ^= _splitmix64((reroll_nonce + 1) * 0xD6E8FEB86659FD93)
|
|
return _splitmix64(value)
|