defined some interfaces, updated readme