Struct MeltQuote 

pub struct MeltQuote {

    pub id: QuoteId,
    pub unit: CurrencyUnit,
    pub request: MeltPaymentRequest,
    pub state: MeltQuoteState,
    pub expiry: u64,
    pub payment_proof: Option<String>,
    pub request_lookup_id: Option<PaymentIdentifier>,
    pub options: Option<MeltOptions>,
    pub created_time: u64,
    pub paid_time: Option<u64>,
    pub payment_method: PaymentMethod,
    pub extra_json: Option<Value>,
    pub estimated_blocks: Option<u32>,
    pub selected_fee_index: Option<u32>,
    /* private fields */
}

Melt Quote Info

Fields

id: QuoteId

Quote id

unit: CurrencyUnit

Quote unit

request: MeltPaymentRequest

Quote Payment request e.g. bolt11

state: MeltQuoteState

Quote state

expiry: u64

Expiration time of quote

payment_proof: Option<String>

Payment proof (e.g. Lightning preimage or onchain outpoint)

request_lookup_id: Option<PaymentIdentifier>

Value used by ln backend to look up state of request

options: Option<MeltOptions>

Payment options

Used for amountless invoices and MPP payments

created_time: u64

Unix time quote was created

paid_time: Option<u64>

Unix time quote was paid

payment_method: PaymentMethod

Payment method

extra_json: Option<Value>

Extra payment-method-specific response fields

estimated_blocks: Option<u32>

Estimated confirmation target in blocks for onchain quotes

selected_fee_index: Option<u32>

Selected fee option index once an onchain quote is executed

Implementations

impl MeltQuote

pub fn new( id: Option<QuoteId>, request: MeltPaymentRequest, unit: CurrencyUnit, amount: Amount<CurrencyUnit>, fee_reserve: Amount<CurrencyUnit>, expiry: u64, request_lookup_id: Option<PaymentIdentifier>, options: Option<MeltOptions>, payment_method: PaymentMethod, extra_json: Option<Value>, estimated_blocks: Option<u32>, ) -> Self

Create new MeltQuote

pub fn new_onchain( id: Option<QuoteId>, request: MeltPaymentRequest, unit: CurrencyUnit, amount: Amount<CurrencyUnit>, expiry: u64, request_lookup_id: Option<PaymentIdentifier>, extra_json: Option<Value>, fee_options: Vec<MeltQuoteOnchainFeeOption>, ) -> Result<Self, Error>

Create a new onchain MeltQuote with explicit fee_options.

Preserves backend-provided fee_index values and validates that the quote contains at least one option (OnchainFeeOptionsEmpty).

fee_reserve is initialized to the lowest-fee option so the quote has a definite reserve before the wallet selects a tier. Once the wallet calls MeltQuote::select_onchain_fee_option the reserve is updated to match the selected option. fee_options itself is never mutated after this call; that invariant is enforced by making the field private.

pub fn fee_options(&self) -> &[MeltQuoteOnchainFeeOption]

Onchain fee options for this quote.

For non-onchain quotes this returns an empty slice. For onchain quotes this is guaranteed non-empty (enforced at construction in MeltQuote::new_onchain and on reload in MeltQuote::from_db).

pub fn amount(&self) -> Amount<CurrencyUnit>

Quote amount

pub fn fee_reserve(&self) -> Amount<CurrencyUnit>

Fee reserve

pub fn select_onchain_fee_option(&mut self, fee_index: u32) -> Result<(), Error>

Select an onchain fee option by its fee_index.

pub fn into_response( self, change: Option<Vec<BlindSignature>>, ) -> MeltQuoteResponse<QuoteId>

Convert into MeltQuoteResponse, overriding change on the inner response with the provided signatures.

Dispatches to the per-variant From<MeltQuote> conversions so that field mapping stays centralized. Note that MeltQuoteBolt12Response is a type alias for MeltQuoteBolt11Response, so both Bolt11 and Bolt12 go through the same conversion.

pub fn total_needed(&self) -> Result<Amount, Error>

Total amount needed (amount + fee_reserve)

pub fn from_db( id: QuoteId, unit: CurrencyUnit, request: MeltPaymentRequest, amount: u64, fee_reserve: u64, state: MeltQuoteState, expiry: u64, payment_proof: Option<String>, request_lookup_id: Option<PaymentIdentifier>, options: Option<MeltOptions>, created_time: u64, paid_time: Option<u64>, payment_method: PaymentMethod, extra_json: Option<Value>, estimated_blocks: Option<u32>, fee_options: Vec<MeltQuoteOnchainFeeOption>, selected_fee_index: Option<u32>, ) -> Result<Self, Error>

Create MeltQuote from database fields (for deserialization)

Trait Implementations

impl Clone for MeltQuote

fn clone(&self) -> MeltQuote

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MeltQuote

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

Formats the value using the given formatter.

impl Eq for MeltQuote

impl From<&MeltQuote> for MeltQuoteBolt11Response<QuoteId>

fn from(melt_quote: &MeltQuote) -> MeltQuoteBolt11Response<QuoteId>

Converts to this type from the input type.

impl<Q> From<MeltQuote> for MeltQuoteResponse<Q>

where Q: From<QuoteId>,

Available on crate feature mint only.

fn from(value: MeltQuote) -> Self

Converts to this type from the input type.

impl From<MeltQuote> for MeltQuoteOnchainResponse<QuoteId>

fn from(quote: MeltQuote) -> Self

Converts to this type from the input type.

impl From<MeltQuote> for MeltQuoteCustomResponse<QuoteId>

fn from(melt_quote: MeltQuote) -> Self

Converts to this type from the input type.

impl From<MeltQuote> for MeltQuoteBolt11Response<QuoteId>

fn from(melt_quote: MeltQuote) -> MeltQuoteBolt11Response<QuoteId>

Converts to this type from the input type.

impl Hash for MeltQuote

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for MeltQuote

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for MeltQuote