add @throws declarations; signalize nullability
include Nullability in README