adds 3 new functions to the user-facing api