core: api implementation prototype