updated interface functions + comments