add public calls and update README.md