Constants & source of truth

The load-bearing numbers behind the engine, and the files that are the source of truth for every claim in these docs. If a number here disagrees with the code, the code wins.

#Engine constants

kUnit

65,536 sub-units per board unit (1 << 16) - the fixed-point scale.

kTrig

4,096 - fixed-point 1.0 for the baked sine table.

kTickRate

120 Hz - the only clock the simulation trusts.

kSimVersion

49 - physics + state-layout version; bumping it invalidates golden replays.

ABI version

9 - the C-ABI struct layout, tracked separately from the sim version.

checkpoint interval

30 ticks (0.25 s) - how often a state hash is captured.

parity rollup

0x9671f5c32f16d0d2 - the hash all four targets must agree on.

#Physics tunables

ball (normal)

radius 700 · restitution 205/256 (~0.80) · launch speed 900.

ball (heavy)

radius 950 · restitution 150/256 · launch speed 760 · power 2.

gravity_accel

22 sub-units / tick² (default, pulling South).

max_speed

2,200 sub-units / tick - the anti-tunnelling clamp.

wall_restitution

205/256 - walls only reflect a ball moving into them.

kSweepStep

150 sub-units - swept-collision sample spacing.

kVelDmgDiv / kChipMin

700 / 1 - damage = max(1, power + |v·n|/700); 6-tick re-hit cooldown.

#Chain & economy constants

escrow program

ricochet_escrow · devnet Gm1CjXJAor3sYy2ZvSCxmZSZqj9Q7Wy9NtZp7PuSfEgc.

MAX_PROTOCOL_FEE_BPS

500 - a hard 5% ceiling on every fee schedule.

MAX_RANDOMNESS_LEAVES

1,000,000 - the randomness-deck leaf cap (not a player count).

strike timeouts

1st → 1 hour · 2nd → 24 hours · 3rd → permanent ban.

lock schedule

co-stake locks: now · 1 week · 2 weeks · 1 month · 3 months.

player ceiling

100 seats per match - proven, enforced end to end.

#Source-of-truth files