added helper fns to client facing api