Skip to content

Keysend bLIP#892

Closed
valentinewallace wants to merge 20 commits intolightning:masterfrom
valentinewallace:keysend
Closed

Keysend bLIP#892
valentinewallace wants to merge 20 commits intolightning:masterfrom
valentinewallace:keysend

Conversation

@valentinewallace
Copy link
Copy Markdown
Contributor

Currently rebased on #884

The portions regarding the keysend feature bit and MPP probably need more iteration, but wanted to get a draft out.

Copy link
Copy Markdown
Collaborator

@TheBlueMatt TheBlueMatt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for writing this up, good to have a spec for this.

Receiver:
* if completing the payment, MUST fulfill the HTLC using the TLV-provided
payment preimage
* if failing the payment, SHOULD error with `PERM|15
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should specify reason -> value, not just "if you fail for any reason, use this code".

Copy link
Copy Markdown

@ariard ariard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good!

* SHOULD only send payments to nodes advertising feature bit 55 in the node
context starting June 1, 2022

Receiver:

This comment was marked as abuse.

This comment was marked as abuse.

* if failing the payment, SHOULD error with `PERM|15
incorrect_or_unknown_payment_details`.
* MUST advertise feature bit 55 in the node context only starting June 1, 2022

This comment was marked as abuse.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You mean TLV type 5482373484? Maybe in this section?

Copy link
Copy Markdown
Collaborator

@t-bast t-bast left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, it will be useful to have this in a shared document 👍

## bLIP Reserved Feature Bits
| Bits | Name | Description | Context | Dependencies | Link |
|-------|----------------------------------|-----------------------------------------------------------|----------|-------------------|---------------------------------------|
| 55 | `keysend` | Node supports receiving keysend payments | N | | [bLIP #0002][blip-0002] |
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are people relying on this specific value? It's a bit of a waste that it used a value so low, especially for a feature that will be obsolete once replaced by AMP...it would be nice if bLIPs used higher values for feature to avoid mixing official bolt features and bLIP features (but maybe that's just my OCD speaking)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tradeoff with higher feature bits, is that since we don't do any sparse encoding, higher feature bits (say in the tens of thousands) require the entire network to send around more data (looots of zeros onthe wire).

Ryan Gentry added 4 commits August 13, 2021 11:07
* MUST include a TLV record keyed by type `5482373484` with a TLV value of a
randomly generated and cryptographically-secure 32-byte value that serves as
the HTLC payment preimage
* MUST NOT set a `payment_data` field
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What's payment_data here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

From this section. I clarified a bit.

@valentinewallace valentinewallace marked this pull request as ready for review August 17, 2021 16:37
@Roasbeef
Copy link
Copy Markdown
Collaborator

Roasbeef commented Dec 6, 2021

Should be moved to https://github.com/lightning/blips

@valentinewallace
Copy link
Copy Markdown
Contributor Author

Should be moved to https://github.com/lightning/blips

Thanks, moving!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants