mirror of
https://github.com/ElementsProject/lightning.git
synced 2024-11-20 02:27:51 +01:00
2ddecdc95a
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> Changelog-Fixed: doc: Epic documentation rewrite: each now lists complete and accurate JSON output, tested against testsuite.
164 lines
3.5 KiB
JSON
164 lines
3.5 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [ "payments" ],
|
|
"properties": {
|
|
"payments": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": true,
|
|
"required": [ "id", "payment_hash", "status", "created_at", "amount_sent_msat" ],
|
|
"properties": {
|
|
"id": {
|
|
"type": "u64",
|
|
"description": "unique ID for this payment attempt"
|
|
},
|
|
"payment_hash": {
|
|
"type": "hex",
|
|
"description": "the hash of the *payment_preimage* which will prove payment",
|
|
"maxLength": 64,
|
|
"minLength": 64
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [ "pending", "failed", "complete" ],
|
|
"description": "status of the payment"
|
|
},
|
|
"msatoshi": {
|
|
"deprecated": true
|
|
},
|
|
"amount_msat": {
|
|
"type": "msat",
|
|
"description": "The amount delivered to destination (if known)"
|
|
},
|
|
"destination": {
|
|
"type": "pubkey",
|
|
"description": "the final destination of the payment if known"
|
|
},
|
|
"created_at": {
|
|
"type": "u64",
|
|
"description": "the UNIX timestamp showing when this payment was initiated"
|
|
},
|
|
"msatoshi_sent": {
|
|
"deprecated": true
|
|
},
|
|
"amount_sent_msat": {
|
|
"type": "msat",
|
|
"description": "The amount sent"
|
|
},
|
|
"label": {
|
|
"type": "string",
|
|
"description": "the label, if given to sendpay"
|
|
},
|
|
"bolt11": {
|
|
"type": "string",
|
|
"description": "the bolt11 string (if pay supplied one)"
|
|
},
|
|
"bolt12": {
|
|
"type": "string",
|
|
"description": "the bolt12 string (if supplied for pay: **experimental-offers** only)."
|
|
}
|
|
},
|
|
"allOf": [
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [ "complete" ]
|
|
}
|
|
}
|
|
},
|
|
"then": {
|
|
"additionalProperties": false,
|
|
"required": [ "payment_preimage" ],
|
|
"properties": {
|
|
"id": { },
|
|
"payment_hash": { },
|
|
"status": { },
|
|
"msatoshi": { },
|
|
"amount_msat": { },
|
|
"destination": { },
|
|
"created_at": { },
|
|
"msatoshi_sent": { },
|
|
"amount_sent_msat": { },
|
|
"label": { },
|
|
"bolt11": { },
|
|
"bolt12": { },
|
|
"payment_preimage": {
|
|
"type": "hex",
|
|
"description": "the proof of payment: SHA256 of this **payment_hash**",
|
|
"maxLength": 64,
|
|
"minLength": 64
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [ "failed" ]
|
|
}
|
|
}
|
|
},
|
|
"then": {
|
|
"additionalProperties": false,
|
|
"required": [ ],
|
|
"properties": {
|
|
"id": { },
|
|
"payment_hash": { },
|
|
"status": { },
|
|
"msatoshi": { },
|
|
"amount_msat": { },
|
|
"destination": { },
|
|
"created_at": { },
|
|
"msatoshi_sent": { },
|
|
"amount_sent_msat": { },
|
|
"label": { },
|
|
"bolt11": { },
|
|
"bolt12": { },
|
|
"erroronion": {
|
|
"type": "hex",
|
|
"description": "the onion message returned"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
{
|
|
"if": {
|
|
"properties": {
|
|
"status": {
|
|
"type": "string",
|
|
"enum": [ "pending" ]
|
|
}
|
|
}
|
|
},
|
|
"then": {
|
|
"additionalProperties": false,
|
|
"required": [ ],
|
|
"properties": {
|
|
"id": { },
|
|
"payment_hash": { },
|
|
"status": { },
|
|
"msatoshi": { },
|
|
"amount_msat": { },
|
|
"destination": { },
|
|
"created_at": { },
|
|
"msatoshi_sent": { },
|
|
"amount_sent_msat": { },
|
|
"label": { },
|
|
"bolt11": { },
|
|
"bolt12": { }
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
}
|
|
}
|
|
}
|