exposed api for events, added some pertinent information to README