mirror of
https://github.com/ElementsProject/lightning.git
synced 2025-02-23 06:55:13 +01:00
18397c0b87
There were cases where address it's empty, and this cases are not right if the field is considered optional. This makes it required and add the field also when `--offline` is set. Changelog-Changed: JSON-RPC: `getinfo` `address` array is always present (though may be empty)
222 lines
5.8 KiB
JSON
222 lines
5.8 KiB
JSON
{
|
|
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"id",
|
|
"alias",
|
|
"color",
|
|
"num_peers",
|
|
"num_pending_channels",
|
|
"num_active_channels",
|
|
"num_inactive_channels",
|
|
"version",
|
|
"blockheight",
|
|
"network",
|
|
"fees_collected_msat",
|
|
"lightning-dir",
|
|
"address"
|
|
],
|
|
"properties": {
|
|
"id": {
|
|
"type": "pubkey",
|
|
"description": "The public key unique to this node"
|
|
},
|
|
"alias": {
|
|
"type": "string",
|
|
"description": "The fun alias this node will advertize",
|
|
"maxLength": 32
|
|
},
|
|
"color": {
|
|
"type": "hex",
|
|
"description": "The favorite RGB color this node will advertize",
|
|
"minLength": 6,
|
|
"maxLength": 6
|
|
},
|
|
"num_peers": {
|
|
"type": "u32",
|
|
"description": "The total count of peers, connected or with channels"
|
|
},
|
|
"num_pending_channels": {
|
|
"type": "u32",
|
|
"description": "The total count of channels being opened"
|
|
},
|
|
"num_active_channels": {
|
|
"type": "u32",
|
|
"description": "The total count of channels in normal state"
|
|
},
|
|
"num_inactive_channels": {
|
|
"type": "u32",
|
|
"description": "The total count of channels waiting for opening or closing transactions to be mined"
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"description": "Identifies what bugs you are running into"
|
|
},
|
|
"lightning-dir": {
|
|
"type": "string",
|
|
"description": "Identifies where you can find the configuration and other related files"
|
|
},
|
|
"our_features": {
|
|
"type": "object",
|
|
"description": "Our BOLT #9 feature bits (as hexstring) for various contexts",
|
|
"additionalProperties": true,
|
|
"required": [
|
|
"init",
|
|
"node",
|
|
"channel",
|
|
"invoice"
|
|
],
|
|
"properties": {
|
|
"init": {
|
|
"type": "hex",
|
|
"description": "features (incl. globalfeatures) in our init message, these also restrict what we offer in open_channel or accept in accept_channel"
|
|
},
|
|
"node": {
|
|
"type": "hex",
|
|
"description": "features in our node_announcement message"
|
|
},
|
|
"channel": {
|
|
"type": "hex",
|
|
"description": "negotiated channel features we (as channel initiator) publish in the channel_announcement message"
|
|
},
|
|
"invoice": {
|
|
"type": "hex",
|
|
"description": "features in our BOLT11 invoices"
|
|
}
|
|
}
|
|
},
|
|
"blockheight": {
|
|
"type": "u32",
|
|
"description": "The highest block height we've learned"
|
|
},
|
|
"network": {
|
|
"type": "string",
|
|
"description": "represents the type of network on the node are working (e.g: `bitcoin`, `testnet`, or `regtest`)"
|
|
},
|
|
"msatoshi_fees_collected": {
|
|
"type": "u64",
|
|
"deprecated": "v0.12.0"
|
|
},
|
|
"fees_collected_msat": {
|
|
"type": "msat",
|
|
"description": "Total routing fees collected by this node"
|
|
},
|
|
"address": {
|
|
"type": "array",
|
|
"description": "The addresses we announce to the world",
|
|
"items": {
|
|
"type": "object",
|
|
"required": [
|
|
"type",
|
|
"port"
|
|
],
|
|
"additionalProperties": true,
|
|
"properties": {
|
|
"type": {
|
|
"type": "string",
|
|
"enum": [
|
|
"dns",
|
|
"ipv4",
|
|
"ipv6",
|
|
"torv2",
|
|
"torv3",
|
|
"websocket"
|
|
],
|
|
"description": "Type of connection"
|
|
},
|
|
"port": {
|
|
"type": "u16",
|
|
"description": "port number"
|
|
}
|
|
},
|
|
"if": {
|
|
"properties": {
|
|
"type": {
|
|
"type": "string",
|
|
"enum": [
|
|
"dns",
|
|
"ipv4",
|
|
"ipv6",
|
|
"torv2",
|
|
"torv3"
|
|
]
|
|
}
|
|
}
|
|
},
|
|
"then": {
|
|
"required": [
|
|
"type",
|
|
"address",
|
|
"port"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"type": {},
|
|
"port": {},
|
|
"address": {
|
|
"type": "string",
|
|
"description": "address in expected format for **type**"
|
|
}
|
|
}
|
|
},
|
|
"else": {
|
|
"required": [
|
|
"type",
|
|
"port"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"type": {},
|
|
"port": {}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"binding": {
|
|
"type": "array",
|
|
"description": "The addresses we are listening on",
|
|
"items": {
|
|
"type": "object",
|
|
"required": [
|
|
"type"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"type": {
|
|
"type": "string",
|
|
"*FIXME*": "The variant in connect.schema.json is more complete",
|
|
"enum": [
|
|
"local socket",
|
|
"ipv4",
|
|
"ipv6",
|
|
"torv2",
|
|
"torv3"
|
|
],
|
|
"description": "Type of connection"
|
|
},
|
|
"address": {
|
|
"type": "string",
|
|
"description": "address in expected format for **type**"
|
|
},
|
|
"port": {
|
|
"type": "u16",
|
|
"description": "port number"
|
|
},
|
|
"socket": {
|
|
"type": "string",
|
|
"description": "socket filename (only if **type** is \"local socket\")"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"warning_bitcoind_sync": {
|
|
"type": "string",
|
|
"description": "Bitcoind is not up-to-date with network."
|
|
},
|
|
"warning_lightningd_sync": {
|
|
"type": "string",
|
|
"description": "Lightningd is still loading latest blocks from bitcoind."
|
|
}
|
|
}
|
|
}
|