state tracking
API for sample tracking, tested, updated