core-lightning/doc/schemas/bkpr-channelsapy.schema.json
niftynei 563910e667 bkpr: add docs, change names to 'bkpr-*'
Adds schema definitions and manpages for bkpr- commands; also renames
the commands to all start with 'bkpr-', so they're easier to identify/
make runes about.
2022-07-28 12:08:18 +09:30

125 lines
4.6 KiB
JSON

{
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"additionalProperties": false,
"required": [
"channels_apy"
],
"properties": {
"channels_apy": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"account",
"routed_out_msat",
"routed_in_msat",
"lease_fee_paid_msat",
"lease_fee_earned_msat",
"pushed_out_msat",
"pushed_in_msat",
"our_start_balance_msat",
"channel_start_balance_msat",
"fees_out_msat",
"utilization_out",
"utilization_in",
"apy_out",
"apy_in",
"apy_total"
],
"properties": {
"account": {
"type": "string",
"description": "The account name. If the account is a channel, the channel_id. The 'net' entry is the rollup of all channel accounts"
},
"routed_out_msat": {
"type": "msat",
"description": "Sats routed (outbound)"
},
"routed_in_msat": {
"type": "msat",
"description": "Sats routed (inbound)"
},
"lease_fee_paid_msat": {
"type": "msat",
"description": "Sats paid for leasing inbound (liquidity ads)"
},
"lease_fee_earned_msat": {
"type": "msat",
"description": "Sats earned for leasing outbound (liquidity ads)"
},
"pushed_out_msat": {
"type": "msat",
"description": "Sats pushed to peer at open"
},
"pushed_in_msat": {
"type": "msat",
"description": "Sats pushed in from peer at open"
},
"our_start_balance_msat": {
"type": "msat",
"description": "Starting balance in channel at funding. Note that if our start ballance is zero, any _initial field will be omitted (can't divide by zero)"
},
"channel_start_balance_msat": {
"type": "msat",
"description": "Total starting balance at funding"
},
"fees_out_msat": {
"type": "msat",
"description": "Fees earned on routed outbound"
},
"fees_in_msat": {
"type": "msat",
"description": "Fees earned on routed inbound"
},
"utilization_out": {
"type": "string",
"description": "Sats routed outbound / total start balance"
},
"utilization_out_initial": {
"type": "string",
"description": "Sats routed outbound / our start balance"
},
"utilization_in": {
"type": "string",
"description": "Sats routed inbound / total start balance"
},
"utilization_in_initial": {
"type": "string",
"description": "Sats routed inbound / our start balance"
},
"apy_out": {
"type": "string",
"description": "Fees earned on outbound routed payments / total start balance for the length of time this channel has been open amortized to a year (APY)"
},
"apy_out_initial": {
"type": "string",
"description": "Fees earned on outbound routed payments / our start balance for the length of time this channel has been open amortized to a year (APY)"
},
"apy_in": {
"type": "string",
"description": "Fees earned on inbound routed payments / total start balance for the length of time this channel has been open amortized to a year (APY)"
},
"apy_in_initial": {
"type": "string",
"description": "Fees earned on inbound routed payments / our start balance for the length of time this channel has been open amortized to a year (APY)"
},
"apy_total": {
"type": "string",
"description": "Total fees earned on routed payments / total start balance for the length of time this channel has been open amortized to a year (APY)"
},
"apy_total_initial": {
"type": "string",
"description": "Total fees earned on routed payments / our start balance for the length of time this channel has been open amortized to a year (APY)"
},
"apy_lease": {
"type": "string",
"description": "Lease fees earned over total amount leased for the lease term, amortized to a year (APY). Only appears if channel was leased out by us"
}
}
}
}
}
}