refactored peerQuery to pass the full server response object back to the application developer
tweaks to example and docs
fixed merge conflict