Difference between revisions of "Withdrawal status"

From Open Transactions
Jump to navigation Jump to search
(Initial page creation)
 
(Schema)
Line 12: Line 12:
 
     "type": "object",
 
     "type": "object",
 
     "properties": {
 
     "properties": {
 +
        "roundID" {
 +
            "type": "number",
 +
            "description": "A positive integer representing the consensus round for which the withdrawal is associated",
 +
            "minimum": 0,
 +
            "exclusiveMinimum": false
 +
        },
 
         "nextinputstart" {
 
         "nextinputstart" {
 
             "description": "The inputstart value to be used in the next consensus round as an address identifier",
 
             "description": "The inputstart value to be used in the next consensus round as an address identifier",

Revision as of 15:29, 9 September 2014

The startwithdrawal API call returns a list of accounting and status information corresponding to the transactions which it has created.

The list is formated as a JSON object.

Schema

{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "title": "Withdrawal status list",
    "description": "Accounting and status information corresponding to a voting pool outBailment consensus round",
    "type": "object",
    "properties": {
        "roundID" {
            "type": "number",
            "description": "A positive integer representing the consensus round for which the withdrawal is associated",
            "minimum": 0,
            "exclusiveMinimum": false
        },
        "nextinputstart" {
            "description": "The inputstart value to be used in the next consensus round as an address identifier",
            "$ref": "TBD"
        },
        "nextchangestart" {
            "description": "The changestart value to be used in the next consensus round as an address identifier",
            "$ref": "TBD"
        },
        "fees" {
            "type": "number",
            "description": "Total transaction fees incurred by the transactions in this round",
            "minimum": 0,
            "exclusiveMinimum": false
        },
        "outputs" {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "outBailmentID" {
                        "type": "string",
                        "description": "the identifier of the originating nym's outBailment message"
                    },
                    "status" {
                        "type": "string",
                        "description": "Status code for the outBailment"
                    },
                    "transactions" {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "ntxid" {
                                    "type": "string",
                                    "description": "Normalized transaction id associated with the withdrawal"
                                }
                                "index" {
                                    "type": "number",
                                    "description": "Output index in transaction which satisfies this outBailmentID",
                                    "minimum": 0,
                                    "exclusiveMinimum": false
                                }
                                "amount" {
                                    "type": "number",
                                    "description": "Monetary value of the output given by the (ntxid,index), in fundamental units",
                                    "minimum": 0,
                                    "exclusiveMinimum": true
                                }
                            }
                        }
                       "minItems": 0,
                       "uniqueItems": true
                    },
                    "required": [ "outBailmentID","status" ]
                }
            }
            "minItems": 1,
            "uniqueItems": true
        },
        "required": [ "nextinputstart","nextchangestart","fees","outputs"]
    }
}