Replaceseries - Revision history

Justusranvier: /* Description */

2015-01-16T16:40:43Z

‎Description

Justusranvier at 13:37, 23 September 2014

2014-09-23T13:37:13Z

Justusranvier: add version status message

2014-09-05T17:14:35Z

add version status message

Justusranvier: /* Errors */

2014-09-05T15:16:40Z

‎Errors

Justusranvier: Move to a new page

2014-09-04T17:04:09Z

Move to a new page

New page

==Description==

This call instructs the [[wallet (blockchain)|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 [[thawseries|thawed]] or activated may not be replaced.

===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 replaced

;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 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 <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.
;Series not cold
:In order to avoid losing deposits, a series that has been [[thawseries|thawed]] may not be replaced.
;Series already active
:In order to avoid losing deposits, a series that has been activated may not be replaced.

[[Category:Voting Pool Wallet API]]

← Older revision		Revision as of 16:40, 16 January 2015
Line 4:		Line 4:

	Series which have already been [[thawseries\|thawed]] or activated may not be replaced.		Series which have already been [[thawseries\|thawed]] or activated may not be replaced.
		+
		+	The new series created by this call becomes the new highest-defined series for the pool. If the series it replaced was not previously the highest-defined series, then the effect of this call will be to create an "orphan chain" of obsolete series definitions.
		+
		+	The private keys for orphaned series definitions should not be deleted, but the series associated with them are no longer considered to be part of the voting pool.

	==Status==		==Status==

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

	Series which have already been [[thawseries\|thawed]] or activated may not be replaced.		Series which have already been [[thawseries\|thawed]] or activated may not be replaced.
		+
		+	==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 10: / Line 10: @@
 :This version of the specification contains is believed to be complete, but is still subject to revision before version 1
-===Arguments===
+==Arguments==
 ;version
@@ Line 24: / Line 24: @@
 :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

@@ Line 31: / Line 31: @@
 ;Unknown version
 :The wallet does not support the supplied version number.
-;Series node defined
+;Series not defined
 :The series to be replaced must already exist.
 ;Too many pubkeys