just dumping some more e3x notes, trying to refine internal api further