Createseries - Revision history

Justusranvier: /* Errors */ Note that series numbers must increase monotonically

2015-01-16T16:34:49Z

‎Errors: Note that series numbers must increase monotonically

Justusranvier at 15:42, 8 September 2014

2014-09-08T15:42:53Z

Justusranvier: add version status message

2014-09-05T17:14:51Z

add version status message

Justusranvier: Move to its own page.

2014-09-04T16:34:18Z

Move to its own page.

New page

==Description==

This call instructs the [[wallet (blockchain)|blockchain wallet]] to create and populate new series.

===Arguments===

;version
:Should be 1. This field allows for future expansion of the voting pool wallet specification.

;[[Wallet_(blockchain)#Series_Identifier|series identifier]]
:The series to be created

;required signatures
:The number of signatures needed to sign an outgoing transaction. This is the <code>m</code> value for the <code>m-of-n</code> multiscript opcode.

;list of [[xpub|xpubs]]
:The <code>n</code> value for the <code>m-of-n</code> 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 <code>[[replaceseries]]</code> call should be used instead.
;Too many pubkeys
:This error indicates that more than the maximum number of pubkeys allowed by <code>OP_CHECKMULTISIG</code> have been supplied.
;Duplicate pubkeys
:[[xpub|xpubs]] in a series must be unique.
;Insufficient pubkeys
:The number of xpubs supplied must be larger than <code>required signatures</code>
;Invalid pool
:The pool supplied as part of the <code>series identifier</code> 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 <code>series identifier</code> must be positive integers.

[[Category:Voting Pool Wallet API]]

← Older revision		Revision as of 17:14, 5 September 2014
Line 2:		Line 2:

	This call instructs the [[wallet (blockchain)\|blockchain wallet]] to create and populate new series.		This call instructs the [[wallet (blockchain)\|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===		===Arguments===

@@ Line 45: / Line 45: @@
 :Each xpub supplied must be a valid [[BIP32]] extended public key.
 ;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]]

@@ Line 8: / Line 8: @@
 :This version of the specification contains is believed to be complete, but is still subject to revision before version 1
-===Arguments===
+==Arguments==
 ;version
@@ Line 22: / Line 22: @@
 :The <code>n</code> value for the <code>m-of-n</code> multiscript opcode is implicitly derived from the number of xpubs provided here.
-===Return Values===
+==Return Values==
-====Data====
+===Data===
 none
-====Errors====
+===Errors===
 ;Success
 :The wallet has created the series.