Skip to content

Commit c415368

Browse files
t-bastrustyrussell
authored andcommitted
Leftover renaming of path_key in blinded paths
We renamed `blinding` to `path_key` in #1181, but forgot to update the description in test vectors and the proposal document.
1 parent 29c6e47 commit c415368

File tree

2 files changed

+12
-12
lines changed

2 files changed

+12
-12
lines changed

bolt12/offers-test.json

+4-4
Original file line numberDiff line numberDiff line change
@@ -311,7 +311,7 @@
311311
]
312312
},
313313
{
314-
"description": "with blinded path via Bob (0x424242...), blinding 020202...",
314+
"description": "with blinded path via Bob (0x424242...), path_key 020202...",
315315
"valid": true,
316316
"bolt12": "lno1pgx9getnwss8vetrw3hhyucs5ypjgef743p5fzqq9nqxh0ah7y87rzv3ud0eleps9kl2d5348hq2k8qzqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgqpqqqqqqqqqqqqqqqqqqqqqqqqqqqzqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqqzq3zyg3zyg3zyg3vggzamrjghtt05kvkvpcp0a79gmy3nt6jsn98ad2xs8de6sl9qmgvcvs",
317317
"field info": "path is [id=02020202..., enc=0x00*16], [id=02020202..., enc=0x11*8]",
@@ -357,7 +357,7 @@
357357
]
358358
},
359359
{
360-
"description": "with no issuer_id and blinded path via Bob (0x424242...), blinding 020202...",
360+
"description": "with no issuer_id and blinded path via Bob (0x424242...), path_key 020202...",
361361
"valid": true,
362362
"bolt12": "lno1pgx9getnwss8vetrw3hhyucs5ypjgef743p5fzqq9nqxh0ah7y87rzv3ud0eleps9kl2d5348hq2k8qzqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgqpqqqqqqqqqqqqqqqqqqqqqqqqqqqzqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqqzq3zyg3zyg3zygs",
363363
"field info": "path is [id=02020202..., enc=0x00*16], [id=02020202..., enc=0x11*8]",
@@ -375,7 +375,7 @@
375375
]
376376
},
377377
{
378-
"description": "... and with second blinded path via 1x2x3 (direction 1), blinding 020202...",
378+
"description": "... and with second blinded path via 1x2x3 (direction 1), path_key 020202...",
379379
"valid": true,
380380
"bolt12": "lno1pgx9getnwss8vetrw3hhyucsl5qj5qeyv5l2cs6y3qqzesrth7mlzrlp3xg7xhulusczm04x6g6nms9trspqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqqsqqqqqqqqqqqqqqqqqqqqqqqqqqpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqsqpqg3zyg3zyg3zygpqqqqzqqqqgqqxqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqqgqqqqqqqqqqqqqqqqqqqqqqqqqqqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgqqsg3zyg3zyg3zygtzzqhwcuj966ma9n9nqwqtl032xeyv6755yeflt235pmww58egx6rxry",
381381
"field info": "path is [id=02020202..., enc=0x00*16], [id=02020202..., enc=0x22*8]",
@@ -524,7 +524,7 @@
524524
"bolt12": "lno1pgz5znzfgdz3qqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqspqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqgqzcssyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqsz"
525525
},
526526
{
527-
"description": "Malformed: bad blinding in blinded_path",
527+
"description": "Malformed: bad path_key in blinded_path",
528528
"valid": false,
529529
"bolt12": "lno1pgz5znzfgdz3qqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpsxqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpsxqcrqvpsxqcpqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqgqzcssyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqszqgpqyqsz"
530530
},

proposals/route-blinding.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ To use the blinded route, senders need the following data:
126126
* The real `node_id` of the introduction point `N(0)` (to locate the beginning of the route)
127127
* The list of blinded `node_id`s: `[B(1),...,B(r)]`
128128
* The encrypted data for each node: `[encrypted_data(0),...,encrypted_data(r)]`
129-
* The first blinding ephemeral key: `E(0)`
129+
* The first blinding `path_key`: `E(0)`
130130

131131
### Sending to a blinded route
132132

@@ -267,7 +267,7 @@ she sets `max_cltv_expiry = 1212` and adds `cltv_expiry_delta` for each hop afte
267267
transmits the following information to the sender (most likely via an invoice):
268268

269269
* Blinded route: `[N(carol), B(bob), B(alice)]`
270-
* First blinding ephemeral key: `E(carol)`
270+
* First blinding `path_key`: `E(carol)`
271271
* Aggregated route relay parameters and constraints:
272272
* `fee_base_msat`: 201
273273
* `fee_proportional_millionths`: 1001
@@ -294,9 +294,9 @@ transmits the following information to the sender (most likely via an invoice):
294294

295295
Note that the introduction point (Carol) uses the real `node_id`, not the blinded one, because the
296296
sender needs to be able to locate this introduction point and find a route to it. The sender will
297-
send the first blinding ephemeral key `E(carol)` in the onion `hop_payload` for Carol, which will
297+
send the first blinding `path_key` `E(carol)` in the onion `hop_payload` for Carol, which will
298298
allow Carol to compute the blinding shared secret and correctly forward. We put this blinding
299-
ephemeral key in the onion instead of using a tlv in `update_add_htlc` because intermediate nodes
299+
`path_key` in the onion instead of using a tlv in `update_add_htlc` because intermediate nodes
300300
added before the blinded route may not support route blinding and wouldn't know how to relay it.
301301

302302
Erin wants to send 100 000 msat to this blinded route.
@@ -348,23 +348,23 @@ The messages exchanged will contain the following values:
348348
| | expiry: 1424 | | | expiry: 1400 | | | expiry: 1256 | | | expiry: 1112 | |
349349
| | onion_routing_packet: | | | onion_routing_packet: | | | onion_routing_packet: | | | onion_routing_packet: | |
350350
| | +----------------------------+ | | | +--------------------------------------+ | | | +--------------------------------------+ | | | +----------------------------+ | |
351-
| --> | | amount_fwd: 100302 msat | | --> | --> | | blinding_eph_key: E(carol) | | --> | --> | | encrypted_data: | | --> | --> | | amount_fwd: 100000 msat | | --> |
351+
| --> | | amount_fwd: 100302 msat | | --> | --> | | path_key: E(carol) | | --> | --> | | encrypted_data: | | --> | --> | | amount_fwd: 100000 msat | | --> |
352352
| | | outgoing_expiry: 1400 | | | | | encrypted_data: | | | | | +----------------------------------+ | | | | | outgoing_expiry: 1112 | | |
353353
| | | scid: scid_dave_to_carol | | | | | +----------------------------------+ | | | | | | scid: scid_bob_to_alice | | | | | | encrypted_data: | | |
354354
| | +----------------------------+ | | | | | scid: scid_carol_to_bob | | | | | | | fee_base_msat: 100 | | | | | | +-----------------------+ | | |
355-
| | | blinding_eph_key: E(carol) | | | | | | fee_base_msat: 100 | | | | | | | fee_proportional_millionths: 500 | | | | | | | path_id: preimage | | | |
355+
| | | path_key: E(carol) | | | | | | fee_base_msat: 100 | | | | | | | fee_proportional_millionths: 500 | | | | | | | path_id: preimage | | | |
356356
| | | encrypted_data(carol) | | | | | | fee_proportional_millionths: 500 | | | | | | | htlc_minimum_msat: 1000 | | | | | | | max_cltv_expiry: 1200 | | | |
357357
| | +----------------------------+ | | | | | htlc_minimum_msat: 1000 | | | | | | | cltv_expiry_delta: 144 | | | | | | +-----------------------+ | | |
358358
| | | encrypted_data(bob) | | | | | | cltv_expiry_delta: 144 | | | | | | | max_cltv_expiry: 1356 | | | | | +----------------------------+ | |
359359
| | +----------------------------+ | | | | | max_cltv_expiry: 1500 | | | | | | +----------------------------------+ | | | | tlv_extension | |
360360
| | | amount_fwd: 100000 msat | | | | | +----------------------------------+ | | | | +--------------------------------------+ | | | +----------------------------+ | |
361-
| | | outgoing_expiry: 1112 | | | | +--------------------------------------+ | | | | amount_fwd: 100000 msat | | | | | blinding_eph_key: E(alice) | | |
361+
| | | outgoing_expiry: 1112 | | | | +--------------------------------------+ | | | | amount_fwd: 100000 msat | | | | | path_key: E(alice) | | |
362362
| | | encrypted_data(alice) | | | | | encrypted_data(bob) | | | | | outgoing_expiry: 1112 | | | | +----------------------------+ | |
363363
| | +----------------------------+ | | | +--------------------------------------+ | | | | encrypted_data(alice) | | | +--------------------------------+ |
364364
| +--------------------------------+ | | | amount_fwd: 100000 msat | | | | +--------------------------------------+ | | |
365365
| | | | outgoing_expiry: 1112 | | | | tlv_extension | | |
366366
| | | | encrypted_data(alice) | | | | +--------------------------------------+ | | |
367-
| | | +--------------------------------------+ | | | | blinding_eph_key: E(bob) | | | |
367+
| | | +--------------------------------------+ | | | | path_key: E(bob) | | | |
368368
| | +------------------------------------------+ | | +--------------------------------------+ | | |
369369
| | | +------------------------------------------+ | |
370370
| | | | |

0 commit comments

Comments
 (0)