update readme & code to use random 'state' parameter