Update Wallet API specification draft document

Latest discussion with frontend'd folks has yield a couple of interesting points.
This draft is the final draft and may change as we start implementing the various
features.