# Difference between revisions of "Createseries"

Jump to navigation
Jump to search

m |
(→Errors: Note that series numbers must increase monotonically) |
||

Line 45: | Line 45: | ||

:Each xpub supplied must be a valid [[BIP32]] extended public key. | :Each xpub supplied must be a valid [[BIP32]] extended public key. | ||

;Invalid series | ;Invalid series | ||

− | :Series numbers supplied as part of the <code>series identifier</code> must be positive integers. | + | :Series numbers supplied as part of the <code>series identifier</code> must be positive integers, and must be exactly one higher than the current highest defined series for the pool. |

[[Category:Voting Pool Wallet API]] | [[Category:Voting Pool Wallet API]] |

## Latest revision as of 16:34, 16 January 2015

## Description

This call instructs the blockchain wallet to create and populate new series.

## 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
- Should be 1. This field allows for future expansion of the voting pool wallet specification.

- series identifier
- The series to be created

- required signatures
- The number of signatures needed to sign an outgoing transaction. This is the
`m`

value for the`m-of-n`

multiscript opcode.

- list of xpubs
- The
`n`

value for the`m-of-n`

multiscript opcode is implicitly derived from the number of xpubs provided here.

## Return Values

### Data

none

### Errors

- Success
- The wallet has created the series.
- Unknown version
- The wallet does not support the supplied version number.
- Series already exists
- This call should not allow the same series number to be created in the same voting pool. If it's necessary to change an already-defined series, the
`replaceseries`

call should be used instead. - 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, and must be exactly one higher than the current highest defined series for the pool.