Update Readme to reflect new api

I am opening this PR for us to discuss the Readme content. I

 did some basic changes to reflect the new api, but I think the readme is still a little confusing. We don't explain what exactly is a contract until way down in the document and also we could provide some more comprehensive examples for the method calls