highperfocused/lnd
1
0
Fork 0
mirror of https://github.com/lightningnetwork/lnd.git synced 2025-04-05 18:49:39 +02:00
Code Issues Packages Projects Releases Wiki Activity

lnrpc: update in preparation for G175

Browse Source 
Add a new ChannelUpdate2 message which can be returned with a Failure.
Also add a block_height member to the RoutingPolicy which will be
populated when the last_update field is not.
This commit is contained in:
Elle Mouton 2024-08-21 13:11:58 +02:00
parent fe595b18ec
commit 3a8e7cc2df
No known key found for this signature in database
GPG Key ID: D7D916376026F177
5 changed files with 2202 additions and 1749 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
lnrpc/devrpc/dev.swagger.json
View File

@ -225,6 +225,10 @@
"inbound_fee_rate_milli_msat": {
"type": "integer",
"format": "int32"
},
"block_height": {
"type": "integer",
"format": "int64"
}
}
},

3725
lnrpc/lightning.pb.go
View File

File diff suppressed because it is too large Load Diff

82
lnrpc/lightning.proto
View File

@ -3359,6 +3359,8 @@ message RoutingPolicy {
int32 inbound_fee_base_msat = 9;
int32 inbound_fee_rate_milli_msat = 10;
uint32 block_height = 11;
}
/*
@ -4793,6 +4795,9 @@ message Failure {
// A failure type-dependent block height.
uint32 height = 9;
// An optional channel update 2 message.
ChannelUpdate2 channel_update_2 = 10;
}
message ChannelUpdate {
@ -4878,6 +4883,83 @@ message ChannelUpdate {
bytes extra_opaque_data = 12;
}
message ChannelUpdate2 {
/*
The signature that validates the announced data and proves the ownership
of node id.
*/
bytes signature = 1;
/*
The target chain that this channel was opened within. This value
should be the genesis hash of the target chain. Along with the short
channel ID, this uniquely identifies the channel globally in a
blockchain.
*/
bytes chain_hash = 2;
/*
The unique description of the funding transaction.
*/
uint64 chan_id = 3 [jstype = JS_STRING];
/*
A block height that allows ordering in the case of multiple announcements.
We should ignore the message if block_height is not greater than the
last-received.
*/
uint32 block_height = 4;
/*
A bit field describing the disabled bits set on the update.
*/
uint32 disabled_flags = 5;
/*
If true, this update is from node 2. Otherwise, it is from node 1.
*/
bool direction = 6;
/*
The minimum number of blocks this node requires to be added to the expiry
of HTLCs. This is a security parameter determined by the node operator.
This value represents the required gap between the time locks of the
incoming and outgoing HTLC's set to this node.
*/
uint32 time_lock_delta = 7;
/*
The base fee that must be used for incoming HTLC's to this particular
channel. This value will be tacked onto the required for a payment
independent of the size of the payment.
*/
uint32 base_fee = 8;
/*
The fee rate that will be charged per millionth of a satoshi.
*/
uint32 fee_rate = 9;
/*
The minimum HTLC value which will be accepted.
*/
uint64 htlc_minimum_msat = 10;
/*
The maximum HTLC value which will be accepted.
*/
uint64 htlc_maximum_msat = 11;
/*
The set of data that was appended to this message, some of which we may
not actually know how to iterate or parse. By holding onto this data, we
ensure that we're able to properly validate the set of signatures that
cover these new fields, and ensure we're able to make upgrades to the
network in a forwards compatible manner.
*/
bytes extra_opaque_data = 12;
}
message MacaroonId {
bytes nonce = 1;
bytes storageId = 2;

72
lnrpc/lightning.swagger.json
View File

@ -4424,6 +4424,70 @@
}
}
},
"lnrpcChannelUpdate2": {
"type": "object",
"properties": {
"signature": {
"type": "string",
"format": "byte",
"description": "The signature that validates the announced data and proves the ownership\nof node id."
},
"chain_hash": {
"type": "string",
"format": "byte",
"description": "The target chain that this channel was opened within. This value\nshould be the genesis hash of the target chain. Along with the short\nchannel ID, this uniquely identifies the channel globally in a\nblockchain."
},
"chan_id": {
"type": "string",
"format": "uint64",
"description": "The unique description of the funding transaction."
},
"block_height": {
"type": "integer",
"format": "int64",
"description": "A block height that allows ordering in the case of multiple announcements.\nWe should ignore the message if block_height is not greater than the\nlast-received."
},
"disabled_flags": {
"type": "integer",
"format": "int64",
"description": "A bit field describing the disabled bits set on the update."
},
"direction": {
"type": "boolean",
"description": "If true, this update is from node 2. Otherwise, it is from node 1."
},
"time_lock_delta": {
"type": "integer",
"format": "int64",
"description": "The minimum number of blocks this node requires to be added to the expiry\nof HTLCs. This is a security parameter determined by the node operator.\nThis value represents the required gap between the time locks of the\nincoming and outgoing HTLC's set to this node."
},
"base_fee": {
"type": "integer",
"format": "int64",
"description": "The base fee that must be used for incoming HTLC's to this particular\nchannel. This value will be tacked onto the required for a payment\nindependent of the size of the payment."
},
"fee_rate": {
"type": "integer",
"format": "int64",
"description": "The fee rate that will be charged per millionth of a satoshi."
},
"htlc_minimum_msat": {
"type": "string",
"format": "uint64",
"description": "The minimum HTLC value which will be accepted."
},
"htlc_maximum_msat": {
"type": "string",
"format": "uint64",
"description": "The maximum HTLC value which will be accepted."
},
"extra_opaque_data": {
"type": "string",
"format": "byte",
"description": "The set of data that was appended to this message, some of which we may\nnot actually know how to iterate or parse. By holding onto this data, we\nensure that we're able to properly validate the set of signatures that\ncover these new fields, and ensure we're able to make upgrades to the\nnetwork in a forwards compatible manner."
}
}
},
"lnrpcCheckMacPermRequest": {
"type": "object",
"properties": {
@ -4688,6 +4752,10 @@
"type": "integer",
"format": "int64",
"description": "A failure type-dependent block height."
},
"channel_update_2": {
"$ref": "#/definitions/lnrpcChannelUpdate2",
"description": "An optional channel update 2 message."
}
}
},
@ -6965,6 +7033,10 @@
"inbound_fee_rate_milli_msat": {
"type": "integer",
"format": "int32"
},
"block_height": {
"type": "integer",
"format": "int64"
}
}
},

68
lnrpc/routerrpc/router.swagger.json
View File

@ -703,6 +703,70 @@
}
}
},
"lnrpcChannelUpdate2": {
"type": "object",
"properties": {
"signature": {
"type": "string",
"format": "byte",
"description": "The signature that validates the announced data and proves the ownership\nof node id."
},
"chain_hash": {
"type": "string",
"format": "byte",
"description": "The target chain that this channel was opened within. This value\nshould be the genesis hash of the target chain. Along with the short\nchannel ID, this uniquely identifies the channel globally in a\nblockchain."
},
"chan_id": {
"type": "string",
"format": "uint64",
"description": "The unique description of the funding transaction."
},
"block_height": {
"type": "integer",
"format": "int64",
"description": "A block height that allows ordering in the case of multiple announcements.\nWe should ignore the message if block_height is not greater than the\nlast-received."
},
"disabled_flags": {
"type": "integer",
"format": "int64",
"description": "A bit field describing the disabled bits set on the update."
},
"direction": {
"type": "boolean",
"description": "If true, this update is from node 2. Otherwise, it is from node 1."
},
"time_lock_delta": {
"type": "integer",
"format": "int64",
"description": "The minimum number of blocks this node requires to be added to the expiry\nof HTLCs. This is a security parameter determined by the node operator.\nThis value represents the required gap between the time locks of the\nincoming and outgoing HTLC's set to this node."
},
"base_fee": {
"type": "integer",
"format": "int64",
"description": "The base fee that must be used for incoming HTLC's to this particular\nchannel. This value will be tacked onto the required for a payment\nindependent of the size of the payment."
},
"fee_rate": {
"type": "integer",
"format": "int64",
"description": "The fee rate that will be charged per millionth of a satoshi."
},
"htlc_minimum_msat": {
"type": "string",
"format": "uint64",
"description": "The minimum HTLC value which will be accepted."
},
"htlc_maximum_msat": {
"type": "string",
"format": "uint64",
"description": "The maximum HTLC value which will be accepted."
},
"extra_opaque_data": {
"type": "string",
"format": "byte",
"description": "The set of data that was appended to this message, some of which we may\nnot actually know how to iterate or parse. By holding onto this data, we\nensure that we're able to properly validate the set of signatures that\ncover these new fields, and ensure we're able to make upgrades to the\nnetwork in a forwards compatible manner."
}
}
},
"lnrpcFailure": {
"type": "object",
"properties": {
@ -743,6 +807,10 @@
"type": "integer",
"format": "int64",
"description": "A failure type-dependent block height."
},
"channel_update_2": {
"$ref": "#/definitions/lnrpcChannelUpdate2",
"description": "An optional channel update 2 message."
}
}
},