Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add Fallback getter that returns Address #2023

Merged
merged 1 commit into from
Apr 7, 2023

Conversation

futurepaul
Copy link
Contributor

closes #882

I wasn't sure the exact right strategy and wrote this before seeing the most recent comment on this issue, so feel free to close if this is the wrong direction.

A few notes:

  • I don't know of a way to impl Into because the Fallback on its own isn't enough to create an Address, you also need a network.
  • I wasn't sure what to do about returning a Result (and what errors that would require) because this is data that's already been successfully parsed and theoretically isn't wrong. Therefore I'm using unwraps which feels wrong, so would appreciate some input on that.
  • There's a potentially deeper fix here by using the bitcoin lib's WitnessVersion, Script, and hash types inside Fallback (there's even a todo on Fallback about using better types)
  • I'm not exactly sure why I didn't end up having to clone even though I take a reference, but I'm not going to look a gift horse in the mouth.
  • I convert Currency::Simnet to Network::Regtest, not sure if that's correct

@jkczyz
Copy link
Contributor

jkczyz commented Feb 9, 2023

Thanks for putting this together!

closes #882

I wasn't sure the exact right strategy and wrote this before seeing the most recent comment on this issue, so feel free to close if this is the wrong direction.

Chatted with @TheBlueMatt. From the perspective from Invoice interface, this looks like the direction we want.

A few notes:

  • I don't know of a way to impl Into because the Fallback on its own isn't enough to create an Address, you also need a network.

You could implement it for a tuple (&Fallback, Currency), but seems like we'd rather not use Into anyhow.

  • I wasn't sure what to do about returning a Result (and what errors that would require) because this is data that's already been successfully parsed and theoretically isn't wrong. Therefore I'm using unwraps which feels wrong, so would appreciate some input on that.
  • There's a potentially deeper fix here by using the bitcoin lib's WitnessVersion, Script, and hash types inside Fallback (there's even a todo on Fallback about using better types)

For these two points, yeah, it would better if we use better types. Could you update the enum variants to use them?

  • I'm not exactly sure why I didn't end up having to clone even though I take a reference, but I'm not going to look a gift horse in the mouth.

Clone wasn't need but the bytes are eventually copied, so somewhat similar.

  • I convert Currency::Simnet to Network::Regtest, not sure if that's correct

This seems right. Not sure how an LND-specific concept got into here lol. We inherited this code. 😛

lightning-invoice/src/lib.rs Outdated Show resolved Hide resolved
lightning-invoice/src/utils.rs Outdated Show resolved Hide resolved
@futurepaul
Copy link
Contributor Author

futurepaul commented Feb 9, 2023

Down to one unwrap in the address creation, so that's nice. Can do a Vec<Result<Address>> if that's feels better

@codecov-commenter
Copy link

codecov-commenter commented Feb 10, 2023

Codecov Report

Patch coverage: 74.07% and project coverage change: +0.23 🎉

Comparison is base (56146e7) 91.04% compared to head (61db97d) 91.28%.

📣 This organization is not using Codecov’s GitHub App Integration. We recommend you install it so Codecov can continue to function properly for your repositories. Learn more

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2023      +/-   ##
==========================================
+ Coverage   91.04%   91.28%   +0.23%     
==========================================
  Files          99      102       +3     
  Lines       51722    49994    -1728     
  Branches    51722    49994    -1728     
==========================================
- Hits        47091    45635    -1456     
+ Misses       4631     4359     -272     
Impacted Files Coverage Δ
lightning-invoice/src/ser.rs 92.43% <0.00%> (+0.24%) ⬆️
lightning-invoice/src/lib.rs 79.91% <68.42%> (-6.41%) ⬇️
lightning-invoice/src/de.rs 75.81% <100.00%> (-6.58%) ⬇️

... and 99 files with indirect coverage changes

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

Copy link
Contributor

@jkczyz jkczyz left a comment

Choose a reason for hiding this comment

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

Sorry about the delay. Travel go the best of me.

lightning-invoice/src/ser.rs Outdated Show resolved Hide resolved
lightning-invoice/src/de.rs Outdated Show resolved Hide resolved
Comment on lines 570 to 568
if bytes.len() != 20 {
return Err(ParseError::InvalidPubKeyHashLength);
}
//TODO: refactor once const generics are available
let mut pkh = [0u8; 20];
pkh.copy_from_slice(&bytes);
let pkh = match PubkeyHash::from_slice(&bytes) {
Ok(pkh) => pkh,
Err(_) => return Err(ParseError::InvalidPubKeyHash),
};
Copy link
Contributor

Choose a reason for hiding this comment

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

from_slice will check the length, so we can remove our explicit check in favor of the new one. Probably could have the match pattern on the exact error variant. That way we won't need to add a new error variant and we'll fail to compile if new variants are added upstream.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

nice, thank you this worked out great

Comment on lines 581 to 575
if bytes.len() != 20 {
return Err(ParseError::InvalidScriptHashLength);
}
let mut sh = [0u8; 20];
sh.copy_from_slice(&bytes);
let sh = match ScriptHash::from_slice(&bytes) {
Ok(sh) => sh,
Err(_) => return Err(ParseError::InvalidScriptHash),
};
Copy link
Contributor

Choose a reason for hiding this comment

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

Likewise here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

yeah I got to get rid of all three errors I added!

lightning-invoice/src/lib.rs Outdated Show resolved Hide resolved
@TheBlueMatt
Copy link
Collaborator

Any update on addressing the review feedback @futurepaul?

@futurepaul
Copy link
Contributor Author

Sorry for the long delay, will be able to get back to this in about a week

@futurepaul
Copy link
Contributor Author

okay @jkczyz @TheBlueMatt this addresses the review feedback

Copy link
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.

Nice!

lightning-invoice/src/de.rs Outdated Show resolved Hide resolved
lightning-invoice/src/lib.rs Outdated Show resolved Hide resolved
@TheBlueMatt
Copy link
Collaborator

Please feel free to squash down your fixups so that each commit stands on its own and doesn't fix issues introduced in previous commits in the same PR. THen we'll get another reviewer here.

@futurepaul
Copy link
Contributor Author

couldn't think of a clean way to separate out this work because the use of the bitcoin types directly impacted how the getter is written so hope it's okay I squashed down to one commit

@jkczyz
Copy link
Contributor

jkczyz commented Apr 6, 2023

couldn't think of a clean way to separate out this work because the use of the bitcoin types directly impacted how the getter is written so hope it's okay I squashed down to one commit

FWIW, you could add fallback_addresses in a second commit since the first one would have all the types changed.

jkczyz
jkczyz previously approved these changes Apr 6, 2023
Copy link
Contributor

@jkczyz jkczyz left a comment

Choose a reason for hiding this comment

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

Just some nits that I missed but otherwise looks good.

lightning-invoice/src/de.rs Outdated Show resolved Hide resolved
lightning-invoice/src/lib.rs Outdated Show resolved Hide resolved
lightning-invoice/src/lib.rs Outdated Show resolved Hide resolved
@jkczyz jkczyz merged commit 1ceb41e into lightningdevkit:main Apr 7, 2023
14 checks passed
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.

invoice: Getter for fallbacks as Address'es
5 participants