Add new store for inbound payment metadata

[tnull]

Prior to v0.1 LDK only offered PaymentIds for outbound payments, which led us to track inbound payments by an ID derived for the payment hash. This was always messy as the latter is only available for BOLT11 payments, resulting in BOLT11 payments being added to the payment store upon invoice creation, and BOLT12 payments only being added upon receiving the invoice request.

With lightningdevkit/rust-lightning#3303 LDK added PaymentIds for inbound payments, so we should switch to use them in a backwards-compatible manner (i.e., probably still checking whether the old-style ID is available in the store for now). However, as this will mean we that we can't add the payment store entry upon invoice creation also for BOLT11 payments, we finally need a different solution to store additional metadata (invoices, but also JIT-channel fee limits) before receiving the payment. That is we need to add a PaymentMetatdataStore or similar.

[TheBlueMatt]

Re #528 (comment) just figured I'd mention here so that it doesn't get lost - we definitely need to store the HRN as well as the DNSSEC proof (and BOLT 12 Invoice itself, once it's in the payment event from LDK in 0.2) because those are the proof of payment.

[moisesPompilio]

I'm working on this issue and have some questions regarding the PaymentMetadata structure. I'm considering the following structure and I’d like to know if this includes all the necessary information, or if I should add, remove, or change anything:

pub enum PaymentMetadataDetail {
	Bolt11 {
		invoice: String,
		preimage: Option<PaymentPreimage>,
	},
	Bolt12Offer {
		offer_id: OfferId,
		preimage: Option<PaymentPreimage>,
		dnssec_proof: Option<DNSSECProofWrapper>,
		hrn: Option<HumanReadableName>,
		quantity: Option<u64>,
		hash: Option<PaymentHash>,
	},
	Bolt12Refund {
		refund: Refund,
		hrn: Option<HumanReadableName>,
		dnssec_proof: Option<DNSSECProofWrapper>,
		invoice: String,
		preimage: Option<PaymentPreimage>,
	},
}

pub struct JitChannelFeeLimits {
	pub max_total_opening_fee_msat: Option<u64>,
	pub max_proportional_opening_fee_ppm_msat: Option<u64>,
	pub counterparty_skimmed_fee_msat: Option<u64>,
}

pub struct PaymentMetadata {
	pub id: PaymentId,
	pub latest_update_timestamp: u64,
	pub direction: PaymentDirection,
	pub payment_metadata_detail: PaymentMetadataDetail,
	pub jit_channel_fee_limit: Option<JitChannelFeeLimits>,
	pub status: PaymentStatus,
}