Replaceseries
Description
This call instructs the blockchain wallet to replace an already-defined series with a new one. This will occur with the structure of the voting pool is changed.
Series which have already been thawed or activated may not be replaced.
Arguments
- version
- Should be 1. This field allows for future expansion of the voting pool wallet specification.
- series identifier
- The series to be replaced
- required signatures
- The number of signatures needed to sign an outgoing transaction. This is the
m
value for them-of-n
multiscript opcode.
- list of xpubs
- The
n
value for them-of-n
multiscript opcode is implicitly derived from the number of xpubs provided here.
Return Values
Data
None
Errors
- Success
- The wallet has replaced the given series with the new definition.
- Unknown version
- The wallet does not support the supplied version number.
- Series node defined
- The series to be replaced must already exist.
- Too many pubkeys
- This error indicates that more than the maximum number of pubkeys allowed by
OP_CHECKMULTISIG
have been supplied. - Duplicate pubkeys
- xpubs in a series must be unique.
- Insufficient pubkeys
- The number of xpubs supplied must be larger than
required signatures
- Invalid pool
- The pool supplied as part of the
series identifier
must be a valid color definition. - Invalid pubkey
- Each xpub supplied must be a valid BIP32 extended public key.
- Invalid series
- Series numbers supplied as part of the
series identifier
must be positive integers. - Series not cold
- In order to avoid losing deposits, a series that has been thawed may not be replaced.
- Series already active
- In order to avoid losing deposits, a series that has been activated may not be replaced.