adding some utilities, API fixed
README update