replayEventsFromFile
Replay blockchain events from a file, discovering shielded coins.
The cold/full shielded sync at PreProd scale must not pass the entire event log as one giant hex String — that JVM allocation spike triggers GC pauses that freeze the UI. The caller streams events to filePath (one hex event per line) and the native side reads them back and replays in 500-event chunks, keeping peak memory bounded. Mirrors com.midnight.kuira.core.crypto.dust.DustLocalState.replayEventsFromFile.
Return
New state with discovered coins, or null on error
Parameters
seed
32-byte zswap seed (derived at m/44'/2400'/0'/3/0)
filePath
Absolute path to the hex events file (one event per line)