Skip to content

Update Wallet API

David Burkett edited this page Apr 9, 2019 · 1 revision

Attempts to rewind unspent outputs in the blockchain, looking for outputs that belong to the user/wallet, and adding them to the wallet's transaction history. The first time this is called (typically following create or restore wallet), the entire UTXO set is scanned (takes 2-10s). On all subsequent calls, only new UTXOs are checked.

URL : /v1/wallet/owner/update_wallet

Query Parameters :

  • fromGenesis: If supplied, will restore outputs starting from genesis. This isn't required in normal workflows, and can take 2-10s. On an extremely rare occasion, an output could be missed due to unfortunate timing of a chain re-org, which is the only known use-case for this.

Method : POST

Headers

  • session_token(string): The user's session token in base64.

Request Body: None/Empty

Responses

Success

Code : 200 OK

Content: None/Empty


Internal Server Error

Condition : If an unknown error occurs.

Code : 500 INTERNAL SERVER ERROR

Content :

"CheckForOutputs failed"

Unauthorized

Condition : If 'session_token' is missing or invalid.

Code : 401 UNAUTHORIZED

Content :

"session_token is missing or invalid."