Struct lightning_invoice::SignedRawInvoice

pub struct SignedRawInvoice { /* fields omitted */ }

Represents a signed RawInvoice with cached hash. The signature is not checked and may be invalid.

Invariants

The hash has to be either from the deserialized invoice or from the serialized raw_invoice.

Implementations

impl SignedRawInvoice

pub fn into_parts(self) -> (RawInvoice, [u8; 32], Signature)

Disassembles the SignedRawInvoice into its three parts:

1. raw invoice
2. hash of the raw invoice
3. signature

pub fn raw_invoice(&self) -> &RawInvoice

The RawInvoice which was signed.

pub fn hash(&self) -> &[u8; 32]

The hash of the RawInvoice that was signed.

pub fn signature(&self) -> &Signature

Signature for the invoice.

pub fn recover_payee_pub_key(&self) -> Result<PayeePubKey, Error>

Recovers the public key used for signing the invoice from the recoverable signature.

pub fn check_signature(&self) -> bool

Checks if the signature is valid for the included payee public key or if none exists if it's valid for the recovered signature (which should always be true?).

Methods from Deref<Target = RawInvoice>

pub fn hash(&self) -> [u8; 32]

Calculate the hash of the encoded RawInvoice

pub fn known_tagged_fields(
    &self
) -> FilterMap<Iter<'_, RawTaggedField>, fn(_: &RawTaggedField) -> Option<&TaggedField>>

Returns an iterator over all tagged fields with known semantics.

pub fn payment_hash(&self) -> Option<&Sha256>

pub fn description(&self) -> Option<&Description>

pub fn payee_pub_key(&self) -> Option<&PayeePubKey>

pub fn description_hash(&self) -> Option<&Sha256>

pub fn expiry_time(&self) -> Option<&ExpiryTime>

pub fn min_final_cltv_expiry(&self) -> Option<&MinFinalCltvExpiry>

pub fn fallbacks(&self) -> Vec<&Fallback>

pub fn routes(&self) -> Vec<&Route>

pub fn amount_pico_btc(&self) -> Option<u64>

pub fn currency(&self) -> Currency

Trait Implementations

impl Clone for SignedRawInvoice

pub fn clone(&self) -> SignedRawInvoice

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SignedRawInvoice

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for SignedRawInvoice

type Target = RawInvoice

The resulting type after dereferencing.

pub fn deref(&self) -> &RawInvoice

Dereferences the value.

impl Display for SignedRawInvoice

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for SignedRawInvoice

impl FromStr for SignedRawInvoice

use lightning_invoice::*;

let invoice = "lnbc1pvjluezpp5qqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqqqsyqcyq5rqwzqfqypqdp\
	l2pkx2ctnv5sxxmmwwd5kgetjypeh2ursdae8g6twvus8g6rfwvs8qun0dfjkxaq8rkx3yf5tcsyz3d7\
	3gafnh3cax9rn449d9p5uxz9ezhhypd0elx87sjle52x86fux2ypatgddc6k63n7erqz25le42c4u4ec\
	ky03ylcqca784w";

let parsed_1 = invoice.parse::<Invoice>();

let parsed_2 = match invoice.parse::<SignedRawInvoice>() {
	Ok(signed) => match Invoice::from_signed(signed) {
		Ok(invoice) => Ok(invoice),
		Err(e) => Err(ParseOrSemanticError::SemanticError(e)),
	},
	Err(e) => Err(ParseOrSemanticError::ParseError(e)),
};

assert!(parsed_1.is_ok());
assert_eq!(parsed_1, parsed_2);

type Err = ParseError

The associated error which can be returned from parsing.

pub fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq<SignedRawInvoice> for SignedRawInvoice

pub fn eq(&self, other: &SignedRawInvoice) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &SignedRawInvoice) -> bool

This method tests for !=.

impl StructuralEq for SignedRawInvoice

impl StructuralPartialEq for SignedRawInvoice