updated README and tests with API draft