Thawseries

From Open Transactions
Revision as of 13:47, 23 September 2014 by Justusranvier (talk | contribs) (Add version argument, argument names and descriptions)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Description

This call adds an extended private key to an existing series. The blockchain wallet takes the provided xpriv and applies it to the correct branch corresponding to its xpub.

Status

Version 1 Release candidate
This version of the specification contains is believed to be complete, but is still subject to revision before version 1

Arguments

version
Currently required to be 1. May be incremented for future expansions to the voting pool specification.
series
A series identifier for the series containing the extended public key (xpub) to be made capable of signing transactions.
key
The extended private key (xpriv) which empowers an xpub in the specified series.

Return Values

Data

none

Errors

Success
The wallet has successfully added the xpriv to its corresponding xpub in the given series.
Incorrect version
The supplied version does not match the version of the series being thawed.
Invalid series
The supplied series is not defined in the wallet.
No matching pubkey
None of the xpubs in the supplied series match the supplied xpriv.
Invalid privkey
The supplied xpriv is not a valid BIP32 extended private key.