update readme, clean up interfaces a bit