1 /* Text to put at the beginning of the generated file. Probably a license. */
3 /* Generated with cbindgen:0.16.0 */
5 /* Warning, this file is autogenerated by cbindgen. Don't modify this manually. */
13 * An error when accessing the chain via [`Access`].
15 * [`Access`]: trait.Access.html
17 typedef enum LDKAccessError {
19 * The requested chain is unknown.
21 LDKAccessError_UnknownChain,
23 * The requested transaction doesn't exist or hasn't confirmed.
25 LDKAccessError_UnknownTx,
27 * Must be last for serialization purposes
29 LDKAccessError_Sentinel,
33 * An error enum representing a failure to persist a channel monitor update.
35 typedef enum LDKChannelMonitorUpdateErr {
37 * Used to indicate a temporary failure (eg connection to a watchtower or remote backup of
38 * our state failed, but is expected to succeed at some point in the future).
40 * Such a failure will \"freeze\" a channel, preventing us from revoking old states or
41 * submitting new commitment transactions to the counterparty. Once the update(s) which failed
42 * have been successfully applied, ChannelManager::channel_monitor_updated can be used to
43 * restore the channel to an operational state.
45 * Note that a given ChannelManager will *never* re-generate a given ChannelMonitorUpdate. If
46 * you return a TemporaryFailure you must ensure that it is written to disk safely before
47 * writing out the latest ChannelManager state.
49 * Even when a channel has been \"frozen\" updates to the ChannelMonitor can continue to occur
50 * (eg if an inbound HTLC which we forwarded was claimed upstream resulting in us attempting
51 * to claim it on this channel) and those updates must be applied wherever they can be. At
52 * least one such updated ChannelMonitor must be persisted otherwise PermanentFailure should
53 * be returned to get things on-chain ASAP using only the in-memory copy. Obviously updates to
54 * the channel which would invalidate previous ChannelMonitors are not made when a channel has
57 * Note that even if updates made after TemporaryFailure succeed you must still call
58 * channel_monitor_updated to ensure you have the latest monitor and re-enable normal channel
61 * Note that the update being processed here will not be replayed for you when you call
62 * ChannelManager::channel_monitor_updated, so you must store the update itself along
63 * with the persisted ChannelMonitor on your own local disk prior to returning a
64 * TemporaryFailure. You may, of course, employ a journaling approach, storing only the
65 * ChannelMonitorUpdate on disk without updating the monitor itself, replaying the journal at
68 * For deployments where a copy of ChannelMonitors and other local state are backed up in a
69 * remote location (with local copies persisted immediately), it is anticipated that all
70 * updates will return TemporaryFailure until the remote copies could be updated.
72 LDKChannelMonitorUpdateErr_TemporaryFailure,
74 * Used to indicate no further channel monitor updates will be allowed (eg we've moved on to a
75 * different watchtower and cannot update with all watchtowers that were previously informed
78 * At reception of this error, ChannelManager will force-close the channel and return at
79 * least a final ChannelMonitorUpdate::ChannelForceClosed which must be delivered to at
80 * least one ChannelMonitor copy. Revocation secret MUST NOT be released and offchain channel
81 * update must be rejected.
83 * This failure may also signal a failure to update the local persisted copy of one of
84 * the channel monitor instance.
86 * Note that even when you fail a holder commitment transaction update, you must store the
87 * update to ensure you can claim from it in case of a duplicate copy of this ChannelMonitor
88 * broadcasts it (e.g distributed channel-monitor deployment)
90 * In case of distributed watchtowers deployment, the new version must be written to disk, as
91 * state may have been stored but rejected due to a block forcing a commitment broadcast. This
92 * storage is used to claim outputs of rejected state confirmed onchain by another watchtower,
93 * lagging behind on block processing.
95 LDKChannelMonitorUpdateErr_PermanentFailure,
97 * Must be last for serialization purposes
99 LDKChannelMonitorUpdateErr_Sentinel,
100 } LDKChannelMonitorUpdateErr;
103 * An enum that represents the speed at which we want a transaction to confirm used for feerate
106 typedef enum LDKConfirmationTarget {
108 * We are happy with this transaction confirming slowly when feerate drops some.
110 LDKConfirmationTarget_Background,
112 * We'd like this transaction to confirm without major delay, but 12-18 blocks is fine.
114 LDKConfirmationTarget_Normal,
116 * We'd like this transaction to confirm in the next few blocks.
118 LDKConfirmationTarget_HighPriority,
120 * Must be last for serialization purposes
122 LDKConfirmationTarget_Sentinel,
123 } LDKConfirmationTarget;
126 * An enum representing the available verbosity levels of the logger.
128 typedef enum LDKLevel {
130 *Designates logger being silent
134 * Designates very serious errors
138 * Designates hazardous situations
142 * Designates useful information
146 * Designates lower priority information
150 * Designates very low priority, often extremely verbose, information
154 * Must be last for serialization purposes
159 typedef enum LDKNetwork {
164 * Must be last for serialization purposes
169 typedef enum LDKSecp256k1Error {
170 LDKSecp256k1Error_IncorrectSignature,
171 LDKSecp256k1Error_InvalidMessage,
172 LDKSecp256k1Error_InvalidPublicKey,
173 LDKSecp256k1Error_InvalidSignature,
174 LDKSecp256k1Error_InvalidSecretKey,
175 LDKSecp256k1Error_InvalidRecoveryId,
176 LDKSecp256k1Error_InvalidTweak,
177 LDKSecp256k1Error_NotEnoughMemory,
178 LDKSecp256k1Error_CallbackPanicked,
180 * Must be last for serialization purposes
182 LDKSecp256k1Error_Sentinel,
186 * A serialized transaction, in (pointer, length) form.
188 * This type optionally owns its own memory, and thus the semantics around access change based on
189 * the `data_is_owned` flag. If `data_is_owned` is set, you must call `Transaction_free` to free
190 * the underlying buffer before the object goes out of scope. If `data_is_owned` is not set, any
191 * access to the buffer after the scope in which the object was provided to you is invalid. eg,
192 * access after you return from the call in which a `!data_is_owned` `Transaction` is provided to
193 * you would be invalid.
195 * Note that, while it may change in the future, because transactions on the Rust side are stored
196 * in a deserialized form, all `Transaction`s generated on the Rust side will have `data_is_owned`
197 * set. Similarly, while it may change in the future, all `Transaction`s you pass to Rust may have
198 * `data_is_owned` either set or unset at your discretion.
200 typedef struct LDKTransaction {
202 * This is non-const for your convenience, an object passed to Rust is never written to.
209 typedef struct LDKCVecTempl_u8 {
214 typedef struct LDKCVecTempl_u8 LDKCVec_u8Z;
217 * A transaction output including a scriptPubKey and value.
218 * This type *does* own its own memory, so must be free'd appropriately.
220 typedef struct LDKTxOut {
221 LDKCVec_u8Z script_pubkey;
225 typedef struct LDKC2TupleTempl_usize__Transaction {
227 struct LDKTransaction b;
228 } LDKC2TupleTempl_usize__Transaction;
230 typedef struct LDKC2TupleTempl_usize__Transaction LDKC2Tuple_usizeTransactionZ;
232 typedef union LDKCResultPtr_u8__ChannelMonitorUpdateErr {
234 enum LDKChannelMonitorUpdateErr *err;
235 } LDKCResultPtr_u8__ChannelMonitorUpdateErr;
237 typedef struct LDKCResultTempl_u8__ChannelMonitorUpdateErr {
238 union LDKCResultPtr_u8__ChannelMonitorUpdateErr contents;
240 } LDKCResultTempl_u8__ChannelMonitorUpdateErr;
242 typedef struct LDKCResultTempl_u8__ChannelMonitorUpdateErr LDKCResult_NoneChannelMonitorUpdateErrZ;
247 * General Err type for ChannelMonitor actions. Generally, this implies that the data provided is
248 * inconsistent with the ChannelMonitor being called. eg for ChannelMonitor::update_monitor this
249 * means you tried to update a monitor for a different channel or the ChannelMonitorUpdate was
251 * Contains a developer-readable error message.
253 typedef struct MUST_USE_STRUCT LDKMonitorUpdateError {
255 * Nearly everywhere, inner must be non-null, however in places where
256 * the Rust equivalent takes an Option, it may be set to null to indicate None.
258 LDKnativeMonitorUpdateError *inner;
260 } LDKMonitorUpdateError;
262 typedef union LDKCResultPtr_u8__MonitorUpdateError {
264 struct LDKMonitorUpdateError *err;
265 } LDKCResultPtr_u8__MonitorUpdateError;
267 typedef struct LDKCResultTempl_u8__MonitorUpdateError {
268 union LDKCResultPtr_u8__MonitorUpdateError contents;
270 } LDKCResultTempl_u8__MonitorUpdateError;
272 typedef struct LDKCResultTempl_u8__MonitorUpdateError LDKCResult_NoneMonitorUpdateErrorZ;
277 * A reference to a transaction output.
279 * Differs from bitcoin::blockdata::transaction::OutPoint as the index is a u16 instead of u32
280 * due to LN's restrictions on index values. Should reduce (possibly) unsafe conversions this way.
282 typedef struct MUST_USE_STRUCT LDKOutPoint {
284 * Nearly everywhere, inner must be non-null, however in places where
285 * the Rust equivalent takes an Option, it may be set to null to indicate None.
287 LDKnativeOutPoint *inner;
291 typedef struct LDKC2TupleTempl_OutPoint__CVec_u8Z {
292 struct LDKOutPoint a;
294 } LDKC2TupleTempl_OutPoint__CVec_u8Z;
296 typedef struct LDKC2TupleTempl_OutPoint__CVec_u8Z LDKC2Tuple_OutPointScriptZ;
298 typedef struct LDKC2TupleTempl_u32__TxOut {
301 } LDKC2TupleTempl_u32__TxOut;
303 typedef struct LDKC2TupleTempl_u32__TxOut LDKC2Tuple_u32TxOutZ;
306 * Arbitrary 32 bytes, which could represent one of a few different things. You probably want to
307 * look up the corresponding function in rust-lightning's docs.
309 typedef struct LDKThirtyTwoBytes {
313 typedef struct LDKCVecTempl_C2TupleTempl_u32__TxOut {
314 struct LDKC2TupleTempl_u32__TxOut *data;
316 } LDKCVecTempl_C2TupleTempl_u32__TxOut;
318 typedef struct LDKC2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut {
319 struct LDKThirtyTwoBytes a;
320 struct LDKCVecTempl_C2TupleTempl_u32__TxOut b;
321 } LDKC2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut;
323 typedef struct LDKC2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ;
325 typedef struct LDKCVecTempl_C2TupleTempl_u32__TxOut LDKCVec_C2Tuple_u32TxOutZZ;
327 typedef struct LDKPublicKey {
328 uint8_t compressed_form[33];
334 * One counterparty's public keys which do not change over the life of a channel.
336 typedef struct MUST_USE_STRUCT LDKChannelPublicKeys {
338 * Nearly everywhere, inner must be non-null, however in places where
339 * the Rust equivalent takes an Option, it may be set to null to indicate None.
341 LDKnativeChannelPublicKeys *inner;
343 } LDKChannelPublicKeys;
345 typedef struct LDKC2TupleTempl_u64__u64 {
348 } LDKC2TupleTempl_u64__u64;
350 typedef struct LDKC2TupleTempl_u64__u64 LDKC2Tuple_u64u64Z;
352 typedef struct LDKSignature {
353 uint8_t compact_form[64];
356 typedef struct LDKCVecTempl_Signature {
357 struct LDKSignature *data;
359 } LDKCVecTempl_Signature;
361 typedef struct LDKC2TupleTempl_Signature__CVecTempl_Signature {
362 struct LDKSignature a;
363 struct LDKCVecTempl_Signature b;
364 } LDKC2TupleTempl_Signature__CVecTempl_Signature;
366 typedef union LDKCResultPtr_C2TupleTempl_Signature__CVecTempl_Signature________u8 {
367 struct LDKC2TupleTempl_Signature__CVecTempl_Signature *result;
369 } LDKCResultPtr_C2TupleTempl_Signature__CVecTempl_Signature________u8;
371 typedef struct LDKCResultTempl_C2TupleTempl_Signature__CVecTempl_Signature________u8 {
372 union LDKCResultPtr_C2TupleTempl_Signature__CVecTempl_Signature________u8 contents;
374 } LDKCResultTempl_C2TupleTempl_Signature__CVecTempl_Signature________u8;
376 typedef struct LDKCResultTempl_C2TupleTempl_Signature__CVecTempl_Signature________u8 LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ;
381 * This class tracks the per-transaction information needed to build a commitment transaction and to
382 * actually build it and sign. It is used for holder transactions that we sign only when needed
383 * and for transactions we sign for the counterparty.
385 * This class can be used inside a signer implementation to generate a signature given the relevant
388 typedef struct MUST_USE_STRUCT LDKCommitmentTransaction {
390 * Nearly everywhere, inner must be non-null, however in places where
391 * the Rust equivalent takes an Option, it may be set to null to indicate None.
393 LDKnativeCommitmentTransaction *inner;
395 } LDKCommitmentTransaction;
397 typedef union LDKCResultPtr_Signature__u8 {
398 struct LDKSignature *result;
400 } LDKCResultPtr_Signature__u8;
402 typedef struct LDKCResultTempl_Signature__u8 {
403 union LDKCResultPtr_Signature__u8 contents;
405 } LDKCResultTempl_Signature__u8;
407 typedef struct LDKCResultTempl_Signature__u8 LDKCResult_SignatureNoneZ;
412 * Information needed to build and sign a holder's commitment transaction.
414 * The transaction is only signed once we are ready to broadcast.
416 typedef struct MUST_USE_STRUCT LDKHolderCommitmentTransaction {
418 * Nearly everywhere, inner must be non-null, however in places where
419 * the Rust equivalent takes an Option, it may be set to null to indicate None.
421 LDKnativeHolderCommitmentTransaction *inner;
423 } LDKHolderCommitmentTransaction;
425 typedef union LDKCResultPtr_CVecTempl_Signature_____u8 {
426 struct LDKCVecTempl_Signature *result;
428 } LDKCResultPtr_CVecTempl_Signature_____u8;
430 typedef struct LDKCResultTempl_CVecTempl_Signature_____u8 {
431 union LDKCResultPtr_CVecTempl_Signature_____u8 contents;
433 } LDKCResultTempl_CVecTempl_Signature_____u8;
435 typedef struct LDKCResultTempl_CVecTempl_Signature_____u8 LDKCResult_CVec_SignatureZNoneZ;
440 * Information about an HTLC as it appears in a commitment transaction
442 typedef struct MUST_USE_STRUCT LDKHTLCOutputInCommitment {
444 * Nearly everywhere, inner must be non-null, however in places where
445 * the Rust equivalent takes an Option, it may be set to null to indicate None.
447 LDKnativeHTLCOutputInCommitment *inner;
449 } LDKHTLCOutputInCommitment;
454 * The unsigned part of a channel_announcement
456 typedef struct MUST_USE_STRUCT LDKUnsignedChannelAnnouncement {
458 * Nearly everywhere, inner must be non-null, however in places where
459 * the Rust equivalent takes an Option, it may be set to null to indicate None.
461 LDKnativeUnsignedChannelAnnouncement *inner;
463 } LDKUnsignedChannelAnnouncement;
468 * Per-channel data used to build transactions in conjunction with the per-commitment data (CommitmentTransaction).
469 * The fields are organized by holder/counterparty.
471 * Normally, this is converted to the broadcaster/countersignatory-organized DirectedChannelTransactionParameters
472 * before use, via the as_holder_broadcastable and as_counterparty_broadcastable functions.
474 typedef struct MUST_USE_STRUCT LDKChannelTransactionParameters {
476 * Nearly everywhere, inner must be non-null, however in places where
477 * the Rust equivalent takes an Option, it may be set to null to indicate None.
479 LDKnativeChannelTransactionParameters *inner;
481 } LDKChannelTransactionParameters;
484 * Set of lightning keys needed to operate a channel as described in BOLT 3.
486 * Signing services could be implemented on a hardware wallet. In this case,
487 * the current ChannelKeys would be a front-end on top of a communication
488 * channel connected to your secure device and lightning key material wouldn't
489 * reside on a hot server. Nevertheless, a this deployment would still need
490 * to trust the ChannelManager to avoid loss of funds as this latest component
491 * could ask to sign commitment transaction with HTLCs paying to attacker pubkeys.
493 * A more secure iteration would be to use hashlock (or payment points) to pair
494 * invoice/incoming HTLCs with outgoing HTLCs to implement a no-trust-ChannelManager
495 * at the price of more state and computation on the hardware wallet side. In the future,
496 * we are looking forward to design such interface.
498 * In any case, ChannelMonitor or fallback watchtowers are always going to be trusted
499 * to act, as liveness and breach reply correctness are always going to be hard requirements
500 * of LN security model, orthogonal of key management issues.
502 * If you're implementing a custom signer, you almost certainly want to implement
503 * Readable/Writable to serialize out a unique reference to this set of keys so
504 * that you can serialize the full ChannelManager object.
507 typedef struct LDKChannelKeys {
510 * Gets the per-commitment point for a specific commitment number
512 * Note that the commitment number starts at (1 << 48) - 1 and counts backwards.
514 struct LDKPublicKey (*get_per_commitment_point)(const void *this_arg, uint64_t idx);
516 * Gets the commitment secret for a specific commitment number as part of the revocation process
518 * An external signer implementation should error here if the commitment was already signed
519 * and should refuse to sign it in the future.
521 * May be called more than once for the same index.
523 * Note that the commitment number starts at (1 << 48) - 1 and counts backwards.
524 * TODO: return a Result so we can signal a validation error
526 struct LDKThirtyTwoBytes (*release_commitment_secret)(const void *this_arg, uint64_t idx);
528 * Gets the holder's channel public keys and basepoints
530 struct LDKChannelPublicKeys pubkeys;
532 * Fill in the pubkeys field as a reference to it will be given to Rust after this returns
533 * Note that this takes a pointer to this object, not the this_ptr like other methods do
534 * This function pointer may be NULL if pubkeys is filled in when this object is created and never needs updating.
536 void (*set_pubkeys)(const struct LDKChannelKeys*NONNULL_PTR );
538 * Gets arbitrary identifiers describing the set of keys which are provided back to you in
539 * some SpendableOutputDescriptor types. These should be sufficient to identify this
540 * ChannelKeys object uniquely and lookup or re-derive its keys.
542 LDKC2Tuple_u64u64Z (*key_derivation_params)(const void *this_arg);
544 * Create a signature for a counterparty's commitment transaction and associated HTLC transactions.
546 * Note that if signing fails or is rejected, the channel will be force-closed.
548 LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ (*sign_counterparty_commitment)(const void *this_arg, const struct LDKCommitmentTransaction *NONNULL_PTR commitment_tx);
550 * Create a signature for a holder's commitment transaction. This will only ever be called with
551 * the same commitment_tx (or a copy thereof), though there are currently no guarantees
552 * that it will not be called multiple times.
553 * An external signer implementation should check that the commitment has not been revoked.
555 LDKCResult_SignatureNoneZ (*sign_holder_commitment)(const void *this_arg, const struct LDKHolderCommitmentTransaction *NONNULL_PTR commitment_tx);
557 * Create a signature for each HTLC transaction spending a holder's commitment transaction.
559 * Unlike sign_holder_commitment, this may be called multiple times with *different*
560 * commitment_tx values. While this will never be called with a revoked
561 * commitment_tx, it is possible that it is called with the second-latest
562 * commitment_tx (only if we haven't yet revoked it) if some watchtower/secondary
563 * ChannelMonitor decided to broadcast before it had been updated to the latest.
565 * Either an Err should be returned, or a Vec with one entry for each HTLC which exists in
568 LDKCResult_CVec_SignatureZNoneZ (*sign_holder_commitment_htlc_transactions)(const void *this_arg, const struct LDKHolderCommitmentTransaction *NONNULL_PTR commitment_tx);
570 * Create a signature for the given input in a transaction spending an HTLC or commitment
571 * transaction output when our counterparty broadcasts an old state.
573 * A justice transaction may claim multiples outputs at the same time if timelocks are
574 * similar, but only a signature for the input at index `input` should be signed for here.
575 * It may be called multiples time for same output(s) if a fee-bump is needed with regards
576 * to an upcoming timelock expiration.
578 * Amount is value of the output spent by this input, committed to in the BIP 143 signature.
580 * per_commitment_key is revocation secret which was provided by our counterparty when they
581 * revoked the state which they eventually broadcast. It's not a _holder_ secret key and does
582 * not allow the spending of any funds by itself (you need our holder revocation_secret to do
585 * htlc holds HTLC elements (hash, timelock) if the output being spent is a HTLC output, thus
586 * changing the format of the witness script (which is committed to in the BIP 143
589 LDKCResult_SignatureNoneZ (*sign_justice_transaction)(const void *this_arg, struct LDKTransaction justice_tx, uintptr_t input, uint64_t amount, const uint8_t (*per_commitment_key)[32], const struct LDKHTLCOutputInCommitment *NONNULL_PTR htlc);
591 * Create a signature for a claiming transaction for a HTLC output on a counterparty's commitment
592 * transaction, either offered or received.
594 * Such a transaction may claim multiples offered outputs at same time if we know the
595 * preimage for each when we create it, but only the input at index `input` should be
596 * signed for here. It may be called multiple times for same output(s) if a fee-bump is
597 * needed with regards to an upcoming timelock expiration.
599 * Witness_script is either a offered or received script as defined in BOLT3 for HTLC
602 * Amount is value of the output spent by this input, committed to in the BIP 143 signature.
604 * Per_commitment_point is the dynamic point corresponding to the channel state
605 * detected onchain. It has been generated by our counterparty and is used to derive
606 * channel state keys, which are then included in the witness script and committed to in the
609 LDKCResult_SignatureNoneZ (*sign_counterparty_htlc_transaction)(const void *this_arg, struct LDKTransaction htlc_tx, uintptr_t input, uint64_t amount, struct LDKPublicKey per_commitment_point, const struct LDKHTLCOutputInCommitment *NONNULL_PTR htlc);
611 * Create a signature for a (proposed) closing transaction.
613 * Note that, due to rounding, there may be one \"missing\" satoshi, and either party may have
614 * chosen to forgo their output as dust.
616 LDKCResult_SignatureNoneZ (*sign_closing_transaction)(const void *this_arg, struct LDKTransaction closing_tx);
618 * Signs a channel announcement message with our funding key, proving it comes from one
619 * of the channel participants.
621 * Note that if this fails or is rejected, the channel will not be publicly announced and
622 * our counterparty may (though likely will not) close the channel on us for violating the
625 LDKCResult_SignatureNoneZ (*sign_channel_announcement)(const void *this_arg, const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR msg);
627 * Set the counterparty static channel data, including basepoints,
628 * counterparty_selected/holder_selected_contest_delay and funding outpoint.
629 * This is done as soon as the funding outpoint is known. Since these are static channel data,
630 * they MUST NOT be allowed to change to different values once set.
632 * channel_parameters.is_populated() MUST be true.
634 * We bind holder_selected_contest_delay late here for API convenience.
636 * Will be called before any signatures are applied.
638 void (*ready_channel)(void *this_arg, const struct LDKChannelTransactionParameters *NONNULL_PTR channel_parameters);
639 void *(*clone)(const void *this_arg);
640 LDKCVec_u8Z (*write)(const void *this_arg);
641 void (*free)(void *this_arg);
647 * A ChannelMonitor handles chain events (blocks connected and disconnected) and generates
648 * on-chain transactions to ensure no loss of funds occurs.
650 * You MUST ensure that no ChannelMonitors for a given channel anywhere contain out-of-date
651 * information and are actively monitoring the chain.
653 * Pending Events or updated HTLCs which have not yet been read out by
654 * get_and_clear_pending_monitor_events or get_and_clear_pending_events are serialized to disk and
655 * reloaded at deserialize-time. Thus, you must ensure that, when handling events, all events
656 * gotten are fully handled before re-serializing the new state.
658 * Note that the deserializer is only implemented for (Sha256dHash, ChannelMonitor), which
659 * tells you the last block hash which was block_connect()ed. You MUST rescan any blocks along
660 * the \"reorg path\" (ie disconnecting blocks until you find a common ancestor from both the
661 * returned block hash and the the current chain and then reconnecting blocks to get to the
662 * best chain) upon deserializing the object!
664 typedef struct MUST_USE_STRUCT LDKChannelMonitor {
666 * Nearly everywhere, inner must be non-null, however in places where
667 * the Rust equivalent takes an Option, it may be set to null to indicate None.
669 LDKnativeChannelMonitor *inner;
673 typedef struct LDKC2TupleTempl_ThirtyTwoBytes__ChannelMonitor {
674 struct LDKThirtyTwoBytes a;
675 struct LDKChannelMonitor b;
676 } LDKC2TupleTempl_ThirtyTwoBytes__ChannelMonitor;
678 typedef struct LDKC2TupleTempl_ThirtyTwoBytes__ChannelMonitor LDKC2Tuple_BlockHashChannelMonitorZ;
680 typedef struct LDKC2TupleTempl_Signature__CVecTempl_Signature LDKC2Tuple_SignatureCVec_SignatureZZ;
682 typedef struct LDKCVecTempl_Signature LDKCVec_SignatureZ;
685 * A Rust str object, ie a reference to a UTF8-valid string.
686 * This is *not* null-terminated so cannot be used directly as a C string!
688 typedef struct LDKStr {
689 const uint8_t *chars;
694 * Indicates an error on the client's part (usually some variant of attempting to use too-low or
697 typedef enum LDKAPIError_Tag {
699 * Indicates the API was wholly misused (see err for more). Cases where these can be returned
700 * are documented, but generally indicates some precondition of a function was violated.
702 LDKAPIError_APIMisuseError,
704 * Due to a high feerate, we were unable to complete the request.
705 * For example, this may be returned if the feerate implies we cannot open a channel at the
706 * requested value, but opening a larger channel would succeed.
708 LDKAPIError_FeeRateTooHigh,
710 * A malformed Route was provided (eg overflowed value, node id mismatch, overly-looped route,
711 * too-many-hops, etc).
713 LDKAPIError_RouteError,
715 * We were unable to complete the request as the Channel required to do so is unable to
716 * complete the request (or was not found). This can take many forms, including disconnected
717 * peer, channel at capacity, channel shutting down, etc.
719 LDKAPIError_ChannelUnavailable,
721 * An attempt to call watch/update_channel returned an Err (ie you did this!), causing the
722 * attempted action to fail.
724 LDKAPIError_MonitorUpdateFailed,
726 * Must be last for serialization purposes
728 LDKAPIError_Sentinel,
731 typedef struct LDKAPIError_LDKAPIMisuseError_Body {
733 } LDKAPIError_LDKAPIMisuseError_Body;
735 typedef struct LDKAPIError_LDKFeeRateTooHigh_Body {
738 } LDKAPIError_LDKFeeRateTooHigh_Body;
740 typedef struct LDKAPIError_LDKRouteError_Body {
742 } LDKAPIError_LDKRouteError_Body;
744 typedef struct LDKAPIError_LDKChannelUnavailable_Body {
746 } LDKAPIError_LDKChannelUnavailable_Body;
748 typedef struct MUST_USE_STRUCT LDKAPIError {
751 LDKAPIError_LDKAPIMisuseError_Body api_misuse_error;
752 LDKAPIError_LDKFeeRateTooHigh_Body fee_rate_too_high;
753 LDKAPIError_LDKRouteError_Body route_error;
754 LDKAPIError_LDKChannelUnavailable_Body channel_unavailable;
758 typedef union LDKCResultPtr_u8__APIError {
760 struct LDKAPIError *err;
761 } LDKCResultPtr_u8__APIError;
763 typedef struct LDKCResultTempl_u8__APIError {
764 union LDKCResultPtr_u8__APIError contents;
766 } LDKCResultTempl_u8__APIError;
768 typedef struct LDKCResultTempl_u8__APIError LDKCResult_NoneAPIErrorZ;
773 * If a payment fails to send, it can be in one of several states. This enum is returned as the
774 * Err() type describing which state the payment is in, see the description of individual enum
777 typedef struct MUST_USE_STRUCT LDKPaymentSendFailure {
779 * Nearly everywhere, inner must be non-null, however in places where
780 * the Rust equivalent takes an Option, it may be set to null to indicate None.
782 LDKnativePaymentSendFailure *inner;
784 } LDKPaymentSendFailure;
786 typedef union LDKCResultPtr_u8__PaymentSendFailure {
788 struct LDKPaymentSendFailure *err;
789 } LDKCResultPtr_u8__PaymentSendFailure;
791 typedef struct LDKCResultTempl_u8__PaymentSendFailure {
792 union LDKCResultPtr_u8__PaymentSendFailure contents;
794 } LDKCResultTempl_u8__PaymentSendFailure;
796 typedef struct LDKCResultTempl_u8__PaymentSendFailure LDKCResult_NonePaymentSendFailureZ;
801 * An update generated by the underlying Channel itself which contains some new information the
802 * ChannelMonitor should be made aware of.
804 typedef struct MUST_USE_STRUCT LDKChannelMonitorUpdate {
806 * Nearly everywhere, inner must be non-null, however in places where
807 * the Rust equivalent takes an Option, it may be set to null to indicate None.
809 LDKnativeChannelMonitorUpdate *inner;
811 } LDKChannelMonitorUpdate;
816 * An event to be processed by the ChannelManager.
818 typedef struct MUST_USE_STRUCT LDKMonitorEvent {
820 * Nearly everywhere, inner must be non-null, however in places where
821 * the Rust equivalent takes an Option, it may be set to null to indicate None.
823 LDKnativeMonitorEvent *inner;
827 typedef struct LDKCVecTempl_MonitorEvent {
828 struct LDKMonitorEvent *data;
830 } LDKCVecTempl_MonitorEvent;
832 typedef struct LDKCVecTempl_MonitorEvent LDKCVec_MonitorEventZ;
835 * The `Watch` trait defines behavior for watching on-chain activity pertaining to channels as
836 * blocks are connected and disconnected.
838 * Each channel is associated with a [`ChannelMonitor`]. Implementations of this trait are
839 * responsible for maintaining a set of monitors such that they can be updated accordingly as
840 * channel state changes and HTLCs are resolved. See method documentation for specific
843 * Implementations **must** ensure that updates are successfully applied and persisted upon method
844 * completion. If an update fails with a [`PermanentFailure`], then it must immediately shut down
845 * without taking any further action such as persisting the current state.
847 * If an implementation maintains multiple instances of a channel's monitor (e.g., by storing
848 * backup copies), then it must ensure that updates are applied across all instances. Otherwise, it
849 * could result in a revoked transaction being broadcast, allowing the counterparty to claim all
850 * funds in the channel. See [`ChannelMonitorUpdateErr`] for more details about how to handle
851 * multiple instances.
853 * [`ChannelMonitor`]: channelmonitor/struct.ChannelMonitor.html
854 * [`ChannelMonitorUpdateErr`]: channelmonitor/enum.ChannelMonitorUpdateErr.html
855 * [`PermanentFailure`]: channelmonitor/enum.ChannelMonitorUpdateErr.html#variant.PermanentFailure
857 typedef struct LDKWatch {
860 * Watches a channel identified by `funding_txo` using `monitor`.
862 * Implementations are responsible for watching the chain for the funding transaction along
863 * with any spends of outputs returned by [`get_outputs_to_watch`]. In practice, this means
864 * calling [`block_connected`] and [`block_disconnected`] on the monitor.
866 * [`get_outputs_to_watch`]: channelmonitor/struct.ChannelMonitor.html#method.get_outputs_to_watch
867 * [`block_connected`]: channelmonitor/struct.ChannelMonitor.html#method.block_connected
868 * [`block_disconnected`]: channelmonitor/struct.ChannelMonitor.html#method.block_disconnected
870 LDKCResult_NoneChannelMonitorUpdateErrZ (*watch_channel)(const void *this_arg, struct LDKOutPoint funding_txo, struct LDKChannelMonitor monitor);
872 * Updates a channel identified by `funding_txo` by applying `update` to its monitor.
874 * Implementations must call [`update_monitor`] with the given update. See
875 * [`ChannelMonitorUpdateErr`] for invariants around returning an error.
877 * [`update_monitor`]: channelmonitor/struct.ChannelMonitor.html#method.update_monitor
878 * [`ChannelMonitorUpdateErr`]: channelmonitor/enum.ChannelMonitorUpdateErr.html
880 LDKCResult_NoneChannelMonitorUpdateErrZ (*update_channel)(const void *this_arg, struct LDKOutPoint funding_txo, struct LDKChannelMonitorUpdate update);
882 * Returns any monitor events since the last call. Subsequent calls must only return new
885 LDKCVec_MonitorEventZ (*release_pending_monitor_events)(const void *this_arg);
886 void (*free)(void *this_arg);
890 * An interface to send a transaction to the Bitcoin network.
892 typedef struct LDKBroadcasterInterface {
895 * Sends a transaction out to (hopefully) be mined.
897 void (*broadcast_transaction)(const void *this_arg, struct LDKTransaction tx);
898 void (*free)(void *this_arg);
899 } LDKBroadcasterInterface;
901 typedef struct LDKSecretKey {
908 * An error in decoding a message or struct.
910 typedef struct MUST_USE_STRUCT LDKDecodeError {
912 * Nearly everywhere, inner must be non-null, however in places where
913 * the Rust equivalent takes an Option, it may be set to null to indicate None.
915 LDKnativeDecodeError *inner;
919 typedef union LDKCResultPtr_ChannelKeys__DecodeError {
920 struct LDKChannelKeys *result;
921 struct LDKDecodeError *err;
922 } LDKCResultPtr_ChannelKeys__DecodeError;
924 typedef struct LDKCResultTempl_ChannelKeys__DecodeError {
925 union LDKCResultPtr_ChannelKeys__DecodeError contents;
927 } LDKCResultTempl_ChannelKeys__DecodeError;
929 typedef struct LDKCResultTempl_ChannelKeys__DecodeError LDKCResult_ChanKeySignerDecodeErrorZ;
931 typedef struct LDKu8slice {
937 * A trait to describe an object which can get user secrets and key material.
939 typedef struct LDKKeysInterface {
942 * Get node secret key (aka node_id or network_key)
944 struct LDKSecretKey (*get_node_secret)(const void *this_arg);
946 * Get destination redeemScript to encumber static protocol exit points.
948 LDKCVec_u8Z (*get_destination_script)(const void *this_arg);
950 * Get shutdown_pubkey to use as PublicKey at channel closure
952 struct LDKPublicKey (*get_shutdown_pubkey)(const void *this_arg);
954 * Get a new set of ChannelKeys for per-channel secrets. These MUST be unique even if you
955 * restarted with some stale data!
957 struct LDKChannelKeys (*get_channel_keys)(const void *this_arg, bool inbound, uint64_t channel_value_satoshis);
959 * Gets a unique, cryptographically-secure, random 32 byte value. This is used for encrypting
960 * onion packets and for temporary channel IDs. There is no requirement that these be
961 * persisted anywhere, though they must be unique across restarts.
963 struct LDKThirtyTwoBytes (*get_secure_random_bytes)(const void *this_arg);
965 * Reads a `ChanKeySigner` for this `KeysInterface` from the given input stream.
966 * This is only called during deserialization of other objects which contain
967 * `ChannelKeys`-implementing objects (ie `ChannelMonitor`s and `ChannelManager`s).
968 * The bytes are exactly those which `<Self::ChanKeySigner as Writeable>::write()` writes, and
969 * contain no versioning scheme. You may wish to include your own version prefix and ensure
970 * you've read all of the provided bytes to ensure no corruption occurred.
972 LDKCResult_ChanKeySignerDecodeErrorZ (*read_chan_signer)(const void *this_arg, struct LDKu8slice reader);
973 void (*free)(void *this_arg);
977 * A trait which should be implemented to provide feerate information on a number of time
980 * Note that all of the functions implemented here *must* be reentrant-safe (obviously - they're
981 * called from inside the library in response to chain events, P2P events, or timer events).
983 typedef struct LDKFeeEstimator {
986 * Gets estimated satoshis of fee required per 1000 Weight-Units.
988 * Must be no smaller than 253 (ie 1 satoshi-per-byte rounded up to ensure later round-downs
989 * don't put us below 1 satoshi-per-byte).
991 * This translates to:
992 * * satoshis-per-byte * 250
993 * * ceil(satoshis-per-kbyte / 4)
995 uint32_t (*get_est_sat_per_1000_weight)(const void *this_arg, enum LDKConfirmationTarget confirmation_target);
996 void (*free)(void *this_arg);
1000 * A trait encapsulating the operations required of a logger
1002 typedef struct LDKLogger {
1007 void (*log)(const void *this_arg, const char *record);
1008 void (*free)(void *this_arg);
1014 * Manager which keeps track of a number of channels and sends messages to the appropriate
1015 * channel, also tracking HTLC preimages and forwarding onion packets appropriately.
1017 * Implements ChannelMessageHandler, handling the multi-channel parts and passing things through
1018 * to individual Channels.
1020 * Implements Writeable to write out all channel state to disk. Implies peer_disconnected() for
1021 * all peers during write/read (though does not modify this instance, only the instance being
1022 * serialized). This will result in any channels which have not yet exchanged funding_created (ie
1023 * called funding_transaction_generated for outbound channels).
1025 * Note that you can be a bit lazier about writing out ChannelManager than you can be with
1026 * ChannelMonitors. With ChannelMonitors you MUST write each monitor update out to disk before
1027 * returning from chain::Watch::watch_/update_channel, with ChannelManagers, writing updates
1028 * happens out-of-band (and will prevent any other ChannelManager operations from occurring during
1029 * the serialization process). If the deserialized version is out-of-date compared to the
1030 * ChannelMonitors passed by reference to read(), those channels will be force-closed based on the
1031 * ChannelMonitor state and no funds will be lost (mod on-chain transaction fees).
1033 * Note that the deserializer is only implemented for (Sha256dHash, ChannelManager), which
1034 * tells you the last block hash which was block_connect()ed. You MUST rescan any blocks along
1035 * the \"reorg path\" (ie call block_disconnected() until you get to a common block and then call
1036 * block_connected() to step towards your best block) upon deserialization before using the
1039 * Note that ChannelManager is responsible for tracking liveness of its channels and generating
1040 * ChannelUpdate messages informing peers that the channel is temporarily disabled. To avoid
1041 * spam due to quick disconnection/reconnection, updates are not sent until the channel has been
1042 * offline for a full minute. In order to track this, you must call
1043 * timer_chan_freshness_every_min roughly once per minute, though it doesn't have to be perfect.
1045 * Rather than using a plain ChannelManager, it is preferable to use either a SimpleArcChannelManager
1046 * a SimpleRefChannelManager, for conciseness. See their documentation for more details, but
1047 * essentially you should default to using a SimpleRefChannelManager, and use a
1048 * SimpleArcChannelManager when you require a ChannelManager with a static lifetime, such as when
1049 * you're using lightning-net-tokio.
1051 typedef struct MUST_USE_STRUCT LDKChannelManager {
1053 * Nearly everywhere, inner must be non-null, however in places where
1054 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1056 LDKnativeChannelManager *inner;
1058 } LDKChannelManager;
1060 typedef struct LDKC2TupleTempl_ThirtyTwoBytes__ChannelManager {
1061 struct LDKThirtyTwoBytes a;
1062 struct LDKChannelManager b;
1063 } LDKC2TupleTempl_ThirtyTwoBytes__ChannelManager;
1065 typedef struct LDKC2TupleTempl_ThirtyTwoBytes__ChannelManager LDKC2Tuple_BlockHashChannelManagerZ;
1070 * A channel_announcement message to be sent or received from a peer
1072 typedef struct MUST_USE_STRUCT LDKChannelAnnouncement {
1074 * Nearly everywhere, inner must be non-null, however in places where
1075 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1077 LDKnativeChannelAnnouncement *inner;
1079 } LDKChannelAnnouncement;
1084 * A channel_update message to be sent or received from a peer
1086 typedef struct MUST_USE_STRUCT LDKChannelUpdate {
1088 * Nearly everywhere, inner must be non-null, however in places where
1089 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1091 LDKnativeChannelUpdate *inner;
1095 typedef struct LDKC3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate {
1096 struct LDKChannelAnnouncement a;
1097 struct LDKChannelUpdate b;
1098 struct LDKChannelUpdate c;
1099 } LDKC3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate;
1101 typedef struct LDKC3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ;
1106 * An Err type for failure to process messages.
1108 typedef struct MUST_USE_STRUCT LDKLightningError {
1110 * Nearly everywhere, inner must be non-null, however in places where
1111 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1113 LDKnativeLightningError *inner;
1115 } LDKLightningError;
1117 typedef union LDKCResultPtr_u8__LightningError {
1119 struct LDKLightningError *err;
1120 } LDKCResultPtr_u8__LightningError;
1122 typedef struct LDKCResultTempl_u8__LightningError {
1123 union LDKCResultPtr_u8__LightningError contents;
1125 } LDKCResultTempl_u8__LightningError;
1127 typedef struct LDKCResultTempl_u8__LightningError LDKCResult_NoneLightningErrorZ;
1132 * Error for PeerManager errors. If you get one of these, you must disconnect the socket and
1133 * generate no further read_event/write_buffer_space_avail calls for the descriptor, only
1134 * triggering a single socket_disconnected call (unless it was provided in response to a
1135 * new_*_connection event, in which case no such socket_disconnected() must be called and the
1136 * socket silently disconencted).
1138 typedef struct MUST_USE_STRUCT LDKPeerHandleError {
1140 * Nearly everywhere, inner must be non-null, however in places where
1141 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1143 LDKnativePeerHandleError *inner;
1145 } LDKPeerHandleError;
1147 typedef union LDKCResultPtr_u8__PeerHandleError {
1149 struct LDKPeerHandleError *err;
1150 } LDKCResultPtr_u8__PeerHandleError;
1152 typedef struct LDKCResultTempl_u8__PeerHandleError {
1153 union LDKCResultPtr_u8__PeerHandleError contents;
1155 } LDKCResultTempl_u8__PeerHandleError;
1157 typedef struct LDKCResultTempl_u8__PeerHandleError LDKCResult_NonePeerHandleErrorZ;
1162 * A wrapper on CommitmentTransaction indicating that the derived fields (the built bitcoin
1163 * transaction and the transaction creation keys) are trusted.
1165 * See trust() and verify() functions on CommitmentTransaction.
1167 * This structure implements Deref.
1169 typedef struct MUST_USE_STRUCT LDKTrustedCommitmentTransaction {
1171 * Nearly everywhere, inner must be non-null, however in places where
1172 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1174 LDKnativeTrustedCommitmentTransaction *inner;
1176 } LDKTrustedCommitmentTransaction;
1178 typedef union LDKCResultPtr_TrustedCommitmentTransaction__u8 {
1179 struct LDKTrustedCommitmentTransaction *result;
1181 } LDKCResultPtr_TrustedCommitmentTransaction__u8;
1183 typedef struct LDKCResultTempl_TrustedCommitmentTransaction__u8 {
1184 union LDKCResultPtr_TrustedCommitmentTransaction__u8 contents;
1186 } LDKCResultTempl_TrustedCommitmentTransaction__u8;
1188 typedef struct LDKCResultTempl_TrustedCommitmentTransaction__u8 LDKCResult_TrustedCommitmentTransactionNoneZ;
1191 * When on-chain outputs are created by rust-lightning (which our counterparty is not able to
1192 * claim at any point in the future) an event is generated which you must track and be able to
1193 * spend on-chain. The information needed to do this is provided in this enum, including the
1194 * outpoint describing which txid and output index is available, the full output which exists at
1195 * that txid/index, and any keys or other information required to sign.
1197 typedef enum LDKSpendableOutputDescriptor_Tag {
1199 * An output to a script which was provided via KeysInterface, thus you should already know
1200 * how to spend it. No keys are provided as rust-lightning was never given any keys - only the
1201 * script_pubkey as it appears in the output.
1202 * These may include outputs from a transaction punishing our counterparty or claiming an HTLC
1203 * on-chain using the payment preimage or after it has timed out.
1205 LDKSpendableOutputDescriptor_StaticOutput,
1207 * An output to a P2WSH script which can be spent with a single signature after a CSV delay.
1209 * The witness in the spending input should be:
1210 * <BIP 143 signature> <empty vector> (MINIMALIF standard rule) <provided witnessScript>
1212 * Note that the nSequence field in the spending input must be set to to_self_delay
1213 * (which means the transaction is not broadcastable until at least to_self_delay
1214 * blocks after the outpoint confirms).
1216 * These are generally the result of a \"revocable\" output to us, spendable only by us unless
1217 * it is an output from an old state which we broadcast (which should never happen).
1219 * To derive the delayed_payment key which is used to sign for this input, you must pass the
1220 * holder delayed_payment_base_key (ie the private key which corresponds to the pubkey in
1221 * ChannelKeys::pubkeys().delayed_payment_basepoint) and the provided per_commitment_point to
1222 * chan_utils::derive_private_key. The public key can be generated without the secret key
1223 * using chan_utils::derive_public_key and only the delayed_payment_basepoint which appears in
1224 * ChannelKeys::pubkeys().
1226 * To derive the revocation_pubkey provided here (which is used in the witness
1227 * script generation), you must pass the counterparty revocation_basepoint (which appears in the
1228 * call to ChannelKeys::ready_channel) and the provided per_commitment point
1229 * to chan_utils::derive_public_revocation_key.
1231 * The witness script which is hashed and included in the output script_pubkey may be
1232 * regenerated by passing the revocation_pubkey (derived as above), our delayed_payment pubkey
1233 * (derived as above), and the to_self_delay contained here to
1234 * chan_utils::get_revokeable_redeemscript.
1236 LDKSpendableOutputDescriptor_DynamicOutputP2WSH,
1238 * An output to a P2WPKH, spendable exclusively by our payment key (ie the private key which
1239 * corresponds to the public key in ChannelKeys::pubkeys().payment_point).
1240 * The witness in the spending input, is, thus, simply:
1241 * <BIP 143 signature> <payment key>
1243 * These are generally the result of our counterparty having broadcast the current state,
1244 * allowing us to claim the non-HTLC-encumbered outputs immediately.
1246 LDKSpendableOutputDescriptor_StaticOutputCounterpartyPayment,
1248 * Must be last for serialization purposes
1250 LDKSpendableOutputDescriptor_Sentinel,
1251 } LDKSpendableOutputDescriptor_Tag;
1253 typedef struct LDKSpendableOutputDescriptor_LDKStaticOutput_Body {
1254 struct LDKOutPoint outpoint;
1255 struct LDKTxOut output;
1256 } LDKSpendableOutputDescriptor_LDKStaticOutput_Body;
1258 typedef struct LDKSpendableOutputDescriptor_LDKDynamicOutputP2WSH_Body {
1259 struct LDKOutPoint outpoint;
1260 struct LDKPublicKey per_commitment_point;
1261 uint16_t to_self_delay;
1262 struct LDKTxOut output;
1263 LDKC2Tuple_u64u64Z key_derivation_params;
1264 struct LDKPublicKey revocation_pubkey;
1265 } LDKSpendableOutputDescriptor_LDKDynamicOutputP2WSH_Body;
1267 typedef struct LDKSpendableOutputDescriptor_LDKStaticOutputCounterpartyPayment_Body {
1268 struct LDKOutPoint outpoint;
1269 struct LDKTxOut output;
1270 LDKC2Tuple_u64u64Z key_derivation_params;
1271 } LDKSpendableOutputDescriptor_LDKStaticOutputCounterpartyPayment_Body;
1273 typedef struct MUST_USE_STRUCT LDKSpendableOutputDescriptor {
1274 LDKSpendableOutputDescriptor_Tag tag;
1276 LDKSpendableOutputDescriptor_LDKStaticOutput_Body static_output;
1277 LDKSpendableOutputDescriptor_LDKDynamicOutputP2WSH_Body dynamic_output_p2wsh;
1278 LDKSpendableOutputDescriptor_LDKStaticOutputCounterpartyPayment_Body static_output_counterparty_payment;
1280 } LDKSpendableOutputDescriptor;
1282 typedef struct LDKCVecTempl_SpendableOutputDescriptor {
1283 struct LDKSpendableOutputDescriptor *data;
1285 } LDKCVecTempl_SpendableOutputDescriptor;
1287 typedef struct LDKCVecTempl_SpendableOutputDescriptor LDKCVec_SpendableOutputDescriptorZ;
1290 * An Event which you should probably take some action in response to.
1292 * Note that while Writeable and Readable are implemented for Event, you probably shouldn't use
1293 * them directly as they don't round-trip exactly (for example FundingGenerationReady is never
1294 * written as it makes no sense to respond to it after reconnecting to peers).
1296 typedef enum LDKEvent_Tag {
1298 * Used to indicate that the client should generate a funding transaction with the given
1299 * parameters and then call ChannelManager::funding_transaction_generated.
1300 * Generated in ChannelManager message handling.
1301 * Note that *all inputs* in the funding transaction must spend SegWit outputs or your
1302 * counterparty can steal your funds!
1304 LDKEvent_FundingGenerationReady,
1306 * Used to indicate that the client may now broadcast the funding transaction it created for a
1307 * channel. Broadcasting such a transaction prior to this event may lead to our counterparty
1308 * trivially stealing all funds in the funding transaction!
1310 LDKEvent_FundingBroadcastSafe,
1312 * Indicates we've received money! Just gotta dig out that payment preimage and feed it to
1313 * ChannelManager::claim_funds to get it....
1314 * Note that if the preimage is not known or the amount paid is incorrect, you should call
1315 * ChannelManager::fail_htlc_backwards to free up resources for this HTLC and avoid
1316 * network congestion.
1317 * The amount paid should be considered 'incorrect' when it is less than or more than twice
1318 * the amount expected.
1319 * If you fail to call either ChannelManager::claim_funds or
1320 * ChannelManager::fail_htlc_backwards within the HTLC's timeout, the HTLC will be
1321 * automatically failed.
1323 LDKEvent_PaymentReceived,
1325 * Indicates an outbound payment we made succeeded (ie it made it all the way to its target
1326 * and we got back the payment preimage for it).
1327 * Note that duplicative PaymentSent Events may be generated - it is your responsibility to
1328 * deduplicate them by payment_preimage (which MUST be unique)!
1330 LDKEvent_PaymentSent,
1332 * Indicates an outbound payment we made failed. Probably some intermediary node dropped
1333 * something. You may wish to retry with a different route.
1334 * Note that duplicative PaymentFailed Events may be generated - it is your responsibility to
1335 * deduplicate them by payment_hash (which MUST be unique)!
1337 LDKEvent_PaymentFailed,
1339 * Used to indicate that ChannelManager::process_pending_htlc_forwards should be called at a
1340 * time in the future.
1342 LDKEvent_PendingHTLCsForwardable,
1344 * Used to indicate that an output was generated on-chain which you should know how to spend.
1345 * Such an output will *not* ever be spent by rust-lightning, and are not at risk of your
1346 * counterparty spending them due to some kind of timeout. Thus, you need to store them
1347 * somewhere and spend them when you create on-chain transactions.
1349 LDKEvent_SpendableOutputs,
1351 * Must be last for serialization purposes
1356 typedef struct LDKEvent_LDKFundingGenerationReady_Body {
1357 struct LDKThirtyTwoBytes temporary_channel_id;
1358 uint64_t channel_value_satoshis;
1359 LDKCVec_u8Z output_script;
1360 uint64_t user_channel_id;
1361 } LDKEvent_LDKFundingGenerationReady_Body;
1363 typedef struct LDKEvent_LDKFundingBroadcastSafe_Body {
1364 struct LDKOutPoint funding_txo;
1365 uint64_t user_channel_id;
1366 } LDKEvent_LDKFundingBroadcastSafe_Body;
1368 typedef struct LDKEvent_LDKPaymentReceived_Body {
1369 struct LDKThirtyTwoBytes payment_hash;
1370 struct LDKThirtyTwoBytes payment_secret;
1372 } LDKEvent_LDKPaymentReceived_Body;
1374 typedef struct LDKEvent_LDKPaymentSent_Body {
1375 struct LDKThirtyTwoBytes payment_preimage;
1376 } LDKEvent_LDKPaymentSent_Body;
1378 typedef struct LDKEvent_LDKPaymentFailed_Body {
1379 struct LDKThirtyTwoBytes payment_hash;
1380 bool rejected_by_dest;
1381 } LDKEvent_LDKPaymentFailed_Body;
1383 typedef struct LDKEvent_LDKPendingHTLCsForwardable_Body {
1384 uint64_t time_forwardable;
1385 } LDKEvent_LDKPendingHTLCsForwardable_Body;
1387 typedef struct LDKEvent_LDKSpendableOutputs_Body {
1388 LDKCVec_SpendableOutputDescriptorZ outputs;
1389 } LDKEvent_LDKSpendableOutputs_Body;
1391 typedef struct MUST_USE_STRUCT LDKEvent {
1394 LDKEvent_LDKFundingGenerationReady_Body funding_generation_ready;
1395 LDKEvent_LDKFundingBroadcastSafe_Body funding_broadcast_safe;
1396 LDKEvent_LDKPaymentReceived_Body payment_received;
1397 LDKEvent_LDKPaymentSent_Body payment_sent;
1398 LDKEvent_LDKPaymentFailed_Body payment_failed;
1399 LDKEvent_LDKPendingHTLCsForwardable_Body pending_htl_cs_forwardable;
1400 LDKEvent_LDKSpendableOutputs_Body spendable_outputs;
1407 * An accept_channel message to be sent or received from a peer
1409 typedef struct MUST_USE_STRUCT LDKAcceptChannel {
1411 * Nearly everywhere, inner must be non-null, however in places where
1412 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1414 LDKnativeAcceptChannel *inner;
1421 * An open_channel message to be sent or received from a peer
1423 typedef struct MUST_USE_STRUCT LDKOpenChannel {
1425 * Nearly everywhere, inner must be non-null, however in places where
1426 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1428 LDKnativeOpenChannel *inner;
1435 * A funding_created message to be sent or received from a peer
1437 typedef struct MUST_USE_STRUCT LDKFundingCreated {
1439 * Nearly everywhere, inner must be non-null, however in places where
1440 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1442 LDKnativeFundingCreated *inner;
1444 } LDKFundingCreated;
1449 * A funding_signed message to be sent or received from a peer
1451 typedef struct MUST_USE_STRUCT LDKFundingSigned {
1453 * Nearly everywhere, inner must be non-null, however in places where
1454 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1456 LDKnativeFundingSigned *inner;
1463 * A funding_locked message to be sent or received from a peer
1465 typedef struct MUST_USE_STRUCT LDKFundingLocked {
1467 * Nearly everywhere, inner must be non-null, however in places where
1468 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1470 LDKnativeFundingLocked *inner;
1477 * An announcement_signatures message to be sent or received from a peer
1479 typedef struct MUST_USE_STRUCT LDKAnnouncementSignatures {
1481 * Nearly everywhere, inner must be non-null, however in places where
1482 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1484 LDKnativeAnnouncementSignatures *inner;
1486 } LDKAnnouncementSignatures;
1491 * Struct used to return values from revoke_and_ack messages, containing a bunch of commitment
1492 * transaction updates if they were pending.
1494 typedef struct MUST_USE_STRUCT LDKCommitmentUpdate {
1496 * Nearly everywhere, inner must be non-null, however in places where
1497 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1499 LDKnativeCommitmentUpdate *inner;
1501 } LDKCommitmentUpdate;
1506 * A revoke_and_ack message to be sent or received from a peer
1508 typedef struct MUST_USE_STRUCT LDKRevokeAndACK {
1510 * Nearly everywhere, inner must be non-null, however in places where
1511 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1513 LDKnativeRevokeAndACK *inner;
1520 * A closing_signed message to be sent or received from a peer
1522 typedef struct MUST_USE_STRUCT LDKClosingSigned {
1524 * Nearly everywhere, inner must be non-null, however in places where
1525 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1527 LDKnativeClosingSigned *inner;
1534 * A shutdown message to be sent or received from a peer
1536 typedef struct MUST_USE_STRUCT LDKShutdown {
1538 * Nearly everywhere, inner must be non-null, however in places where
1539 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1541 LDKnativeShutdown *inner;
1548 * A channel_reestablish message to be sent or received from a peer
1550 typedef struct MUST_USE_STRUCT LDKChannelReestablish {
1552 * Nearly everywhere, inner must be non-null, however in places where
1553 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1555 LDKnativeChannelReestablish *inner;
1557 } LDKChannelReestablish;
1562 * A node_announcement message to be sent or received from a peer
1564 typedef struct MUST_USE_STRUCT LDKNodeAnnouncement {
1566 * Nearly everywhere, inner must be non-null, however in places where
1567 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1569 LDKnativeNodeAnnouncement *inner;
1571 } LDKNodeAnnouncement;
1576 * An error message to be sent or received from a peer
1578 typedef struct MUST_USE_STRUCT LDKErrorMessage {
1580 * Nearly everywhere, inner must be non-null, however in places where
1581 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1583 LDKnativeErrorMessage *inner;
1588 * Used to put an error message in a LightningError
1590 typedef enum LDKErrorAction_Tag {
1592 * The peer took some action which made us think they were useless. Disconnect them.
1594 LDKErrorAction_DisconnectPeer,
1596 * The peer did something harmless that we weren't able to process, just log and ignore
1598 LDKErrorAction_IgnoreError,
1600 * The peer did something incorrect. Tell them.
1602 LDKErrorAction_SendErrorMessage,
1604 * Must be last for serialization purposes
1606 LDKErrorAction_Sentinel,
1607 } LDKErrorAction_Tag;
1609 typedef struct LDKErrorAction_LDKDisconnectPeer_Body {
1610 struct LDKErrorMessage msg;
1611 } LDKErrorAction_LDKDisconnectPeer_Body;
1613 typedef struct LDKErrorAction_LDKSendErrorMessage_Body {
1614 struct LDKErrorMessage msg;
1615 } LDKErrorAction_LDKSendErrorMessage_Body;
1617 typedef struct MUST_USE_STRUCT LDKErrorAction {
1618 LDKErrorAction_Tag tag;
1620 LDKErrorAction_LDKDisconnectPeer_Body disconnect_peer;
1621 LDKErrorAction_LDKSendErrorMessage_Body send_error_message;
1626 * The information we received from a peer along the route of a payment we originated. This is
1627 * returned by ChannelMessageHandler::handle_update_fail_htlc to be passed into
1628 * RoutingMessageHandler::handle_htlc_fail_channel_update to update our network map.
1630 typedef enum LDKHTLCFailChannelUpdate_Tag {
1632 * We received an error which included a full ChannelUpdate message.
1634 LDKHTLCFailChannelUpdate_ChannelUpdateMessage,
1636 * We received an error which indicated only that a channel has been closed
1638 LDKHTLCFailChannelUpdate_ChannelClosed,
1640 * We received an error which indicated only that a node has failed
1642 LDKHTLCFailChannelUpdate_NodeFailure,
1644 * Must be last for serialization purposes
1646 LDKHTLCFailChannelUpdate_Sentinel,
1647 } LDKHTLCFailChannelUpdate_Tag;
1649 typedef struct LDKHTLCFailChannelUpdate_LDKChannelUpdateMessage_Body {
1650 struct LDKChannelUpdate msg;
1651 } LDKHTLCFailChannelUpdate_LDKChannelUpdateMessage_Body;
1653 typedef struct LDKHTLCFailChannelUpdate_LDKChannelClosed_Body {
1654 uint64_t short_channel_id;
1656 } LDKHTLCFailChannelUpdate_LDKChannelClosed_Body;
1658 typedef struct LDKHTLCFailChannelUpdate_LDKNodeFailure_Body {
1659 struct LDKPublicKey node_id;
1661 } LDKHTLCFailChannelUpdate_LDKNodeFailure_Body;
1663 typedef struct MUST_USE_STRUCT LDKHTLCFailChannelUpdate {
1664 LDKHTLCFailChannelUpdate_Tag tag;
1666 LDKHTLCFailChannelUpdate_LDKChannelUpdateMessage_Body channel_update_message;
1667 LDKHTLCFailChannelUpdate_LDKChannelClosed_Body channel_closed;
1668 LDKHTLCFailChannelUpdate_LDKNodeFailure_Body node_failure;
1670 } LDKHTLCFailChannelUpdate;
1675 * A query_channel_range message is used to query a peer for channel
1676 * UTXOs in a range of blocks. The recipient of a query makes a best
1677 * effort to reply to the query using one or more reply_channel_range
1680 typedef struct MUST_USE_STRUCT LDKQueryChannelRange {
1682 * Nearly everywhere, inner must be non-null, however in places where
1683 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1685 LDKnativeQueryChannelRange *inner;
1687 } LDKQueryChannelRange;
1692 * A query_short_channel_ids message is used to query a peer for
1693 * routing gossip messages related to one or more short_channel_ids.
1694 * The query recipient will reply with the latest, if available,
1695 * channel_announcement, channel_update and node_announcement messages
1696 * it maintains for the requested short_channel_ids followed by a
1697 * reply_short_channel_ids_end message. The short_channel_ids sent in
1698 * this query are encoded. We only support encoding_type=0 uncompressed
1699 * serialization and do not support encoding_type=1 zlib serialization.
1701 typedef struct MUST_USE_STRUCT LDKQueryShortChannelIds {
1703 * Nearly everywhere, inner must be non-null, however in places where
1704 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1706 LDKnativeQueryShortChannelIds *inner;
1708 } LDKQueryShortChannelIds;
1711 * An event generated by ChannelManager which indicates a message should be sent to a peer (or
1712 * broadcast to most peers).
1713 * These events are handled by PeerManager::process_events if you are using a PeerManager.
1715 typedef enum LDKMessageSendEvent_Tag {
1717 * Used to indicate that we've accepted a channel open and should send the accept_channel
1718 * message provided to the given peer.
1720 LDKMessageSendEvent_SendAcceptChannel,
1722 * Used to indicate that we've initiated a channel open and should send the open_channel
1723 * message provided to the given peer.
1725 LDKMessageSendEvent_SendOpenChannel,
1727 * Used to indicate that a funding_created message should be sent to the peer with the given node_id.
1729 LDKMessageSendEvent_SendFundingCreated,
1731 * Used to indicate that a funding_signed message should be sent to the peer with the given node_id.
1733 LDKMessageSendEvent_SendFundingSigned,
1735 * Used to indicate that a funding_locked message should be sent to the peer with the given node_id.
1737 LDKMessageSendEvent_SendFundingLocked,
1739 * Used to indicate that an announcement_signatures message should be sent to the peer with the given node_id.
1741 LDKMessageSendEvent_SendAnnouncementSignatures,
1743 * Used to indicate that a series of HTLC update messages, as well as a commitment_signed
1744 * message should be sent to the peer with the given node_id.
1746 LDKMessageSendEvent_UpdateHTLCs,
1748 * Used to indicate that a revoke_and_ack message should be sent to the peer with the given node_id.
1750 LDKMessageSendEvent_SendRevokeAndACK,
1752 * Used to indicate that a closing_signed message should be sent to the peer with the given node_id.
1754 LDKMessageSendEvent_SendClosingSigned,
1756 * Used to indicate that a shutdown message should be sent to the peer with the given node_id.
1758 LDKMessageSendEvent_SendShutdown,
1760 * Used to indicate that a channel_reestablish message should be sent to the peer with the given node_id.
1762 LDKMessageSendEvent_SendChannelReestablish,
1764 * Used to indicate that a channel_announcement and channel_update should be broadcast to all
1765 * peers (except the peer with node_id either msg.contents.node_id_1 or msg.contents.node_id_2).
1767 * Note that after doing so, you very likely (unless you did so very recently) want to call
1768 * ChannelManager::broadcast_node_announcement to trigger a BroadcastNodeAnnouncement event.
1769 * This ensures that any nodes which see our channel_announcement also have a relevant
1770 * node_announcement, including relevant feature flags which may be important for routing
1773 LDKMessageSendEvent_BroadcastChannelAnnouncement,
1775 * Used to indicate that a node_announcement should be broadcast to all peers.
1777 LDKMessageSendEvent_BroadcastNodeAnnouncement,
1779 * Used to indicate that a channel_update should be broadcast to all peers.
1781 LDKMessageSendEvent_BroadcastChannelUpdate,
1783 * Broadcast an error downstream to be handled
1785 LDKMessageSendEvent_HandleError,
1787 * When a payment fails we may receive updates back from the hop where it failed. In such
1788 * cases this event is generated so that we can inform the network graph of this information.
1790 LDKMessageSendEvent_PaymentFailureNetworkUpdate,
1792 * Query a peer for channels with funding transaction UTXOs in a block range.
1794 LDKMessageSendEvent_SendChannelRangeQuery,
1796 * Request routing gossip messages from a peer for a list of channels identified by
1797 * their short_channel_ids.
1799 LDKMessageSendEvent_SendShortIdsQuery,
1801 * Must be last for serialization purposes
1803 LDKMessageSendEvent_Sentinel,
1804 } LDKMessageSendEvent_Tag;
1806 typedef struct LDKMessageSendEvent_LDKSendAcceptChannel_Body {
1807 struct LDKPublicKey node_id;
1808 struct LDKAcceptChannel msg;
1809 } LDKMessageSendEvent_LDKSendAcceptChannel_Body;
1811 typedef struct LDKMessageSendEvent_LDKSendOpenChannel_Body {
1812 struct LDKPublicKey node_id;
1813 struct LDKOpenChannel msg;
1814 } LDKMessageSendEvent_LDKSendOpenChannel_Body;
1816 typedef struct LDKMessageSendEvent_LDKSendFundingCreated_Body {
1817 struct LDKPublicKey node_id;
1818 struct LDKFundingCreated msg;
1819 } LDKMessageSendEvent_LDKSendFundingCreated_Body;
1821 typedef struct LDKMessageSendEvent_LDKSendFundingSigned_Body {
1822 struct LDKPublicKey node_id;
1823 struct LDKFundingSigned msg;
1824 } LDKMessageSendEvent_LDKSendFundingSigned_Body;
1826 typedef struct LDKMessageSendEvent_LDKSendFundingLocked_Body {
1827 struct LDKPublicKey node_id;
1828 struct LDKFundingLocked msg;
1829 } LDKMessageSendEvent_LDKSendFundingLocked_Body;
1831 typedef struct LDKMessageSendEvent_LDKSendAnnouncementSignatures_Body {
1832 struct LDKPublicKey node_id;
1833 struct LDKAnnouncementSignatures msg;
1834 } LDKMessageSendEvent_LDKSendAnnouncementSignatures_Body;
1836 typedef struct LDKMessageSendEvent_LDKUpdateHTLCs_Body {
1837 struct LDKPublicKey node_id;
1838 struct LDKCommitmentUpdate updates;
1839 } LDKMessageSendEvent_LDKUpdateHTLCs_Body;
1841 typedef struct LDKMessageSendEvent_LDKSendRevokeAndACK_Body {
1842 struct LDKPublicKey node_id;
1843 struct LDKRevokeAndACK msg;
1844 } LDKMessageSendEvent_LDKSendRevokeAndACK_Body;
1846 typedef struct LDKMessageSendEvent_LDKSendClosingSigned_Body {
1847 struct LDKPublicKey node_id;
1848 struct LDKClosingSigned msg;
1849 } LDKMessageSendEvent_LDKSendClosingSigned_Body;
1851 typedef struct LDKMessageSendEvent_LDKSendShutdown_Body {
1852 struct LDKPublicKey node_id;
1853 struct LDKShutdown msg;
1854 } LDKMessageSendEvent_LDKSendShutdown_Body;
1856 typedef struct LDKMessageSendEvent_LDKSendChannelReestablish_Body {
1857 struct LDKPublicKey node_id;
1858 struct LDKChannelReestablish msg;
1859 } LDKMessageSendEvent_LDKSendChannelReestablish_Body;
1861 typedef struct LDKMessageSendEvent_LDKBroadcastChannelAnnouncement_Body {
1862 struct LDKChannelAnnouncement msg;
1863 struct LDKChannelUpdate update_msg;
1864 } LDKMessageSendEvent_LDKBroadcastChannelAnnouncement_Body;
1866 typedef struct LDKMessageSendEvent_LDKBroadcastNodeAnnouncement_Body {
1867 struct LDKNodeAnnouncement msg;
1868 } LDKMessageSendEvent_LDKBroadcastNodeAnnouncement_Body;
1870 typedef struct LDKMessageSendEvent_LDKBroadcastChannelUpdate_Body {
1871 struct LDKChannelUpdate msg;
1872 } LDKMessageSendEvent_LDKBroadcastChannelUpdate_Body;
1874 typedef struct LDKMessageSendEvent_LDKHandleError_Body {
1875 struct LDKPublicKey node_id;
1876 struct LDKErrorAction action;
1877 } LDKMessageSendEvent_LDKHandleError_Body;
1879 typedef struct LDKMessageSendEvent_LDKPaymentFailureNetworkUpdate_Body {
1880 struct LDKHTLCFailChannelUpdate update;
1881 } LDKMessageSendEvent_LDKPaymentFailureNetworkUpdate_Body;
1883 typedef struct LDKMessageSendEvent_LDKSendChannelRangeQuery_Body {
1884 struct LDKPublicKey node_id;
1885 struct LDKQueryChannelRange msg;
1886 } LDKMessageSendEvent_LDKSendChannelRangeQuery_Body;
1888 typedef struct LDKMessageSendEvent_LDKSendShortIdsQuery_Body {
1889 struct LDKPublicKey node_id;
1890 struct LDKQueryShortChannelIds msg;
1891 } LDKMessageSendEvent_LDKSendShortIdsQuery_Body;
1893 typedef struct MUST_USE_STRUCT LDKMessageSendEvent {
1894 LDKMessageSendEvent_Tag tag;
1896 LDKMessageSendEvent_LDKSendAcceptChannel_Body send_accept_channel;
1897 LDKMessageSendEvent_LDKSendOpenChannel_Body send_open_channel;
1898 LDKMessageSendEvent_LDKSendFundingCreated_Body send_funding_created;
1899 LDKMessageSendEvent_LDKSendFundingSigned_Body send_funding_signed;
1900 LDKMessageSendEvent_LDKSendFundingLocked_Body send_funding_locked;
1901 LDKMessageSendEvent_LDKSendAnnouncementSignatures_Body send_announcement_signatures;
1902 LDKMessageSendEvent_LDKUpdateHTLCs_Body update_htl_cs;
1903 LDKMessageSendEvent_LDKSendRevokeAndACK_Body send_revoke_and_ack;
1904 LDKMessageSendEvent_LDKSendClosingSigned_Body send_closing_signed;
1905 LDKMessageSendEvent_LDKSendShutdown_Body send_shutdown;
1906 LDKMessageSendEvent_LDKSendChannelReestablish_Body send_channel_reestablish;
1907 LDKMessageSendEvent_LDKBroadcastChannelAnnouncement_Body broadcast_channel_announcement;
1908 LDKMessageSendEvent_LDKBroadcastNodeAnnouncement_Body broadcast_node_announcement;
1909 LDKMessageSendEvent_LDKBroadcastChannelUpdate_Body broadcast_channel_update;
1910 LDKMessageSendEvent_LDKHandleError_Body handle_error;
1911 LDKMessageSendEvent_LDKPaymentFailureNetworkUpdate_Body payment_failure_network_update;
1912 LDKMessageSendEvent_LDKSendChannelRangeQuery_Body send_channel_range_query;
1913 LDKMessageSendEvent_LDKSendShortIdsQuery_Body send_short_ids_query;
1915 } LDKMessageSendEvent;
1917 typedef struct LDKCVecTempl_MessageSendEvent {
1918 struct LDKMessageSendEvent *data;
1920 } LDKCVecTempl_MessageSendEvent;
1922 typedef struct LDKCVecTempl_MessageSendEvent LDKCVec_MessageSendEventZ;
1925 * A trait indicating an object may generate message send events
1927 typedef struct LDKMessageSendEventsProvider {
1930 * Gets the list of pending events which were generated by previous actions, clearing the list
1933 LDKCVec_MessageSendEventZ (*get_and_clear_pending_msg_events)(const void *this_arg);
1934 void (*free)(void *this_arg);
1935 } LDKMessageSendEventsProvider;
1937 typedef struct LDKCVecTempl_Event {
1938 struct LDKEvent *data;
1940 } LDKCVecTempl_Event;
1942 typedef struct LDKCVecTempl_Event LDKCVec_EventZ;
1945 * A trait indicating an object may generate events
1947 typedef struct LDKEventsProvider {
1950 * Gets the list of pending events which were generated by previous actions, clearing the list
1953 LDKCVec_EventZ (*get_and_clear_pending_events)(const void *this_arg);
1954 void (*free)(void *this_arg);
1955 } LDKEventsProvider;
1960 * Configuration we set when applicable.
1962 * Default::default() provides sane defaults.
1964 typedef struct MUST_USE_STRUCT LDKChannelHandshakeConfig {
1966 * Nearly everywhere, inner must be non-null, however in places where
1967 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1969 LDKnativeChannelHandshakeConfig *inner;
1971 } LDKChannelHandshakeConfig;
1976 * Optional channel limits which are applied during channel creation.
1978 * These limits are only applied to our counterparty's limits, not our own.
1980 * Use 0/<type>::max_value() as appropriate to skip checking.
1982 * Provides sane defaults for most configurations.
1984 * Most additional limits are disabled except those with which specify a default in individual
1985 * field documentation. Note that this may result in barely-usable channels, but since they
1986 * are applied mostly only to incoming channels that's not much of a problem.
1988 typedef struct MUST_USE_STRUCT LDKChannelHandshakeLimits {
1990 * Nearly everywhere, inner must be non-null, however in places where
1991 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1993 LDKnativeChannelHandshakeLimits *inner;
1995 } LDKChannelHandshakeLimits;
2000 * Options which apply on a per-channel basis and may change at runtime or based on negotiation
2001 * with our counterparty.
2003 typedef struct MUST_USE_STRUCT LDKChannelConfig {
2005 * Nearly everywhere, inner must be non-null, however in places where
2006 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2008 LDKnativeChannelConfig *inner;
2015 * Top-level config which holds ChannelHandshakeLimits and ChannelConfig.
2017 * Default::default() provides sane defaults for most configurations
2018 * (but currently with 0 relay fees!)
2020 typedef struct MUST_USE_STRUCT LDKUserConfig {
2022 * Nearly everywhere, inner must be non-null, however in places where
2023 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2025 LDKnativeUserConfig *inner;
2029 typedef union LDKCResultPtr_TxOut__AccessError {
2030 struct LDKTxOut *result;
2031 enum LDKAccessError *err;
2032 } LDKCResultPtr_TxOut__AccessError;
2034 typedef struct LDKCResultTempl_TxOut__AccessError {
2035 union LDKCResultPtr_TxOut__AccessError contents;
2037 } LDKCResultTempl_TxOut__AccessError;
2039 typedef struct LDKCResultTempl_TxOut__AccessError LDKCResult_TxOutAccessErrorZ;
2042 * The `Access` trait defines behavior for accessing chain data and state, such as blocks and
2045 typedef struct LDKAccess {
2048 * Returns the transaction output of a funding transaction encoded by [`short_channel_id`].
2049 * Returns an error if `genesis_hash` is for a different chain or if such a transaction output
2052 * [`short_channel_id`]: https://github.com/lightningnetwork/lightning-rfc/blob/master/07-routing-gossip.md#definition-of-short_channel_id
2054 LDKCResult_TxOutAccessErrorZ (*get_utxo)(const void *this_arg, const uint8_t (*genesis_hash)[32], uint64_t short_channel_id);
2055 void (*free)(void *this_arg);
2059 * The `Filter` trait defines behavior for indicating chain activity of interest pertaining to
2062 * This is useful in order to have a [`Watch`] implementation convey to a chain source which
2063 * transactions to be notified of. Notification may take the form of pre-filtering blocks or, in
2064 * the case of [BIP 157]/[BIP 158], only fetching a block if the compact filter matches. If
2065 * receiving full blocks from a chain source, any further filtering is unnecessary.
2067 * After an output has been registered, subsequent block retrievals from the chain source must not
2068 * exclude any transactions matching the new criteria nor any in-block descendants of such
2071 * Note that use as part of a [`Watch`] implementation involves reentrancy. Therefore, the `Filter`
2072 * should not block on I/O. Implementations should instead queue the newly monitored data to be
2073 * processed later. Then, in order to block until the data has been processed, any `Watch`
2074 * invocation that has called the `Filter` must return [`TemporaryFailure`].
2076 * [`Watch`]: trait.Watch.html
2077 * [`TemporaryFailure`]: channelmonitor/enum.ChannelMonitorUpdateErr.html#variant.TemporaryFailure
2078 * [BIP 157]: https://github.com/bitcoin/bips/blob/master/bip-0157.mediawiki
2079 * [BIP 158]: https://github.com/bitcoin/bips/blob/master/bip-0158.mediawiki
2081 typedef struct LDKFilter {
2084 * Registers interest in a transaction with `txid` and having an output with `script_pubkey` as
2085 * a spending condition.
2087 void (*register_tx)(const void *this_arg, const uint8_t (*txid)[32], struct LDKu8slice script_pubkey);
2089 * Registers interest in spends of a transaction output identified by `outpoint` having
2090 * `script_pubkey` as the spending condition.
2092 void (*register_output)(const void *this_arg, const struct LDKOutPoint *NONNULL_PTR outpoint, struct LDKu8slice script_pubkey);
2093 void (*free)(void *this_arg);
2097 * `Persist` defines behavior for persisting channel monitors: this could mean
2098 * writing once to disk, and/or uploading to one or more backup services.
2100 * Note that for every new monitor, you **must** persist the new `ChannelMonitor`
2101 * to disk/backups. And, on every update, you **must** persist either the
2102 * `ChannelMonitorUpdate` or the updated monitor itself. Otherwise, there is risk
2103 * of situations such as revoking a transaction, then crashing before this
2104 * revocation can be persisted, then unintentionally broadcasting a revoked
2105 * transaction and losing money. This is a risk because previous channel states
2106 * are toxic, so it's important that whatever channel state is persisted is
2109 typedef struct LDKPersist {
2112 * Persist a new channel's data. The data can be stored any way you want, but
2113 * the identifier provided by Rust-Lightning is the channel's outpoint (and
2114 * it is up to you to maintain a correct mapping between the outpoint and the
2115 * stored channel data). Note that you **must** persist every new monitor to
2116 * disk. See the `Persist` trait documentation for more details.
2118 * See [`ChannelMonitor::serialize_for_disk`] for writing out a `ChannelMonitor`,
2119 * and [`ChannelMonitorUpdateErr`] for requirements when returning errors.
2121 * [`ChannelMonitor::serialize_for_disk`]: struct.ChannelMonitor.html#method.serialize_for_disk
2122 * [`ChannelMonitorUpdateErr`]: enum.ChannelMonitorUpdateErr.html
2124 LDKCResult_NoneChannelMonitorUpdateErrZ (*persist_new_channel)(const void *this_arg, struct LDKOutPoint id, const struct LDKChannelMonitor *NONNULL_PTR data);
2126 * Update one channel's data. The provided `ChannelMonitor` has already
2127 * applied the given update.
2129 * Note that on every update, you **must** persist either the
2130 * `ChannelMonitorUpdate` or the updated monitor itself to disk/backups. See
2131 * the `Persist` trait documentation for more details.
2133 * If an implementer chooses to persist the updates only, they need to make
2134 * sure that all the updates are applied to the `ChannelMonitors` *before*
2135 * the set of channel monitors is given to the `ChannelManager`
2136 * deserialization routine. See [`ChannelMonitor::update_monitor`] for
2137 * applying a monitor update to a monitor. If full `ChannelMonitors` are
2138 * persisted, then there is no need to persist individual updates.
2140 * Note that there could be a performance tradeoff between persisting complete
2141 * channel monitors on every update vs. persisting only updates and applying
2142 * them in batches. The size of each monitor grows `O(number of state updates)`
2143 * whereas updates are small and `O(1)`.
2145 * See [`ChannelMonitor::serialize_for_disk`] for writing out a `ChannelMonitor`,
2146 * [`ChannelMonitorUpdate::write`] for writing out an update, and
2147 * [`ChannelMonitorUpdateErr`] for requirements when returning errors.
2149 * [`ChannelMonitor::update_monitor`]: struct.ChannelMonitor.html#impl-1
2150 * [`ChannelMonitor::serialize_for_disk`]: struct.ChannelMonitor.html#method.serialize_for_disk
2151 * [`ChannelMonitorUpdate::write`]: struct.ChannelMonitorUpdate.html#method.write
2152 * [`ChannelMonitorUpdateErr`]: enum.ChannelMonitorUpdateErr.html
2154 LDKCResult_NoneChannelMonitorUpdateErrZ (*update_persisted_channel)(const void *this_arg, struct LDKOutPoint id, const struct LDKChannelMonitorUpdate *NONNULL_PTR update, const struct LDKChannelMonitor *NONNULL_PTR data);
2155 void (*free)(void *this_arg);
2161 * An implementation of [`chain::Watch`] for monitoring channels.
2163 * Connected and disconnected blocks must be provided to `ChainMonitor` as documented by
2164 * [`chain::Watch`]. May be used in conjunction with [`ChannelManager`] to monitor channels locally
2165 * or used independently to monitor channels remotely. See the [module-level documentation] for
2168 * [`chain::Watch`]: ../trait.Watch.html
2169 * [`ChannelManager`]: ../../ln/channelmanager/struct.ChannelManager.html
2170 * [module-level documentation]: index.html
2172 typedef struct MUST_USE_STRUCT LDKChainMonitor {
2174 * Nearly everywhere, inner must be non-null, however in places where
2175 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2177 LDKnativeChainMonitor *inner;
2181 typedef struct LDKCVecTempl_C2TupleTempl_usize__Transaction {
2182 struct LDKC2TupleTempl_usize__Transaction *data;
2184 } LDKCVecTempl_C2TupleTempl_usize__Transaction;
2186 typedef struct LDKCVecTempl_C2TupleTempl_usize__Transaction LDKCVec_C2Tuple_usizeTransactionZZ;
2188 typedef union LDKCResultPtr_ChannelMonitorUpdate__DecodeError {
2189 struct LDKChannelMonitorUpdate *result;
2190 struct LDKDecodeError *err;
2191 } LDKCResultPtr_ChannelMonitorUpdate__DecodeError;
2193 typedef struct LDKCResultTempl_ChannelMonitorUpdate__DecodeError {
2194 union LDKCResultPtr_ChannelMonitorUpdate__DecodeError contents;
2196 } LDKCResultTempl_ChannelMonitorUpdate__DecodeError;
2198 typedef struct LDKCResultTempl_ChannelMonitorUpdate__DecodeError LDKCResult_ChannelMonitorUpdateDecodeErrorZ;
2203 * Simple structure sent back by `chain::Watch` when an HTLC from a forward channel is detected on
2204 * chain. Used to update the corresponding HTLC in the backward channel. Failing to pass the
2205 * preimage claim backward will lead to loss of funds.
2207 * [`chain::Watch`]: ../trait.Watch.html
2209 typedef struct MUST_USE_STRUCT LDKHTLCUpdate {
2211 * Nearly everywhere, inner must be non-null, however in places where
2212 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2214 LDKnativeHTLCUpdate *inner;
2218 typedef struct LDKCVecTempl_Transaction {
2219 struct LDKTransaction *data;
2221 } LDKCVecTempl_Transaction;
2223 typedef struct LDKCVecTempl_Transaction LDKCVec_TransactionZ;
2225 typedef struct LDKCVecTempl_C2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut {
2226 struct LDKC2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut *data;
2228 } LDKCVecTempl_C2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut;
2230 typedef struct LDKCVecTempl_C2TupleTempl_ThirtyTwoBytes__CVecTempl_C2TupleTempl_u32__TxOut LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ;
2232 typedef union LDKCResultPtr_C2TupleTempl_ThirtyTwoBytes__ChannelMonitor_____DecodeError {
2233 struct LDKC2TupleTempl_ThirtyTwoBytes__ChannelMonitor *result;
2234 struct LDKDecodeError *err;
2235 } LDKCResultPtr_C2TupleTempl_ThirtyTwoBytes__ChannelMonitor_____DecodeError;
2237 typedef struct LDKCResultTempl_C2TupleTempl_ThirtyTwoBytes__ChannelMonitor_____DecodeError {
2238 union LDKCResultPtr_C2TupleTempl_ThirtyTwoBytes__ChannelMonitor_____DecodeError contents;
2240 } LDKCResultTempl_C2TupleTempl_ThirtyTwoBytes__ChannelMonitor_____DecodeError;
2242 typedef struct LDKCResultTempl_C2TupleTempl_ThirtyTwoBytes__ChannelMonitor_____DecodeError LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ;
2244 typedef union LDKCResultPtr_SpendableOutputDescriptor__DecodeError {
2245 struct LDKSpendableOutputDescriptor *result;
2246 struct LDKDecodeError *err;
2247 } LDKCResultPtr_SpendableOutputDescriptor__DecodeError;
2249 typedef struct LDKCResultTempl_SpendableOutputDescriptor__DecodeError {
2250 union LDKCResultPtr_SpendableOutputDescriptor__DecodeError contents;
2252 } LDKCResultTempl_SpendableOutputDescriptor__DecodeError;
2254 typedef struct LDKCResultTempl_SpendableOutputDescriptor__DecodeError LDKCResult_SpendableOutputDescriptorDecodeErrorZ;
2259 * A simple implementation of ChannelKeys that just keeps the private keys in memory.
2261 * This implementation performs no policy checks and is insufficient by itself as
2262 * a secure external signer.
2264 typedef struct MUST_USE_STRUCT LDKInMemoryChannelKeys {
2266 * Nearly everywhere, inner must be non-null, however in places where
2267 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2269 LDKnativeInMemoryChannelKeys *inner;
2271 } LDKInMemoryChannelKeys;
2273 typedef union LDKCResultPtr_InMemoryChannelKeys__DecodeError {
2274 struct LDKInMemoryChannelKeys *result;
2275 struct LDKDecodeError *err;
2276 } LDKCResultPtr_InMemoryChannelKeys__DecodeError;
2278 typedef struct LDKCResultTempl_InMemoryChannelKeys__DecodeError {
2279 union LDKCResultPtr_InMemoryChannelKeys__DecodeError contents;
2281 } LDKCResultTempl_InMemoryChannelKeys__DecodeError;
2283 typedef struct LDKCResultTempl_InMemoryChannelKeys__DecodeError LDKCResult_InMemoryChannelKeysDecodeErrorZ;
2288 * Simple KeysInterface implementor that takes a 32-byte seed for use as a BIP 32 extended key
2289 * and derives keys from that.
2291 * Your node_id is seed/0'
2292 * ChannelMonitor closes may use seed/1'
2293 * Cooperative closes may use seed/2'
2294 * The two close keys may be needed to claim on-chain funds!
2296 typedef struct MUST_USE_STRUCT LDKKeysManager {
2298 * Nearly everywhere, inner must be non-null, however in places where
2299 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2301 LDKnativeKeysManager *inner;
2308 * Details of a channel, as returned by ChannelManager::list_channels and ChannelManager::list_usable_channels
2310 typedef struct MUST_USE_STRUCT LDKChannelDetails {
2312 * Nearly everywhere, inner must be non-null, however in places where
2313 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2315 LDKnativeChannelDetails *inner;
2317 } LDKChannelDetails;
2322 * Features used within an `init` message.
2324 typedef struct MUST_USE_STRUCT LDKInitFeatures {
2326 * Nearly everywhere, inner must be non-null, however in places where
2327 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2329 LDKnativeInitFeatures *inner;
2333 typedef struct LDKCVecTempl_ChannelDetails {
2334 struct LDKChannelDetails *data;
2336 } LDKCVecTempl_ChannelDetails;
2338 typedef struct LDKCVecTempl_ChannelDetails LDKCVec_ChannelDetailsZ;
2343 * A route directs a payment from the sender (us) to the recipient. If the recipient supports MPP,
2344 * it can take multiple paths. Each path is composed of one or more hops through the network.
2346 typedef struct MUST_USE_STRUCT LDKRoute {
2348 * Nearly everywhere, inner must be non-null, however in places where
2349 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2351 LDKnativeRoute *inner;
2355 typedef struct LDKThreeBytes {
2359 typedef struct LDKFourBytes {
2363 typedef struct LDKSixteenBytes {
2367 typedef struct LDKTenBytes {
2372 * An address which can be used to connect to a remote peer
2374 typedef enum LDKNetAddress_Tag {
2376 * An IPv4 address/port on which the peer is listening.
2380 * An IPv6 address/port on which the peer is listening.
2384 * An old-style Tor onion address/port on which the peer is listening.
2386 LDKNetAddress_OnionV2,
2388 * A new-style Tor onion address/port on which the peer is listening.
2389 * To create the human-readable \"hostname\", concatenate ed25519_pubkey, checksum, and version,
2390 * wrap as base32 and append \".onion\".
2392 LDKNetAddress_OnionV3,
2394 * Must be last for serialization purposes
2396 LDKNetAddress_Sentinel,
2397 } LDKNetAddress_Tag;
2399 typedef struct LDKNetAddress_LDKIPv4_Body {
2400 struct LDKFourBytes addr;
2402 } LDKNetAddress_LDKIPv4_Body;
2404 typedef struct LDKNetAddress_LDKIPv6_Body {
2405 struct LDKSixteenBytes addr;
2407 } LDKNetAddress_LDKIPv6_Body;
2409 typedef struct LDKNetAddress_LDKOnionV2_Body {
2410 struct LDKTenBytes addr;
2412 } LDKNetAddress_LDKOnionV2_Body;
2414 typedef struct LDKNetAddress_LDKOnionV3_Body {
2415 struct LDKThirtyTwoBytes ed25519_pubkey;
2419 } LDKNetAddress_LDKOnionV3_Body;
2421 typedef struct MUST_USE_STRUCT LDKNetAddress {
2422 LDKNetAddress_Tag tag;
2424 LDKNetAddress_LDKIPv4_Body i_pv4;
2425 LDKNetAddress_LDKIPv6_Body i_pv6;
2426 LDKNetAddress_LDKOnionV2_Body onion_v2;
2427 LDKNetAddress_LDKOnionV3_Body onion_v3;
2431 typedef struct LDKCVecTempl_NetAddress {
2432 struct LDKNetAddress *data;
2434 } LDKCVecTempl_NetAddress;
2436 typedef struct LDKCVecTempl_NetAddress LDKCVec_NetAddressZ;
2441 * An update_add_htlc message to be sent or received from a peer
2443 typedef struct MUST_USE_STRUCT LDKUpdateAddHTLC {
2445 * Nearly everywhere, inner must be non-null, however in places where
2446 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2448 LDKnativeUpdateAddHTLC *inner;
2455 * An update_fulfill_htlc message to be sent or received from a peer
2457 typedef struct MUST_USE_STRUCT LDKUpdateFulfillHTLC {
2459 * Nearly everywhere, inner must be non-null, however in places where
2460 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2462 LDKnativeUpdateFulfillHTLC *inner;
2464 } LDKUpdateFulfillHTLC;
2469 * An update_fail_htlc message to be sent or received from a peer
2471 typedef struct MUST_USE_STRUCT LDKUpdateFailHTLC {
2473 * Nearly everywhere, inner must be non-null, however in places where
2474 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2476 LDKnativeUpdateFailHTLC *inner;
2478 } LDKUpdateFailHTLC;
2483 * An update_fail_malformed_htlc message to be sent or received from a peer
2485 typedef struct MUST_USE_STRUCT LDKUpdateFailMalformedHTLC {
2487 * Nearly everywhere, inner must be non-null, however in places where
2488 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2490 LDKnativeUpdateFailMalformedHTLC *inner;
2492 } LDKUpdateFailMalformedHTLC;
2497 * A commitment_signed message to be sent or received from a peer
2499 typedef struct MUST_USE_STRUCT LDKCommitmentSigned {
2501 * Nearly everywhere, inner must be non-null, however in places where
2502 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2504 LDKnativeCommitmentSigned *inner;
2506 } LDKCommitmentSigned;
2511 * An update_fee message to be sent or received from a peer
2513 typedef struct MUST_USE_STRUCT LDKUpdateFee {
2515 * Nearly everywhere, inner must be non-null, however in places where
2516 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2518 LDKnativeUpdateFee *inner;
2525 * An init message to be sent or received from a peer
2527 typedef struct MUST_USE_STRUCT LDKInit {
2529 * Nearly everywhere, inner must be non-null, however in places where
2530 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2532 LDKnativeInit *inner;
2537 * A trait to describe an object which can receive channel messages.
2539 * Messages MAY be called in parallel when they originate from different their_node_ids, however
2540 * they MUST NOT be called in parallel when the two calls have the same their_node_id.
2542 typedef struct LDKChannelMessageHandler {
2545 * Handle an incoming open_channel message from the given peer.
2547 void (*handle_open_channel)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKInitFeatures their_features, const struct LDKOpenChannel *NONNULL_PTR msg);
2549 * Handle an incoming accept_channel message from the given peer.
2551 void (*handle_accept_channel)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKInitFeatures their_features, const struct LDKAcceptChannel *NONNULL_PTR msg);
2553 * Handle an incoming funding_created message from the given peer.
2555 void (*handle_funding_created)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKFundingCreated *NONNULL_PTR msg);
2557 * Handle an incoming funding_signed message from the given peer.
2559 void (*handle_funding_signed)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKFundingSigned *NONNULL_PTR msg);
2561 * Handle an incoming funding_locked message from the given peer.
2563 void (*handle_funding_locked)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKFundingLocked *NONNULL_PTR msg);
2565 * Handle an incoming shutdown message from the given peer.
2567 void (*handle_shutdown)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKShutdown *NONNULL_PTR msg);
2569 * Handle an incoming closing_signed message from the given peer.
2571 void (*handle_closing_signed)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKClosingSigned *NONNULL_PTR msg);
2573 * Handle an incoming update_add_htlc message from the given peer.
2575 void (*handle_update_add_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateAddHTLC *NONNULL_PTR msg);
2577 * Handle an incoming update_fulfill_htlc message from the given peer.
2579 void (*handle_update_fulfill_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFulfillHTLC *NONNULL_PTR msg);
2581 * Handle an incoming update_fail_htlc message from the given peer.
2583 void (*handle_update_fail_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFailHTLC *NONNULL_PTR msg);
2585 * Handle an incoming update_fail_malformed_htlc message from the given peer.
2587 void (*handle_update_fail_malformed_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR msg);
2589 * Handle an incoming commitment_signed message from the given peer.
2591 void (*handle_commitment_signed)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKCommitmentSigned *NONNULL_PTR msg);
2593 * Handle an incoming revoke_and_ack message from the given peer.
2595 void (*handle_revoke_and_ack)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKRevokeAndACK *NONNULL_PTR msg);
2597 * Handle an incoming update_fee message from the given peer.
2599 void (*handle_update_fee)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFee *NONNULL_PTR msg);
2601 * Handle an incoming announcement_signatures message from the given peer.
2603 void (*handle_announcement_signatures)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKAnnouncementSignatures *NONNULL_PTR msg);
2605 * Indicates a connection to the peer failed/an existing connection was lost. If no connection
2606 * is believed to be possible in the future (eg they're sending us messages we don't
2607 * understand or indicate they require unknown feature bits), no_connection_possible is set
2608 * and any outstanding channels should be failed.
2610 void (*peer_disconnected)(const void *this_arg, struct LDKPublicKey their_node_id, bool no_connection_possible);
2612 * Handle a peer reconnecting, possibly generating channel_reestablish message(s).
2614 void (*peer_connected)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKInit *NONNULL_PTR msg);
2616 * Handle an incoming channel_reestablish message from the given peer.
2618 void (*handle_channel_reestablish)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKChannelReestablish *NONNULL_PTR msg);
2620 * Handle an incoming error message from the given peer.
2622 void (*handle_error)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKErrorMessage *NONNULL_PTR msg);
2623 struct LDKMessageSendEventsProvider MessageSendEventsProvider;
2624 void (*free)(void *this_arg);
2625 } LDKChannelMessageHandler;
2630 * Arguments for the creation of a ChannelManager that are not deserialized.
2632 * At a high-level, the process for deserializing a ChannelManager and resuming normal operation
2634 * 1) Deserialize all stored ChannelMonitors.
2635 * 2) Deserialize the ChannelManager by filling in this struct and calling <(Sha256dHash,
2636 * ChannelManager)>::read(reader, args).
2637 * This may result in closing some Channels if the ChannelMonitor is newer than the stored
2638 * ChannelManager state to ensure no loss of funds. Thus, transactions may be broadcasted.
2639 * 3) Register all relevant ChannelMonitor outpoints with your chain watch mechanism using
2640 * ChannelMonitor::get_outputs_to_watch() and ChannelMonitor::get_funding_txo().
2641 * 4) Reconnect blocks on your ChannelMonitors.
2642 * 5) Move the ChannelMonitors into your local chain::Watch.
2643 * 6) Disconnect/connect blocks on the ChannelManager.
2645 typedef struct MUST_USE_STRUCT LDKChannelManagerReadArgs {
2647 * Nearly everywhere, inner must be non-null, however in places where
2648 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2650 LDKnativeChannelManagerReadArgs *inner;
2652 } LDKChannelManagerReadArgs;
2654 typedef struct LDKCVecTempl_ChannelMonitor {
2655 struct LDKChannelMonitor *data;
2657 } LDKCVecTempl_ChannelMonitor;
2659 typedef struct LDKCVecTempl_ChannelMonitor LDKCVec_ChannelMonitorZ;
2661 typedef union LDKCResultPtr_C2TupleTempl_ThirtyTwoBytes__ChannelManager_____DecodeError {
2662 struct LDKC2TupleTempl_ThirtyTwoBytes__ChannelManager *result;
2663 struct LDKDecodeError *err;
2664 } LDKCResultPtr_C2TupleTempl_ThirtyTwoBytes__ChannelManager_____DecodeError;
2666 typedef struct LDKCResultTempl_C2TupleTempl_ThirtyTwoBytes__ChannelManager_____DecodeError {
2667 union LDKCResultPtr_C2TupleTempl_ThirtyTwoBytes__ChannelManager_____DecodeError contents;
2669 } LDKCResultTempl_C2TupleTempl_ThirtyTwoBytes__ChannelManager_____DecodeError;
2671 typedef struct LDKCResultTempl_C2TupleTempl_ThirtyTwoBytes__ChannelManager_____DecodeError LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ;
2676 * A ping message to be sent or received from a peer
2678 typedef struct MUST_USE_STRUCT LDKPing {
2680 * Nearly everywhere, inner must be non-null, however in places where
2681 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2683 LDKnativePing *inner;
2690 * A pong message to be sent or received from a peer
2692 typedef struct MUST_USE_STRUCT LDKPong {
2694 * Nearly everywhere, inner must be non-null, however in places where
2695 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2697 LDKnativePong *inner;
2704 * Proof that the sender knows the per-commitment secret of the previous commitment transaction.
2705 * This is used to convince the recipient that the channel is at a certain commitment
2706 * number even if they lost that data due to a local failure. Of course, the peer may lie
2707 * and even later commitments may have been revoked.
2709 typedef struct MUST_USE_STRUCT LDKDataLossProtect {
2711 * Nearly everywhere, inner must be non-null, however in places where
2712 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2714 LDKnativeDataLossProtect *inner;
2716 } LDKDataLossProtect;
2718 typedef union LDKCResultPtr_NetAddress__u8 {
2719 struct LDKNetAddress *result;
2721 } LDKCResultPtr_NetAddress__u8;
2723 typedef struct LDKCResultTempl_NetAddress__u8 {
2724 union LDKCResultPtr_NetAddress__u8 contents;
2726 } LDKCResultTempl_NetAddress__u8;
2728 typedef union LDKCResultPtr_CResultTempl_NetAddress__u8_____DecodeError {
2729 struct LDKCResultTempl_NetAddress__u8 *result;
2730 struct LDKDecodeError *err;
2731 } LDKCResultPtr_CResultTempl_NetAddress__u8_____DecodeError;
2733 typedef struct LDKCResultTempl_CResultTempl_NetAddress__u8_____DecodeError {
2734 union LDKCResultPtr_CResultTempl_NetAddress__u8_____DecodeError contents;
2736 } LDKCResultTempl_CResultTempl_NetAddress__u8_____DecodeError;
2738 typedef struct LDKCResultTempl_CResultTempl_NetAddress__u8_____DecodeError LDKCResult_CResult_NetAddressu8ZDecodeErrorZ;
2743 * The unsigned part of a node_announcement
2745 typedef struct MUST_USE_STRUCT LDKUnsignedNodeAnnouncement {
2747 * Nearly everywhere, inner must be non-null, however in places where
2748 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2750 LDKnativeUnsignedNodeAnnouncement *inner;
2752 } LDKUnsignedNodeAnnouncement;
2757 * Features used within a `node_announcement` message.
2759 typedef struct MUST_USE_STRUCT LDKNodeFeatures {
2761 * Nearly everywhere, inner must be non-null, however in places where
2762 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2764 LDKnativeNodeFeatures *inner;
2771 * Features used within a `channel_announcement` message.
2773 typedef struct MUST_USE_STRUCT LDKChannelFeatures {
2775 * Nearly everywhere, inner must be non-null, however in places where
2776 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2778 LDKnativeChannelFeatures *inner;
2780 } LDKChannelFeatures;
2785 * The unsigned part of a channel_update
2787 typedef struct MUST_USE_STRUCT LDKUnsignedChannelUpdate {
2789 * Nearly everywhere, inner must be non-null, however in places where
2790 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2792 LDKnativeUnsignedChannelUpdate *inner;
2794 } LDKUnsignedChannelUpdate;
2799 * A reply_channel_range message is a reply to a query_channel_range
2800 * message. Multiple reply_channel_range messages can be sent in reply
2801 * to a single query_channel_range message. The query recipient makes a
2802 * best effort to respond based on their local network view which may
2803 * not be a perfect view of the network. The short_channel_ids in the
2804 * reply are encoded. We only support encoding_type=0 uncompressed
2805 * serialization and do not support encoding_type=1 zlib serialization.
2807 typedef struct MUST_USE_STRUCT LDKReplyChannelRange {
2809 * Nearly everywhere, inner must be non-null, however in places where
2810 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2812 LDKnativeReplyChannelRange *inner;
2814 } LDKReplyChannelRange;
2816 typedef struct LDKCVecTempl_u64 {
2821 typedef struct LDKCVecTempl_u64 LDKCVec_u64Z;
2826 * A reply_short_channel_ids_end message is sent as a reply to a
2827 * query_short_channel_ids message. The query recipient makes a best
2828 * effort to respond based on their local network view which may not be
2829 * a perfect view of the network.
2831 typedef struct MUST_USE_STRUCT LDKReplyShortChannelIdsEnd {
2833 * Nearly everywhere, inner must be non-null, however in places where
2834 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2836 LDKnativeReplyShortChannelIdsEnd *inner;
2838 } LDKReplyShortChannelIdsEnd;
2843 * A gossip_timestamp_filter message is used by a node to request
2844 * gossip relay for messages in the requested time range when the
2845 * gossip_queries feature has been negotiated.
2847 typedef struct MUST_USE_STRUCT LDKGossipTimestampFilter {
2849 * Nearly everywhere, inner must be non-null, however in places where
2850 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2852 LDKnativeGossipTimestampFilter *inner;
2854 } LDKGossipTimestampFilter;
2856 typedef struct LDKCVecTempl_UpdateAddHTLC {
2857 struct LDKUpdateAddHTLC *data;
2859 } LDKCVecTempl_UpdateAddHTLC;
2861 typedef struct LDKCVecTempl_UpdateAddHTLC LDKCVec_UpdateAddHTLCZ;
2863 typedef struct LDKCVecTempl_UpdateFulfillHTLC {
2864 struct LDKUpdateFulfillHTLC *data;
2866 } LDKCVecTempl_UpdateFulfillHTLC;
2868 typedef struct LDKCVecTempl_UpdateFulfillHTLC LDKCVec_UpdateFulfillHTLCZ;
2870 typedef struct LDKCVecTempl_UpdateFailHTLC {
2871 struct LDKUpdateFailHTLC *data;
2873 } LDKCVecTempl_UpdateFailHTLC;
2875 typedef struct LDKCVecTempl_UpdateFailHTLC LDKCVec_UpdateFailHTLCZ;
2877 typedef struct LDKCVecTempl_UpdateFailMalformedHTLC {
2878 struct LDKUpdateFailMalformedHTLC *data;
2880 } LDKCVecTempl_UpdateFailMalformedHTLC;
2882 typedef struct LDKCVecTempl_UpdateFailMalformedHTLC LDKCVec_UpdateFailMalformedHTLCZ;
2884 typedef union LDKCResultPtr_bool__LightningError {
2886 struct LDKLightningError *err;
2887 } LDKCResultPtr_bool__LightningError;
2889 typedef struct LDKCResultTempl_bool__LightningError {
2890 union LDKCResultPtr_bool__LightningError contents;
2892 } LDKCResultTempl_bool__LightningError;
2894 typedef struct LDKCResultTempl_bool__LightningError LDKCResult_boolLightningErrorZ;
2896 typedef struct LDKCVecTempl_C3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate {
2897 struct LDKC3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate *data;
2899 } LDKCVecTempl_C3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate;
2901 typedef struct LDKCVecTempl_C3TupleTempl_ChannelAnnouncement__ChannelUpdate__ChannelUpdate LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ;
2903 typedef struct LDKCVecTempl_NodeAnnouncement {
2904 struct LDKNodeAnnouncement *data;
2906 } LDKCVecTempl_NodeAnnouncement;
2908 typedef struct LDKCVecTempl_NodeAnnouncement LDKCVec_NodeAnnouncementZ;
2911 * A trait to describe an object which can receive routing messages.
2913 * # Implementor DoS Warnings
2915 * For `gossip_queries` messages there are potential DoS vectors when handling
2916 * inbound queries. Implementors using an on-disk network graph should be aware of
2917 * repeated disk I/O for queries accessing different parts of the network graph.
2919 typedef struct LDKRoutingMessageHandler {
2922 * Handle an incoming node_announcement message, returning true if it should be forwarded on,
2923 * false or returning an Err otherwise.
2925 LDKCResult_boolLightningErrorZ (*handle_node_announcement)(const void *this_arg, const struct LDKNodeAnnouncement *NONNULL_PTR msg);
2927 * Handle a channel_announcement message, returning true if it should be forwarded on, false
2928 * or returning an Err otherwise.
2930 LDKCResult_boolLightningErrorZ (*handle_channel_announcement)(const void *this_arg, const struct LDKChannelAnnouncement *NONNULL_PTR msg);
2932 * Handle an incoming channel_update message, returning true if it should be forwarded on,
2933 * false or returning an Err otherwise.
2935 LDKCResult_boolLightningErrorZ (*handle_channel_update)(const void *this_arg, const struct LDKChannelUpdate *NONNULL_PTR msg);
2937 * Handle some updates to the route graph that we learned due to an outbound failed payment.
2939 void (*handle_htlc_fail_channel_update)(const void *this_arg, const struct LDKHTLCFailChannelUpdate *NONNULL_PTR update);
2941 * Gets a subset of the channel announcements and updates required to dump our routing table
2942 * to a remote node, starting at the short_channel_id indicated by starting_point and
2943 * including the batch_amount entries immediately higher in numerical value than starting_point.
2945 LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ (*get_next_channel_announcements)(const void *this_arg, uint64_t starting_point, uint8_t batch_amount);
2947 * Gets a subset of the node announcements required to dump our routing table to a remote node,
2948 * starting at the node *after* the provided publickey and including batch_amount entries
2949 * immediately higher (as defined by <PublicKey as Ord>::cmp) than starting_point.
2950 * If None is provided for starting_point, we start at the first node.
2952 LDKCVec_NodeAnnouncementZ (*get_next_node_announcements)(const void *this_arg, struct LDKPublicKey starting_point, uint8_t batch_amount);
2954 * Called when a connection is established with a peer. This can be used to
2955 * perform routing table synchronization using a strategy defined by the
2958 void (*sync_routing_table)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKInit *NONNULL_PTR init);
2960 * Handles the reply of a query we initiated to learn about channels
2961 * for a given range of blocks. We can expect to receive one or more
2962 * replies to a single query.
2964 LDKCResult_NoneLightningErrorZ (*handle_reply_channel_range)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKReplyChannelRange msg);
2966 * Handles the reply of a query we initiated asking for routing gossip
2967 * messages for a list of channels. We should receive this message when
2968 * a node has completed its best effort to send us the pertaining routing
2971 LDKCResult_NoneLightningErrorZ (*handle_reply_short_channel_ids_end)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKReplyShortChannelIdsEnd msg);
2973 * Handles when a peer asks us to send a list of short_channel_ids
2974 * for the requested range of blocks.
2976 LDKCResult_NoneLightningErrorZ (*handle_query_channel_range)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKQueryChannelRange msg);
2978 * Handles when a peer asks us to send routing gossip messages for a
2979 * list of short_channel_ids.
2981 LDKCResult_NoneLightningErrorZ (*handle_query_short_channel_ids)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKQueryShortChannelIds msg);
2982 struct LDKMessageSendEventsProvider MessageSendEventsProvider;
2983 void (*free)(void *this_arg);
2984 } LDKRoutingMessageHandler;
2986 typedef union LDKCResultPtr_ChannelReestablish__DecodeError {
2987 struct LDKChannelReestablish *result;
2988 struct LDKDecodeError *err;
2989 } LDKCResultPtr_ChannelReestablish__DecodeError;
2991 typedef struct LDKCResultTempl_ChannelReestablish__DecodeError {
2992 union LDKCResultPtr_ChannelReestablish__DecodeError contents;
2994 } LDKCResultTempl_ChannelReestablish__DecodeError;
2996 typedef struct LDKCResultTempl_ChannelReestablish__DecodeError LDKCResult_ChannelReestablishDecodeErrorZ;
2998 typedef union LDKCResultPtr_Init__DecodeError {
2999 struct LDKInit *result;
3000 struct LDKDecodeError *err;
3001 } LDKCResultPtr_Init__DecodeError;
3003 typedef struct LDKCResultTempl_Init__DecodeError {
3004 union LDKCResultPtr_Init__DecodeError contents;
3006 } LDKCResultTempl_Init__DecodeError;
3008 typedef struct LDKCResultTempl_Init__DecodeError LDKCResult_InitDecodeErrorZ;
3010 typedef union LDKCResultPtr_Ping__DecodeError {
3011 struct LDKPing *result;
3012 struct LDKDecodeError *err;
3013 } LDKCResultPtr_Ping__DecodeError;
3015 typedef struct LDKCResultTempl_Ping__DecodeError {
3016 union LDKCResultPtr_Ping__DecodeError contents;
3018 } LDKCResultTempl_Ping__DecodeError;
3020 typedef struct LDKCResultTempl_Ping__DecodeError LDKCResult_PingDecodeErrorZ;
3022 typedef union LDKCResultPtr_Pong__DecodeError {
3023 struct LDKPong *result;
3024 struct LDKDecodeError *err;
3025 } LDKCResultPtr_Pong__DecodeError;
3027 typedef struct LDKCResultTempl_Pong__DecodeError {
3028 union LDKCResultPtr_Pong__DecodeError contents;
3030 } LDKCResultTempl_Pong__DecodeError;
3032 typedef struct LDKCResultTempl_Pong__DecodeError LDKCResult_PongDecodeErrorZ;
3034 typedef union LDKCResultPtr_UnsignedChannelAnnouncement__DecodeError {
3035 struct LDKUnsignedChannelAnnouncement *result;
3036 struct LDKDecodeError *err;
3037 } LDKCResultPtr_UnsignedChannelAnnouncement__DecodeError;
3039 typedef struct LDKCResultTempl_UnsignedChannelAnnouncement__DecodeError {
3040 union LDKCResultPtr_UnsignedChannelAnnouncement__DecodeError contents;
3042 } LDKCResultTempl_UnsignedChannelAnnouncement__DecodeError;
3044 typedef struct LDKCResultTempl_UnsignedChannelAnnouncement__DecodeError LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ;
3046 typedef union LDKCResultPtr_UnsignedChannelUpdate__DecodeError {
3047 struct LDKUnsignedChannelUpdate *result;
3048 struct LDKDecodeError *err;
3049 } LDKCResultPtr_UnsignedChannelUpdate__DecodeError;
3051 typedef struct LDKCResultTempl_UnsignedChannelUpdate__DecodeError {
3052 union LDKCResultPtr_UnsignedChannelUpdate__DecodeError contents;
3054 } LDKCResultTempl_UnsignedChannelUpdate__DecodeError;
3056 typedef struct LDKCResultTempl_UnsignedChannelUpdate__DecodeError LDKCResult_UnsignedChannelUpdateDecodeErrorZ;
3058 typedef union LDKCResultPtr_ErrorMessage__DecodeError {
3059 struct LDKErrorMessage *result;
3060 struct LDKDecodeError *err;
3061 } LDKCResultPtr_ErrorMessage__DecodeError;
3063 typedef struct LDKCResultTempl_ErrorMessage__DecodeError {
3064 union LDKCResultPtr_ErrorMessage__DecodeError contents;
3066 } LDKCResultTempl_ErrorMessage__DecodeError;
3068 typedef struct LDKCResultTempl_ErrorMessage__DecodeError LDKCResult_ErrorMessageDecodeErrorZ;
3070 typedef union LDKCResultPtr_UnsignedNodeAnnouncement__DecodeError {
3071 struct LDKUnsignedNodeAnnouncement *result;
3072 struct LDKDecodeError *err;
3073 } LDKCResultPtr_UnsignedNodeAnnouncement__DecodeError;
3075 typedef struct LDKCResultTempl_UnsignedNodeAnnouncement__DecodeError {
3076 union LDKCResultPtr_UnsignedNodeAnnouncement__DecodeError contents;
3078 } LDKCResultTempl_UnsignedNodeAnnouncement__DecodeError;
3080 typedef struct LDKCResultTempl_UnsignedNodeAnnouncement__DecodeError LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ;
3082 typedef union LDKCResultPtr_QueryShortChannelIds__DecodeError {
3083 struct LDKQueryShortChannelIds *result;
3084 struct LDKDecodeError *err;
3085 } LDKCResultPtr_QueryShortChannelIds__DecodeError;
3087 typedef struct LDKCResultTempl_QueryShortChannelIds__DecodeError {
3088 union LDKCResultPtr_QueryShortChannelIds__DecodeError contents;
3090 } LDKCResultTempl_QueryShortChannelIds__DecodeError;
3092 typedef struct LDKCResultTempl_QueryShortChannelIds__DecodeError LDKCResult_QueryShortChannelIdsDecodeErrorZ;
3094 typedef union LDKCResultPtr_ReplyShortChannelIdsEnd__DecodeError {
3095 struct LDKReplyShortChannelIdsEnd *result;
3096 struct LDKDecodeError *err;
3097 } LDKCResultPtr_ReplyShortChannelIdsEnd__DecodeError;
3099 typedef struct LDKCResultTempl_ReplyShortChannelIdsEnd__DecodeError {
3100 union LDKCResultPtr_ReplyShortChannelIdsEnd__DecodeError contents;
3102 } LDKCResultTempl_ReplyShortChannelIdsEnd__DecodeError;
3104 typedef struct LDKCResultTempl_ReplyShortChannelIdsEnd__DecodeError LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ;
3106 typedef union LDKCResultPtr_QueryChannelRange__DecodeError {
3107 struct LDKQueryChannelRange *result;
3108 struct LDKDecodeError *err;
3109 } LDKCResultPtr_QueryChannelRange__DecodeError;
3111 typedef struct LDKCResultTempl_QueryChannelRange__DecodeError {
3112 union LDKCResultPtr_QueryChannelRange__DecodeError contents;
3114 } LDKCResultTempl_QueryChannelRange__DecodeError;
3116 typedef struct LDKCResultTempl_QueryChannelRange__DecodeError LDKCResult_QueryChannelRangeDecodeErrorZ;
3118 typedef union LDKCResultPtr_ReplyChannelRange__DecodeError {
3119 struct LDKReplyChannelRange *result;
3120 struct LDKDecodeError *err;
3121 } LDKCResultPtr_ReplyChannelRange__DecodeError;
3123 typedef struct LDKCResultTempl_ReplyChannelRange__DecodeError {
3124 union LDKCResultPtr_ReplyChannelRange__DecodeError contents;
3126 } LDKCResultTempl_ReplyChannelRange__DecodeError;
3128 typedef struct LDKCResultTempl_ReplyChannelRange__DecodeError LDKCResult_ReplyChannelRangeDecodeErrorZ;
3130 typedef union LDKCResultPtr_GossipTimestampFilter__DecodeError {
3131 struct LDKGossipTimestampFilter *result;
3132 struct LDKDecodeError *err;
3133 } LDKCResultPtr_GossipTimestampFilter__DecodeError;
3135 typedef struct LDKCResultTempl_GossipTimestampFilter__DecodeError {
3136 union LDKCResultPtr_GossipTimestampFilter__DecodeError contents;
3138 } LDKCResultTempl_GossipTimestampFilter__DecodeError;
3140 typedef struct LDKCResultTempl_GossipTimestampFilter__DecodeError LDKCResult_GossipTimestampFilterDecodeErrorZ;
3145 * Provides references to trait impls which handle different types of messages.
3147 typedef struct MUST_USE_STRUCT LDKMessageHandler {
3149 * Nearly everywhere, inner must be non-null, however in places where
3150 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3152 LDKnativeMessageHandler *inner;
3154 } LDKMessageHandler;
3157 * Provides an object which can be used to send data to and which uniquely identifies a connection
3158 * to a remote host. You will need to be able to generate multiple of these which meet Eq and
3159 * implement Hash to meet the PeerManager API.
3161 * For efficiency, Clone should be relatively cheap for this type.
3163 * You probably want to just extend an int and put a file descriptor in a struct and implement
3164 * send_data. Note that if you are using a higher-level net library that may call close() itself,
3165 * be careful to ensure you don't have races whereby you might register a new connection with an
3166 * fd which is the same as a previous one which has yet to be removed via
3167 * PeerManager::socket_disconnected().
3169 typedef struct LDKSocketDescriptor {
3172 * Attempts to send some data from the given slice to the peer.
3174 * Returns the amount of data which was sent, possibly 0 if the socket has since disconnected.
3175 * Note that in the disconnected case, socket_disconnected must still fire and further write
3176 * attempts may occur until that time.
3178 * If the returned size is smaller than data.len(), a write_available event must
3179 * trigger the next time more data can be written. Additionally, until the a send_data event
3180 * completes fully, no further read_events should trigger on the same peer!
3182 * If a read_event on this descriptor had previously returned true (indicating that read
3183 * events should be paused to prevent DoS in the send buffer), resume_read may be set
3184 * indicating that read events on this descriptor should resume. A resume_read of false does
3185 * *not* imply that further read events should be paused.
3187 uintptr_t (*send_data)(void *this_arg, struct LDKu8slice data, bool resume_read);
3189 * Disconnect the socket pointed to by this SocketDescriptor. Once this function returns, no
3190 * more calls to write_buffer_space_avail, read_event or socket_disconnected may be made with
3191 * this descriptor. No socket_disconnected call should be generated as a result of this call,
3192 * though races may occur whereby disconnect_socket is called after a call to
3193 * socket_disconnected but prior to socket_disconnected returning.
3195 void (*disconnect_socket)(void *this_arg);
3196 bool (*eq)(const void *this_arg, const struct LDKSocketDescriptor *NONNULL_PTR other_arg);
3197 uint64_t (*hash)(const void *this_arg);
3198 void *(*clone)(const void *this_arg);
3199 void (*free)(void *this_arg);
3200 } LDKSocketDescriptor;
3205 * A PeerManager manages a set of peers, described by their SocketDescriptor and marshalls socket
3206 * events into messages which it passes on to its MessageHandlers.
3208 * Rather than using a plain PeerManager, it is preferable to use either a SimpleArcPeerManager
3209 * a SimpleRefPeerManager, for conciseness. See their documentation for more details, but
3210 * essentially you should default to using a SimpleRefPeerManager, and use a
3211 * SimpleArcPeerManager when you require a PeerManager with a static lifetime, such as when
3212 * you're using lightning-net-tokio.
3214 typedef struct MUST_USE_STRUCT LDKPeerManager {
3216 * Nearly everywhere, inner must be non-null, however in places where
3217 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3219 LDKnativePeerManager *inner;
3223 typedef struct LDKCVecTempl_PublicKey {
3224 struct LDKPublicKey *data;
3226 } LDKCVecTempl_PublicKey;
3228 typedef struct LDKCVecTempl_PublicKey LDKCVec_PublicKeyZ;
3230 typedef union LDKCResultPtr_CVecTempl_u8_____PeerHandleError {
3231 struct LDKCVecTempl_u8 *result;
3232 struct LDKPeerHandleError *err;
3233 } LDKCResultPtr_CVecTempl_u8_____PeerHandleError;
3235 typedef struct LDKCResultTempl_CVecTempl_u8_____PeerHandleError {
3236 union LDKCResultPtr_CVecTempl_u8_____PeerHandleError contents;
3238 } LDKCResultTempl_CVecTempl_u8_____PeerHandleError;
3240 typedef struct LDKCResultTempl_CVecTempl_u8_____PeerHandleError LDKCResult_CVec_u8ZPeerHandleErrorZ;
3242 typedef union LDKCResultPtr_bool__PeerHandleError {
3244 struct LDKPeerHandleError *err;
3245 } LDKCResultPtr_bool__PeerHandleError;
3247 typedef struct LDKCResultTempl_bool__PeerHandleError {
3248 union LDKCResultPtr_bool__PeerHandleError contents;
3250 } LDKCResultTempl_bool__PeerHandleError;
3252 typedef struct LDKCResultTempl_bool__PeerHandleError LDKCResult_boolPeerHandleErrorZ;
3254 typedef union LDKCResultPtr_SecretKey__Secp256k1Error {
3255 struct LDKSecretKey *result;
3256 enum LDKSecp256k1Error *err;
3257 } LDKCResultPtr_SecretKey__Secp256k1Error;
3259 typedef struct LDKCResultTempl_SecretKey__Secp256k1Error {
3260 union LDKCResultPtr_SecretKey__Secp256k1Error contents;
3262 } LDKCResultTempl_SecretKey__Secp256k1Error;
3264 typedef struct LDKCResultTempl_SecretKey__Secp256k1Error LDKCResult_SecretKeySecpErrorZ;
3266 typedef union LDKCResultPtr_PublicKey__Secp256k1Error {
3267 struct LDKPublicKey *result;
3268 enum LDKSecp256k1Error *err;
3269 } LDKCResultPtr_PublicKey__Secp256k1Error;
3271 typedef struct LDKCResultTempl_PublicKey__Secp256k1Error {
3272 union LDKCResultPtr_PublicKey__Secp256k1Error contents;
3274 } LDKCResultTempl_PublicKey__Secp256k1Error;
3276 typedef struct LDKCResultTempl_PublicKey__Secp256k1Error LDKCResult_PublicKeySecpErrorZ;
3281 * The set of public keys which are used in the creation of one commitment transaction.
3282 * These are derived from the channel base keys and per-commitment data.
3284 * A broadcaster key is provided from potential broadcaster of the computed transaction.
3285 * A countersignatory key is coming from a protocol participant unable to broadcast the
3288 * These keys are assumed to be good, either because the code derived them from
3289 * channel basepoints via the new function, or they were obtained via
3290 * CommitmentTransaction.trust().keys() because we trusted the source of the
3291 * pre-calculated keys.
3293 typedef struct MUST_USE_STRUCT LDKTxCreationKeys {
3295 * Nearly everywhere, inner must be non-null, however in places where
3296 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3298 LDKnativeTxCreationKeys *inner;
3300 } LDKTxCreationKeys;
3302 typedef union LDKCResultPtr_TxCreationKeys__Secp256k1Error {
3303 struct LDKTxCreationKeys *result;
3304 enum LDKSecp256k1Error *err;
3305 } LDKCResultPtr_TxCreationKeys__Secp256k1Error;
3307 typedef struct LDKCResultTempl_TxCreationKeys__Secp256k1Error {
3308 union LDKCResultPtr_TxCreationKeys__Secp256k1Error contents;
3310 } LDKCResultTempl_TxCreationKeys__Secp256k1Error;
3312 typedef struct LDKCResultTempl_TxCreationKeys__Secp256k1Error LDKCResult_TxCreationKeysSecpErrorZ;
3317 * Late-bound per-channel counterparty data used to build transactions.
3319 typedef struct MUST_USE_STRUCT LDKCounterpartyChannelTransactionParameters {
3321 * Nearly everywhere, inner must be non-null, however in places where
3322 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3324 LDKnativeCounterpartyChannelTransactionParameters *inner;
3326 } LDKCounterpartyChannelTransactionParameters;
3331 * Static channel fields used to build transactions given per-commitment fields, organized by
3332 * broadcaster/countersignatory.
3334 * This is derived from the holder/counterparty-organized ChannelTransactionParameters via the
3335 * as_holder_broadcastable and as_counterparty_broadcastable functions.
3337 typedef struct MUST_USE_STRUCT LDKDirectedChannelTransactionParameters {
3339 * Nearly everywhere, inner must be non-null, however in places where
3340 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3342 LDKnativeDirectedChannelTransactionParameters *inner;
3344 } LDKDirectedChannelTransactionParameters;
3349 * A pre-built Bitcoin commitment transaction and its txid.
3351 typedef struct MUST_USE_STRUCT LDKBuiltCommitmentTransaction {
3353 * Nearly everywhere, inner must be non-null, however in places where
3354 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3356 LDKnativeBuiltCommitmentTransaction *inner;
3358 } LDKBuiltCommitmentTransaction;
3365 typedef struct MUST_USE_STRUCT LDKRouteHop {
3367 * Nearly everywhere, inner must be non-null, however in places where
3368 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3370 LDKnativeRouteHop *inner;
3374 typedef struct LDKCVecTempl_RouteHop {
3375 struct LDKRouteHop *data;
3377 } LDKCVecTempl_RouteHop;
3379 typedef struct LDKCVecTempl_CVecTempl_RouteHop {
3380 struct LDKCVecTempl_RouteHop *data;
3382 } LDKCVecTempl_CVecTempl_RouteHop;
3384 typedef struct LDKCVecTempl_CVecTempl_RouteHop LDKCVec_CVec_RouteHopZZ;
3386 typedef union LDKCResultPtr_Route__DecodeError {
3387 struct LDKRoute *result;
3388 struct LDKDecodeError *err;
3389 } LDKCResultPtr_Route__DecodeError;
3391 typedef struct LDKCResultTempl_Route__DecodeError {
3392 union LDKCResultPtr_Route__DecodeError contents;
3394 } LDKCResultTempl_Route__DecodeError;
3396 typedef struct LDKCResultTempl_Route__DecodeError LDKCResult_RouteDecodeErrorZ;
3401 * A channel descriptor which provides a last-hop route to get_route
3403 typedef struct MUST_USE_STRUCT LDKRouteHint {
3405 * Nearly everywhere, inner must be non-null, however in places where
3406 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3408 LDKnativeRouteHint *inner;
3415 * Fees for routing via a given channel or a node
3417 typedef struct MUST_USE_STRUCT LDKRoutingFees {
3419 * Nearly everywhere, inner must be non-null, however in places where
3420 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3422 LDKnativeRoutingFees *inner;
3426 typedef union LDKCResultPtr_Route__LightningError {
3427 struct LDKRoute *result;
3428 struct LDKLightningError *err;
3429 } LDKCResultPtr_Route__LightningError;
3431 typedef struct LDKCResultTempl_Route__LightningError {
3432 union LDKCResultPtr_Route__LightningError contents;
3434 } LDKCResultTempl_Route__LightningError;
3436 typedef struct LDKCResultTempl_Route__LightningError LDKCResult_RouteLightningErrorZ;
3441 * Represents the network as nodes and channels between them
3443 typedef struct MUST_USE_STRUCT LDKNetworkGraph {
3445 * Nearly everywhere, inner must be non-null, however in places where
3446 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3448 LDKnativeNetworkGraph *inner;
3452 typedef struct LDKCVecTempl_RouteHint {
3453 struct LDKRouteHint *data;
3455 } LDKCVecTempl_RouteHint;
3457 typedef struct LDKCVecTempl_RouteHint LDKCVec_RouteHintZ;
3462 * A simple newtype for RwLockReadGuard<'a, NetworkGraph>.
3463 * This exists only to make accessing a RwLock<NetworkGraph> possible from
3464 * the C bindings, as it can be done directly in Rust code.
3466 typedef struct MUST_USE_STRUCT LDKLockedNetworkGraph {
3468 * Nearly everywhere, inner must be non-null, however in places where
3469 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3471 LDKnativeLockedNetworkGraph *inner;
3473 } LDKLockedNetworkGraph;
3478 * Receives and validates network updates from peers,
3479 * stores authentic and relevant data as a network graph.
3480 * This network graph is then used for routing payments.
3481 * Provides interface to help with initial routing sync by
3482 * serving historical announcements.
3484 typedef struct MUST_USE_STRUCT LDKNetGraphMsgHandler {
3486 * Nearly everywhere, inner must be non-null, however in places where
3487 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3489 LDKnativeNetGraphMsgHandler *inner;
3491 } LDKNetGraphMsgHandler;
3496 * Details about one direction of a channel. Received
3497 * within a channel update.
3499 typedef struct MUST_USE_STRUCT LDKDirectionalChannelInfo {
3501 * Nearly everywhere, inner must be non-null, however in places where
3502 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3504 LDKnativeDirectionalChannelInfo *inner;
3506 } LDKDirectionalChannelInfo;
3511 * Details about a channel (both directions).
3512 * Received within a channel announcement.
3514 typedef struct MUST_USE_STRUCT LDKChannelInfo {
3516 * Nearly everywhere, inner must be non-null, however in places where
3517 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3519 LDKnativeChannelInfo *inner;
3523 typedef union LDKCResultPtr_RoutingFees__DecodeError {
3524 struct LDKRoutingFees *result;
3525 struct LDKDecodeError *err;
3526 } LDKCResultPtr_RoutingFees__DecodeError;
3528 typedef struct LDKCResultTempl_RoutingFees__DecodeError {
3529 union LDKCResultPtr_RoutingFees__DecodeError contents;
3531 } LDKCResultTempl_RoutingFees__DecodeError;
3533 typedef struct LDKCResultTempl_RoutingFees__DecodeError LDKCResult_RoutingFeesDecodeErrorZ;
3538 * Information received in the latest node_announcement from this node.
3540 typedef struct MUST_USE_STRUCT LDKNodeAnnouncementInfo {
3542 * Nearly everywhere, inner must be non-null, however in places where
3543 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3545 LDKnativeNodeAnnouncementInfo *inner;
3547 } LDKNodeAnnouncementInfo;
3549 typedef union LDKCResultPtr_NodeAnnouncementInfo__DecodeError {
3550 struct LDKNodeAnnouncementInfo *result;
3551 struct LDKDecodeError *err;
3552 } LDKCResultPtr_NodeAnnouncementInfo__DecodeError;
3554 typedef struct LDKCResultTempl_NodeAnnouncementInfo__DecodeError {
3555 union LDKCResultPtr_NodeAnnouncementInfo__DecodeError contents;
3557 } LDKCResultTempl_NodeAnnouncementInfo__DecodeError;
3559 typedef struct LDKCResultTempl_NodeAnnouncementInfo__DecodeError LDKCResult_NodeAnnouncementInfoDecodeErrorZ;
3564 * Details about a node in the network, known from the network announcement.
3566 typedef struct MUST_USE_STRUCT LDKNodeInfo {
3568 * Nearly everywhere, inner must be non-null, however in places where
3569 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3571 LDKnativeNodeInfo *inner;
3575 typedef union LDKCResultPtr_NodeInfo__DecodeError {
3576 struct LDKNodeInfo *result;
3577 struct LDKDecodeError *err;
3578 } LDKCResultPtr_NodeInfo__DecodeError;
3580 typedef struct LDKCResultTempl_NodeInfo__DecodeError {
3581 union LDKCResultPtr_NodeInfo__DecodeError contents;
3583 } LDKCResultTempl_NodeInfo__DecodeError;
3585 typedef struct LDKCResultTempl_NodeInfo__DecodeError LDKCResult_NodeInfoDecodeErrorZ;
3587 typedef union LDKCResultPtr_NetworkGraph__DecodeError {
3588 struct LDKNetworkGraph *result;
3589 struct LDKDecodeError *err;
3590 } LDKCResultPtr_NetworkGraph__DecodeError;
3592 typedef struct LDKCResultTempl_NetworkGraph__DecodeError {
3593 union LDKCResultPtr_NetworkGraph__DecodeError contents;
3595 } LDKCResultTempl_NetworkGraph__DecodeError;
3597 typedef struct LDKCResultTempl_NetworkGraph__DecodeError LDKCResult_NetworkGraphDecodeErrorZ;
3599 typedef struct LDKCResultTempl_NetAddress__u8 LDKCResult_NetAddressu8Z;
3601 typedef struct LDKCVecTempl_RouteHop LDKCVec_RouteHopZ;
3603 extern const void (*CVec_SpendableOutputDescriptorZ_free)(LDKCVec_SpendableOutputDescriptorZ);
3605 extern const void (*CVec_MessageSendEventZ_free)(LDKCVec_MessageSendEventZ);
3607 extern const void (*CVec_EventZ_free)(LDKCVec_EventZ);
3609 extern const void (*C2Tuple_usizeTransactionZ_free)(LDKC2Tuple_usizeTransactionZ);
3611 extern const void (*CVec_C2Tuple_usizeTransactionZZ_free)(LDKCVec_C2Tuple_usizeTransactionZZ);
3613 extern const void (*CResult_NoneChannelMonitorUpdateErrZ_free)(LDKCResult_NoneChannelMonitorUpdateErrZ);
3615 extern const LDKCResult_NoneChannelMonitorUpdateErrZ (*CResult_NoneChannelMonitorUpdateErrZ_err)(enum LDKChannelMonitorUpdateErr);
3617 extern const void (*CVec_MonitorEventZ_free)(LDKCVec_MonitorEventZ);
3619 extern const void (*CResult_ChannelMonitorUpdateDecodeErrorZ_free)(LDKCResult_ChannelMonitorUpdateDecodeErrorZ);
3621 extern const LDKCResult_ChannelMonitorUpdateDecodeErrorZ (*CResult_ChannelMonitorUpdateDecodeErrorZ_ok)(struct LDKChannelMonitorUpdate);
3623 extern const LDKCResult_ChannelMonitorUpdateDecodeErrorZ (*CResult_ChannelMonitorUpdateDecodeErrorZ_err)(struct LDKDecodeError);
3625 extern const void (*CResult_NoneMonitorUpdateErrorZ_free)(LDKCResult_NoneMonitorUpdateErrorZ);
3627 extern const LDKCResult_NoneMonitorUpdateErrorZ (*CResult_NoneMonitorUpdateErrorZ_err)(struct LDKMonitorUpdateError);
3629 extern const void (*C2Tuple_OutPointScriptZ_free)(LDKC2Tuple_OutPointScriptZ);
3631 extern const void (*CVec_TransactionZ_free)(LDKCVec_TransactionZ);
3633 extern const void (*C2Tuple_u32TxOutZ_free)(LDKC2Tuple_u32TxOutZ);
3635 extern const void (*CVec_C2Tuple_u32TxOutZZ_free)(LDKCVec_C2Tuple_u32TxOutZZ);
3637 extern const void (*C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ_free)(LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ);
3639 extern const void (*CVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ_free)(LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ);
3641 extern const void (*C2Tuple_BlockHashChannelMonitorZ_free)(LDKC2Tuple_BlockHashChannelMonitorZ);
3643 extern const void (*CResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ_free)(LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ);
3645 extern const LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ (*CResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ_ok)(LDKC2Tuple_BlockHashChannelMonitorZ);
3647 extern const LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ (*CResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ_err)(struct LDKDecodeError);
3649 extern const void (*C2Tuple_u64u64Z_free)(LDKC2Tuple_u64u64Z);
3651 extern const void (*CResult_SpendableOutputDescriptorDecodeErrorZ_free)(LDKCResult_SpendableOutputDescriptorDecodeErrorZ);
3653 extern const LDKCResult_SpendableOutputDescriptorDecodeErrorZ (*CResult_SpendableOutputDescriptorDecodeErrorZ_ok)(struct LDKSpendableOutputDescriptor);
3655 extern const LDKCResult_SpendableOutputDescriptorDecodeErrorZ (*CResult_SpendableOutputDescriptorDecodeErrorZ_err)(struct LDKDecodeError);
3657 extern const void (*CVec_SignatureZ_free)(LDKCVec_SignatureZ);
3659 extern const void (*C2Tuple_SignatureCVec_SignatureZZ_free)(LDKC2Tuple_SignatureCVec_SignatureZZ);
3661 extern const void (*CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_free)(LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ);
3663 extern const LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ (*CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_ok)(LDKC2Tuple_SignatureCVec_SignatureZZ);
3665 extern const void (*CResult_SignatureNoneZ_free)(LDKCResult_SignatureNoneZ);
3667 extern const LDKCResult_SignatureNoneZ (*CResult_SignatureNoneZ_ok)(struct LDKSignature);
3669 extern const void (*CResult_CVec_SignatureZNoneZ_free)(LDKCResult_CVec_SignatureZNoneZ);
3671 extern const LDKCResult_CVec_SignatureZNoneZ (*CResult_CVec_SignatureZNoneZ_ok)(LDKCVec_SignatureZ);
3673 extern const void (*CResult_ChanKeySignerDecodeErrorZ_free)(LDKCResult_ChanKeySignerDecodeErrorZ);
3675 extern const LDKCResult_ChanKeySignerDecodeErrorZ (*CResult_ChanKeySignerDecodeErrorZ_ok)(struct LDKChannelKeys);
3677 extern const LDKCResult_ChanKeySignerDecodeErrorZ (*CResult_ChanKeySignerDecodeErrorZ_err)(struct LDKDecodeError);
3679 extern const void (*CResult_InMemoryChannelKeysDecodeErrorZ_free)(LDKCResult_InMemoryChannelKeysDecodeErrorZ);
3681 extern const LDKCResult_InMemoryChannelKeysDecodeErrorZ (*CResult_InMemoryChannelKeysDecodeErrorZ_ok)(struct LDKInMemoryChannelKeys);
3683 extern const LDKCResult_InMemoryChannelKeysDecodeErrorZ (*CResult_InMemoryChannelKeysDecodeErrorZ_err)(struct LDKDecodeError);
3685 extern const void (*CResult_TxOutAccessErrorZ_free)(LDKCResult_TxOutAccessErrorZ);
3687 extern const LDKCResult_TxOutAccessErrorZ (*CResult_TxOutAccessErrorZ_ok)(struct LDKTxOut);
3689 extern const LDKCResult_TxOutAccessErrorZ (*CResult_TxOutAccessErrorZ_err)(enum LDKAccessError);
3691 extern const void (*CResult_NoneAPIErrorZ_free)(LDKCResult_NoneAPIErrorZ);
3693 extern const LDKCResult_NoneAPIErrorZ (*CResult_NoneAPIErrorZ_err)(struct LDKAPIError);
3695 extern const void (*CVec_ChannelDetailsZ_free)(LDKCVec_ChannelDetailsZ);
3697 extern const void (*CResult_NonePaymentSendFailureZ_free)(LDKCResult_NonePaymentSendFailureZ);
3699 extern const LDKCResult_NonePaymentSendFailureZ (*CResult_NonePaymentSendFailureZ_err)(struct LDKPaymentSendFailure);
3701 extern const void (*CVec_NetAddressZ_free)(LDKCVec_NetAddressZ);
3703 extern const void (*CVec_ChannelMonitorZ_free)(LDKCVec_ChannelMonitorZ);
3705 extern const void (*C2Tuple_BlockHashChannelManagerZ_free)(LDKC2Tuple_BlockHashChannelManagerZ);
3707 extern const void (*CResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ_free)(LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ);
3709 extern const LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ (*CResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ_ok)(LDKC2Tuple_BlockHashChannelManagerZ);
3711 extern const LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ (*CResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ_err)(struct LDKDecodeError);
3713 extern const void (*CResult_NetAddressu8Z_free)(LDKCResult_NetAddressu8Z);
3715 extern const LDKCResult_NetAddressu8Z (*CResult_NetAddressu8Z_ok)(struct LDKNetAddress);
3717 extern const LDKCResult_NetAddressu8Z (*CResult_NetAddressu8Z_err)(uint8_t);
3719 extern const void (*CResult_CResult_NetAddressu8ZDecodeErrorZ_free)(LDKCResult_CResult_NetAddressu8ZDecodeErrorZ);
3721 extern const LDKCResult_CResult_NetAddressu8ZDecodeErrorZ (*CResult_CResult_NetAddressu8ZDecodeErrorZ_ok)(LDKCResult_NetAddressu8Z);
3723 extern const LDKCResult_CResult_NetAddressu8ZDecodeErrorZ (*CResult_CResult_NetAddressu8ZDecodeErrorZ_err)(struct LDKDecodeError);
3725 extern const void (*CVec_u64Z_free)(LDKCVec_u64Z);
3727 extern const void (*CVec_UpdateAddHTLCZ_free)(LDKCVec_UpdateAddHTLCZ);
3729 extern const void (*CVec_UpdateFulfillHTLCZ_free)(LDKCVec_UpdateFulfillHTLCZ);
3731 extern const void (*CVec_UpdateFailHTLCZ_free)(LDKCVec_UpdateFailHTLCZ);
3733 extern const void (*CVec_UpdateFailMalformedHTLCZ_free)(LDKCVec_UpdateFailMalformedHTLCZ);
3735 extern const void (*CResult_boolLightningErrorZ_free)(LDKCResult_boolLightningErrorZ);
3737 extern const LDKCResult_boolLightningErrorZ (*CResult_boolLightningErrorZ_ok)(bool);
3739 extern const LDKCResult_boolLightningErrorZ (*CResult_boolLightningErrorZ_err)(struct LDKLightningError);
3741 extern const void (*C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_free)(LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ);
3743 extern const void (*CVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ_free)(LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ);
3745 extern const void (*CVec_NodeAnnouncementZ_free)(LDKCVec_NodeAnnouncementZ);
3747 extern const void (*CResult_NoneLightningErrorZ_free)(LDKCResult_NoneLightningErrorZ);
3749 extern const LDKCResult_NoneLightningErrorZ (*CResult_NoneLightningErrorZ_err)(struct LDKLightningError);
3751 extern const void (*CResult_ChannelReestablishDecodeErrorZ_free)(LDKCResult_ChannelReestablishDecodeErrorZ);
3753 extern const LDKCResult_ChannelReestablishDecodeErrorZ (*CResult_ChannelReestablishDecodeErrorZ_ok)(struct LDKChannelReestablish);
3755 extern const LDKCResult_ChannelReestablishDecodeErrorZ (*CResult_ChannelReestablishDecodeErrorZ_err)(struct LDKDecodeError);
3757 extern const void (*CResult_InitDecodeErrorZ_free)(LDKCResult_InitDecodeErrorZ);
3759 extern const LDKCResult_InitDecodeErrorZ (*CResult_InitDecodeErrorZ_ok)(struct LDKInit);
3761 extern const LDKCResult_InitDecodeErrorZ (*CResult_InitDecodeErrorZ_err)(struct LDKDecodeError);
3763 extern const void (*CResult_PingDecodeErrorZ_free)(LDKCResult_PingDecodeErrorZ);
3765 extern const LDKCResult_PingDecodeErrorZ (*CResult_PingDecodeErrorZ_ok)(struct LDKPing);
3767 extern const LDKCResult_PingDecodeErrorZ (*CResult_PingDecodeErrorZ_err)(struct LDKDecodeError);
3769 extern const void (*CResult_PongDecodeErrorZ_free)(LDKCResult_PongDecodeErrorZ);
3771 extern const LDKCResult_PongDecodeErrorZ (*CResult_PongDecodeErrorZ_ok)(struct LDKPong);
3773 extern const LDKCResult_PongDecodeErrorZ (*CResult_PongDecodeErrorZ_err)(struct LDKDecodeError);
3775 extern const void (*CResult_UnsignedChannelAnnouncementDecodeErrorZ_free)(LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ);
3777 extern const LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ (*CResult_UnsignedChannelAnnouncementDecodeErrorZ_ok)(struct LDKUnsignedChannelAnnouncement);
3779 extern const LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ (*CResult_UnsignedChannelAnnouncementDecodeErrorZ_err)(struct LDKDecodeError);
3781 extern const void (*CResult_UnsignedChannelUpdateDecodeErrorZ_free)(LDKCResult_UnsignedChannelUpdateDecodeErrorZ);
3783 extern const LDKCResult_UnsignedChannelUpdateDecodeErrorZ (*CResult_UnsignedChannelUpdateDecodeErrorZ_ok)(struct LDKUnsignedChannelUpdate);
3785 extern const LDKCResult_UnsignedChannelUpdateDecodeErrorZ (*CResult_UnsignedChannelUpdateDecodeErrorZ_err)(struct LDKDecodeError);
3787 extern const void (*CResult_ErrorMessageDecodeErrorZ_free)(LDKCResult_ErrorMessageDecodeErrorZ);
3789 extern const LDKCResult_ErrorMessageDecodeErrorZ (*CResult_ErrorMessageDecodeErrorZ_ok)(struct LDKErrorMessage);
3791 extern const LDKCResult_ErrorMessageDecodeErrorZ (*CResult_ErrorMessageDecodeErrorZ_err)(struct LDKDecodeError);
3793 extern const void (*CResult_UnsignedNodeAnnouncementDecodeErrorZ_free)(LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ);
3795 extern const LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ (*CResult_UnsignedNodeAnnouncementDecodeErrorZ_ok)(struct LDKUnsignedNodeAnnouncement);
3797 extern const LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ (*CResult_UnsignedNodeAnnouncementDecodeErrorZ_err)(struct LDKDecodeError);
3799 extern const void (*CResult_QueryShortChannelIdsDecodeErrorZ_free)(LDKCResult_QueryShortChannelIdsDecodeErrorZ);
3801 extern const LDKCResult_QueryShortChannelIdsDecodeErrorZ (*CResult_QueryShortChannelIdsDecodeErrorZ_ok)(struct LDKQueryShortChannelIds);
3803 extern const LDKCResult_QueryShortChannelIdsDecodeErrorZ (*CResult_QueryShortChannelIdsDecodeErrorZ_err)(struct LDKDecodeError);
3805 extern const void (*CResult_ReplyShortChannelIdsEndDecodeErrorZ_free)(LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ);
3807 extern const LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ (*CResult_ReplyShortChannelIdsEndDecodeErrorZ_ok)(struct LDKReplyShortChannelIdsEnd);
3809 extern const LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ (*CResult_ReplyShortChannelIdsEndDecodeErrorZ_err)(struct LDKDecodeError);
3811 extern const void (*CResult_QueryChannelRangeDecodeErrorZ_free)(LDKCResult_QueryChannelRangeDecodeErrorZ);
3813 extern const LDKCResult_QueryChannelRangeDecodeErrorZ (*CResult_QueryChannelRangeDecodeErrorZ_ok)(struct LDKQueryChannelRange);
3815 extern const LDKCResult_QueryChannelRangeDecodeErrorZ (*CResult_QueryChannelRangeDecodeErrorZ_err)(struct LDKDecodeError);
3817 extern const void (*CResult_ReplyChannelRangeDecodeErrorZ_free)(LDKCResult_ReplyChannelRangeDecodeErrorZ);
3819 extern const LDKCResult_ReplyChannelRangeDecodeErrorZ (*CResult_ReplyChannelRangeDecodeErrorZ_ok)(struct LDKReplyChannelRange);
3821 extern const LDKCResult_ReplyChannelRangeDecodeErrorZ (*CResult_ReplyChannelRangeDecodeErrorZ_err)(struct LDKDecodeError);
3823 extern const void (*CResult_GossipTimestampFilterDecodeErrorZ_free)(LDKCResult_GossipTimestampFilterDecodeErrorZ);
3825 extern const LDKCResult_GossipTimestampFilterDecodeErrorZ (*CResult_GossipTimestampFilterDecodeErrorZ_ok)(struct LDKGossipTimestampFilter);
3827 extern const LDKCResult_GossipTimestampFilterDecodeErrorZ (*CResult_GossipTimestampFilterDecodeErrorZ_err)(struct LDKDecodeError);
3829 extern const void (*CVec_PublicKeyZ_free)(LDKCVec_PublicKeyZ);
3831 extern const void (*CVec_u8Z_free)(LDKCVec_u8Z);
3833 extern const void (*CResult_CVec_u8ZPeerHandleErrorZ_free)(LDKCResult_CVec_u8ZPeerHandleErrorZ);
3835 extern const LDKCResult_CVec_u8ZPeerHandleErrorZ (*CResult_CVec_u8ZPeerHandleErrorZ_ok)(LDKCVec_u8Z);
3837 extern const LDKCResult_CVec_u8ZPeerHandleErrorZ (*CResult_CVec_u8ZPeerHandleErrorZ_err)(struct LDKPeerHandleError);
3839 extern const void (*CResult_NonePeerHandleErrorZ_free)(LDKCResult_NonePeerHandleErrorZ);
3841 extern const LDKCResult_NonePeerHandleErrorZ (*CResult_NonePeerHandleErrorZ_err)(struct LDKPeerHandleError);
3843 extern const void (*CResult_boolPeerHandleErrorZ_free)(LDKCResult_boolPeerHandleErrorZ);
3845 extern const LDKCResult_boolPeerHandleErrorZ (*CResult_boolPeerHandleErrorZ_ok)(bool);
3847 extern const LDKCResult_boolPeerHandleErrorZ (*CResult_boolPeerHandleErrorZ_err)(struct LDKPeerHandleError);
3849 extern const void (*CResult_SecretKeySecpErrorZ_free)(LDKCResult_SecretKeySecpErrorZ);
3851 extern const LDKCResult_SecretKeySecpErrorZ (*CResult_SecretKeySecpErrorZ_ok)(struct LDKSecretKey);
3853 extern const LDKCResult_SecretKeySecpErrorZ (*CResult_SecretKeySecpErrorZ_err)(enum LDKSecp256k1Error);
3855 extern const void (*CResult_PublicKeySecpErrorZ_free)(LDKCResult_PublicKeySecpErrorZ);
3857 extern const LDKCResult_PublicKeySecpErrorZ (*CResult_PublicKeySecpErrorZ_ok)(struct LDKPublicKey);
3859 extern const LDKCResult_PublicKeySecpErrorZ (*CResult_PublicKeySecpErrorZ_err)(enum LDKSecp256k1Error);
3861 extern const void (*CResult_TxCreationKeysSecpErrorZ_free)(LDKCResult_TxCreationKeysSecpErrorZ);
3863 extern const LDKCResult_TxCreationKeysSecpErrorZ (*CResult_TxCreationKeysSecpErrorZ_ok)(struct LDKTxCreationKeys);
3865 extern const LDKCResult_TxCreationKeysSecpErrorZ (*CResult_TxCreationKeysSecpErrorZ_err)(enum LDKSecp256k1Error);
3867 extern const void (*CResult_TrustedCommitmentTransactionNoneZ_free)(LDKCResult_TrustedCommitmentTransactionNoneZ);
3869 extern const LDKCResult_TrustedCommitmentTransactionNoneZ (*CResult_TrustedCommitmentTransactionNoneZ_ok)(struct LDKTrustedCommitmentTransaction);
3871 extern const void (*CVec_RouteHopZ_free)(LDKCVec_RouteHopZ);
3873 extern const void (*CVec_CVec_RouteHopZZ_free)(LDKCVec_CVec_RouteHopZZ);
3875 extern const void (*CResult_RouteDecodeErrorZ_free)(LDKCResult_RouteDecodeErrorZ);
3877 extern const LDKCResult_RouteDecodeErrorZ (*CResult_RouteDecodeErrorZ_ok)(struct LDKRoute);
3879 extern const LDKCResult_RouteDecodeErrorZ (*CResult_RouteDecodeErrorZ_err)(struct LDKDecodeError);
3881 extern const void (*CVec_RouteHintZ_free)(LDKCVec_RouteHintZ);
3883 extern const void (*CResult_RouteLightningErrorZ_free)(LDKCResult_RouteLightningErrorZ);
3885 extern const LDKCResult_RouteLightningErrorZ (*CResult_RouteLightningErrorZ_ok)(struct LDKRoute);
3887 extern const LDKCResult_RouteLightningErrorZ (*CResult_RouteLightningErrorZ_err)(struct LDKLightningError);
3889 extern const void (*CResult_RoutingFeesDecodeErrorZ_free)(LDKCResult_RoutingFeesDecodeErrorZ);
3891 extern const LDKCResult_RoutingFeesDecodeErrorZ (*CResult_RoutingFeesDecodeErrorZ_ok)(struct LDKRoutingFees);
3893 extern const LDKCResult_RoutingFeesDecodeErrorZ (*CResult_RoutingFeesDecodeErrorZ_err)(struct LDKDecodeError);
3895 extern const void (*CResult_NodeAnnouncementInfoDecodeErrorZ_free)(LDKCResult_NodeAnnouncementInfoDecodeErrorZ);
3897 extern const LDKCResult_NodeAnnouncementInfoDecodeErrorZ (*CResult_NodeAnnouncementInfoDecodeErrorZ_ok)(struct LDKNodeAnnouncementInfo);
3899 extern const LDKCResult_NodeAnnouncementInfoDecodeErrorZ (*CResult_NodeAnnouncementInfoDecodeErrorZ_err)(struct LDKDecodeError);
3901 extern const void (*CResult_NodeInfoDecodeErrorZ_free)(LDKCResult_NodeInfoDecodeErrorZ);
3903 extern const LDKCResult_NodeInfoDecodeErrorZ (*CResult_NodeInfoDecodeErrorZ_ok)(struct LDKNodeInfo);
3905 extern const LDKCResult_NodeInfoDecodeErrorZ (*CResult_NodeInfoDecodeErrorZ_err)(struct LDKDecodeError);
3907 extern const void (*CResult_NetworkGraphDecodeErrorZ_free)(LDKCResult_NetworkGraphDecodeErrorZ);
3909 extern const LDKCResult_NetworkGraphDecodeErrorZ (*CResult_NetworkGraphDecodeErrorZ_ok)(struct LDKNetworkGraph);
3911 extern const LDKCResult_NetworkGraphDecodeErrorZ (*CResult_NetworkGraphDecodeErrorZ_err)(struct LDKDecodeError);
3913 extern const uintptr_t MAX_BUF_SIZE;
3915 extern const uint64_t MIN_RELAY_FEE_SAT_PER_1000_WEIGHT;
3917 extern const uint64_t CLOSED_CHANNEL_UPDATE_ID;
3919 void Transaction_free(struct LDKTransaction _res);
3921 void TxOut_free(struct LDKTxOut _res);
3923 LDKC2Tuple_usizeTransactionZ C2Tuple_usizeTransactionZ_new(uintptr_t a, struct LDKTransaction b);
3925 LDKCResult_NoneChannelMonitorUpdateErrZ CResult_NoneChannelMonitorUpdateErrZ_ok(void);
3927 LDKCResult_NoneMonitorUpdateErrorZ CResult_NoneMonitorUpdateErrorZ_ok(void);
3929 LDKC2Tuple_OutPointScriptZ C2Tuple_OutPointScriptZ_new(struct LDKOutPoint a, LDKCVec_u8Z b);
3931 LDKC2Tuple_u32TxOutZ C2Tuple_u32TxOutZ_new(uint32_t a, struct LDKTxOut b);
3933 LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ_new(struct LDKThirtyTwoBytes a, LDKCVec_C2Tuple_u32TxOutZZ b);
3935 LDKC2Tuple_BlockHashChannelMonitorZ C2Tuple_BlockHashChannelMonitorZ_new(struct LDKThirtyTwoBytes a, struct LDKChannelMonitor b);
3937 LDKC2Tuple_u64u64Z C2Tuple_u64u64Z_new(uint64_t a, uint64_t b);
3939 LDKC2Tuple_SignatureCVec_SignatureZZ C2Tuple_SignatureCVec_SignatureZZ_new(struct LDKSignature a, LDKCVec_SignatureZ b);
3941 LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_err(void);
3943 LDKCResult_SignatureNoneZ CResult_SignatureNoneZ_err(void);
3945 LDKCResult_CVec_SignatureZNoneZ CResult_CVec_SignatureZNoneZ_err(void);
3947 LDKCResult_NoneAPIErrorZ CResult_NoneAPIErrorZ_ok(void);
3949 LDKCResult_NonePaymentSendFailureZ CResult_NonePaymentSendFailureZ_ok(void);
3951 LDKC2Tuple_BlockHashChannelManagerZ C2Tuple_BlockHashChannelManagerZ_new(struct LDKThirtyTwoBytes a, struct LDKChannelManager b);
3953 LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_new(struct LDKChannelAnnouncement a, struct LDKChannelUpdate b, struct LDKChannelUpdate c);
3955 LDKCResult_NoneLightningErrorZ CResult_NoneLightningErrorZ_ok(void);
3957 LDKCResult_NonePeerHandleErrorZ CResult_NonePeerHandleErrorZ_ok(void);
3959 LDKCResult_TrustedCommitmentTransactionNoneZ CResult_TrustedCommitmentTransactionNoneZ_err(void);
3961 void Event_free(struct LDKEvent this_ptr);
3963 struct LDKEvent Event_clone(const struct LDKEvent *NONNULL_PTR orig);
3965 LDKCVec_u8Z Event_write(const struct LDKEvent *NONNULL_PTR obj);
3967 void MessageSendEvent_free(struct LDKMessageSendEvent this_ptr);
3969 struct LDKMessageSendEvent MessageSendEvent_clone(const struct LDKMessageSendEvent *NONNULL_PTR orig);
3972 * Calls the free function if one is set
3974 void MessageSendEventsProvider_free(struct LDKMessageSendEventsProvider this_ptr);
3977 * Calls the free function if one is set
3979 void EventsProvider_free(struct LDKEventsProvider this_ptr);
3981 void APIError_free(struct LDKAPIError this_ptr);
3983 struct LDKAPIError APIError_clone(const struct LDKAPIError *NONNULL_PTR orig);
3985 enum LDKLevel Level_clone(const enum LDKLevel *NONNULL_PTR orig);
3988 * Returns the most verbose logging level.
3990 MUST_USE_RES enum LDKLevel Level_max(void);
3993 * Calls the free function if one is set
3995 void Logger_free(struct LDKLogger this_ptr);
3997 void ChannelHandshakeConfig_free(struct LDKChannelHandshakeConfig this_ptr);
3999 struct LDKChannelHandshakeConfig ChannelHandshakeConfig_clone(const struct LDKChannelHandshakeConfig *NONNULL_PTR orig);
4002 * Confirmations we will wait for before considering the channel locked in.
4003 * Applied only for inbound channels (see ChannelHandshakeLimits::max_minimum_depth for the
4004 * equivalent limit applied to outbound channels).
4008 uint32_t ChannelHandshakeConfig_get_minimum_depth(const struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr);
4011 * Confirmations we will wait for before considering the channel locked in.
4012 * Applied only for inbound channels (see ChannelHandshakeLimits::max_minimum_depth for the
4013 * equivalent limit applied to outbound channels).
4017 void ChannelHandshakeConfig_set_minimum_depth(struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr, uint32_t val);
4020 * Set to the amount of time we require our counterparty to wait to claim their money.
4022 * It's one of the main parameter of our security model. We (or one of our watchtowers) MUST
4023 * be online to check for peer having broadcast a revoked transaction to steal our funds
4024 * at least once every our_to_self_delay blocks.
4026 * Meanwhile, asking for a too high delay, we bother peer to freeze funds for nothing in
4027 * case of an honest unilateral channel close, which implicitly decrease the economic value of
4030 * Default value: BREAKDOWN_TIMEOUT (currently 144), we enforce it as a minimum at channel
4031 * opening so you can tweak config to ask for more security, not less.
4033 uint16_t ChannelHandshakeConfig_get_our_to_self_delay(const struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr);
4036 * Set to the amount of time we require our counterparty to wait to claim their money.
4038 * It's one of the main parameter of our security model. We (or one of our watchtowers) MUST
4039 * be online to check for peer having broadcast a revoked transaction to steal our funds
4040 * at least once every our_to_self_delay blocks.
4042 * Meanwhile, asking for a too high delay, we bother peer to freeze funds for nothing in
4043 * case of an honest unilateral channel close, which implicitly decrease the economic value of
4046 * Default value: BREAKDOWN_TIMEOUT (currently 144), we enforce it as a minimum at channel
4047 * opening so you can tweak config to ask for more security, not less.
4049 void ChannelHandshakeConfig_set_our_to_self_delay(struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr, uint16_t val);
4052 * Set to the smallest value HTLC we will accept to process.
4054 * This value is sent to our counterparty on channel-open and we close the channel any time
4055 * our counterparty misbehaves by sending us an HTLC with a value smaller than this.
4057 * Default value: 1. If the value is less than 1, it is ignored and set to 1, as is required
4060 uint64_t ChannelHandshakeConfig_get_our_htlc_minimum_msat(const struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr);
4063 * Set to the smallest value HTLC we will accept to process.
4065 * This value is sent to our counterparty on channel-open and we close the channel any time
4066 * our counterparty misbehaves by sending us an HTLC with a value smaller than this.
4068 * Default value: 1. If the value is less than 1, it is ignored and set to 1, as is required
4071 void ChannelHandshakeConfig_set_our_htlc_minimum_msat(struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr, uint64_t val);
4073 MUST_USE_RES struct LDKChannelHandshakeConfig ChannelHandshakeConfig_new(uint32_t minimum_depth_arg, uint16_t our_to_self_delay_arg, uint64_t our_htlc_minimum_msat_arg);
4075 MUST_USE_RES struct LDKChannelHandshakeConfig ChannelHandshakeConfig_default(void);
4077 void ChannelHandshakeLimits_free(struct LDKChannelHandshakeLimits this_ptr);
4079 struct LDKChannelHandshakeLimits ChannelHandshakeLimits_clone(const struct LDKChannelHandshakeLimits *NONNULL_PTR orig);
4082 * Minimum allowed satoshis when a channel is funded, this is supplied by the sender and so
4083 * only applies to inbound channels.
4087 uint64_t ChannelHandshakeLimits_get_min_funding_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4090 * Minimum allowed satoshis when a channel is funded, this is supplied by the sender and so
4091 * only applies to inbound channels.
4095 void ChannelHandshakeLimits_set_min_funding_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4098 * The remote node sets a limit on the minimum size of HTLCs we can send to them. This allows
4099 * you to limit the maximum minimum-size they can require.
4101 * Default value: u64::max_value.
4103 uint64_t ChannelHandshakeLimits_get_max_htlc_minimum_msat(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4106 * The remote node sets a limit on the minimum size of HTLCs we can send to them. This allows
4107 * you to limit the maximum minimum-size they can require.
4109 * Default value: u64::max_value.
4111 void ChannelHandshakeLimits_set_max_htlc_minimum_msat(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4114 * The remote node sets a limit on the maximum value of pending HTLCs to them at any given
4115 * time to limit their funds exposure to HTLCs. This allows you to set a minimum such value.
4119 uint64_t ChannelHandshakeLimits_get_min_max_htlc_value_in_flight_msat(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4122 * The remote node sets a limit on the maximum value of pending HTLCs to them at any given
4123 * time to limit their funds exposure to HTLCs. This allows you to set a minimum such value.
4127 void ChannelHandshakeLimits_set_min_max_htlc_value_in_flight_msat(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4130 * The remote node will require we keep a certain amount in direct payment to ourselves at all
4131 * time, ensuring that we are able to be punished if we broadcast an old state. This allows to
4132 * you limit the amount which we will have to keep to ourselves (and cannot use for HTLCs).
4134 * Default value: u64::max_value.
4136 uint64_t ChannelHandshakeLimits_get_max_channel_reserve_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4139 * The remote node will require we keep a certain amount in direct payment to ourselves at all
4140 * time, ensuring that we are able to be punished if we broadcast an old state. This allows to
4141 * you limit the amount which we will have to keep to ourselves (and cannot use for HTLCs).
4143 * Default value: u64::max_value.
4145 void ChannelHandshakeLimits_set_max_channel_reserve_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4148 * The remote node sets a limit on the maximum number of pending HTLCs to them at any given
4149 * time. This allows you to set a minimum such value.
4153 uint16_t ChannelHandshakeLimits_get_min_max_accepted_htlcs(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4156 * The remote node sets a limit on the maximum number of pending HTLCs to them at any given
4157 * time. This allows you to set a minimum such value.
4161 void ChannelHandshakeLimits_set_min_max_accepted_htlcs(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint16_t val);
4164 * Outputs below a certain value will not be added to on-chain transactions. The dust value is
4165 * required to always be higher than this value so this only applies to HTLC outputs (and
4166 * potentially to-self outputs before any payments have been made).
4167 * Thus, HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4168 * This setting allows you to set a minimum dust limit for their commitment transactions,
4169 * reflecting the reality that tiny outputs are not considered standard transactions and will
4170 * not propagate through the Bitcoin network.
4172 * Default value: 546, the current dust limit on the Bitcoin network.
4174 uint64_t ChannelHandshakeLimits_get_min_dust_limit_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4177 * Outputs below a certain value will not be added to on-chain transactions. The dust value is
4178 * required to always be higher than this value so this only applies to HTLC outputs (and
4179 * potentially to-self outputs before any payments have been made).
4180 * Thus, HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4181 * This setting allows you to set a minimum dust limit for their commitment transactions,
4182 * reflecting the reality that tiny outputs are not considered standard transactions and will
4183 * not propagate through the Bitcoin network.
4185 * Default value: 546, the current dust limit on the Bitcoin network.
4187 void ChannelHandshakeLimits_set_min_dust_limit_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4190 * Maximum allowed threshold above which outputs will not be generated in their commitment
4192 * HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4194 * Default value: u64::max_value.
4196 uint64_t ChannelHandshakeLimits_get_max_dust_limit_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4199 * Maximum allowed threshold above which outputs will not be generated in their commitment
4201 * HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4203 * Default value: u64::max_value.
4205 void ChannelHandshakeLimits_set_max_dust_limit_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4208 * Before a channel is usable the funding transaction will need to be confirmed by at least a
4209 * certain number of blocks, specified by the node which is not the funder (as the funder can
4210 * assume they aren't going to double-spend themselves).
4211 * This config allows you to set a limit on the maximum amount of time to wait.
4213 * Default value: 144, or roughly one day and only applies to outbound channels.
4215 uint32_t ChannelHandshakeLimits_get_max_minimum_depth(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4218 * Before a channel is usable the funding transaction will need to be confirmed by at least a
4219 * certain number of blocks, specified by the node which is not the funder (as the funder can
4220 * assume they aren't going to double-spend themselves).
4221 * This config allows you to set a limit on the maximum amount of time to wait.
4223 * Default value: 144, or roughly one day and only applies to outbound channels.
4225 void ChannelHandshakeLimits_set_max_minimum_depth(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint32_t val);
4228 * Set to force the incoming channel to match our announced channel preference in
4231 * Default value: true, to make the default that no announced channels are possible (which is
4232 * appropriate for any nodes which are not online very reliably).
4234 bool ChannelHandshakeLimits_get_force_announced_channel_preference(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4237 * Set to force the incoming channel to match our announced channel preference in
4240 * Default value: true, to make the default that no announced channels are possible (which is
4241 * appropriate for any nodes which are not online very reliably).
4243 void ChannelHandshakeLimits_set_force_announced_channel_preference(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, bool val);
4246 * Set to the amount of time we're willing to wait to claim money back to us.
4248 * Not checking this value would be a security issue, as our peer would be able to set it to
4249 * max relative lock-time (a year) and we would \"lose\" money as it would be locked for a long time.
4251 * Default value: MAX_LOCAL_BREAKDOWN_TIMEOUT (1008), which we also enforce as a maximum value
4252 * so you can tweak config to reduce the loss of having useless locked funds (if your peer accepts)
4254 uint16_t ChannelHandshakeLimits_get_their_to_self_delay(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4257 * Set to the amount of time we're willing to wait to claim money back to us.
4259 * Not checking this value would be a security issue, as our peer would be able to set it to
4260 * max relative lock-time (a year) and we would \"lose\" money as it would be locked for a long time.
4262 * Default value: MAX_LOCAL_BREAKDOWN_TIMEOUT (1008), which we also enforce as a maximum value
4263 * so you can tweak config to reduce the loss of having useless locked funds (if your peer accepts)
4265 void ChannelHandshakeLimits_set_their_to_self_delay(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint16_t val);
4267 MUST_USE_RES struct LDKChannelHandshakeLimits ChannelHandshakeLimits_new(uint64_t min_funding_satoshis_arg, uint64_t max_htlc_minimum_msat_arg, uint64_t min_max_htlc_value_in_flight_msat_arg, uint64_t max_channel_reserve_satoshis_arg, uint16_t min_max_accepted_htlcs_arg, uint64_t min_dust_limit_satoshis_arg, uint64_t max_dust_limit_satoshis_arg, uint32_t max_minimum_depth_arg, bool force_announced_channel_preference_arg, uint16_t their_to_self_delay_arg);
4269 MUST_USE_RES struct LDKChannelHandshakeLimits ChannelHandshakeLimits_default(void);
4271 void ChannelConfig_free(struct LDKChannelConfig this_ptr);
4273 struct LDKChannelConfig ChannelConfig_clone(const struct LDKChannelConfig *NONNULL_PTR orig);
4276 * Amount (in millionths of a satoshi) the channel will charge per transferred satoshi.
4277 * This may be allowed to change at runtime in a later update, however doing so must result in
4278 * update messages sent to notify all nodes of our updated relay fee.
4282 uint32_t ChannelConfig_get_fee_proportional_millionths(const struct LDKChannelConfig *NONNULL_PTR this_ptr);
4285 * Amount (in millionths of a satoshi) the channel will charge per transferred satoshi.
4286 * This may be allowed to change at runtime in a later update, however doing so must result in
4287 * update messages sent to notify all nodes of our updated relay fee.
4291 void ChannelConfig_set_fee_proportional_millionths(struct LDKChannelConfig *NONNULL_PTR this_ptr, uint32_t val);
4294 * Set to announce the channel publicly and notify all nodes that they can route via this
4297 * This should only be set to true for nodes which expect to be online reliably.
4299 * As the node which funds a channel picks this value this will only apply for new outbound
4300 * channels unless ChannelHandshakeLimits::force_announced_channel_preferences is set.
4302 * This cannot be changed after the initial channel handshake.
4304 * Default value: false.
4306 bool ChannelConfig_get_announced_channel(const struct LDKChannelConfig *NONNULL_PTR this_ptr);
4309 * Set to announce the channel publicly and notify all nodes that they can route via this
4312 * This should only be set to true for nodes which expect to be online reliably.
4314 * As the node which funds a channel picks this value this will only apply for new outbound
4315 * channels unless ChannelHandshakeLimits::force_announced_channel_preferences is set.
4317 * This cannot be changed after the initial channel handshake.
4319 * Default value: false.
4321 void ChannelConfig_set_announced_channel(struct LDKChannelConfig *NONNULL_PTR this_ptr, bool val);
4324 * When set, we commit to an upfront shutdown_pubkey at channel open. If our counterparty
4325 * supports it, they will then enforce the mutual-close output to us matches what we provided
4326 * at intialization, preventing us from closing to an alternate pubkey.
4328 * This is set to true by default to provide a slight increase in security, though ultimately
4329 * any attacker who is able to take control of a channel can just as easily send the funds via
4330 * lightning payments, so we never require that our counterparties support this option.
4332 * This cannot be changed after a channel has been initialized.
4334 * Default value: true.
4336 bool ChannelConfig_get_commit_upfront_shutdown_pubkey(const struct LDKChannelConfig *NONNULL_PTR this_ptr);
4339 * When set, we commit to an upfront shutdown_pubkey at channel open. If our counterparty
4340 * supports it, they will then enforce the mutual-close output to us matches what we provided
4341 * at intialization, preventing us from closing to an alternate pubkey.
4343 * This is set to true by default to provide a slight increase in security, though ultimately
4344 * any attacker who is able to take control of a channel can just as easily send the funds via
4345 * lightning payments, so we never require that our counterparties support this option.
4347 * This cannot be changed after a channel has been initialized.
4349 * Default value: true.
4351 void ChannelConfig_set_commit_upfront_shutdown_pubkey(struct LDKChannelConfig *NONNULL_PTR this_ptr, bool val);
4353 MUST_USE_RES struct LDKChannelConfig ChannelConfig_new(uint32_t fee_proportional_millionths_arg, bool announced_channel_arg, bool commit_upfront_shutdown_pubkey_arg);
4355 MUST_USE_RES struct LDKChannelConfig ChannelConfig_default(void);
4357 LDKCVec_u8Z ChannelConfig_write(const struct LDKChannelConfig *NONNULL_PTR obj);
4359 struct LDKChannelConfig ChannelConfig_read(struct LDKu8slice ser);
4361 void UserConfig_free(struct LDKUserConfig this_ptr);
4363 struct LDKUserConfig UserConfig_clone(const struct LDKUserConfig *NONNULL_PTR orig);
4366 * Channel config that we propose to our counterparty.
4368 struct LDKChannelHandshakeConfig UserConfig_get_own_channel_config(const struct LDKUserConfig *NONNULL_PTR this_ptr);
4371 * Channel config that we propose to our counterparty.
4373 void UserConfig_set_own_channel_config(struct LDKUserConfig *NONNULL_PTR this_ptr, struct LDKChannelHandshakeConfig val);
4376 * Limits applied to our counterparty's proposed channel config settings.
4378 struct LDKChannelHandshakeLimits UserConfig_get_peer_channel_config_limits(const struct LDKUserConfig *NONNULL_PTR this_ptr);
4381 * Limits applied to our counterparty's proposed channel config settings.
4383 void UserConfig_set_peer_channel_config_limits(struct LDKUserConfig *NONNULL_PTR this_ptr, struct LDKChannelHandshakeLimits val);
4386 * Channel config which affects behavior during channel lifetime.
4388 struct LDKChannelConfig UserConfig_get_channel_options(const struct LDKUserConfig *NONNULL_PTR this_ptr);
4391 * Channel config which affects behavior during channel lifetime.
4393 void UserConfig_set_channel_options(struct LDKUserConfig *NONNULL_PTR this_ptr, struct LDKChannelConfig val);
4395 MUST_USE_RES struct LDKUserConfig UserConfig_new(struct LDKChannelHandshakeConfig own_channel_config_arg, struct LDKChannelHandshakeLimits peer_channel_config_limits_arg, struct LDKChannelConfig channel_options_arg);
4397 MUST_USE_RES struct LDKUserConfig UserConfig_default(void);
4399 enum LDKAccessError AccessError_clone(const enum LDKAccessError *NONNULL_PTR orig);
4402 * Calls the free function if one is set
4404 void Access_free(struct LDKAccess this_ptr);
4407 * Calls the free function if one is set
4409 void Watch_free(struct LDKWatch this_ptr);
4412 * Calls the free function if one is set
4414 void Filter_free(struct LDKFilter this_ptr);
4417 * Calls the free function if one is set
4419 void BroadcasterInterface_free(struct LDKBroadcasterInterface this_ptr);
4421 enum LDKConfirmationTarget ConfirmationTarget_clone(const enum LDKConfirmationTarget *NONNULL_PTR orig);
4424 * Calls the free function if one is set
4426 void FeeEstimator_free(struct LDKFeeEstimator this_ptr);
4428 void ChainMonitor_free(struct LDKChainMonitor this_ptr);
4431 * Dispatches to per-channel monitors, which are responsible for updating their on-chain view
4432 * of a channel and reacting accordingly based on transactions in the connected block. See
4433 * [`ChannelMonitor::block_connected`] for details. Any HTLCs that were resolved on chain will
4434 * be returned by [`chain::Watch::release_pending_monitor_events`].
4436 * Calls back to [`chain::Filter`] if any monitor indicated new outputs to watch. Subsequent
4437 * calls must not exclude any transactions matching the new outputs nor any in-block
4438 * descendants of such transactions. It is not necessary to re-fetch the block to obtain
4441 * [`ChannelMonitor::block_connected`]: ../channelmonitor/struct.ChannelMonitor.html#method.block_connected
4442 * [`chain::Watch::release_pending_monitor_events`]: ../trait.Watch.html#tymethod.release_pending_monitor_events
4443 * [`chain::Filter`]: ../trait.Filter.html
4445 void ChainMonitor_block_connected(const struct LDKChainMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], LDKCVec_C2Tuple_usizeTransactionZZ txdata, uint32_t height);
4448 * Dispatches to per-channel monitors, which are responsible for updating their on-chain view
4449 * of a channel based on the disconnected block. See [`ChannelMonitor::block_disconnected`] for
4452 * [`ChannelMonitor::block_disconnected`]: ../channelmonitor/struct.ChannelMonitor.html#method.block_disconnected
4454 void ChainMonitor_block_disconnected(const struct LDKChainMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], uint32_t disconnected_height);
4457 * Creates a new `ChainMonitor` used to watch on-chain activity pertaining to channels.
4459 * When an optional chain source implementing [`chain::Filter`] is provided, the chain monitor
4460 * will call back to it indicating transactions and outputs of interest. This allows clients to
4461 * pre-filter blocks or only fetch blocks matching a compact filter. Otherwise, clients may
4462 * always need to fetch full blocks absent another means for determining which blocks contain
4463 * transactions relevant to the watched channels.
4465 * [`chain::Filter`]: ../trait.Filter.html
4467 MUST_USE_RES struct LDKChainMonitor ChainMonitor_new(struct LDKFilter *chain_source, struct LDKBroadcasterInterface broadcaster, struct LDKLogger logger, struct LDKFeeEstimator feeest, struct LDKPersist persister);
4469 struct LDKWatch ChainMonitor_as_Watch(const struct LDKChainMonitor *NONNULL_PTR this_arg);
4471 struct LDKEventsProvider ChainMonitor_as_EventsProvider(const struct LDKChainMonitor *NONNULL_PTR this_arg);
4473 void ChannelMonitorUpdate_free(struct LDKChannelMonitorUpdate this_ptr);
4475 struct LDKChannelMonitorUpdate ChannelMonitorUpdate_clone(const struct LDKChannelMonitorUpdate *NONNULL_PTR orig);
4478 * The sequence number of this update. Updates *must* be replayed in-order according to this
4479 * sequence number (and updates may panic if they are not). The update_id values are strictly
4480 * increasing and increase by one for each new update, with one exception specified below.
4482 * This sequence number is also used to track up to which points updates which returned
4483 * ChannelMonitorUpdateErr::TemporaryFailure have been applied to all copies of a given
4484 * ChannelMonitor when ChannelManager::channel_monitor_updated is called.
4486 * The only instance where update_id values are not strictly increasing is the case where we
4487 * allow post-force-close updates with a special update ID of [`CLOSED_CHANNEL_UPDATE_ID`]. See
4488 * its docs for more details.
4490 * [`CLOSED_CHANNEL_UPDATE_ID`]: constant.CLOSED_CHANNEL_UPDATE_ID.html
4492 uint64_t ChannelMonitorUpdate_get_update_id(const struct LDKChannelMonitorUpdate *NONNULL_PTR this_ptr);
4495 * The sequence number of this update. Updates *must* be replayed in-order according to this
4496 * sequence number (and updates may panic if they are not). The update_id values are strictly
4497 * increasing and increase by one for each new update, with one exception specified below.
4499 * This sequence number is also used to track up to which points updates which returned
4500 * ChannelMonitorUpdateErr::TemporaryFailure have been applied to all copies of a given
4501 * ChannelMonitor when ChannelManager::channel_monitor_updated is called.
4503 * The only instance where update_id values are not strictly increasing is the case where we
4504 * allow post-force-close updates with a special update ID of [`CLOSED_CHANNEL_UPDATE_ID`]. See
4505 * its docs for more details.
4507 * [`CLOSED_CHANNEL_UPDATE_ID`]: constant.CLOSED_CHANNEL_UPDATE_ID.html
4509 void ChannelMonitorUpdate_set_update_id(struct LDKChannelMonitorUpdate *NONNULL_PTR this_ptr, uint64_t val);
4511 LDKCVec_u8Z ChannelMonitorUpdate_write(const struct LDKChannelMonitorUpdate *NONNULL_PTR obj);
4513 LDKCResult_ChannelMonitorUpdateDecodeErrorZ ChannelMonitorUpdate_read(struct LDKu8slice ser);
4515 enum LDKChannelMonitorUpdateErr ChannelMonitorUpdateErr_clone(const enum LDKChannelMonitorUpdateErr *NONNULL_PTR orig);
4517 void MonitorUpdateError_free(struct LDKMonitorUpdateError this_ptr);
4519 void MonitorEvent_free(struct LDKMonitorEvent this_ptr);
4521 struct LDKMonitorEvent MonitorEvent_clone(const struct LDKMonitorEvent *NONNULL_PTR orig);
4523 void HTLCUpdate_free(struct LDKHTLCUpdate this_ptr);
4525 struct LDKHTLCUpdate HTLCUpdate_clone(const struct LDKHTLCUpdate *NONNULL_PTR orig);
4527 LDKCVec_u8Z HTLCUpdate_write(const struct LDKHTLCUpdate *NONNULL_PTR obj);
4529 struct LDKHTLCUpdate HTLCUpdate_read(struct LDKu8slice ser);
4531 void ChannelMonitor_free(struct LDKChannelMonitor this_ptr);
4533 LDKCVec_u8Z ChannelMonitor_write(const struct LDKChannelMonitor *NONNULL_PTR obj);
4536 * Updates a ChannelMonitor on the basis of some new information provided by the Channel
4539 * panics if the given update is not the next update by update_id.
4541 MUST_USE_RES LDKCResult_NoneMonitorUpdateErrorZ ChannelMonitor_update_monitor(struct LDKChannelMonitor *NONNULL_PTR this_arg, const struct LDKChannelMonitorUpdate *NONNULL_PTR updates, const struct LDKBroadcasterInterface *NONNULL_PTR broadcaster, const struct LDKFeeEstimator *NONNULL_PTR fee_estimator, const struct LDKLogger *NONNULL_PTR logger);
4544 * Gets the update_id from the latest ChannelMonitorUpdate which was applied to this
4547 MUST_USE_RES uint64_t ChannelMonitor_get_latest_update_id(const struct LDKChannelMonitor *NONNULL_PTR this_arg);
4550 * Gets the funding transaction outpoint of the channel this ChannelMonitor is monitoring for.
4552 MUST_USE_RES LDKC2Tuple_OutPointScriptZ ChannelMonitor_get_funding_txo(const struct LDKChannelMonitor *NONNULL_PTR this_arg);
4555 * Get the list of HTLCs who's status has been updated on chain. This should be called by
4556 * ChannelManager via [`chain::Watch::release_pending_monitor_events`].
4558 * [`chain::Watch::release_pending_monitor_events`]: ../trait.Watch.html#tymethod.release_pending_monitor_events
4560 MUST_USE_RES LDKCVec_MonitorEventZ ChannelMonitor_get_and_clear_pending_monitor_events(struct LDKChannelMonitor *NONNULL_PTR this_arg);
4563 * Gets the list of pending events which were generated by previous actions, clearing the list
4566 * This is called by ChainMonitor::get_and_clear_pending_events() and is equivalent to
4567 * EventsProvider::get_and_clear_pending_events() except that it requires &mut self as we do
4568 * no internal locking in ChannelMonitors.
4570 MUST_USE_RES LDKCVec_EventZ ChannelMonitor_get_and_clear_pending_events(struct LDKChannelMonitor *NONNULL_PTR this_arg);
4573 * Used by ChannelManager deserialization to broadcast the latest holder state if its copy of
4574 * the Channel was out-of-date. You may use it to get a broadcastable holder toxic tx in case of
4575 * fallen-behind, i.e when receiving a channel_reestablish with a proof that our counterparty side knows
4576 * a higher revocation secret than the holder commitment number we are aware of. Broadcasting these
4577 * transactions are UNSAFE, as they allow counterparty side to punish you. Nevertheless you may want to
4578 * broadcast them if counterparty don't close channel with his higher commitment transaction after a
4579 * substantial amount of time (a month or even a year) to get back funds. Best may be to contact
4580 * out-of-band the other node operator to coordinate with him if option is available to you.
4581 * In any-case, choice is up to the user.
4583 MUST_USE_RES LDKCVec_TransactionZ ChannelMonitor_get_latest_holder_commitment_txn(struct LDKChannelMonitor *NONNULL_PTR this_arg, const struct LDKLogger *NONNULL_PTR logger);
4586 * Processes transactions in a newly connected block, which may result in any of the following:
4587 * - update the monitor's state against resolved HTLCs
4588 * - punish the counterparty in the case of seeing a revoked commitment transaction
4589 * - force close the channel and claim/timeout incoming/outgoing HTLCs if near expiration
4590 * - detect settled outputs for later spending
4591 * - schedule and bump any in-flight claims
4593 * Returns any new outputs to watch from `txdata`; after called, these are also included in
4594 * [`get_outputs_to_watch`].
4596 * [`get_outputs_to_watch`]: #method.get_outputs_to_watch
4598 MUST_USE_RES LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ ChannelMonitor_block_connected(struct LDKChannelMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], LDKCVec_C2Tuple_usizeTransactionZZ txdata, uint32_t height, struct LDKBroadcasterInterface broadcaster, struct LDKFeeEstimator fee_estimator, struct LDKLogger logger);
4601 * Determines if the disconnected block contained any transactions of interest and updates
4604 void ChannelMonitor_block_disconnected(struct LDKChannelMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], uint32_t height, struct LDKBroadcasterInterface broadcaster, struct LDKFeeEstimator fee_estimator, struct LDKLogger logger);
4607 * Calls the free function if one is set
4609 void Persist_free(struct LDKPersist this_ptr);
4611 LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ C2Tuple_BlockHashChannelMonitorZ_read(struct LDKu8slice ser, const struct LDKKeysInterface *NONNULL_PTR arg);
4613 void OutPoint_free(struct LDKOutPoint this_ptr);
4615 struct LDKOutPoint OutPoint_clone(const struct LDKOutPoint *NONNULL_PTR orig);
4618 * The referenced transaction's txid.
4620 const uint8_t (*OutPoint_get_txid(const struct LDKOutPoint *NONNULL_PTR this_ptr))[32];
4623 * The referenced transaction's txid.
4625 void OutPoint_set_txid(struct LDKOutPoint *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
4628 * The index of the referenced output in its transaction's vout.
4630 uint16_t OutPoint_get_index(const struct LDKOutPoint *NONNULL_PTR this_ptr);
4633 * The index of the referenced output in its transaction's vout.
4635 void OutPoint_set_index(struct LDKOutPoint *NONNULL_PTR this_ptr, uint16_t val);
4637 MUST_USE_RES struct LDKOutPoint OutPoint_new(struct LDKThirtyTwoBytes txid_arg, uint16_t index_arg);
4640 * Convert an `OutPoint` to a lightning channel id.
4642 MUST_USE_RES struct LDKThirtyTwoBytes OutPoint_to_channel_id(const struct LDKOutPoint *NONNULL_PTR this_arg);
4644 LDKCVec_u8Z OutPoint_write(const struct LDKOutPoint *NONNULL_PTR obj);
4646 struct LDKOutPoint OutPoint_read(struct LDKu8slice ser);
4648 void SpendableOutputDescriptor_free(struct LDKSpendableOutputDescriptor this_ptr);
4650 struct LDKSpendableOutputDescriptor SpendableOutputDescriptor_clone(const struct LDKSpendableOutputDescriptor *NONNULL_PTR orig);
4652 LDKCVec_u8Z SpendableOutputDescriptor_write(const struct LDKSpendableOutputDescriptor *NONNULL_PTR obj);
4654 LDKCResult_SpendableOutputDescriptorDecodeErrorZ SpendableOutputDescriptor_read(struct LDKu8slice ser);
4656 struct LDKChannelKeys ChannelKeys_clone(const struct LDKChannelKeys *NONNULL_PTR orig);
4659 * Calls the free function if one is set
4661 void ChannelKeys_free(struct LDKChannelKeys this_ptr);
4664 * Calls the free function if one is set
4666 void KeysInterface_free(struct LDKKeysInterface this_ptr);
4668 void InMemoryChannelKeys_free(struct LDKInMemoryChannelKeys this_ptr);
4670 struct LDKInMemoryChannelKeys InMemoryChannelKeys_clone(const struct LDKInMemoryChannelKeys *NONNULL_PTR orig);
4673 * Private key of anchor tx
4675 const uint8_t (*InMemoryChannelKeys_get_funding_key(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr))[32];
4678 * Private key of anchor tx
4680 void InMemoryChannelKeys_set_funding_key(struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr, struct LDKSecretKey val);
4683 * Holder secret key for blinded revocation pubkey
4685 const uint8_t (*InMemoryChannelKeys_get_revocation_base_key(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr))[32];
4688 * Holder secret key for blinded revocation pubkey
4690 void InMemoryChannelKeys_set_revocation_base_key(struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr, struct LDKSecretKey val);
4693 * Holder secret key used for our balance in counterparty-broadcasted commitment transactions
4695 const uint8_t (*InMemoryChannelKeys_get_payment_key(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr))[32];
4698 * Holder secret key used for our balance in counterparty-broadcasted commitment transactions
4700 void InMemoryChannelKeys_set_payment_key(struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr, struct LDKSecretKey val);
4703 * Holder secret key used in HTLC tx
4705 const uint8_t (*InMemoryChannelKeys_get_delayed_payment_base_key(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr))[32];
4708 * Holder secret key used in HTLC tx
4710 void InMemoryChannelKeys_set_delayed_payment_base_key(struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr, struct LDKSecretKey val);
4713 * Holder htlc secret key used in commitment tx htlc outputs
4715 const uint8_t (*InMemoryChannelKeys_get_htlc_base_key(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr))[32];
4718 * Holder htlc secret key used in commitment tx htlc outputs
4720 void InMemoryChannelKeys_set_htlc_base_key(struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr, struct LDKSecretKey val);
4725 const uint8_t (*InMemoryChannelKeys_get_commitment_seed(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr))[32];
4730 void InMemoryChannelKeys_set_commitment_seed(struct LDKInMemoryChannelKeys *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
4733 * Create a new InMemoryChannelKeys
4735 MUST_USE_RES struct LDKInMemoryChannelKeys InMemoryChannelKeys_new(struct LDKSecretKey funding_key, struct LDKSecretKey revocation_base_key, struct LDKSecretKey payment_key, struct LDKSecretKey delayed_payment_base_key, struct LDKSecretKey htlc_base_key, struct LDKThirtyTwoBytes commitment_seed, uint64_t channel_value_satoshis, LDKC2Tuple_u64u64Z key_derivation_params);
4738 * Counterparty pubkeys.
4739 * Will panic if ready_channel wasn't called.
4741 MUST_USE_RES struct LDKChannelPublicKeys InMemoryChannelKeys_counterparty_pubkeys(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4744 * The contest_delay value specified by our counterparty and applied on holder-broadcastable
4745 * transactions, ie the amount of time that we have to wait to recover our funds if we
4746 * broadcast a transaction.
4747 * Will panic if ready_channel wasn't called.
4749 MUST_USE_RES uint16_t InMemoryChannelKeys_counterparty_selected_contest_delay(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4752 * The contest_delay value specified by us and applied on transactions broadcastable
4753 * by our counterparty, ie the amount of time that they have to wait to recover their funds
4754 * if they broadcast a transaction.
4755 * Will panic if ready_channel wasn't called.
4757 MUST_USE_RES uint16_t InMemoryChannelKeys_holder_selected_contest_delay(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4760 * Whether the holder is the initiator
4761 * Will panic if ready_channel wasn't called.
4763 MUST_USE_RES bool InMemoryChannelKeys_is_outbound(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4767 * Will panic if ready_channel wasn't called.
4769 MUST_USE_RES struct LDKOutPoint InMemoryChannelKeys_funding_outpoint(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4772 * Obtain a ChannelTransactionParameters for this channel, to be used when verifying or
4773 * building transactions.
4775 * Will panic if ready_channel wasn't called.
4777 MUST_USE_RES struct LDKChannelTransactionParameters InMemoryChannelKeys_get_channel_parameters(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4779 struct LDKChannelKeys InMemoryChannelKeys_as_ChannelKeys(const struct LDKInMemoryChannelKeys *NONNULL_PTR this_arg);
4781 LDKCVec_u8Z InMemoryChannelKeys_write(const struct LDKInMemoryChannelKeys *NONNULL_PTR obj);
4783 LDKCResult_InMemoryChannelKeysDecodeErrorZ InMemoryChannelKeys_read(struct LDKu8slice ser);
4785 void KeysManager_free(struct LDKKeysManager this_ptr);
4788 * Constructs a KeysManager from a 32-byte seed. If the seed is in some way biased (eg your
4789 * CSRNG is busted) this may panic (but more importantly, you will possibly lose funds).
4790 * starting_time isn't strictly required to actually be a time, but it must absolutely,
4791 * without a doubt, be unique to this instance. ie if you start multiple times with the same
4792 * seed, starting_time must be unique to each run. Thus, the easiest way to achieve this is to
4793 * simply use the current time (with very high precision).
4795 * The seed MUST be backed up safely prior to use so that the keys can be re-created, however,
4796 * obviously, starting_time should be unique every time you reload the library - it is only
4797 * used to generate new ephemeral key data (which will be stored by the individual channel if
4800 * Note that the seed is required to recover certain on-chain funds independent of
4801 * ChannelMonitor data, though a current copy of ChannelMonitor data is also required for any
4802 * channel, and some on-chain during-closing funds.
4804 * Note that until the 0.1 release there is no guarantee of backward compatibility between
4805 * versions. Once the library is more fully supported, the docs will be updated to include a
4806 * detailed description of the guarantee.
4808 MUST_USE_RES struct LDKKeysManager KeysManager_new(const uint8_t (*seed)[32], enum LDKNetwork network, uint64_t starting_time_secs, uint32_t starting_time_nanos);
4811 * Derive an old set of ChannelKeys for per-channel secrets based on a key derivation
4813 * Key derivation parameters are accessible through a per-channel secrets
4814 * ChannelKeys::key_derivation_params and is provided inside DynamicOuputP2WSH in case of
4815 * onchain output detection for which a corresponding delayed_payment_key must be derived.
4817 MUST_USE_RES struct LDKInMemoryChannelKeys KeysManager_derive_channel_keys(const struct LDKKeysManager *NONNULL_PTR this_arg, uint64_t channel_value_satoshis, uint64_t params_1, uint64_t params_2);
4819 struct LDKKeysInterface KeysManager_as_KeysInterface(const struct LDKKeysManager *NONNULL_PTR this_arg);
4821 void ChannelManager_free(struct LDKChannelManager this_ptr);
4823 void ChannelDetails_free(struct LDKChannelDetails this_ptr);
4825 struct LDKChannelDetails ChannelDetails_clone(const struct LDKChannelDetails *NONNULL_PTR orig);
4828 * The channel's ID (prior to funding transaction generation, this is a random 32 bytes,
4829 * thereafter this is the txid of the funding transaction xor the funding transaction output).
4830 * Note that this means this value is *not* persistent - it can change once during the
4831 * lifetime of the channel.
4833 const uint8_t (*ChannelDetails_get_channel_id(const struct LDKChannelDetails *NONNULL_PTR this_ptr))[32];
4836 * The channel's ID (prior to funding transaction generation, this is a random 32 bytes,
4837 * thereafter this is the txid of the funding transaction xor the funding transaction output).
4838 * Note that this means this value is *not* persistent - it can change once during the
4839 * lifetime of the channel.
4841 void ChannelDetails_set_channel_id(struct LDKChannelDetails *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
4844 * The node_id of our counterparty
4846 struct LDKPublicKey ChannelDetails_get_remote_network_id(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4849 * The node_id of our counterparty
4851 void ChannelDetails_set_remote_network_id(struct LDKChannelDetails *NONNULL_PTR this_ptr, struct LDKPublicKey val);
4854 * The Features the channel counterparty provided upon last connection.
4855 * Useful for routing as it is the most up-to-date copy of the counterparty's features and
4856 * many routing-relevant features are present in the init context.
4858 struct LDKInitFeatures ChannelDetails_get_counterparty_features(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4861 * The Features the channel counterparty provided upon last connection.
4862 * Useful for routing as it is the most up-to-date copy of the counterparty's features and
4863 * many routing-relevant features are present in the init context.
4865 void ChannelDetails_set_counterparty_features(struct LDKChannelDetails *NONNULL_PTR this_ptr, struct LDKInitFeatures val);
4868 * The value, in satoshis, of this channel as appears in the funding output
4870 uint64_t ChannelDetails_get_channel_value_satoshis(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4873 * The value, in satoshis, of this channel as appears in the funding output
4875 void ChannelDetails_set_channel_value_satoshis(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
4878 * The user_id passed in to create_channel, or 0 if the channel was inbound.
4880 uint64_t ChannelDetails_get_user_id(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4883 * The user_id passed in to create_channel, or 0 if the channel was inbound.
4885 void ChannelDetails_set_user_id(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
4888 * The available outbound capacity for sending HTLCs to the remote peer. This does not include
4889 * any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
4890 * available for inclusion in new outbound HTLCs). This further does not include any pending
4891 * outgoing HTLCs which are awaiting some other resolution to be sent.
4893 uint64_t ChannelDetails_get_outbound_capacity_msat(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4896 * The available outbound capacity for sending HTLCs to the remote peer. This does not include
4897 * any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
4898 * available for inclusion in new outbound HTLCs). This further does not include any pending
4899 * outgoing HTLCs which are awaiting some other resolution to be sent.
4901 void ChannelDetails_set_outbound_capacity_msat(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
4904 * The available inbound capacity for the remote peer to send HTLCs to us. This does not
4905 * include any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
4906 * available for inclusion in new inbound HTLCs).
4907 * Note that there are some corner cases not fully handled here, so the actual available
4908 * inbound capacity may be slightly higher than this.
4910 uint64_t ChannelDetails_get_inbound_capacity_msat(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4913 * The available inbound capacity for the remote peer to send HTLCs to us. This does not
4914 * include any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
4915 * available for inclusion in new inbound HTLCs).
4916 * Note that there are some corner cases not fully handled here, so the actual available
4917 * inbound capacity may be slightly higher than this.
4919 void ChannelDetails_set_inbound_capacity_msat(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
4922 * True if the channel is (a) confirmed and funding_locked messages have been exchanged, (b)
4923 * the peer is connected, and (c) no monitor update failure is pending resolution.
4925 bool ChannelDetails_get_is_live(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
4928 * True if the channel is (a) confirmed and funding_locked messages have been exchanged, (b)
4929 * the peer is connected, and (c) no monitor update failure is pending resolution.
4931 void ChannelDetails_set_is_live(struct LDKChannelDetails *NONNULL_PTR this_ptr, bool val);
4933 void PaymentSendFailure_free(struct LDKPaymentSendFailure this_ptr);
4936 * Constructs a new ChannelManager to hold several channels and route between them.
4938 * This is the main \"logic hub\" for all channel-related actions, and implements
4939 * ChannelMessageHandler.
4941 * Non-proportional fees are fixed according to our risk using the provided fee estimator.
4943 * panics if channel_value_satoshis is >= `MAX_FUNDING_SATOSHIS`!
4945 * Users must provide the current blockchain height from which to track onchain channel
4946 * funding outpoints and send payments with reliable timelocks.
4948 * Users need to notify the new ChannelManager when a new block is connected or
4949 * disconnected using its `block_connected` and `block_disconnected` methods.
4951 MUST_USE_RES struct LDKChannelManager ChannelManager_new(enum LDKNetwork network, struct LDKFeeEstimator fee_est, struct LDKWatch chain_monitor, struct LDKBroadcasterInterface tx_broadcaster, struct LDKLogger logger, struct LDKKeysInterface keys_manager, struct LDKUserConfig config, uintptr_t current_blockchain_height);
4954 * Creates a new outbound channel to the given remote node and with the given value.
4956 * user_id will be provided back as user_channel_id in FundingGenerationReady and
4957 * FundingBroadcastSafe events to allow tracking of which events correspond with which
4958 * create_channel call. Note that user_channel_id defaults to 0 for inbound channels, so you
4959 * may wish to avoid using 0 for user_id here.
4961 * If successful, will generate a SendOpenChannel message event, so you should probably poll
4962 * PeerManager::process_events afterwards.
4964 * Raises APIError::APIMisuseError when channel_value_satoshis > 2**24 or push_msat is
4965 * greater than channel_value_satoshis * 1k or channel_value_satoshis is < 1000.
4967 MUST_USE_RES LDKCResult_NoneAPIErrorZ ChannelManager_create_channel(const struct LDKChannelManager *NONNULL_PTR this_arg, struct LDKPublicKey their_network_key, uint64_t channel_value_satoshis, uint64_t push_msat, uint64_t user_id, struct LDKUserConfig override_config);
4970 * Gets the list of open channels, in random order. See ChannelDetail field documentation for
4973 MUST_USE_RES LDKCVec_ChannelDetailsZ ChannelManager_list_channels(const struct LDKChannelManager *NONNULL_PTR this_arg);
4976 * Gets the list of usable channels, in random order. Useful as an argument to
4977 * get_route to ensure non-announced channels are used.
4979 * These are guaranteed to have their is_live value set to true, see the documentation for
4980 * ChannelDetails::is_live for more info on exactly what the criteria are.
4982 MUST_USE_RES LDKCVec_ChannelDetailsZ ChannelManager_list_usable_channels(const struct LDKChannelManager *NONNULL_PTR this_arg);
4985 * Begins the process of closing a channel. After this call (plus some timeout), no new HTLCs
4986 * will be accepted on the given channel, and after additional timeout/the closing of all
4987 * pending HTLCs, the channel will be closed on chain.
4989 * May generate a SendShutdown message event on success, which should be relayed.
4991 MUST_USE_RES LDKCResult_NoneAPIErrorZ ChannelManager_close_channel(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*channel_id)[32]);
4994 * Force closes a channel, immediately broadcasting the latest local commitment transaction to
4995 * the chain and rejecting new HTLCs on the given channel.
4997 void ChannelManager_force_close_channel(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*channel_id)[32]);
5000 * Force close all channels, immediately broadcasting the latest local commitment transaction
5001 * for each to the chain and rejecting new HTLCs on each.
5003 void ChannelManager_force_close_all_channels(const struct LDKChannelManager *NONNULL_PTR this_arg);
5006 * Sends a payment along a given route.
5008 * Value parameters are provided via the last hop in route, see documentation for RouteHop
5009 * fields for more info.
5011 * Note that if the payment_hash already exists elsewhere (eg you're sending a duplicative
5012 * payment), we don't do anything to stop you! We always try to ensure that if the provided
5013 * next hop knows the preimage to payment_hash they can claim an additional amount as
5014 * specified in the last hop in the route! Thus, you should probably do your own
5015 * payment_preimage tracking (which you should already be doing as they represent \"proof of
5016 * payment\") and prevent double-sends yourself.
5018 * May generate SendHTLCs message(s) event on success, which should be relayed.
5020 * Each path may have a different return value, and PaymentSendValue may return a Vec with
5021 * each entry matching the corresponding-index entry in the route paths, see
5022 * PaymentSendFailure for more info.
5024 * In general, a path may raise:
5025 * * APIError::RouteError when an invalid route or forwarding parameter (cltv_delta, fee,
5026 * node public key) is specified.
5027 * * APIError::ChannelUnavailable if the next-hop channel is not available for updates
5028 * (including due to previous monitor update failure or new permanent monitor update
5030 * * APIError::MonitorUpdateFailed if a new monitor update failure prevented sending the
5033 * Note that depending on the type of the PaymentSendFailure the HTLC may have been
5034 * irrevocably committed to on our end. In such a case, do NOT retry the payment with a
5035 * different route unless you intend to pay twice!
5037 * payment_secret is unrelated to payment_hash (or PaymentPreimage) and exists to authenticate
5038 * the sender to the recipient and prevent payment-probing (deanonymization) attacks. For
5039 * newer nodes, it will be provided to you in the invoice. If you do not have one, the Route
5040 * must not contain multiple paths as multi-path payments require a recipient-provided
5042 * If a payment_secret *is* provided, we assume that the invoice had the payment_secret feature
5043 * bit set (either as required or as available). If multiple paths are present in the Route,
5044 * we assume the invoice had the basic_mpp feature set.
5046 MUST_USE_RES LDKCResult_NonePaymentSendFailureZ ChannelManager_send_payment(const struct LDKChannelManager *NONNULL_PTR this_arg, const struct LDKRoute *NONNULL_PTR route, struct LDKThirtyTwoBytes payment_hash, struct LDKThirtyTwoBytes payment_secret);
5049 * Call this upon creation of a funding transaction for the given channel.
5051 * Note that ALL inputs in the transaction pointed to by funding_txo MUST spend SegWit outputs
5052 * or your counterparty can steal your funds!
5054 * Panics if a funding transaction has already been provided for this channel.
5056 * May panic if the funding_txo is duplicative with some other channel (note that this should
5057 * be trivially prevented by using unique funding transaction keys per-channel).
5059 void ChannelManager_funding_transaction_generated(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*temporary_channel_id)[32], struct LDKOutPoint funding_txo);
5062 * Generates a signed node_announcement from the given arguments and creates a
5063 * BroadcastNodeAnnouncement event. Note that such messages will be ignored unless peers have
5064 * seen a channel_announcement from us (ie unless we have public channels open).
5066 * RGB is a node \"color\" and alias is a printable human-readable string to describe this node
5067 * to humans. They carry no in-protocol meaning.
5069 * addresses represent the set (possibly empty) of socket addresses on which this node accepts
5070 * incoming connections. These will be broadcast to the network, publicly tying these
5071 * addresses together. If you wish to preserve user privacy, addresses should likely contain
5072 * only Tor Onion addresses.
5074 * Panics if addresses is absurdly large (more than 500).
5076 void ChannelManager_broadcast_node_announcement(const struct LDKChannelManager *NONNULL_PTR this_arg, struct LDKThreeBytes rgb, struct LDKThirtyTwoBytes alias, LDKCVec_NetAddressZ addresses);
5079 * Processes HTLCs which are pending waiting on random forward delay.
5081 * Should only really ever be called in response to a PendingHTLCsForwardable event.
5082 * Will likely generate further events.
5084 void ChannelManager_process_pending_htlc_forwards(const struct LDKChannelManager *NONNULL_PTR this_arg);
5087 * If a peer is disconnected we mark any channels with that peer as 'disabled'.
5088 * After some time, if channels are still disabled we need to broadcast a ChannelUpdate
5089 * to inform the network about the uselessness of these channels.
5091 * This method handles all the details, and must be called roughly once per minute.
5093 void ChannelManager_timer_chan_freshness_every_min(const struct LDKChannelManager *NONNULL_PTR this_arg);
5096 * Indicates that the preimage for payment_hash is unknown or the received amount is incorrect
5097 * after a PaymentReceived event, failing the HTLC back to its origin and freeing resources
5098 * along the path (including in our own channel on which we received it).
5099 * Returns false if no payment was found to fail backwards, true if the process of failing the
5100 * HTLC backwards has been started.
5102 MUST_USE_RES bool ChannelManager_fail_htlc_backwards(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*payment_hash)[32], struct LDKThirtyTwoBytes payment_secret);
5105 * Provides a payment preimage in response to a PaymentReceived event, returning true and
5106 * generating message events for the net layer to claim the payment, if possible. Thus, you
5107 * should probably kick the net layer to go send messages if this returns true!
5109 * You must specify the expected amounts for this HTLC, and we will only claim HTLCs
5110 * available within a few percent of the expected amount. This is critical for several
5111 * reasons : a) it avoids providing senders with `proof-of-payment` (in the form of the
5112 * payment_preimage without having provided the full value and b) it avoids certain
5113 * privacy-breaking recipient-probing attacks which may reveal payment activity to
5114 * motivated attackers.
5116 * Note that the privacy concerns in (b) are not relevant in payments with a payment_secret
5117 * set. Thus, for such payments we will claim any payments which do not under-pay.
5119 * May panic if called except in response to a PaymentReceived event.
5121 MUST_USE_RES bool ChannelManager_claim_funds(const struct LDKChannelManager *NONNULL_PTR this_arg, struct LDKThirtyTwoBytes payment_preimage, struct LDKThirtyTwoBytes payment_secret, uint64_t expected_amount);
5124 * Gets the node_id held by this ChannelManager
5126 MUST_USE_RES struct LDKPublicKey ChannelManager_get_our_node_id(const struct LDKChannelManager *NONNULL_PTR this_arg);
5129 * Restores a single, given channel to normal operation after a
5130 * ChannelMonitorUpdateErr::TemporaryFailure was returned from a channel monitor update
5133 * All ChannelMonitor updates up to and including highest_applied_update_id must have been
5134 * fully committed in every copy of the given channels' ChannelMonitors.
5136 * Note that there is no effect to calling with a highest_applied_update_id other than the
5137 * current latest ChannelMonitorUpdate and one call to this function after multiple
5138 * ChannelMonitorUpdateErr::TemporaryFailures is fine. The highest_applied_update_id field
5139 * exists largely only to prevent races between this and concurrent update_monitor calls.
5141 * Thus, the anticipated use is, at a high level:
5142 * 1) You register a chain::Watch with this ChannelManager,
5143 * 2) it stores each update to disk, and begins updating any remote (eg watchtower) copies of
5144 * said ChannelMonitors as it can, returning ChannelMonitorUpdateErr::TemporaryFailures
5145 * any time it cannot do so instantly,
5146 * 3) update(s) are applied to each remote copy of a ChannelMonitor,
5147 * 4) once all remote copies are updated, you call this function with the update_id that
5148 * completed, and once it is the latest the Channel will be re-enabled.
5150 void ChannelManager_channel_monitor_updated(const struct LDKChannelManager *NONNULL_PTR this_arg, const struct LDKOutPoint *NONNULL_PTR funding_txo, uint64_t highest_applied_update_id);
5152 struct LDKMessageSendEventsProvider ChannelManager_as_MessageSendEventsProvider(const struct LDKChannelManager *NONNULL_PTR this_arg);
5154 struct LDKEventsProvider ChannelManager_as_EventsProvider(const struct LDKChannelManager *NONNULL_PTR this_arg);
5157 * Updates channel state based on transactions seen in a connected block.
5159 void ChannelManager_block_connected(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*header)[80], LDKCVec_C2Tuple_usizeTransactionZZ txdata, uint32_t height);
5162 * Updates channel state based on a disconnected block.
5164 * If necessary, the channel may be force-closed without letting the counterparty participate
5167 void ChannelManager_block_disconnected(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*header)[80]);
5169 struct LDKChannelMessageHandler ChannelManager_as_ChannelMessageHandler(const struct LDKChannelManager *NONNULL_PTR this_arg);
5171 LDKCVec_u8Z ChannelManager_write(const struct LDKChannelManager *NONNULL_PTR obj);
5173 void ChannelManagerReadArgs_free(struct LDKChannelManagerReadArgs this_ptr);
5176 * The keys provider which will give us relevant keys. Some keys will be loaded during
5177 * deserialization and KeysInterface::read_chan_signer will be used to read per-Channel
5180 const struct LDKKeysInterface *ChannelManagerReadArgs_get_keys_manager(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
5183 * The keys provider which will give us relevant keys. Some keys will be loaded during
5184 * deserialization and KeysInterface::read_chan_signer will be used to read per-Channel
5187 void ChannelManagerReadArgs_set_keys_manager(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKKeysInterface val);
5190 * The fee_estimator for use in the ChannelManager in the future.
5192 * No calls to the FeeEstimator will be made during deserialization.
5194 const struct LDKFeeEstimator *ChannelManagerReadArgs_get_fee_estimator(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
5197 * The fee_estimator for use in the ChannelManager in the future.
5199 * No calls to the FeeEstimator will be made during deserialization.
5201 void ChannelManagerReadArgs_set_fee_estimator(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKFeeEstimator val);
5204 * The chain::Watch for use in the ChannelManager in the future.
5206 * No calls to the chain::Watch will be made during deserialization. It is assumed that
5207 * you have deserialized ChannelMonitors separately and will add them to your
5208 * chain::Watch after deserializing this ChannelManager.
5210 const struct LDKWatch *ChannelManagerReadArgs_get_chain_monitor(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
5213 * The chain::Watch for use in the ChannelManager in the future.
5215 * No calls to the chain::Watch will be made during deserialization. It is assumed that
5216 * you have deserialized ChannelMonitors separately and will add them to your
5217 * chain::Watch after deserializing this ChannelManager.
5219 void ChannelManagerReadArgs_set_chain_monitor(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKWatch val);
5222 * The BroadcasterInterface which will be used in the ChannelManager in the future and may be
5223 * used to broadcast the latest local commitment transactions of channels which must be
5224 * force-closed during deserialization.
5226 const struct LDKBroadcasterInterface *ChannelManagerReadArgs_get_tx_broadcaster(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
5229 * The BroadcasterInterface which will be used in the ChannelManager in the future and may be
5230 * used to broadcast the latest local commitment transactions of channels which must be
5231 * force-closed during deserialization.
5233 void ChannelManagerReadArgs_set_tx_broadcaster(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKBroadcasterInterface val);
5236 * The Logger for use in the ChannelManager and which may be used to log information during
5239 const struct LDKLogger *ChannelManagerReadArgs_get_logger(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
5242 * The Logger for use in the ChannelManager and which may be used to log information during
5245 void ChannelManagerReadArgs_set_logger(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKLogger val);
5248 * Default settings used for new channels. Any existing channels will continue to use the
5249 * runtime settings which were stored when the ChannelManager was serialized.
5251 struct LDKUserConfig ChannelManagerReadArgs_get_default_config(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
5254 * Default settings used for new channels. Any existing channels will continue to use the
5255 * runtime settings which were stored when the ChannelManager was serialized.
5257 void ChannelManagerReadArgs_set_default_config(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKUserConfig val);
5260 * Simple utility function to create a ChannelManagerReadArgs which creates the monitor
5261 * HashMap for you. This is primarily useful for C bindings where it is not practical to
5262 * populate a HashMap directly from C.
5264 MUST_USE_RES struct LDKChannelManagerReadArgs ChannelManagerReadArgs_new(struct LDKKeysInterface keys_manager, struct LDKFeeEstimator fee_estimator, struct LDKWatch chain_monitor, struct LDKBroadcasterInterface tx_broadcaster, struct LDKLogger logger, struct LDKUserConfig default_config, LDKCVec_ChannelMonitorZ channel_monitors);
5266 LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ C2Tuple_BlockHashChannelManagerZ_read(struct LDKu8slice ser, struct LDKChannelManagerReadArgs arg);
5268 void DecodeError_free(struct LDKDecodeError this_ptr);
5270 void Init_free(struct LDKInit this_ptr);
5272 struct LDKInit Init_clone(const struct LDKInit *NONNULL_PTR orig);
5274 void ErrorMessage_free(struct LDKErrorMessage this_ptr);
5276 struct LDKErrorMessage ErrorMessage_clone(const struct LDKErrorMessage *NONNULL_PTR orig);
5279 * The channel ID involved in the error
5281 const uint8_t (*ErrorMessage_get_channel_id(const struct LDKErrorMessage *NONNULL_PTR this_ptr))[32];
5284 * The channel ID involved in the error
5286 void ErrorMessage_set_channel_id(struct LDKErrorMessage *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5289 * A possibly human-readable error description.
5290 * The string should be sanitized before it is used (e.g. emitted to logs
5291 * or printed to stdout). Otherwise, a well crafted error message may trigger a security
5292 * vulnerability in the terminal emulator or the logging subsystem.
5294 struct LDKStr ErrorMessage_get_data(const struct LDKErrorMessage *NONNULL_PTR this_ptr);
5297 * A possibly human-readable error description.
5298 * The string should be sanitized before it is used (e.g. emitted to logs
5299 * or printed to stdout). Otherwise, a well crafted error message may trigger a security
5300 * vulnerability in the terminal emulator or the logging subsystem.
5302 void ErrorMessage_set_data(struct LDKErrorMessage *NONNULL_PTR this_ptr, LDKCVec_u8Z val);
5304 MUST_USE_RES struct LDKErrorMessage ErrorMessage_new(struct LDKThirtyTwoBytes channel_id_arg, LDKCVec_u8Z data_arg);
5306 void Ping_free(struct LDKPing this_ptr);
5308 struct LDKPing Ping_clone(const struct LDKPing *NONNULL_PTR orig);
5311 * The desired response length
5313 uint16_t Ping_get_ponglen(const struct LDKPing *NONNULL_PTR this_ptr);
5316 * The desired response length
5318 void Ping_set_ponglen(struct LDKPing *NONNULL_PTR this_ptr, uint16_t val);
5321 * The ping packet size.
5322 * This field is not sent on the wire. byteslen zeros are sent.
5324 uint16_t Ping_get_byteslen(const struct LDKPing *NONNULL_PTR this_ptr);
5327 * The ping packet size.
5328 * This field is not sent on the wire. byteslen zeros are sent.
5330 void Ping_set_byteslen(struct LDKPing *NONNULL_PTR this_ptr, uint16_t val);
5332 MUST_USE_RES struct LDKPing Ping_new(uint16_t ponglen_arg, uint16_t byteslen_arg);
5334 void Pong_free(struct LDKPong this_ptr);
5336 struct LDKPong Pong_clone(const struct LDKPong *NONNULL_PTR orig);
5339 * The pong packet size.
5340 * This field is not sent on the wire. byteslen zeros are sent.
5342 uint16_t Pong_get_byteslen(const struct LDKPong *NONNULL_PTR this_ptr);
5345 * The pong packet size.
5346 * This field is not sent on the wire. byteslen zeros are sent.
5348 void Pong_set_byteslen(struct LDKPong *NONNULL_PTR this_ptr, uint16_t val);
5350 MUST_USE_RES struct LDKPong Pong_new(uint16_t byteslen_arg);
5352 void OpenChannel_free(struct LDKOpenChannel this_ptr);
5354 struct LDKOpenChannel OpenChannel_clone(const struct LDKOpenChannel *NONNULL_PTR orig);
5357 * The genesis hash of the blockchain where the channel is to be opened
5359 const uint8_t (*OpenChannel_get_chain_hash(const struct LDKOpenChannel *NONNULL_PTR this_ptr))[32];
5362 * The genesis hash of the blockchain where the channel is to be opened
5364 void OpenChannel_set_chain_hash(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5367 * A temporary channel ID, until the funding outpoint is announced
5369 const uint8_t (*OpenChannel_get_temporary_channel_id(const struct LDKOpenChannel *NONNULL_PTR this_ptr))[32];
5372 * A temporary channel ID, until the funding outpoint is announced
5374 void OpenChannel_set_temporary_channel_id(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5379 uint64_t OpenChannel_get_funding_satoshis(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5384 void OpenChannel_set_funding_satoshis(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
5387 * The amount to push to the counterparty as part of the open, in milli-satoshi
5389 uint64_t OpenChannel_get_push_msat(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5392 * The amount to push to the counterparty as part of the open, in milli-satoshi
5394 void OpenChannel_set_push_msat(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
5397 * The threshold below which outputs on transactions broadcast by sender will be omitted
5399 uint64_t OpenChannel_get_dust_limit_satoshis(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5402 * The threshold below which outputs on transactions broadcast by sender will be omitted
5404 void OpenChannel_set_dust_limit_satoshis(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
5407 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
5409 uint64_t OpenChannel_get_max_htlc_value_in_flight_msat(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5412 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
5414 void OpenChannel_set_max_htlc_value_in_flight_msat(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
5417 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
5419 uint64_t OpenChannel_get_channel_reserve_satoshis(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5422 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
5424 void OpenChannel_set_channel_reserve_satoshis(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
5427 * The minimum HTLC size incoming to sender, in milli-satoshi
5429 uint64_t OpenChannel_get_htlc_minimum_msat(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5432 * The minimum HTLC size incoming to sender, in milli-satoshi
5434 void OpenChannel_set_htlc_minimum_msat(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
5437 * The feerate per 1000-weight of sender generated transactions, until updated by update_fee
5439 uint32_t OpenChannel_get_feerate_per_kw(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5442 * The feerate per 1000-weight of sender generated transactions, until updated by update_fee
5444 void OpenChannel_set_feerate_per_kw(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint32_t val);
5447 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
5449 uint16_t OpenChannel_get_to_self_delay(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5452 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
5454 void OpenChannel_set_to_self_delay(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint16_t val);
5457 * The maximum number of inbound HTLCs towards sender
5459 uint16_t OpenChannel_get_max_accepted_htlcs(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5462 * The maximum number of inbound HTLCs towards sender
5464 void OpenChannel_set_max_accepted_htlcs(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint16_t val);
5467 * The sender's key controlling the funding transaction
5469 struct LDKPublicKey OpenChannel_get_funding_pubkey(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5472 * The sender's key controlling the funding transaction
5474 void OpenChannel_set_funding_pubkey(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5477 * Used to derive a revocation key for transactions broadcast by counterparty
5479 struct LDKPublicKey OpenChannel_get_revocation_basepoint(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5482 * Used to derive a revocation key for transactions broadcast by counterparty
5484 void OpenChannel_set_revocation_basepoint(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5487 * A payment key to sender for transactions broadcast by counterparty
5489 struct LDKPublicKey OpenChannel_get_payment_point(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5492 * A payment key to sender for transactions broadcast by counterparty
5494 void OpenChannel_set_payment_point(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5497 * Used to derive a payment key to sender for transactions broadcast by sender
5499 struct LDKPublicKey OpenChannel_get_delayed_payment_basepoint(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5502 * Used to derive a payment key to sender for transactions broadcast by sender
5504 void OpenChannel_set_delayed_payment_basepoint(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5507 * Used to derive an HTLC payment key to sender
5509 struct LDKPublicKey OpenChannel_get_htlc_basepoint(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5512 * Used to derive an HTLC payment key to sender
5514 void OpenChannel_set_htlc_basepoint(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5517 * The first to-be-broadcast-by-sender transaction's per commitment point
5519 struct LDKPublicKey OpenChannel_get_first_per_commitment_point(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5522 * The first to-be-broadcast-by-sender transaction's per commitment point
5524 void OpenChannel_set_first_per_commitment_point(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5529 uint8_t OpenChannel_get_channel_flags(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
5534 void OpenChannel_set_channel_flags(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint8_t val);
5536 void AcceptChannel_free(struct LDKAcceptChannel this_ptr);
5538 struct LDKAcceptChannel AcceptChannel_clone(const struct LDKAcceptChannel *NONNULL_PTR orig);
5541 * A temporary channel ID, until the funding outpoint is announced
5543 const uint8_t (*AcceptChannel_get_temporary_channel_id(const struct LDKAcceptChannel *NONNULL_PTR this_ptr))[32];
5546 * A temporary channel ID, until the funding outpoint is announced
5548 void AcceptChannel_set_temporary_channel_id(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5551 * The threshold below which outputs on transactions broadcast by sender will be omitted
5553 uint64_t AcceptChannel_get_dust_limit_satoshis(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5556 * The threshold below which outputs on transactions broadcast by sender will be omitted
5558 void AcceptChannel_set_dust_limit_satoshis(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
5561 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
5563 uint64_t AcceptChannel_get_max_htlc_value_in_flight_msat(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5566 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
5568 void AcceptChannel_set_max_htlc_value_in_flight_msat(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
5571 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
5573 uint64_t AcceptChannel_get_channel_reserve_satoshis(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5576 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
5578 void AcceptChannel_set_channel_reserve_satoshis(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
5581 * The minimum HTLC size incoming to sender, in milli-satoshi
5583 uint64_t AcceptChannel_get_htlc_minimum_msat(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5586 * The minimum HTLC size incoming to sender, in milli-satoshi
5588 void AcceptChannel_set_htlc_minimum_msat(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
5591 * Minimum depth of the funding transaction before the channel is considered open
5593 uint32_t AcceptChannel_get_minimum_depth(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5596 * Minimum depth of the funding transaction before the channel is considered open
5598 void AcceptChannel_set_minimum_depth(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint32_t val);
5601 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
5603 uint16_t AcceptChannel_get_to_self_delay(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5606 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
5608 void AcceptChannel_set_to_self_delay(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint16_t val);
5611 * The maximum number of inbound HTLCs towards sender
5613 uint16_t AcceptChannel_get_max_accepted_htlcs(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5616 * The maximum number of inbound HTLCs towards sender
5618 void AcceptChannel_set_max_accepted_htlcs(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint16_t val);
5621 * The sender's key controlling the funding transaction
5623 struct LDKPublicKey AcceptChannel_get_funding_pubkey(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5626 * The sender's key controlling the funding transaction
5628 void AcceptChannel_set_funding_pubkey(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5631 * Used to derive a revocation key for transactions broadcast by counterparty
5633 struct LDKPublicKey AcceptChannel_get_revocation_basepoint(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5636 * Used to derive a revocation key for transactions broadcast by counterparty
5638 void AcceptChannel_set_revocation_basepoint(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5641 * A payment key to sender for transactions broadcast by counterparty
5643 struct LDKPublicKey AcceptChannel_get_payment_point(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5646 * A payment key to sender for transactions broadcast by counterparty
5648 void AcceptChannel_set_payment_point(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5651 * Used to derive a payment key to sender for transactions broadcast by sender
5653 struct LDKPublicKey AcceptChannel_get_delayed_payment_basepoint(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5656 * Used to derive a payment key to sender for transactions broadcast by sender
5658 void AcceptChannel_set_delayed_payment_basepoint(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5661 * Used to derive an HTLC payment key to sender for transactions broadcast by counterparty
5663 struct LDKPublicKey AcceptChannel_get_htlc_basepoint(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5666 * Used to derive an HTLC payment key to sender for transactions broadcast by counterparty
5668 void AcceptChannel_set_htlc_basepoint(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5671 * The first to-be-broadcast-by-sender transaction's per commitment point
5673 struct LDKPublicKey AcceptChannel_get_first_per_commitment_point(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
5676 * The first to-be-broadcast-by-sender transaction's per commitment point
5678 void AcceptChannel_set_first_per_commitment_point(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5680 void FundingCreated_free(struct LDKFundingCreated this_ptr);
5682 struct LDKFundingCreated FundingCreated_clone(const struct LDKFundingCreated *NONNULL_PTR orig);
5685 * A temporary channel ID, until the funding is established
5687 const uint8_t (*FundingCreated_get_temporary_channel_id(const struct LDKFundingCreated *NONNULL_PTR this_ptr))[32];
5690 * A temporary channel ID, until the funding is established
5692 void FundingCreated_set_temporary_channel_id(struct LDKFundingCreated *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5695 * The funding transaction ID
5697 const uint8_t (*FundingCreated_get_funding_txid(const struct LDKFundingCreated *NONNULL_PTR this_ptr))[32];
5700 * The funding transaction ID
5702 void FundingCreated_set_funding_txid(struct LDKFundingCreated *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5705 * The specific output index funding this channel
5707 uint16_t FundingCreated_get_funding_output_index(const struct LDKFundingCreated *NONNULL_PTR this_ptr);
5710 * The specific output index funding this channel
5712 void FundingCreated_set_funding_output_index(struct LDKFundingCreated *NONNULL_PTR this_ptr, uint16_t val);
5715 * The signature of the channel initiator (funder) on the funding transaction
5717 struct LDKSignature FundingCreated_get_signature(const struct LDKFundingCreated *NONNULL_PTR this_ptr);
5720 * The signature of the channel initiator (funder) on the funding transaction
5722 void FundingCreated_set_signature(struct LDKFundingCreated *NONNULL_PTR this_ptr, struct LDKSignature val);
5724 MUST_USE_RES struct LDKFundingCreated FundingCreated_new(struct LDKThirtyTwoBytes temporary_channel_id_arg, struct LDKThirtyTwoBytes funding_txid_arg, uint16_t funding_output_index_arg, struct LDKSignature signature_arg);
5726 void FundingSigned_free(struct LDKFundingSigned this_ptr);
5728 struct LDKFundingSigned FundingSigned_clone(const struct LDKFundingSigned *NONNULL_PTR orig);
5733 const uint8_t (*FundingSigned_get_channel_id(const struct LDKFundingSigned *NONNULL_PTR this_ptr))[32];
5738 void FundingSigned_set_channel_id(struct LDKFundingSigned *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5741 * The signature of the channel acceptor (fundee) on the funding transaction
5743 struct LDKSignature FundingSigned_get_signature(const struct LDKFundingSigned *NONNULL_PTR this_ptr);
5746 * The signature of the channel acceptor (fundee) on the funding transaction
5748 void FundingSigned_set_signature(struct LDKFundingSigned *NONNULL_PTR this_ptr, struct LDKSignature val);
5750 MUST_USE_RES struct LDKFundingSigned FundingSigned_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKSignature signature_arg);
5752 void FundingLocked_free(struct LDKFundingLocked this_ptr);
5754 struct LDKFundingLocked FundingLocked_clone(const struct LDKFundingLocked *NONNULL_PTR orig);
5759 const uint8_t (*FundingLocked_get_channel_id(const struct LDKFundingLocked *NONNULL_PTR this_ptr))[32];
5764 void FundingLocked_set_channel_id(struct LDKFundingLocked *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5767 * The per-commitment point of the second commitment transaction
5769 struct LDKPublicKey FundingLocked_get_next_per_commitment_point(const struct LDKFundingLocked *NONNULL_PTR this_ptr);
5772 * The per-commitment point of the second commitment transaction
5774 void FundingLocked_set_next_per_commitment_point(struct LDKFundingLocked *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5776 MUST_USE_RES struct LDKFundingLocked FundingLocked_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKPublicKey next_per_commitment_point_arg);
5778 void Shutdown_free(struct LDKShutdown this_ptr);
5780 struct LDKShutdown Shutdown_clone(const struct LDKShutdown *NONNULL_PTR orig);
5785 const uint8_t (*Shutdown_get_channel_id(const struct LDKShutdown *NONNULL_PTR this_ptr))[32];
5790 void Shutdown_set_channel_id(struct LDKShutdown *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5793 * The destination of this peer's funds on closing.
5794 * Must be in one of these forms: p2pkh, p2sh, p2wpkh, p2wsh.
5796 struct LDKu8slice Shutdown_get_scriptpubkey(const struct LDKShutdown *NONNULL_PTR this_ptr);
5799 * The destination of this peer's funds on closing.
5800 * Must be in one of these forms: p2pkh, p2sh, p2wpkh, p2wsh.
5802 void Shutdown_set_scriptpubkey(struct LDKShutdown *NONNULL_PTR this_ptr, LDKCVec_u8Z val);
5804 MUST_USE_RES struct LDKShutdown Shutdown_new(struct LDKThirtyTwoBytes channel_id_arg, LDKCVec_u8Z scriptpubkey_arg);
5806 void ClosingSigned_free(struct LDKClosingSigned this_ptr);
5808 struct LDKClosingSigned ClosingSigned_clone(const struct LDKClosingSigned *NONNULL_PTR orig);
5813 const uint8_t (*ClosingSigned_get_channel_id(const struct LDKClosingSigned *NONNULL_PTR this_ptr))[32];
5818 void ClosingSigned_set_channel_id(struct LDKClosingSigned *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5821 * The proposed total fee for the closing transaction
5823 uint64_t ClosingSigned_get_fee_satoshis(const struct LDKClosingSigned *NONNULL_PTR this_ptr);
5826 * The proposed total fee for the closing transaction
5828 void ClosingSigned_set_fee_satoshis(struct LDKClosingSigned *NONNULL_PTR this_ptr, uint64_t val);
5831 * A signature on the closing transaction
5833 struct LDKSignature ClosingSigned_get_signature(const struct LDKClosingSigned *NONNULL_PTR this_ptr);
5836 * A signature on the closing transaction
5838 void ClosingSigned_set_signature(struct LDKClosingSigned *NONNULL_PTR this_ptr, struct LDKSignature val);
5840 MUST_USE_RES struct LDKClosingSigned ClosingSigned_new(struct LDKThirtyTwoBytes channel_id_arg, uint64_t fee_satoshis_arg, struct LDKSignature signature_arg);
5842 void UpdateAddHTLC_free(struct LDKUpdateAddHTLC this_ptr);
5844 struct LDKUpdateAddHTLC UpdateAddHTLC_clone(const struct LDKUpdateAddHTLC *NONNULL_PTR orig);
5849 const uint8_t (*UpdateAddHTLC_get_channel_id(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr))[32];
5854 void UpdateAddHTLC_set_channel_id(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5859 uint64_t UpdateAddHTLC_get_htlc_id(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr);
5864 void UpdateAddHTLC_set_htlc_id(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, uint64_t val);
5867 * The HTLC value in milli-satoshi
5869 uint64_t UpdateAddHTLC_get_amount_msat(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr);
5872 * The HTLC value in milli-satoshi
5874 void UpdateAddHTLC_set_amount_msat(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, uint64_t val);
5877 * The payment hash, the pre-image of which controls HTLC redemption
5879 const uint8_t (*UpdateAddHTLC_get_payment_hash(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr))[32];
5882 * The payment hash, the pre-image of which controls HTLC redemption
5884 void UpdateAddHTLC_set_payment_hash(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5887 * The expiry height of the HTLC
5889 uint32_t UpdateAddHTLC_get_cltv_expiry(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr);
5892 * The expiry height of the HTLC
5894 void UpdateAddHTLC_set_cltv_expiry(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, uint32_t val);
5896 void UpdateFulfillHTLC_free(struct LDKUpdateFulfillHTLC this_ptr);
5898 struct LDKUpdateFulfillHTLC UpdateFulfillHTLC_clone(const struct LDKUpdateFulfillHTLC *NONNULL_PTR orig);
5903 const uint8_t (*UpdateFulfillHTLC_get_channel_id(const struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr))[32];
5908 void UpdateFulfillHTLC_set_channel_id(struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5913 uint64_t UpdateFulfillHTLC_get_htlc_id(const struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr);
5918 void UpdateFulfillHTLC_set_htlc_id(struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr, uint64_t val);
5921 * The pre-image of the payment hash, allowing HTLC redemption
5923 const uint8_t (*UpdateFulfillHTLC_get_payment_preimage(const struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr))[32];
5926 * The pre-image of the payment hash, allowing HTLC redemption
5928 void UpdateFulfillHTLC_set_payment_preimage(struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5930 MUST_USE_RES struct LDKUpdateFulfillHTLC UpdateFulfillHTLC_new(struct LDKThirtyTwoBytes channel_id_arg, uint64_t htlc_id_arg, struct LDKThirtyTwoBytes payment_preimage_arg);
5932 void UpdateFailHTLC_free(struct LDKUpdateFailHTLC this_ptr);
5934 struct LDKUpdateFailHTLC UpdateFailHTLC_clone(const struct LDKUpdateFailHTLC *NONNULL_PTR orig);
5939 const uint8_t (*UpdateFailHTLC_get_channel_id(const struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr))[32];
5944 void UpdateFailHTLC_set_channel_id(struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5949 uint64_t UpdateFailHTLC_get_htlc_id(const struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr);
5954 void UpdateFailHTLC_set_htlc_id(struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr, uint64_t val);
5956 void UpdateFailMalformedHTLC_free(struct LDKUpdateFailMalformedHTLC this_ptr);
5958 struct LDKUpdateFailMalformedHTLC UpdateFailMalformedHTLC_clone(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR orig);
5963 const uint8_t (*UpdateFailMalformedHTLC_get_channel_id(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr))[32];
5968 void UpdateFailMalformedHTLC_set_channel_id(struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5973 uint64_t UpdateFailMalformedHTLC_get_htlc_id(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr);
5978 void UpdateFailMalformedHTLC_set_htlc_id(struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr, uint64_t val);
5983 uint16_t UpdateFailMalformedHTLC_get_failure_code(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr);
5988 void UpdateFailMalformedHTLC_set_failure_code(struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr, uint16_t val);
5990 void CommitmentSigned_free(struct LDKCommitmentSigned this_ptr);
5992 struct LDKCommitmentSigned CommitmentSigned_clone(const struct LDKCommitmentSigned *NONNULL_PTR orig);
5997 const uint8_t (*CommitmentSigned_get_channel_id(const struct LDKCommitmentSigned *NONNULL_PTR this_ptr))[32];
6002 void CommitmentSigned_set_channel_id(struct LDKCommitmentSigned *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6005 * A signature on the commitment transaction
6007 struct LDKSignature CommitmentSigned_get_signature(const struct LDKCommitmentSigned *NONNULL_PTR this_ptr);
6010 * A signature on the commitment transaction
6012 void CommitmentSigned_set_signature(struct LDKCommitmentSigned *NONNULL_PTR this_ptr, struct LDKSignature val);
6015 * Signatures on the HTLC transactions
6017 void CommitmentSigned_set_htlc_signatures(struct LDKCommitmentSigned *NONNULL_PTR this_ptr, LDKCVec_SignatureZ val);
6019 MUST_USE_RES struct LDKCommitmentSigned CommitmentSigned_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKSignature signature_arg, LDKCVec_SignatureZ htlc_signatures_arg);
6021 void RevokeAndACK_free(struct LDKRevokeAndACK this_ptr);
6023 struct LDKRevokeAndACK RevokeAndACK_clone(const struct LDKRevokeAndACK *NONNULL_PTR orig);
6028 const uint8_t (*RevokeAndACK_get_channel_id(const struct LDKRevokeAndACK *NONNULL_PTR this_ptr))[32];
6033 void RevokeAndACK_set_channel_id(struct LDKRevokeAndACK *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6036 * The secret corresponding to the per-commitment point
6038 const uint8_t (*RevokeAndACK_get_per_commitment_secret(const struct LDKRevokeAndACK *NONNULL_PTR this_ptr))[32];
6041 * The secret corresponding to the per-commitment point
6043 void RevokeAndACK_set_per_commitment_secret(struct LDKRevokeAndACK *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6046 * The next sender-broadcast commitment transaction's per-commitment point
6048 struct LDKPublicKey RevokeAndACK_get_next_per_commitment_point(const struct LDKRevokeAndACK *NONNULL_PTR this_ptr);
6051 * The next sender-broadcast commitment transaction's per-commitment point
6053 void RevokeAndACK_set_next_per_commitment_point(struct LDKRevokeAndACK *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6055 MUST_USE_RES struct LDKRevokeAndACK RevokeAndACK_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKThirtyTwoBytes per_commitment_secret_arg, struct LDKPublicKey next_per_commitment_point_arg);
6057 void UpdateFee_free(struct LDKUpdateFee this_ptr);
6059 struct LDKUpdateFee UpdateFee_clone(const struct LDKUpdateFee *NONNULL_PTR orig);
6064 const uint8_t (*UpdateFee_get_channel_id(const struct LDKUpdateFee *NONNULL_PTR this_ptr))[32];
6069 void UpdateFee_set_channel_id(struct LDKUpdateFee *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6072 * Fee rate per 1000-weight of the transaction
6074 uint32_t UpdateFee_get_feerate_per_kw(const struct LDKUpdateFee *NONNULL_PTR this_ptr);
6077 * Fee rate per 1000-weight of the transaction
6079 void UpdateFee_set_feerate_per_kw(struct LDKUpdateFee *NONNULL_PTR this_ptr, uint32_t val);
6081 MUST_USE_RES struct LDKUpdateFee UpdateFee_new(struct LDKThirtyTwoBytes channel_id_arg, uint32_t feerate_per_kw_arg);
6083 void DataLossProtect_free(struct LDKDataLossProtect this_ptr);
6085 struct LDKDataLossProtect DataLossProtect_clone(const struct LDKDataLossProtect *NONNULL_PTR orig);
6088 * Proof that the sender knows the per-commitment secret of a specific commitment transaction
6089 * belonging to the recipient
6091 const uint8_t (*DataLossProtect_get_your_last_per_commitment_secret(const struct LDKDataLossProtect *NONNULL_PTR this_ptr))[32];
6094 * Proof that the sender knows the per-commitment secret of a specific commitment transaction
6095 * belonging to the recipient
6097 void DataLossProtect_set_your_last_per_commitment_secret(struct LDKDataLossProtect *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6100 * The sender's per-commitment point for their current commitment transaction
6102 struct LDKPublicKey DataLossProtect_get_my_current_per_commitment_point(const struct LDKDataLossProtect *NONNULL_PTR this_ptr);
6105 * The sender's per-commitment point for their current commitment transaction
6107 void DataLossProtect_set_my_current_per_commitment_point(struct LDKDataLossProtect *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6109 MUST_USE_RES struct LDKDataLossProtect DataLossProtect_new(struct LDKThirtyTwoBytes your_last_per_commitment_secret_arg, struct LDKPublicKey my_current_per_commitment_point_arg);
6111 void ChannelReestablish_free(struct LDKChannelReestablish this_ptr);
6113 struct LDKChannelReestablish ChannelReestablish_clone(const struct LDKChannelReestablish *NONNULL_PTR orig);
6118 const uint8_t (*ChannelReestablish_get_channel_id(const struct LDKChannelReestablish *NONNULL_PTR this_ptr))[32];
6123 void ChannelReestablish_set_channel_id(struct LDKChannelReestablish *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6126 * The next commitment number for the sender
6128 uint64_t ChannelReestablish_get_next_local_commitment_number(const struct LDKChannelReestablish *NONNULL_PTR this_ptr);
6131 * The next commitment number for the sender
6133 void ChannelReestablish_set_next_local_commitment_number(struct LDKChannelReestablish *NONNULL_PTR this_ptr, uint64_t val);
6136 * The next commitment number for the recipient
6138 uint64_t ChannelReestablish_get_next_remote_commitment_number(const struct LDKChannelReestablish *NONNULL_PTR this_ptr);
6141 * The next commitment number for the recipient
6143 void ChannelReestablish_set_next_remote_commitment_number(struct LDKChannelReestablish *NONNULL_PTR this_ptr, uint64_t val);
6145 void AnnouncementSignatures_free(struct LDKAnnouncementSignatures this_ptr);
6147 struct LDKAnnouncementSignatures AnnouncementSignatures_clone(const struct LDKAnnouncementSignatures *NONNULL_PTR orig);
6152 const uint8_t (*AnnouncementSignatures_get_channel_id(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr))[32];
6157 void AnnouncementSignatures_set_channel_id(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6160 * The short channel ID
6162 uint64_t AnnouncementSignatures_get_short_channel_id(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr);
6165 * The short channel ID
6167 void AnnouncementSignatures_set_short_channel_id(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, uint64_t val);
6170 * A signature by the node key
6172 struct LDKSignature AnnouncementSignatures_get_node_signature(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr);
6175 * A signature by the node key
6177 void AnnouncementSignatures_set_node_signature(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, struct LDKSignature val);
6180 * A signature by the funding key
6182 struct LDKSignature AnnouncementSignatures_get_bitcoin_signature(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr);
6185 * A signature by the funding key
6187 void AnnouncementSignatures_set_bitcoin_signature(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, struct LDKSignature val);
6189 MUST_USE_RES struct LDKAnnouncementSignatures AnnouncementSignatures_new(struct LDKThirtyTwoBytes channel_id_arg, uint64_t short_channel_id_arg, struct LDKSignature node_signature_arg, struct LDKSignature bitcoin_signature_arg);
6191 void NetAddress_free(struct LDKNetAddress this_ptr);
6193 struct LDKNetAddress NetAddress_clone(const struct LDKNetAddress *NONNULL_PTR orig);
6195 LDKCVec_u8Z NetAddress_write(const struct LDKNetAddress *NONNULL_PTR obj);
6197 LDKCResult_CResult_NetAddressu8ZDecodeErrorZ Result_read(struct LDKu8slice ser);
6199 void UnsignedNodeAnnouncement_free(struct LDKUnsignedNodeAnnouncement this_ptr);
6201 struct LDKUnsignedNodeAnnouncement UnsignedNodeAnnouncement_clone(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR orig);
6204 * The advertised features
6206 struct LDKNodeFeatures UnsignedNodeAnnouncement_get_features(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr);
6209 * The advertised features
6211 void UnsignedNodeAnnouncement_set_features(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKNodeFeatures val);
6214 * A strictly monotonic announcement counter, with gaps allowed
6216 uint32_t UnsignedNodeAnnouncement_get_timestamp(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr);
6219 * A strictly monotonic announcement counter, with gaps allowed
6221 void UnsignedNodeAnnouncement_set_timestamp(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, uint32_t val);
6224 * The node_id this announcement originated from (don't rebroadcast the node_announcement back
6227 struct LDKPublicKey UnsignedNodeAnnouncement_get_node_id(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr);
6230 * The node_id this announcement originated from (don't rebroadcast the node_announcement back
6233 void UnsignedNodeAnnouncement_set_node_id(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6236 * An RGB color for UI purposes
6238 const uint8_t (*UnsignedNodeAnnouncement_get_rgb(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr))[3];
6241 * An RGB color for UI purposes
6243 void UnsignedNodeAnnouncement_set_rgb(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKThreeBytes val);
6246 * An alias, for UI purposes. This should be sanitized before use. There is no guarantee
6249 const uint8_t (*UnsignedNodeAnnouncement_get_alias(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr))[32];
6252 * An alias, for UI purposes. This should be sanitized before use. There is no guarantee
6255 void UnsignedNodeAnnouncement_set_alias(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6258 * List of addresses on which this node is reachable
6260 void UnsignedNodeAnnouncement_set_addresses(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, LDKCVec_NetAddressZ val);
6262 void NodeAnnouncement_free(struct LDKNodeAnnouncement this_ptr);
6264 struct LDKNodeAnnouncement NodeAnnouncement_clone(const struct LDKNodeAnnouncement *NONNULL_PTR orig);
6267 * The signature by the node key
6269 struct LDKSignature NodeAnnouncement_get_signature(const struct LDKNodeAnnouncement *NONNULL_PTR this_ptr);
6272 * The signature by the node key
6274 void NodeAnnouncement_set_signature(struct LDKNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
6277 * The actual content of the announcement
6279 struct LDKUnsignedNodeAnnouncement NodeAnnouncement_get_contents(const struct LDKNodeAnnouncement *NONNULL_PTR this_ptr);
6282 * The actual content of the announcement
6284 void NodeAnnouncement_set_contents(struct LDKNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKUnsignedNodeAnnouncement val);
6286 MUST_USE_RES struct LDKNodeAnnouncement NodeAnnouncement_new(struct LDKSignature signature_arg, struct LDKUnsignedNodeAnnouncement contents_arg);
6288 void UnsignedChannelAnnouncement_free(struct LDKUnsignedChannelAnnouncement this_ptr);
6290 struct LDKUnsignedChannelAnnouncement UnsignedChannelAnnouncement_clone(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR orig);
6293 * The advertised channel features
6295 struct LDKChannelFeatures UnsignedChannelAnnouncement_get_features(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
6298 * The advertised channel features
6300 void UnsignedChannelAnnouncement_set_features(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKChannelFeatures val);
6303 * The genesis hash of the blockchain where the channel is to be opened
6305 const uint8_t (*UnsignedChannelAnnouncement_get_chain_hash(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr))[32];
6308 * The genesis hash of the blockchain where the channel is to be opened
6310 void UnsignedChannelAnnouncement_set_chain_hash(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6313 * The short channel ID
6315 uint64_t UnsignedChannelAnnouncement_get_short_channel_id(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
6318 * The short channel ID
6320 void UnsignedChannelAnnouncement_set_short_channel_id(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, uint64_t val);
6323 * One of the two node_ids which are endpoints of this channel
6325 struct LDKPublicKey UnsignedChannelAnnouncement_get_node_id_1(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
6328 * One of the two node_ids which are endpoints of this channel
6330 void UnsignedChannelAnnouncement_set_node_id_1(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6333 * The other of the two node_ids which are endpoints of this channel
6335 struct LDKPublicKey UnsignedChannelAnnouncement_get_node_id_2(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
6338 * The other of the two node_ids which are endpoints of this channel
6340 void UnsignedChannelAnnouncement_set_node_id_2(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6343 * The funding key for the first node
6345 struct LDKPublicKey UnsignedChannelAnnouncement_get_bitcoin_key_1(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
6348 * The funding key for the first node
6350 void UnsignedChannelAnnouncement_set_bitcoin_key_1(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6353 * The funding key for the second node
6355 struct LDKPublicKey UnsignedChannelAnnouncement_get_bitcoin_key_2(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
6358 * The funding key for the second node
6360 void UnsignedChannelAnnouncement_set_bitcoin_key_2(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6362 void ChannelAnnouncement_free(struct LDKChannelAnnouncement this_ptr);
6364 struct LDKChannelAnnouncement ChannelAnnouncement_clone(const struct LDKChannelAnnouncement *NONNULL_PTR orig);
6367 * Authentication of the announcement by the first public node
6369 struct LDKSignature ChannelAnnouncement_get_node_signature_1(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
6372 * Authentication of the announcement by the first public node
6374 void ChannelAnnouncement_set_node_signature_1(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
6377 * Authentication of the announcement by the second public node
6379 struct LDKSignature ChannelAnnouncement_get_node_signature_2(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
6382 * Authentication of the announcement by the second public node
6384 void ChannelAnnouncement_set_node_signature_2(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
6387 * Proof of funding UTXO ownership by the first public node
6389 struct LDKSignature ChannelAnnouncement_get_bitcoin_signature_1(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
6392 * Proof of funding UTXO ownership by the first public node
6394 void ChannelAnnouncement_set_bitcoin_signature_1(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
6397 * Proof of funding UTXO ownership by the second public node
6399 struct LDKSignature ChannelAnnouncement_get_bitcoin_signature_2(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
6402 * Proof of funding UTXO ownership by the second public node
6404 void ChannelAnnouncement_set_bitcoin_signature_2(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
6407 * The actual announcement
6409 struct LDKUnsignedChannelAnnouncement ChannelAnnouncement_get_contents(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
6412 * The actual announcement
6414 void ChannelAnnouncement_set_contents(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKUnsignedChannelAnnouncement val);
6416 MUST_USE_RES struct LDKChannelAnnouncement ChannelAnnouncement_new(struct LDKSignature node_signature_1_arg, struct LDKSignature node_signature_2_arg, struct LDKSignature bitcoin_signature_1_arg, struct LDKSignature bitcoin_signature_2_arg, struct LDKUnsignedChannelAnnouncement contents_arg);
6418 void UnsignedChannelUpdate_free(struct LDKUnsignedChannelUpdate this_ptr);
6420 struct LDKUnsignedChannelUpdate UnsignedChannelUpdate_clone(const struct LDKUnsignedChannelUpdate *NONNULL_PTR orig);
6423 * The genesis hash of the blockchain where the channel is to be opened
6425 const uint8_t (*UnsignedChannelUpdate_get_chain_hash(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr))[32];
6428 * The genesis hash of the blockchain where the channel is to be opened
6430 void UnsignedChannelUpdate_set_chain_hash(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6433 * The short channel ID
6435 uint64_t UnsignedChannelUpdate_get_short_channel_id(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6438 * The short channel ID
6440 void UnsignedChannelUpdate_set_short_channel_id(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint64_t val);
6443 * A strictly monotonic announcement counter, with gaps allowed, specific to this channel
6445 uint32_t UnsignedChannelUpdate_get_timestamp(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6448 * A strictly monotonic announcement counter, with gaps allowed, specific to this channel
6450 void UnsignedChannelUpdate_set_timestamp(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint32_t val);
6455 uint8_t UnsignedChannelUpdate_get_flags(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6460 void UnsignedChannelUpdate_set_flags(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint8_t val);
6463 * The number of blocks to subtract from incoming HTLC cltv_expiry values
6465 uint16_t UnsignedChannelUpdate_get_cltv_expiry_delta(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6468 * The number of blocks to subtract from incoming HTLC cltv_expiry values
6470 void UnsignedChannelUpdate_set_cltv_expiry_delta(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint16_t val);
6473 * The minimum HTLC size incoming to sender, in milli-satoshi
6475 uint64_t UnsignedChannelUpdate_get_htlc_minimum_msat(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6478 * The minimum HTLC size incoming to sender, in milli-satoshi
6480 void UnsignedChannelUpdate_set_htlc_minimum_msat(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint64_t val);
6483 * The base HTLC fee charged by sender, in milli-satoshi
6485 uint32_t UnsignedChannelUpdate_get_fee_base_msat(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6488 * The base HTLC fee charged by sender, in milli-satoshi
6490 void UnsignedChannelUpdate_set_fee_base_msat(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint32_t val);
6493 * The amount to fee multiplier, in micro-satoshi
6495 uint32_t UnsignedChannelUpdate_get_fee_proportional_millionths(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
6498 * The amount to fee multiplier, in micro-satoshi
6500 void UnsignedChannelUpdate_set_fee_proportional_millionths(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint32_t val);
6502 void ChannelUpdate_free(struct LDKChannelUpdate this_ptr);
6504 struct LDKChannelUpdate ChannelUpdate_clone(const struct LDKChannelUpdate *NONNULL_PTR orig);
6507 * A signature of the channel update
6509 struct LDKSignature ChannelUpdate_get_signature(const struct LDKChannelUpdate *NONNULL_PTR this_ptr);
6512 * A signature of the channel update
6514 void ChannelUpdate_set_signature(struct LDKChannelUpdate *NONNULL_PTR this_ptr, struct LDKSignature val);
6517 * The actual channel update
6519 struct LDKUnsignedChannelUpdate ChannelUpdate_get_contents(const struct LDKChannelUpdate *NONNULL_PTR this_ptr);
6522 * The actual channel update
6524 void ChannelUpdate_set_contents(struct LDKChannelUpdate *NONNULL_PTR this_ptr, struct LDKUnsignedChannelUpdate val);
6526 MUST_USE_RES struct LDKChannelUpdate ChannelUpdate_new(struct LDKSignature signature_arg, struct LDKUnsignedChannelUpdate contents_arg);
6528 void QueryChannelRange_free(struct LDKQueryChannelRange this_ptr);
6530 struct LDKQueryChannelRange QueryChannelRange_clone(const struct LDKQueryChannelRange *NONNULL_PTR orig);
6533 * The genesis hash of the blockchain being queried
6535 const uint8_t (*QueryChannelRange_get_chain_hash(const struct LDKQueryChannelRange *NONNULL_PTR this_ptr))[32];
6538 * The genesis hash of the blockchain being queried
6540 void QueryChannelRange_set_chain_hash(struct LDKQueryChannelRange *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6543 * The height of the first block for the channel UTXOs being queried
6545 uint32_t QueryChannelRange_get_first_blocknum(const struct LDKQueryChannelRange *NONNULL_PTR this_ptr);
6548 * The height of the first block for the channel UTXOs being queried
6550 void QueryChannelRange_set_first_blocknum(struct LDKQueryChannelRange *NONNULL_PTR this_ptr, uint32_t val);
6553 * The number of blocks to include in the query results
6555 uint32_t QueryChannelRange_get_number_of_blocks(const struct LDKQueryChannelRange *NONNULL_PTR this_ptr);
6558 * The number of blocks to include in the query results
6560 void QueryChannelRange_set_number_of_blocks(struct LDKQueryChannelRange *NONNULL_PTR this_ptr, uint32_t val);
6562 MUST_USE_RES struct LDKQueryChannelRange QueryChannelRange_new(struct LDKThirtyTwoBytes chain_hash_arg, uint32_t first_blocknum_arg, uint32_t number_of_blocks_arg);
6564 void ReplyChannelRange_free(struct LDKReplyChannelRange this_ptr);
6566 struct LDKReplyChannelRange ReplyChannelRange_clone(const struct LDKReplyChannelRange *NONNULL_PTR orig);
6569 * The genesis hash of the blockchain being queried
6571 const uint8_t (*ReplyChannelRange_get_chain_hash(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr))[32];
6574 * The genesis hash of the blockchain being queried
6576 void ReplyChannelRange_set_chain_hash(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6579 * The height of the first block in the range of the reply
6581 uint32_t ReplyChannelRange_get_first_blocknum(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr);
6584 * The height of the first block in the range of the reply
6586 void ReplyChannelRange_set_first_blocknum(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, uint32_t val);
6589 * The number of blocks included in the range of the reply
6591 uint32_t ReplyChannelRange_get_number_of_blocks(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr);
6594 * The number of blocks included in the range of the reply
6596 void ReplyChannelRange_set_number_of_blocks(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, uint32_t val);
6599 * Indicates if the query recipient maintains up-to-date channel
6600 * information for the chain_hash
6602 bool ReplyChannelRange_get_full_information(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr);
6605 * Indicates if the query recipient maintains up-to-date channel
6606 * information for the chain_hash
6608 void ReplyChannelRange_set_full_information(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, bool val);
6611 * The short_channel_ids in the channel range
6613 void ReplyChannelRange_set_short_channel_ids(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, LDKCVec_u64Z val);
6615 MUST_USE_RES struct LDKReplyChannelRange ReplyChannelRange_new(struct LDKThirtyTwoBytes chain_hash_arg, uint32_t first_blocknum_arg, uint32_t number_of_blocks_arg, bool full_information_arg, LDKCVec_u64Z short_channel_ids_arg);
6617 void QueryShortChannelIds_free(struct LDKQueryShortChannelIds this_ptr);
6619 struct LDKQueryShortChannelIds QueryShortChannelIds_clone(const struct LDKQueryShortChannelIds *NONNULL_PTR orig);
6622 * The genesis hash of the blockchain being queried
6624 const uint8_t (*QueryShortChannelIds_get_chain_hash(const struct LDKQueryShortChannelIds *NONNULL_PTR this_ptr))[32];
6627 * The genesis hash of the blockchain being queried
6629 void QueryShortChannelIds_set_chain_hash(struct LDKQueryShortChannelIds *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6632 * The short_channel_ids that are being queried
6634 void QueryShortChannelIds_set_short_channel_ids(struct LDKQueryShortChannelIds *NONNULL_PTR this_ptr, LDKCVec_u64Z val);
6636 MUST_USE_RES struct LDKQueryShortChannelIds QueryShortChannelIds_new(struct LDKThirtyTwoBytes chain_hash_arg, LDKCVec_u64Z short_channel_ids_arg);
6638 void ReplyShortChannelIdsEnd_free(struct LDKReplyShortChannelIdsEnd this_ptr);
6640 struct LDKReplyShortChannelIdsEnd ReplyShortChannelIdsEnd_clone(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR orig);
6643 * The genesis hash of the blockchain that was queried
6645 const uint8_t (*ReplyShortChannelIdsEnd_get_chain_hash(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr))[32];
6648 * The genesis hash of the blockchain that was queried
6650 void ReplyShortChannelIdsEnd_set_chain_hash(struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6653 * Indicates if the query recipient maintains up-to-date channel
6654 * information for the chain_hash
6656 bool ReplyShortChannelIdsEnd_get_full_information(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr);
6659 * Indicates if the query recipient maintains up-to-date channel
6660 * information for the chain_hash
6662 void ReplyShortChannelIdsEnd_set_full_information(struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr, bool val);
6664 MUST_USE_RES struct LDKReplyShortChannelIdsEnd ReplyShortChannelIdsEnd_new(struct LDKThirtyTwoBytes chain_hash_arg, bool full_information_arg);
6666 void GossipTimestampFilter_free(struct LDKGossipTimestampFilter this_ptr);
6668 struct LDKGossipTimestampFilter GossipTimestampFilter_clone(const struct LDKGossipTimestampFilter *NONNULL_PTR orig);
6671 * The genesis hash of the blockchain for channel and node information
6673 const uint8_t (*GossipTimestampFilter_get_chain_hash(const struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr))[32];
6676 * The genesis hash of the blockchain for channel and node information
6678 void GossipTimestampFilter_set_chain_hash(struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6681 * The starting unix timestamp
6683 uint32_t GossipTimestampFilter_get_first_timestamp(const struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr);
6686 * The starting unix timestamp
6688 void GossipTimestampFilter_set_first_timestamp(struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr, uint32_t val);
6691 * The range of information in seconds
6693 uint32_t GossipTimestampFilter_get_timestamp_range(const struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr);
6696 * The range of information in seconds
6698 void GossipTimestampFilter_set_timestamp_range(struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr, uint32_t val);
6700 MUST_USE_RES struct LDKGossipTimestampFilter GossipTimestampFilter_new(struct LDKThirtyTwoBytes chain_hash_arg, uint32_t first_timestamp_arg, uint32_t timestamp_range_arg);
6702 void ErrorAction_free(struct LDKErrorAction this_ptr);
6704 struct LDKErrorAction ErrorAction_clone(const struct LDKErrorAction *NONNULL_PTR orig);
6706 void LightningError_free(struct LDKLightningError this_ptr);
6709 * A human-readable message describing the error
6711 struct LDKStr LightningError_get_err(const struct LDKLightningError *NONNULL_PTR this_ptr);
6714 * A human-readable message describing the error
6716 void LightningError_set_err(struct LDKLightningError *NONNULL_PTR this_ptr, LDKCVec_u8Z val);
6719 * The action which should be taken against the offending peer.
6721 struct LDKErrorAction LightningError_get_action(const struct LDKLightningError *NONNULL_PTR this_ptr);
6724 * The action which should be taken against the offending peer.
6726 void LightningError_set_action(struct LDKLightningError *NONNULL_PTR this_ptr, struct LDKErrorAction val);
6728 MUST_USE_RES struct LDKLightningError LightningError_new(LDKCVec_u8Z err_arg, struct LDKErrorAction action_arg);
6730 void CommitmentUpdate_free(struct LDKCommitmentUpdate this_ptr);
6732 struct LDKCommitmentUpdate CommitmentUpdate_clone(const struct LDKCommitmentUpdate *NONNULL_PTR orig);
6735 * update_add_htlc messages which should be sent
6737 void CommitmentUpdate_set_update_add_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, LDKCVec_UpdateAddHTLCZ val);
6740 * update_fulfill_htlc messages which should be sent
6742 void CommitmentUpdate_set_update_fulfill_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, LDKCVec_UpdateFulfillHTLCZ val);
6745 * update_fail_htlc messages which should be sent
6747 void CommitmentUpdate_set_update_fail_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, LDKCVec_UpdateFailHTLCZ val);
6750 * update_fail_malformed_htlc messages which should be sent
6752 void CommitmentUpdate_set_update_fail_malformed_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, LDKCVec_UpdateFailMalformedHTLCZ val);
6755 * An update_fee message which should be sent
6757 struct LDKUpdateFee CommitmentUpdate_get_update_fee(const struct LDKCommitmentUpdate *NONNULL_PTR this_ptr);
6760 * An update_fee message which should be sent
6762 void CommitmentUpdate_set_update_fee(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKUpdateFee val);
6765 * Finally, the commitment_signed message which should be sent
6767 struct LDKCommitmentSigned CommitmentUpdate_get_commitment_signed(const struct LDKCommitmentUpdate *NONNULL_PTR this_ptr);
6770 * Finally, the commitment_signed message which should be sent
6772 void CommitmentUpdate_set_commitment_signed(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKCommitmentSigned val);
6774 MUST_USE_RES struct LDKCommitmentUpdate CommitmentUpdate_new(LDKCVec_UpdateAddHTLCZ update_add_htlcs_arg, LDKCVec_UpdateFulfillHTLCZ update_fulfill_htlcs_arg, LDKCVec_UpdateFailHTLCZ update_fail_htlcs_arg, LDKCVec_UpdateFailMalformedHTLCZ update_fail_malformed_htlcs_arg, struct LDKUpdateFee update_fee_arg, struct LDKCommitmentSigned commitment_signed_arg);
6776 void HTLCFailChannelUpdate_free(struct LDKHTLCFailChannelUpdate this_ptr);
6778 struct LDKHTLCFailChannelUpdate HTLCFailChannelUpdate_clone(const struct LDKHTLCFailChannelUpdate *NONNULL_PTR orig);
6781 * Calls the free function if one is set
6783 void ChannelMessageHandler_free(struct LDKChannelMessageHandler this_ptr);
6786 * Calls the free function if one is set
6788 void RoutingMessageHandler_free(struct LDKRoutingMessageHandler this_ptr);
6790 LDKCVec_u8Z AcceptChannel_write(const struct LDKAcceptChannel *NONNULL_PTR obj);
6792 struct LDKAcceptChannel AcceptChannel_read(struct LDKu8slice ser);
6794 LDKCVec_u8Z AnnouncementSignatures_write(const struct LDKAnnouncementSignatures *NONNULL_PTR obj);
6796 struct LDKAnnouncementSignatures AnnouncementSignatures_read(struct LDKu8slice ser);
6798 LDKCVec_u8Z ChannelReestablish_write(const struct LDKChannelReestablish *NONNULL_PTR obj);
6800 LDKCResult_ChannelReestablishDecodeErrorZ ChannelReestablish_read(struct LDKu8slice ser);
6802 LDKCVec_u8Z ClosingSigned_write(const struct LDKClosingSigned *NONNULL_PTR obj);
6804 struct LDKClosingSigned ClosingSigned_read(struct LDKu8slice ser);
6806 LDKCVec_u8Z CommitmentSigned_write(const struct LDKCommitmentSigned *NONNULL_PTR obj);
6808 struct LDKCommitmentSigned CommitmentSigned_read(struct LDKu8slice ser);
6810 LDKCVec_u8Z FundingCreated_write(const struct LDKFundingCreated *NONNULL_PTR obj);
6812 struct LDKFundingCreated FundingCreated_read(struct LDKu8slice ser);
6814 LDKCVec_u8Z FundingSigned_write(const struct LDKFundingSigned *NONNULL_PTR obj);
6816 struct LDKFundingSigned FundingSigned_read(struct LDKu8slice ser);
6818 LDKCVec_u8Z FundingLocked_write(const struct LDKFundingLocked *NONNULL_PTR obj);
6820 struct LDKFundingLocked FundingLocked_read(struct LDKu8slice ser);
6822 LDKCVec_u8Z Init_write(const struct LDKInit *NONNULL_PTR obj);
6824 LDKCResult_InitDecodeErrorZ Init_read(struct LDKu8slice ser);
6826 LDKCVec_u8Z OpenChannel_write(const struct LDKOpenChannel *NONNULL_PTR obj);
6828 struct LDKOpenChannel OpenChannel_read(struct LDKu8slice ser);
6830 LDKCVec_u8Z RevokeAndACK_write(const struct LDKRevokeAndACK *NONNULL_PTR obj);
6832 struct LDKRevokeAndACK RevokeAndACK_read(struct LDKu8slice ser);
6834 LDKCVec_u8Z Shutdown_write(const struct LDKShutdown *NONNULL_PTR obj);
6836 struct LDKShutdown Shutdown_read(struct LDKu8slice ser);
6838 LDKCVec_u8Z UpdateFailHTLC_write(const struct LDKUpdateFailHTLC *NONNULL_PTR obj);
6840 struct LDKUpdateFailHTLC UpdateFailHTLC_read(struct LDKu8slice ser);
6842 LDKCVec_u8Z UpdateFailMalformedHTLC_write(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR obj);
6844 struct LDKUpdateFailMalformedHTLC UpdateFailMalformedHTLC_read(struct LDKu8slice ser);
6846 LDKCVec_u8Z UpdateFee_write(const struct LDKUpdateFee *NONNULL_PTR obj);
6848 struct LDKUpdateFee UpdateFee_read(struct LDKu8slice ser);
6850 LDKCVec_u8Z UpdateFulfillHTLC_write(const struct LDKUpdateFulfillHTLC *NONNULL_PTR obj);
6852 struct LDKUpdateFulfillHTLC UpdateFulfillHTLC_read(struct LDKu8slice ser);
6854 LDKCVec_u8Z UpdateAddHTLC_write(const struct LDKUpdateAddHTLC *NONNULL_PTR obj);
6856 struct LDKUpdateAddHTLC UpdateAddHTLC_read(struct LDKu8slice ser);
6858 LDKCVec_u8Z Ping_write(const struct LDKPing *NONNULL_PTR obj);
6860 LDKCResult_PingDecodeErrorZ Ping_read(struct LDKu8slice ser);
6862 LDKCVec_u8Z Pong_write(const struct LDKPong *NONNULL_PTR obj);
6864 LDKCResult_PongDecodeErrorZ Pong_read(struct LDKu8slice ser);
6866 LDKCVec_u8Z UnsignedChannelAnnouncement_write(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR obj);
6868 LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ UnsignedChannelAnnouncement_read(struct LDKu8slice ser);
6870 LDKCVec_u8Z ChannelAnnouncement_write(const struct LDKChannelAnnouncement *NONNULL_PTR obj);
6872 struct LDKChannelAnnouncement ChannelAnnouncement_read(struct LDKu8slice ser);
6874 LDKCVec_u8Z UnsignedChannelUpdate_write(const struct LDKUnsignedChannelUpdate *NONNULL_PTR obj);
6876 LDKCResult_UnsignedChannelUpdateDecodeErrorZ UnsignedChannelUpdate_read(struct LDKu8slice ser);
6878 LDKCVec_u8Z ChannelUpdate_write(const struct LDKChannelUpdate *NONNULL_PTR obj);
6880 struct LDKChannelUpdate ChannelUpdate_read(struct LDKu8slice ser);
6882 LDKCVec_u8Z ErrorMessage_write(const struct LDKErrorMessage *NONNULL_PTR obj);
6884 LDKCResult_ErrorMessageDecodeErrorZ ErrorMessage_read(struct LDKu8slice ser);
6886 LDKCVec_u8Z UnsignedNodeAnnouncement_write(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR obj);
6888 LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ UnsignedNodeAnnouncement_read(struct LDKu8slice ser);
6890 LDKCVec_u8Z NodeAnnouncement_write(const struct LDKNodeAnnouncement *NONNULL_PTR obj);
6892 struct LDKNodeAnnouncement NodeAnnouncement_read(struct LDKu8slice ser);
6894 LDKCResult_QueryShortChannelIdsDecodeErrorZ QueryShortChannelIds_read(struct LDKu8slice ser);
6896 LDKCVec_u8Z QueryShortChannelIds_write(const struct LDKQueryShortChannelIds *NONNULL_PTR obj);
6898 LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ ReplyShortChannelIdsEnd_read(struct LDKu8slice ser);
6900 LDKCVec_u8Z ReplyShortChannelIdsEnd_write(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR obj);
6902 LDKCResult_QueryChannelRangeDecodeErrorZ QueryChannelRange_read(struct LDKu8slice ser);
6904 LDKCVec_u8Z QueryChannelRange_write(const struct LDKQueryChannelRange *NONNULL_PTR obj);
6906 LDKCResult_ReplyChannelRangeDecodeErrorZ ReplyChannelRange_read(struct LDKu8slice ser);
6908 LDKCVec_u8Z ReplyChannelRange_write(const struct LDKReplyChannelRange *NONNULL_PTR obj);
6910 LDKCResult_GossipTimestampFilterDecodeErrorZ GossipTimestampFilter_read(struct LDKu8slice ser);
6912 LDKCVec_u8Z GossipTimestampFilter_write(const struct LDKGossipTimestampFilter *NONNULL_PTR obj);
6914 void MessageHandler_free(struct LDKMessageHandler this_ptr);
6917 * A message handler which handles messages specific to channels. Usually this is just a
6918 * ChannelManager object.
6920 const struct LDKChannelMessageHandler *MessageHandler_get_chan_handler(const struct LDKMessageHandler *NONNULL_PTR this_ptr);
6923 * A message handler which handles messages specific to channels. Usually this is just a
6924 * ChannelManager object.
6926 void MessageHandler_set_chan_handler(struct LDKMessageHandler *NONNULL_PTR this_ptr, struct LDKChannelMessageHandler val);
6929 * A message handler which handles messages updating our knowledge of the network channel
6930 * graph. Usually this is just a NetGraphMsgHandlerMonitor object.
6932 const struct LDKRoutingMessageHandler *MessageHandler_get_route_handler(const struct LDKMessageHandler *NONNULL_PTR this_ptr);
6935 * A message handler which handles messages updating our knowledge of the network channel
6936 * graph. Usually this is just a NetGraphMsgHandlerMonitor object.
6938 void MessageHandler_set_route_handler(struct LDKMessageHandler *NONNULL_PTR this_ptr, struct LDKRoutingMessageHandler val);
6940 MUST_USE_RES struct LDKMessageHandler MessageHandler_new(struct LDKChannelMessageHandler chan_handler_arg, struct LDKRoutingMessageHandler route_handler_arg);
6942 struct LDKSocketDescriptor SocketDescriptor_clone(const struct LDKSocketDescriptor *NONNULL_PTR orig);
6945 * Calls the free function if one is set
6947 void SocketDescriptor_free(struct LDKSocketDescriptor this_ptr);
6949 void PeerHandleError_free(struct LDKPeerHandleError this_ptr);
6952 * Used to indicate that we probably can't make any future connections to this peer, implying
6953 * we should go ahead and force-close any channels we have with it.
6955 bool PeerHandleError_get_no_connection_possible(const struct LDKPeerHandleError *NONNULL_PTR this_ptr);
6958 * Used to indicate that we probably can't make any future connections to this peer, implying
6959 * we should go ahead and force-close any channels we have with it.
6961 void PeerHandleError_set_no_connection_possible(struct LDKPeerHandleError *NONNULL_PTR this_ptr, bool val);
6963 MUST_USE_RES struct LDKPeerHandleError PeerHandleError_new(bool no_connection_possible_arg);
6965 void PeerManager_free(struct LDKPeerManager this_ptr);
6968 * Constructs a new PeerManager with the given message handlers and node_id secret key
6969 * ephemeral_random_data is used to derive per-connection ephemeral keys and must be
6970 * cryptographically secure random bytes.
6972 MUST_USE_RES struct LDKPeerManager PeerManager_new(struct LDKMessageHandler message_handler, struct LDKSecretKey our_node_secret, const uint8_t (*ephemeral_random_data)[32], struct LDKLogger logger);
6975 * Get the list of node ids for peers which have completed the initial handshake.
6977 * For outbound connections, this will be the same as the their_node_id parameter passed in to
6978 * new_outbound_connection, however entries will only appear once the initial handshake has
6979 * completed and we are sure the remote peer has the private key for the given node_id.
6981 MUST_USE_RES LDKCVec_PublicKeyZ PeerManager_get_peer_node_ids(const struct LDKPeerManager *NONNULL_PTR this_arg);
6984 * Indicates a new outbound connection has been established to a node with the given node_id.
6985 * Note that if an Err is returned here you MUST NOT call socket_disconnected for the new
6986 * descriptor but must disconnect the connection immediately.
6988 * Returns a small number of bytes to send to the remote node (currently always 50).
6990 * Panics if descriptor is duplicative with some other descriptor which has not yet had a
6991 * socket_disconnected().
6993 MUST_USE_RES LDKCResult_CVec_u8ZPeerHandleErrorZ PeerManager_new_outbound_connection(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKPublicKey their_node_id, struct LDKSocketDescriptor descriptor);
6996 * Indicates a new inbound connection has been established.
6998 * May refuse the connection by returning an Err, but will never write bytes to the remote end
6999 * (outbound connector always speaks first). Note that if an Err is returned here you MUST NOT
7000 * call socket_disconnected for the new descriptor but must disconnect the connection
7003 * Panics if descriptor is duplicative with some other descriptor which has not yet had
7004 * socket_disconnected called.
7006 MUST_USE_RES LDKCResult_NonePeerHandleErrorZ PeerManager_new_inbound_connection(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKSocketDescriptor descriptor);
7009 * Indicates that there is room to write data to the given socket descriptor.
7011 * May return an Err to indicate that the connection should be closed.
7013 * Will most likely call send_data on the descriptor passed in (or the descriptor handed into
7014 * new_*\\_connection) before returning. Thus, be very careful with reentrancy issues! The
7015 * invariants around calling write_buffer_space_avail in case a write did not fully complete
7016 * must still hold - be ready to call write_buffer_space_avail again if a write call generated
7017 * here isn't sufficient! Panics if the descriptor was not previously registered in a
7018 * new_\\*_connection event.
7020 MUST_USE_RES LDKCResult_NonePeerHandleErrorZ PeerManager_write_buffer_space_avail(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKSocketDescriptor *NONNULL_PTR descriptor);
7023 * Indicates that data was read from the given socket descriptor.
7025 * May return an Err to indicate that the connection should be closed.
7027 * Will *not* call back into send_data on any descriptors to avoid reentrancy complexity.
7028 * Thus, however, you almost certainly want to call process_events() after any read_event to
7029 * generate send_data calls to handle responses.
7031 * If Ok(true) is returned, further read_events should not be triggered until a send_data call
7032 * on this file descriptor has resume_read set (preventing DoS issues in the send buffer).
7034 * Panics if the descriptor was not previously registered in a new_*_connection event.
7036 MUST_USE_RES LDKCResult_boolPeerHandleErrorZ PeerManager_read_event(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKSocketDescriptor *NONNULL_PTR peer_descriptor, struct LDKu8slice data);
7039 * Checks for any events generated by our handlers and processes them. Includes sending most
7040 * response messages as well as messages generated by calls to handler functions directly (eg
7041 * functions like ChannelManager::process_pending_htlc_forward or send_payment).
7043 void PeerManager_process_events(const struct LDKPeerManager *NONNULL_PTR this_arg);
7046 * Indicates that the given socket descriptor's connection is now closed.
7048 * This must only be called if the socket has been disconnected by the peer or your own
7049 * decision to disconnect it and must NOT be called in any case where other parts of this
7050 * library (eg PeerHandleError, explicit disconnect_socket calls) instruct you to disconnect
7053 * Panics if the descriptor was not previously registered in a successful new_*_connection event.
7055 void PeerManager_socket_disconnected(const struct LDKPeerManager *NONNULL_PTR this_arg, const struct LDKSocketDescriptor *NONNULL_PTR descriptor);
7058 * This function should be called roughly once every 30 seconds.
7059 * It will send pings to each peer and disconnect those which did not respond to the last round of pings.
7060 * Will most likely call send_data on all of the registered descriptors, thus, be very careful with reentrancy issues!
7062 void PeerManager_timer_tick_occured(const struct LDKPeerManager *NONNULL_PTR this_arg);
7065 * Build the commitment secret from the seed and the commitment number
7067 struct LDKThirtyTwoBytes build_commitment_secret(const uint8_t (*commitment_seed)[32], uint64_t idx);
7070 * Derives a per-commitment-transaction private key (eg an htlc key or delayed_payment key)
7071 * from the base secret and the per_commitment_point.
7073 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
7074 * generated (ie our own).
7076 LDKCResult_SecretKeySecpErrorZ derive_private_key(struct LDKPublicKey per_commitment_point, const uint8_t (*base_secret)[32]);
7079 * Derives a per-commitment-transaction public key (eg an htlc key or a delayed_payment key)
7080 * from the base point and the per_commitment_key. This is the public equivalent of
7081 * derive_private_key - using only public keys to derive a public key instead of private keys.
7083 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
7084 * generated (ie our own).
7086 LDKCResult_PublicKeySecpErrorZ derive_public_key(struct LDKPublicKey per_commitment_point, struct LDKPublicKey base_point);
7089 * Derives a per-commitment-transaction revocation key from its constituent parts.
7091 * Only the cheating participant owns a valid witness to propagate a revoked
7092 * commitment transaction, thus per_commitment_secret always come from cheater
7093 * and revocation_base_secret always come from punisher, which is the broadcaster
7094 * of the transaction spending with this key knowledge.
7096 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
7097 * generated (ie our own).
7099 LDKCResult_SecretKeySecpErrorZ derive_private_revocation_key(const uint8_t (*per_commitment_secret)[32], const uint8_t (*countersignatory_revocation_base_secret)[32]);
7102 * Derives a per-commitment-transaction revocation public key from its constituent parts. This is
7103 * the public equivalend of derive_private_revocation_key - using only public keys to derive a
7104 * public key instead of private keys.
7106 * Only the cheating participant owns a valid witness to propagate a revoked
7107 * commitment transaction, thus per_commitment_point always come from cheater
7108 * and revocation_base_point always come from punisher, which is the broadcaster
7109 * of the transaction spending with this key knowledge.
7111 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
7112 * generated (ie our own).
7114 LDKCResult_PublicKeySecpErrorZ derive_public_revocation_key(struct LDKPublicKey per_commitment_point, struct LDKPublicKey countersignatory_revocation_base_point);
7116 void TxCreationKeys_free(struct LDKTxCreationKeys this_ptr);
7118 struct LDKTxCreationKeys TxCreationKeys_clone(const struct LDKTxCreationKeys *NONNULL_PTR orig);
7121 * The broadcaster's per-commitment public key which was used to derive the other keys.
7123 struct LDKPublicKey TxCreationKeys_get_per_commitment_point(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
7126 * The broadcaster's per-commitment public key which was used to derive the other keys.
7128 void TxCreationKeys_set_per_commitment_point(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7131 * The revocation key which is used to allow the broadcaster of the commitment
7132 * transaction to provide their counterparty the ability to punish them if they broadcast
7135 struct LDKPublicKey TxCreationKeys_get_revocation_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
7138 * The revocation key which is used to allow the broadcaster of the commitment
7139 * transaction to provide their counterparty the ability to punish them if they broadcast
7142 void TxCreationKeys_set_revocation_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7145 * Broadcaster's HTLC Key
7147 struct LDKPublicKey TxCreationKeys_get_broadcaster_htlc_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
7150 * Broadcaster's HTLC Key
7152 void TxCreationKeys_set_broadcaster_htlc_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7155 * Countersignatory's HTLC Key
7157 struct LDKPublicKey TxCreationKeys_get_countersignatory_htlc_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
7160 * Countersignatory's HTLC Key
7162 void TxCreationKeys_set_countersignatory_htlc_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7165 * Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
7167 struct LDKPublicKey TxCreationKeys_get_broadcaster_delayed_payment_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
7170 * Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
7172 void TxCreationKeys_set_broadcaster_delayed_payment_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7174 MUST_USE_RES struct LDKTxCreationKeys TxCreationKeys_new(struct LDKPublicKey per_commitment_point_arg, struct LDKPublicKey revocation_key_arg, struct LDKPublicKey broadcaster_htlc_key_arg, struct LDKPublicKey countersignatory_htlc_key_arg, struct LDKPublicKey broadcaster_delayed_payment_key_arg);
7176 LDKCVec_u8Z TxCreationKeys_write(const struct LDKTxCreationKeys *NONNULL_PTR obj);
7178 struct LDKTxCreationKeys TxCreationKeys_read(struct LDKu8slice ser);
7180 void ChannelPublicKeys_free(struct LDKChannelPublicKeys this_ptr);
7182 struct LDKChannelPublicKeys ChannelPublicKeys_clone(const struct LDKChannelPublicKeys *NONNULL_PTR orig);
7185 * The public key which is used to sign all commitment transactions, as it appears in the
7186 * on-chain channel lock-in 2-of-2 multisig output.
7188 struct LDKPublicKey ChannelPublicKeys_get_funding_pubkey(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
7191 * The public key which is used to sign all commitment transactions, as it appears in the
7192 * on-chain channel lock-in 2-of-2 multisig output.
7194 void ChannelPublicKeys_set_funding_pubkey(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7197 * The base point which is used (with derive_public_revocation_key) to derive per-commitment
7198 * revocation keys. This is combined with the per-commitment-secret generated by the
7199 * counterparty to create a secret which the counterparty can reveal to revoke previous
7202 struct LDKPublicKey ChannelPublicKeys_get_revocation_basepoint(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
7205 * The base point which is used (with derive_public_revocation_key) to derive per-commitment
7206 * revocation keys. This is combined with the per-commitment-secret generated by the
7207 * counterparty to create a secret which the counterparty can reveal to revoke previous
7210 void ChannelPublicKeys_set_revocation_basepoint(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7213 * The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
7214 * spendable primary channel balance on the broadcaster's commitment transaction. This key is
7215 * static across every commitment transaction.
7217 struct LDKPublicKey ChannelPublicKeys_get_payment_point(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
7220 * The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
7221 * spendable primary channel balance on the broadcaster's commitment transaction. This key is
7222 * static across every commitment transaction.
7224 void ChannelPublicKeys_set_payment_point(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7227 * The base point which is used (with derive_public_key) to derive a per-commitment payment
7228 * public key which receives non-HTLC-encumbered funds which are only available for spending
7229 * after some delay (or can be claimed via the revocation path).
7231 struct LDKPublicKey ChannelPublicKeys_get_delayed_payment_basepoint(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
7234 * The base point which is used (with derive_public_key) to derive a per-commitment payment
7235 * public key which receives non-HTLC-encumbered funds which are only available for spending
7236 * after some delay (or can be claimed via the revocation path).
7238 void ChannelPublicKeys_set_delayed_payment_basepoint(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7241 * The base point which is used (with derive_public_key) to derive a per-commitment public key
7242 * which is used to encumber HTLC-in-flight outputs.
7244 struct LDKPublicKey ChannelPublicKeys_get_htlc_basepoint(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
7247 * The base point which is used (with derive_public_key) to derive a per-commitment public key
7248 * which is used to encumber HTLC-in-flight outputs.
7250 void ChannelPublicKeys_set_htlc_basepoint(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7252 MUST_USE_RES struct LDKChannelPublicKeys ChannelPublicKeys_new(struct LDKPublicKey funding_pubkey_arg, struct LDKPublicKey revocation_basepoint_arg, struct LDKPublicKey payment_point_arg, struct LDKPublicKey delayed_payment_basepoint_arg, struct LDKPublicKey htlc_basepoint_arg);
7254 LDKCVec_u8Z ChannelPublicKeys_write(const struct LDKChannelPublicKeys *NONNULL_PTR obj);
7256 struct LDKChannelPublicKeys ChannelPublicKeys_read(struct LDKu8slice ser);
7259 * Create per-state keys from channel base points and the per-commitment point.
7260 * Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
7262 MUST_USE_RES LDKCResult_TxCreationKeysSecpErrorZ TxCreationKeys_derive_new(struct LDKPublicKey per_commitment_point, struct LDKPublicKey broadcaster_delayed_payment_base, struct LDKPublicKey broadcaster_htlc_base, struct LDKPublicKey countersignatory_revocation_base, struct LDKPublicKey countersignatory_htlc_base);
7265 * Generate per-state keys from channel static keys.
7266 * Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
7268 MUST_USE_RES LDKCResult_TxCreationKeysSecpErrorZ TxCreationKeys_from_channel_static_keys(struct LDKPublicKey per_commitment_point, const struct LDKChannelPublicKeys *NONNULL_PTR broadcaster_keys, const struct LDKChannelPublicKeys *NONNULL_PTR countersignatory_keys);
7271 * A script either spendable by the revocation
7272 * key or the broadcaster_delayed_payment_key and satisfying the relative-locktime OP_CSV constrain.
7273 * Encumbering a `to_holder` output on a commitment transaction or 2nd-stage HTLC transactions.
7275 LDKCVec_u8Z get_revokeable_redeemscript(struct LDKPublicKey revocation_key, uint16_t contest_delay, struct LDKPublicKey broadcaster_delayed_payment_key);
7277 void HTLCOutputInCommitment_free(struct LDKHTLCOutputInCommitment this_ptr);
7279 struct LDKHTLCOutputInCommitment HTLCOutputInCommitment_clone(const struct LDKHTLCOutputInCommitment *NONNULL_PTR orig);
7282 * Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
7283 * Note that this is not the same as whether it is ountbound *from us*. To determine that you
7284 * need to compare this value to whether the commitment transaction in question is that of
7285 * the counterparty or our own.
7287 bool HTLCOutputInCommitment_get_offered(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr);
7290 * Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
7291 * Note that this is not the same as whether it is ountbound *from us*. To determine that you
7292 * need to compare this value to whether the commitment transaction in question is that of
7293 * the counterparty or our own.
7295 void HTLCOutputInCommitment_set_offered(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, bool val);
7298 * The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
7299 * this divided by 1000.
7301 uint64_t HTLCOutputInCommitment_get_amount_msat(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr);
7304 * The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
7305 * this divided by 1000.
7307 void HTLCOutputInCommitment_set_amount_msat(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, uint64_t val);
7310 * The CLTV lock-time at which this HTLC expires.
7312 uint32_t HTLCOutputInCommitment_get_cltv_expiry(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr);
7315 * The CLTV lock-time at which this HTLC expires.
7317 void HTLCOutputInCommitment_set_cltv_expiry(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, uint32_t val);
7320 * The hash of the preimage which unlocks this HTLC.
7322 const uint8_t (*HTLCOutputInCommitment_get_payment_hash(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr))[32];
7325 * The hash of the preimage which unlocks this HTLC.
7327 void HTLCOutputInCommitment_set_payment_hash(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7329 LDKCVec_u8Z HTLCOutputInCommitment_write(const struct LDKHTLCOutputInCommitment *NONNULL_PTR obj);
7331 struct LDKHTLCOutputInCommitment HTLCOutputInCommitment_read(struct LDKu8slice ser);
7334 * Gets the witness redeemscript for an HTLC output in a commitment transaction. Note that htlc
7335 * does not need to have its previous_output_index filled.
7337 LDKCVec_u8Z get_htlc_redeemscript(const struct LDKHTLCOutputInCommitment *NONNULL_PTR htlc, const struct LDKTxCreationKeys *NONNULL_PTR keys);
7340 * Gets the redeemscript for a funding output from the two funding public keys.
7341 * Note that the order of funding public keys does not matter.
7343 LDKCVec_u8Z make_funding_redeemscript(struct LDKPublicKey broadcaster, struct LDKPublicKey countersignatory);
7346 * panics if htlc.transaction_output_index.is_none()!
7348 struct LDKTransaction build_htlc_transaction(const uint8_t (*prev_hash)[32], uint32_t feerate_per_kw, uint16_t contest_delay, const struct LDKHTLCOutputInCommitment *NONNULL_PTR htlc, struct LDKPublicKey broadcaster_delayed_payment_key, struct LDKPublicKey revocation_key);
7350 void ChannelTransactionParameters_free(struct LDKChannelTransactionParameters this_ptr);
7352 struct LDKChannelTransactionParameters ChannelTransactionParameters_clone(const struct LDKChannelTransactionParameters *NONNULL_PTR orig);
7355 * Holder public keys
7357 struct LDKChannelPublicKeys ChannelTransactionParameters_get_holder_pubkeys(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
7360 * Holder public keys
7362 void ChannelTransactionParameters_set_holder_pubkeys(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKChannelPublicKeys val);
7365 * The contest delay selected by the holder, which applies to counterparty-broadcast transactions
7367 uint16_t ChannelTransactionParameters_get_holder_selected_contest_delay(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
7370 * The contest delay selected by the holder, which applies to counterparty-broadcast transactions
7372 void ChannelTransactionParameters_set_holder_selected_contest_delay(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, uint16_t val);
7375 * Whether the holder is the initiator of this channel.
7376 * This is an input to the commitment number obscure factor computation.
7378 bool ChannelTransactionParameters_get_is_outbound_from_holder(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
7381 * Whether the holder is the initiator of this channel.
7382 * This is an input to the commitment number obscure factor computation.
7384 void ChannelTransactionParameters_set_is_outbound_from_holder(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, bool val);
7387 * The late-bound counterparty channel transaction parameters.
7388 * These parameters are populated at the point in the protocol where the counterparty provides them.
7390 struct LDKCounterpartyChannelTransactionParameters ChannelTransactionParameters_get_counterparty_parameters(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
7393 * The late-bound counterparty channel transaction parameters.
7394 * These parameters are populated at the point in the protocol where the counterparty provides them.
7396 void ChannelTransactionParameters_set_counterparty_parameters(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKCounterpartyChannelTransactionParameters val);
7399 * The late-bound funding outpoint
7401 struct LDKOutPoint ChannelTransactionParameters_get_funding_outpoint(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
7404 * The late-bound funding outpoint
7406 void ChannelTransactionParameters_set_funding_outpoint(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKOutPoint val);
7408 MUST_USE_RES struct LDKChannelTransactionParameters ChannelTransactionParameters_new(struct LDKChannelPublicKeys holder_pubkeys_arg, uint16_t holder_selected_contest_delay_arg, bool is_outbound_from_holder_arg, struct LDKCounterpartyChannelTransactionParameters counterparty_parameters_arg, struct LDKOutPoint funding_outpoint_arg);
7410 void CounterpartyChannelTransactionParameters_free(struct LDKCounterpartyChannelTransactionParameters this_ptr);
7412 struct LDKCounterpartyChannelTransactionParameters CounterpartyChannelTransactionParameters_clone(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR orig);
7415 * Counter-party public keys
7417 struct LDKChannelPublicKeys CounterpartyChannelTransactionParameters_get_pubkeys(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr);
7420 * Counter-party public keys
7422 void CounterpartyChannelTransactionParameters_set_pubkeys(struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKChannelPublicKeys val);
7425 * The contest delay selected by the counterparty, which applies to holder-broadcast transactions
7427 uint16_t CounterpartyChannelTransactionParameters_get_selected_contest_delay(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr);
7430 * The contest delay selected by the counterparty, which applies to holder-broadcast transactions
7432 void CounterpartyChannelTransactionParameters_set_selected_contest_delay(struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr, uint16_t val);
7434 MUST_USE_RES struct LDKCounterpartyChannelTransactionParameters CounterpartyChannelTransactionParameters_new(struct LDKChannelPublicKeys pubkeys_arg, uint16_t selected_contest_delay_arg);
7437 * Whether the late bound parameters are populated.
7439 MUST_USE_RES bool ChannelTransactionParameters_is_populated(const struct LDKChannelTransactionParameters *NONNULL_PTR this_arg);
7442 * Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
7443 * given that the holder is the broadcaster.
7445 * self.is_populated() must be true before calling this function.
7447 MUST_USE_RES struct LDKDirectedChannelTransactionParameters ChannelTransactionParameters_as_holder_broadcastable(const struct LDKChannelTransactionParameters *NONNULL_PTR this_arg);
7450 * Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
7451 * given that the counterparty is the broadcaster.
7453 * self.is_populated() must be true before calling this function.
7455 MUST_USE_RES struct LDKDirectedChannelTransactionParameters ChannelTransactionParameters_as_counterparty_broadcastable(const struct LDKChannelTransactionParameters *NONNULL_PTR this_arg);
7457 LDKCVec_u8Z CounterpartyChannelTransactionParameters_write(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR obj);
7459 struct LDKCounterpartyChannelTransactionParameters CounterpartyChannelTransactionParameters_read(struct LDKu8slice ser);
7461 LDKCVec_u8Z ChannelTransactionParameters_write(const struct LDKChannelTransactionParameters *NONNULL_PTR obj);
7463 struct LDKChannelTransactionParameters ChannelTransactionParameters_read(struct LDKu8slice ser);
7465 void DirectedChannelTransactionParameters_free(struct LDKDirectedChannelTransactionParameters this_ptr);
7468 * Get the channel pubkeys for the broadcaster
7470 MUST_USE_RES struct LDKChannelPublicKeys DirectedChannelTransactionParameters_broadcaster_pubkeys(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
7473 * Get the channel pubkeys for the countersignatory
7475 MUST_USE_RES struct LDKChannelPublicKeys DirectedChannelTransactionParameters_countersignatory_pubkeys(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
7478 * Get the contest delay applicable to the transactions.
7479 * Note that the contest delay was selected by the countersignatory.
7481 MUST_USE_RES uint16_t DirectedChannelTransactionParameters_contest_delay(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
7484 * Whether the channel is outbound from the broadcaster.
7486 * The boolean representing the side that initiated the channel is
7487 * an input to the commitment number obscure factor computation.
7489 MUST_USE_RES bool DirectedChannelTransactionParameters_is_outbound(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
7492 * The funding outpoint
7494 MUST_USE_RES struct LDKOutPoint DirectedChannelTransactionParameters_funding_outpoint(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
7496 void HolderCommitmentTransaction_free(struct LDKHolderCommitmentTransaction this_ptr);
7498 struct LDKHolderCommitmentTransaction HolderCommitmentTransaction_clone(const struct LDKHolderCommitmentTransaction *NONNULL_PTR orig);
7501 * Our counterparty's signature for the transaction
7503 struct LDKSignature HolderCommitmentTransaction_get_counterparty_sig(const struct LDKHolderCommitmentTransaction *NONNULL_PTR this_ptr);
7506 * Our counterparty's signature for the transaction
7508 void HolderCommitmentTransaction_set_counterparty_sig(struct LDKHolderCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKSignature val);
7511 * All non-dust counterparty HTLC signatures, in the order they appear in the transaction
7513 void HolderCommitmentTransaction_set_counterparty_htlc_sigs(struct LDKHolderCommitmentTransaction *NONNULL_PTR this_ptr, LDKCVec_SignatureZ val);
7515 LDKCVec_u8Z HolderCommitmentTransaction_write(const struct LDKHolderCommitmentTransaction *NONNULL_PTR obj);
7517 struct LDKHolderCommitmentTransaction HolderCommitmentTransaction_read(struct LDKu8slice ser);
7520 * Create a new holder transaction with the given counterparty signatures.
7521 * The funding keys are used to figure out which signature should go first when building the transaction for broadcast.
7523 MUST_USE_RES struct LDKHolderCommitmentTransaction HolderCommitmentTransaction_new(struct LDKCommitmentTransaction commitment_tx, struct LDKSignature counterparty_sig, LDKCVec_SignatureZ counterparty_htlc_sigs, struct LDKPublicKey holder_funding_key, struct LDKPublicKey counterparty_funding_key);
7525 void BuiltCommitmentTransaction_free(struct LDKBuiltCommitmentTransaction this_ptr);
7527 struct LDKBuiltCommitmentTransaction BuiltCommitmentTransaction_clone(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR orig);
7530 * The commitment transaction
7532 struct LDKTransaction BuiltCommitmentTransaction_get_transaction(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr);
7535 * The commitment transaction
7537 void BuiltCommitmentTransaction_set_transaction(struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKTransaction val);
7540 * The txid for the commitment transaction.
7542 * This is provided as a performance optimization, instead of calling transaction.txid()
7545 const uint8_t (*BuiltCommitmentTransaction_get_txid(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr))[32];
7548 * The txid for the commitment transaction.
7550 * This is provided as a performance optimization, instead of calling transaction.txid()
7553 void BuiltCommitmentTransaction_set_txid(struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7555 MUST_USE_RES struct LDKBuiltCommitmentTransaction BuiltCommitmentTransaction_new(struct LDKTransaction transaction_arg, struct LDKThirtyTwoBytes txid_arg);
7557 LDKCVec_u8Z BuiltCommitmentTransaction_write(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR obj);
7559 struct LDKBuiltCommitmentTransaction BuiltCommitmentTransaction_read(struct LDKu8slice ser);
7562 * Get the SIGHASH_ALL sighash value of the transaction.
7564 * This can be used to verify a signature.
7566 MUST_USE_RES struct LDKThirtyTwoBytes BuiltCommitmentTransaction_get_sighash_all(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_arg, struct LDKu8slice funding_redeemscript, uint64_t channel_value_satoshis);
7569 * Sign a transaction, either because we are counter-signing the counterparty's transaction or
7570 * because we are about to broadcast a holder transaction.
7572 MUST_USE_RES struct LDKSignature BuiltCommitmentTransaction_sign(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_arg, const uint8_t (*funding_key)[32], struct LDKu8slice funding_redeemscript, uint64_t channel_value_satoshis);
7574 void CommitmentTransaction_free(struct LDKCommitmentTransaction this_ptr);
7576 struct LDKCommitmentTransaction CommitmentTransaction_clone(const struct LDKCommitmentTransaction *NONNULL_PTR orig);
7578 LDKCVec_u8Z CommitmentTransaction_write(const struct LDKCommitmentTransaction *NONNULL_PTR obj);
7580 struct LDKCommitmentTransaction CommitmentTransaction_read(struct LDKu8slice ser);
7583 * The backwards-counting commitment number
7585 MUST_USE_RES uint64_t CommitmentTransaction_commitment_number(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
7588 * The value to be sent to the broadcaster
7590 MUST_USE_RES uint64_t CommitmentTransaction_to_broadcaster_value_sat(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
7593 * The value to be sent to the counterparty
7595 MUST_USE_RES uint64_t CommitmentTransaction_to_countersignatory_value_sat(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
7598 * The feerate paid per 1000-weight-unit in this commitment transaction.
7600 MUST_USE_RES uint32_t CommitmentTransaction_feerate_per_kw(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
7603 * Trust our pre-built transaction and derived transaction creation public keys.
7605 * Applies a wrapper which allows access to these fields.
7607 * This should only be used if you fully trust the builder of this object. It should not
7608 *\tbe used by an external signer - instead use the verify function.
7610 MUST_USE_RES struct LDKTrustedCommitmentTransaction CommitmentTransaction_trust(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
7613 * Verify our pre-built transaction and derived transaction creation public keys.
7615 * Applies a wrapper which allows access to these fields.
7617 * An external validating signer must call this method before signing
7618 * or using the built transaction.
7620 MUST_USE_RES LDKCResult_TrustedCommitmentTransactionNoneZ CommitmentTransaction_verify(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg, const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR channel_parameters, const struct LDKChannelPublicKeys *NONNULL_PTR broadcaster_keys, const struct LDKChannelPublicKeys *NONNULL_PTR countersignatory_keys);
7622 void TrustedCommitmentTransaction_free(struct LDKTrustedCommitmentTransaction this_ptr);
7625 * The transaction ID of the built Bitcoin transaction
7627 MUST_USE_RES struct LDKThirtyTwoBytes TrustedCommitmentTransaction_txid(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg);
7630 * The pre-built Bitcoin commitment transaction
7632 MUST_USE_RES struct LDKBuiltCommitmentTransaction TrustedCommitmentTransaction_built_transaction(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg);
7635 * The pre-calculated transaction creation public keys.
7637 MUST_USE_RES struct LDKTxCreationKeys TrustedCommitmentTransaction_keys(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg);
7640 * Get a signature for each HTLC which was included in the commitment transaction (ie for
7641 * which HTLCOutputInCommitment::transaction_output_index.is_some()).
7643 * The returned Vec has one entry for each HTLC, and in the same order.
7645 MUST_USE_RES LDKCResult_CVec_SignatureZNoneZ TrustedCommitmentTransaction_get_htlc_sigs(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg, const uint8_t (*htlc_base_key)[32], const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR channel_parameters);
7648 * Get the transaction number obscure factor
7650 uint64_t get_commitment_transaction_number_obscure_factor(struct LDKPublicKey broadcaster_payment_basepoint, struct LDKPublicKey countersignatory_payment_basepoint, bool outbound_from_broadcaster);
7652 void InitFeatures_free(struct LDKInitFeatures this_ptr);
7654 void NodeFeatures_free(struct LDKNodeFeatures this_ptr);
7656 void ChannelFeatures_free(struct LDKChannelFeatures this_ptr);
7658 void RouteHop_free(struct LDKRouteHop this_ptr);
7660 struct LDKRouteHop RouteHop_clone(const struct LDKRouteHop *NONNULL_PTR orig);
7663 * The node_id of the node at this hop.
7665 struct LDKPublicKey RouteHop_get_pubkey(const struct LDKRouteHop *NONNULL_PTR this_ptr);
7668 * The node_id of the node at this hop.
7670 void RouteHop_set_pubkey(struct LDKRouteHop *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7673 * The node_announcement features of the node at this hop. For the last hop, these may be
7674 * amended to match the features present in the invoice this node generated.
7676 struct LDKNodeFeatures RouteHop_get_node_features(const struct LDKRouteHop *NONNULL_PTR this_ptr);
7679 * The node_announcement features of the node at this hop. For the last hop, these may be
7680 * amended to match the features present in the invoice this node generated.
7682 void RouteHop_set_node_features(struct LDKRouteHop *NONNULL_PTR this_ptr, struct LDKNodeFeatures val);
7685 * The channel that should be used from the previous hop to reach this node.
7687 uint64_t RouteHop_get_short_channel_id(const struct LDKRouteHop *NONNULL_PTR this_ptr);
7690 * The channel that should be used from the previous hop to reach this node.
7692 void RouteHop_set_short_channel_id(struct LDKRouteHop *NONNULL_PTR this_ptr, uint64_t val);
7695 * The channel_announcement features of the channel that should be used from the previous hop
7696 * to reach this node.
7698 struct LDKChannelFeatures RouteHop_get_channel_features(const struct LDKRouteHop *NONNULL_PTR this_ptr);
7701 * The channel_announcement features of the channel that should be used from the previous hop
7702 * to reach this node.
7704 void RouteHop_set_channel_features(struct LDKRouteHop *NONNULL_PTR this_ptr, struct LDKChannelFeatures val);
7707 * The fee taken on this hop. For the last hop, this should be the full value of the payment.
7709 uint64_t RouteHop_get_fee_msat(const struct LDKRouteHop *NONNULL_PTR this_ptr);
7712 * The fee taken on this hop. For the last hop, this should be the full value of the payment.
7714 void RouteHop_set_fee_msat(struct LDKRouteHop *NONNULL_PTR this_ptr, uint64_t val);
7717 * The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
7718 * expected at the destination, in excess of the current block height.
7720 uint32_t RouteHop_get_cltv_expiry_delta(const struct LDKRouteHop *NONNULL_PTR this_ptr);
7723 * The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
7724 * expected at the destination, in excess of the current block height.
7726 void RouteHop_set_cltv_expiry_delta(struct LDKRouteHop *NONNULL_PTR this_ptr, uint32_t val);
7728 MUST_USE_RES struct LDKRouteHop RouteHop_new(struct LDKPublicKey pubkey_arg, struct LDKNodeFeatures node_features_arg, uint64_t short_channel_id_arg, struct LDKChannelFeatures channel_features_arg, uint64_t fee_msat_arg, uint32_t cltv_expiry_delta_arg);
7730 void Route_free(struct LDKRoute this_ptr);
7732 struct LDKRoute Route_clone(const struct LDKRoute *NONNULL_PTR orig);
7735 * The list of routes taken for a single (potentially-)multi-part payment. The pubkey of the
7736 * last RouteHop in each path must be the same.
7737 * Each entry represents a list of hops, NOT INCLUDING our own, where the last hop is the
7738 * destination. Thus, this must always be at least length one. While the maximum length of any
7739 * given path is variable, keeping the length of any path to less than 20 should currently
7740 * ensure it is viable.
7742 void Route_set_paths(struct LDKRoute *NONNULL_PTR this_ptr, LDKCVec_CVec_RouteHopZZ val);
7744 MUST_USE_RES struct LDKRoute Route_new(LDKCVec_CVec_RouteHopZZ paths_arg);
7746 LDKCVec_u8Z Route_write(const struct LDKRoute *NONNULL_PTR obj);
7748 LDKCResult_RouteDecodeErrorZ Route_read(struct LDKu8slice ser);
7750 void RouteHint_free(struct LDKRouteHint this_ptr);
7752 struct LDKRouteHint RouteHint_clone(const struct LDKRouteHint *NONNULL_PTR orig);
7755 * The node_id of the non-target end of the route
7757 struct LDKPublicKey RouteHint_get_src_node_id(const struct LDKRouteHint *NONNULL_PTR this_ptr);
7760 * The node_id of the non-target end of the route
7762 void RouteHint_set_src_node_id(struct LDKRouteHint *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7765 * The short_channel_id of this channel
7767 uint64_t RouteHint_get_short_channel_id(const struct LDKRouteHint *NONNULL_PTR this_ptr);
7770 * The short_channel_id of this channel
7772 void RouteHint_set_short_channel_id(struct LDKRouteHint *NONNULL_PTR this_ptr, uint64_t val);
7775 * The fees which must be paid to use this channel
7777 struct LDKRoutingFees RouteHint_get_fees(const struct LDKRouteHint *NONNULL_PTR this_ptr);
7780 * The fees which must be paid to use this channel
7782 void RouteHint_set_fees(struct LDKRouteHint *NONNULL_PTR this_ptr, struct LDKRoutingFees val);
7785 * The difference in CLTV values between this node and the next node.
7787 uint16_t RouteHint_get_cltv_expiry_delta(const struct LDKRouteHint *NONNULL_PTR this_ptr);
7790 * The difference in CLTV values between this node and the next node.
7792 void RouteHint_set_cltv_expiry_delta(struct LDKRouteHint *NONNULL_PTR this_ptr, uint16_t val);
7795 * The minimum value, in msat, which must be relayed to the next hop.
7797 uint64_t RouteHint_get_htlc_minimum_msat(const struct LDKRouteHint *NONNULL_PTR this_ptr);
7800 * The minimum value, in msat, which must be relayed to the next hop.
7802 void RouteHint_set_htlc_minimum_msat(struct LDKRouteHint *NONNULL_PTR this_ptr, uint64_t val);
7804 MUST_USE_RES struct LDKRouteHint RouteHint_new(struct LDKPublicKey src_node_id_arg, uint64_t short_channel_id_arg, struct LDKRoutingFees fees_arg, uint16_t cltv_expiry_delta_arg, uint64_t htlc_minimum_msat_arg);
7807 * Gets a route from us to the given target node.
7809 * Extra routing hops between known nodes and the target will be used if they are included in
7812 * If some channels aren't announced, it may be useful to fill in a first_hops with the
7813 * results from a local ChannelManager::list_usable_channels() call. If it is filled in, our
7814 * view of our local channels (from net_graph_msg_handler) will be ignored, and only those in first_hops
7817 * Panics if first_hops contains channels without short_channel_ids
7818 * (ChannelManager::list_usable_channels will never include such channels).
7820 * The fees on channels from us to next-hops are ignored (as they are assumed to all be
7821 * equal), however the enabled/disabled bit on such channels as well as the htlc_minimum_msat
7822 * *is* checked as they may change based on the receiving node.
7824 LDKCResult_RouteLightningErrorZ get_route(struct LDKPublicKey our_node_id, const struct LDKNetworkGraph *NONNULL_PTR network, struct LDKPublicKey target, LDKCVec_ChannelDetailsZ *first_hops, LDKCVec_RouteHintZ last_hops, uint64_t final_value_msat, uint32_t final_cltv, struct LDKLogger logger);
7826 void NetworkGraph_free(struct LDKNetworkGraph this_ptr);
7828 void LockedNetworkGraph_free(struct LDKLockedNetworkGraph this_ptr);
7830 void NetGraphMsgHandler_free(struct LDKNetGraphMsgHandler this_ptr);
7833 * Creates a new tracker of the actual state of the network of channels and nodes,
7834 * assuming a fresh network graph.
7835 * Chain monitor is used to make sure announced channels exist on-chain,
7836 * channel data is correct, and that the announcement is signed with
7837 * channel owners' keys.
7839 MUST_USE_RES struct LDKNetGraphMsgHandler NetGraphMsgHandler_new(struct LDKThirtyTwoBytes genesis_hash, struct LDKAccess *chain_access, struct LDKLogger logger);
7842 * Creates a new tracker of the actual state of the network of channels and nodes,
7843 * assuming an existing Network Graph.
7845 MUST_USE_RES struct LDKNetGraphMsgHandler NetGraphMsgHandler_from_net_graph(struct LDKAccess *chain_access, struct LDKLogger logger, struct LDKNetworkGraph network_graph);
7848 * Take a read lock on the network_graph and return it in the C-bindings
7849 * newtype helper. This is likely only useful when called via the C
7850 * bindings as you can call `self.network_graph.read().unwrap()` in Rust
7853 MUST_USE_RES struct LDKLockedNetworkGraph NetGraphMsgHandler_read_locked_graph(const struct LDKNetGraphMsgHandler *NONNULL_PTR this_arg);
7856 * Get a reference to the NetworkGraph which this read-lock contains.
7858 MUST_USE_RES struct LDKNetworkGraph LockedNetworkGraph_graph(const struct LDKLockedNetworkGraph *NONNULL_PTR this_arg);
7860 struct LDKRoutingMessageHandler NetGraphMsgHandler_as_RoutingMessageHandler(const struct LDKNetGraphMsgHandler *NONNULL_PTR this_arg);
7862 struct LDKMessageSendEventsProvider NetGraphMsgHandler_as_MessageSendEventsProvider(const struct LDKNetGraphMsgHandler *NONNULL_PTR this_arg);
7864 void DirectionalChannelInfo_free(struct LDKDirectionalChannelInfo this_ptr);
7867 * When the last update to the channel direction was issued.
7868 * Value is opaque, as set in the announcement.
7870 uint32_t DirectionalChannelInfo_get_last_update(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
7873 * When the last update to the channel direction was issued.
7874 * Value is opaque, as set in the announcement.
7876 void DirectionalChannelInfo_set_last_update(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, uint32_t val);
7879 * Whether the channel can be currently used for payments (in this one direction).
7881 bool DirectionalChannelInfo_get_enabled(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
7884 * Whether the channel can be currently used for payments (in this one direction).
7886 void DirectionalChannelInfo_set_enabled(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, bool val);
7889 * The difference in CLTV values that you must have when routing through this channel.
7891 uint16_t DirectionalChannelInfo_get_cltv_expiry_delta(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
7894 * The difference in CLTV values that you must have when routing through this channel.
7896 void DirectionalChannelInfo_set_cltv_expiry_delta(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, uint16_t val);
7899 * The minimum value, which must be relayed to the next hop via the channel
7901 uint64_t DirectionalChannelInfo_get_htlc_minimum_msat(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
7904 * The minimum value, which must be relayed to the next hop via the channel
7906 void DirectionalChannelInfo_set_htlc_minimum_msat(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, uint64_t val);
7909 * Fees charged when the channel is used for routing
7911 struct LDKRoutingFees DirectionalChannelInfo_get_fees(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
7914 * Fees charged when the channel is used for routing
7916 void DirectionalChannelInfo_set_fees(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, struct LDKRoutingFees val);
7919 * Most recent update for the channel received from the network
7920 * Mostly redundant with the data we store in fields explicitly.
7921 * Everything else is useful only for sending out for initial routing sync.
7922 * Not stored if contains excess data to prevent DoS.
7924 struct LDKChannelUpdate DirectionalChannelInfo_get_last_update_message(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
7927 * Most recent update for the channel received from the network
7928 * Mostly redundant with the data we store in fields explicitly.
7929 * Everything else is useful only for sending out for initial routing sync.
7930 * Not stored if contains excess data to prevent DoS.
7932 void DirectionalChannelInfo_set_last_update_message(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, struct LDKChannelUpdate val);
7934 LDKCVec_u8Z DirectionalChannelInfo_write(const struct LDKDirectionalChannelInfo *NONNULL_PTR obj);
7936 struct LDKDirectionalChannelInfo DirectionalChannelInfo_read(struct LDKu8slice ser);
7938 void ChannelInfo_free(struct LDKChannelInfo this_ptr);
7941 * Protocol features of a channel communicated during its announcement
7943 struct LDKChannelFeatures ChannelInfo_get_features(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
7946 * Protocol features of a channel communicated during its announcement
7948 void ChannelInfo_set_features(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKChannelFeatures val);
7951 * Source node of the first direction of a channel
7953 struct LDKPublicKey ChannelInfo_get_node_one(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
7956 * Source node of the first direction of a channel
7958 void ChannelInfo_set_node_one(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7961 * Details about the first direction of a channel
7963 struct LDKDirectionalChannelInfo ChannelInfo_get_one_to_two(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
7966 * Details about the first direction of a channel
7968 void ChannelInfo_set_one_to_two(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKDirectionalChannelInfo val);
7971 * Source node of the second direction of a channel
7973 struct LDKPublicKey ChannelInfo_get_node_two(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
7976 * Source node of the second direction of a channel
7978 void ChannelInfo_set_node_two(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7981 * Details about the second direction of a channel
7983 struct LDKDirectionalChannelInfo ChannelInfo_get_two_to_one(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
7986 * Details about the second direction of a channel
7988 void ChannelInfo_set_two_to_one(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKDirectionalChannelInfo val);
7991 * An initial announcement of the channel
7992 * Mostly redundant with the data we store in fields explicitly.
7993 * Everything else is useful only for sending out for initial routing sync.
7994 * Not stored if contains excess data to prevent DoS.
7996 struct LDKChannelAnnouncement ChannelInfo_get_announcement_message(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
7999 * An initial announcement of the channel
8000 * Mostly redundant with the data we store in fields explicitly.
8001 * Everything else is useful only for sending out for initial routing sync.
8002 * Not stored if contains excess data to prevent DoS.
8004 void ChannelInfo_set_announcement_message(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKChannelAnnouncement val);
8006 LDKCVec_u8Z ChannelInfo_write(const struct LDKChannelInfo *NONNULL_PTR obj);
8008 struct LDKChannelInfo ChannelInfo_read(struct LDKu8slice ser);
8010 void RoutingFees_free(struct LDKRoutingFees this_ptr);
8012 struct LDKRoutingFees RoutingFees_clone(const struct LDKRoutingFees *NONNULL_PTR orig);
8015 * Flat routing fee in satoshis
8017 uint32_t RoutingFees_get_base_msat(const struct LDKRoutingFees *NONNULL_PTR this_ptr);
8020 * Flat routing fee in satoshis
8022 void RoutingFees_set_base_msat(struct LDKRoutingFees *NONNULL_PTR this_ptr, uint32_t val);
8025 * Liquidity-based routing fee in millionths of a routed amount.
8026 * In other words, 10000 is 1%.
8028 uint32_t RoutingFees_get_proportional_millionths(const struct LDKRoutingFees *NONNULL_PTR this_ptr);
8031 * Liquidity-based routing fee in millionths of a routed amount.
8032 * In other words, 10000 is 1%.
8034 void RoutingFees_set_proportional_millionths(struct LDKRoutingFees *NONNULL_PTR this_ptr, uint32_t val);
8036 MUST_USE_RES struct LDKRoutingFees RoutingFees_new(uint32_t base_msat_arg, uint32_t proportional_millionths_arg);
8038 LDKCResult_RoutingFeesDecodeErrorZ RoutingFees_read(struct LDKu8slice ser);
8040 LDKCVec_u8Z RoutingFees_write(const struct LDKRoutingFees *NONNULL_PTR obj);
8042 void NodeAnnouncementInfo_free(struct LDKNodeAnnouncementInfo this_ptr);
8045 * Protocol features the node announced support for
8047 struct LDKNodeFeatures NodeAnnouncementInfo_get_features(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr);
8050 * Protocol features the node announced support for
8052 void NodeAnnouncementInfo_set_features(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKNodeFeatures val);
8055 * When the last known update to the node state was issued.
8056 * Value is opaque, as set in the announcement.
8058 uint32_t NodeAnnouncementInfo_get_last_update(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr);
8061 * When the last known update to the node state was issued.
8062 * Value is opaque, as set in the announcement.
8064 void NodeAnnouncementInfo_set_last_update(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, uint32_t val);
8067 * Color assigned to the node
8069 const uint8_t (*NodeAnnouncementInfo_get_rgb(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr))[3];
8072 * Color assigned to the node
8074 void NodeAnnouncementInfo_set_rgb(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKThreeBytes val);
8077 * Moniker assigned to the node.
8078 * May be invalid or malicious (eg control chars),
8079 * should not be exposed to the user.
8081 const uint8_t (*NodeAnnouncementInfo_get_alias(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr))[32];
8084 * Moniker assigned to the node.
8085 * May be invalid or malicious (eg control chars),
8086 * should not be exposed to the user.
8088 void NodeAnnouncementInfo_set_alias(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
8091 * Internet-level addresses via which one can connect to the node
8093 void NodeAnnouncementInfo_set_addresses(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, LDKCVec_NetAddressZ val);
8096 * An initial announcement of the node
8097 * Mostly redundant with the data we store in fields explicitly.
8098 * Everything else is useful only for sending out for initial routing sync.
8099 * Not stored if contains excess data to prevent DoS.
8101 struct LDKNodeAnnouncement NodeAnnouncementInfo_get_announcement_message(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr);
8104 * An initial announcement of the node
8105 * Mostly redundant with the data we store in fields explicitly.
8106 * Everything else is useful only for sending out for initial routing sync.
8107 * Not stored if contains excess data to prevent DoS.
8109 void NodeAnnouncementInfo_set_announcement_message(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKNodeAnnouncement val);
8111 MUST_USE_RES struct LDKNodeAnnouncementInfo NodeAnnouncementInfo_new(struct LDKNodeFeatures features_arg, uint32_t last_update_arg, struct LDKThreeBytes rgb_arg, struct LDKThirtyTwoBytes alias_arg, LDKCVec_NetAddressZ addresses_arg, struct LDKNodeAnnouncement announcement_message_arg);
8113 LDKCVec_u8Z NodeAnnouncementInfo_write(const struct LDKNodeAnnouncementInfo *NONNULL_PTR obj);
8115 LDKCResult_NodeAnnouncementInfoDecodeErrorZ NodeAnnouncementInfo_read(struct LDKu8slice ser);
8117 void NodeInfo_free(struct LDKNodeInfo this_ptr);
8120 * All valid channels a node has announced
8122 void NodeInfo_set_channels(struct LDKNodeInfo *NONNULL_PTR this_ptr, LDKCVec_u64Z val);
8125 * Lowest fees enabling routing via any of the enabled, known channels to a node.
8126 * The two fields (flat and proportional fee) are independent,
8127 * meaning they don't have to refer to the same channel.
8129 struct LDKRoutingFees NodeInfo_get_lowest_inbound_channel_fees(const struct LDKNodeInfo *NONNULL_PTR this_ptr);
8132 * Lowest fees enabling routing via any of the enabled, known channels to a node.
8133 * The two fields (flat and proportional fee) are independent,
8134 * meaning they don't have to refer to the same channel.
8136 void NodeInfo_set_lowest_inbound_channel_fees(struct LDKNodeInfo *NONNULL_PTR this_ptr, struct LDKRoutingFees val);
8139 * More information about a node from node_announcement.
8140 * Optional because we store a Node entry after learning about it from
8141 * a channel announcement, but before receiving a node announcement.
8143 struct LDKNodeAnnouncementInfo NodeInfo_get_announcement_info(const struct LDKNodeInfo *NONNULL_PTR this_ptr);
8146 * More information about a node from node_announcement.
8147 * Optional because we store a Node entry after learning about it from
8148 * a channel announcement, but before receiving a node announcement.
8150 void NodeInfo_set_announcement_info(struct LDKNodeInfo *NONNULL_PTR this_ptr, struct LDKNodeAnnouncementInfo val);
8152 MUST_USE_RES struct LDKNodeInfo NodeInfo_new(LDKCVec_u64Z channels_arg, struct LDKRoutingFees lowest_inbound_channel_fees_arg, struct LDKNodeAnnouncementInfo announcement_info_arg);
8154 LDKCVec_u8Z NodeInfo_write(const struct LDKNodeInfo *NONNULL_PTR obj);
8156 LDKCResult_NodeInfoDecodeErrorZ NodeInfo_read(struct LDKu8slice ser);
8158 LDKCVec_u8Z NetworkGraph_write(const struct LDKNetworkGraph *NONNULL_PTR obj);
8160 LDKCResult_NetworkGraphDecodeErrorZ NetworkGraph_read(struct LDKu8slice ser);
8163 * Creates a new, empty, network graph.
8165 MUST_USE_RES struct LDKNetworkGraph NetworkGraph_new(struct LDKThirtyTwoBytes genesis_hash);
8168 * For an already known node (from channel announcements), update its stored properties from a
8169 * given node announcement.
8171 * You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
8172 * RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
8173 * routing messages from a source using a protocol other than the lightning P2P protocol.
8175 MUST_USE_RES LDKCResult_NoneLightningErrorZ NetworkGraph_update_node_from_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKNodeAnnouncement *NONNULL_PTR msg);
8178 * For an already known node (from channel announcements), update its stored properties from a
8179 * given node announcement without verifying the associated signatures. Because we aren't
8180 * given the associated signatures here we cannot relay the node announcement to any of our
8183 MUST_USE_RES LDKCResult_NoneLightningErrorZ NetworkGraph_update_node_from_unsigned_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR msg);
8186 * Store or update channel info from a channel announcement.
8188 * You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
8189 * RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
8190 * routing messages from a source using a protocol other than the lightning P2P protocol.
8192 * If a `chain::Access` object is provided via `chain_access`, it will be called to verify
8193 * the corresponding UTXO exists on chain and is correctly-formatted.
8195 MUST_USE_RES LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel_from_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKChannelAnnouncement *NONNULL_PTR msg, struct LDKAccess *chain_access);
8198 * Store or update channel info from a channel announcement without verifying the associated
8199 * signatures. Because we aren't given the associated signatures here we cannot relay the
8200 * channel announcement to any of our peers.
8202 * If a `chain::Access` object is provided via `chain_access`, it will be called to verify
8203 * the corresponding UTXO exists on chain and is correctly-formatted.
8205 MUST_USE_RES LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel_from_unsigned_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR msg, struct LDKAccess *chain_access);
8208 * Close a channel if a corresponding HTLC fail was sent.
8209 * If permanent, removes a channel from the local storage.
8210 * May cause the removal of nodes too, if this was their last channel.
8211 * If not permanent, makes channels unavailable for routing.
8213 void NetworkGraph_close_channel_from_update(struct LDKNetworkGraph *NONNULL_PTR this_arg, uint64_t short_channel_id, bool is_permanent);
8216 * For an already known (from announcement) channel, update info about one of the directions
8219 * You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
8220 * RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
8221 * routing messages from a source using a protocol other than the lightning P2P protocol.
8223 MUST_USE_RES LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKChannelUpdate *NONNULL_PTR msg);
8226 * For an already known (from announcement) channel, update info about one of the directions
8227 * of the channel without verifying the associated signatures. Because we aren't given the
8228 * associated signatures here we cannot relay the channel update to any of our peers.
8230 MUST_USE_RES LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel_unsigned(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKUnsignedChannelUpdate *NONNULL_PTR msg);
8232 /* Text to put at the end of the generated file */