[Reviewer: Rob][From: Alex] Update homestead API docs to reflect new API (fixes #39)

Rob, please can you review? Not particularly urgent since I don't think anyone is programming to the homestead API, but it would be nice to get this pulled in the next week or so.