updated API, test file, readme