states for the requester.
doc comments.