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_TweakCheckFailed,
178 LDKSecp256k1Error_NotEnoughMemory,
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 LDKCVec_u8Z {
215 * A transaction output including a scriptPubKey and value.
216 * This type *does* own its own memory, so must be free'd appropriately.
218 typedef struct LDKTxOut {
219 struct LDKCVec_u8Z script_pubkey;
223 typedef struct LDKSecretKey {
227 typedef union LDKCResult_SecretKeyErrorZPtr {
228 struct LDKSecretKey *result;
229 enum LDKSecp256k1Error *err;
230 } LDKCResult_SecretKeyErrorZPtr;
232 typedef struct LDKCResult_SecretKeyErrorZ {
233 union LDKCResult_SecretKeyErrorZPtr contents;
235 } LDKCResult_SecretKeyErrorZ;
237 typedef struct LDKPublicKey {
238 uint8_t compressed_form[33];
241 typedef union LDKCResult_PublicKeyErrorZPtr {
242 struct LDKPublicKey *result;
243 enum LDKSecp256k1Error *err;
244 } LDKCResult_PublicKeyErrorZPtr;
246 typedef struct LDKCResult_PublicKeyErrorZ {
247 union LDKCResult_PublicKeyErrorZPtr contents;
249 } LDKCResult_PublicKeyErrorZ;
254 * The set of public keys which are used in the creation of one commitment transaction.
255 * These are derived from the channel base keys and per-commitment data.
257 * A broadcaster key is provided from potential broadcaster of the computed transaction.
258 * A countersignatory key is coming from a protocol participant unable to broadcast the
261 * These keys are assumed to be good, either because the code derived them from
262 * channel basepoints via the new function, or they were obtained via
263 * CommitmentTransaction.trust().keys() because we trusted the source of the
264 * pre-calculated keys.
266 typedef struct MUST_USE_STRUCT LDKTxCreationKeys {
268 * Nearly everywhere, inner must be non-null, however in places where
269 * the Rust equivalent takes an Option, it may be set to null to indicate None.
271 LDKnativeTxCreationKeys *inner;
278 * An error in decoding a message or struct.
280 typedef struct MUST_USE_STRUCT LDKDecodeError {
282 * Nearly everywhere, inner must be non-null, however in places where
283 * the Rust equivalent takes an Option, it may be set to null to indicate None.
285 LDKnativeDecodeError *inner;
289 typedef union LDKCResult_TxCreationKeysDecodeErrorZPtr {
290 struct LDKTxCreationKeys *result;
291 struct LDKDecodeError *err;
292 } LDKCResult_TxCreationKeysDecodeErrorZPtr;
294 typedef struct LDKCResult_TxCreationKeysDecodeErrorZ {
295 union LDKCResult_TxCreationKeysDecodeErrorZPtr contents;
297 } LDKCResult_TxCreationKeysDecodeErrorZ;
302 * One counterparty's public keys which do not change over the life of a channel.
304 typedef struct MUST_USE_STRUCT LDKChannelPublicKeys {
306 * Nearly everywhere, inner must be non-null, however in places where
307 * the Rust equivalent takes an Option, it may be set to null to indicate None.
309 LDKnativeChannelPublicKeys *inner;
311 } LDKChannelPublicKeys;
313 typedef union LDKCResult_ChannelPublicKeysDecodeErrorZPtr {
314 struct LDKChannelPublicKeys *result;
315 struct LDKDecodeError *err;
316 } LDKCResult_ChannelPublicKeysDecodeErrorZPtr;
318 typedef struct LDKCResult_ChannelPublicKeysDecodeErrorZ {
319 union LDKCResult_ChannelPublicKeysDecodeErrorZPtr contents;
321 } LDKCResult_ChannelPublicKeysDecodeErrorZ;
323 typedef union LDKCResult_TxCreationKeysErrorZPtr {
324 struct LDKTxCreationKeys *result;
325 enum LDKSecp256k1Error *err;
326 } LDKCResult_TxCreationKeysErrorZPtr;
328 typedef struct LDKCResult_TxCreationKeysErrorZ {
329 union LDKCResult_TxCreationKeysErrorZPtr contents;
331 } LDKCResult_TxCreationKeysErrorZ;
336 * Information about an HTLC as it appears in a commitment transaction
338 typedef struct MUST_USE_STRUCT LDKHTLCOutputInCommitment {
340 * Nearly everywhere, inner must be non-null, however in places where
341 * the Rust equivalent takes an Option, it may be set to null to indicate None.
343 LDKnativeHTLCOutputInCommitment *inner;
345 } LDKHTLCOutputInCommitment;
347 typedef union LDKCResult_HTLCOutputInCommitmentDecodeErrorZPtr {
348 struct LDKHTLCOutputInCommitment *result;
349 struct LDKDecodeError *err;
350 } LDKCResult_HTLCOutputInCommitmentDecodeErrorZPtr;
352 typedef struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ {
353 union LDKCResult_HTLCOutputInCommitmentDecodeErrorZPtr contents;
355 } LDKCResult_HTLCOutputInCommitmentDecodeErrorZ;
360 * Late-bound per-channel counterparty data used to build transactions.
362 typedef struct MUST_USE_STRUCT LDKCounterpartyChannelTransactionParameters {
364 * Nearly everywhere, inner must be non-null, however in places where
365 * the Rust equivalent takes an Option, it may be set to null to indicate None.
367 LDKnativeCounterpartyChannelTransactionParameters *inner;
369 } LDKCounterpartyChannelTransactionParameters;
371 typedef union LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZPtr {
372 struct LDKCounterpartyChannelTransactionParameters *result;
373 struct LDKDecodeError *err;
374 } LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZPtr;
376 typedef struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ {
377 union LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZPtr contents;
379 } LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ;
384 * Per-channel data used to build transactions in conjunction with the per-commitment data (CommitmentTransaction).
385 * The fields are organized by holder/counterparty.
387 * Normally, this is converted to the broadcaster/countersignatory-organized DirectedChannelTransactionParameters
388 * before use, via the as_holder_broadcastable and as_counterparty_broadcastable functions.
390 typedef struct MUST_USE_STRUCT LDKChannelTransactionParameters {
392 * Nearly everywhere, inner must be non-null, however in places where
393 * the Rust equivalent takes an Option, it may be set to null to indicate None.
395 LDKnativeChannelTransactionParameters *inner;
397 } LDKChannelTransactionParameters;
399 typedef union LDKCResult_ChannelTransactionParametersDecodeErrorZPtr {
400 struct LDKChannelTransactionParameters *result;
401 struct LDKDecodeError *err;
402 } LDKCResult_ChannelTransactionParametersDecodeErrorZPtr;
404 typedef struct LDKCResult_ChannelTransactionParametersDecodeErrorZ {
405 union LDKCResult_ChannelTransactionParametersDecodeErrorZPtr contents;
407 } LDKCResult_ChannelTransactionParametersDecodeErrorZ;
409 typedef struct LDKSignature {
410 uint8_t compact_form[64];
413 typedef struct LDKCVec_SignatureZ {
414 struct LDKSignature *data;
416 } LDKCVec_SignatureZ;
421 * Information needed to build and sign a holder's commitment transaction.
423 * The transaction is only signed once we are ready to broadcast.
425 typedef struct MUST_USE_STRUCT LDKHolderCommitmentTransaction {
427 * Nearly everywhere, inner must be non-null, however in places where
428 * the Rust equivalent takes an Option, it may be set to null to indicate None.
430 LDKnativeHolderCommitmentTransaction *inner;
432 } LDKHolderCommitmentTransaction;
434 typedef union LDKCResult_HolderCommitmentTransactionDecodeErrorZPtr {
435 struct LDKHolderCommitmentTransaction *result;
436 struct LDKDecodeError *err;
437 } LDKCResult_HolderCommitmentTransactionDecodeErrorZPtr;
439 typedef struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ {
440 union LDKCResult_HolderCommitmentTransactionDecodeErrorZPtr contents;
442 } LDKCResult_HolderCommitmentTransactionDecodeErrorZ;
447 * A pre-built Bitcoin commitment transaction and its txid.
449 typedef struct MUST_USE_STRUCT LDKBuiltCommitmentTransaction {
451 * Nearly everywhere, inner must be non-null, however in places where
452 * the Rust equivalent takes an Option, it may be set to null to indicate None.
454 LDKnativeBuiltCommitmentTransaction *inner;
456 } LDKBuiltCommitmentTransaction;
458 typedef union LDKCResult_BuiltCommitmentTransactionDecodeErrorZPtr {
459 struct LDKBuiltCommitmentTransaction *result;
460 struct LDKDecodeError *err;
461 } LDKCResult_BuiltCommitmentTransactionDecodeErrorZPtr;
463 typedef struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ {
464 union LDKCResult_BuiltCommitmentTransactionDecodeErrorZPtr contents;
466 } LDKCResult_BuiltCommitmentTransactionDecodeErrorZ;
471 * This class tracks the per-transaction information needed to build a commitment transaction and to
472 * actually build it and sign. It is used for holder transactions that we sign only when needed
473 * and for transactions we sign for the counterparty.
475 * This class can be used inside a signer implementation to generate a signature given the relevant
478 typedef struct MUST_USE_STRUCT LDKCommitmentTransaction {
480 * Nearly everywhere, inner must be non-null, however in places where
481 * the Rust equivalent takes an Option, it may be set to null to indicate None.
483 LDKnativeCommitmentTransaction *inner;
485 } LDKCommitmentTransaction;
487 typedef union LDKCResult_CommitmentTransactionDecodeErrorZPtr {
488 struct LDKCommitmentTransaction *result;
489 struct LDKDecodeError *err;
490 } LDKCResult_CommitmentTransactionDecodeErrorZPtr;
492 typedef struct LDKCResult_CommitmentTransactionDecodeErrorZ {
493 union LDKCResult_CommitmentTransactionDecodeErrorZPtr contents;
495 } LDKCResult_CommitmentTransactionDecodeErrorZ;
500 * A wrapper on CommitmentTransaction indicating that the derived fields (the built bitcoin
501 * transaction and the transaction creation keys) are trusted.
503 * See trust() and verify() functions on CommitmentTransaction.
505 * This structure implements Deref.
507 typedef struct MUST_USE_STRUCT LDKTrustedCommitmentTransaction {
509 * Nearly everywhere, inner must be non-null, however in places where
510 * the Rust equivalent takes an Option, it may be set to null to indicate None.
512 LDKnativeTrustedCommitmentTransaction *inner;
514 } LDKTrustedCommitmentTransaction;
516 typedef union LDKCResult_TrustedCommitmentTransactionNoneZPtr {
517 struct LDKTrustedCommitmentTransaction *result;
519 * Note that this value is always NULL, as there are no contents in the Err variant
522 } LDKCResult_TrustedCommitmentTransactionNoneZPtr;
524 typedef struct LDKCResult_TrustedCommitmentTransactionNoneZ {
525 union LDKCResult_TrustedCommitmentTransactionNoneZPtr contents;
527 } LDKCResult_TrustedCommitmentTransactionNoneZ;
529 typedef union LDKCResult_CVec_SignatureZNoneZPtr {
530 struct LDKCVec_SignatureZ *result;
532 * Note that this value is always NULL, as there are no contents in the Err variant
535 } LDKCResult_CVec_SignatureZNoneZPtr;
537 typedef struct LDKCResult_CVec_SignatureZNoneZ {
538 union LDKCResult_CVec_SignatureZNoneZPtr contents;
540 } LDKCResult_CVec_SignatureZNoneZ;
542 typedef struct LDKCVec_PublicKeyZ {
543 struct LDKPublicKey *data;
545 } LDKCVec_PublicKeyZ;
550 * Error for PeerManager errors. If you get one of these, you must disconnect the socket and
551 * generate no further read_event/write_buffer_space_avail/socket_disconnected calls for the
554 typedef struct MUST_USE_STRUCT LDKPeerHandleError {
556 * Nearly everywhere, inner must be non-null, however in places where
557 * the Rust equivalent takes an Option, it may be set to null to indicate None.
559 LDKnativePeerHandleError *inner;
561 } LDKPeerHandleError;
563 typedef union LDKCResult_CVec_u8ZPeerHandleErrorZPtr {
564 struct LDKCVec_u8Z *result;
565 struct LDKPeerHandleError *err;
566 } LDKCResult_CVec_u8ZPeerHandleErrorZPtr;
568 typedef struct LDKCResult_CVec_u8ZPeerHandleErrorZ {
569 union LDKCResult_CVec_u8ZPeerHandleErrorZPtr contents;
571 } LDKCResult_CVec_u8ZPeerHandleErrorZ;
573 typedef union LDKCResult_NonePeerHandleErrorZPtr {
575 * Note that this value is always NULL, as there are no contents in the OK variant
578 struct LDKPeerHandleError *err;
579 } LDKCResult_NonePeerHandleErrorZPtr;
581 typedef struct LDKCResult_NonePeerHandleErrorZ {
582 union LDKCResult_NonePeerHandleErrorZPtr contents;
584 } LDKCResult_NonePeerHandleErrorZ;
586 typedef union LDKCResult_boolPeerHandleErrorZPtr {
588 struct LDKPeerHandleError *err;
589 } LDKCResult_boolPeerHandleErrorZPtr;
591 typedef struct LDKCResult_boolPeerHandleErrorZ {
592 union LDKCResult_boolPeerHandleErrorZPtr contents;
594 } LDKCResult_boolPeerHandleErrorZ;
599 * Features used within an `init` message.
601 typedef struct MUST_USE_STRUCT LDKInitFeatures {
603 * Nearly everywhere, inner must be non-null, however in places where
604 * the Rust equivalent takes an Option, it may be set to null to indicate None.
606 LDKnativeInitFeatures *inner;
610 typedef union LDKCResult_InitFeaturesDecodeErrorZPtr {
611 struct LDKInitFeatures *result;
612 struct LDKDecodeError *err;
613 } LDKCResult_InitFeaturesDecodeErrorZPtr;
615 typedef struct LDKCResult_InitFeaturesDecodeErrorZ {
616 union LDKCResult_InitFeaturesDecodeErrorZPtr contents;
618 } LDKCResult_InitFeaturesDecodeErrorZ;
623 * Features used within a `node_announcement` message.
625 typedef struct MUST_USE_STRUCT LDKNodeFeatures {
627 * Nearly everywhere, inner must be non-null, however in places where
628 * the Rust equivalent takes an Option, it may be set to null to indicate None.
630 LDKnativeNodeFeatures *inner;
634 typedef union LDKCResult_NodeFeaturesDecodeErrorZPtr {
635 struct LDKNodeFeatures *result;
636 struct LDKDecodeError *err;
637 } LDKCResult_NodeFeaturesDecodeErrorZPtr;
639 typedef struct LDKCResult_NodeFeaturesDecodeErrorZ {
640 union LDKCResult_NodeFeaturesDecodeErrorZPtr contents;
642 } LDKCResult_NodeFeaturesDecodeErrorZ;
647 * Features used within a `channel_announcement` message.
649 typedef struct MUST_USE_STRUCT LDKChannelFeatures {
651 * Nearly everywhere, inner must be non-null, however in places where
652 * the Rust equivalent takes an Option, it may be set to null to indicate None.
654 LDKnativeChannelFeatures *inner;
656 } LDKChannelFeatures;
658 typedef union LDKCResult_ChannelFeaturesDecodeErrorZPtr {
659 struct LDKChannelFeatures *result;
660 struct LDKDecodeError *err;
661 } LDKCResult_ChannelFeaturesDecodeErrorZPtr;
663 typedef struct LDKCResult_ChannelFeaturesDecodeErrorZ {
664 union LDKCResult_ChannelFeaturesDecodeErrorZPtr contents;
666 } LDKCResult_ChannelFeaturesDecodeErrorZ;
671 * Options which apply on a per-channel basis and may change at runtime or based on negotiation
672 * with our counterparty.
674 typedef struct MUST_USE_STRUCT LDKChannelConfig {
676 * Nearly everywhere, inner must be non-null, however in places where
677 * the Rust equivalent takes an Option, it may be set to null to indicate None.
679 LDKnativeChannelConfig *inner;
683 typedef union LDKCResult_ChannelConfigDecodeErrorZPtr {
684 struct LDKChannelConfig *result;
685 struct LDKDecodeError *err;
686 } LDKCResult_ChannelConfigDecodeErrorZPtr;
688 typedef struct LDKCResult_ChannelConfigDecodeErrorZ {
689 union LDKCResult_ChannelConfigDecodeErrorZPtr contents;
691 } LDKCResult_ChannelConfigDecodeErrorZ;
696 * An Err type for failure to process messages.
698 typedef struct MUST_USE_STRUCT LDKLightningError {
700 * Nearly everywhere, inner must be non-null, however in places where
701 * the Rust equivalent takes an Option, it may be set to null to indicate None.
703 LDKnativeLightningError *inner;
707 typedef union LDKCResult_boolLightningErrorZPtr {
709 struct LDKLightningError *err;
710 } LDKCResult_boolLightningErrorZPtr;
712 typedef struct LDKCResult_boolLightningErrorZ {
713 union LDKCResult_boolLightningErrorZPtr contents;
715 } LDKCResult_boolLightningErrorZ;
720 * A channel_announcement message to be sent or received from a peer
722 typedef struct MUST_USE_STRUCT LDKChannelAnnouncement {
724 * Nearly everywhere, inner must be non-null, however in places where
725 * the Rust equivalent takes an Option, it may be set to null to indicate None.
727 LDKnativeChannelAnnouncement *inner;
729 } LDKChannelAnnouncement;
734 * A channel_update message to be sent or received from a peer
736 typedef struct MUST_USE_STRUCT LDKChannelUpdate {
738 * Nearly everywhere, inner must be non-null, however in places where
739 * the Rust equivalent takes an Option, it may be set to null to indicate None.
741 LDKnativeChannelUpdate *inner;
745 typedef struct LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ {
746 struct LDKChannelAnnouncement a;
747 struct LDKChannelUpdate b;
748 struct LDKChannelUpdate c;
749 } LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ;
751 typedef struct LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ {
752 struct LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ *data;
754 } LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ;
759 * A node_announcement message to be sent or received from a peer
761 typedef struct MUST_USE_STRUCT LDKNodeAnnouncement {
763 * Nearly everywhere, inner must be non-null, however in places where
764 * the Rust equivalent takes an Option, it may be set to null to indicate None.
766 LDKnativeNodeAnnouncement *inner;
768 } LDKNodeAnnouncement;
770 typedef struct LDKCVec_NodeAnnouncementZ {
771 struct LDKNodeAnnouncement *data;
773 } LDKCVec_NodeAnnouncementZ;
775 typedef union LDKCResult_NoneLightningErrorZPtr {
777 * Note that this value is always NULL, as there are no contents in the OK variant
780 struct LDKLightningError *err;
781 } LDKCResult_NoneLightningErrorZPtr;
783 typedef struct LDKCResult_NoneLightningErrorZ {
784 union LDKCResult_NoneLightningErrorZPtr contents;
786 } LDKCResult_NoneLightningErrorZ;
791 * An accept_channel message to be sent or received from a peer
793 typedef struct MUST_USE_STRUCT LDKAcceptChannel {
795 * Nearly everywhere, inner must be non-null, however in places where
796 * the Rust equivalent takes an Option, it may be set to null to indicate None.
798 LDKnativeAcceptChannel *inner;
805 * An open_channel message to be sent or received from a peer
807 typedef struct MUST_USE_STRUCT LDKOpenChannel {
809 * Nearly everywhere, inner must be non-null, however in places where
810 * the Rust equivalent takes an Option, it may be set to null to indicate None.
812 LDKnativeOpenChannel *inner;
819 * A funding_created message to be sent or received from a peer
821 typedef struct MUST_USE_STRUCT LDKFundingCreated {
823 * Nearly everywhere, inner must be non-null, however in places where
824 * the Rust equivalent takes an Option, it may be set to null to indicate None.
826 LDKnativeFundingCreated *inner;
833 * A funding_signed message to be sent or received from a peer
835 typedef struct MUST_USE_STRUCT LDKFundingSigned {
837 * Nearly everywhere, inner must be non-null, however in places where
838 * the Rust equivalent takes an Option, it may be set to null to indicate None.
840 LDKnativeFundingSigned *inner;
847 * A funding_locked message to be sent or received from a peer
849 typedef struct MUST_USE_STRUCT LDKFundingLocked {
851 * Nearly everywhere, inner must be non-null, however in places where
852 * the Rust equivalent takes an Option, it may be set to null to indicate None.
854 LDKnativeFundingLocked *inner;
861 * An announcement_signatures message to be sent or received from a peer
863 typedef struct MUST_USE_STRUCT LDKAnnouncementSignatures {
865 * Nearly everywhere, inner must be non-null, however in places where
866 * the Rust equivalent takes an Option, it may be set to null to indicate None.
868 LDKnativeAnnouncementSignatures *inner;
870 } LDKAnnouncementSignatures;
875 * Struct used to return values from revoke_and_ack messages, containing a bunch of commitment
876 * transaction updates if they were pending.
878 typedef struct MUST_USE_STRUCT LDKCommitmentUpdate {
880 * Nearly everywhere, inner must be non-null, however in places where
881 * the Rust equivalent takes an Option, it may be set to null to indicate None.
883 LDKnativeCommitmentUpdate *inner;
885 } LDKCommitmentUpdate;
890 * A revoke_and_ack message to be sent or received from a peer
892 typedef struct MUST_USE_STRUCT LDKRevokeAndACK {
894 * Nearly everywhere, inner must be non-null, however in places where
895 * the Rust equivalent takes an Option, it may be set to null to indicate None.
897 LDKnativeRevokeAndACK *inner;
904 * A closing_signed message to be sent or received from a peer
906 typedef struct MUST_USE_STRUCT LDKClosingSigned {
908 * Nearly everywhere, inner must be non-null, however in places where
909 * the Rust equivalent takes an Option, it may be set to null to indicate None.
911 LDKnativeClosingSigned *inner;
918 * A shutdown message to be sent or received from a peer
920 typedef struct MUST_USE_STRUCT LDKShutdown {
922 * Nearly everywhere, inner must be non-null, however in places where
923 * the Rust equivalent takes an Option, it may be set to null to indicate None.
925 LDKnativeShutdown *inner;
932 * A channel_reestablish message to be sent or received from a peer
934 typedef struct MUST_USE_STRUCT LDKChannelReestablish {
936 * Nearly everywhere, inner must be non-null, however in places where
937 * the Rust equivalent takes an Option, it may be set to null to indicate None.
939 LDKnativeChannelReestablish *inner;
941 } LDKChannelReestablish;
946 * An error message to be sent or received from a peer
948 typedef struct MUST_USE_STRUCT LDKErrorMessage {
950 * Nearly everywhere, inner must be non-null, however in places where
951 * the Rust equivalent takes an Option, it may be set to null to indicate None.
953 LDKnativeErrorMessage *inner;
958 * Used to put an error message in a LightningError
960 typedef enum LDKErrorAction_Tag {
962 * The peer took some action which made us think they were useless. Disconnect them.
964 LDKErrorAction_DisconnectPeer,
966 * The peer did something harmless that we weren't able to process, just log and ignore
968 LDKErrorAction_IgnoreError,
970 * The peer did something incorrect. Tell them.
972 LDKErrorAction_SendErrorMessage,
974 * Must be last for serialization purposes
976 LDKErrorAction_Sentinel,
977 } LDKErrorAction_Tag;
979 typedef struct LDKErrorAction_LDKDisconnectPeer_Body {
980 struct LDKErrorMessage msg;
981 } LDKErrorAction_LDKDisconnectPeer_Body;
983 typedef struct LDKErrorAction_LDKSendErrorMessage_Body {
984 struct LDKErrorMessage msg;
985 } LDKErrorAction_LDKSendErrorMessage_Body;
987 typedef struct MUST_USE_STRUCT LDKErrorAction {
988 LDKErrorAction_Tag tag;
990 LDKErrorAction_LDKDisconnectPeer_Body disconnect_peer;
991 LDKErrorAction_LDKSendErrorMessage_Body send_error_message;
996 * The information we received from a peer along the route of a payment we originated. This is
997 * returned by ChannelMessageHandler::handle_update_fail_htlc to be passed into
998 * RoutingMessageHandler::handle_htlc_fail_channel_update to update our network map.
1000 typedef enum LDKHTLCFailChannelUpdate_Tag {
1002 * We received an error which included a full ChannelUpdate message.
1004 LDKHTLCFailChannelUpdate_ChannelUpdateMessage,
1006 * We received an error which indicated only that a channel has been closed
1008 LDKHTLCFailChannelUpdate_ChannelClosed,
1010 * We received an error which indicated only that a node has failed
1012 LDKHTLCFailChannelUpdate_NodeFailure,
1014 * Must be last for serialization purposes
1016 LDKHTLCFailChannelUpdate_Sentinel,
1017 } LDKHTLCFailChannelUpdate_Tag;
1019 typedef struct LDKHTLCFailChannelUpdate_LDKChannelUpdateMessage_Body {
1020 struct LDKChannelUpdate msg;
1021 } LDKHTLCFailChannelUpdate_LDKChannelUpdateMessage_Body;
1023 typedef struct LDKHTLCFailChannelUpdate_LDKChannelClosed_Body {
1024 uint64_t short_channel_id;
1026 } LDKHTLCFailChannelUpdate_LDKChannelClosed_Body;
1028 typedef struct LDKHTLCFailChannelUpdate_LDKNodeFailure_Body {
1029 struct LDKPublicKey node_id;
1031 } LDKHTLCFailChannelUpdate_LDKNodeFailure_Body;
1033 typedef struct MUST_USE_STRUCT LDKHTLCFailChannelUpdate {
1034 LDKHTLCFailChannelUpdate_Tag tag;
1036 LDKHTLCFailChannelUpdate_LDKChannelUpdateMessage_Body channel_update_message;
1037 LDKHTLCFailChannelUpdate_LDKChannelClosed_Body channel_closed;
1038 LDKHTLCFailChannelUpdate_LDKNodeFailure_Body node_failure;
1040 } LDKHTLCFailChannelUpdate;
1045 * A query_channel_range message is used to query a peer for channel
1046 * UTXOs in a range of blocks. The recipient of a query makes a best
1047 * effort to reply to the query using one or more reply_channel_range
1050 typedef struct MUST_USE_STRUCT LDKQueryChannelRange {
1052 * Nearly everywhere, inner must be non-null, however in places where
1053 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1055 LDKnativeQueryChannelRange *inner;
1057 } LDKQueryChannelRange;
1062 * A query_short_channel_ids message is used to query a peer for
1063 * routing gossip messages related to one or more short_channel_ids.
1064 * The query recipient will reply with the latest, if available,
1065 * channel_announcement, channel_update and node_announcement messages
1066 * it maintains for the requested short_channel_ids followed by a
1067 * reply_short_channel_ids_end message. The short_channel_ids sent in
1068 * this query are encoded. We only support encoding_type=0 uncompressed
1069 * serialization and do not support encoding_type=1 zlib serialization.
1071 typedef struct MUST_USE_STRUCT LDKQueryShortChannelIds {
1073 * Nearly everywhere, inner must be non-null, however in places where
1074 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1076 LDKnativeQueryShortChannelIds *inner;
1078 } LDKQueryShortChannelIds;
1081 * An event generated by ChannelManager which indicates a message should be sent to a peer (or
1082 * broadcast to most peers).
1083 * These events are handled by PeerManager::process_events if you are using a PeerManager.
1085 typedef enum LDKMessageSendEvent_Tag {
1087 * Used to indicate that we've accepted a channel open and should send the accept_channel
1088 * message provided to the given peer.
1090 LDKMessageSendEvent_SendAcceptChannel,
1092 * Used to indicate that we've initiated a channel open and should send the open_channel
1093 * message provided to the given peer.
1095 LDKMessageSendEvent_SendOpenChannel,
1097 * Used to indicate that a funding_created message should be sent to the peer with the given node_id.
1099 LDKMessageSendEvent_SendFundingCreated,
1101 * Used to indicate that a funding_signed message should be sent to the peer with the given node_id.
1103 LDKMessageSendEvent_SendFundingSigned,
1105 * Used to indicate that a funding_locked message should be sent to the peer with the given node_id.
1107 LDKMessageSendEvent_SendFundingLocked,
1109 * Used to indicate that an announcement_signatures message should be sent to the peer with the given node_id.
1111 LDKMessageSendEvent_SendAnnouncementSignatures,
1113 * Used to indicate that a series of HTLC update messages, as well as a commitment_signed
1114 * message should be sent to the peer with the given node_id.
1116 LDKMessageSendEvent_UpdateHTLCs,
1118 * Used to indicate that a revoke_and_ack message should be sent to the peer with the given node_id.
1120 LDKMessageSendEvent_SendRevokeAndACK,
1122 * Used to indicate that a closing_signed message should be sent to the peer with the given node_id.
1124 LDKMessageSendEvent_SendClosingSigned,
1126 * Used to indicate that a shutdown message should be sent to the peer with the given node_id.
1128 LDKMessageSendEvent_SendShutdown,
1130 * Used to indicate that a channel_reestablish message should be sent to the peer with the given node_id.
1132 LDKMessageSendEvent_SendChannelReestablish,
1134 * Used to indicate that a channel_announcement and channel_update should be broadcast to all
1135 * peers (except the peer with node_id either msg.contents.node_id_1 or msg.contents.node_id_2).
1137 * Note that after doing so, you very likely (unless you did so very recently) want to call
1138 * ChannelManager::broadcast_node_announcement to trigger a BroadcastNodeAnnouncement event.
1139 * This ensures that any nodes which see our channel_announcement also have a relevant
1140 * node_announcement, including relevant feature flags which may be important for routing
1143 LDKMessageSendEvent_BroadcastChannelAnnouncement,
1145 * Used to indicate that a node_announcement should be broadcast to all peers.
1147 LDKMessageSendEvent_BroadcastNodeAnnouncement,
1149 * Used to indicate that a channel_update should be broadcast to all peers.
1151 LDKMessageSendEvent_BroadcastChannelUpdate,
1153 * Broadcast an error downstream to be handled
1155 LDKMessageSendEvent_HandleError,
1157 * When a payment fails we may receive updates back from the hop where it failed. In such
1158 * cases this event is generated so that we can inform the network graph of this information.
1160 LDKMessageSendEvent_PaymentFailureNetworkUpdate,
1162 * Query a peer for channels with funding transaction UTXOs in a block range.
1164 LDKMessageSendEvent_SendChannelRangeQuery,
1166 * Request routing gossip messages from a peer for a list of channels identified by
1167 * their short_channel_ids.
1169 LDKMessageSendEvent_SendShortIdsQuery,
1171 * Must be last for serialization purposes
1173 LDKMessageSendEvent_Sentinel,
1174 } LDKMessageSendEvent_Tag;
1176 typedef struct LDKMessageSendEvent_LDKSendAcceptChannel_Body {
1177 struct LDKPublicKey node_id;
1178 struct LDKAcceptChannel msg;
1179 } LDKMessageSendEvent_LDKSendAcceptChannel_Body;
1181 typedef struct LDKMessageSendEvent_LDKSendOpenChannel_Body {
1182 struct LDKPublicKey node_id;
1183 struct LDKOpenChannel msg;
1184 } LDKMessageSendEvent_LDKSendOpenChannel_Body;
1186 typedef struct LDKMessageSendEvent_LDKSendFundingCreated_Body {
1187 struct LDKPublicKey node_id;
1188 struct LDKFundingCreated msg;
1189 } LDKMessageSendEvent_LDKSendFundingCreated_Body;
1191 typedef struct LDKMessageSendEvent_LDKSendFundingSigned_Body {
1192 struct LDKPublicKey node_id;
1193 struct LDKFundingSigned msg;
1194 } LDKMessageSendEvent_LDKSendFundingSigned_Body;
1196 typedef struct LDKMessageSendEvent_LDKSendFundingLocked_Body {
1197 struct LDKPublicKey node_id;
1198 struct LDKFundingLocked msg;
1199 } LDKMessageSendEvent_LDKSendFundingLocked_Body;
1201 typedef struct LDKMessageSendEvent_LDKSendAnnouncementSignatures_Body {
1202 struct LDKPublicKey node_id;
1203 struct LDKAnnouncementSignatures msg;
1204 } LDKMessageSendEvent_LDKSendAnnouncementSignatures_Body;
1206 typedef struct LDKMessageSendEvent_LDKUpdateHTLCs_Body {
1207 struct LDKPublicKey node_id;
1208 struct LDKCommitmentUpdate updates;
1209 } LDKMessageSendEvent_LDKUpdateHTLCs_Body;
1211 typedef struct LDKMessageSendEvent_LDKSendRevokeAndACK_Body {
1212 struct LDKPublicKey node_id;
1213 struct LDKRevokeAndACK msg;
1214 } LDKMessageSendEvent_LDKSendRevokeAndACK_Body;
1216 typedef struct LDKMessageSendEvent_LDKSendClosingSigned_Body {
1217 struct LDKPublicKey node_id;
1218 struct LDKClosingSigned msg;
1219 } LDKMessageSendEvent_LDKSendClosingSigned_Body;
1221 typedef struct LDKMessageSendEvent_LDKSendShutdown_Body {
1222 struct LDKPublicKey node_id;
1223 struct LDKShutdown msg;
1224 } LDKMessageSendEvent_LDKSendShutdown_Body;
1226 typedef struct LDKMessageSendEvent_LDKSendChannelReestablish_Body {
1227 struct LDKPublicKey node_id;
1228 struct LDKChannelReestablish msg;
1229 } LDKMessageSendEvent_LDKSendChannelReestablish_Body;
1231 typedef struct LDKMessageSendEvent_LDKBroadcastChannelAnnouncement_Body {
1232 struct LDKChannelAnnouncement msg;
1233 struct LDKChannelUpdate update_msg;
1234 } LDKMessageSendEvent_LDKBroadcastChannelAnnouncement_Body;
1236 typedef struct LDKMessageSendEvent_LDKBroadcastNodeAnnouncement_Body {
1237 struct LDKNodeAnnouncement msg;
1238 } LDKMessageSendEvent_LDKBroadcastNodeAnnouncement_Body;
1240 typedef struct LDKMessageSendEvent_LDKBroadcastChannelUpdate_Body {
1241 struct LDKChannelUpdate msg;
1242 } LDKMessageSendEvent_LDKBroadcastChannelUpdate_Body;
1244 typedef struct LDKMessageSendEvent_LDKHandleError_Body {
1245 struct LDKPublicKey node_id;
1246 struct LDKErrorAction action;
1247 } LDKMessageSendEvent_LDKHandleError_Body;
1249 typedef struct LDKMessageSendEvent_LDKPaymentFailureNetworkUpdate_Body {
1250 struct LDKHTLCFailChannelUpdate update;
1251 } LDKMessageSendEvent_LDKPaymentFailureNetworkUpdate_Body;
1253 typedef struct LDKMessageSendEvent_LDKSendChannelRangeQuery_Body {
1254 struct LDKPublicKey node_id;
1255 struct LDKQueryChannelRange msg;
1256 } LDKMessageSendEvent_LDKSendChannelRangeQuery_Body;
1258 typedef struct LDKMessageSendEvent_LDKSendShortIdsQuery_Body {
1259 struct LDKPublicKey node_id;
1260 struct LDKQueryShortChannelIds msg;
1261 } LDKMessageSendEvent_LDKSendShortIdsQuery_Body;
1263 typedef struct MUST_USE_STRUCT LDKMessageSendEvent {
1264 LDKMessageSendEvent_Tag tag;
1266 LDKMessageSendEvent_LDKSendAcceptChannel_Body send_accept_channel;
1267 LDKMessageSendEvent_LDKSendOpenChannel_Body send_open_channel;
1268 LDKMessageSendEvent_LDKSendFundingCreated_Body send_funding_created;
1269 LDKMessageSendEvent_LDKSendFundingSigned_Body send_funding_signed;
1270 LDKMessageSendEvent_LDKSendFundingLocked_Body send_funding_locked;
1271 LDKMessageSendEvent_LDKSendAnnouncementSignatures_Body send_announcement_signatures;
1272 LDKMessageSendEvent_LDKUpdateHTLCs_Body update_htl_cs;
1273 LDKMessageSendEvent_LDKSendRevokeAndACK_Body send_revoke_and_ack;
1274 LDKMessageSendEvent_LDKSendClosingSigned_Body send_closing_signed;
1275 LDKMessageSendEvent_LDKSendShutdown_Body send_shutdown;
1276 LDKMessageSendEvent_LDKSendChannelReestablish_Body send_channel_reestablish;
1277 LDKMessageSendEvent_LDKBroadcastChannelAnnouncement_Body broadcast_channel_announcement;
1278 LDKMessageSendEvent_LDKBroadcastNodeAnnouncement_Body broadcast_node_announcement;
1279 LDKMessageSendEvent_LDKBroadcastChannelUpdate_Body broadcast_channel_update;
1280 LDKMessageSendEvent_LDKHandleError_Body handle_error;
1281 LDKMessageSendEvent_LDKPaymentFailureNetworkUpdate_Body payment_failure_network_update;
1282 LDKMessageSendEvent_LDKSendChannelRangeQuery_Body send_channel_range_query;
1283 LDKMessageSendEvent_LDKSendShortIdsQuery_Body send_short_ids_query;
1285 } LDKMessageSendEvent;
1287 typedef struct LDKCVec_MessageSendEventZ {
1288 struct LDKMessageSendEvent *data;
1290 } LDKCVec_MessageSendEventZ;
1295 * Details about one direction of a channel. Received
1296 * within a channel update.
1298 typedef struct MUST_USE_STRUCT LDKDirectionalChannelInfo {
1300 * Nearly everywhere, inner must be non-null, however in places where
1301 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1303 LDKnativeDirectionalChannelInfo *inner;
1305 } LDKDirectionalChannelInfo;
1307 typedef union LDKCResult_DirectionalChannelInfoDecodeErrorZPtr {
1308 struct LDKDirectionalChannelInfo *result;
1309 struct LDKDecodeError *err;
1310 } LDKCResult_DirectionalChannelInfoDecodeErrorZPtr;
1312 typedef struct LDKCResult_DirectionalChannelInfoDecodeErrorZ {
1313 union LDKCResult_DirectionalChannelInfoDecodeErrorZPtr contents;
1315 } LDKCResult_DirectionalChannelInfoDecodeErrorZ;
1320 * Details about a channel (both directions).
1321 * Received within a channel announcement.
1323 typedef struct MUST_USE_STRUCT LDKChannelInfo {
1325 * Nearly everywhere, inner must be non-null, however in places where
1326 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1328 LDKnativeChannelInfo *inner;
1332 typedef union LDKCResult_ChannelInfoDecodeErrorZPtr {
1333 struct LDKChannelInfo *result;
1334 struct LDKDecodeError *err;
1335 } LDKCResult_ChannelInfoDecodeErrorZPtr;
1337 typedef struct LDKCResult_ChannelInfoDecodeErrorZ {
1338 union LDKCResult_ChannelInfoDecodeErrorZPtr contents;
1340 } LDKCResult_ChannelInfoDecodeErrorZ;
1345 * Fees for routing via a given channel or a node
1347 typedef struct MUST_USE_STRUCT LDKRoutingFees {
1349 * Nearly everywhere, inner must be non-null, however in places where
1350 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1352 LDKnativeRoutingFees *inner;
1356 typedef union LDKCResult_RoutingFeesDecodeErrorZPtr {
1357 struct LDKRoutingFees *result;
1358 struct LDKDecodeError *err;
1359 } LDKCResult_RoutingFeesDecodeErrorZPtr;
1361 typedef struct LDKCResult_RoutingFeesDecodeErrorZ {
1362 union LDKCResult_RoutingFeesDecodeErrorZPtr contents;
1364 } LDKCResult_RoutingFeesDecodeErrorZ;
1366 typedef struct LDKFourBytes {
1370 typedef struct LDKSixteenBytes {
1374 typedef struct LDKTenBytes {
1379 * Arbitrary 32 bytes, which could represent one of a few different things. You probably want to
1380 * look up the corresponding function in rust-lightning's docs.
1382 typedef struct LDKThirtyTwoBytes {
1384 } LDKThirtyTwoBytes;
1387 * An address which can be used to connect to a remote peer
1389 typedef enum LDKNetAddress_Tag {
1391 * An IPv4 address/port on which the peer is listening.
1395 * An IPv6 address/port on which the peer is listening.
1399 * An old-style Tor onion address/port on which the peer is listening.
1401 LDKNetAddress_OnionV2,
1403 * A new-style Tor onion address/port on which the peer is listening.
1404 * To create the human-readable \"hostname\", concatenate ed25519_pubkey, checksum, and version,
1405 * wrap as base32 and append \".onion\".
1407 LDKNetAddress_OnionV3,
1409 * Must be last for serialization purposes
1411 LDKNetAddress_Sentinel,
1412 } LDKNetAddress_Tag;
1414 typedef struct LDKNetAddress_LDKIPv4_Body {
1415 struct LDKFourBytes addr;
1417 } LDKNetAddress_LDKIPv4_Body;
1419 typedef struct LDKNetAddress_LDKIPv6_Body {
1420 struct LDKSixteenBytes addr;
1422 } LDKNetAddress_LDKIPv6_Body;
1424 typedef struct LDKNetAddress_LDKOnionV2_Body {
1425 struct LDKTenBytes addr;
1427 } LDKNetAddress_LDKOnionV2_Body;
1429 typedef struct LDKNetAddress_LDKOnionV3_Body {
1430 struct LDKThirtyTwoBytes ed25519_pubkey;
1434 } LDKNetAddress_LDKOnionV3_Body;
1436 typedef struct MUST_USE_STRUCT LDKNetAddress {
1437 LDKNetAddress_Tag tag;
1439 LDKNetAddress_LDKIPv4_Body i_pv4;
1440 LDKNetAddress_LDKIPv6_Body i_pv6;
1441 LDKNetAddress_LDKOnionV2_Body onion_v2;
1442 LDKNetAddress_LDKOnionV3_Body onion_v3;
1446 typedef struct LDKCVec_NetAddressZ {
1447 struct LDKNetAddress *data;
1449 } LDKCVec_NetAddressZ;
1454 * Information received in the latest node_announcement from this node.
1456 typedef struct MUST_USE_STRUCT LDKNodeAnnouncementInfo {
1458 * Nearly everywhere, inner must be non-null, however in places where
1459 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1461 LDKnativeNodeAnnouncementInfo *inner;
1463 } LDKNodeAnnouncementInfo;
1465 typedef union LDKCResult_NodeAnnouncementInfoDecodeErrorZPtr {
1466 struct LDKNodeAnnouncementInfo *result;
1467 struct LDKDecodeError *err;
1468 } LDKCResult_NodeAnnouncementInfoDecodeErrorZPtr;
1470 typedef struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ {
1471 union LDKCResult_NodeAnnouncementInfoDecodeErrorZPtr contents;
1473 } LDKCResult_NodeAnnouncementInfoDecodeErrorZ;
1475 typedef struct LDKCVec_u64Z {
1483 * Details about a node in the network, known from the network announcement.
1485 typedef struct MUST_USE_STRUCT LDKNodeInfo {
1487 * Nearly everywhere, inner must be non-null, however in places where
1488 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1490 LDKnativeNodeInfo *inner;
1494 typedef union LDKCResult_NodeInfoDecodeErrorZPtr {
1495 struct LDKNodeInfo *result;
1496 struct LDKDecodeError *err;
1497 } LDKCResult_NodeInfoDecodeErrorZPtr;
1499 typedef struct LDKCResult_NodeInfoDecodeErrorZ {
1500 union LDKCResult_NodeInfoDecodeErrorZPtr contents;
1502 } LDKCResult_NodeInfoDecodeErrorZ;
1507 * Represents the network as nodes and channels between them
1509 typedef struct MUST_USE_STRUCT LDKNetworkGraph {
1511 * Nearly everywhere, inner must be non-null, however in places where
1512 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1514 LDKnativeNetworkGraph *inner;
1518 typedef union LDKCResult_NetworkGraphDecodeErrorZPtr {
1519 struct LDKNetworkGraph *result;
1520 struct LDKDecodeError *err;
1521 } LDKCResult_NetworkGraphDecodeErrorZPtr;
1523 typedef struct LDKCResult_NetworkGraphDecodeErrorZ {
1524 union LDKCResult_NetworkGraphDecodeErrorZPtr contents;
1526 } LDKCResult_NetworkGraphDecodeErrorZ;
1528 typedef struct LDKC2Tuple_usizeTransactionZ {
1530 struct LDKTransaction b;
1531 } LDKC2Tuple_usizeTransactionZ;
1533 typedef struct LDKCVec_C2Tuple_usizeTransactionZZ {
1534 struct LDKC2Tuple_usizeTransactionZ *data;
1536 } LDKCVec_C2Tuple_usizeTransactionZZ;
1538 typedef union LDKCResult_NoneChannelMonitorUpdateErrZPtr {
1540 * Note that this value is always NULL, as there are no contents in the OK variant
1543 enum LDKChannelMonitorUpdateErr *err;
1544 } LDKCResult_NoneChannelMonitorUpdateErrZPtr;
1546 typedef struct LDKCResult_NoneChannelMonitorUpdateErrZ {
1547 union LDKCResult_NoneChannelMonitorUpdateErrZPtr contents;
1549 } LDKCResult_NoneChannelMonitorUpdateErrZ;
1554 * Simple structure sent back by `chain::Watch` when an HTLC from a forward channel is detected on
1555 * chain. Used to update the corresponding HTLC in the backward channel. Failing to pass the
1556 * preimage claim backward will lead to loss of funds.
1558 * [`chain::Watch`]: ../trait.Watch.html
1560 typedef struct MUST_USE_STRUCT LDKHTLCUpdate {
1562 * Nearly everywhere, inner must be non-null, however in places where
1563 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1565 LDKnativeHTLCUpdate *inner;
1572 * A reference to a transaction output.
1574 * Differs from bitcoin::blockdata::transaction::OutPoint as the index is a u16 instead of u32
1575 * due to LN's restrictions on index values. Should reduce (possibly) unsafe conversions this way.
1577 typedef struct MUST_USE_STRUCT LDKOutPoint {
1579 * Nearly everywhere, inner must be non-null, however in places where
1580 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1582 LDKnativeOutPoint *inner;
1587 * An event to be processed by the ChannelManager.
1589 typedef enum LDKMonitorEvent_Tag {
1591 * A monitor event containing an HTLCUpdate.
1593 LDKMonitorEvent_HTLCEvent,
1595 * A monitor event that the Channel's commitment transaction was broadcasted.
1597 LDKMonitorEvent_CommitmentTxBroadcasted,
1599 * Must be last for serialization purposes
1601 LDKMonitorEvent_Sentinel,
1602 } LDKMonitorEvent_Tag;
1604 typedef struct MUST_USE_STRUCT LDKMonitorEvent {
1605 LDKMonitorEvent_Tag tag;
1608 struct LDKHTLCUpdate htlc_event;
1611 struct LDKOutPoint commitment_tx_broadcasted;
1616 typedef struct LDKCVec_MonitorEventZ {
1617 struct LDKMonitorEvent *data;
1619 } LDKCVec_MonitorEventZ;
1624 * Information about a spendable output to a P2WSH script. See
1625 * SpendableOutputDescriptor::DelayedPaymentOutput for more details on how to spend this.
1627 typedef struct MUST_USE_STRUCT LDKDelayedPaymentOutputDescriptor {
1629 * Nearly everywhere, inner must be non-null, however in places where
1630 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1632 LDKnativeDelayedPaymentOutputDescriptor *inner;
1634 } LDKDelayedPaymentOutputDescriptor;
1639 * Information about a spendable output to our \"payment key\". See
1640 * SpendableOutputDescriptor::StaticPaymentOutput for more details on how to spend this.
1642 typedef struct MUST_USE_STRUCT LDKStaticPaymentOutputDescriptor {
1644 * Nearly everywhere, inner must be non-null, however in places where
1645 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1647 LDKnativeStaticPaymentOutputDescriptor *inner;
1649 } LDKStaticPaymentOutputDescriptor;
1652 * When on-chain outputs are created by rust-lightning (which our counterparty is not able to
1653 * claim at any point in the future) an event is generated which you must track and be able to
1654 * spend on-chain. The information needed to do this is provided in this enum, including the
1655 * outpoint describing which txid and output index is available, the full output which exists at
1656 * that txid/index, and any keys or other information required to sign.
1658 typedef enum LDKSpendableOutputDescriptor_Tag {
1660 * An output to a script which was provided via KeysInterface directly, either from
1661 * `get_destination_script()` or `get_shutdown_pubkey()`, thus you should already know how to
1662 * spend it. No secret keys are provided as rust-lightning was never given any key.
1663 * These may include outputs from a transaction punishing our counterparty or claiming an HTLC
1664 * on-chain using the payment preimage or after it has timed out.
1666 LDKSpendableOutputDescriptor_StaticOutput,
1668 * An output to a P2WSH script which can be spent with a single signature after a CSV delay.
1670 * The witness in the spending input should be:
1671 * <BIP 143 signature> <empty vector> (MINIMALIF standard rule) <provided witnessScript>
1673 * Note that the nSequence field in the spending input must be set to to_self_delay
1674 * (which means the transaction is not broadcastable until at least to_self_delay
1675 * blocks after the outpoint confirms).
1677 * These are generally the result of a \"revocable\" output to us, spendable only by us unless
1678 * it is an output from an old state which we broadcast (which should never happen).
1680 * To derive the delayed_payment key which is used to sign for this input, you must pass the
1681 * holder delayed_payment_base_key (ie the private key which corresponds to the pubkey in
1682 * Sign::pubkeys().delayed_payment_basepoint) and the provided per_commitment_point to
1683 * chan_utils::derive_private_key. The public key can be generated without the secret key
1684 * using chan_utils::derive_public_key and only the delayed_payment_basepoint which appears in
1687 * To derive the revocation_pubkey provided here (which is used in the witness
1688 * script generation), you must pass the counterparty revocation_basepoint (which appears in the
1689 * call to Sign::ready_channel) and the provided per_commitment point
1690 * to chan_utils::derive_public_revocation_key.
1692 * The witness script which is hashed and included in the output script_pubkey may be
1693 * regenerated by passing the revocation_pubkey (derived as above), our delayed_payment pubkey
1694 * (derived as above), and the to_self_delay contained here to
1695 * chan_utils::get_revokeable_redeemscript.
1697 LDKSpendableOutputDescriptor_DelayedPaymentOutput,
1699 * An output to a P2WPKH, spendable exclusively by our payment key (ie the private key which
1700 * corresponds to the public key in Sign::pubkeys().payment_point).
1701 * The witness in the spending input, is, thus, simply:
1702 * <BIP 143 signature> <payment key>
1704 * These are generally the result of our counterparty having broadcast the current state,
1705 * allowing us to claim the non-HTLC-encumbered outputs immediately.
1707 LDKSpendableOutputDescriptor_StaticPaymentOutput,
1709 * Must be last for serialization purposes
1711 LDKSpendableOutputDescriptor_Sentinel,
1712 } LDKSpendableOutputDescriptor_Tag;
1714 typedef struct LDKSpendableOutputDescriptor_LDKStaticOutput_Body {
1715 struct LDKOutPoint outpoint;
1716 struct LDKTxOut output;
1717 } LDKSpendableOutputDescriptor_LDKStaticOutput_Body;
1719 typedef struct MUST_USE_STRUCT LDKSpendableOutputDescriptor {
1720 LDKSpendableOutputDescriptor_Tag tag;
1722 LDKSpendableOutputDescriptor_LDKStaticOutput_Body static_output;
1724 struct LDKDelayedPaymentOutputDescriptor delayed_payment_output;
1727 struct LDKStaticPaymentOutputDescriptor static_payment_output;
1730 } LDKSpendableOutputDescriptor;
1732 typedef struct LDKCVec_SpendableOutputDescriptorZ {
1733 struct LDKSpendableOutputDescriptor *data;
1735 } LDKCVec_SpendableOutputDescriptorZ;
1738 * An Event which you should probably take some action in response to.
1740 * Note that while Writeable and Readable are implemented for Event, you probably shouldn't use
1741 * them directly as they don't round-trip exactly (for example FundingGenerationReady is never
1742 * written as it makes no sense to respond to it after reconnecting to peers).
1744 typedef enum LDKEvent_Tag {
1746 * Used to indicate that the client should generate a funding transaction with the given
1747 * parameters and then call ChannelManager::funding_transaction_generated.
1748 * Generated in ChannelManager message handling.
1749 * Note that *all inputs* in the funding transaction must spend SegWit outputs or your
1750 * counterparty can steal your funds!
1752 LDKEvent_FundingGenerationReady,
1754 * Used to indicate that the client may now broadcast the funding transaction it created for a
1755 * channel. Broadcasting such a transaction prior to this event may lead to our counterparty
1756 * trivially stealing all funds in the funding transaction!
1758 LDKEvent_FundingBroadcastSafe,
1760 * Indicates we've received money! Just gotta dig out that payment preimage and feed it to
1761 * ChannelManager::claim_funds to get it....
1762 * Note that if the preimage is not known or the amount paid is incorrect, you should call
1763 * ChannelManager::fail_htlc_backwards to free up resources for this HTLC and avoid
1764 * network congestion.
1765 * The amount paid should be considered 'incorrect' when it is less than or more than twice
1766 * the amount expected.
1767 * If you fail to call either ChannelManager::claim_funds or
1768 * ChannelManager::fail_htlc_backwards within the HTLC's timeout, the HTLC will be
1769 * automatically failed.
1771 LDKEvent_PaymentReceived,
1773 * Indicates an outbound payment we made succeeded (ie it made it all the way to its target
1774 * and we got back the payment preimage for it).
1775 * Note that duplicative PaymentSent Events may be generated - it is your responsibility to
1776 * deduplicate them by payment_preimage (which MUST be unique)!
1778 LDKEvent_PaymentSent,
1780 * Indicates an outbound payment we made failed. Probably some intermediary node dropped
1781 * something. You may wish to retry with a different route.
1782 * Note that duplicative PaymentFailed Events may be generated - it is your responsibility to
1783 * deduplicate them by payment_hash (which MUST be unique)!
1785 LDKEvent_PaymentFailed,
1787 * Used to indicate that ChannelManager::process_pending_htlc_forwards should be called at a
1788 * time in the future.
1790 LDKEvent_PendingHTLCsForwardable,
1792 * Used to indicate that an output was generated on-chain which you should know how to spend.
1793 * Such an output will *not* ever be spent by rust-lightning, and are not at risk of your
1794 * counterparty spending them due to some kind of timeout. Thus, you need to store them
1795 * somewhere and spend them when you create on-chain transactions.
1797 LDKEvent_SpendableOutputs,
1799 * Must be last for serialization purposes
1804 typedef struct LDKEvent_LDKFundingGenerationReady_Body {
1805 struct LDKThirtyTwoBytes temporary_channel_id;
1806 uint64_t channel_value_satoshis;
1807 struct LDKCVec_u8Z output_script;
1808 uint64_t user_channel_id;
1809 } LDKEvent_LDKFundingGenerationReady_Body;
1811 typedef struct LDKEvent_LDKFundingBroadcastSafe_Body {
1812 struct LDKOutPoint funding_txo;
1813 uint64_t user_channel_id;
1814 } LDKEvent_LDKFundingBroadcastSafe_Body;
1816 typedef struct LDKEvent_LDKPaymentReceived_Body {
1817 struct LDKThirtyTwoBytes payment_hash;
1818 struct LDKThirtyTwoBytes payment_secret;
1820 } LDKEvent_LDKPaymentReceived_Body;
1822 typedef struct LDKEvent_LDKPaymentSent_Body {
1823 struct LDKThirtyTwoBytes payment_preimage;
1824 } LDKEvent_LDKPaymentSent_Body;
1826 typedef struct LDKEvent_LDKPaymentFailed_Body {
1827 struct LDKThirtyTwoBytes payment_hash;
1828 bool rejected_by_dest;
1829 } LDKEvent_LDKPaymentFailed_Body;
1831 typedef struct LDKEvent_LDKPendingHTLCsForwardable_Body {
1832 uint64_t time_forwardable;
1833 } LDKEvent_LDKPendingHTLCsForwardable_Body;
1835 typedef struct LDKEvent_LDKSpendableOutputs_Body {
1836 struct LDKCVec_SpendableOutputDescriptorZ outputs;
1837 } LDKEvent_LDKSpendableOutputs_Body;
1839 typedef struct MUST_USE_STRUCT LDKEvent {
1842 LDKEvent_LDKFundingGenerationReady_Body funding_generation_ready;
1843 LDKEvent_LDKFundingBroadcastSafe_Body funding_broadcast_safe;
1844 LDKEvent_LDKPaymentReceived_Body payment_received;
1845 LDKEvent_LDKPaymentSent_Body payment_sent;
1846 LDKEvent_LDKPaymentFailed_Body payment_failed;
1847 LDKEvent_LDKPendingHTLCsForwardable_Body pending_htl_cs_forwardable;
1848 LDKEvent_LDKSpendableOutputs_Body spendable_outputs;
1852 typedef struct LDKCVec_EventZ {
1853 struct LDKEvent *data;
1857 typedef union LDKCResult_OutPointDecodeErrorZPtr {
1858 struct LDKOutPoint *result;
1859 struct LDKDecodeError *err;
1860 } LDKCResult_OutPointDecodeErrorZPtr;
1862 typedef struct LDKCResult_OutPointDecodeErrorZ {
1863 union LDKCResult_OutPointDecodeErrorZPtr contents;
1865 } LDKCResult_OutPointDecodeErrorZ;
1870 * An update generated by the underlying Channel itself which contains some new information the
1871 * ChannelMonitor should be made aware of.
1873 typedef struct MUST_USE_STRUCT LDKChannelMonitorUpdate {
1875 * Nearly everywhere, inner must be non-null, however in places where
1876 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1878 LDKnativeChannelMonitorUpdate *inner;
1880 } LDKChannelMonitorUpdate;
1882 typedef union LDKCResult_ChannelMonitorUpdateDecodeErrorZPtr {
1883 struct LDKChannelMonitorUpdate *result;
1884 struct LDKDecodeError *err;
1885 } LDKCResult_ChannelMonitorUpdateDecodeErrorZPtr;
1887 typedef struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ {
1888 union LDKCResult_ChannelMonitorUpdateDecodeErrorZPtr contents;
1890 } LDKCResult_ChannelMonitorUpdateDecodeErrorZ;
1892 typedef union LDKCResult_HTLCUpdateDecodeErrorZPtr {
1893 struct LDKHTLCUpdate *result;
1894 struct LDKDecodeError *err;
1895 } LDKCResult_HTLCUpdateDecodeErrorZPtr;
1897 typedef struct LDKCResult_HTLCUpdateDecodeErrorZ {
1898 union LDKCResult_HTLCUpdateDecodeErrorZPtr contents;
1900 } LDKCResult_HTLCUpdateDecodeErrorZ;
1905 * General Err type for ChannelMonitor actions. Generally, this implies that the data provided is
1906 * inconsistent with the ChannelMonitor being called. eg for ChannelMonitor::update_monitor this
1907 * means you tried to update a monitor for a different channel or the ChannelMonitorUpdate was
1909 * Contains a developer-readable error message.
1911 typedef struct MUST_USE_STRUCT LDKMonitorUpdateError {
1913 * Nearly everywhere, inner must be non-null, however in places where
1914 * the Rust equivalent takes an Option, it may be set to null to indicate None.
1916 LDKnativeMonitorUpdateError *inner;
1918 } LDKMonitorUpdateError;
1920 typedef union LDKCResult_NoneMonitorUpdateErrorZPtr {
1922 * Note that this value is always NULL, as there are no contents in the OK variant
1925 struct LDKMonitorUpdateError *err;
1926 } LDKCResult_NoneMonitorUpdateErrorZPtr;
1928 typedef struct LDKCResult_NoneMonitorUpdateErrorZ {
1929 union LDKCResult_NoneMonitorUpdateErrorZPtr contents;
1931 } LDKCResult_NoneMonitorUpdateErrorZ;
1933 typedef struct LDKC2Tuple_OutPointScriptZ {
1934 struct LDKOutPoint a;
1935 struct LDKCVec_u8Z b;
1936 } LDKC2Tuple_OutPointScriptZ;
1938 typedef struct LDKCVec_TransactionZ {
1939 struct LDKTransaction *data;
1941 } LDKCVec_TransactionZ;
1943 typedef struct LDKC2Tuple_u32TxOutZ {
1946 } LDKC2Tuple_u32TxOutZ;
1948 typedef struct LDKCVec_C2Tuple_u32TxOutZZ {
1949 struct LDKC2Tuple_u32TxOutZ *data;
1951 } LDKCVec_C2Tuple_u32TxOutZZ;
1953 typedef struct LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ {
1954 struct LDKThirtyTwoBytes a;
1955 struct LDKCVec_C2Tuple_u32TxOutZZ b;
1956 } LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ;
1958 typedef struct LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ {
1959 struct LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ *data;
1961 } LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ;
1963 typedef struct LDKC2Tuple_SignatureCVec_SignatureZZ {
1964 struct LDKSignature a;
1965 struct LDKCVec_SignatureZ b;
1966 } LDKC2Tuple_SignatureCVec_SignatureZZ;
1968 typedef union LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZPtr {
1969 struct LDKC2Tuple_SignatureCVec_SignatureZZ *result;
1971 * Note that this value is always NULL, as there are no contents in the Err variant
1974 } LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZPtr;
1976 typedef struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ {
1977 union LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZPtr contents;
1979 } LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ;
1981 typedef union LDKCResult_SignatureNoneZPtr {
1982 struct LDKSignature *result;
1984 * Note that this value is always NULL, as there are no contents in the Err variant
1987 } LDKCResult_SignatureNoneZPtr;
1989 typedef struct LDKCResult_SignatureNoneZ {
1990 union LDKCResult_SignatureNoneZPtr contents;
1992 } LDKCResult_SignatureNoneZ;
1997 * The unsigned part of a channel_announcement
1999 typedef struct MUST_USE_STRUCT LDKUnsignedChannelAnnouncement {
2001 * Nearly everywhere, inner must be non-null, however in places where
2002 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2004 LDKnativeUnsignedChannelAnnouncement *inner;
2006 } LDKUnsignedChannelAnnouncement;
2009 * A trait to sign lightning channel transactions as described in BOLT 3.
2011 * Signing services could be implemented on a hardware wallet. In this case,
2012 * the current Sign would be a front-end on top of a communication
2013 * channel connected to your secure device and lightning key material wouldn't
2014 * reside on a hot server. Nevertheless, a this deployment would still need
2015 * to trust the ChannelManager to avoid loss of funds as this latest component
2016 * could ask to sign commitment transaction with HTLCs paying to attacker pubkeys.
2018 * A more secure iteration would be to use hashlock (or payment points) to pair
2019 * invoice/incoming HTLCs with outgoing HTLCs to implement a no-trust-ChannelManager
2020 * at the price of more state and computation on the hardware wallet side. In the future,
2021 * we are looking forward to design such interface.
2023 * In any case, ChannelMonitor or fallback watchtowers are always going to be trusted
2024 * to act, as liveness and breach reply correctness are always going to be hard requirements
2025 * of LN security model, orthogonal of key management issues.
2027 typedef struct LDKSign {
2030 * Gets the per-commitment point for a specific commitment number
2032 * Note that the commitment number starts at (1 << 48) - 1 and counts backwards.
2034 struct LDKPublicKey (*get_per_commitment_point)(const void *this_arg, uint64_t idx);
2036 * Gets the commitment secret for a specific commitment number as part of the revocation process
2038 * An external signer implementation should error here if the commitment was already signed
2039 * and should refuse to sign it in the future.
2041 * May be called more than once for the same index.
2043 * Note that the commitment number starts at (1 << 48) - 1 and counts backwards.
2045 struct LDKThirtyTwoBytes (*release_commitment_secret)(const void *this_arg, uint64_t idx);
2047 * Gets the holder's channel public keys and basepoints
2049 struct LDKChannelPublicKeys pubkeys;
2051 * Fill in the pubkeys field as a reference to it will be given to Rust after this returns
2052 * Note that this takes a pointer to this object, not the this_ptr like other methods do
2053 * This function pointer may be NULL if pubkeys is filled in when this object is created and never needs updating.
2055 void (*set_pubkeys)(const struct LDKSign*NONNULL_PTR );
2057 * Gets an arbitrary identifier describing the set of keys which are provided back to you in
2058 * some SpendableOutputDescriptor types. This should be sufficient to identify this
2059 * Sign object uniquely and lookup or re-derive its keys.
2061 struct LDKThirtyTwoBytes (*channel_keys_id)(const void *this_arg);
2063 * Create a signature for a counterparty's commitment transaction and associated HTLC transactions.
2065 * Note that if signing fails or is rejected, the channel will be force-closed.
2067 struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ (*sign_counterparty_commitment)(const void *this_arg, const struct LDKCommitmentTransaction *NONNULL_PTR commitment_tx);
2069 * Create a signatures for a holder's commitment transaction and its claiming HTLC transactions.
2070 * This will only ever be called with a non-revoked commitment_tx. This will be called with the
2071 * latest commitment_tx when we initiate a force-close.
2072 * This will be called with the previous latest, just to get claiming HTLC signatures, if we are
2073 * reacting to a ChannelMonitor replica that decided to broadcast before it had been updated to
2075 * This may be called multiple times for the same transaction.
2077 * An external signer implementation should check that the commitment has not been revoked.
2079 * May return Err if key derivation fails. Callers, such as ChannelMonitor, will panic in such a case.
2081 struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ (*sign_holder_commitment_and_htlcs)(const void *this_arg, const struct LDKHolderCommitmentTransaction *NONNULL_PTR commitment_tx);
2083 * Create a signature for the given input in a transaction spending an HTLC or commitment
2084 * transaction output when our counterparty broadcasts an old state.
2086 * A justice transaction may claim multiples outputs at the same time if timelocks are
2087 * similar, but only a signature for the input at index `input` should be signed for here.
2088 * It may be called multiples time for same output(s) if a fee-bump is needed with regards
2089 * to an upcoming timelock expiration.
2091 * Amount is value of the output spent by this input, committed to in the BIP 143 signature.
2093 * per_commitment_key is revocation secret which was provided by our counterparty when they
2094 * revoked the state which they eventually broadcast. It's not a _holder_ secret key and does
2095 * not allow the spending of any funds by itself (you need our holder revocation_secret to do
2098 * htlc holds HTLC elements (hash, timelock) if the output being spent is a HTLC output, thus
2099 * changing the format of the witness script (which is committed to in the BIP 143
2102 struct 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);
2104 * Create a signature for a claiming transaction for a HTLC output on a counterparty's commitment
2105 * transaction, either offered or received.
2107 * Such a transaction may claim multiples offered outputs at same time if we know the
2108 * preimage for each when we create it, but only the input at index `input` should be
2109 * signed for here. It may be called multiple times for same output(s) if a fee-bump is
2110 * needed with regards to an upcoming timelock expiration.
2112 * Witness_script is either a offered or received script as defined in BOLT3 for HTLC
2115 * Amount is value of the output spent by this input, committed to in the BIP 143 signature.
2117 * Per_commitment_point is the dynamic point corresponding to the channel state
2118 * detected onchain. It has been generated by our counterparty and is used to derive
2119 * channel state keys, which are then included in the witness script and committed to in the
2120 * BIP 143 signature.
2122 struct 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);
2124 * Create a signature for a (proposed) closing transaction.
2126 * Note that, due to rounding, there may be one \"missing\" satoshi, and either party may have
2127 * chosen to forgo their output as dust.
2129 struct LDKCResult_SignatureNoneZ (*sign_closing_transaction)(const void *this_arg, struct LDKTransaction closing_tx);
2131 * Signs a channel announcement message with our funding key, proving it comes from one
2132 * of the channel participants.
2134 * Note that if this fails or is rejected, the channel will not be publicly announced and
2135 * our counterparty may (though likely will not) close the channel on us for violating the
2138 struct LDKCResult_SignatureNoneZ (*sign_channel_announcement)(const void *this_arg, const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR msg);
2140 * Set the counterparty static channel data, including basepoints,
2141 * counterparty_selected/holder_selected_contest_delay and funding outpoint.
2142 * This is done as soon as the funding outpoint is known. Since these are static channel data,
2143 * they MUST NOT be allowed to change to different values once set.
2145 * channel_parameters.is_populated() MUST be true.
2147 * We bind holder_selected_contest_delay late here for API convenience.
2149 * Will be called before any signatures are applied.
2151 void (*ready_channel)(void *this_arg, const struct LDKChannelTransactionParameters *NONNULL_PTR channel_parameters);
2152 void *(*clone)(const void *this_arg);
2153 struct LDKCVec_u8Z (*write)(const void *this_arg);
2154 void (*free)(void *this_arg);
2160 * A ChannelMonitor handles chain events (blocks connected and disconnected) and generates
2161 * on-chain transactions to ensure no loss of funds occurs.
2163 * You MUST ensure that no ChannelMonitors for a given channel anywhere contain out-of-date
2164 * information and are actively monitoring the chain.
2166 * Pending Events or updated HTLCs which have not yet been read out by
2167 * get_and_clear_pending_monitor_events or get_and_clear_pending_events are serialized to disk and
2168 * reloaded at deserialize-time. Thus, you must ensure that, when handling events, all events
2169 * gotten are fully handled before re-serializing the new state.
2171 * Note that the deserializer is only implemented for (Sha256dHash, ChannelMonitor), which
2172 * tells you the last block hash which was block_connect()ed. You MUST rescan any blocks along
2173 * the \"reorg path\" (ie disconnecting blocks until you find a common ancestor from both the
2174 * returned block hash and the the current chain and then reconnecting blocks to get to the
2175 * best chain) upon deserializing the object!
2177 typedef struct MUST_USE_STRUCT LDKChannelMonitor {
2179 * Nearly everywhere, inner must be non-null, however in places where
2180 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2182 LDKnativeChannelMonitor *inner;
2184 } LDKChannelMonitor;
2186 typedef struct LDKC2Tuple_BlockHashChannelMonitorZ {
2187 struct LDKThirtyTwoBytes a;
2188 struct LDKChannelMonitor b;
2189 } LDKC2Tuple_BlockHashChannelMonitorZ;
2191 typedef union LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZPtr {
2192 struct LDKC2Tuple_BlockHashChannelMonitorZ *result;
2193 struct LDKDecodeError *err;
2194 } LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZPtr;
2196 typedef struct LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ {
2197 union LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZPtr contents;
2199 } LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ;
2201 typedef union LDKCResult_TxOutAccessErrorZPtr {
2202 struct LDKTxOut *result;
2203 enum LDKAccessError *err;
2204 } LDKCResult_TxOutAccessErrorZPtr;
2206 typedef struct LDKCResult_TxOutAccessErrorZ {
2207 union LDKCResult_TxOutAccessErrorZPtr contents;
2209 } LDKCResult_TxOutAccessErrorZ;
2212 * A Rust str object, ie a reference to a UTF8-valid string.
2213 * This is *not* null-terminated so cannot be used directly as a C string!
2215 typedef struct LDKStr {
2216 const uint8_t *chars;
2221 * Indicates an error on the client's part (usually some variant of attempting to use too-low or
2224 typedef enum LDKAPIError_Tag {
2226 * Indicates the API was wholly misused (see err for more). Cases where these can be returned
2227 * are documented, but generally indicates some precondition of a function was violated.
2229 LDKAPIError_APIMisuseError,
2231 * Due to a high feerate, we were unable to complete the request.
2232 * For example, this may be returned if the feerate implies we cannot open a channel at the
2233 * requested value, but opening a larger channel would succeed.
2235 LDKAPIError_FeeRateTooHigh,
2237 * A malformed Route was provided (eg overflowed value, node id mismatch, overly-looped route,
2238 * too-many-hops, etc).
2240 LDKAPIError_RouteError,
2242 * We were unable to complete the request as the Channel required to do so is unable to
2243 * complete the request (or was not found). This can take many forms, including disconnected
2244 * peer, channel at capacity, channel shutting down, etc.
2246 LDKAPIError_ChannelUnavailable,
2248 * An attempt to call watch/update_channel returned an Err (ie you did this!), causing the
2249 * attempted action to fail.
2251 LDKAPIError_MonitorUpdateFailed,
2253 * Must be last for serialization purposes
2255 LDKAPIError_Sentinel,
2258 typedef struct LDKAPIError_LDKAPIMisuseError_Body {
2259 struct LDKCVec_u8Z err;
2260 } LDKAPIError_LDKAPIMisuseError_Body;
2262 typedef struct LDKAPIError_LDKFeeRateTooHigh_Body {
2263 struct LDKCVec_u8Z err;
2265 } LDKAPIError_LDKFeeRateTooHigh_Body;
2267 typedef struct LDKAPIError_LDKRouteError_Body {
2269 } LDKAPIError_LDKRouteError_Body;
2271 typedef struct LDKAPIError_LDKChannelUnavailable_Body {
2272 struct LDKCVec_u8Z err;
2273 } LDKAPIError_LDKChannelUnavailable_Body;
2275 typedef struct MUST_USE_STRUCT LDKAPIError {
2276 LDKAPIError_Tag tag;
2278 LDKAPIError_LDKAPIMisuseError_Body api_misuse_error;
2279 LDKAPIError_LDKFeeRateTooHigh_Body fee_rate_too_high;
2280 LDKAPIError_LDKRouteError_Body route_error;
2281 LDKAPIError_LDKChannelUnavailable_Body channel_unavailable;
2285 typedef union LDKCResult_NoneAPIErrorZPtr {
2287 * Note that this value is always NULL, as there are no contents in the OK variant
2290 struct LDKAPIError *err;
2291 } LDKCResult_NoneAPIErrorZPtr;
2293 typedef struct LDKCResult_NoneAPIErrorZ {
2294 union LDKCResult_NoneAPIErrorZPtr contents;
2296 } LDKCResult_NoneAPIErrorZ;
2298 typedef struct LDKCVec_CResult_NoneAPIErrorZZ {
2299 struct LDKCResult_NoneAPIErrorZ *data;
2301 } LDKCVec_CResult_NoneAPIErrorZZ;
2303 typedef struct LDKCVec_APIErrorZ {
2304 struct LDKAPIError *data;
2306 } LDKCVec_APIErrorZ;
2311 * Details of a channel, as returned by ChannelManager::list_channels and ChannelManager::list_usable_channels
2313 typedef struct MUST_USE_STRUCT LDKChannelDetails {
2315 * Nearly everywhere, inner must be non-null, however in places where
2316 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2318 LDKnativeChannelDetails *inner;
2320 } LDKChannelDetails;
2322 typedef struct LDKCVec_ChannelDetailsZ {
2323 struct LDKChannelDetails *data;
2325 } LDKCVec_ChannelDetailsZ;
2328 * If a payment fails to send, it can be in one of several states. This enum is returned as the
2329 * Err() type describing which state the payment is in, see the description of individual enum
2332 typedef enum LDKPaymentSendFailure_Tag {
2334 * A parameter which was passed to send_payment was invalid, preventing us from attempting to
2335 * send the payment at all. No channel state has been changed or messages sent to peers, and
2336 * once you've changed the parameter at error, you can freely retry the payment in full.
2338 LDKPaymentSendFailure_ParameterError,
2340 * A parameter in a single path which was passed to send_payment was invalid, preventing us
2341 * from attempting to send the payment at all. No channel state has been changed or messages
2342 * sent to peers, and once you've changed the parameter at error, you can freely retry the
2345 * The results here are ordered the same as the paths in the route object which was passed to
2348 LDKPaymentSendFailure_PathParameterError,
2350 * All paths which were attempted failed to send, with no channel state change taking place.
2351 * You can freely retry the payment in full (though you probably want to do so over different
2352 * paths than the ones selected).
2354 LDKPaymentSendFailure_AllFailedRetrySafe,
2356 * Some paths which were attempted failed to send, though possibly not all. At least some
2357 * paths have irrevocably committed to the HTLC and retrying the payment in full would result
2358 * in over-/re-payment.
2360 * The results here are ordered the same as the paths in the route object which was passed to
2361 * send_payment, and any Errs which are not APIError::MonitorUpdateFailed can be safely
2362 * retried (though there is currently no API with which to do so).
2364 * Any entries which contain Err(APIError::MonitorUpdateFailed) or Ok(()) MUST NOT be retried
2365 * as they will result in over-/re-payment. These HTLCs all either successfully sent (in the
2366 * case of Ok(())) or will send once channel_monitor_updated is called on the next-hop channel
2367 * with the latest update_id.
2369 LDKPaymentSendFailure_PartialFailure,
2371 * Must be last for serialization purposes
2373 LDKPaymentSendFailure_Sentinel,
2374 } LDKPaymentSendFailure_Tag;
2376 typedef struct MUST_USE_STRUCT LDKPaymentSendFailure {
2377 LDKPaymentSendFailure_Tag tag;
2380 struct LDKAPIError parameter_error;
2383 struct LDKCVec_CResult_NoneAPIErrorZZ path_parameter_error;
2386 struct LDKCVec_APIErrorZ all_failed_retry_safe;
2389 struct LDKCVec_CResult_NoneAPIErrorZZ partial_failure;
2392 } LDKPaymentSendFailure;
2394 typedef union LDKCResult_NonePaymentSendFailureZPtr {
2396 * Note that this value is always NULL, as there are no contents in the OK variant
2399 struct LDKPaymentSendFailure *err;
2400 } LDKCResult_NonePaymentSendFailureZPtr;
2402 typedef struct LDKCResult_NonePaymentSendFailureZ {
2403 union LDKCResult_NonePaymentSendFailureZPtr contents;
2405 } LDKCResult_NonePaymentSendFailureZ;
2407 typedef struct LDKCVec_ChannelMonitorZ {
2408 struct LDKChannelMonitor *data;
2410 } LDKCVec_ChannelMonitorZ;
2413 * The `Watch` trait defines behavior for watching on-chain activity pertaining to channels as
2414 * blocks are connected and disconnected.
2416 * Each channel is associated with a [`ChannelMonitor`]. Implementations of this trait are
2417 * responsible for maintaining a set of monitors such that they can be updated accordingly as
2418 * channel state changes and HTLCs are resolved. See method documentation for specific
2421 * Implementations **must** ensure that updates are successfully applied and persisted upon method
2422 * completion. If an update fails with a [`PermanentFailure`], then it must immediately shut down
2423 * without taking any further action such as persisting the current state.
2425 * If an implementation maintains multiple instances of a channel's monitor (e.g., by storing
2426 * backup copies), then it must ensure that updates are applied across all instances. Otherwise, it
2427 * could result in a revoked transaction being broadcast, allowing the counterparty to claim all
2428 * funds in the channel. See [`ChannelMonitorUpdateErr`] for more details about how to handle
2429 * multiple instances.
2431 * [`ChannelMonitor`]: channelmonitor/struct.ChannelMonitor.html
2432 * [`ChannelMonitorUpdateErr`]: channelmonitor/enum.ChannelMonitorUpdateErr.html
2433 * [`PermanentFailure`]: channelmonitor/enum.ChannelMonitorUpdateErr.html#variant.PermanentFailure
2435 typedef struct LDKWatch {
2438 * Watches a channel identified by `funding_txo` using `monitor`.
2440 * Implementations are responsible for watching the chain for the funding transaction along
2441 * with any spends of outputs returned by [`get_outputs_to_watch`]. In practice, this means
2442 * calling [`block_connected`] and [`block_disconnected`] on the monitor.
2444 * [`get_outputs_to_watch`]: channelmonitor/struct.ChannelMonitor.html#method.get_outputs_to_watch
2445 * [`block_connected`]: channelmonitor/struct.ChannelMonitor.html#method.block_connected
2446 * [`block_disconnected`]: channelmonitor/struct.ChannelMonitor.html#method.block_disconnected
2448 struct LDKCResult_NoneChannelMonitorUpdateErrZ (*watch_channel)(const void *this_arg, struct LDKOutPoint funding_txo, struct LDKChannelMonitor monitor);
2450 * Updates a channel identified by `funding_txo` by applying `update` to its monitor.
2452 * Implementations must call [`update_monitor`] with the given update. See
2453 * [`ChannelMonitorUpdateErr`] for invariants around returning an error.
2455 * [`update_monitor`]: channelmonitor/struct.ChannelMonitor.html#method.update_monitor
2456 * [`ChannelMonitorUpdateErr`]: channelmonitor/enum.ChannelMonitorUpdateErr.html
2458 struct LDKCResult_NoneChannelMonitorUpdateErrZ (*update_channel)(const void *this_arg, struct LDKOutPoint funding_txo, struct LDKChannelMonitorUpdate update);
2460 * Returns any monitor events since the last call. Subsequent calls must only return new
2463 struct LDKCVec_MonitorEventZ (*release_pending_monitor_events)(const void *this_arg);
2464 void (*free)(void *this_arg);
2468 * An interface to send a transaction to the Bitcoin network.
2470 typedef struct LDKBroadcasterInterface {
2473 * Sends a transaction out to (hopefully) be mined.
2475 void (*broadcast_transaction)(const void *this_arg, struct LDKTransaction tx);
2476 void (*free)(void *this_arg);
2477 } LDKBroadcasterInterface;
2479 typedef union LDKCResult_SignDecodeErrorZPtr {
2480 struct LDKSign *result;
2481 struct LDKDecodeError *err;
2482 } LDKCResult_SignDecodeErrorZPtr;
2484 typedef struct LDKCResult_SignDecodeErrorZ {
2485 union LDKCResult_SignDecodeErrorZPtr contents;
2487 } LDKCResult_SignDecodeErrorZ;
2489 typedef struct LDKu8slice {
2490 const uint8_t *data;
2495 * A trait to describe an object which can get user secrets and key material.
2497 typedef struct LDKKeysInterface {
2500 * Get node secret key (aka node_id or network_key).
2502 * This method must return the same value each time it is called.
2504 struct LDKSecretKey (*get_node_secret)(const void *this_arg);
2506 * Get a script pubkey which we send funds to when claiming on-chain contestable outputs.
2508 * This method should return a different value each time it is called, to avoid linking
2509 * on-chain funds across channels as controlled to the same user.
2511 struct LDKCVec_u8Z (*get_destination_script)(const void *this_arg);
2513 * Get a public key which we will send funds to (in the form of a P2WPKH output) when closing
2516 * This method should return a different value each time it is called, to avoid linking
2517 * on-chain funds across channels as controlled to the same user.
2519 struct LDKPublicKey (*get_shutdown_pubkey)(const void *this_arg);
2521 * Get a new set of Sign for per-channel secrets. These MUST be unique even if you
2522 * restarted with some stale data!
2524 * This method must return a different value each time it is called.
2526 struct LDKSign (*get_channel_signer)(const void *this_arg, bool inbound, uint64_t channel_value_satoshis);
2528 * Gets a unique, cryptographically-secure, random 32 byte value. This is used for encrypting
2529 * onion packets and for temporary channel IDs. There is no requirement that these be
2530 * persisted anywhere, though they must be unique across restarts.
2532 * This method must return a different value each time it is called.
2534 struct LDKThirtyTwoBytes (*get_secure_random_bytes)(const void *this_arg);
2536 * Reads a `Signer` for this `KeysInterface` from the given input stream.
2537 * This is only called during deserialization of other objects which contain
2538 * `Sign`-implementing objects (ie `ChannelMonitor`s and `ChannelManager`s).
2539 * The bytes are exactly those which `<Self::Signer as Writeable>::write()` writes, and
2540 * contain no versioning scheme. You may wish to include your own version prefix and ensure
2541 * you've read all of the provided bytes to ensure no corruption occurred.
2543 struct LDKCResult_SignDecodeErrorZ (*read_chan_signer)(const void *this_arg, struct LDKu8slice reader);
2544 void (*free)(void *this_arg);
2548 * A trait which should be implemented to provide feerate information on a number of time
2551 * Note that all of the functions implemented here *must* be reentrant-safe (obviously - they're
2552 * called from inside the library in response to chain events, P2P events, or timer events).
2554 typedef struct LDKFeeEstimator {
2557 * Gets estimated satoshis of fee required per 1000 Weight-Units.
2559 * Must be no smaller than 253 (ie 1 satoshi-per-byte rounded up to ensure later round-downs
2560 * don't put us below 1 satoshi-per-byte).
2562 * This translates to:
2563 * * satoshis-per-byte * 250
2564 * * ceil(satoshis-per-kbyte / 4)
2566 uint32_t (*get_est_sat_per_1000_weight)(const void *this_arg, enum LDKConfirmationTarget confirmation_target);
2567 void (*free)(void *this_arg);
2571 * A trait encapsulating the operations required of a logger
2573 typedef struct LDKLogger {
2578 void (*log)(const void *this_arg, const char *record);
2579 void (*free)(void *this_arg);
2585 * Manager which keeps track of a number of channels and sends messages to the appropriate
2586 * channel, also tracking HTLC preimages and forwarding onion packets appropriately.
2588 * Implements ChannelMessageHandler, handling the multi-channel parts and passing things through
2589 * to individual Channels.
2591 * Implements Writeable to write out all channel state to disk. Implies peer_disconnected() for
2592 * all peers during write/read (though does not modify this instance, only the instance being
2593 * serialized). This will result in any channels which have not yet exchanged funding_created (ie
2594 * called funding_transaction_generated for outbound channels).
2596 * Note that you can be a bit lazier about writing out ChannelManager than you can be with
2597 * ChannelMonitors. With ChannelMonitors you MUST write each monitor update out to disk before
2598 * returning from chain::Watch::watch_/update_channel, with ChannelManagers, writing updates
2599 * happens out-of-band (and will prevent any other ChannelManager operations from occurring during
2600 * the serialization process). If the deserialized version is out-of-date compared to the
2601 * ChannelMonitors passed by reference to read(), those channels will be force-closed based on the
2602 * ChannelMonitor state and no funds will be lost (mod on-chain transaction fees).
2604 * Note that the deserializer is only implemented for (Sha256dHash, ChannelManager), which
2605 * tells you the last block hash which was block_connect()ed. You MUST rescan any blocks along
2606 * the \"reorg path\" (ie call block_disconnected() until you get to a common block and then call
2607 * block_connected() to step towards your best block) upon deserialization before using the
2610 * Note that ChannelManager is responsible for tracking liveness of its channels and generating
2611 * ChannelUpdate messages informing peers that the channel is temporarily disabled. To avoid
2612 * spam due to quick disconnection/reconnection, updates are not sent until the channel has been
2613 * offline for a full minute. In order to track this, you must call
2614 * timer_chan_freshness_every_min roughly once per minute, though it doesn't have to be perfect.
2616 * Rather than using a plain ChannelManager, it is preferable to use either a SimpleArcChannelManager
2617 * a SimpleRefChannelManager, for conciseness. See their documentation for more details, but
2618 * essentially you should default to using a SimpleRefChannelManager, and use a
2619 * SimpleArcChannelManager when you require a ChannelManager with a static lifetime, such as when
2620 * you're using lightning-net-tokio.
2622 typedef struct MUST_USE_STRUCT LDKChannelManager {
2624 * Nearly everywhere, inner must be non-null, however in places where
2625 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2627 LDKnativeChannelManager *inner;
2629 } LDKChannelManager;
2631 typedef struct LDKC2Tuple_BlockHashChannelManagerZ {
2632 struct LDKThirtyTwoBytes a;
2633 struct LDKChannelManager b;
2634 } LDKC2Tuple_BlockHashChannelManagerZ;
2636 typedef union LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZPtr {
2637 struct LDKC2Tuple_BlockHashChannelManagerZ *result;
2638 struct LDKDecodeError *err;
2639 } LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZPtr;
2641 typedef struct LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ {
2642 union LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZPtr contents;
2644 } LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ;
2646 typedef union LDKCResult_SpendableOutputDescriptorDecodeErrorZPtr {
2647 struct LDKSpendableOutputDescriptor *result;
2648 struct LDKDecodeError *err;
2649 } LDKCResult_SpendableOutputDescriptorDecodeErrorZPtr;
2651 typedef struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ {
2652 union LDKCResult_SpendableOutputDescriptorDecodeErrorZPtr contents;
2654 } LDKCResult_SpendableOutputDescriptorDecodeErrorZ;
2656 typedef struct LDKCVec_CVec_u8ZZ {
2657 struct LDKCVec_u8Z *data;
2659 } LDKCVec_CVec_u8ZZ;
2661 typedef union LDKCResult_CVec_CVec_u8ZZNoneZPtr {
2662 struct LDKCVec_CVec_u8ZZ *result;
2664 * Note that this value is always NULL, as there are no contents in the Err variant
2667 } LDKCResult_CVec_CVec_u8ZZNoneZPtr;
2669 typedef struct LDKCResult_CVec_CVec_u8ZZNoneZ {
2670 union LDKCResult_CVec_CVec_u8ZZNoneZPtr contents;
2672 } LDKCResult_CVec_CVec_u8ZZNoneZ;
2677 * A simple implementation of Sign that just keeps the private keys in memory.
2679 * This implementation performs no policy checks and is insufficient by itself as
2680 * a secure external signer.
2682 typedef struct MUST_USE_STRUCT LDKInMemorySigner {
2684 * Nearly everywhere, inner must be non-null, however in places where
2685 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2687 LDKnativeInMemorySigner *inner;
2689 } LDKInMemorySigner;
2691 typedef union LDKCResult_InMemorySignerDecodeErrorZPtr {
2692 struct LDKInMemorySigner *result;
2693 struct LDKDecodeError *err;
2694 } LDKCResult_InMemorySignerDecodeErrorZPtr;
2696 typedef struct LDKCResult_InMemorySignerDecodeErrorZ {
2697 union LDKCResult_InMemorySignerDecodeErrorZPtr contents;
2699 } LDKCResult_InMemorySignerDecodeErrorZ;
2701 typedef struct LDKCVec_TxOutZ {
2702 struct LDKTxOut *data;
2706 typedef union LDKCResult_TransactionNoneZPtr {
2707 struct LDKTransaction *result;
2709 * Note that this value is always NULL, as there are no contents in the Err variant
2712 } LDKCResult_TransactionNoneZPtr;
2714 typedef struct LDKCResult_TransactionNoneZ {
2715 union LDKCResult_TransactionNoneZPtr contents;
2717 } LDKCResult_TransactionNoneZ;
2724 typedef struct MUST_USE_STRUCT LDKRouteHop {
2726 * Nearly everywhere, inner must be non-null, however in places where
2727 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2729 LDKnativeRouteHop *inner;
2733 typedef struct LDKCVec_RouteHopZ {
2734 struct LDKRouteHop *data;
2736 } LDKCVec_RouteHopZ;
2738 typedef struct LDKCVec_CVec_RouteHopZZ {
2739 struct LDKCVec_RouteHopZ *data;
2741 } LDKCVec_CVec_RouteHopZZ;
2746 * A route directs a payment from the sender (us) to the recipient. If the recipient supports MPP,
2747 * it can take multiple paths. Each path is composed of one or more hops through the network.
2749 typedef struct MUST_USE_STRUCT LDKRoute {
2751 * Nearly everywhere, inner must be non-null, however in places where
2752 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2754 LDKnativeRoute *inner;
2758 typedef union LDKCResult_RouteDecodeErrorZPtr {
2759 struct LDKRoute *result;
2760 struct LDKDecodeError *err;
2761 } LDKCResult_RouteDecodeErrorZPtr;
2763 typedef struct LDKCResult_RouteDecodeErrorZ {
2764 union LDKCResult_RouteDecodeErrorZPtr contents;
2766 } LDKCResult_RouteDecodeErrorZ;
2771 * A channel descriptor which provides a last-hop route to get_route
2773 typedef struct MUST_USE_STRUCT LDKRouteHint {
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 LDKnativeRouteHint *inner;
2782 typedef struct LDKCVec_RouteHintZ {
2783 struct LDKRouteHint *data;
2785 } LDKCVec_RouteHintZ;
2787 typedef union LDKCResult_RouteLightningErrorZPtr {
2788 struct LDKRoute *result;
2789 struct LDKLightningError *err;
2790 } LDKCResult_RouteLightningErrorZPtr;
2792 typedef struct LDKCResult_RouteLightningErrorZ {
2793 union LDKCResult_RouteLightningErrorZPtr contents;
2795 } LDKCResult_RouteLightningErrorZ;
2797 typedef union LDKCResult_NetAddressu8ZPtr {
2798 struct LDKNetAddress *result;
2800 } LDKCResult_NetAddressu8ZPtr;
2802 typedef struct LDKCResult_NetAddressu8Z {
2803 union LDKCResult_NetAddressu8ZPtr contents;
2805 } LDKCResult_NetAddressu8Z;
2807 typedef union LDKCResult_CResult_NetAddressu8ZDecodeErrorZPtr {
2808 struct LDKCResult_NetAddressu8Z *result;
2809 struct LDKDecodeError *err;
2810 } LDKCResult_CResult_NetAddressu8ZDecodeErrorZPtr;
2812 typedef struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ {
2813 union LDKCResult_CResult_NetAddressu8ZDecodeErrorZPtr contents;
2815 } LDKCResult_CResult_NetAddressu8ZDecodeErrorZ;
2820 * An update_add_htlc message to be sent or received from a peer
2822 typedef struct MUST_USE_STRUCT LDKUpdateAddHTLC {
2824 * Nearly everywhere, inner must be non-null, however in places where
2825 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2827 LDKnativeUpdateAddHTLC *inner;
2831 typedef struct LDKCVec_UpdateAddHTLCZ {
2832 struct LDKUpdateAddHTLC *data;
2834 } LDKCVec_UpdateAddHTLCZ;
2839 * An update_fulfill_htlc message to be sent or received from a peer
2841 typedef struct MUST_USE_STRUCT LDKUpdateFulfillHTLC {
2843 * Nearly everywhere, inner must be non-null, however in places where
2844 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2846 LDKnativeUpdateFulfillHTLC *inner;
2848 } LDKUpdateFulfillHTLC;
2850 typedef struct LDKCVec_UpdateFulfillHTLCZ {
2851 struct LDKUpdateFulfillHTLC *data;
2853 } LDKCVec_UpdateFulfillHTLCZ;
2858 * An update_fail_htlc message to be sent or received from a peer
2860 typedef struct MUST_USE_STRUCT LDKUpdateFailHTLC {
2862 * Nearly everywhere, inner must be non-null, however in places where
2863 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2865 LDKnativeUpdateFailHTLC *inner;
2867 } LDKUpdateFailHTLC;
2869 typedef struct LDKCVec_UpdateFailHTLCZ {
2870 struct LDKUpdateFailHTLC *data;
2872 } LDKCVec_UpdateFailHTLCZ;
2877 * An update_fail_malformed_htlc message to be sent or received from a peer
2879 typedef struct MUST_USE_STRUCT LDKUpdateFailMalformedHTLC {
2881 * Nearly everywhere, inner must be non-null, however in places where
2882 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2884 LDKnativeUpdateFailMalformedHTLC *inner;
2886 } LDKUpdateFailMalformedHTLC;
2888 typedef struct LDKCVec_UpdateFailMalformedHTLCZ {
2889 struct LDKUpdateFailMalformedHTLC *data;
2891 } LDKCVec_UpdateFailMalformedHTLCZ;
2893 typedef union LDKCResult_AcceptChannelDecodeErrorZPtr {
2894 struct LDKAcceptChannel *result;
2895 struct LDKDecodeError *err;
2896 } LDKCResult_AcceptChannelDecodeErrorZPtr;
2898 typedef struct LDKCResult_AcceptChannelDecodeErrorZ {
2899 union LDKCResult_AcceptChannelDecodeErrorZPtr contents;
2901 } LDKCResult_AcceptChannelDecodeErrorZ;
2903 typedef union LDKCResult_AnnouncementSignaturesDecodeErrorZPtr {
2904 struct LDKAnnouncementSignatures *result;
2905 struct LDKDecodeError *err;
2906 } LDKCResult_AnnouncementSignaturesDecodeErrorZPtr;
2908 typedef struct LDKCResult_AnnouncementSignaturesDecodeErrorZ {
2909 union LDKCResult_AnnouncementSignaturesDecodeErrorZPtr contents;
2911 } LDKCResult_AnnouncementSignaturesDecodeErrorZ;
2913 typedef union LDKCResult_ChannelReestablishDecodeErrorZPtr {
2914 struct LDKChannelReestablish *result;
2915 struct LDKDecodeError *err;
2916 } LDKCResult_ChannelReestablishDecodeErrorZPtr;
2918 typedef struct LDKCResult_ChannelReestablishDecodeErrorZ {
2919 union LDKCResult_ChannelReestablishDecodeErrorZPtr contents;
2921 } LDKCResult_ChannelReestablishDecodeErrorZ;
2923 typedef union LDKCResult_ClosingSignedDecodeErrorZPtr {
2924 struct LDKClosingSigned *result;
2925 struct LDKDecodeError *err;
2926 } LDKCResult_ClosingSignedDecodeErrorZPtr;
2928 typedef struct LDKCResult_ClosingSignedDecodeErrorZ {
2929 union LDKCResult_ClosingSignedDecodeErrorZPtr contents;
2931 } LDKCResult_ClosingSignedDecodeErrorZ;
2936 * A commitment_signed message to be sent or received from a peer
2938 typedef struct MUST_USE_STRUCT LDKCommitmentSigned {
2940 * Nearly everywhere, inner must be non-null, however in places where
2941 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2943 LDKnativeCommitmentSigned *inner;
2945 } LDKCommitmentSigned;
2947 typedef union LDKCResult_CommitmentSignedDecodeErrorZPtr {
2948 struct LDKCommitmentSigned *result;
2949 struct LDKDecodeError *err;
2950 } LDKCResult_CommitmentSignedDecodeErrorZPtr;
2952 typedef struct LDKCResult_CommitmentSignedDecodeErrorZ {
2953 union LDKCResult_CommitmentSignedDecodeErrorZPtr contents;
2955 } LDKCResult_CommitmentSignedDecodeErrorZ;
2957 typedef union LDKCResult_FundingCreatedDecodeErrorZPtr {
2958 struct LDKFundingCreated *result;
2959 struct LDKDecodeError *err;
2960 } LDKCResult_FundingCreatedDecodeErrorZPtr;
2962 typedef struct LDKCResult_FundingCreatedDecodeErrorZ {
2963 union LDKCResult_FundingCreatedDecodeErrorZPtr contents;
2965 } LDKCResult_FundingCreatedDecodeErrorZ;
2967 typedef union LDKCResult_FundingSignedDecodeErrorZPtr {
2968 struct LDKFundingSigned *result;
2969 struct LDKDecodeError *err;
2970 } LDKCResult_FundingSignedDecodeErrorZPtr;
2972 typedef struct LDKCResult_FundingSignedDecodeErrorZ {
2973 union LDKCResult_FundingSignedDecodeErrorZPtr contents;
2975 } LDKCResult_FundingSignedDecodeErrorZ;
2977 typedef union LDKCResult_FundingLockedDecodeErrorZPtr {
2978 struct LDKFundingLocked *result;
2979 struct LDKDecodeError *err;
2980 } LDKCResult_FundingLockedDecodeErrorZPtr;
2982 typedef struct LDKCResult_FundingLockedDecodeErrorZ {
2983 union LDKCResult_FundingLockedDecodeErrorZPtr contents;
2985 } LDKCResult_FundingLockedDecodeErrorZ;
2990 * An init message to be sent or received from a peer
2992 typedef struct MUST_USE_STRUCT LDKInit {
2994 * Nearly everywhere, inner must be non-null, however in places where
2995 * the Rust equivalent takes an Option, it may be set to null to indicate None.
2997 LDKnativeInit *inner;
3001 typedef union LDKCResult_InitDecodeErrorZPtr {
3002 struct LDKInit *result;
3003 struct LDKDecodeError *err;
3004 } LDKCResult_InitDecodeErrorZPtr;
3006 typedef struct LDKCResult_InitDecodeErrorZ {
3007 union LDKCResult_InitDecodeErrorZPtr contents;
3009 } LDKCResult_InitDecodeErrorZ;
3011 typedef union LDKCResult_OpenChannelDecodeErrorZPtr {
3012 struct LDKOpenChannel *result;
3013 struct LDKDecodeError *err;
3014 } LDKCResult_OpenChannelDecodeErrorZPtr;
3016 typedef struct LDKCResult_OpenChannelDecodeErrorZ {
3017 union LDKCResult_OpenChannelDecodeErrorZPtr contents;
3019 } LDKCResult_OpenChannelDecodeErrorZ;
3021 typedef union LDKCResult_RevokeAndACKDecodeErrorZPtr {
3022 struct LDKRevokeAndACK *result;
3023 struct LDKDecodeError *err;
3024 } LDKCResult_RevokeAndACKDecodeErrorZPtr;
3026 typedef struct LDKCResult_RevokeAndACKDecodeErrorZ {
3027 union LDKCResult_RevokeAndACKDecodeErrorZPtr contents;
3029 } LDKCResult_RevokeAndACKDecodeErrorZ;
3031 typedef union LDKCResult_ShutdownDecodeErrorZPtr {
3032 struct LDKShutdown *result;
3033 struct LDKDecodeError *err;
3034 } LDKCResult_ShutdownDecodeErrorZPtr;
3036 typedef struct LDKCResult_ShutdownDecodeErrorZ {
3037 union LDKCResult_ShutdownDecodeErrorZPtr contents;
3039 } LDKCResult_ShutdownDecodeErrorZ;
3041 typedef union LDKCResult_UpdateFailHTLCDecodeErrorZPtr {
3042 struct LDKUpdateFailHTLC *result;
3043 struct LDKDecodeError *err;
3044 } LDKCResult_UpdateFailHTLCDecodeErrorZPtr;
3046 typedef struct LDKCResult_UpdateFailHTLCDecodeErrorZ {
3047 union LDKCResult_UpdateFailHTLCDecodeErrorZPtr contents;
3049 } LDKCResult_UpdateFailHTLCDecodeErrorZ;
3051 typedef union LDKCResult_UpdateFailMalformedHTLCDecodeErrorZPtr {
3052 struct LDKUpdateFailMalformedHTLC *result;
3053 struct LDKDecodeError *err;
3054 } LDKCResult_UpdateFailMalformedHTLCDecodeErrorZPtr;
3056 typedef struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ {
3057 union LDKCResult_UpdateFailMalformedHTLCDecodeErrorZPtr contents;
3059 } LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ;
3064 * An update_fee message to be sent or received from a peer
3066 typedef struct MUST_USE_STRUCT LDKUpdateFee {
3068 * Nearly everywhere, inner must be non-null, however in places where
3069 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3071 LDKnativeUpdateFee *inner;
3075 typedef union LDKCResult_UpdateFeeDecodeErrorZPtr {
3076 struct LDKUpdateFee *result;
3077 struct LDKDecodeError *err;
3078 } LDKCResult_UpdateFeeDecodeErrorZPtr;
3080 typedef struct LDKCResult_UpdateFeeDecodeErrorZ {
3081 union LDKCResult_UpdateFeeDecodeErrorZPtr contents;
3083 } LDKCResult_UpdateFeeDecodeErrorZ;
3085 typedef union LDKCResult_UpdateFulfillHTLCDecodeErrorZPtr {
3086 struct LDKUpdateFulfillHTLC *result;
3087 struct LDKDecodeError *err;
3088 } LDKCResult_UpdateFulfillHTLCDecodeErrorZPtr;
3090 typedef struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ {
3091 union LDKCResult_UpdateFulfillHTLCDecodeErrorZPtr contents;
3093 } LDKCResult_UpdateFulfillHTLCDecodeErrorZ;
3095 typedef union LDKCResult_UpdateAddHTLCDecodeErrorZPtr {
3096 struct LDKUpdateAddHTLC *result;
3097 struct LDKDecodeError *err;
3098 } LDKCResult_UpdateAddHTLCDecodeErrorZPtr;
3100 typedef struct LDKCResult_UpdateAddHTLCDecodeErrorZ {
3101 union LDKCResult_UpdateAddHTLCDecodeErrorZPtr contents;
3103 } LDKCResult_UpdateAddHTLCDecodeErrorZ;
3108 * A ping message to be sent or received from a peer
3110 typedef struct MUST_USE_STRUCT LDKPing {
3112 * Nearly everywhere, inner must be non-null, however in places where
3113 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3115 LDKnativePing *inner;
3119 typedef union LDKCResult_PingDecodeErrorZPtr {
3120 struct LDKPing *result;
3121 struct LDKDecodeError *err;
3122 } LDKCResult_PingDecodeErrorZPtr;
3124 typedef struct LDKCResult_PingDecodeErrorZ {
3125 union LDKCResult_PingDecodeErrorZPtr contents;
3127 } LDKCResult_PingDecodeErrorZ;
3132 * A pong message to be sent or received from a peer
3134 typedef struct MUST_USE_STRUCT LDKPong {
3136 * Nearly everywhere, inner must be non-null, however in places where
3137 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3139 LDKnativePong *inner;
3143 typedef union LDKCResult_PongDecodeErrorZPtr {
3144 struct LDKPong *result;
3145 struct LDKDecodeError *err;
3146 } LDKCResult_PongDecodeErrorZPtr;
3148 typedef struct LDKCResult_PongDecodeErrorZ {
3149 union LDKCResult_PongDecodeErrorZPtr contents;
3151 } LDKCResult_PongDecodeErrorZ;
3153 typedef union LDKCResult_UnsignedChannelAnnouncementDecodeErrorZPtr {
3154 struct LDKUnsignedChannelAnnouncement *result;
3155 struct LDKDecodeError *err;
3156 } LDKCResult_UnsignedChannelAnnouncementDecodeErrorZPtr;
3158 typedef struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ {
3159 union LDKCResult_UnsignedChannelAnnouncementDecodeErrorZPtr contents;
3161 } LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ;
3163 typedef union LDKCResult_ChannelAnnouncementDecodeErrorZPtr {
3164 struct LDKChannelAnnouncement *result;
3165 struct LDKDecodeError *err;
3166 } LDKCResult_ChannelAnnouncementDecodeErrorZPtr;
3168 typedef struct LDKCResult_ChannelAnnouncementDecodeErrorZ {
3169 union LDKCResult_ChannelAnnouncementDecodeErrorZPtr contents;
3171 } LDKCResult_ChannelAnnouncementDecodeErrorZ;
3176 * The unsigned part of a channel_update
3178 typedef struct MUST_USE_STRUCT LDKUnsignedChannelUpdate {
3180 * Nearly everywhere, inner must be non-null, however in places where
3181 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3183 LDKnativeUnsignedChannelUpdate *inner;
3185 } LDKUnsignedChannelUpdate;
3187 typedef union LDKCResult_UnsignedChannelUpdateDecodeErrorZPtr {
3188 struct LDKUnsignedChannelUpdate *result;
3189 struct LDKDecodeError *err;
3190 } LDKCResult_UnsignedChannelUpdateDecodeErrorZPtr;
3192 typedef struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ {
3193 union LDKCResult_UnsignedChannelUpdateDecodeErrorZPtr contents;
3195 } LDKCResult_UnsignedChannelUpdateDecodeErrorZ;
3197 typedef union LDKCResult_ChannelUpdateDecodeErrorZPtr {
3198 struct LDKChannelUpdate *result;
3199 struct LDKDecodeError *err;
3200 } LDKCResult_ChannelUpdateDecodeErrorZPtr;
3202 typedef struct LDKCResult_ChannelUpdateDecodeErrorZ {
3203 union LDKCResult_ChannelUpdateDecodeErrorZPtr contents;
3205 } LDKCResult_ChannelUpdateDecodeErrorZ;
3207 typedef union LDKCResult_ErrorMessageDecodeErrorZPtr {
3208 struct LDKErrorMessage *result;
3209 struct LDKDecodeError *err;
3210 } LDKCResult_ErrorMessageDecodeErrorZPtr;
3212 typedef struct LDKCResult_ErrorMessageDecodeErrorZ {
3213 union LDKCResult_ErrorMessageDecodeErrorZPtr contents;
3215 } LDKCResult_ErrorMessageDecodeErrorZ;
3220 * The unsigned part of a node_announcement
3222 typedef struct MUST_USE_STRUCT LDKUnsignedNodeAnnouncement {
3224 * Nearly everywhere, inner must be non-null, however in places where
3225 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3227 LDKnativeUnsignedNodeAnnouncement *inner;
3229 } LDKUnsignedNodeAnnouncement;
3231 typedef union LDKCResult_UnsignedNodeAnnouncementDecodeErrorZPtr {
3232 struct LDKUnsignedNodeAnnouncement *result;
3233 struct LDKDecodeError *err;
3234 } LDKCResult_UnsignedNodeAnnouncementDecodeErrorZPtr;
3236 typedef struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ {
3237 union LDKCResult_UnsignedNodeAnnouncementDecodeErrorZPtr contents;
3239 } LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ;
3241 typedef union LDKCResult_NodeAnnouncementDecodeErrorZPtr {
3242 struct LDKNodeAnnouncement *result;
3243 struct LDKDecodeError *err;
3244 } LDKCResult_NodeAnnouncementDecodeErrorZPtr;
3246 typedef struct LDKCResult_NodeAnnouncementDecodeErrorZ {
3247 union LDKCResult_NodeAnnouncementDecodeErrorZPtr contents;
3249 } LDKCResult_NodeAnnouncementDecodeErrorZ;
3251 typedef union LDKCResult_QueryShortChannelIdsDecodeErrorZPtr {
3252 struct LDKQueryShortChannelIds *result;
3253 struct LDKDecodeError *err;
3254 } LDKCResult_QueryShortChannelIdsDecodeErrorZPtr;
3256 typedef struct LDKCResult_QueryShortChannelIdsDecodeErrorZ {
3257 union LDKCResult_QueryShortChannelIdsDecodeErrorZPtr contents;
3259 } LDKCResult_QueryShortChannelIdsDecodeErrorZ;
3264 * A reply_short_channel_ids_end message is sent as a reply to a
3265 * query_short_channel_ids message. The query recipient makes a best
3266 * effort to respond based on their local network view which may not be
3267 * a perfect view of the network.
3269 typedef struct MUST_USE_STRUCT LDKReplyShortChannelIdsEnd {
3271 * Nearly everywhere, inner must be non-null, however in places where
3272 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3274 LDKnativeReplyShortChannelIdsEnd *inner;
3276 } LDKReplyShortChannelIdsEnd;
3278 typedef union LDKCResult_ReplyShortChannelIdsEndDecodeErrorZPtr {
3279 struct LDKReplyShortChannelIdsEnd *result;
3280 struct LDKDecodeError *err;
3281 } LDKCResult_ReplyShortChannelIdsEndDecodeErrorZPtr;
3283 typedef struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ {
3284 union LDKCResult_ReplyShortChannelIdsEndDecodeErrorZPtr contents;
3286 } LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ;
3288 typedef union LDKCResult_QueryChannelRangeDecodeErrorZPtr {
3289 struct LDKQueryChannelRange *result;
3290 struct LDKDecodeError *err;
3291 } LDKCResult_QueryChannelRangeDecodeErrorZPtr;
3293 typedef struct LDKCResult_QueryChannelRangeDecodeErrorZ {
3294 union LDKCResult_QueryChannelRangeDecodeErrorZPtr contents;
3296 } LDKCResult_QueryChannelRangeDecodeErrorZ;
3301 * A reply_channel_range message is a reply to a query_channel_range
3302 * message. Multiple reply_channel_range messages can be sent in reply
3303 * to a single query_channel_range message. The query recipient makes a
3304 * best effort to respond based on their local network view which may
3305 * not be a perfect view of the network. The short_channel_ids in the
3306 * reply are encoded. We only support encoding_type=0 uncompressed
3307 * serialization and do not support encoding_type=1 zlib serialization.
3309 typedef struct MUST_USE_STRUCT LDKReplyChannelRange {
3311 * Nearly everywhere, inner must be non-null, however in places where
3312 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3314 LDKnativeReplyChannelRange *inner;
3316 } LDKReplyChannelRange;
3318 typedef union LDKCResult_ReplyChannelRangeDecodeErrorZPtr {
3319 struct LDKReplyChannelRange *result;
3320 struct LDKDecodeError *err;
3321 } LDKCResult_ReplyChannelRangeDecodeErrorZPtr;
3323 typedef struct LDKCResult_ReplyChannelRangeDecodeErrorZ {
3324 union LDKCResult_ReplyChannelRangeDecodeErrorZPtr contents;
3326 } LDKCResult_ReplyChannelRangeDecodeErrorZ;
3331 * A gossip_timestamp_filter message is used by a node to request
3332 * gossip relay for messages in the requested time range when the
3333 * gossip_queries feature has been negotiated.
3335 typedef struct MUST_USE_STRUCT LDKGossipTimestampFilter {
3337 * Nearly everywhere, inner must be non-null, however in places where
3338 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3340 LDKnativeGossipTimestampFilter *inner;
3342 } LDKGossipTimestampFilter;
3344 typedef union LDKCResult_GossipTimestampFilterDecodeErrorZPtr {
3345 struct LDKGossipTimestampFilter *result;
3346 struct LDKDecodeError *err;
3347 } LDKCResult_GossipTimestampFilterDecodeErrorZPtr;
3349 typedef struct LDKCResult_GossipTimestampFilterDecodeErrorZ {
3350 union LDKCResult_GossipTimestampFilterDecodeErrorZPtr contents;
3352 } LDKCResult_GossipTimestampFilterDecodeErrorZ;
3355 * A trait indicating an object may generate message send events
3357 typedef struct LDKMessageSendEventsProvider {
3360 * Gets the list of pending events which were generated by previous actions, clearing the list
3363 struct LDKCVec_MessageSendEventZ (*get_and_clear_pending_msg_events)(const void *this_arg);
3364 void (*free)(void *this_arg);
3365 } LDKMessageSendEventsProvider;
3368 * A trait indicating an object may generate events
3370 typedef struct LDKEventsProvider {
3373 * Gets the list of pending events which were generated by previous actions, clearing the list
3376 struct LDKCVec_EventZ (*get_and_clear_pending_events)(const void *this_arg);
3377 void (*free)(void *this_arg);
3378 } LDKEventsProvider;
3383 * Configuration we set when applicable.
3385 * Default::default() provides sane defaults.
3387 typedef struct MUST_USE_STRUCT LDKChannelHandshakeConfig {
3389 * Nearly everywhere, inner must be non-null, however in places where
3390 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3392 LDKnativeChannelHandshakeConfig *inner;
3394 } LDKChannelHandshakeConfig;
3399 * Optional channel limits which are applied during channel creation.
3401 * These limits are only applied to our counterparty's limits, not our own.
3403 * Use 0/<type>::max_value() as appropriate to skip checking.
3405 * Provides sane defaults for most configurations.
3407 * Most additional limits are disabled except those with which specify a default in individual
3408 * field documentation. Note that this may result in barely-usable channels, but since they
3409 * are applied mostly only to incoming channels that's not much of a problem.
3411 typedef struct MUST_USE_STRUCT LDKChannelHandshakeLimits {
3413 * Nearly everywhere, inner must be non-null, however in places where
3414 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3416 LDKnativeChannelHandshakeLimits *inner;
3418 } LDKChannelHandshakeLimits;
3423 * Top-level config which holds ChannelHandshakeLimits and ChannelConfig.
3425 * Default::default() provides sane defaults for most configurations
3426 * (but currently with 0 relay fees!)
3428 typedef struct MUST_USE_STRUCT LDKUserConfig {
3430 * Nearly everywhere, inner must be non-null, however in places where
3431 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3433 LDKnativeUserConfig *inner;
3438 * The `Access` trait defines behavior for accessing chain data and state, such as blocks and
3441 typedef struct LDKAccess {
3444 * Returns the transaction output of a funding transaction encoded by [`short_channel_id`].
3445 * Returns an error if `genesis_hash` is for a different chain or if such a transaction output
3448 * [`short_channel_id`]: https://github.com/lightningnetwork/lightning-rfc/blob/master/07-routing-gossip.md#definition-of-short_channel_id
3450 struct LDKCResult_TxOutAccessErrorZ (*get_utxo)(const void *this_arg, const uint8_t (*genesis_hash)[32], uint64_t short_channel_id);
3451 void (*free)(void *this_arg);
3455 * The `Listen` trait is used to be notified of when blocks have been connected or disconnected
3458 * Useful when needing to replay chain data upon startup or as new chain events occur.
3460 typedef struct LDKListen {
3463 * Notifies the listener that a block was added at the given height.
3465 void (*block_connected)(const void *this_arg, struct LDKu8slice block, uint32_t height);
3467 * Notifies the listener that a block was removed at the given height.
3469 void (*block_disconnected)(const void *this_arg, const uint8_t (*header)[80], uint32_t height);
3470 void (*free)(void *this_arg);
3474 * The `Filter` trait defines behavior for indicating chain activity of interest pertaining to
3477 * This is useful in order to have a [`Watch`] implementation convey to a chain source which
3478 * transactions to be notified of. Notification may take the form of pre-filtering blocks or, in
3479 * the case of [BIP 157]/[BIP 158], only fetching a block if the compact filter matches. If
3480 * receiving full blocks from a chain source, any further filtering is unnecessary.
3482 * After an output has been registered, subsequent block retrievals from the chain source must not
3483 * exclude any transactions matching the new criteria nor any in-block descendants of such
3486 * Note that use as part of a [`Watch`] implementation involves reentrancy. Therefore, the `Filter`
3487 * should not block on I/O. Implementations should instead queue the newly monitored data to be
3488 * processed later. Then, in order to block until the data has been processed, any `Watch`
3489 * invocation that has called the `Filter` must return [`TemporaryFailure`].
3491 * [`Watch`]: trait.Watch.html
3492 * [`TemporaryFailure`]: channelmonitor/enum.ChannelMonitorUpdateErr.html#variant.TemporaryFailure
3493 * [BIP 157]: https://github.com/bitcoin/bips/blob/master/bip-0157.mediawiki
3494 * [BIP 158]: https://github.com/bitcoin/bips/blob/master/bip-0158.mediawiki
3496 typedef struct LDKFilter {
3499 * Registers interest in a transaction with `txid` and having an output with `script_pubkey` as
3500 * a spending condition.
3502 void (*register_tx)(const void *this_arg, const uint8_t (*txid)[32], struct LDKu8slice script_pubkey);
3504 * Registers interest in spends of a transaction output identified by `outpoint` having
3505 * `script_pubkey` as the spending condition.
3507 void (*register_output)(const void *this_arg, const struct LDKOutPoint *NONNULL_PTR outpoint, struct LDKu8slice script_pubkey);
3508 void (*free)(void *this_arg);
3512 * `Persist` defines behavior for persisting channel monitors: this could mean
3513 * writing once to disk, and/or uploading to one or more backup services.
3515 * Note that for every new monitor, you **must** persist the new `ChannelMonitor`
3516 * to disk/backups. And, on every update, you **must** persist either the
3517 * `ChannelMonitorUpdate` or the updated monitor itself. Otherwise, there is risk
3518 * of situations such as revoking a transaction, then crashing before this
3519 * revocation can be persisted, then unintentionally broadcasting a revoked
3520 * transaction and losing money. This is a risk because previous channel states
3521 * are toxic, so it's important that whatever channel state is persisted is
3524 typedef struct LDKPersist {
3527 * Persist a new channel's data. The data can be stored any way you want, but
3528 * the identifier provided by Rust-Lightning is the channel's outpoint (and
3529 * it is up to you to maintain a correct mapping between the outpoint and the
3530 * stored channel data). Note that you **must** persist every new monitor to
3531 * disk. See the `Persist` trait documentation for more details.
3533 * See [`ChannelMonitor::serialize_for_disk`] for writing out a `ChannelMonitor`,
3534 * and [`ChannelMonitorUpdateErr`] for requirements when returning errors.
3536 * [`ChannelMonitor::serialize_for_disk`]: struct.ChannelMonitor.html#method.serialize_for_disk
3537 * [`ChannelMonitorUpdateErr`]: enum.ChannelMonitorUpdateErr.html
3539 struct LDKCResult_NoneChannelMonitorUpdateErrZ (*persist_new_channel)(const void *this_arg, struct LDKOutPoint id, const struct LDKChannelMonitor *NONNULL_PTR data);
3541 * Update one channel's data. The provided `ChannelMonitor` has already
3542 * applied the given update.
3544 * Note that on every update, you **must** persist either the
3545 * `ChannelMonitorUpdate` or the updated monitor itself to disk/backups. See
3546 * the `Persist` trait documentation for more details.
3548 * If an implementer chooses to persist the updates only, they need to make
3549 * sure that all the updates are applied to the `ChannelMonitors` *before*
3550 * the set of channel monitors is given to the `ChannelManager`
3551 * deserialization routine. See [`ChannelMonitor::update_monitor`] for
3552 * applying a monitor update to a monitor. If full `ChannelMonitors` are
3553 * persisted, then there is no need to persist individual updates.
3555 * Note that there could be a performance tradeoff between persisting complete
3556 * channel monitors on every update vs. persisting only updates and applying
3557 * them in batches. The size of each monitor grows `O(number of state updates)`
3558 * whereas updates are small and `O(1)`.
3560 * See [`ChannelMonitor::serialize_for_disk`] for writing out a `ChannelMonitor`,
3561 * [`ChannelMonitorUpdate::write`] for writing out an update, and
3562 * [`ChannelMonitorUpdateErr`] for requirements when returning errors.
3564 * [`ChannelMonitor::update_monitor`]: struct.ChannelMonitor.html#impl-1
3565 * [`ChannelMonitor::serialize_for_disk`]: struct.ChannelMonitor.html#method.serialize_for_disk
3566 * [`ChannelMonitorUpdate::write`]: struct.ChannelMonitorUpdate.html#method.write
3567 * [`ChannelMonitorUpdateErr`]: enum.ChannelMonitorUpdateErr.html
3569 struct LDKCResult_NoneChannelMonitorUpdateErrZ (*update_persisted_channel)(const void *this_arg, struct LDKOutPoint id, const struct LDKChannelMonitorUpdate *NONNULL_PTR update, const struct LDKChannelMonitor *NONNULL_PTR data);
3570 void (*free)(void *this_arg);
3576 * An implementation of [`chain::Watch`] for monitoring channels.
3578 * Connected and disconnected blocks must be provided to `ChainMonitor` as documented by
3579 * [`chain::Watch`]. May be used in conjunction with [`ChannelManager`] to monitor channels locally
3580 * or used independently to monitor channels remotely. See the [module-level documentation] for
3583 * [`chain::Watch`]: ../trait.Watch.html
3584 * [`ChannelManager`]: ../../ln/channelmanager/struct.ChannelManager.html
3585 * [module-level documentation]: index.html
3587 typedef struct MUST_USE_STRUCT LDKChainMonitor {
3589 * Nearly everywhere, inner must be non-null, however in places where
3590 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3592 LDKnativeChainMonitor *inner;
3599 * Simple KeysInterface implementor that takes a 32-byte seed for use as a BIP 32 extended key
3600 * and derives keys from that.
3602 * Your node_id is seed/0'
3603 * ChannelMonitor closes may use seed/1'
3604 * Cooperative closes may use seed/2'
3605 * The two close keys may be needed to claim on-chain funds!
3607 typedef struct MUST_USE_STRUCT LDKKeysManager {
3609 * Nearly everywhere, inner must be non-null, however in places where
3610 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3612 LDKnativeKeysManager *inner;
3616 typedef struct LDKThreeBytes {
3621 * A trait to describe an object which can receive channel messages.
3623 * Messages MAY be called in parallel when they originate from different their_node_ids, however
3624 * they MUST NOT be called in parallel when the two calls have the same their_node_id.
3626 typedef struct LDKChannelMessageHandler {
3629 * Handle an incoming open_channel message from the given peer.
3631 void (*handle_open_channel)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKInitFeatures their_features, const struct LDKOpenChannel *NONNULL_PTR msg);
3633 * Handle an incoming accept_channel message from the given peer.
3635 void (*handle_accept_channel)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKInitFeatures their_features, const struct LDKAcceptChannel *NONNULL_PTR msg);
3637 * Handle an incoming funding_created message from the given peer.
3639 void (*handle_funding_created)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKFundingCreated *NONNULL_PTR msg);
3641 * Handle an incoming funding_signed message from the given peer.
3643 void (*handle_funding_signed)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKFundingSigned *NONNULL_PTR msg);
3645 * Handle an incoming funding_locked message from the given peer.
3647 void (*handle_funding_locked)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKFundingLocked *NONNULL_PTR msg);
3649 * Handle an incoming shutdown message from the given peer.
3651 void (*handle_shutdown)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKInitFeatures *NONNULL_PTR their_features, const struct LDKShutdown *NONNULL_PTR msg);
3653 * Handle an incoming closing_signed message from the given peer.
3655 void (*handle_closing_signed)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKClosingSigned *NONNULL_PTR msg);
3657 * Handle an incoming update_add_htlc message from the given peer.
3659 void (*handle_update_add_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateAddHTLC *NONNULL_PTR msg);
3661 * Handle an incoming update_fulfill_htlc message from the given peer.
3663 void (*handle_update_fulfill_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFulfillHTLC *NONNULL_PTR msg);
3665 * Handle an incoming update_fail_htlc message from the given peer.
3667 void (*handle_update_fail_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFailHTLC *NONNULL_PTR msg);
3669 * Handle an incoming update_fail_malformed_htlc message from the given peer.
3671 void (*handle_update_fail_malformed_htlc)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR msg);
3673 * Handle an incoming commitment_signed message from the given peer.
3675 void (*handle_commitment_signed)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKCommitmentSigned *NONNULL_PTR msg);
3677 * Handle an incoming revoke_and_ack message from the given peer.
3679 void (*handle_revoke_and_ack)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKRevokeAndACK *NONNULL_PTR msg);
3681 * Handle an incoming update_fee message from the given peer.
3683 void (*handle_update_fee)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKUpdateFee *NONNULL_PTR msg);
3685 * Handle an incoming announcement_signatures message from the given peer.
3687 void (*handle_announcement_signatures)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKAnnouncementSignatures *NONNULL_PTR msg);
3689 * Indicates a connection to the peer failed/an existing connection was lost. If no connection
3690 * is believed to be possible in the future (eg they're sending us messages we don't
3691 * understand or indicate they require unknown feature bits), no_connection_possible is set
3692 * and any outstanding channels should be failed.
3694 void (*peer_disconnected)(const void *this_arg, struct LDKPublicKey their_node_id, bool no_connection_possible);
3696 * Handle a peer reconnecting, possibly generating channel_reestablish message(s).
3698 void (*peer_connected)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKInit *NONNULL_PTR msg);
3700 * Handle an incoming channel_reestablish message from the given peer.
3702 void (*handle_channel_reestablish)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKChannelReestablish *NONNULL_PTR msg);
3704 * Handle an incoming error message from the given peer.
3706 void (*handle_error)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKErrorMessage *NONNULL_PTR msg);
3707 struct LDKMessageSendEventsProvider MessageSendEventsProvider;
3708 void (*free)(void *this_arg);
3709 } LDKChannelMessageHandler;
3714 * Arguments for the creation of a ChannelManager that are not deserialized.
3716 * At a high-level, the process for deserializing a ChannelManager and resuming normal operation
3718 * 1) Deserialize all stored ChannelMonitors.
3719 * 2) Deserialize the ChannelManager by filling in this struct and calling <(Sha256dHash,
3720 * ChannelManager)>::read(reader, args).
3721 * This may result in closing some Channels if the ChannelMonitor is newer than the stored
3722 * ChannelManager state to ensure no loss of funds. Thus, transactions may be broadcasted.
3723 * 3) Register all relevant ChannelMonitor outpoints with your chain watch mechanism using
3724 * ChannelMonitor::get_outputs_to_watch() and ChannelMonitor::get_funding_txo().
3725 * 4) Reconnect blocks on your ChannelMonitors.
3726 * 5) Move the ChannelMonitors into your local chain::Watch.
3727 * 6) Disconnect/connect blocks on the ChannelManager.
3729 typedef struct MUST_USE_STRUCT LDKChannelManagerReadArgs {
3731 * Nearly everywhere, inner must be non-null, however in places where
3732 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3734 LDKnativeChannelManagerReadArgs *inner;
3736 } LDKChannelManagerReadArgs;
3741 * Proof that the sender knows the per-commitment secret of the previous commitment transaction.
3742 * This is used to convince the recipient that the channel is at a certain commitment
3743 * number even if they lost that data due to a local failure. Of course, the peer may lie
3744 * and even later commitments may have been revoked.
3746 typedef struct MUST_USE_STRUCT LDKDataLossProtect {
3748 * Nearly everywhere, inner must be non-null, however in places where
3749 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3751 LDKnativeDataLossProtect *inner;
3753 } LDKDataLossProtect;
3756 * A trait to describe an object which can receive routing messages.
3758 * # Implementor DoS Warnings
3760 * For `gossip_queries` messages there are potential DoS vectors when handling
3761 * inbound queries. Implementors using an on-disk network graph should be aware of
3762 * repeated disk I/O for queries accessing different parts of the network graph.
3764 typedef struct LDKRoutingMessageHandler {
3767 * Handle an incoming node_announcement message, returning true if it should be forwarded on,
3768 * false or returning an Err otherwise.
3770 struct LDKCResult_boolLightningErrorZ (*handle_node_announcement)(const void *this_arg, const struct LDKNodeAnnouncement *NONNULL_PTR msg);
3772 * Handle a channel_announcement message, returning true if it should be forwarded on, false
3773 * or returning an Err otherwise.
3775 struct LDKCResult_boolLightningErrorZ (*handle_channel_announcement)(const void *this_arg, const struct LDKChannelAnnouncement *NONNULL_PTR msg);
3777 * Handle an incoming channel_update message, returning true if it should be forwarded on,
3778 * false or returning an Err otherwise.
3780 struct LDKCResult_boolLightningErrorZ (*handle_channel_update)(const void *this_arg, const struct LDKChannelUpdate *NONNULL_PTR msg);
3782 * Handle some updates to the route graph that we learned due to an outbound failed payment.
3784 void (*handle_htlc_fail_channel_update)(const void *this_arg, const struct LDKHTLCFailChannelUpdate *NONNULL_PTR update);
3786 * Gets a subset of the channel announcements and updates required to dump our routing table
3787 * to a remote node, starting at the short_channel_id indicated by starting_point and
3788 * including the batch_amount entries immediately higher in numerical value than starting_point.
3790 struct LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ (*get_next_channel_announcements)(const void *this_arg, uint64_t starting_point, uint8_t batch_amount);
3792 * Gets a subset of the node announcements required to dump our routing table to a remote node,
3793 * starting at the node *after* the provided publickey and including batch_amount entries
3794 * immediately higher (as defined by <PublicKey as Ord>::cmp) than starting_point.
3795 * If None is provided for starting_point, we start at the first node.
3797 struct LDKCVec_NodeAnnouncementZ (*get_next_node_announcements)(const void *this_arg, struct LDKPublicKey starting_point, uint8_t batch_amount);
3799 * Called when a connection is established with a peer. This can be used to
3800 * perform routing table synchronization using a strategy defined by the
3803 void (*sync_routing_table)(const void *this_arg, struct LDKPublicKey their_node_id, const struct LDKInit *NONNULL_PTR init);
3805 * Handles the reply of a query we initiated to learn about channels
3806 * for a given range of blocks. We can expect to receive one or more
3807 * replies to a single query.
3809 struct LDKCResult_NoneLightningErrorZ (*handle_reply_channel_range)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKReplyChannelRange msg);
3811 * Handles the reply of a query we initiated asking for routing gossip
3812 * messages for a list of channels. We should receive this message when
3813 * a node has completed its best effort to send us the pertaining routing
3816 struct LDKCResult_NoneLightningErrorZ (*handle_reply_short_channel_ids_end)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKReplyShortChannelIdsEnd msg);
3818 * Handles when a peer asks us to send a list of short_channel_ids
3819 * for the requested range of blocks.
3821 struct LDKCResult_NoneLightningErrorZ (*handle_query_channel_range)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKQueryChannelRange msg);
3823 * Handles when a peer asks us to send routing gossip messages for a
3824 * list of short_channel_ids.
3826 struct LDKCResult_NoneLightningErrorZ (*handle_query_short_channel_ids)(const void *this_arg, struct LDKPublicKey their_node_id, struct LDKQueryShortChannelIds msg);
3827 struct LDKMessageSendEventsProvider MessageSendEventsProvider;
3828 void (*free)(void *this_arg);
3829 } LDKRoutingMessageHandler;
3834 * Provides references to trait impls which handle different types of messages.
3836 typedef struct MUST_USE_STRUCT LDKMessageHandler {
3838 * Nearly everywhere, inner must be non-null, however in places where
3839 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3841 LDKnativeMessageHandler *inner;
3843 } LDKMessageHandler;
3846 * Provides an object which can be used to send data to and which uniquely identifies a connection
3847 * to a remote host. You will need to be able to generate multiple of these which meet Eq and
3848 * implement Hash to meet the PeerManager API.
3850 * For efficiency, Clone should be relatively cheap for this type.
3852 * You probably want to just extend an int and put a file descriptor in a struct and implement
3853 * send_data. Note that if you are using a higher-level net library that may call close() itself,
3854 * be careful to ensure you don't have races whereby you might register a new connection with an
3855 * fd which is the same as a previous one which has yet to be removed via
3856 * PeerManager::socket_disconnected().
3858 typedef struct LDKSocketDescriptor {
3861 * Attempts to send some data from the given slice to the peer.
3863 * Returns the amount of data which was sent, possibly 0 if the socket has since disconnected.
3864 * Note that in the disconnected case, socket_disconnected must still fire and further write
3865 * attempts may occur until that time.
3867 * If the returned size is smaller than data.len(), a write_available event must
3868 * trigger the next time more data can be written. Additionally, until the a send_data event
3869 * completes fully, no further read_events should trigger on the same peer!
3871 * If a read_event on this descriptor had previously returned true (indicating that read
3872 * events should be paused to prevent DoS in the send buffer), resume_read may be set
3873 * indicating that read events on this descriptor should resume. A resume_read of false does
3874 * *not* imply that further read events should be paused.
3876 uintptr_t (*send_data)(void *this_arg, struct LDKu8slice data, bool resume_read);
3878 * Disconnect the socket pointed to by this SocketDescriptor. Once this function returns, no
3879 * more calls to write_buffer_space_avail, read_event or socket_disconnected may be made with
3880 * this descriptor. No socket_disconnected call should be generated as a result of this call,
3881 * though races may occur whereby disconnect_socket is called after a call to
3882 * socket_disconnected but prior to socket_disconnected returning.
3884 void (*disconnect_socket)(void *this_arg);
3885 bool (*eq)(const void *this_arg, const struct LDKSocketDescriptor *NONNULL_PTR other_arg);
3886 uint64_t (*hash)(const void *this_arg);
3887 void *(*clone)(const void *this_arg);
3888 void (*free)(void *this_arg);
3889 } LDKSocketDescriptor;
3894 * A PeerManager manages a set of peers, described by their SocketDescriptor and marshalls socket
3895 * events into messages which it passes on to its MessageHandlers.
3897 * Rather than using a plain PeerManager, it is preferable to use either a SimpleArcPeerManager
3898 * a SimpleRefPeerManager, for conciseness. See their documentation for more details, but
3899 * essentially you should default to using a SimpleRefPeerManager, and use a
3900 * SimpleArcPeerManager when you require a PeerManager with a static lifetime, such as when
3901 * you're using lightning-net-tokio.
3903 typedef struct MUST_USE_STRUCT LDKPeerManager {
3905 * Nearly everywhere, inner must be non-null, however in places where
3906 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3908 LDKnativePeerManager *inner;
3915 * Static channel fields used to build transactions given per-commitment fields, organized by
3916 * broadcaster/countersignatory.
3918 * This is derived from the holder/counterparty-organized ChannelTransactionParameters via the
3919 * as_holder_broadcastable and as_counterparty_broadcastable functions.
3921 typedef struct MUST_USE_STRUCT LDKDirectedChannelTransactionParameters {
3923 * Nearly everywhere, inner must be non-null, however in places where
3924 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3926 LDKnativeDirectedChannelTransactionParameters *inner;
3928 } LDKDirectedChannelTransactionParameters;
3933 * A simple newtype for RwLockReadGuard<'a, NetworkGraph>.
3934 * This exists only to make accessing a RwLock<NetworkGraph> possible from
3935 * the C bindings, as it can be done directly in Rust code.
3937 typedef struct MUST_USE_STRUCT LDKLockedNetworkGraph {
3939 * Nearly everywhere, inner must be non-null, however in places where
3940 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3942 LDKnativeLockedNetworkGraph *inner;
3944 } LDKLockedNetworkGraph;
3949 * Receives and validates network updates from peers,
3950 * stores authentic and relevant data as a network graph.
3951 * This network graph is then used for routing payments.
3952 * Provides interface to help with initial routing sync by
3953 * serving historical announcements.
3955 typedef struct MUST_USE_STRUCT LDKNetGraphMsgHandler {
3957 * Nearly everywhere, inner must be non-null, however in places where
3958 * the Rust equivalent takes an Option, it may be set to null to indicate None.
3960 LDKnativeNetGraphMsgHandler *inner;
3962 } LDKNetGraphMsgHandler;
3964 extern const uintptr_t MAX_BUF_SIZE;
3966 extern const uint64_t MIN_RELAY_FEE_SAT_PER_1000_WEIGHT;
3968 extern const uint64_t CLOSED_CHANNEL_UPDATE_ID;
3970 extern const uintptr_t REVOKEABLE_REDEEMSCRIPT_MAX_LENGTH;
3972 void Transaction_free(struct LDKTransaction _res);
3974 void TxOut_free(struct LDKTxOut _res);
3976 struct LDKTxOut TxOut_clone(const struct LDKTxOut *NONNULL_PTR orig);
3978 struct LDKCResult_SecretKeyErrorZ CResult_SecretKeyErrorZ_ok(struct LDKSecretKey o);
3980 struct LDKCResult_SecretKeyErrorZ CResult_SecretKeyErrorZ_err(enum LDKSecp256k1Error e);
3982 void CResult_SecretKeyErrorZ_free(struct LDKCResult_SecretKeyErrorZ _res);
3984 struct LDKCResult_PublicKeyErrorZ CResult_PublicKeyErrorZ_ok(struct LDKPublicKey o);
3986 struct LDKCResult_PublicKeyErrorZ CResult_PublicKeyErrorZ_err(enum LDKSecp256k1Error e);
3988 void CResult_PublicKeyErrorZ_free(struct LDKCResult_PublicKeyErrorZ _res);
3990 struct LDKCResult_TxCreationKeysDecodeErrorZ CResult_TxCreationKeysDecodeErrorZ_ok(struct LDKTxCreationKeys o);
3992 struct LDKCResult_TxCreationKeysDecodeErrorZ CResult_TxCreationKeysDecodeErrorZ_err(struct LDKDecodeError e);
3994 void CResult_TxCreationKeysDecodeErrorZ_free(struct LDKCResult_TxCreationKeysDecodeErrorZ _res);
3996 struct LDKCResult_TxCreationKeysDecodeErrorZ CResult_TxCreationKeysDecodeErrorZ_clone(const struct LDKCResult_TxCreationKeysDecodeErrorZ *NONNULL_PTR orig);
3998 struct LDKCResult_ChannelPublicKeysDecodeErrorZ CResult_ChannelPublicKeysDecodeErrorZ_ok(struct LDKChannelPublicKeys o);
4000 struct LDKCResult_ChannelPublicKeysDecodeErrorZ CResult_ChannelPublicKeysDecodeErrorZ_err(struct LDKDecodeError e);
4002 void CResult_ChannelPublicKeysDecodeErrorZ_free(struct LDKCResult_ChannelPublicKeysDecodeErrorZ _res);
4004 struct LDKCResult_ChannelPublicKeysDecodeErrorZ CResult_ChannelPublicKeysDecodeErrorZ_clone(const struct LDKCResult_ChannelPublicKeysDecodeErrorZ *NONNULL_PTR orig);
4006 struct LDKCResult_TxCreationKeysErrorZ CResult_TxCreationKeysErrorZ_ok(struct LDKTxCreationKeys o);
4008 struct LDKCResult_TxCreationKeysErrorZ CResult_TxCreationKeysErrorZ_err(enum LDKSecp256k1Error e);
4010 void CResult_TxCreationKeysErrorZ_free(struct LDKCResult_TxCreationKeysErrorZ _res);
4012 struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ CResult_HTLCOutputInCommitmentDecodeErrorZ_ok(struct LDKHTLCOutputInCommitment o);
4014 struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ CResult_HTLCOutputInCommitmentDecodeErrorZ_err(struct LDKDecodeError e);
4016 void CResult_HTLCOutputInCommitmentDecodeErrorZ_free(struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ _res);
4018 struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ CResult_HTLCOutputInCommitmentDecodeErrorZ_clone(const struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ *NONNULL_PTR orig);
4020 struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ CResult_CounterpartyChannelTransactionParametersDecodeErrorZ_ok(struct LDKCounterpartyChannelTransactionParameters o);
4022 struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ CResult_CounterpartyChannelTransactionParametersDecodeErrorZ_err(struct LDKDecodeError e);
4024 void CResult_CounterpartyChannelTransactionParametersDecodeErrorZ_free(struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ _res);
4026 struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ CResult_CounterpartyChannelTransactionParametersDecodeErrorZ_clone(const struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ *NONNULL_PTR orig);
4028 struct LDKCResult_ChannelTransactionParametersDecodeErrorZ CResult_ChannelTransactionParametersDecodeErrorZ_ok(struct LDKChannelTransactionParameters o);
4030 struct LDKCResult_ChannelTransactionParametersDecodeErrorZ CResult_ChannelTransactionParametersDecodeErrorZ_err(struct LDKDecodeError e);
4032 void CResult_ChannelTransactionParametersDecodeErrorZ_free(struct LDKCResult_ChannelTransactionParametersDecodeErrorZ _res);
4034 struct LDKCResult_ChannelTransactionParametersDecodeErrorZ CResult_ChannelTransactionParametersDecodeErrorZ_clone(const struct LDKCResult_ChannelTransactionParametersDecodeErrorZ *NONNULL_PTR orig);
4036 void CVec_SignatureZ_free(struct LDKCVec_SignatureZ _res);
4038 struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ CResult_HolderCommitmentTransactionDecodeErrorZ_ok(struct LDKHolderCommitmentTransaction o);
4040 struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ CResult_HolderCommitmentTransactionDecodeErrorZ_err(struct LDKDecodeError e);
4042 void CResult_HolderCommitmentTransactionDecodeErrorZ_free(struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ _res);
4044 struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ CResult_HolderCommitmentTransactionDecodeErrorZ_clone(const struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ *NONNULL_PTR orig);
4046 struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ CResult_BuiltCommitmentTransactionDecodeErrorZ_ok(struct LDKBuiltCommitmentTransaction o);
4048 struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ CResult_BuiltCommitmentTransactionDecodeErrorZ_err(struct LDKDecodeError e);
4050 void CResult_BuiltCommitmentTransactionDecodeErrorZ_free(struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ _res);
4052 struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ CResult_BuiltCommitmentTransactionDecodeErrorZ_clone(const struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ *NONNULL_PTR orig);
4054 struct LDKCResult_CommitmentTransactionDecodeErrorZ CResult_CommitmentTransactionDecodeErrorZ_ok(struct LDKCommitmentTransaction o);
4056 struct LDKCResult_CommitmentTransactionDecodeErrorZ CResult_CommitmentTransactionDecodeErrorZ_err(struct LDKDecodeError e);
4058 void CResult_CommitmentTransactionDecodeErrorZ_free(struct LDKCResult_CommitmentTransactionDecodeErrorZ _res);
4060 struct LDKCResult_CommitmentTransactionDecodeErrorZ CResult_CommitmentTransactionDecodeErrorZ_clone(const struct LDKCResult_CommitmentTransactionDecodeErrorZ *NONNULL_PTR orig);
4062 struct LDKCResult_TrustedCommitmentTransactionNoneZ CResult_TrustedCommitmentTransactionNoneZ_ok(struct LDKTrustedCommitmentTransaction o);
4064 struct LDKCResult_TrustedCommitmentTransactionNoneZ CResult_TrustedCommitmentTransactionNoneZ_err(void);
4066 void CResult_TrustedCommitmentTransactionNoneZ_free(struct LDKCResult_TrustedCommitmentTransactionNoneZ _res);
4068 struct LDKCResult_CVec_SignatureZNoneZ CResult_CVec_SignatureZNoneZ_ok(struct LDKCVec_SignatureZ o);
4070 struct LDKCResult_CVec_SignatureZNoneZ CResult_CVec_SignatureZNoneZ_err(void);
4072 void CResult_CVec_SignatureZNoneZ_free(struct LDKCResult_CVec_SignatureZNoneZ _res);
4074 struct LDKCResult_CVec_SignatureZNoneZ CResult_CVec_SignatureZNoneZ_clone(const struct LDKCResult_CVec_SignatureZNoneZ *NONNULL_PTR orig);
4076 void CVec_PublicKeyZ_free(struct LDKCVec_PublicKeyZ _res);
4078 void CVec_u8Z_free(struct LDKCVec_u8Z _res);
4080 struct LDKCResult_CVec_u8ZPeerHandleErrorZ CResult_CVec_u8ZPeerHandleErrorZ_ok(struct LDKCVec_u8Z o);
4082 struct LDKCResult_CVec_u8ZPeerHandleErrorZ CResult_CVec_u8ZPeerHandleErrorZ_err(struct LDKPeerHandleError e);
4084 void CResult_CVec_u8ZPeerHandleErrorZ_free(struct LDKCResult_CVec_u8ZPeerHandleErrorZ _res);
4086 struct LDKCResult_CVec_u8ZPeerHandleErrorZ CResult_CVec_u8ZPeerHandleErrorZ_clone(const struct LDKCResult_CVec_u8ZPeerHandleErrorZ *NONNULL_PTR orig);
4088 struct LDKCResult_NonePeerHandleErrorZ CResult_NonePeerHandleErrorZ_ok(void);
4090 struct LDKCResult_NonePeerHandleErrorZ CResult_NonePeerHandleErrorZ_err(struct LDKPeerHandleError e);
4092 void CResult_NonePeerHandleErrorZ_free(struct LDKCResult_NonePeerHandleErrorZ _res);
4094 struct LDKCResult_NonePeerHandleErrorZ CResult_NonePeerHandleErrorZ_clone(const struct LDKCResult_NonePeerHandleErrorZ *NONNULL_PTR orig);
4096 struct LDKCResult_boolPeerHandleErrorZ CResult_boolPeerHandleErrorZ_ok(bool o);
4098 struct LDKCResult_boolPeerHandleErrorZ CResult_boolPeerHandleErrorZ_err(struct LDKPeerHandleError e);
4100 void CResult_boolPeerHandleErrorZ_free(struct LDKCResult_boolPeerHandleErrorZ _res);
4102 struct LDKCResult_boolPeerHandleErrorZ CResult_boolPeerHandleErrorZ_clone(const struct LDKCResult_boolPeerHandleErrorZ *NONNULL_PTR orig);
4104 struct LDKCResult_InitFeaturesDecodeErrorZ CResult_InitFeaturesDecodeErrorZ_ok(struct LDKInitFeatures o);
4106 struct LDKCResult_InitFeaturesDecodeErrorZ CResult_InitFeaturesDecodeErrorZ_err(struct LDKDecodeError e);
4108 void CResult_InitFeaturesDecodeErrorZ_free(struct LDKCResult_InitFeaturesDecodeErrorZ _res);
4110 struct LDKCResult_NodeFeaturesDecodeErrorZ CResult_NodeFeaturesDecodeErrorZ_ok(struct LDKNodeFeatures o);
4112 struct LDKCResult_NodeFeaturesDecodeErrorZ CResult_NodeFeaturesDecodeErrorZ_err(struct LDKDecodeError e);
4114 void CResult_NodeFeaturesDecodeErrorZ_free(struct LDKCResult_NodeFeaturesDecodeErrorZ _res);
4116 struct LDKCResult_ChannelFeaturesDecodeErrorZ CResult_ChannelFeaturesDecodeErrorZ_ok(struct LDKChannelFeatures o);
4118 struct LDKCResult_ChannelFeaturesDecodeErrorZ CResult_ChannelFeaturesDecodeErrorZ_err(struct LDKDecodeError e);
4120 void CResult_ChannelFeaturesDecodeErrorZ_free(struct LDKCResult_ChannelFeaturesDecodeErrorZ _res);
4122 struct LDKCResult_ChannelConfigDecodeErrorZ CResult_ChannelConfigDecodeErrorZ_ok(struct LDKChannelConfig o);
4124 struct LDKCResult_ChannelConfigDecodeErrorZ CResult_ChannelConfigDecodeErrorZ_err(struct LDKDecodeError e);
4126 void CResult_ChannelConfigDecodeErrorZ_free(struct LDKCResult_ChannelConfigDecodeErrorZ _res);
4128 struct LDKCResult_ChannelConfigDecodeErrorZ CResult_ChannelConfigDecodeErrorZ_clone(const struct LDKCResult_ChannelConfigDecodeErrorZ *NONNULL_PTR orig);
4130 struct LDKCResult_boolLightningErrorZ CResult_boolLightningErrorZ_ok(bool o);
4132 struct LDKCResult_boolLightningErrorZ CResult_boolLightningErrorZ_err(struct LDKLightningError e);
4134 void CResult_boolLightningErrorZ_free(struct LDKCResult_boolLightningErrorZ _res);
4136 struct LDKCResult_boolLightningErrorZ CResult_boolLightningErrorZ_clone(const struct LDKCResult_boolLightningErrorZ *NONNULL_PTR orig);
4138 struct LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_clone(const struct LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ *NONNULL_PTR orig);
4140 struct LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_new(struct LDKChannelAnnouncement a, struct LDKChannelUpdate b, struct LDKChannelUpdate c);
4142 void C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ_free(struct LDKC3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZ _res);
4144 void CVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ_free(struct LDKCVec_C3Tuple_ChannelAnnouncementChannelUpdateChannelUpdateZZ _res);
4146 void CVec_NodeAnnouncementZ_free(struct LDKCVec_NodeAnnouncementZ _res);
4148 struct LDKCResult_NoneLightningErrorZ CResult_NoneLightningErrorZ_ok(void);
4150 struct LDKCResult_NoneLightningErrorZ CResult_NoneLightningErrorZ_err(struct LDKLightningError e);
4152 void CResult_NoneLightningErrorZ_free(struct LDKCResult_NoneLightningErrorZ _res);
4154 struct LDKCResult_NoneLightningErrorZ CResult_NoneLightningErrorZ_clone(const struct LDKCResult_NoneLightningErrorZ *NONNULL_PTR orig);
4156 void CVec_MessageSendEventZ_free(struct LDKCVec_MessageSendEventZ _res);
4158 struct LDKCResult_DirectionalChannelInfoDecodeErrorZ CResult_DirectionalChannelInfoDecodeErrorZ_ok(struct LDKDirectionalChannelInfo o);
4160 struct LDKCResult_DirectionalChannelInfoDecodeErrorZ CResult_DirectionalChannelInfoDecodeErrorZ_err(struct LDKDecodeError e);
4162 void CResult_DirectionalChannelInfoDecodeErrorZ_free(struct LDKCResult_DirectionalChannelInfoDecodeErrorZ _res);
4164 struct LDKCResult_DirectionalChannelInfoDecodeErrorZ CResult_DirectionalChannelInfoDecodeErrorZ_clone(const struct LDKCResult_DirectionalChannelInfoDecodeErrorZ *NONNULL_PTR orig);
4166 struct LDKCResult_ChannelInfoDecodeErrorZ CResult_ChannelInfoDecodeErrorZ_ok(struct LDKChannelInfo o);
4168 struct LDKCResult_ChannelInfoDecodeErrorZ CResult_ChannelInfoDecodeErrorZ_err(struct LDKDecodeError e);
4170 void CResult_ChannelInfoDecodeErrorZ_free(struct LDKCResult_ChannelInfoDecodeErrorZ _res);
4172 struct LDKCResult_ChannelInfoDecodeErrorZ CResult_ChannelInfoDecodeErrorZ_clone(const struct LDKCResult_ChannelInfoDecodeErrorZ *NONNULL_PTR orig);
4174 struct LDKCResult_RoutingFeesDecodeErrorZ CResult_RoutingFeesDecodeErrorZ_ok(struct LDKRoutingFees o);
4176 struct LDKCResult_RoutingFeesDecodeErrorZ CResult_RoutingFeesDecodeErrorZ_err(struct LDKDecodeError e);
4178 void CResult_RoutingFeesDecodeErrorZ_free(struct LDKCResult_RoutingFeesDecodeErrorZ _res);
4180 struct LDKCResult_RoutingFeesDecodeErrorZ CResult_RoutingFeesDecodeErrorZ_clone(const struct LDKCResult_RoutingFeesDecodeErrorZ *NONNULL_PTR orig);
4182 void CVec_NetAddressZ_free(struct LDKCVec_NetAddressZ _res);
4184 struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ CResult_NodeAnnouncementInfoDecodeErrorZ_ok(struct LDKNodeAnnouncementInfo o);
4186 struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ CResult_NodeAnnouncementInfoDecodeErrorZ_err(struct LDKDecodeError e);
4188 void CResult_NodeAnnouncementInfoDecodeErrorZ_free(struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ _res);
4190 struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ CResult_NodeAnnouncementInfoDecodeErrorZ_clone(const struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ *NONNULL_PTR orig);
4192 void CVec_u64Z_free(struct LDKCVec_u64Z _res);
4194 struct LDKCResult_NodeInfoDecodeErrorZ CResult_NodeInfoDecodeErrorZ_ok(struct LDKNodeInfo o);
4196 struct LDKCResult_NodeInfoDecodeErrorZ CResult_NodeInfoDecodeErrorZ_err(struct LDKDecodeError e);
4198 void CResult_NodeInfoDecodeErrorZ_free(struct LDKCResult_NodeInfoDecodeErrorZ _res);
4200 struct LDKCResult_NodeInfoDecodeErrorZ CResult_NodeInfoDecodeErrorZ_clone(const struct LDKCResult_NodeInfoDecodeErrorZ *NONNULL_PTR orig);
4202 struct LDKCResult_NetworkGraphDecodeErrorZ CResult_NetworkGraphDecodeErrorZ_ok(struct LDKNetworkGraph o);
4204 struct LDKCResult_NetworkGraphDecodeErrorZ CResult_NetworkGraphDecodeErrorZ_err(struct LDKDecodeError e);
4206 void CResult_NetworkGraphDecodeErrorZ_free(struct LDKCResult_NetworkGraphDecodeErrorZ _res);
4208 struct LDKCResult_NetworkGraphDecodeErrorZ CResult_NetworkGraphDecodeErrorZ_clone(const struct LDKCResult_NetworkGraphDecodeErrorZ *NONNULL_PTR orig);
4210 struct LDKC2Tuple_usizeTransactionZ C2Tuple_usizeTransactionZ_new(uintptr_t a, struct LDKTransaction b);
4212 void C2Tuple_usizeTransactionZ_free(struct LDKC2Tuple_usizeTransactionZ _res);
4214 void CVec_C2Tuple_usizeTransactionZZ_free(struct LDKCVec_C2Tuple_usizeTransactionZZ _res);
4216 struct LDKCResult_NoneChannelMonitorUpdateErrZ CResult_NoneChannelMonitorUpdateErrZ_ok(void);
4218 struct LDKCResult_NoneChannelMonitorUpdateErrZ CResult_NoneChannelMonitorUpdateErrZ_err(enum LDKChannelMonitorUpdateErr e);
4220 void CResult_NoneChannelMonitorUpdateErrZ_free(struct LDKCResult_NoneChannelMonitorUpdateErrZ _res);
4222 struct LDKCResult_NoneChannelMonitorUpdateErrZ CResult_NoneChannelMonitorUpdateErrZ_clone(const struct LDKCResult_NoneChannelMonitorUpdateErrZ *NONNULL_PTR orig);
4224 void CVec_MonitorEventZ_free(struct LDKCVec_MonitorEventZ _res);
4226 void CVec_EventZ_free(struct LDKCVec_EventZ _res);
4228 struct LDKCResult_OutPointDecodeErrorZ CResult_OutPointDecodeErrorZ_ok(struct LDKOutPoint o);
4230 struct LDKCResult_OutPointDecodeErrorZ CResult_OutPointDecodeErrorZ_err(struct LDKDecodeError e);
4232 void CResult_OutPointDecodeErrorZ_free(struct LDKCResult_OutPointDecodeErrorZ _res);
4234 struct LDKCResult_OutPointDecodeErrorZ CResult_OutPointDecodeErrorZ_clone(const struct LDKCResult_OutPointDecodeErrorZ *NONNULL_PTR orig);
4236 struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ CResult_ChannelMonitorUpdateDecodeErrorZ_ok(struct LDKChannelMonitorUpdate o);
4238 struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ CResult_ChannelMonitorUpdateDecodeErrorZ_err(struct LDKDecodeError e);
4240 void CResult_ChannelMonitorUpdateDecodeErrorZ_free(struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ _res);
4242 struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ CResult_ChannelMonitorUpdateDecodeErrorZ_clone(const struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ *NONNULL_PTR orig);
4244 struct LDKCResult_HTLCUpdateDecodeErrorZ CResult_HTLCUpdateDecodeErrorZ_ok(struct LDKHTLCUpdate o);
4246 struct LDKCResult_HTLCUpdateDecodeErrorZ CResult_HTLCUpdateDecodeErrorZ_err(struct LDKDecodeError e);
4248 void CResult_HTLCUpdateDecodeErrorZ_free(struct LDKCResult_HTLCUpdateDecodeErrorZ _res);
4250 struct LDKCResult_HTLCUpdateDecodeErrorZ CResult_HTLCUpdateDecodeErrorZ_clone(const struct LDKCResult_HTLCUpdateDecodeErrorZ *NONNULL_PTR orig);
4252 struct LDKCResult_NoneMonitorUpdateErrorZ CResult_NoneMonitorUpdateErrorZ_ok(void);
4254 struct LDKCResult_NoneMonitorUpdateErrorZ CResult_NoneMonitorUpdateErrorZ_err(struct LDKMonitorUpdateError e);
4256 void CResult_NoneMonitorUpdateErrorZ_free(struct LDKCResult_NoneMonitorUpdateErrorZ _res);
4258 struct LDKCResult_NoneMonitorUpdateErrorZ CResult_NoneMonitorUpdateErrorZ_clone(const struct LDKCResult_NoneMonitorUpdateErrorZ *NONNULL_PTR orig);
4260 struct LDKC2Tuple_OutPointScriptZ C2Tuple_OutPointScriptZ_clone(const struct LDKC2Tuple_OutPointScriptZ *NONNULL_PTR orig);
4262 struct LDKC2Tuple_OutPointScriptZ C2Tuple_OutPointScriptZ_new(struct LDKOutPoint a, struct LDKCVec_u8Z b);
4264 void C2Tuple_OutPointScriptZ_free(struct LDKC2Tuple_OutPointScriptZ _res);
4266 void CVec_TransactionZ_free(struct LDKCVec_TransactionZ _res);
4268 struct LDKC2Tuple_u32TxOutZ C2Tuple_u32TxOutZ_clone(const struct LDKC2Tuple_u32TxOutZ *NONNULL_PTR orig);
4270 struct LDKC2Tuple_u32TxOutZ C2Tuple_u32TxOutZ_new(uint32_t a, struct LDKTxOut b);
4272 void C2Tuple_u32TxOutZ_free(struct LDKC2Tuple_u32TxOutZ _res);
4274 void CVec_C2Tuple_u32TxOutZZ_free(struct LDKCVec_C2Tuple_u32TxOutZZ _res);
4276 struct LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ_new(struct LDKThirtyTwoBytes a, struct LDKCVec_C2Tuple_u32TxOutZZ b);
4278 void C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ_free(struct LDKC2Tuple_TxidCVec_C2Tuple_u32TxOutZZZ _res);
4280 void CVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ_free(struct LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ _res);
4282 struct LDKC2Tuple_BlockHashChannelMonitorZ C2Tuple_BlockHashChannelMonitorZ_new(struct LDKThirtyTwoBytes a, struct LDKChannelMonitor b);
4284 void C2Tuple_BlockHashChannelMonitorZ_free(struct LDKC2Tuple_BlockHashChannelMonitorZ _res);
4286 struct LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ CResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ_ok(struct LDKC2Tuple_BlockHashChannelMonitorZ o);
4288 struct LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ CResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ_err(struct LDKDecodeError e);
4290 void CResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ_free(struct LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ _res);
4292 void CVec_SpendableOutputDescriptorZ_free(struct LDKCVec_SpendableOutputDescriptorZ _res);
4294 struct LDKCResult_TxOutAccessErrorZ CResult_TxOutAccessErrorZ_ok(struct LDKTxOut o);
4296 struct LDKCResult_TxOutAccessErrorZ CResult_TxOutAccessErrorZ_err(enum LDKAccessError e);
4298 void CResult_TxOutAccessErrorZ_free(struct LDKCResult_TxOutAccessErrorZ _res);
4300 struct LDKCResult_TxOutAccessErrorZ CResult_TxOutAccessErrorZ_clone(const struct LDKCResult_TxOutAccessErrorZ *NONNULL_PTR orig);
4302 struct LDKCResult_NoneAPIErrorZ CResult_NoneAPIErrorZ_ok(void);
4304 struct LDKCResult_NoneAPIErrorZ CResult_NoneAPIErrorZ_err(struct LDKAPIError e);
4306 void CResult_NoneAPIErrorZ_free(struct LDKCResult_NoneAPIErrorZ _res);
4308 struct LDKCResult_NoneAPIErrorZ CResult_NoneAPIErrorZ_clone(const struct LDKCResult_NoneAPIErrorZ *NONNULL_PTR orig);
4310 void CVec_CResult_NoneAPIErrorZZ_free(struct LDKCVec_CResult_NoneAPIErrorZZ _res);
4312 void CVec_APIErrorZ_free(struct LDKCVec_APIErrorZ _res);
4314 void CVec_ChannelDetailsZ_free(struct LDKCVec_ChannelDetailsZ _res);
4316 struct LDKCResult_NonePaymentSendFailureZ CResult_NonePaymentSendFailureZ_ok(void);
4318 struct LDKCResult_NonePaymentSendFailureZ CResult_NonePaymentSendFailureZ_err(struct LDKPaymentSendFailure e);
4320 void CResult_NonePaymentSendFailureZ_free(struct LDKCResult_NonePaymentSendFailureZ _res);
4322 struct LDKCResult_NonePaymentSendFailureZ CResult_NonePaymentSendFailureZ_clone(const struct LDKCResult_NonePaymentSendFailureZ *NONNULL_PTR orig);
4324 void CVec_ChannelMonitorZ_free(struct LDKCVec_ChannelMonitorZ _res);
4326 struct LDKC2Tuple_BlockHashChannelManagerZ C2Tuple_BlockHashChannelManagerZ_new(struct LDKThirtyTwoBytes a, struct LDKChannelManager b);
4328 void C2Tuple_BlockHashChannelManagerZ_free(struct LDKC2Tuple_BlockHashChannelManagerZ _res);
4330 struct LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ CResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ_ok(struct LDKC2Tuple_BlockHashChannelManagerZ o);
4332 struct LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ CResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ_err(struct LDKDecodeError e);
4334 void CResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ_free(struct LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ _res);
4336 struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ CResult_SpendableOutputDescriptorDecodeErrorZ_ok(struct LDKSpendableOutputDescriptor o);
4338 struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ CResult_SpendableOutputDescriptorDecodeErrorZ_err(struct LDKDecodeError e);
4340 void CResult_SpendableOutputDescriptorDecodeErrorZ_free(struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ _res);
4342 struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ CResult_SpendableOutputDescriptorDecodeErrorZ_clone(const struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ *NONNULL_PTR orig);
4344 struct LDKC2Tuple_SignatureCVec_SignatureZZ C2Tuple_SignatureCVec_SignatureZZ_clone(const struct LDKC2Tuple_SignatureCVec_SignatureZZ *NONNULL_PTR orig);
4346 struct LDKC2Tuple_SignatureCVec_SignatureZZ C2Tuple_SignatureCVec_SignatureZZ_new(struct LDKSignature a, struct LDKCVec_SignatureZ b);
4348 void C2Tuple_SignatureCVec_SignatureZZ_free(struct LDKC2Tuple_SignatureCVec_SignatureZZ _res);
4350 struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_ok(struct LDKC2Tuple_SignatureCVec_SignatureZZ o);
4352 struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_err(void);
4354 void CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_free(struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ _res);
4356 struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ CResult_C2Tuple_SignatureCVec_SignatureZZNoneZ_clone(const struct LDKCResult_C2Tuple_SignatureCVec_SignatureZZNoneZ *NONNULL_PTR orig);
4358 struct LDKCResult_SignatureNoneZ CResult_SignatureNoneZ_ok(struct LDKSignature o);
4360 struct LDKCResult_SignatureNoneZ CResult_SignatureNoneZ_err(void);
4362 void CResult_SignatureNoneZ_free(struct LDKCResult_SignatureNoneZ _res);
4364 struct LDKCResult_SignatureNoneZ CResult_SignatureNoneZ_clone(const struct LDKCResult_SignatureNoneZ *NONNULL_PTR orig);
4366 struct LDKCResult_SignDecodeErrorZ CResult_SignDecodeErrorZ_ok(struct LDKSign o);
4368 struct LDKCResult_SignDecodeErrorZ CResult_SignDecodeErrorZ_err(struct LDKDecodeError e);
4370 void CResult_SignDecodeErrorZ_free(struct LDKCResult_SignDecodeErrorZ _res);
4372 struct LDKCResult_SignDecodeErrorZ CResult_SignDecodeErrorZ_clone(const struct LDKCResult_SignDecodeErrorZ *NONNULL_PTR orig);
4374 void CVec_CVec_u8ZZ_free(struct LDKCVec_CVec_u8ZZ _res);
4376 struct LDKCResult_CVec_CVec_u8ZZNoneZ CResult_CVec_CVec_u8ZZNoneZ_ok(struct LDKCVec_CVec_u8ZZ o);
4378 struct LDKCResult_CVec_CVec_u8ZZNoneZ CResult_CVec_CVec_u8ZZNoneZ_err(void);
4380 void CResult_CVec_CVec_u8ZZNoneZ_free(struct LDKCResult_CVec_CVec_u8ZZNoneZ _res);
4382 struct LDKCResult_CVec_CVec_u8ZZNoneZ CResult_CVec_CVec_u8ZZNoneZ_clone(const struct LDKCResult_CVec_CVec_u8ZZNoneZ *NONNULL_PTR orig);
4384 struct LDKCResult_InMemorySignerDecodeErrorZ CResult_InMemorySignerDecodeErrorZ_ok(struct LDKInMemorySigner o);
4386 struct LDKCResult_InMemorySignerDecodeErrorZ CResult_InMemorySignerDecodeErrorZ_err(struct LDKDecodeError e);
4388 void CResult_InMemorySignerDecodeErrorZ_free(struct LDKCResult_InMemorySignerDecodeErrorZ _res);
4390 struct LDKCResult_InMemorySignerDecodeErrorZ CResult_InMemorySignerDecodeErrorZ_clone(const struct LDKCResult_InMemorySignerDecodeErrorZ *NONNULL_PTR orig);
4392 void CVec_TxOutZ_free(struct LDKCVec_TxOutZ _res);
4394 struct LDKCResult_TransactionNoneZ CResult_TransactionNoneZ_ok(struct LDKTransaction o);
4396 struct LDKCResult_TransactionNoneZ CResult_TransactionNoneZ_err(void);
4398 void CResult_TransactionNoneZ_free(struct LDKCResult_TransactionNoneZ _res);
4400 void CVec_RouteHopZ_free(struct LDKCVec_RouteHopZ _res);
4402 void CVec_CVec_RouteHopZZ_free(struct LDKCVec_CVec_RouteHopZZ _res);
4404 struct LDKCResult_RouteDecodeErrorZ CResult_RouteDecodeErrorZ_ok(struct LDKRoute o);
4406 struct LDKCResult_RouteDecodeErrorZ CResult_RouteDecodeErrorZ_err(struct LDKDecodeError e);
4408 void CResult_RouteDecodeErrorZ_free(struct LDKCResult_RouteDecodeErrorZ _res);
4410 struct LDKCResult_RouteDecodeErrorZ CResult_RouteDecodeErrorZ_clone(const struct LDKCResult_RouteDecodeErrorZ *NONNULL_PTR orig);
4412 void CVec_RouteHintZ_free(struct LDKCVec_RouteHintZ _res);
4414 struct LDKCResult_RouteLightningErrorZ CResult_RouteLightningErrorZ_ok(struct LDKRoute o);
4416 struct LDKCResult_RouteLightningErrorZ CResult_RouteLightningErrorZ_err(struct LDKLightningError e);
4418 void CResult_RouteLightningErrorZ_free(struct LDKCResult_RouteLightningErrorZ _res);
4420 struct LDKCResult_RouteLightningErrorZ CResult_RouteLightningErrorZ_clone(const struct LDKCResult_RouteLightningErrorZ *NONNULL_PTR orig);
4422 struct LDKCResult_NetAddressu8Z CResult_NetAddressu8Z_ok(struct LDKNetAddress o);
4424 struct LDKCResult_NetAddressu8Z CResult_NetAddressu8Z_err(uint8_t e);
4426 void CResult_NetAddressu8Z_free(struct LDKCResult_NetAddressu8Z _res);
4428 struct LDKCResult_NetAddressu8Z CResult_NetAddressu8Z_clone(const struct LDKCResult_NetAddressu8Z *NONNULL_PTR orig);
4430 struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ CResult_CResult_NetAddressu8ZDecodeErrorZ_ok(struct LDKCResult_NetAddressu8Z o);
4432 struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ CResult_CResult_NetAddressu8ZDecodeErrorZ_err(struct LDKDecodeError e);
4434 void CResult_CResult_NetAddressu8ZDecodeErrorZ_free(struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ _res);
4436 struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ CResult_CResult_NetAddressu8ZDecodeErrorZ_clone(const struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ *NONNULL_PTR orig);
4438 void CVec_UpdateAddHTLCZ_free(struct LDKCVec_UpdateAddHTLCZ _res);
4440 void CVec_UpdateFulfillHTLCZ_free(struct LDKCVec_UpdateFulfillHTLCZ _res);
4442 void CVec_UpdateFailHTLCZ_free(struct LDKCVec_UpdateFailHTLCZ _res);
4444 void CVec_UpdateFailMalformedHTLCZ_free(struct LDKCVec_UpdateFailMalformedHTLCZ _res);
4446 struct LDKCResult_AcceptChannelDecodeErrorZ CResult_AcceptChannelDecodeErrorZ_ok(struct LDKAcceptChannel o);
4448 struct LDKCResult_AcceptChannelDecodeErrorZ CResult_AcceptChannelDecodeErrorZ_err(struct LDKDecodeError e);
4450 void CResult_AcceptChannelDecodeErrorZ_free(struct LDKCResult_AcceptChannelDecodeErrorZ _res);
4452 struct LDKCResult_AcceptChannelDecodeErrorZ CResult_AcceptChannelDecodeErrorZ_clone(const struct LDKCResult_AcceptChannelDecodeErrorZ *NONNULL_PTR orig);
4454 struct LDKCResult_AnnouncementSignaturesDecodeErrorZ CResult_AnnouncementSignaturesDecodeErrorZ_ok(struct LDKAnnouncementSignatures o);
4456 struct LDKCResult_AnnouncementSignaturesDecodeErrorZ CResult_AnnouncementSignaturesDecodeErrorZ_err(struct LDKDecodeError e);
4458 void CResult_AnnouncementSignaturesDecodeErrorZ_free(struct LDKCResult_AnnouncementSignaturesDecodeErrorZ _res);
4460 struct LDKCResult_AnnouncementSignaturesDecodeErrorZ CResult_AnnouncementSignaturesDecodeErrorZ_clone(const struct LDKCResult_AnnouncementSignaturesDecodeErrorZ *NONNULL_PTR orig);
4462 struct LDKCResult_ChannelReestablishDecodeErrorZ CResult_ChannelReestablishDecodeErrorZ_ok(struct LDKChannelReestablish o);
4464 struct LDKCResult_ChannelReestablishDecodeErrorZ CResult_ChannelReestablishDecodeErrorZ_err(struct LDKDecodeError e);
4466 void CResult_ChannelReestablishDecodeErrorZ_free(struct LDKCResult_ChannelReestablishDecodeErrorZ _res);
4468 struct LDKCResult_ChannelReestablishDecodeErrorZ CResult_ChannelReestablishDecodeErrorZ_clone(const struct LDKCResult_ChannelReestablishDecodeErrorZ *NONNULL_PTR orig);
4470 struct LDKCResult_ClosingSignedDecodeErrorZ CResult_ClosingSignedDecodeErrorZ_ok(struct LDKClosingSigned o);
4472 struct LDKCResult_ClosingSignedDecodeErrorZ CResult_ClosingSignedDecodeErrorZ_err(struct LDKDecodeError e);
4474 void CResult_ClosingSignedDecodeErrorZ_free(struct LDKCResult_ClosingSignedDecodeErrorZ _res);
4476 struct LDKCResult_ClosingSignedDecodeErrorZ CResult_ClosingSignedDecodeErrorZ_clone(const struct LDKCResult_ClosingSignedDecodeErrorZ *NONNULL_PTR orig);
4478 struct LDKCResult_CommitmentSignedDecodeErrorZ CResult_CommitmentSignedDecodeErrorZ_ok(struct LDKCommitmentSigned o);
4480 struct LDKCResult_CommitmentSignedDecodeErrorZ CResult_CommitmentSignedDecodeErrorZ_err(struct LDKDecodeError e);
4482 void CResult_CommitmentSignedDecodeErrorZ_free(struct LDKCResult_CommitmentSignedDecodeErrorZ _res);
4484 struct LDKCResult_CommitmentSignedDecodeErrorZ CResult_CommitmentSignedDecodeErrorZ_clone(const struct LDKCResult_CommitmentSignedDecodeErrorZ *NONNULL_PTR orig);
4486 struct LDKCResult_FundingCreatedDecodeErrorZ CResult_FundingCreatedDecodeErrorZ_ok(struct LDKFundingCreated o);
4488 struct LDKCResult_FundingCreatedDecodeErrorZ CResult_FundingCreatedDecodeErrorZ_err(struct LDKDecodeError e);
4490 void CResult_FundingCreatedDecodeErrorZ_free(struct LDKCResult_FundingCreatedDecodeErrorZ _res);
4492 struct LDKCResult_FundingCreatedDecodeErrorZ CResult_FundingCreatedDecodeErrorZ_clone(const struct LDKCResult_FundingCreatedDecodeErrorZ *NONNULL_PTR orig);
4494 struct LDKCResult_FundingSignedDecodeErrorZ CResult_FundingSignedDecodeErrorZ_ok(struct LDKFundingSigned o);
4496 struct LDKCResult_FundingSignedDecodeErrorZ CResult_FundingSignedDecodeErrorZ_err(struct LDKDecodeError e);
4498 void CResult_FundingSignedDecodeErrorZ_free(struct LDKCResult_FundingSignedDecodeErrorZ _res);
4500 struct LDKCResult_FundingSignedDecodeErrorZ CResult_FundingSignedDecodeErrorZ_clone(const struct LDKCResult_FundingSignedDecodeErrorZ *NONNULL_PTR orig);
4502 struct LDKCResult_FundingLockedDecodeErrorZ CResult_FundingLockedDecodeErrorZ_ok(struct LDKFundingLocked o);
4504 struct LDKCResult_FundingLockedDecodeErrorZ CResult_FundingLockedDecodeErrorZ_err(struct LDKDecodeError e);
4506 void CResult_FundingLockedDecodeErrorZ_free(struct LDKCResult_FundingLockedDecodeErrorZ _res);
4508 struct LDKCResult_FundingLockedDecodeErrorZ CResult_FundingLockedDecodeErrorZ_clone(const struct LDKCResult_FundingLockedDecodeErrorZ *NONNULL_PTR orig);
4510 struct LDKCResult_InitDecodeErrorZ CResult_InitDecodeErrorZ_ok(struct LDKInit o);
4512 struct LDKCResult_InitDecodeErrorZ CResult_InitDecodeErrorZ_err(struct LDKDecodeError e);
4514 void CResult_InitDecodeErrorZ_free(struct LDKCResult_InitDecodeErrorZ _res);
4516 struct LDKCResult_InitDecodeErrorZ CResult_InitDecodeErrorZ_clone(const struct LDKCResult_InitDecodeErrorZ *NONNULL_PTR orig);
4518 struct LDKCResult_OpenChannelDecodeErrorZ CResult_OpenChannelDecodeErrorZ_ok(struct LDKOpenChannel o);
4520 struct LDKCResult_OpenChannelDecodeErrorZ CResult_OpenChannelDecodeErrorZ_err(struct LDKDecodeError e);
4522 void CResult_OpenChannelDecodeErrorZ_free(struct LDKCResult_OpenChannelDecodeErrorZ _res);
4524 struct LDKCResult_OpenChannelDecodeErrorZ CResult_OpenChannelDecodeErrorZ_clone(const struct LDKCResult_OpenChannelDecodeErrorZ *NONNULL_PTR orig);
4526 struct LDKCResult_RevokeAndACKDecodeErrorZ CResult_RevokeAndACKDecodeErrorZ_ok(struct LDKRevokeAndACK o);
4528 struct LDKCResult_RevokeAndACKDecodeErrorZ CResult_RevokeAndACKDecodeErrorZ_err(struct LDKDecodeError e);
4530 void CResult_RevokeAndACKDecodeErrorZ_free(struct LDKCResult_RevokeAndACKDecodeErrorZ _res);
4532 struct LDKCResult_RevokeAndACKDecodeErrorZ CResult_RevokeAndACKDecodeErrorZ_clone(const struct LDKCResult_RevokeAndACKDecodeErrorZ *NONNULL_PTR orig);
4534 struct LDKCResult_ShutdownDecodeErrorZ CResult_ShutdownDecodeErrorZ_ok(struct LDKShutdown o);
4536 struct LDKCResult_ShutdownDecodeErrorZ CResult_ShutdownDecodeErrorZ_err(struct LDKDecodeError e);
4538 void CResult_ShutdownDecodeErrorZ_free(struct LDKCResult_ShutdownDecodeErrorZ _res);
4540 struct LDKCResult_ShutdownDecodeErrorZ CResult_ShutdownDecodeErrorZ_clone(const struct LDKCResult_ShutdownDecodeErrorZ *NONNULL_PTR orig);
4542 struct LDKCResult_UpdateFailHTLCDecodeErrorZ CResult_UpdateFailHTLCDecodeErrorZ_ok(struct LDKUpdateFailHTLC o);
4544 struct LDKCResult_UpdateFailHTLCDecodeErrorZ CResult_UpdateFailHTLCDecodeErrorZ_err(struct LDKDecodeError e);
4546 void CResult_UpdateFailHTLCDecodeErrorZ_free(struct LDKCResult_UpdateFailHTLCDecodeErrorZ _res);
4548 struct LDKCResult_UpdateFailHTLCDecodeErrorZ CResult_UpdateFailHTLCDecodeErrorZ_clone(const struct LDKCResult_UpdateFailHTLCDecodeErrorZ *NONNULL_PTR orig);
4550 struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ CResult_UpdateFailMalformedHTLCDecodeErrorZ_ok(struct LDKUpdateFailMalformedHTLC o);
4552 struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ CResult_UpdateFailMalformedHTLCDecodeErrorZ_err(struct LDKDecodeError e);
4554 void CResult_UpdateFailMalformedHTLCDecodeErrorZ_free(struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ _res);
4556 struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ CResult_UpdateFailMalformedHTLCDecodeErrorZ_clone(const struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ *NONNULL_PTR orig);
4558 struct LDKCResult_UpdateFeeDecodeErrorZ CResult_UpdateFeeDecodeErrorZ_ok(struct LDKUpdateFee o);
4560 struct LDKCResult_UpdateFeeDecodeErrorZ CResult_UpdateFeeDecodeErrorZ_err(struct LDKDecodeError e);
4562 void CResult_UpdateFeeDecodeErrorZ_free(struct LDKCResult_UpdateFeeDecodeErrorZ _res);
4564 struct LDKCResult_UpdateFeeDecodeErrorZ CResult_UpdateFeeDecodeErrorZ_clone(const struct LDKCResult_UpdateFeeDecodeErrorZ *NONNULL_PTR orig);
4566 struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ CResult_UpdateFulfillHTLCDecodeErrorZ_ok(struct LDKUpdateFulfillHTLC o);
4568 struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ CResult_UpdateFulfillHTLCDecodeErrorZ_err(struct LDKDecodeError e);
4570 void CResult_UpdateFulfillHTLCDecodeErrorZ_free(struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ _res);
4572 struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ CResult_UpdateFulfillHTLCDecodeErrorZ_clone(const struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ *NONNULL_PTR orig);
4574 struct LDKCResult_UpdateAddHTLCDecodeErrorZ CResult_UpdateAddHTLCDecodeErrorZ_ok(struct LDKUpdateAddHTLC o);
4576 struct LDKCResult_UpdateAddHTLCDecodeErrorZ CResult_UpdateAddHTLCDecodeErrorZ_err(struct LDKDecodeError e);
4578 void CResult_UpdateAddHTLCDecodeErrorZ_free(struct LDKCResult_UpdateAddHTLCDecodeErrorZ _res);
4580 struct LDKCResult_UpdateAddHTLCDecodeErrorZ CResult_UpdateAddHTLCDecodeErrorZ_clone(const struct LDKCResult_UpdateAddHTLCDecodeErrorZ *NONNULL_PTR orig);
4582 struct LDKCResult_PingDecodeErrorZ CResult_PingDecodeErrorZ_ok(struct LDKPing o);
4584 struct LDKCResult_PingDecodeErrorZ CResult_PingDecodeErrorZ_err(struct LDKDecodeError e);
4586 void CResult_PingDecodeErrorZ_free(struct LDKCResult_PingDecodeErrorZ _res);
4588 struct LDKCResult_PingDecodeErrorZ CResult_PingDecodeErrorZ_clone(const struct LDKCResult_PingDecodeErrorZ *NONNULL_PTR orig);
4590 struct LDKCResult_PongDecodeErrorZ CResult_PongDecodeErrorZ_ok(struct LDKPong o);
4592 struct LDKCResult_PongDecodeErrorZ CResult_PongDecodeErrorZ_err(struct LDKDecodeError e);
4594 void CResult_PongDecodeErrorZ_free(struct LDKCResult_PongDecodeErrorZ _res);
4596 struct LDKCResult_PongDecodeErrorZ CResult_PongDecodeErrorZ_clone(const struct LDKCResult_PongDecodeErrorZ *NONNULL_PTR orig);
4598 struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ CResult_UnsignedChannelAnnouncementDecodeErrorZ_ok(struct LDKUnsignedChannelAnnouncement o);
4600 struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ CResult_UnsignedChannelAnnouncementDecodeErrorZ_err(struct LDKDecodeError e);
4602 void CResult_UnsignedChannelAnnouncementDecodeErrorZ_free(struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ _res);
4604 struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ CResult_UnsignedChannelAnnouncementDecodeErrorZ_clone(const struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ *NONNULL_PTR orig);
4606 struct LDKCResult_ChannelAnnouncementDecodeErrorZ CResult_ChannelAnnouncementDecodeErrorZ_ok(struct LDKChannelAnnouncement o);
4608 struct LDKCResult_ChannelAnnouncementDecodeErrorZ CResult_ChannelAnnouncementDecodeErrorZ_err(struct LDKDecodeError e);
4610 void CResult_ChannelAnnouncementDecodeErrorZ_free(struct LDKCResult_ChannelAnnouncementDecodeErrorZ _res);
4612 struct LDKCResult_ChannelAnnouncementDecodeErrorZ CResult_ChannelAnnouncementDecodeErrorZ_clone(const struct LDKCResult_ChannelAnnouncementDecodeErrorZ *NONNULL_PTR orig);
4614 struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ CResult_UnsignedChannelUpdateDecodeErrorZ_ok(struct LDKUnsignedChannelUpdate o);
4616 struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ CResult_UnsignedChannelUpdateDecodeErrorZ_err(struct LDKDecodeError e);
4618 void CResult_UnsignedChannelUpdateDecodeErrorZ_free(struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ _res);
4620 struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ CResult_UnsignedChannelUpdateDecodeErrorZ_clone(const struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ *NONNULL_PTR orig);
4622 struct LDKCResult_ChannelUpdateDecodeErrorZ CResult_ChannelUpdateDecodeErrorZ_ok(struct LDKChannelUpdate o);
4624 struct LDKCResult_ChannelUpdateDecodeErrorZ CResult_ChannelUpdateDecodeErrorZ_err(struct LDKDecodeError e);
4626 void CResult_ChannelUpdateDecodeErrorZ_free(struct LDKCResult_ChannelUpdateDecodeErrorZ _res);
4628 struct LDKCResult_ChannelUpdateDecodeErrorZ CResult_ChannelUpdateDecodeErrorZ_clone(const struct LDKCResult_ChannelUpdateDecodeErrorZ *NONNULL_PTR orig);
4630 struct LDKCResult_ErrorMessageDecodeErrorZ CResult_ErrorMessageDecodeErrorZ_ok(struct LDKErrorMessage o);
4632 struct LDKCResult_ErrorMessageDecodeErrorZ CResult_ErrorMessageDecodeErrorZ_err(struct LDKDecodeError e);
4634 void CResult_ErrorMessageDecodeErrorZ_free(struct LDKCResult_ErrorMessageDecodeErrorZ _res);
4636 struct LDKCResult_ErrorMessageDecodeErrorZ CResult_ErrorMessageDecodeErrorZ_clone(const struct LDKCResult_ErrorMessageDecodeErrorZ *NONNULL_PTR orig);
4638 struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ CResult_UnsignedNodeAnnouncementDecodeErrorZ_ok(struct LDKUnsignedNodeAnnouncement o);
4640 struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ CResult_UnsignedNodeAnnouncementDecodeErrorZ_err(struct LDKDecodeError e);
4642 void CResult_UnsignedNodeAnnouncementDecodeErrorZ_free(struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ _res);
4644 struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ CResult_UnsignedNodeAnnouncementDecodeErrorZ_clone(const struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ *NONNULL_PTR orig);
4646 struct LDKCResult_NodeAnnouncementDecodeErrorZ CResult_NodeAnnouncementDecodeErrorZ_ok(struct LDKNodeAnnouncement o);
4648 struct LDKCResult_NodeAnnouncementDecodeErrorZ CResult_NodeAnnouncementDecodeErrorZ_err(struct LDKDecodeError e);
4650 void CResult_NodeAnnouncementDecodeErrorZ_free(struct LDKCResult_NodeAnnouncementDecodeErrorZ _res);
4652 struct LDKCResult_NodeAnnouncementDecodeErrorZ CResult_NodeAnnouncementDecodeErrorZ_clone(const struct LDKCResult_NodeAnnouncementDecodeErrorZ *NONNULL_PTR orig);
4654 struct LDKCResult_QueryShortChannelIdsDecodeErrorZ CResult_QueryShortChannelIdsDecodeErrorZ_ok(struct LDKQueryShortChannelIds o);
4656 struct LDKCResult_QueryShortChannelIdsDecodeErrorZ CResult_QueryShortChannelIdsDecodeErrorZ_err(struct LDKDecodeError e);
4658 void CResult_QueryShortChannelIdsDecodeErrorZ_free(struct LDKCResult_QueryShortChannelIdsDecodeErrorZ _res);
4660 struct LDKCResult_QueryShortChannelIdsDecodeErrorZ CResult_QueryShortChannelIdsDecodeErrorZ_clone(const struct LDKCResult_QueryShortChannelIdsDecodeErrorZ *NONNULL_PTR orig);
4662 struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ CResult_ReplyShortChannelIdsEndDecodeErrorZ_ok(struct LDKReplyShortChannelIdsEnd o);
4664 struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ CResult_ReplyShortChannelIdsEndDecodeErrorZ_err(struct LDKDecodeError e);
4666 void CResult_ReplyShortChannelIdsEndDecodeErrorZ_free(struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ _res);
4668 struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ CResult_ReplyShortChannelIdsEndDecodeErrorZ_clone(const struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ *NONNULL_PTR orig);
4670 struct LDKCResult_QueryChannelRangeDecodeErrorZ CResult_QueryChannelRangeDecodeErrorZ_ok(struct LDKQueryChannelRange o);
4672 struct LDKCResult_QueryChannelRangeDecodeErrorZ CResult_QueryChannelRangeDecodeErrorZ_err(struct LDKDecodeError e);
4674 void CResult_QueryChannelRangeDecodeErrorZ_free(struct LDKCResult_QueryChannelRangeDecodeErrorZ _res);
4676 struct LDKCResult_QueryChannelRangeDecodeErrorZ CResult_QueryChannelRangeDecodeErrorZ_clone(const struct LDKCResult_QueryChannelRangeDecodeErrorZ *NONNULL_PTR orig);
4678 struct LDKCResult_ReplyChannelRangeDecodeErrorZ CResult_ReplyChannelRangeDecodeErrorZ_ok(struct LDKReplyChannelRange o);
4680 struct LDKCResult_ReplyChannelRangeDecodeErrorZ CResult_ReplyChannelRangeDecodeErrorZ_err(struct LDKDecodeError e);
4682 void CResult_ReplyChannelRangeDecodeErrorZ_free(struct LDKCResult_ReplyChannelRangeDecodeErrorZ _res);
4684 struct LDKCResult_ReplyChannelRangeDecodeErrorZ CResult_ReplyChannelRangeDecodeErrorZ_clone(const struct LDKCResult_ReplyChannelRangeDecodeErrorZ *NONNULL_PTR orig);
4686 struct LDKCResult_GossipTimestampFilterDecodeErrorZ CResult_GossipTimestampFilterDecodeErrorZ_ok(struct LDKGossipTimestampFilter o);
4688 struct LDKCResult_GossipTimestampFilterDecodeErrorZ CResult_GossipTimestampFilterDecodeErrorZ_err(struct LDKDecodeError e);
4690 void CResult_GossipTimestampFilterDecodeErrorZ_free(struct LDKCResult_GossipTimestampFilterDecodeErrorZ _res);
4692 struct LDKCResult_GossipTimestampFilterDecodeErrorZ CResult_GossipTimestampFilterDecodeErrorZ_clone(const struct LDKCResult_GossipTimestampFilterDecodeErrorZ *NONNULL_PTR orig);
4694 void Event_free(struct LDKEvent this_ptr);
4696 struct LDKEvent Event_clone(const struct LDKEvent *NONNULL_PTR orig);
4698 struct LDKCVec_u8Z Event_write(const struct LDKEvent *NONNULL_PTR obj);
4700 void MessageSendEvent_free(struct LDKMessageSendEvent this_ptr);
4702 struct LDKMessageSendEvent MessageSendEvent_clone(const struct LDKMessageSendEvent *NONNULL_PTR orig);
4705 * Calls the free function if one is set
4707 void MessageSendEventsProvider_free(struct LDKMessageSendEventsProvider this_ptr);
4710 * Calls the free function if one is set
4712 void EventsProvider_free(struct LDKEventsProvider this_ptr);
4714 void APIError_free(struct LDKAPIError this_ptr);
4716 struct LDKAPIError APIError_clone(const struct LDKAPIError *NONNULL_PTR orig);
4718 enum LDKLevel Level_clone(const enum LDKLevel *NONNULL_PTR orig);
4721 * Returns the most verbose logging level.
4723 MUST_USE_RES enum LDKLevel Level_max(void);
4726 * Calls the free function if one is set
4728 void Logger_free(struct LDKLogger this_ptr);
4730 void ChannelHandshakeConfig_free(struct LDKChannelHandshakeConfig this_ptr);
4733 * Confirmations we will wait for before considering the channel locked in.
4734 * Applied only for inbound channels (see ChannelHandshakeLimits::max_minimum_depth for the
4735 * equivalent limit applied to outbound channels).
4739 uint32_t ChannelHandshakeConfig_get_minimum_depth(const struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr);
4742 * Confirmations we will wait for before considering the channel locked in.
4743 * Applied only for inbound channels (see ChannelHandshakeLimits::max_minimum_depth for the
4744 * equivalent limit applied to outbound channels).
4748 void ChannelHandshakeConfig_set_minimum_depth(struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr, uint32_t val);
4751 * Set to the amount of time we require our counterparty to wait to claim their money.
4753 * It's one of the main parameter of our security model. We (or one of our watchtowers) MUST
4754 * be online to check for peer having broadcast a revoked transaction to steal our funds
4755 * at least once every our_to_self_delay blocks.
4757 * Meanwhile, asking for a too high delay, we bother peer to freeze funds for nothing in
4758 * case of an honest unilateral channel close, which implicitly decrease the economic value of
4761 * Default value: BREAKDOWN_TIMEOUT (currently 144), we enforce it as a minimum at channel
4762 * opening so you can tweak config to ask for more security, not less.
4764 uint16_t ChannelHandshakeConfig_get_our_to_self_delay(const struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr);
4767 * Set to the amount of time we require our counterparty to wait to claim their money.
4769 * It's one of the main parameter of our security model. We (or one of our watchtowers) MUST
4770 * be online to check for peer having broadcast a revoked transaction to steal our funds
4771 * at least once every our_to_self_delay blocks.
4773 * Meanwhile, asking for a too high delay, we bother peer to freeze funds for nothing in
4774 * case of an honest unilateral channel close, which implicitly decrease the economic value of
4777 * Default value: BREAKDOWN_TIMEOUT (currently 144), we enforce it as a minimum at channel
4778 * opening so you can tweak config to ask for more security, not less.
4780 void ChannelHandshakeConfig_set_our_to_self_delay(struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr, uint16_t val);
4783 * Set to the smallest value HTLC we will accept to process.
4785 * This value is sent to our counterparty on channel-open and we close the channel any time
4786 * our counterparty misbehaves by sending us an HTLC with a value smaller than this.
4788 * Default value: 1. If the value is less than 1, it is ignored and set to 1, as is required
4791 uint64_t ChannelHandshakeConfig_get_our_htlc_minimum_msat(const struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr);
4794 * Set to the smallest value HTLC we will accept to process.
4796 * This value is sent to our counterparty on channel-open and we close the channel any time
4797 * our counterparty misbehaves by sending us an HTLC with a value smaller than this.
4799 * Default value: 1. If the value is less than 1, it is ignored and set to 1, as is required
4802 void ChannelHandshakeConfig_set_our_htlc_minimum_msat(struct LDKChannelHandshakeConfig *NONNULL_PTR this_ptr, uint64_t val);
4804 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);
4806 struct LDKChannelHandshakeConfig ChannelHandshakeConfig_clone(const struct LDKChannelHandshakeConfig *NONNULL_PTR orig);
4808 MUST_USE_RES struct LDKChannelHandshakeConfig ChannelHandshakeConfig_default(void);
4810 void ChannelHandshakeLimits_free(struct LDKChannelHandshakeLimits this_ptr);
4813 * Minimum allowed satoshis when a channel is funded, this is supplied by the sender and so
4814 * only applies to inbound channels.
4818 uint64_t ChannelHandshakeLimits_get_min_funding_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4821 * Minimum allowed satoshis when a channel is funded, this is supplied by the sender and so
4822 * only applies to inbound channels.
4826 void ChannelHandshakeLimits_set_min_funding_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4829 * The remote node sets a limit on the minimum size of HTLCs we can send to them. This allows
4830 * you to limit the maximum minimum-size they can require.
4832 * Default value: u64::max_value.
4834 uint64_t ChannelHandshakeLimits_get_max_htlc_minimum_msat(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4837 * The remote node sets a limit on the minimum size of HTLCs we can send to them. This allows
4838 * you to limit the maximum minimum-size they can require.
4840 * Default value: u64::max_value.
4842 void ChannelHandshakeLimits_set_max_htlc_minimum_msat(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4845 * The remote node sets a limit on the maximum value of pending HTLCs to them at any given
4846 * time to limit their funds exposure to HTLCs. This allows you to set a minimum such value.
4850 uint64_t ChannelHandshakeLimits_get_min_max_htlc_value_in_flight_msat(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4853 * The remote node sets a limit on the maximum value of pending HTLCs to them at any given
4854 * time to limit their funds exposure to HTLCs. This allows you to set a minimum such value.
4858 void ChannelHandshakeLimits_set_min_max_htlc_value_in_flight_msat(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4861 * The remote node will require we keep a certain amount in direct payment to ourselves at all
4862 * time, ensuring that we are able to be punished if we broadcast an old state. This allows to
4863 * you limit the amount which we will have to keep to ourselves (and cannot use for HTLCs).
4865 * Default value: u64::max_value.
4867 uint64_t ChannelHandshakeLimits_get_max_channel_reserve_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4870 * The remote node will require we keep a certain amount in direct payment to ourselves at all
4871 * time, ensuring that we are able to be punished if we broadcast an old state. This allows to
4872 * you limit the amount which we will have to keep to ourselves (and cannot use for HTLCs).
4874 * Default value: u64::max_value.
4876 void ChannelHandshakeLimits_set_max_channel_reserve_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4879 * The remote node sets a limit on the maximum number of pending HTLCs to them at any given
4880 * time. This allows you to set a minimum such value.
4884 uint16_t ChannelHandshakeLimits_get_min_max_accepted_htlcs(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4887 * The remote node sets a limit on the maximum number of pending HTLCs to them at any given
4888 * time. This allows you to set a minimum such value.
4892 void ChannelHandshakeLimits_set_min_max_accepted_htlcs(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint16_t val);
4895 * Outputs below a certain value will not be added to on-chain transactions. The dust value is
4896 * required to always be higher than this value so this only applies to HTLC outputs (and
4897 * potentially to-self outputs before any payments have been made).
4898 * Thus, HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4899 * This setting allows you to set a minimum dust limit for their commitment transactions,
4900 * reflecting the reality that tiny outputs are not considered standard transactions and will
4901 * not propagate through the Bitcoin network.
4903 * Default value: 546, the current dust limit on the Bitcoin network.
4905 uint64_t ChannelHandshakeLimits_get_min_dust_limit_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4908 * Outputs below a certain value will not be added to on-chain transactions. The dust value is
4909 * required to always be higher than this value so this only applies to HTLC outputs (and
4910 * potentially to-self outputs before any payments have been made).
4911 * Thus, HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4912 * This setting allows you to set a minimum dust limit for their commitment transactions,
4913 * reflecting the reality that tiny outputs are not considered standard transactions and will
4914 * not propagate through the Bitcoin network.
4916 * Default value: 546, the current dust limit on the Bitcoin network.
4918 void ChannelHandshakeLimits_set_min_dust_limit_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4921 * Maximum allowed threshold above which outputs will not be generated in their commitment
4923 * HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4925 * Default value: u64::max_value.
4927 uint64_t ChannelHandshakeLimits_get_max_dust_limit_satoshis(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4930 * Maximum allowed threshold above which outputs will not be generated in their commitment
4932 * HTLCs below this amount plus HTLC transaction fees are not enforceable on-chain.
4934 * Default value: u64::max_value.
4936 void ChannelHandshakeLimits_set_max_dust_limit_satoshis(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint64_t val);
4939 * Before a channel is usable the funding transaction will need to be confirmed by at least a
4940 * certain number of blocks, specified by the node which is not the funder (as the funder can
4941 * assume they aren't going to double-spend themselves).
4942 * This config allows you to set a limit on the maximum amount of time to wait.
4944 * Default value: 144, or roughly one day and only applies to outbound channels.
4946 uint32_t ChannelHandshakeLimits_get_max_minimum_depth(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4949 * Before a channel is usable the funding transaction will need to be confirmed by at least a
4950 * certain number of blocks, specified by the node which is not the funder (as the funder can
4951 * assume they aren't going to double-spend themselves).
4952 * This config allows you to set a limit on the maximum amount of time to wait.
4954 * Default value: 144, or roughly one day and only applies to outbound channels.
4956 void ChannelHandshakeLimits_set_max_minimum_depth(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint32_t val);
4959 * Set to force the incoming channel to match our announced channel preference in
4962 * Default value: true, to make the default that no announced channels are possible (which is
4963 * appropriate for any nodes which are not online very reliably).
4965 bool ChannelHandshakeLimits_get_force_announced_channel_preference(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4968 * Set to force the incoming channel to match our announced channel preference in
4971 * Default value: true, to make the default that no announced channels are possible (which is
4972 * appropriate for any nodes which are not online very reliably).
4974 void ChannelHandshakeLimits_set_force_announced_channel_preference(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, bool val);
4977 * Set to the amount of time we're willing to wait to claim money back to us.
4979 * Not checking this value would be a security issue, as our peer would be able to set it to
4980 * max relative lock-time (a year) and we would \"lose\" money as it would be locked for a long time.
4982 * Default value: MAX_LOCAL_BREAKDOWN_TIMEOUT (1008), which we also enforce as a maximum value
4983 * so you can tweak config to reduce the loss of having useless locked funds (if your peer accepts)
4985 uint16_t ChannelHandshakeLimits_get_their_to_self_delay(const struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr);
4988 * Set to the amount of time we're willing to wait to claim money back to us.
4990 * Not checking this value would be a security issue, as our peer would be able to set it to
4991 * max relative lock-time (a year) and we would \"lose\" money as it would be locked for a long time.
4993 * Default value: MAX_LOCAL_BREAKDOWN_TIMEOUT (1008), which we also enforce as a maximum value
4994 * so you can tweak config to reduce the loss of having useless locked funds (if your peer accepts)
4996 void ChannelHandshakeLimits_set_their_to_self_delay(struct LDKChannelHandshakeLimits *NONNULL_PTR this_ptr, uint16_t val);
4998 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);
5000 struct LDKChannelHandshakeLimits ChannelHandshakeLimits_clone(const struct LDKChannelHandshakeLimits *NONNULL_PTR orig);
5002 MUST_USE_RES struct LDKChannelHandshakeLimits ChannelHandshakeLimits_default(void);
5004 void ChannelConfig_free(struct LDKChannelConfig this_ptr);
5007 * Amount (in millionths of a satoshi) the channel will charge per transferred satoshi.
5008 * This may be allowed to change at runtime in a later update, however doing so must result in
5009 * update messages sent to notify all nodes of our updated relay fee.
5013 uint32_t ChannelConfig_get_fee_proportional_millionths(const struct LDKChannelConfig *NONNULL_PTR this_ptr);
5016 * Amount (in millionths of a satoshi) the channel will charge per transferred satoshi.
5017 * This may be allowed to change at runtime in a later update, however doing so must result in
5018 * update messages sent to notify all nodes of our updated relay fee.
5022 void ChannelConfig_set_fee_proportional_millionths(struct LDKChannelConfig *NONNULL_PTR this_ptr, uint32_t val);
5025 * Set to announce the channel publicly and notify all nodes that they can route via this
5028 * This should only be set to true for nodes which expect to be online reliably.
5030 * As the node which funds a channel picks this value this will only apply for new outbound
5031 * channels unless ChannelHandshakeLimits::force_announced_channel_preferences is set.
5033 * This cannot be changed after the initial channel handshake.
5035 * Default value: false.
5037 bool ChannelConfig_get_announced_channel(const struct LDKChannelConfig *NONNULL_PTR this_ptr);
5040 * Set to announce the channel publicly and notify all nodes that they can route via this
5043 * This should only be set to true for nodes which expect to be online reliably.
5045 * As the node which funds a channel picks this value this will only apply for new outbound
5046 * channels unless ChannelHandshakeLimits::force_announced_channel_preferences is set.
5048 * This cannot be changed after the initial channel handshake.
5050 * Default value: false.
5052 void ChannelConfig_set_announced_channel(struct LDKChannelConfig *NONNULL_PTR this_ptr, bool val);
5055 * When set, we commit to an upfront shutdown_pubkey at channel open. If our counterparty
5056 * supports it, they will then enforce the mutual-close output to us matches what we provided
5057 * at intialization, preventing us from closing to an alternate pubkey.
5059 * This is set to true by default to provide a slight increase in security, though ultimately
5060 * any attacker who is able to take control of a channel can just as easily send the funds via
5061 * lightning payments, so we never require that our counterparties support this option.
5063 * This cannot be changed after a channel has been initialized.
5065 * Default value: true.
5067 bool ChannelConfig_get_commit_upfront_shutdown_pubkey(const struct LDKChannelConfig *NONNULL_PTR this_ptr);
5070 * When set, we commit to an upfront shutdown_pubkey at channel open. If our counterparty
5071 * supports it, they will then enforce the mutual-close output to us matches what we provided
5072 * at intialization, preventing us from closing to an alternate pubkey.
5074 * This is set to true by default to provide a slight increase in security, though ultimately
5075 * any attacker who is able to take control of a channel can just as easily send the funds via
5076 * lightning payments, so we never require that our counterparties support this option.
5078 * This cannot be changed after a channel has been initialized.
5080 * Default value: true.
5082 void ChannelConfig_set_commit_upfront_shutdown_pubkey(struct LDKChannelConfig *NONNULL_PTR this_ptr, bool val);
5084 MUST_USE_RES struct LDKChannelConfig ChannelConfig_new(uint32_t fee_proportional_millionths_arg, bool announced_channel_arg, bool commit_upfront_shutdown_pubkey_arg);
5086 struct LDKChannelConfig ChannelConfig_clone(const struct LDKChannelConfig *NONNULL_PTR orig);
5088 MUST_USE_RES struct LDKChannelConfig ChannelConfig_default(void);
5090 struct LDKCVec_u8Z ChannelConfig_write(const struct LDKChannelConfig *NONNULL_PTR obj);
5092 struct LDKCResult_ChannelConfigDecodeErrorZ ChannelConfig_read(struct LDKu8slice ser);
5094 void UserConfig_free(struct LDKUserConfig this_ptr);
5097 * Channel config that we propose to our counterparty.
5099 struct LDKChannelHandshakeConfig UserConfig_get_own_channel_config(const struct LDKUserConfig *NONNULL_PTR this_ptr);
5102 * Channel config that we propose to our counterparty.
5104 void UserConfig_set_own_channel_config(struct LDKUserConfig *NONNULL_PTR this_ptr, struct LDKChannelHandshakeConfig val);
5107 * Limits applied to our counterparty's proposed channel config settings.
5109 struct LDKChannelHandshakeLimits UserConfig_get_peer_channel_config_limits(const struct LDKUserConfig *NONNULL_PTR this_ptr);
5112 * Limits applied to our counterparty's proposed channel config settings.
5114 void UserConfig_set_peer_channel_config_limits(struct LDKUserConfig *NONNULL_PTR this_ptr, struct LDKChannelHandshakeLimits val);
5117 * Channel config which affects behavior during channel lifetime.
5119 struct LDKChannelConfig UserConfig_get_channel_options(const struct LDKUserConfig *NONNULL_PTR this_ptr);
5122 * Channel config which affects behavior during channel lifetime.
5124 void UserConfig_set_channel_options(struct LDKUserConfig *NONNULL_PTR this_ptr, struct LDKChannelConfig val);
5126 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);
5128 struct LDKUserConfig UserConfig_clone(const struct LDKUserConfig *NONNULL_PTR orig);
5130 MUST_USE_RES struct LDKUserConfig UserConfig_default(void);
5132 enum LDKAccessError AccessError_clone(const enum LDKAccessError *NONNULL_PTR orig);
5135 * Calls the free function if one is set
5137 void Access_free(struct LDKAccess this_ptr);
5140 * Calls the free function if one is set
5142 void Listen_free(struct LDKListen this_ptr);
5145 * Calls the free function if one is set
5147 void Watch_free(struct LDKWatch this_ptr);
5150 * Calls the free function if one is set
5152 void Filter_free(struct LDKFilter this_ptr);
5155 * Calls the free function if one is set
5157 void BroadcasterInterface_free(struct LDKBroadcasterInterface this_ptr);
5159 enum LDKConfirmationTarget ConfirmationTarget_clone(const enum LDKConfirmationTarget *NONNULL_PTR orig);
5162 * Calls the free function if one is set
5164 void FeeEstimator_free(struct LDKFeeEstimator this_ptr);
5166 void ChainMonitor_free(struct LDKChainMonitor this_ptr);
5169 * Dispatches to per-channel monitors, which are responsible for updating their on-chain view
5170 * of a channel and reacting accordingly based on transactions in the connected block. See
5171 * [`ChannelMonitor::block_connected`] for details. Any HTLCs that were resolved on chain will
5172 * be returned by [`chain::Watch::release_pending_monitor_events`].
5174 * Calls back to [`chain::Filter`] if any monitor indicated new outputs to watch. Subsequent
5175 * calls must not exclude any transactions matching the new outputs nor any in-block
5176 * descendants of such transactions. It is not necessary to re-fetch the block to obtain
5179 * [`ChannelMonitor::block_connected`]: ../channelmonitor/struct.ChannelMonitor.html#method.block_connected
5180 * [`chain::Watch::release_pending_monitor_events`]: ../trait.Watch.html#tymethod.release_pending_monitor_events
5181 * [`chain::Filter`]: ../trait.Filter.html
5183 void ChainMonitor_block_connected(const struct LDKChainMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], struct LDKCVec_C2Tuple_usizeTransactionZZ txdata, uint32_t height);
5186 * Dispatches to per-channel monitors, which are responsible for updating their on-chain view
5187 * of a channel based on the disconnected block. See [`ChannelMonitor::block_disconnected`] for
5190 * [`ChannelMonitor::block_disconnected`]: ../channelmonitor/struct.ChannelMonitor.html#method.block_disconnected
5192 void ChainMonitor_block_disconnected(const struct LDKChainMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], uint32_t disconnected_height);
5195 * Creates a new `ChainMonitor` used to watch on-chain activity pertaining to channels.
5197 * When an optional chain source implementing [`chain::Filter`] is provided, the chain monitor
5198 * will call back to it indicating transactions and outputs of interest. This allows clients to
5199 * pre-filter blocks or only fetch blocks matching a compact filter. Otherwise, clients may
5200 * always need to fetch full blocks absent another means for determining which blocks contain
5201 * transactions relevant to the watched channels.
5203 * [`chain::Filter`]: ../trait.Filter.html
5205 MUST_USE_RES struct LDKChainMonitor ChainMonitor_new(struct LDKFilter *chain_source, struct LDKBroadcasterInterface broadcaster, struct LDKLogger logger, struct LDKFeeEstimator feeest, struct LDKPersist persister);
5207 struct LDKWatch ChainMonitor_as_Watch(const struct LDKChainMonitor *NONNULL_PTR this_arg);
5209 struct LDKEventsProvider ChainMonitor_as_EventsProvider(const struct LDKChainMonitor *NONNULL_PTR this_arg);
5211 void ChannelMonitorUpdate_free(struct LDKChannelMonitorUpdate this_ptr);
5214 * The sequence number of this update. Updates *must* be replayed in-order according to this
5215 * sequence number (and updates may panic if they are not). The update_id values are strictly
5216 * increasing and increase by one for each new update, with one exception specified below.
5218 * This sequence number is also used to track up to which points updates which returned
5219 * ChannelMonitorUpdateErr::TemporaryFailure have been applied to all copies of a given
5220 * ChannelMonitor when ChannelManager::channel_monitor_updated is called.
5222 * The only instance where update_id values are not strictly increasing is the case where we
5223 * allow post-force-close updates with a special update ID of [`CLOSED_CHANNEL_UPDATE_ID`]. See
5224 * its docs for more details.
5226 * [`CLOSED_CHANNEL_UPDATE_ID`]: constant.CLOSED_CHANNEL_UPDATE_ID.html
5228 uint64_t ChannelMonitorUpdate_get_update_id(const struct LDKChannelMonitorUpdate *NONNULL_PTR this_ptr);
5231 * The sequence number of this update. Updates *must* be replayed in-order according to this
5232 * sequence number (and updates may panic if they are not). The update_id values are strictly
5233 * increasing and increase by one for each new update, with one exception specified below.
5235 * This sequence number is also used to track up to which points updates which returned
5236 * ChannelMonitorUpdateErr::TemporaryFailure have been applied to all copies of a given
5237 * ChannelMonitor when ChannelManager::channel_monitor_updated is called.
5239 * The only instance where update_id values are not strictly increasing is the case where we
5240 * allow post-force-close updates with a special update ID of [`CLOSED_CHANNEL_UPDATE_ID`]. See
5241 * its docs for more details.
5243 * [`CLOSED_CHANNEL_UPDATE_ID`]: constant.CLOSED_CHANNEL_UPDATE_ID.html
5245 void ChannelMonitorUpdate_set_update_id(struct LDKChannelMonitorUpdate *NONNULL_PTR this_ptr, uint64_t val);
5247 struct LDKChannelMonitorUpdate ChannelMonitorUpdate_clone(const struct LDKChannelMonitorUpdate *NONNULL_PTR orig);
5249 struct LDKCVec_u8Z ChannelMonitorUpdate_write(const struct LDKChannelMonitorUpdate *NONNULL_PTR obj);
5251 struct LDKCResult_ChannelMonitorUpdateDecodeErrorZ ChannelMonitorUpdate_read(struct LDKu8slice ser);
5253 enum LDKChannelMonitorUpdateErr ChannelMonitorUpdateErr_clone(const enum LDKChannelMonitorUpdateErr *NONNULL_PTR orig);
5255 void MonitorUpdateError_free(struct LDKMonitorUpdateError this_ptr);
5257 struct LDKMonitorUpdateError MonitorUpdateError_clone(const struct LDKMonitorUpdateError *NONNULL_PTR orig);
5259 void MonitorEvent_free(struct LDKMonitorEvent this_ptr);
5261 struct LDKMonitorEvent MonitorEvent_clone(const struct LDKMonitorEvent *NONNULL_PTR orig);
5263 void HTLCUpdate_free(struct LDKHTLCUpdate this_ptr);
5265 struct LDKHTLCUpdate HTLCUpdate_clone(const struct LDKHTLCUpdate *NONNULL_PTR orig);
5267 struct LDKCVec_u8Z HTLCUpdate_write(const struct LDKHTLCUpdate *NONNULL_PTR obj);
5269 struct LDKCResult_HTLCUpdateDecodeErrorZ HTLCUpdate_read(struct LDKu8slice ser);
5271 void ChannelMonitor_free(struct LDKChannelMonitor this_ptr);
5273 struct LDKCVec_u8Z ChannelMonitor_write(const struct LDKChannelMonitor *NONNULL_PTR obj);
5276 * Updates a ChannelMonitor on the basis of some new information provided by the Channel
5279 * panics if the given update is not the next update by update_id.
5281 MUST_USE_RES struct 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);
5284 * Gets the update_id from the latest ChannelMonitorUpdate which was applied to this
5287 MUST_USE_RES uint64_t ChannelMonitor_get_latest_update_id(const struct LDKChannelMonitor *NONNULL_PTR this_arg);
5290 * Gets the funding transaction outpoint of the channel this ChannelMonitor is monitoring for.
5292 MUST_USE_RES struct LDKC2Tuple_OutPointScriptZ ChannelMonitor_get_funding_txo(const struct LDKChannelMonitor *NONNULL_PTR this_arg);
5295 * Get the list of HTLCs who's status has been updated on chain. This should be called by
5296 * ChannelManager via [`chain::Watch::release_pending_monitor_events`].
5298 * [`chain::Watch::release_pending_monitor_events`]: ../trait.Watch.html#tymethod.release_pending_monitor_events
5300 MUST_USE_RES struct LDKCVec_MonitorEventZ ChannelMonitor_get_and_clear_pending_monitor_events(struct LDKChannelMonitor *NONNULL_PTR this_arg);
5303 * Gets the list of pending events which were generated by previous actions, clearing the list
5306 * This is called by ChainMonitor::get_and_clear_pending_events() and is equivalent to
5307 * EventsProvider::get_and_clear_pending_events() except that it requires &mut self as we do
5308 * no internal locking in ChannelMonitors.
5310 MUST_USE_RES struct LDKCVec_EventZ ChannelMonitor_get_and_clear_pending_events(struct LDKChannelMonitor *NONNULL_PTR this_arg);
5313 * Used by ChannelManager deserialization to broadcast the latest holder state if its copy of
5314 * the Channel was out-of-date. You may use it to get a broadcastable holder toxic tx in case of
5315 * fallen-behind, i.e when receiving a channel_reestablish with a proof that our counterparty side knows
5316 * a higher revocation secret than the holder commitment number we are aware of. Broadcasting these
5317 * transactions are UNSAFE, as they allow counterparty side to punish you. Nevertheless you may want to
5318 * broadcast them if counterparty don't close channel with his higher commitment transaction after a
5319 * substantial amount of time (a month or even a year) to get back funds. Best may be to contact
5320 * out-of-band the other node operator to coordinate with him if option is available to you.
5321 * In any-case, choice is up to the user.
5323 MUST_USE_RES struct LDKCVec_TransactionZ ChannelMonitor_get_latest_holder_commitment_txn(struct LDKChannelMonitor *NONNULL_PTR this_arg, const struct LDKLogger *NONNULL_PTR logger);
5326 * Processes transactions in a newly connected block, which may result in any of the following:
5327 * - update the monitor's state against resolved HTLCs
5328 * - punish the counterparty in the case of seeing a revoked commitment transaction
5329 * - force close the channel and claim/timeout incoming/outgoing HTLCs if near expiration
5330 * - detect settled outputs for later spending
5331 * - schedule and bump any in-flight claims
5333 * Returns any new outputs to watch from `txdata`; after called, these are also included in
5334 * [`get_outputs_to_watch`].
5336 * [`get_outputs_to_watch`]: #method.get_outputs_to_watch
5338 MUST_USE_RES struct LDKCVec_C2Tuple_TxidCVec_C2Tuple_u32TxOutZZZZ ChannelMonitor_block_connected(struct LDKChannelMonitor *NONNULL_PTR this_arg, const uint8_t (*header)[80], struct LDKCVec_C2Tuple_usizeTransactionZZ txdata, uint32_t height, struct LDKBroadcasterInterface broadcaster, struct LDKFeeEstimator fee_estimator, struct LDKLogger logger);
5341 * Determines if the disconnected block contained any transactions of interest and updates
5344 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);
5347 * Calls the free function if one is set
5349 void Persist_free(struct LDKPersist this_ptr);
5351 struct LDKCResult_C2Tuple_BlockHashChannelMonitorZDecodeErrorZ C2Tuple_BlockHashChannelMonitorZ_read(struct LDKu8slice ser, const struct LDKKeysInterface *NONNULL_PTR arg);
5353 void OutPoint_free(struct LDKOutPoint this_ptr);
5356 * The referenced transaction's txid.
5358 const uint8_t (*OutPoint_get_txid(const struct LDKOutPoint *NONNULL_PTR this_ptr))[32];
5361 * The referenced transaction's txid.
5363 void OutPoint_set_txid(struct LDKOutPoint *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5366 * The index of the referenced output in its transaction's vout.
5368 uint16_t OutPoint_get_index(const struct LDKOutPoint *NONNULL_PTR this_ptr);
5371 * The index of the referenced output in its transaction's vout.
5373 void OutPoint_set_index(struct LDKOutPoint *NONNULL_PTR this_ptr, uint16_t val);
5375 MUST_USE_RES struct LDKOutPoint OutPoint_new(struct LDKThirtyTwoBytes txid_arg, uint16_t index_arg);
5377 struct LDKOutPoint OutPoint_clone(const struct LDKOutPoint *NONNULL_PTR orig);
5380 * Convert an `OutPoint` to a lightning channel id.
5382 MUST_USE_RES struct LDKThirtyTwoBytes OutPoint_to_channel_id(const struct LDKOutPoint *NONNULL_PTR this_arg);
5384 struct LDKCVec_u8Z OutPoint_write(const struct LDKOutPoint *NONNULL_PTR obj);
5386 struct LDKCResult_OutPointDecodeErrorZ OutPoint_read(struct LDKu8slice ser);
5388 void DelayedPaymentOutputDescriptor_free(struct LDKDelayedPaymentOutputDescriptor this_ptr);
5391 * The outpoint which is spendable
5393 struct LDKOutPoint DelayedPaymentOutputDescriptor_get_outpoint(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5396 * The outpoint which is spendable
5398 void DelayedPaymentOutputDescriptor_set_outpoint(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKOutPoint val);
5401 * Per commitment point to derive delayed_payment_key by key holder
5403 struct LDKPublicKey DelayedPaymentOutputDescriptor_get_per_commitment_point(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5406 * Per commitment point to derive delayed_payment_key by key holder
5408 void DelayedPaymentOutputDescriptor_set_per_commitment_point(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5411 * The nSequence value which must be set in the spending input to satisfy the OP_CSV in
5412 * the witness_script.
5414 uint16_t DelayedPaymentOutputDescriptor_get_to_self_delay(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5417 * The nSequence value which must be set in the spending input to satisfy the OP_CSV in
5418 * the witness_script.
5420 void DelayedPaymentOutputDescriptor_set_to_self_delay(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, uint16_t val);
5423 * The output which is referenced by the given outpoint
5425 void DelayedPaymentOutputDescriptor_set_output(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKTxOut val);
5428 * The revocation point specific to the commitment transaction which was broadcast. Used to
5429 * derive the witnessScript for this output.
5431 struct LDKPublicKey DelayedPaymentOutputDescriptor_get_revocation_pubkey(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5434 * The revocation point specific to the commitment transaction which was broadcast. Used to
5435 * derive the witnessScript for this output.
5437 void DelayedPaymentOutputDescriptor_set_revocation_pubkey(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5440 * Arbitrary identification information returned by a call to
5441 * `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
5442 * the channel to spend the output.
5444 const uint8_t (*DelayedPaymentOutputDescriptor_get_channel_keys_id(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr))[32];
5447 * Arbitrary identification information returned by a call to
5448 * `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
5449 * the channel to spend the output.
5451 void DelayedPaymentOutputDescriptor_set_channel_keys_id(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5454 * The value of the channel which this output originated from, possibly indirectly.
5456 uint64_t DelayedPaymentOutputDescriptor_get_channel_value_satoshis(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5459 * The value of the channel which this output originated from, possibly indirectly.
5461 void DelayedPaymentOutputDescriptor_set_channel_value_satoshis(struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR this_ptr, uint64_t val);
5463 MUST_USE_RES struct LDKDelayedPaymentOutputDescriptor DelayedPaymentOutputDescriptor_new(struct LDKOutPoint outpoint_arg, struct LDKPublicKey per_commitment_point_arg, uint16_t to_self_delay_arg, struct LDKTxOut output_arg, struct LDKPublicKey revocation_pubkey_arg, struct LDKThirtyTwoBytes channel_keys_id_arg, uint64_t channel_value_satoshis_arg);
5465 struct LDKDelayedPaymentOutputDescriptor DelayedPaymentOutputDescriptor_clone(const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR orig);
5467 void StaticPaymentOutputDescriptor_free(struct LDKStaticPaymentOutputDescriptor this_ptr);
5470 * The outpoint which is spendable
5472 struct LDKOutPoint StaticPaymentOutputDescriptor_get_outpoint(const struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5475 * The outpoint which is spendable
5477 void StaticPaymentOutputDescriptor_set_outpoint(struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKOutPoint val);
5480 * The output which is referenced by the given outpoint
5482 void StaticPaymentOutputDescriptor_set_output(struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKTxOut val);
5485 * Arbitrary identification information returned by a call to
5486 * `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
5487 * the channel to spend the output.
5489 const uint8_t (*StaticPaymentOutputDescriptor_get_channel_keys_id(const struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr))[32];
5492 * Arbitrary identification information returned by a call to
5493 * `Sign::channel_keys_id()`. This may be useful in re-deriving keys used in
5494 * the channel to spend the output.
5496 void StaticPaymentOutputDescriptor_set_channel_keys_id(struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5499 * The value of the channel which this transactions spends.
5501 uint64_t StaticPaymentOutputDescriptor_get_channel_value_satoshis(const struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr);
5504 * The value of the channel which this transactions spends.
5506 void StaticPaymentOutputDescriptor_set_channel_value_satoshis(struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR this_ptr, uint64_t val);
5508 MUST_USE_RES struct LDKStaticPaymentOutputDescriptor StaticPaymentOutputDescriptor_new(struct LDKOutPoint outpoint_arg, struct LDKTxOut output_arg, struct LDKThirtyTwoBytes channel_keys_id_arg, uint64_t channel_value_satoshis_arg);
5510 struct LDKStaticPaymentOutputDescriptor StaticPaymentOutputDescriptor_clone(const struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR orig);
5512 void SpendableOutputDescriptor_free(struct LDKSpendableOutputDescriptor this_ptr);
5514 struct LDKSpendableOutputDescriptor SpendableOutputDescriptor_clone(const struct LDKSpendableOutputDescriptor *NONNULL_PTR orig);
5516 struct LDKCVec_u8Z SpendableOutputDescriptor_write(const struct LDKSpendableOutputDescriptor *NONNULL_PTR obj);
5518 struct LDKCResult_SpendableOutputDescriptorDecodeErrorZ SpendableOutputDescriptor_read(struct LDKu8slice ser);
5520 struct LDKSign Sign_clone(const struct LDKSign *NONNULL_PTR orig);
5523 * Calls the free function if one is set
5525 void Sign_free(struct LDKSign this_ptr);
5528 * Calls the free function if one is set
5530 void KeysInterface_free(struct LDKKeysInterface this_ptr);
5532 void InMemorySigner_free(struct LDKInMemorySigner this_ptr);
5535 * Private key of anchor tx
5537 const uint8_t (*InMemorySigner_get_funding_key(const struct LDKInMemorySigner *NONNULL_PTR this_ptr))[32];
5540 * Private key of anchor tx
5542 void InMemorySigner_set_funding_key(struct LDKInMemorySigner *NONNULL_PTR this_ptr, struct LDKSecretKey val);
5545 * Holder secret key for blinded revocation pubkey
5547 const uint8_t (*InMemorySigner_get_revocation_base_key(const struct LDKInMemorySigner *NONNULL_PTR this_ptr))[32];
5550 * Holder secret key for blinded revocation pubkey
5552 void InMemorySigner_set_revocation_base_key(struct LDKInMemorySigner *NONNULL_PTR this_ptr, struct LDKSecretKey val);
5555 * Holder secret key used for our balance in counterparty-broadcasted commitment transactions
5557 const uint8_t (*InMemorySigner_get_payment_key(const struct LDKInMemorySigner *NONNULL_PTR this_ptr))[32];
5560 * Holder secret key used for our balance in counterparty-broadcasted commitment transactions
5562 void InMemorySigner_set_payment_key(struct LDKInMemorySigner *NONNULL_PTR this_ptr, struct LDKSecretKey val);
5565 * Holder secret key used in HTLC tx
5567 const uint8_t (*InMemorySigner_get_delayed_payment_base_key(const struct LDKInMemorySigner *NONNULL_PTR this_ptr))[32];
5570 * Holder secret key used in HTLC tx
5572 void InMemorySigner_set_delayed_payment_base_key(struct LDKInMemorySigner *NONNULL_PTR this_ptr, struct LDKSecretKey val);
5575 * Holder htlc secret key used in commitment tx htlc outputs
5577 const uint8_t (*InMemorySigner_get_htlc_base_key(const struct LDKInMemorySigner *NONNULL_PTR this_ptr))[32];
5580 * Holder htlc secret key used in commitment tx htlc outputs
5582 void InMemorySigner_set_htlc_base_key(struct LDKInMemorySigner *NONNULL_PTR this_ptr, struct LDKSecretKey val);
5587 const uint8_t (*InMemorySigner_get_commitment_seed(const struct LDKInMemorySigner *NONNULL_PTR this_ptr))[32];
5592 void InMemorySigner_set_commitment_seed(struct LDKInMemorySigner *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5594 struct LDKInMemorySigner InMemorySigner_clone(const struct LDKInMemorySigner *NONNULL_PTR orig);
5597 * Create a new InMemorySigner
5599 MUST_USE_RES struct LDKInMemorySigner InMemorySigner_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, struct LDKThirtyTwoBytes channel_keys_id);
5602 * Counterparty pubkeys.
5603 * Will panic if ready_channel wasn't called.
5605 MUST_USE_RES struct LDKChannelPublicKeys InMemorySigner_counterparty_pubkeys(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5608 * The contest_delay value specified by our counterparty and applied on holder-broadcastable
5609 * transactions, ie the amount of time that we have to wait to recover our funds if we
5610 * broadcast a transaction.
5611 * Will panic if ready_channel wasn't called.
5613 MUST_USE_RES uint16_t InMemorySigner_counterparty_selected_contest_delay(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5616 * The contest_delay value specified by us and applied on transactions broadcastable
5617 * by our counterparty, ie the amount of time that they have to wait to recover their funds
5618 * if they broadcast a transaction.
5619 * Will panic if ready_channel wasn't called.
5621 MUST_USE_RES uint16_t InMemorySigner_holder_selected_contest_delay(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5624 * Whether the holder is the initiator
5625 * Will panic if ready_channel wasn't called.
5627 MUST_USE_RES bool InMemorySigner_is_outbound(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5631 * Will panic if ready_channel wasn't called.
5633 MUST_USE_RES struct LDKOutPoint InMemorySigner_funding_outpoint(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5636 * Obtain a ChannelTransactionParameters for this channel, to be used when verifying or
5637 * building transactions.
5639 * Will panic if ready_channel wasn't called.
5641 MUST_USE_RES struct LDKChannelTransactionParameters InMemorySigner_get_channel_parameters(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5644 * Sign the single input of spend_tx at index `input_idx` which spends the output
5645 * described by descriptor, returning the witness stack for the input.
5647 * Returns an Err if the input at input_idx does not exist, has a non-empty script_sig,
5648 * or is not spending the outpoint described by `descriptor.outpoint`.
5650 MUST_USE_RES struct LDKCResult_CVec_CVec_u8ZZNoneZ InMemorySigner_sign_counterparty_payment_input(const struct LDKInMemorySigner *NONNULL_PTR this_arg, struct LDKTransaction spend_tx, uintptr_t input_idx, const struct LDKStaticPaymentOutputDescriptor *NONNULL_PTR descriptor);
5653 * Sign the single input of spend_tx at index `input_idx` which spends the output
5654 * described by descriptor, returning the witness stack for the input.
5656 * Returns an Err if the input at input_idx does not exist, has a non-empty script_sig,
5657 * is not spending the outpoint described by `descriptor.outpoint`, or does not have a
5658 * sequence set to `descriptor.to_self_delay`.
5660 MUST_USE_RES struct LDKCResult_CVec_CVec_u8ZZNoneZ InMemorySigner_sign_dynamic_p2wsh_input(const struct LDKInMemorySigner *NONNULL_PTR this_arg, struct LDKTransaction spend_tx, uintptr_t input_idx, const struct LDKDelayedPaymentOutputDescriptor *NONNULL_PTR descriptor);
5662 struct LDKSign InMemorySigner_as_Sign(const struct LDKInMemorySigner *NONNULL_PTR this_arg);
5664 struct LDKCVec_u8Z InMemorySigner_write(const struct LDKInMemorySigner *NONNULL_PTR obj);
5666 struct LDKCResult_InMemorySignerDecodeErrorZ InMemorySigner_read(struct LDKu8slice ser);
5668 void KeysManager_free(struct LDKKeysManager this_ptr);
5671 * Constructs a KeysManager from a 32-byte seed. If the seed is in some way biased (eg your
5672 * CSRNG is busted) this may panic (but more importantly, you will possibly lose funds).
5673 * starting_time isn't strictly required to actually be a time, but it must absolutely,
5674 * without a doubt, be unique to this instance. ie if you start multiple times with the same
5675 * seed, starting_time must be unique to each run. Thus, the easiest way to achieve this is to
5676 * simply use the current time (with very high precision).
5678 * The seed MUST be backed up safely prior to use so that the keys can be re-created, however,
5679 * obviously, starting_time should be unique every time you reload the library - it is only
5680 * used to generate new ephemeral key data (which will be stored by the individual channel if
5683 * Note that the seed is required to recover certain on-chain funds independent of
5684 * ChannelMonitor data, though a current copy of ChannelMonitor data is also required for any
5685 * channel, and some on-chain during-closing funds.
5687 * Note that until the 0.1 release there is no guarantee of backward compatibility between
5688 * versions. Once the library is more fully supported, the docs will be updated to include a
5689 * detailed description of the guarantee.
5691 MUST_USE_RES struct LDKKeysManager KeysManager_new(const uint8_t (*seed)[32], uint64_t starting_time_secs, uint32_t starting_time_nanos);
5694 * Derive an old Sign containing per-channel secrets based on a key derivation parameters.
5696 * Key derivation parameters are accessible through a per-channel secrets
5697 * Sign::channel_keys_id and is provided inside DynamicOuputP2WSH in case of
5698 * onchain output detection for which a corresponding delayed_payment_key must be derived.
5700 MUST_USE_RES struct LDKInMemorySigner KeysManager_derive_channel_keys(const struct LDKKeysManager *NONNULL_PTR this_arg, uint64_t channel_value_satoshis, const uint8_t (*params)[32]);
5703 * Creates a Transaction which spends the given descriptors to the given outputs, plus an
5704 * output to the given change destination (if sufficient change value remains). The
5705 * transaction will have a feerate, at least, of the given value.
5707 * Returns `Err(())` if the output value is greater than the input value minus required fee or
5708 * if a descriptor was duplicated.
5710 * We do not enforce that outputs meet the dust limit or that any output scripts are standard.
5712 * May panic if the `SpendableOutputDescriptor`s were not generated by Channels which used
5713 * this KeysManager or one of the `InMemorySigner` created by this KeysManager.
5715 MUST_USE_RES struct LDKCResult_TransactionNoneZ KeysManager_spend_spendable_outputs(const struct LDKKeysManager *NONNULL_PTR this_arg, struct LDKCVec_SpendableOutputDescriptorZ descriptors, struct LDKCVec_TxOutZ outputs, struct LDKCVec_u8Z change_destination_script, uint32_t feerate_sat_per_1000_weight);
5717 struct LDKKeysInterface KeysManager_as_KeysInterface(const struct LDKKeysManager *NONNULL_PTR this_arg);
5719 void ChannelManager_free(struct LDKChannelManager this_ptr);
5721 void ChannelDetails_free(struct LDKChannelDetails this_ptr);
5724 * The channel's ID (prior to funding transaction generation, this is a random 32 bytes,
5725 * thereafter this is the txid of the funding transaction xor the funding transaction output).
5726 * Note that this means this value is *not* persistent - it can change once during the
5727 * lifetime of the channel.
5729 const uint8_t (*ChannelDetails_get_channel_id(const struct LDKChannelDetails *NONNULL_PTR this_ptr))[32];
5732 * The channel's ID (prior to funding transaction generation, this is a random 32 bytes,
5733 * thereafter this is the txid of the funding transaction xor the funding transaction output).
5734 * Note that this means this value is *not* persistent - it can change once during the
5735 * lifetime of the channel.
5737 void ChannelDetails_set_channel_id(struct LDKChannelDetails *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
5740 * The node_id of our counterparty
5742 struct LDKPublicKey ChannelDetails_get_remote_network_id(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5745 * The node_id of our counterparty
5747 void ChannelDetails_set_remote_network_id(struct LDKChannelDetails *NONNULL_PTR this_ptr, struct LDKPublicKey val);
5750 * The Features the channel counterparty provided upon last connection.
5751 * Useful for routing as it is the most up-to-date copy of the counterparty's features and
5752 * many routing-relevant features are present in the init context.
5754 struct LDKInitFeatures ChannelDetails_get_counterparty_features(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5757 * The Features the channel counterparty provided upon last connection.
5758 * Useful for routing as it is the most up-to-date copy of the counterparty's features and
5759 * many routing-relevant features are present in the init context.
5761 void ChannelDetails_set_counterparty_features(struct LDKChannelDetails *NONNULL_PTR this_ptr, struct LDKInitFeatures val);
5764 * The value, in satoshis, of this channel as appears in the funding output
5766 uint64_t ChannelDetails_get_channel_value_satoshis(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5769 * The value, in satoshis, of this channel as appears in the funding output
5771 void ChannelDetails_set_channel_value_satoshis(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
5774 * The user_id passed in to create_channel, or 0 if the channel was inbound.
5776 uint64_t ChannelDetails_get_user_id(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5779 * The user_id passed in to create_channel, or 0 if the channel was inbound.
5781 void ChannelDetails_set_user_id(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
5784 * The available outbound capacity for sending HTLCs to the remote peer. This does not include
5785 * any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
5786 * available for inclusion in new outbound HTLCs). This further does not include any pending
5787 * outgoing HTLCs which are awaiting some other resolution to be sent.
5789 uint64_t ChannelDetails_get_outbound_capacity_msat(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5792 * The available outbound capacity for sending HTLCs to the remote peer. This does not include
5793 * any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
5794 * available for inclusion in new outbound HTLCs). This further does not include any pending
5795 * outgoing HTLCs which are awaiting some other resolution to be sent.
5797 void ChannelDetails_set_outbound_capacity_msat(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
5800 * The available inbound capacity for the remote peer to send HTLCs to us. This does not
5801 * include any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
5802 * available for inclusion in new inbound HTLCs).
5803 * Note that there are some corner cases not fully handled here, so the actual available
5804 * inbound capacity may be slightly higher than this.
5806 uint64_t ChannelDetails_get_inbound_capacity_msat(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5809 * The available inbound capacity for the remote peer to send HTLCs to us. This does not
5810 * include any pending HTLCs which are not yet fully resolved (and, thus, who's balance is not
5811 * available for inclusion in new inbound HTLCs).
5812 * Note that there are some corner cases not fully handled here, so the actual available
5813 * inbound capacity may be slightly higher than this.
5815 void ChannelDetails_set_inbound_capacity_msat(struct LDKChannelDetails *NONNULL_PTR this_ptr, uint64_t val);
5818 * True if the channel is (a) confirmed and funding_locked messages have been exchanged, (b)
5819 * the peer is connected, and (c) no monitor update failure is pending resolution.
5821 bool ChannelDetails_get_is_live(const struct LDKChannelDetails *NONNULL_PTR this_ptr);
5824 * True if the channel is (a) confirmed and funding_locked messages have been exchanged, (b)
5825 * the peer is connected, and (c) no monitor update failure is pending resolution.
5827 void ChannelDetails_set_is_live(struct LDKChannelDetails *NONNULL_PTR this_ptr, bool val);
5829 struct LDKChannelDetails ChannelDetails_clone(const struct LDKChannelDetails *NONNULL_PTR orig);
5831 void PaymentSendFailure_free(struct LDKPaymentSendFailure this_ptr);
5833 struct LDKPaymentSendFailure PaymentSendFailure_clone(const struct LDKPaymentSendFailure *NONNULL_PTR orig);
5836 * Constructs a new ChannelManager to hold several channels and route between them.
5838 * This is the main \"logic hub\" for all channel-related actions, and implements
5839 * ChannelMessageHandler.
5841 * Non-proportional fees are fixed according to our risk using the provided fee estimator.
5843 * panics if channel_value_satoshis is >= `MAX_FUNDING_SATOSHIS`!
5845 * Users must provide the current blockchain height from which to track onchain channel
5846 * funding outpoints and send payments with reliable timelocks.
5848 * Users need to notify the new ChannelManager when a new block is connected or
5849 * disconnected using its `block_connected` and `block_disconnected` methods.
5851 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);
5854 * Creates a new outbound channel to the given remote node and with the given value.
5856 * user_id will be provided back as user_channel_id in FundingGenerationReady and
5857 * FundingBroadcastSafe events to allow tracking of which events correspond with which
5858 * create_channel call. Note that user_channel_id defaults to 0 for inbound channels, so you
5859 * may wish to avoid using 0 for user_id here.
5861 * If successful, will generate a SendOpenChannel message event, so you should probably poll
5862 * PeerManager::process_events afterwards.
5864 * Raises APIError::APIMisuseError when channel_value_satoshis > 2**24 or push_msat is
5865 * greater than channel_value_satoshis * 1k or channel_value_satoshis is < 1000.
5867 MUST_USE_RES struct 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);
5870 * Gets the list of open channels, in random order. See ChannelDetail field documentation for
5873 MUST_USE_RES struct LDKCVec_ChannelDetailsZ ChannelManager_list_channels(const struct LDKChannelManager *NONNULL_PTR this_arg);
5876 * Gets the list of usable channels, in random order. Useful as an argument to
5877 * get_route to ensure non-announced channels are used.
5879 * These are guaranteed to have their is_live value set to true, see the documentation for
5880 * ChannelDetails::is_live for more info on exactly what the criteria are.
5882 MUST_USE_RES struct LDKCVec_ChannelDetailsZ ChannelManager_list_usable_channels(const struct LDKChannelManager *NONNULL_PTR this_arg);
5885 * Begins the process of closing a channel. After this call (plus some timeout), no new HTLCs
5886 * will be accepted on the given channel, and after additional timeout/the closing of all
5887 * pending HTLCs, the channel will be closed on chain.
5889 * May generate a SendShutdown message event on success, which should be relayed.
5891 MUST_USE_RES struct LDKCResult_NoneAPIErrorZ ChannelManager_close_channel(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*channel_id)[32]);
5894 * Force closes a channel, immediately broadcasting the latest local commitment transaction to
5895 * the chain and rejecting new HTLCs on the given channel. Fails if channel_id is unknown to the manager.
5897 MUST_USE_RES struct LDKCResult_NoneAPIErrorZ ChannelManager_force_close_channel(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*channel_id)[32]);
5900 * Force close all channels, immediately broadcasting the latest local commitment transaction
5901 * for each to the chain and rejecting new HTLCs on each.
5903 void ChannelManager_force_close_all_channels(const struct LDKChannelManager *NONNULL_PTR this_arg);
5906 * Sends a payment along a given route.
5908 * Value parameters are provided via the last hop in route, see documentation for RouteHop
5909 * fields for more info.
5911 * Note that if the payment_hash already exists elsewhere (eg you're sending a duplicative
5912 * payment), we don't do anything to stop you! We always try to ensure that if the provided
5913 * next hop knows the preimage to payment_hash they can claim an additional amount as
5914 * specified in the last hop in the route! Thus, you should probably do your own
5915 * payment_preimage tracking (which you should already be doing as they represent \"proof of
5916 * payment\") and prevent double-sends yourself.
5918 * May generate SendHTLCs message(s) event on success, which should be relayed.
5920 * Each path may have a different return value, and PaymentSendValue may return a Vec with
5921 * each entry matching the corresponding-index entry in the route paths, see
5922 * PaymentSendFailure for more info.
5924 * In general, a path may raise:
5925 * * APIError::RouteError when an invalid route or forwarding parameter (cltv_delta, fee,
5926 * node public key) is specified.
5927 * * APIError::ChannelUnavailable if the next-hop channel is not available for updates
5928 * (including due to previous monitor update failure or new permanent monitor update
5930 * * APIError::MonitorUpdateFailed if a new monitor update failure prevented sending the
5933 * Note that depending on the type of the PaymentSendFailure the HTLC may have been
5934 * irrevocably committed to on our end. In such a case, do NOT retry the payment with a
5935 * different route unless you intend to pay twice!
5937 * payment_secret is unrelated to payment_hash (or PaymentPreimage) and exists to authenticate
5938 * the sender to the recipient and prevent payment-probing (deanonymization) attacks. For
5939 * newer nodes, it will be provided to you in the invoice. If you do not have one, the Route
5940 * must not contain multiple paths as multi-path payments require a recipient-provided
5942 * If a payment_secret *is* provided, we assume that the invoice had the payment_secret feature
5943 * bit set (either as required or as available). If multiple paths are present in the Route,
5944 * we assume the invoice had the basic_mpp feature set.
5946 MUST_USE_RES struct 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);
5949 * Call this upon creation of a funding transaction for the given channel.
5951 * Note that ALL inputs in the transaction pointed to by funding_txo MUST spend SegWit outputs
5952 * or your counterparty can steal your funds!
5954 * Panics if a funding transaction has already been provided for this channel.
5956 * May panic if the funding_txo is duplicative with some other channel (note that this should
5957 * be trivially prevented by using unique funding transaction keys per-channel).
5959 void ChannelManager_funding_transaction_generated(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*temporary_channel_id)[32], struct LDKOutPoint funding_txo);
5962 * Generates a signed node_announcement from the given arguments and creates a
5963 * BroadcastNodeAnnouncement event. Note that such messages will be ignored unless peers have
5964 * seen a channel_announcement from us (ie unless we have public channels open).
5966 * RGB is a node \"color\" and alias is a printable human-readable string to describe this node
5967 * to humans. They carry no in-protocol meaning.
5969 * addresses represent the set (possibly empty) of socket addresses on which this node accepts
5970 * incoming connections. These will be broadcast to the network, publicly tying these
5971 * addresses together. If you wish to preserve user privacy, addresses should likely contain
5972 * only Tor Onion addresses.
5974 * Panics if addresses is absurdly large (more than 500).
5976 void ChannelManager_broadcast_node_announcement(const struct LDKChannelManager *NONNULL_PTR this_arg, struct LDKThreeBytes rgb, struct LDKThirtyTwoBytes alias, struct LDKCVec_NetAddressZ addresses);
5979 * Processes HTLCs which are pending waiting on random forward delay.
5981 * Should only really ever be called in response to a PendingHTLCsForwardable event.
5982 * Will likely generate further events.
5984 void ChannelManager_process_pending_htlc_forwards(const struct LDKChannelManager *NONNULL_PTR this_arg);
5987 * If a peer is disconnected we mark any channels with that peer as 'disabled'.
5988 * After some time, if channels are still disabled we need to broadcast a ChannelUpdate
5989 * to inform the network about the uselessness of these channels.
5991 * This method handles all the details, and must be called roughly once per minute.
5993 void ChannelManager_timer_chan_freshness_every_min(const struct LDKChannelManager *NONNULL_PTR this_arg);
5996 * Indicates that the preimage for payment_hash is unknown or the received amount is incorrect
5997 * after a PaymentReceived event, failing the HTLC back to its origin and freeing resources
5998 * along the path (including in our own channel on which we received it).
5999 * Returns false if no payment was found to fail backwards, true if the process of failing the
6000 * HTLC backwards has been started.
6002 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);
6005 * Provides a payment preimage in response to a PaymentReceived event, returning true and
6006 * generating message events for the net layer to claim the payment, if possible. Thus, you
6007 * should probably kick the net layer to go send messages if this returns true!
6009 * You must specify the expected amounts for this HTLC, and we will only claim HTLCs
6010 * available within a few percent of the expected amount. This is critical for several
6011 * reasons : a) it avoids providing senders with `proof-of-payment` (in the form of the
6012 * payment_preimage without having provided the full value and b) it avoids certain
6013 * privacy-breaking recipient-probing attacks which may reveal payment activity to
6014 * motivated attackers.
6016 * Note that the privacy concerns in (b) are not relevant in payments with a payment_secret
6017 * set. Thus, for such payments we will claim any payments which do not under-pay.
6019 * May panic if called except in response to a PaymentReceived event.
6021 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);
6024 * Gets the node_id held by this ChannelManager
6026 MUST_USE_RES struct LDKPublicKey ChannelManager_get_our_node_id(const struct LDKChannelManager *NONNULL_PTR this_arg);
6029 * Restores a single, given channel to normal operation after a
6030 * ChannelMonitorUpdateErr::TemporaryFailure was returned from a channel monitor update
6033 * All ChannelMonitor updates up to and including highest_applied_update_id must have been
6034 * fully committed in every copy of the given channels' ChannelMonitors.
6036 * Note that there is no effect to calling with a highest_applied_update_id other than the
6037 * current latest ChannelMonitorUpdate and one call to this function after multiple
6038 * ChannelMonitorUpdateErr::TemporaryFailures is fine. The highest_applied_update_id field
6039 * exists largely only to prevent races between this and concurrent update_monitor calls.
6041 * Thus, the anticipated use is, at a high level:
6042 * 1) You register a chain::Watch with this ChannelManager,
6043 * 2) it stores each update to disk, and begins updating any remote (eg watchtower) copies of
6044 * said ChannelMonitors as it can, returning ChannelMonitorUpdateErr::TemporaryFailures
6045 * any time it cannot do so instantly,
6046 * 3) update(s) are applied to each remote copy of a ChannelMonitor,
6047 * 4) once all remote copies are updated, you call this function with the update_id that
6048 * completed, and once it is the latest the Channel will be re-enabled.
6050 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);
6052 struct LDKMessageSendEventsProvider ChannelManager_as_MessageSendEventsProvider(const struct LDKChannelManager *NONNULL_PTR this_arg);
6054 struct LDKEventsProvider ChannelManager_as_EventsProvider(const struct LDKChannelManager *NONNULL_PTR this_arg);
6056 struct LDKListen ChannelManager_as_Listen(const struct LDKChannelManager *NONNULL_PTR this_arg);
6059 * Updates channel state based on transactions seen in a connected block.
6061 void ChannelManager_block_connected(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*header)[80], struct LDKCVec_C2Tuple_usizeTransactionZZ txdata, uint32_t height);
6064 * Updates channel state based on a disconnected block.
6066 * If necessary, the channel may be force-closed without letting the counterparty participate
6069 void ChannelManager_block_disconnected(const struct LDKChannelManager *NONNULL_PTR this_arg, const uint8_t (*header)[80]);
6072 * Blocks until ChannelManager needs to be persisted. Only one listener on `wait` is
6073 * guaranteed to be woken up.
6075 void ChannelManager_wait(const struct LDKChannelManager *NONNULL_PTR this_arg);
6077 struct LDKChannelMessageHandler ChannelManager_as_ChannelMessageHandler(const struct LDKChannelManager *NONNULL_PTR this_arg);
6079 struct LDKCVec_u8Z ChannelManager_write(const struct LDKChannelManager *NONNULL_PTR obj);
6081 void ChannelManagerReadArgs_free(struct LDKChannelManagerReadArgs this_ptr);
6084 * The keys provider which will give us relevant keys. Some keys will be loaded during
6085 * deserialization and KeysInterface::read_chan_signer will be used to read per-Channel
6088 const struct LDKKeysInterface *ChannelManagerReadArgs_get_keys_manager(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
6091 * The keys provider which will give us relevant keys. Some keys will be loaded during
6092 * deserialization and KeysInterface::read_chan_signer will be used to read per-Channel
6095 void ChannelManagerReadArgs_set_keys_manager(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKKeysInterface val);
6098 * The fee_estimator for use in the ChannelManager in the future.
6100 * No calls to the FeeEstimator will be made during deserialization.
6102 const struct LDKFeeEstimator *ChannelManagerReadArgs_get_fee_estimator(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
6105 * The fee_estimator for use in the ChannelManager in the future.
6107 * No calls to the FeeEstimator will be made during deserialization.
6109 void ChannelManagerReadArgs_set_fee_estimator(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKFeeEstimator val);
6112 * The chain::Watch for use in the ChannelManager in the future.
6114 * No calls to the chain::Watch will be made during deserialization. It is assumed that
6115 * you have deserialized ChannelMonitors separately and will add them to your
6116 * chain::Watch after deserializing this ChannelManager.
6118 const struct LDKWatch *ChannelManagerReadArgs_get_chain_monitor(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
6121 * The chain::Watch for use in the ChannelManager in the future.
6123 * No calls to the chain::Watch will be made during deserialization. It is assumed that
6124 * you have deserialized ChannelMonitors separately and will add them to your
6125 * chain::Watch after deserializing this ChannelManager.
6127 void ChannelManagerReadArgs_set_chain_monitor(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKWatch val);
6130 * The BroadcasterInterface which will be used in the ChannelManager in the future and may be
6131 * used to broadcast the latest local commitment transactions of channels which must be
6132 * force-closed during deserialization.
6134 const struct LDKBroadcasterInterface *ChannelManagerReadArgs_get_tx_broadcaster(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
6137 * The BroadcasterInterface which will be used in the ChannelManager in the future and may be
6138 * used to broadcast the latest local commitment transactions of channels which must be
6139 * force-closed during deserialization.
6141 void ChannelManagerReadArgs_set_tx_broadcaster(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKBroadcasterInterface val);
6144 * The Logger for use in the ChannelManager and which may be used to log information during
6147 const struct LDKLogger *ChannelManagerReadArgs_get_logger(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
6150 * The Logger for use in the ChannelManager and which may be used to log information during
6153 void ChannelManagerReadArgs_set_logger(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKLogger val);
6156 * Default settings used for new channels. Any existing channels will continue to use the
6157 * runtime settings which were stored when the ChannelManager was serialized.
6159 struct LDKUserConfig ChannelManagerReadArgs_get_default_config(const struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr);
6162 * Default settings used for new channels. Any existing channels will continue to use the
6163 * runtime settings which were stored when the ChannelManager was serialized.
6165 void ChannelManagerReadArgs_set_default_config(struct LDKChannelManagerReadArgs *NONNULL_PTR this_ptr, struct LDKUserConfig val);
6168 * Simple utility function to create a ChannelManagerReadArgs which creates the monitor
6169 * HashMap for you. This is primarily useful for C bindings where it is not practical to
6170 * populate a HashMap directly from C.
6172 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, struct LDKCVec_ChannelMonitorZ channel_monitors);
6174 struct LDKCResult_C2Tuple_BlockHashChannelManagerZDecodeErrorZ C2Tuple_BlockHashChannelManagerZ_read(struct LDKu8slice ser, struct LDKChannelManagerReadArgs arg);
6176 void DecodeError_free(struct LDKDecodeError this_ptr);
6178 struct LDKDecodeError DecodeError_clone(const struct LDKDecodeError *NONNULL_PTR orig);
6180 void Init_free(struct LDKInit this_ptr);
6183 * The relevant features which the sender supports
6185 struct LDKInitFeatures Init_get_features(const struct LDKInit *NONNULL_PTR this_ptr);
6188 * The relevant features which the sender supports
6190 void Init_set_features(struct LDKInit *NONNULL_PTR this_ptr, struct LDKInitFeatures val);
6192 MUST_USE_RES struct LDKInit Init_new(struct LDKInitFeatures features_arg);
6194 struct LDKInit Init_clone(const struct LDKInit *NONNULL_PTR orig);
6196 void ErrorMessage_free(struct LDKErrorMessage this_ptr);
6199 * The channel ID involved in the error
6201 const uint8_t (*ErrorMessage_get_channel_id(const struct LDKErrorMessage *NONNULL_PTR this_ptr))[32];
6204 * The channel ID involved in the error
6206 void ErrorMessage_set_channel_id(struct LDKErrorMessage *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6209 * A possibly human-readable error description.
6210 * The string should be sanitized before it is used (e.g. emitted to logs
6211 * or printed to stdout). Otherwise, a well crafted error message may trigger a security
6212 * vulnerability in the terminal emulator or the logging subsystem.
6214 struct LDKStr ErrorMessage_get_data(const struct LDKErrorMessage *NONNULL_PTR this_ptr);
6217 * A possibly human-readable error description.
6218 * The string should be sanitized before it is used (e.g. emitted to logs
6219 * or printed to stdout). Otherwise, a well crafted error message may trigger a security
6220 * vulnerability in the terminal emulator or the logging subsystem.
6222 void ErrorMessage_set_data(struct LDKErrorMessage *NONNULL_PTR this_ptr, struct LDKCVec_u8Z val);
6224 MUST_USE_RES struct LDKErrorMessage ErrorMessage_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKCVec_u8Z data_arg);
6226 struct LDKErrorMessage ErrorMessage_clone(const struct LDKErrorMessage *NONNULL_PTR orig);
6228 void Ping_free(struct LDKPing this_ptr);
6231 * The desired response length
6233 uint16_t Ping_get_ponglen(const struct LDKPing *NONNULL_PTR this_ptr);
6236 * The desired response length
6238 void Ping_set_ponglen(struct LDKPing *NONNULL_PTR this_ptr, uint16_t val);
6241 * The ping packet size.
6242 * This field is not sent on the wire. byteslen zeros are sent.
6244 uint16_t Ping_get_byteslen(const struct LDKPing *NONNULL_PTR this_ptr);
6247 * The ping packet size.
6248 * This field is not sent on the wire. byteslen zeros are sent.
6250 void Ping_set_byteslen(struct LDKPing *NONNULL_PTR this_ptr, uint16_t val);
6252 MUST_USE_RES struct LDKPing Ping_new(uint16_t ponglen_arg, uint16_t byteslen_arg);
6254 struct LDKPing Ping_clone(const struct LDKPing *NONNULL_PTR orig);
6256 void Pong_free(struct LDKPong this_ptr);
6259 * The pong packet size.
6260 * This field is not sent on the wire. byteslen zeros are sent.
6262 uint16_t Pong_get_byteslen(const struct LDKPong *NONNULL_PTR this_ptr);
6265 * The pong packet size.
6266 * This field is not sent on the wire. byteslen zeros are sent.
6268 void Pong_set_byteslen(struct LDKPong *NONNULL_PTR this_ptr, uint16_t val);
6270 MUST_USE_RES struct LDKPong Pong_new(uint16_t byteslen_arg);
6272 struct LDKPong Pong_clone(const struct LDKPong *NONNULL_PTR orig);
6274 void OpenChannel_free(struct LDKOpenChannel this_ptr);
6277 * The genesis hash of the blockchain where the channel is to be opened
6279 const uint8_t (*OpenChannel_get_chain_hash(const struct LDKOpenChannel *NONNULL_PTR this_ptr))[32];
6282 * The genesis hash of the blockchain where the channel is to be opened
6284 void OpenChannel_set_chain_hash(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6287 * A temporary channel ID, until the funding outpoint is announced
6289 const uint8_t (*OpenChannel_get_temporary_channel_id(const struct LDKOpenChannel *NONNULL_PTR this_ptr))[32];
6292 * A temporary channel ID, until the funding outpoint is announced
6294 void OpenChannel_set_temporary_channel_id(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6299 uint64_t OpenChannel_get_funding_satoshis(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6304 void OpenChannel_set_funding_satoshis(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
6307 * The amount to push to the counterparty as part of the open, in milli-satoshi
6309 uint64_t OpenChannel_get_push_msat(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6312 * The amount to push to the counterparty as part of the open, in milli-satoshi
6314 void OpenChannel_set_push_msat(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
6317 * The threshold below which outputs on transactions broadcast by sender will be omitted
6319 uint64_t OpenChannel_get_dust_limit_satoshis(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6322 * The threshold below which outputs on transactions broadcast by sender will be omitted
6324 void OpenChannel_set_dust_limit_satoshis(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
6327 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
6329 uint64_t OpenChannel_get_max_htlc_value_in_flight_msat(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6332 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
6334 void OpenChannel_set_max_htlc_value_in_flight_msat(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
6337 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
6339 uint64_t OpenChannel_get_channel_reserve_satoshis(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6342 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
6344 void OpenChannel_set_channel_reserve_satoshis(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
6347 * The minimum HTLC size incoming to sender, in milli-satoshi
6349 uint64_t OpenChannel_get_htlc_minimum_msat(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6352 * The minimum HTLC size incoming to sender, in milli-satoshi
6354 void OpenChannel_set_htlc_minimum_msat(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint64_t val);
6357 * The feerate per 1000-weight of sender generated transactions, until updated by update_fee
6359 uint32_t OpenChannel_get_feerate_per_kw(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6362 * The feerate per 1000-weight of sender generated transactions, until updated by update_fee
6364 void OpenChannel_set_feerate_per_kw(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint32_t val);
6367 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
6369 uint16_t OpenChannel_get_to_self_delay(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6372 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
6374 void OpenChannel_set_to_self_delay(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint16_t val);
6377 * The maximum number of inbound HTLCs towards sender
6379 uint16_t OpenChannel_get_max_accepted_htlcs(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6382 * The maximum number of inbound HTLCs towards sender
6384 void OpenChannel_set_max_accepted_htlcs(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint16_t val);
6387 * The sender's key controlling the funding transaction
6389 struct LDKPublicKey OpenChannel_get_funding_pubkey(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6392 * The sender's key controlling the funding transaction
6394 void OpenChannel_set_funding_pubkey(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6397 * Used to derive a revocation key for transactions broadcast by counterparty
6399 struct LDKPublicKey OpenChannel_get_revocation_basepoint(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6402 * Used to derive a revocation key for transactions broadcast by counterparty
6404 void OpenChannel_set_revocation_basepoint(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6407 * A payment key to sender for transactions broadcast by counterparty
6409 struct LDKPublicKey OpenChannel_get_payment_point(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6412 * A payment key to sender for transactions broadcast by counterparty
6414 void OpenChannel_set_payment_point(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6417 * Used to derive a payment key to sender for transactions broadcast by sender
6419 struct LDKPublicKey OpenChannel_get_delayed_payment_basepoint(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6422 * Used to derive a payment key to sender for transactions broadcast by sender
6424 void OpenChannel_set_delayed_payment_basepoint(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6427 * Used to derive an HTLC payment key to sender
6429 struct LDKPublicKey OpenChannel_get_htlc_basepoint(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6432 * Used to derive an HTLC payment key to sender
6434 void OpenChannel_set_htlc_basepoint(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6437 * The first to-be-broadcast-by-sender transaction's per commitment point
6439 struct LDKPublicKey OpenChannel_get_first_per_commitment_point(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6442 * The first to-be-broadcast-by-sender transaction's per commitment point
6444 void OpenChannel_set_first_per_commitment_point(struct LDKOpenChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6449 uint8_t OpenChannel_get_channel_flags(const struct LDKOpenChannel *NONNULL_PTR this_ptr);
6454 void OpenChannel_set_channel_flags(struct LDKOpenChannel *NONNULL_PTR this_ptr, uint8_t val);
6456 struct LDKOpenChannel OpenChannel_clone(const struct LDKOpenChannel *NONNULL_PTR orig);
6458 void AcceptChannel_free(struct LDKAcceptChannel this_ptr);
6461 * A temporary channel ID, until the funding outpoint is announced
6463 const uint8_t (*AcceptChannel_get_temporary_channel_id(const struct LDKAcceptChannel *NONNULL_PTR this_ptr))[32];
6466 * A temporary channel ID, until the funding outpoint is announced
6468 void AcceptChannel_set_temporary_channel_id(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6471 * The threshold below which outputs on transactions broadcast by sender will be omitted
6473 uint64_t AcceptChannel_get_dust_limit_satoshis(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6476 * The threshold below which outputs on transactions broadcast by sender will be omitted
6478 void AcceptChannel_set_dust_limit_satoshis(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
6481 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
6483 uint64_t AcceptChannel_get_max_htlc_value_in_flight_msat(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6486 * The maximum inbound HTLC value in flight towards sender, in milli-satoshi
6488 void AcceptChannel_set_max_htlc_value_in_flight_msat(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
6491 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
6493 uint64_t AcceptChannel_get_channel_reserve_satoshis(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6496 * The minimum value unencumbered by HTLCs for the counterparty to keep in the channel
6498 void AcceptChannel_set_channel_reserve_satoshis(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
6501 * The minimum HTLC size incoming to sender, in milli-satoshi
6503 uint64_t AcceptChannel_get_htlc_minimum_msat(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6506 * The minimum HTLC size incoming to sender, in milli-satoshi
6508 void AcceptChannel_set_htlc_minimum_msat(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint64_t val);
6511 * Minimum depth of the funding transaction before the channel is considered open
6513 uint32_t AcceptChannel_get_minimum_depth(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6516 * Minimum depth of the funding transaction before the channel is considered open
6518 void AcceptChannel_set_minimum_depth(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint32_t val);
6521 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
6523 uint16_t AcceptChannel_get_to_self_delay(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6526 * The number of blocks which the counterparty will have to wait to claim on-chain funds if they broadcast a commitment transaction
6528 void AcceptChannel_set_to_self_delay(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint16_t val);
6531 * The maximum number of inbound HTLCs towards sender
6533 uint16_t AcceptChannel_get_max_accepted_htlcs(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6536 * The maximum number of inbound HTLCs towards sender
6538 void AcceptChannel_set_max_accepted_htlcs(struct LDKAcceptChannel *NONNULL_PTR this_ptr, uint16_t val);
6541 * The sender's key controlling the funding transaction
6543 struct LDKPublicKey AcceptChannel_get_funding_pubkey(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6546 * The sender's key controlling the funding transaction
6548 void AcceptChannel_set_funding_pubkey(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6551 * Used to derive a revocation key for transactions broadcast by counterparty
6553 struct LDKPublicKey AcceptChannel_get_revocation_basepoint(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6556 * Used to derive a revocation key for transactions broadcast by counterparty
6558 void AcceptChannel_set_revocation_basepoint(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6561 * A payment key to sender for transactions broadcast by counterparty
6563 struct LDKPublicKey AcceptChannel_get_payment_point(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6566 * A payment key to sender for transactions broadcast by counterparty
6568 void AcceptChannel_set_payment_point(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6571 * Used to derive a payment key to sender for transactions broadcast by sender
6573 struct LDKPublicKey AcceptChannel_get_delayed_payment_basepoint(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6576 * Used to derive a payment key to sender for transactions broadcast by sender
6578 void AcceptChannel_set_delayed_payment_basepoint(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6581 * Used to derive an HTLC payment key to sender for transactions broadcast by counterparty
6583 struct LDKPublicKey AcceptChannel_get_htlc_basepoint(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6586 * Used to derive an HTLC payment key to sender for transactions broadcast by counterparty
6588 void AcceptChannel_set_htlc_basepoint(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6591 * The first to-be-broadcast-by-sender transaction's per commitment point
6593 struct LDKPublicKey AcceptChannel_get_first_per_commitment_point(const struct LDKAcceptChannel *NONNULL_PTR this_ptr);
6596 * The first to-be-broadcast-by-sender transaction's per commitment point
6598 void AcceptChannel_set_first_per_commitment_point(struct LDKAcceptChannel *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6600 struct LDKAcceptChannel AcceptChannel_clone(const struct LDKAcceptChannel *NONNULL_PTR orig);
6602 void FundingCreated_free(struct LDKFundingCreated this_ptr);
6605 * A temporary channel ID, until the funding is established
6607 const uint8_t (*FundingCreated_get_temporary_channel_id(const struct LDKFundingCreated *NONNULL_PTR this_ptr))[32];
6610 * A temporary channel ID, until the funding is established
6612 void FundingCreated_set_temporary_channel_id(struct LDKFundingCreated *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6615 * The funding transaction ID
6617 const uint8_t (*FundingCreated_get_funding_txid(const struct LDKFundingCreated *NONNULL_PTR this_ptr))[32];
6620 * The funding transaction ID
6622 void FundingCreated_set_funding_txid(struct LDKFundingCreated *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6625 * The specific output index funding this channel
6627 uint16_t FundingCreated_get_funding_output_index(const struct LDKFundingCreated *NONNULL_PTR this_ptr);
6630 * The specific output index funding this channel
6632 void FundingCreated_set_funding_output_index(struct LDKFundingCreated *NONNULL_PTR this_ptr, uint16_t val);
6635 * The signature of the channel initiator (funder) on the funding transaction
6637 struct LDKSignature FundingCreated_get_signature(const struct LDKFundingCreated *NONNULL_PTR this_ptr);
6640 * The signature of the channel initiator (funder) on the funding transaction
6642 void FundingCreated_set_signature(struct LDKFundingCreated *NONNULL_PTR this_ptr, struct LDKSignature val);
6644 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);
6646 struct LDKFundingCreated FundingCreated_clone(const struct LDKFundingCreated *NONNULL_PTR orig);
6648 void FundingSigned_free(struct LDKFundingSigned this_ptr);
6653 const uint8_t (*FundingSigned_get_channel_id(const struct LDKFundingSigned *NONNULL_PTR this_ptr))[32];
6658 void FundingSigned_set_channel_id(struct LDKFundingSigned *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6661 * The signature of the channel acceptor (fundee) on the funding transaction
6663 struct LDKSignature FundingSigned_get_signature(const struct LDKFundingSigned *NONNULL_PTR this_ptr);
6666 * The signature of the channel acceptor (fundee) on the funding transaction
6668 void FundingSigned_set_signature(struct LDKFundingSigned *NONNULL_PTR this_ptr, struct LDKSignature val);
6670 MUST_USE_RES struct LDKFundingSigned FundingSigned_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKSignature signature_arg);
6672 struct LDKFundingSigned FundingSigned_clone(const struct LDKFundingSigned *NONNULL_PTR orig);
6674 void FundingLocked_free(struct LDKFundingLocked this_ptr);
6679 const uint8_t (*FundingLocked_get_channel_id(const struct LDKFundingLocked *NONNULL_PTR this_ptr))[32];
6684 void FundingLocked_set_channel_id(struct LDKFundingLocked *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6687 * The per-commitment point of the second commitment transaction
6689 struct LDKPublicKey FundingLocked_get_next_per_commitment_point(const struct LDKFundingLocked *NONNULL_PTR this_ptr);
6692 * The per-commitment point of the second commitment transaction
6694 void FundingLocked_set_next_per_commitment_point(struct LDKFundingLocked *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6696 MUST_USE_RES struct LDKFundingLocked FundingLocked_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKPublicKey next_per_commitment_point_arg);
6698 struct LDKFundingLocked FundingLocked_clone(const struct LDKFundingLocked *NONNULL_PTR orig);
6700 void Shutdown_free(struct LDKShutdown this_ptr);
6705 const uint8_t (*Shutdown_get_channel_id(const struct LDKShutdown *NONNULL_PTR this_ptr))[32];
6710 void Shutdown_set_channel_id(struct LDKShutdown *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6713 * The destination of this peer's funds on closing.
6714 * Must be in one of these forms: p2pkh, p2sh, p2wpkh, p2wsh.
6716 struct LDKu8slice Shutdown_get_scriptpubkey(const struct LDKShutdown *NONNULL_PTR this_ptr);
6719 * The destination of this peer's funds on closing.
6720 * Must be in one of these forms: p2pkh, p2sh, p2wpkh, p2wsh.
6722 void Shutdown_set_scriptpubkey(struct LDKShutdown *NONNULL_PTR this_ptr, struct LDKCVec_u8Z val);
6724 MUST_USE_RES struct LDKShutdown Shutdown_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKCVec_u8Z scriptpubkey_arg);
6726 struct LDKShutdown Shutdown_clone(const struct LDKShutdown *NONNULL_PTR orig);
6728 void ClosingSigned_free(struct LDKClosingSigned this_ptr);
6733 const uint8_t (*ClosingSigned_get_channel_id(const struct LDKClosingSigned *NONNULL_PTR this_ptr))[32];
6738 void ClosingSigned_set_channel_id(struct LDKClosingSigned *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6741 * The proposed total fee for the closing transaction
6743 uint64_t ClosingSigned_get_fee_satoshis(const struct LDKClosingSigned *NONNULL_PTR this_ptr);
6746 * The proposed total fee for the closing transaction
6748 void ClosingSigned_set_fee_satoshis(struct LDKClosingSigned *NONNULL_PTR this_ptr, uint64_t val);
6751 * A signature on the closing transaction
6753 struct LDKSignature ClosingSigned_get_signature(const struct LDKClosingSigned *NONNULL_PTR this_ptr);
6756 * A signature on the closing transaction
6758 void ClosingSigned_set_signature(struct LDKClosingSigned *NONNULL_PTR this_ptr, struct LDKSignature val);
6760 MUST_USE_RES struct LDKClosingSigned ClosingSigned_new(struct LDKThirtyTwoBytes channel_id_arg, uint64_t fee_satoshis_arg, struct LDKSignature signature_arg);
6762 struct LDKClosingSigned ClosingSigned_clone(const struct LDKClosingSigned *NONNULL_PTR orig);
6764 void UpdateAddHTLC_free(struct LDKUpdateAddHTLC this_ptr);
6769 const uint8_t (*UpdateAddHTLC_get_channel_id(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr))[32];
6774 void UpdateAddHTLC_set_channel_id(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6779 uint64_t UpdateAddHTLC_get_htlc_id(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr);
6784 void UpdateAddHTLC_set_htlc_id(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, uint64_t val);
6787 * The HTLC value in milli-satoshi
6789 uint64_t UpdateAddHTLC_get_amount_msat(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr);
6792 * The HTLC value in milli-satoshi
6794 void UpdateAddHTLC_set_amount_msat(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, uint64_t val);
6797 * The payment hash, the pre-image of which controls HTLC redemption
6799 const uint8_t (*UpdateAddHTLC_get_payment_hash(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr))[32];
6802 * The payment hash, the pre-image of which controls HTLC redemption
6804 void UpdateAddHTLC_set_payment_hash(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6807 * The expiry height of the HTLC
6809 uint32_t UpdateAddHTLC_get_cltv_expiry(const struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr);
6812 * The expiry height of the HTLC
6814 void UpdateAddHTLC_set_cltv_expiry(struct LDKUpdateAddHTLC *NONNULL_PTR this_ptr, uint32_t val);
6816 struct LDKUpdateAddHTLC UpdateAddHTLC_clone(const struct LDKUpdateAddHTLC *NONNULL_PTR orig);
6818 void UpdateFulfillHTLC_free(struct LDKUpdateFulfillHTLC this_ptr);
6823 const uint8_t (*UpdateFulfillHTLC_get_channel_id(const struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr))[32];
6828 void UpdateFulfillHTLC_set_channel_id(struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6833 uint64_t UpdateFulfillHTLC_get_htlc_id(const struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr);
6838 void UpdateFulfillHTLC_set_htlc_id(struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr, uint64_t val);
6841 * The pre-image of the payment hash, allowing HTLC redemption
6843 const uint8_t (*UpdateFulfillHTLC_get_payment_preimage(const struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr))[32];
6846 * The pre-image of the payment hash, allowing HTLC redemption
6848 void UpdateFulfillHTLC_set_payment_preimage(struct LDKUpdateFulfillHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6850 MUST_USE_RES struct LDKUpdateFulfillHTLC UpdateFulfillHTLC_new(struct LDKThirtyTwoBytes channel_id_arg, uint64_t htlc_id_arg, struct LDKThirtyTwoBytes payment_preimage_arg);
6852 struct LDKUpdateFulfillHTLC UpdateFulfillHTLC_clone(const struct LDKUpdateFulfillHTLC *NONNULL_PTR orig);
6854 void UpdateFailHTLC_free(struct LDKUpdateFailHTLC this_ptr);
6859 const uint8_t (*UpdateFailHTLC_get_channel_id(const struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr))[32];
6864 void UpdateFailHTLC_set_channel_id(struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6869 uint64_t UpdateFailHTLC_get_htlc_id(const struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr);
6874 void UpdateFailHTLC_set_htlc_id(struct LDKUpdateFailHTLC *NONNULL_PTR this_ptr, uint64_t val);
6876 struct LDKUpdateFailHTLC UpdateFailHTLC_clone(const struct LDKUpdateFailHTLC *NONNULL_PTR orig);
6878 void UpdateFailMalformedHTLC_free(struct LDKUpdateFailMalformedHTLC this_ptr);
6883 const uint8_t (*UpdateFailMalformedHTLC_get_channel_id(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr))[32];
6888 void UpdateFailMalformedHTLC_set_channel_id(struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6893 uint64_t UpdateFailMalformedHTLC_get_htlc_id(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr);
6898 void UpdateFailMalformedHTLC_set_htlc_id(struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr, uint64_t val);
6903 uint16_t UpdateFailMalformedHTLC_get_failure_code(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr);
6908 void UpdateFailMalformedHTLC_set_failure_code(struct LDKUpdateFailMalformedHTLC *NONNULL_PTR this_ptr, uint16_t val);
6910 struct LDKUpdateFailMalformedHTLC UpdateFailMalformedHTLC_clone(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR orig);
6912 void CommitmentSigned_free(struct LDKCommitmentSigned this_ptr);
6917 const uint8_t (*CommitmentSigned_get_channel_id(const struct LDKCommitmentSigned *NONNULL_PTR this_ptr))[32];
6922 void CommitmentSigned_set_channel_id(struct LDKCommitmentSigned *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6925 * A signature on the commitment transaction
6927 struct LDKSignature CommitmentSigned_get_signature(const struct LDKCommitmentSigned *NONNULL_PTR this_ptr);
6930 * A signature on the commitment transaction
6932 void CommitmentSigned_set_signature(struct LDKCommitmentSigned *NONNULL_PTR this_ptr, struct LDKSignature val);
6935 * Signatures on the HTLC transactions
6937 void CommitmentSigned_set_htlc_signatures(struct LDKCommitmentSigned *NONNULL_PTR this_ptr, struct LDKCVec_SignatureZ val);
6939 MUST_USE_RES struct LDKCommitmentSigned CommitmentSigned_new(struct LDKThirtyTwoBytes channel_id_arg, struct LDKSignature signature_arg, struct LDKCVec_SignatureZ htlc_signatures_arg);
6941 struct LDKCommitmentSigned CommitmentSigned_clone(const struct LDKCommitmentSigned *NONNULL_PTR orig);
6943 void RevokeAndACK_free(struct LDKRevokeAndACK this_ptr);
6948 const uint8_t (*RevokeAndACK_get_channel_id(const struct LDKRevokeAndACK *NONNULL_PTR this_ptr))[32];
6953 void RevokeAndACK_set_channel_id(struct LDKRevokeAndACK *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6956 * The secret corresponding to the per-commitment point
6958 const uint8_t (*RevokeAndACK_get_per_commitment_secret(const struct LDKRevokeAndACK *NONNULL_PTR this_ptr))[32];
6961 * The secret corresponding to the per-commitment point
6963 void RevokeAndACK_set_per_commitment_secret(struct LDKRevokeAndACK *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6966 * The next sender-broadcast commitment transaction's per-commitment point
6968 struct LDKPublicKey RevokeAndACK_get_next_per_commitment_point(const struct LDKRevokeAndACK *NONNULL_PTR this_ptr);
6971 * The next sender-broadcast commitment transaction's per-commitment point
6973 void RevokeAndACK_set_next_per_commitment_point(struct LDKRevokeAndACK *NONNULL_PTR this_ptr, struct LDKPublicKey val);
6975 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);
6977 struct LDKRevokeAndACK RevokeAndACK_clone(const struct LDKRevokeAndACK *NONNULL_PTR orig);
6979 void UpdateFee_free(struct LDKUpdateFee this_ptr);
6984 const uint8_t (*UpdateFee_get_channel_id(const struct LDKUpdateFee *NONNULL_PTR this_ptr))[32];
6989 void UpdateFee_set_channel_id(struct LDKUpdateFee *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
6992 * Fee rate per 1000-weight of the transaction
6994 uint32_t UpdateFee_get_feerate_per_kw(const struct LDKUpdateFee *NONNULL_PTR this_ptr);
6997 * Fee rate per 1000-weight of the transaction
6999 void UpdateFee_set_feerate_per_kw(struct LDKUpdateFee *NONNULL_PTR this_ptr, uint32_t val);
7001 MUST_USE_RES struct LDKUpdateFee UpdateFee_new(struct LDKThirtyTwoBytes channel_id_arg, uint32_t feerate_per_kw_arg);
7003 struct LDKUpdateFee UpdateFee_clone(const struct LDKUpdateFee *NONNULL_PTR orig);
7005 void DataLossProtect_free(struct LDKDataLossProtect this_ptr);
7008 * Proof that the sender knows the per-commitment secret of a specific commitment transaction
7009 * belonging to the recipient
7011 const uint8_t (*DataLossProtect_get_your_last_per_commitment_secret(const struct LDKDataLossProtect *NONNULL_PTR this_ptr))[32];
7014 * Proof that the sender knows the per-commitment secret of a specific commitment transaction
7015 * belonging to the recipient
7017 void DataLossProtect_set_your_last_per_commitment_secret(struct LDKDataLossProtect *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7020 * The sender's per-commitment point for their current commitment transaction
7022 struct LDKPublicKey DataLossProtect_get_my_current_per_commitment_point(const struct LDKDataLossProtect *NONNULL_PTR this_ptr);
7025 * The sender's per-commitment point for their current commitment transaction
7027 void DataLossProtect_set_my_current_per_commitment_point(struct LDKDataLossProtect *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7029 MUST_USE_RES struct LDKDataLossProtect DataLossProtect_new(struct LDKThirtyTwoBytes your_last_per_commitment_secret_arg, struct LDKPublicKey my_current_per_commitment_point_arg);
7031 struct LDKDataLossProtect DataLossProtect_clone(const struct LDKDataLossProtect *NONNULL_PTR orig);
7033 void ChannelReestablish_free(struct LDKChannelReestablish this_ptr);
7038 const uint8_t (*ChannelReestablish_get_channel_id(const struct LDKChannelReestablish *NONNULL_PTR this_ptr))[32];
7043 void ChannelReestablish_set_channel_id(struct LDKChannelReestablish *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7046 * The next commitment number for the sender
7048 uint64_t ChannelReestablish_get_next_local_commitment_number(const struct LDKChannelReestablish *NONNULL_PTR this_ptr);
7051 * The next commitment number for the sender
7053 void ChannelReestablish_set_next_local_commitment_number(struct LDKChannelReestablish *NONNULL_PTR this_ptr, uint64_t val);
7056 * The next commitment number for the recipient
7058 uint64_t ChannelReestablish_get_next_remote_commitment_number(const struct LDKChannelReestablish *NONNULL_PTR this_ptr);
7061 * The next commitment number for the recipient
7063 void ChannelReestablish_set_next_remote_commitment_number(struct LDKChannelReestablish *NONNULL_PTR this_ptr, uint64_t val);
7065 struct LDKChannelReestablish ChannelReestablish_clone(const struct LDKChannelReestablish *NONNULL_PTR orig);
7067 void AnnouncementSignatures_free(struct LDKAnnouncementSignatures this_ptr);
7072 const uint8_t (*AnnouncementSignatures_get_channel_id(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr))[32];
7077 void AnnouncementSignatures_set_channel_id(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7080 * The short channel ID
7082 uint64_t AnnouncementSignatures_get_short_channel_id(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr);
7085 * The short channel ID
7087 void AnnouncementSignatures_set_short_channel_id(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, uint64_t val);
7090 * A signature by the node key
7092 struct LDKSignature AnnouncementSignatures_get_node_signature(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr);
7095 * A signature by the node key
7097 void AnnouncementSignatures_set_node_signature(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, struct LDKSignature val);
7100 * A signature by the funding key
7102 struct LDKSignature AnnouncementSignatures_get_bitcoin_signature(const struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr);
7105 * A signature by the funding key
7107 void AnnouncementSignatures_set_bitcoin_signature(struct LDKAnnouncementSignatures *NONNULL_PTR this_ptr, struct LDKSignature val);
7109 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);
7111 struct LDKAnnouncementSignatures AnnouncementSignatures_clone(const struct LDKAnnouncementSignatures *NONNULL_PTR orig);
7113 void NetAddress_free(struct LDKNetAddress this_ptr);
7115 struct LDKNetAddress NetAddress_clone(const struct LDKNetAddress *NONNULL_PTR orig);
7117 struct LDKCVec_u8Z NetAddress_write(const struct LDKNetAddress *NONNULL_PTR obj);
7119 struct LDKCResult_CResult_NetAddressu8ZDecodeErrorZ Result_read(struct LDKu8slice ser);
7121 void UnsignedNodeAnnouncement_free(struct LDKUnsignedNodeAnnouncement this_ptr);
7124 * The advertised features
7126 struct LDKNodeFeatures UnsignedNodeAnnouncement_get_features(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr);
7129 * The advertised features
7131 void UnsignedNodeAnnouncement_set_features(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKNodeFeatures val);
7134 * A strictly monotonic announcement counter, with gaps allowed
7136 uint32_t UnsignedNodeAnnouncement_get_timestamp(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr);
7139 * A strictly monotonic announcement counter, with gaps allowed
7141 void UnsignedNodeAnnouncement_set_timestamp(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, uint32_t val);
7144 * The node_id this announcement originated from (don't rebroadcast the node_announcement back
7147 struct LDKPublicKey UnsignedNodeAnnouncement_get_node_id(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr);
7150 * The node_id this announcement originated from (don't rebroadcast the node_announcement back
7153 void UnsignedNodeAnnouncement_set_node_id(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7156 * An RGB color for UI purposes
7158 const uint8_t (*UnsignedNodeAnnouncement_get_rgb(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr))[3];
7161 * An RGB color for UI purposes
7163 void UnsignedNodeAnnouncement_set_rgb(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKThreeBytes val);
7166 * An alias, for UI purposes. This should be sanitized before use. There is no guarantee
7169 const uint8_t (*UnsignedNodeAnnouncement_get_alias(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr))[32];
7172 * An alias, for UI purposes. This should be sanitized before use. There is no guarantee
7175 void UnsignedNodeAnnouncement_set_alias(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7178 * List of addresses on which this node is reachable
7180 void UnsignedNodeAnnouncement_set_addresses(struct LDKUnsignedNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKCVec_NetAddressZ val);
7182 struct LDKUnsignedNodeAnnouncement UnsignedNodeAnnouncement_clone(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR orig);
7184 void NodeAnnouncement_free(struct LDKNodeAnnouncement this_ptr);
7187 * The signature by the node key
7189 struct LDKSignature NodeAnnouncement_get_signature(const struct LDKNodeAnnouncement *NONNULL_PTR this_ptr);
7192 * The signature by the node key
7194 void NodeAnnouncement_set_signature(struct LDKNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
7197 * The actual content of the announcement
7199 struct LDKUnsignedNodeAnnouncement NodeAnnouncement_get_contents(const struct LDKNodeAnnouncement *NONNULL_PTR this_ptr);
7202 * The actual content of the announcement
7204 void NodeAnnouncement_set_contents(struct LDKNodeAnnouncement *NONNULL_PTR this_ptr, struct LDKUnsignedNodeAnnouncement val);
7206 MUST_USE_RES struct LDKNodeAnnouncement NodeAnnouncement_new(struct LDKSignature signature_arg, struct LDKUnsignedNodeAnnouncement contents_arg);
7208 struct LDKNodeAnnouncement NodeAnnouncement_clone(const struct LDKNodeAnnouncement *NONNULL_PTR orig);
7210 void UnsignedChannelAnnouncement_free(struct LDKUnsignedChannelAnnouncement this_ptr);
7213 * The advertised channel features
7215 struct LDKChannelFeatures UnsignedChannelAnnouncement_get_features(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
7218 * The advertised channel features
7220 void UnsignedChannelAnnouncement_set_features(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKChannelFeatures val);
7223 * The genesis hash of the blockchain where the channel is to be opened
7225 const uint8_t (*UnsignedChannelAnnouncement_get_chain_hash(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr))[32];
7228 * The genesis hash of the blockchain where the channel is to be opened
7230 void UnsignedChannelAnnouncement_set_chain_hash(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7233 * The short channel ID
7235 uint64_t UnsignedChannelAnnouncement_get_short_channel_id(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
7238 * The short channel ID
7240 void UnsignedChannelAnnouncement_set_short_channel_id(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, uint64_t val);
7243 * One of the two node_ids which are endpoints of this channel
7245 struct LDKPublicKey UnsignedChannelAnnouncement_get_node_id_1(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
7248 * One of the two node_ids which are endpoints of this channel
7250 void UnsignedChannelAnnouncement_set_node_id_1(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7253 * The other of the two node_ids which are endpoints of this channel
7255 struct LDKPublicKey UnsignedChannelAnnouncement_get_node_id_2(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
7258 * The other of the two node_ids which are endpoints of this channel
7260 void UnsignedChannelAnnouncement_set_node_id_2(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7263 * The funding key for the first node
7265 struct LDKPublicKey UnsignedChannelAnnouncement_get_bitcoin_key_1(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
7268 * The funding key for the first node
7270 void UnsignedChannelAnnouncement_set_bitcoin_key_1(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7273 * The funding key for the second node
7275 struct LDKPublicKey UnsignedChannelAnnouncement_get_bitcoin_key_2(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr);
7278 * The funding key for the second node
7280 void UnsignedChannelAnnouncement_set_bitcoin_key_2(struct LDKUnsignedChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKPublicKey val);
7282 struct LDKUnsignedChannelAnnouncement UnsignedChannelAnnouncement_clone(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR orig);
7284 void ChannelAnnouncement_free(struct LDKChannelAnnouncement this_ptr);
7287 * Authentication of the announcement by the first public node
7289 struct LDKSignature ChannelAnnouncement_get_node_signature_1(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
7292 * Authentication of the announcement by the first public node
7294 void ChannelAnnouncement_set_node_signature_1(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
7297 * Authentication of the announcement by the second public node
7299 struct LDKSignature ChannelAnnouncement_get_node_signature_2(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
7302 * Authentication of the announcement by the second public node
7304 void ChannelAnnouncement_set_node_signature_2(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
7307 * Proof of funding UTXO ownership by the first public node
7309 struct LDKSignature ChannelAnnouncement_get_bitcoin_signature_1(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
7312 * Proof of funding UTXO ownership by the first public node
7314 void ChannelAnnouncement_set_bitcoin_signature_1(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
7317 * Proof of funding UTXO ownership by the second public node
7319 struct LDKSignature ChannelAnnouncement_get_bitcoin_signature_2(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
7322 * Proof of funding UTXO ownership by the second public node
7324 void ChannelAnnouncement_set_bitcoin_signature_2(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKSignature val);
7327 * The actual announcement
7329 struct LDKUnsignedChannelAnnouncement ChannelAnnouncement_get_contents(const struct LDKChannelAnnouncement *NONNULL_PTR this_ptr);
7332 * The actual announcement
7334 void ChannelAnnouncement_set_contents(struct LDKChannelAnnouncement *NONNULL_PTR this_ptr, struct LDKUnsignedChannelAnnouncement val);
7336 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);
7338 struct LDKChannelAnnouncement ChannelAnnouncement_clone(const struct LDKChannelAnnouncement *NONNULL_PTR orig);
7340 void UnsignedChannelUpdate_free(struct LDKUnsignedChannelUpdate this_ptr);
7343 * The genesis hash of the blockchain where the channel is to be opened
7345 const uint8_t (*UnsignedChannelUpdate_get_chain_hash(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr))[32];
7348 * The genesis hash of the blockchain where the channel is to be opened
7350 void UnsignedChannelUpdate_set_chain_hash(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7353 * The short channel ID
7355 uint64_t UnsignedChannelUpdate_get_short_channel_id(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7358 * The short channel ID
7360 void UnsignedChannelUpdate_set_short_channel_id(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint64_t val);
7363 * A strictly monotonic announcement counter, with gaps allowed, specific to this channel
7365 uint32_t UnsignedChannelUpdate_get_timestamp(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7368 * A strictly monotonic announcement counter, with gaps allowed, specific to this channel
7370 void UnsignedChannelUpdate_set_timestamp(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint32_t val);
7375 uint8_t UnsignedChannelUpdate_get_flags(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7380 void UnsignedChannelUpdate_set_flags(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint8_t val);
7383 * The number of blocks to subtract from incoming HTLC cltv_expiry values
7385 uint16_t UnsignedChannelUpdate_get_cltv_expiry_delta(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7388 * The number of blocks to subtract from incoming HTLC cltv_expiry values
7390 void UnsignedChannelUpdate_set_cltv_expiry_delta(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint16_t val);
7393 * The minimum HTLC size incoming to sender, in milli-satoshi
7395 uint64_t UnsignedChannelUpdate_get_htlc_minimum_msat(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7398 * The minimum HTLC size incoming to sender, in milli-satoshi
7400 void UnsignedChannelUpdate_set_htlc_minimum_msat(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint64_t val);
7403 * The base HTLC fee charged by sender, in milli-satoshi
7405 uint32_t UnsignedChannelUpdate_get_fee_base_msat(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7408 * The base HTLC fee charged by sender, in milli-satoshi
7410 void UnsignedChannelUpdate_set_fee_base_msat(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint32_t val);
7413 * The amount to fee multiplier, in micro-satoshi
7415 uint32_t UnsignedChannelUpdate_get_fee_proportional_millionths(const struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr);
7418 * The amount to fee multiplier, in micro-satoshi
7420 void UnsignedChannelUpdate_set_fee_proportional_millionths(struct LDKUnsignedChannelUpdate *NONNULL_PTR this_ptr, uint32_t val);
7422 struct LDKUnsignedChannelUpdate UnsignedChannelUpdate_clone(const struct LDKUnsignedChannelUpdate *NONNULL_PTR orig);
7424 void ChannelUpdate_free(struct LDKChannelUpdate this_ptr);
7427 * A signature of the channel update
7429 struct LDKSignature ChannelUpdate_get_signature(const struct LDKChannelUpdate *NONNULL_PTR this_ptr);
7432 * A signature of the channel update
7434 void ChannelUpdate_set_signature(struct LDKChannelUpdate *NONNULL_PTR this_ptr, struct LDKSignature val);
7437 * The actual channel update
7439 struct LDKUnsignedChannelUpdate ChannelUpdate_get_contents(const struct LDKChannelUpdate *NONNULL_PTR this_ptr);
7442 * The actual channel update
7444 void ChannelUpdate_set_contents(struct LDKChannelUpdate *NONNULL_PTR this_ptr, struct LDKUnsignedChannelUpdate val);
7446 MUST_USE_RES struct LDKChannelUpdate ChannelUpdate_new(struct LDKSignature signature_arg, struct LDKUnsignedChannelUpdate contents_arg);
7448 struct LDKChannelUpdate ChannelUpdate_clone(const struct LDKChannelUpdate *NONNULL_PTR orig);
7450 void QueryChannelRange_free(struct LDKQueryChannelRange this_ptr);
7453 * The genesis hash of the blockchain being queried
7455 const uint8_t (*QueryChannelRange_get_chain_hash(const struct LDKQueryChannelRange *NONNULL_PTR this_ptr))[32];
7458 * The genesis hash of the blockchain being queried
7460 void QueryChannelRange_set_chain_hash(struct LDKQueryChannelRange *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7463 * The height of the first block for the channel UTXOs being queried
7465 uint32_t QueryChannelRange_get_first_blocknum(const struct LDKQueryChannelRange *NONNULL_PTR this_ptr);
7468 * The height of the first block for the channel UTXOs being queried
7470 void QueryChannelRange_set_first_blocknum(struct LDKQueryChannelRange *NONNULL_PTR this_ptr, uint32_t val);
7473 * The number of blocks to include in the query results
7475 uint32_t QueryChannelRange_get_number_of_blocks(const struct LDKQueryChannelRange *NONNULL_PTR this_ptr);
7478 * The number of blocks to include in the query results
7480 void QueryChannelRange_set_number_of_blocks(struct LDKQueryChannelRange *NONNULL_PTR this_ptr, uint32_t val);
7482 MUST_USE_RES struct LDKQueryChannelRange QueryChannelRange_new(struct LDKThirtyTwoBytes chain_hash_arg, uint32_t first_blocknum_arg, uint32_t number_of_blocks_arg);
7484 struct LDKQueryChannelRange QueryChannelRange_clone(const struct LDKQueryChannelRange *NONNULL_PTR orig);
7486 void ReplyChannelRange_free(struct LDKReplyChannelRange this_ptr);
7489 * The genesis hash of the blockchain being queried
7491 const uint8_t (*ReplyChannelRange_get_chain_hash(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr))[32];
7494 * The genesis hash of the blockchain being queried
7496 void ReplyChannelRange_set_chain_hash(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7499 * The height of the first block in the range of the reply
7501 uint32_t ReplyChannelRange_get_first_blocknum(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr);
7504 * The height of the first block in the range of the reply
7506 void ReplyChannelRange_set_first_blocknum(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, uint32_t val);
7509 * The number of blocks included in the range of the reply
7511 uint32_t ReplyChannelRange_get_number_of_blocks(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr);
7514 * The number of blocks included in the range of the reply
7516 void ReplyChannelRange_set_number_of_blocks(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, uint32_t val);
7519 * True when this is the final reply for a query
7521 bool ReplyChannelRange_get_sync_complete(const struct LDKReplyChannelRange *NONNULL_PTR this_ptr);
7524 * True when this is the final reply for a query
7526 void ReplyChannelRange_set_sync_complete(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, bool val);
7529 * The short_channel_ids in the channel range
7531 void ReplyChannelRange_set_short_channel_ids(struct LDKReplyChannelRange *NONNULL_PTR this_ptr, struct LDKCVec_u64Z val);
7533 MUST_USE_RES struct LDKReplyChannelRange ReplyChannelRange_new(struct LDKThirtyTwoBytes chain_hash_arg, uint32_t first_blocknum_arg, uint32_t number_of_blocks_arg, bool sync_complete_arg, struct LDKCVec_u64Z short_channel_ids_arg);
7535 struct LDKReplyChannelRange ReplyChannelRange_clone(const struct LDKReplyChannelRange *NONNULL_PTR orig);
7537 void QueryShortChannelIds_free(struct LDKQueryShortChannelIds this_ptr);
7540 * The genesis hash of the blockchain being queried
7542 const uint8_t (*QueryShortChannelIds_get_chain_hash(const struct LDKQueryShortChannelIds *NONNULL_PTR this_ptr))[32];
7545 * The genesis hash of the blockchain being queried
7547 void QueryShortChannelIds_set_chain_hash(struct LDKQueryShortChannelIds *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7550 * The short_channel_ids that are being queried
7552 void QueryShortChannelIds_set_short_channel_ids(struct LDKQueryShortChannelIds *NONNULL_PTR this_ptr, struct LDKCVec_u64Z val);
7554 MUST_USE_RES struct LDKQueryShortChannelIds QueryShortChannelIds_new(struct LDKThirtyTwoBytes chain_hash_arg, struct LDKCVec_u64Z short_channel_ids_arg);
7556 struct LDKQueryShortChannelIds QueryShortChannelIds_clone(const struct LDKQueryShortChannelIds *NONNULL_PTR orig);
7558 void ReplyShortChannelIdsEnd_free(struct LDKReplyShortChannelIdsEnd this_ptr);
7561 * The genesis hash of the blockchain that was queried
7563 const uint8_t (*ReplyShortChannelIdsEnd_get_chain_hash(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr))[32];
7566 * The genesis hash of the blockchain that was queried
7568 void ReplyShortChannelIdsEnd_set_chain_hash(struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7571 * Indicates if the query recipient maintains up-to-date channel
7572 * information for the chain_hash
7574 bool ReplyShortChannelIdsEnd_get_full_information(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr);
7577 * Indicates if the query recipient maintains up-to-date channel
7578 * information for the chain_hash
7580 void ReplyShortChannelIdsEnd_set_full_information(struct LDKReplyShortChannelIdsEnd *NONNULL_PTR this_ptr, bool val);
7582 MUST_USE_RES struct LDKReplyShortChannelIdsEnd ReplyShortChannelIdsEnd_new(struct LDKThirtyTwoBytes chain_hash_arg, bool full_information_arg);
7584 struct LDKReplyShortChannelIdsEnd ReplyShortChannelIdsEnd_clone(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR orig);
7586 void GossipTimestampFilter_free(struct LDKGossipTimestampFilter this_ptr);
7589 * The genesis hash of the blockchain for channel and node information
7591 const uint8_t (*GossipTimestampFilter_get_chain_hash(const struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr))[32];
7594 * The genesis hash of the blockchain for channel and node information
7596 void GossipTimestampFilter_set_chain_hash(struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
7599 * The starting unix timestamp
7601 uint32_t GossipTimestampFilter_get_first_timestamp(const struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr);
7604 * The starting unix timestamp
7606 void GossipTimestampFilter_set_first_timestamp(struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr, uint32_t val);
7609 * The range of information in seconds
7611 uint32_t GossipTimestampFilter_get_timestamp_range(const struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr);
7614 * The range of information in seconds
7616 void GossipTimestampFilter_set_timestamp_range(struct LDKGossipTimestampFilter *NONNULL_PTR this_ptr, uint32_t val);
7618 MUST_USE_RES struct LDKGossipTimestampFilter GossipTimestampFilter_new(struct LDKThirtyTwoBytes chain_hash_arg, uint32_t first_timestamp_arg, uint32_t timestamp_range_arg);
7620 struct LDKGossipTimestampFilter GossipTimestampFilter_clone(const struct LDKGossipTimestampFilter *NONNULL_PTR orig);
7622 void ErrorAction_free(struct LDKErrorAction this_ptr);
7624 struct LDKErrorAction ErrorAction_clone(const struct LDKErrorAction *NONNULL_PTR orig);
7626 void LightningError_free(struct LDKLightningError this_ptr);
7629 * A human-readable message describing the error
7631 struct LDKStr LightningError_get_err(const struct LDKLightningError *NONNULL_PTR this_ptr);
7634 * A human-readable message describing the error
7636 void LightningError_set_err(struct LDKLightningError *NONNULL_PTR this_ptr, struct LDKCVec_u8Z val);
7639 * The action which should be taken against the offending peer.
7641 struct LDKErrorAction LightningError_get_action(const struct LDKLightningError *NONNULL_PTR this_ptr);
7644 * The action which should be taken against the offending peer.
7646 void LightningError_set_action(struct LDKLightningError *NONNULL_PTR this_ptr, struct LDKErrorAction val);
7648 MUST_USE_RES struct LDKLightningError LightningError_new(struct LDKCVec_u8Z err_arg, struct LDKErrorAction action_arg);
7650 struct LDKLightningError LightningError_clone(const struct LDKLightningError *NONNULL_PTR orig);
7652 void CommitmentUpdate_free(struct LDKCommitmentUpdate this_ptr);
7655 * update_add_htlc messages which should be sent
7657 void CommitmentUpdate_set_update_add_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKCVec_UpdateAddHTLCZ val);
7660 * update_fulfill_htlc messages which should be sent
7662 void CommitmentUpdate_set_update_fulfill_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKCVec_UpdateFulfillHTLCZ val);
7665 * update_fail_htlc messages which should be sent
7667 void CommitmentUpdate_set_update_fail_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKCVec_UpdateFailHTLCZ val);
7670 * update_fail_malformed_htlc messages which should be sent
7672 void CommitmentUpdate_set_update_fail_malformed_htlcs(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKCVec_UpdateFailMalformedHTLCZ val);
7675 * An update_fee message which should be sent
7677 struct LDKUpdateFee CommitmentUpdate_get_update_fee(const struct LDKCommitmentUpdate *NONNULL_PTR this_ptr);
7680 * An update_fee message which should be sent
7682 void CommitmentUpdate_set_update_fee(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKUpdateFee val);
7685 * Finally, the commitment_signed message which should be sent
7687 struct LDKCommitmentSigned CommitmentUpdate_get_commitment_signed(const struct LDKCommitmentUpdate *NONNULL_PTR this_ptr);
7690 * Finally, the commitment_signed message which should be sent
7692 void CommitmentUpdate_set_commitment_signed(struct LDKCommitmentUpdate *NONNULL_PTR this_ptr, struct LDKCommitmentSigned val);
7694 MUST_USE_RES struct LDKCommitmentUpdate CommitmentUpdate_new(struct LDKCVec_UpdateAddHTLCZ update_add_htlcs_arg, struct LDKCVec_UpdateFulfillHTLCZ update_fulfill_htlcs_arg, struct LDKCVec_UpdateFailHTLCZ update_fail_htlcs_arg, struct LDKCVec_UpdateFailMalformedHTLCZ update_fail_malformed_htlcs_arg, struct LDKUpdateFee update_fee_arg, struct LDKCommitmentSigned commitment_signed_arg);
7696 struct LDKCommitmentUpdate CommitmentUpdate_clone(const struct LDKCommitmentUpdate *NONNULL_PTR orig);
7698 void HTLCFailChannelUpdate_free(struct LDKHTLCFailChannelUpdate this_ptr);
7700 struct LDKHTLCFailChannelUpdate HTLCFailChannelUpdate_clone(const struct LDKHTLCFailChannelUpdate *NONNULL_PTR orig);
7703 * Calls the free function if one is set
7705 void ChannelMessageHandler_free(struct LDKChannelMessageHandler this_ptr);
7708 * Calls the free function if one is set
7710 void RoutingMessageHandler_free(struct LDKRoutingMessageHandler this_ptr);
7712 struct LDKCVec_u8Z AcceptChannel_write(const struct LDKAcceptChannel *NONNULL_PTR obj);
7714 struct LDKCResult_AcceptChannelDecodeErrorZ AcceptChannel_read(struct LDKu8slice ser);
7716 struct LDKCVec_u8Z AnnouncementSignatures_write(const struct LDKAnnouncementSignatures *NONNULL_PTR obj);
7718 struct LDKCResult_AnnouncementSignaturesDecodeErrorZ AnnouncementSignatures_read(struct LDKu8slice ser);
7720 struct LDKCVec_u8Z ChannelReestablish_write(const struct LDKChannelReestablish *NONNULL_PTR obj);
7722 struct LDKCResult_ChannelReestablishDecodeErrorZ ChannelReestablish_read(struct LDKu8slice ser);
7724 struct LDKCVec_u8Z ClosingSigned_write(const struct LDKClosingSigned *NONNULL_PTR obj);
7726 struct LDKCResult_ClosingSignedDecodeErrorZ ClosingSigned_read(struct LDKu8slice ser);
7728 struct LDKCVec_u8Z CommitmentSigned_write(const struct LDKCommitmentSigned *NONNULL_PTR obj);
7730 struct LDKCResult_CommitmentSignedDecodeErrorZ CommitmentSigned_read(struct LDKu8slice ser);
7732 struct LDKCVec_u8Z FundingCreated_write(const struct LDKFundingCreated *NONNULL_PTR obj);
7734 struct LDKCResult_FundingCreatedDecodeErrorZ FundingCreated_read(struct LDKu8slice ser);
7736 struct LDKCVec_u8Z FundingSigned_write(const struct LDKFundingSigned *NONNULL_PTR obj);
7738 struct LDKCResult_FundingSignedDecodeErrorZ FundingSigned_read(struct LDKu8slice ser);
7740 struct LDKCVec_u8Z FundingLocked_write(const struct LDKFundingLocked *NONNULL_PTR obj);
7742 struct LDKCResult_FundingLockedDecodeErrorZ FundingLocked_read(struct LDKu8slice ser);
7744 struct LDKCVec_u8Z Init_write(const struct LDKInit *NONNULL_PTR obj);
7746 struct LDKCResult_InitDecodeErrorZ Init_read(struct LDKu8slice ser);
7748 struct LDKCVec_u8Z OpenChannel_write(const struct LDKOpenChannel *NONNULL_PTR obj);
7750 struct LDKCResult_OpenChannelDecodeErrorZ OpenChannel_read(struct LDKu8slice ser);
7752 struct LDKCVec_u8Z RevokeAndACK_write(const struct LDKRevokeAndACK *NONNULL_PTR obj);
7754 struct LDKCResult_RevokeAndACKDecodeErrorZ RevokeAndACK_read(struct LDKu8slice ser);
7756 struct LDKCVec_u8Z Shutdown_write(const struct LDKShutdown *NONNULL_PTR obj);
7758 struct LDKCResult_ShutdownDecodeErrorZ Shutdown_read(struct LDKu8slice ser);
7760 struct LDKCVec_u8Z UpdateFailHTLC_write(const struct LDKUpdateFailHTLC *NONNULL_PTR obj);
7762 struct LDKCResult_UpdateFailHTLCDecodeErrorZ UpdateFailHTLC_read(struct LDKu8slice ser);
7764 struct LDKCVec_u8Z UpdateFailMalformedHTLC_write(const struct LDKUpdateFailMalformedHTLC *NONNULL_PTR obj);
7766 struct LDKCResult_UpdateFailMalformedHTLCDecodeErrorZ UpdateFailMalformedHTLC_read(struct LDKu8slice ser);
7768 struct LDKCVec_u8Z UpdateFee_write(const struct LDKUpdateFee *NONNULL_PTR obj);
7770 struct LDKCResult_UpdateFeeDecodeErrorZ UpdateFee_read(struct LDKu8slice ser);
7772 struct LDKCVec_u8Z UpdateFulfillHTLC_write(const struct LDKUpdateFulfillHTLC *NONNULL_PTR obj);
7774 struct LDKCResult_UpdateFulfillHTLCDecodeErrorZ UpdateFulfillHTLC_read(struct LDKu8slice ser);
7776 struct LDKCVec_u8Z UpdateAddHTLC_write(const struct LDKUpdateAddHTLC *NONNULL_PTR obj);
7778 struct LDKCResult_UpdateAddHTLCDecodeErrorZ UpdateAddHTLC_read(struct LDKu8slice ser);
7780 struct LDKCVec_u8Z Ping_write(const struct LDKPing *NONNULL_PTR obj);
7782 struct LDKCResult_PingDecodeErrorZ Ping_read(struct LDKu8slice ser);
7784 struct LDKCVec_u8Z Pong_write(const struct LDKPong *NONNULL_PTR obj);
7786 struct LDKCResult_PongDecodeErrorZ Pong_read(struct LDKu8slice ser);
7788 struct LDKCVec_u8Z UnsignedChannelAnnouncement_write(const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR obj);
7790 struct LDKCResult_UnsignedChannelAnnouncementDecodeErrorZ UnsignedChannelAnnouncement_read(struct LDKu8slice ser);
7792 struct LDKCVec_u8Z ChannelAnnouncement_write(const struct LDKChannelAnnouncement *NONNULL_PTR obj);
7794 struct LDKCResult_ChannelAnnouncementDecodeErrorZ ChannelAnnouncement_read(struct LDKu8slice ser);
7796 struct LDKCVec_u8Z UnsignedChannelUpdate_write(const struct LDKUnsignedChannelUpdate *NONNULL_PTR obj);
7798 struct LDKCResult_UnsignedChannelUpdateDecodeErrorZ UnsignedChannelUpdate_read(struct LDKu8slice ser);
7800 struct LDKCVec_u8Z ChannelUpdate_write(const struct LDKChannelUpdate *NONNULL_PTR obj);
7802 struct LDKCResult_ChannelUpdateDecodeErrorZ ChannelUpdate_read(struct LDKu8slice ser);
7804 struct LDKCVec_u8Z ErrorMessage_write(const struct LDKErrorMessage *NONNULL_PTR obj);
7806 struct LDKCResult_ErrorMessageDecodeErrorZ ErrorMessage_read(struct LDKu8slice ser);
7808 struct LDKCVec_u8Z UnsignedNodeAnnouncement_write(const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR obj);
7810 struct LDKCResult_UnsignedNodeAnnouncementDecodeErrorZ UnsignedNodeAnnouncement_read(struct LDKu8slice ser);
7812 struct LDKCVec_u8Z NodeAnnouncement_write(const struct LDKNodeAnnouncement *NONNULL_PTR obj);
7814 struct LDKCResult_NodeAnnouncementDecodeErrorZ NodeAnnouncement_read(struct LDKu8slice ser);
7816 struct LDKCResult_QueryShortChannelIdsDecodeErrorZ QueryShortChannelIds_read(struct LDKu8slice ser);
7818 struct LDKCVec_u8Z QueryShortChannelIds_write(const struct LDKQueryShortChannelIds *NONNULL_PTR obj);
7820 struct LDKCResult_ReplyShortChannelIdsEndDecodeErrorZ ReplyShortChannelIdsEnd_read(struct LDKu8slice ser);
7822 struct LDKCVec_u8Z ReplyShortChannelIdsEnd_write(const struct LDKReplyShortChannelIdsEnd *NONNULL_PTR obj);
7824 struct LDKCResult_QueryChannelRangeDecodeErrorZ QueryChannelRange_read(struct LDKu8slice ser);
7826 struct LDKCVec_u8Z QueryChannelRange_write(const struct LDKQueryChannelRange *NONNULL_PTR obj);
7828 struct LDKCResult_ReplyChannelRangeDecodeErrorZ ReplyChannelRange_read(struct LDKu8slice ser);
7830 struct LDKCVec_u8Z ReplyChannelRange_write(const struct LDKReplyChannelRange *NONNULL_PTR obj);
7832 struct LDKCResult_GossipTimestampFilterDecodeErrorZ GossipTimestampFilter_read(struct LDKu8slice ser);
7834 struct LDKCVec_u8Z GossipTimestampFilter_write(const struct LDKGossipTimestampFilter *NONNULL_PTR obj);
7836 void MessageHandler_free(struct LDKMessageHandler this_ptr);
7839 * A message handler which handles messages specific to channels. Usually this is just a
7840 * ChannelManager object.
7842 const struct LDKChannelMessageHandler *MessageHandler_get_chan_handler(const struct LDKMessageHandler *NONNULL_PTR this_ptr);
7845 * A message handler which handles messages specific to channels. Usually this is just a
7846 * ChannelManager object.
7848 void MessageHandler_set_chan_handler(struct LDKMessageHandler *NONNULL_PTR this_ptr, struct LDKChannelMessageHandler val);
7851 * A message handler which handles messages updating our knowledge of the network channel
7852 * graph. Usually this is just a NetGraphMsgHandlerMonitor object.
7854 const struct LDKRoutingMessageHandler *MessageHandler_get_route_handler(const struct LDKMessageHandler *NONNULL_PTR this_ptr);
7857 * A message handler which handles messages updating our knowledge of the network channel
7858 * graph. Usually this is just a NetGraphMsgHandlerMonitor object.
7860 void MessageHandler_set_route_handler(struct LDKMessageHandler *NONNULL_PTR this_ptr, struct LDKRoutingMessageHandler val);
7862 MUST_USE_RES struct LDKMessageHandler MessageHandler_new(struct LDKChannelMessageHandler chan_handler_arg, struct LDKRoutingMessageHandler route_handler_arg);
7864 struct LDKSocketDescriptor SocketDescriptor_clone(const struct LDKSocketDescriptor *NONNULL_PTR orig);
7867 * Calls the free function if one is set
7869 void SocketDescriptor_free(struct LDKSocketDescriptor this_ptr);
7871 void PeerHandleError_free(struct LDKPeerHandleError this_ptr);
7874 * Used to indicate that we probably can't make any future connections to this peer, implying
7875 * we should go ahead and force-close any channels we have with it.
7877 bool PeerHandleError_get_no_connection_possible(const struct LDKPeerHandleError *NONNULL_PTR this_ptr);
7880 * Used to indicate that we probably can't make any future connections to this peer, implying
7881 * we should go ahead and force-close any channels we have with it.
7883 void PeerHandleError_set_no_connection_possible(struct LDKPeerHandleError *NONNULL_PTR this_ptr, bool val);
7885 MUST_USE_RES struct LDKPeerHandleError PeerHandleError_new(bool no_connection_possible_arg);
7887 struct LDKPeerHandleError PeerHandleError_clone(const struct LDKPeerHandleError *NONNULL_PTR orig);
7889 void PeerManager_free(struct LDKPeerManager this_ptr);
7892 * Constructs a new PeerManager with the given message handlers and node_id secret key
7893 * ephemeral_random_data is used to derive per-connection ephemeral keys and must be
7894 * cryptographically secure random bytes.
7896 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);
7899 * Get the list of node ids for peers which have completed the initial handshake.
7901 * For outbound connections, this will be the same as the their_node_id parameter passed in to
7902 * new_outbound_connection, however entries will only appear once the initial handshake has
7903 * completed and we are sure the remote peer has the private key for the given node_id.
7905 MUST_USE_RES struct LDKCVec_PublicKeyZ PeerManager_get_peer_node_ids(const struct LDKPeerManager *NONNULL_PTR this_arg);
7908 * Indicates a new outbound connection has been established to a node with the given node_id.
7909 * Note that if an Err is returned here you MUST NOT call socket_disconnected for the new
7910 * descriptor but must disconnect the connection immediately.
7912 * Returns a small number of bytes to send to the remote node (currently always 50).
7914 * Panics if descriptor is duplicative with some other descriptor which has not yet had a
7915 * socket_disconnected().
7917 MUST_USE_RES struct LDKCResult_CVec_u8ZPeerHandleErrorZ PeerManager_new_outbound_connection(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKPublicKey their_node_id, struct LDKSocketDescriptor descriptor);
7920 * Indicates a new inbound connection has been established.
7922 * May refuse the connection by returning an Err, but will never write bytes to the remote end
7923 * (outbound connector always speaks first). Note that if an Err is returned here you MUST NOT
7924 * call socket_disconnected for the new descriptor but must disconnect the connection
7927 * Panics if descriptor is duplicative with some other descriptor which has not yet had
7928 * socket_disconnected called.
7930 MUST_USE_RES struct LDKCResult_NonePeerHandleErrorZ PeerManager_new_inbound_connection(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKSocketDescriptor descriptor);
7933 * Indicates that there is room to write data to the given socket descriptor.
7935 * May return an Err to indicate that the connection should be closed.
7937 * Will most likely call send_data on the descriptor passed in (or the descriptor handed into
7938 * new_*\\_connection) before returning. Thus, be very careful with reentrancy issues! The
7939 * invariants around calling write_buffer_space_avail in case a write did not fully complete
7940 * must still hold - be ready to call write_buffer_space_avail again if a write call generated
7941 * here isn't sufficient! Panics if the descriptor was not previously registered in a
7942 * new_\\*_connection event.
7944 MUST_USE_RES struct LDKCResult_NonePeerHandleErrorZ PeerManager_write_buffer_space_avail(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKSocketDescriptor *NONNULL_PTR descriptor);
7947 * Indicates that data was read from the given socket descriptor.
7949 * May return an Err to indicate that the connection should be closed.
7951 * Will *not* call back into send_data on any descriptors to avoid reentrancy complexity.
7952 * Thus, however, you almost certainly want to call process_events() after any read_event to
7953 * generate send_data calls to handle responses.
7955 * If Ok(true) is returned, further read_events should not be triggered until a send_data call
7956 * on this file descriptor has resume_read set (preventing DoS issues in the send buffer).
7958 * Panics if the descriptor was not previously registered in a new_*_connection event.
7960 MUST_USE_RES struct LDKCResult_boolPeerHandleErrorZ PeerManager_read_event(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKSocketDescriptor *NONNULL_PTR peer_descriptor, struct LDKu8slice data);
7963 * Checks for any events generated by our handlers and processes them. Includes sending most
7964 * response messages as well as messages generated by calls to handler functions directly (eg
7965 * functions like ChannelManager::process_pending_htlc_forward or send_payment).
7967 void PeerManager_process_events(const struct LDKPeerManager *NONNULL_PTR this_arg);
7970 * Indicates that the given socket descriptor's connection is now closed.
7972 * This must only be called if the socket has been disconnected by the peer or your own
7973 * decision to disconnect it and must NOT be called in any case where other parts of this
7974 * library (eg PeerHandleError, explicit disconnect_socket calls) instruct you to disconnect
7977 * Panics if the descriptor was not previously registered in a successful new_*_connection event.
7979 void PeerManager_socket_disconnected(const struct LDKPeerManager *NONNULL_PTR this_arg, const struct LDKSocketDescriptor *NONNULL_PTR descriptor);
7982 * Disconnect a peer given its node id.
7984 * Set no_connection_possible to true to prevent any further connection with this peer,
7985 * force-closing any channels we have with it.
7987 * If a peer is connected, this will call `disconnect_socket` on the descriptor for the peer,
7988 * so be careful about reentrancy issues.
7990 void PeerManager_disconnect_by_node_id(const struct LDKPeerManager *NONNULL_PTR this_arg, struct LDKPublicKey node_id, bool no_connection_possible);
7993 * This function should be called roughly once every 30 seconds.
7994 * It will send pings to each peer and disconnect those which did not respond to the last round of pings.
7995 * Will most likely call send_data on all of the registered descriptors, thus, be very careful with reentrancy issues!
7997 void PeerManager_timer_tick_occured(const struct LDKPeerManager *NONNULL_PTR this_arg);
8000 * Build the commitment secret from the seed and the commitment number
8002 struct LDKThirtyTwoBytes build_commitment_secret(const uint8_t (*commitment_seed)[32], uint64_t idx);
8005 * Derives a per-commitment-transaction private key (eg an htlc key or delayed_payment key)
8006 * from the base secret and the per_commitment_point.
8008 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
8009 * generated (ie our own).
8011 struct LDKCResult_SecretKeyErrorZ derive_private_key(struct LDKPublicKey per_commitment_point, const uint8_t (*base_secret)[32]);
8014 * Derives a per-commitment-transaction public key (eg an htlc key or a delayed_payment key)
8015 * from the base point and the per_commitment_key. This is the public equivalent of
8016 * derive_private_key - using only public keys to derive a public key instead of private keys.
8018 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
8019 * generated (ie our own).
8021 struct LDKCResult_PublicKeyErrorZ derive_public_key(struct LDKPublicKey per_commitment_point, struct LDKPublicKey base_point);
8024 * Derives a per-commitment-transaction revocation key from its constituent parts.
8026 * Only the cheating participant owns a valid witness to propagate a revoked
8027 * commitment transaction, thus per_commitment_secret always come from cheater
8028 * and revocation_base_secret always come from punisher, which is the broadcaster
8029 * of the transaction spending with this key knowledge.
8031 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
8032 * generated (ie our own).
8034 struct LDKCResult_SecretKeyErrorZ derive_private_revocation_key(const uint8_t (*per_commitment_secret)[32], const uint8_t (*countersignatory_revocation_base_secret)[32]);
8037 * Derives a per-commitment-transaction revocation public key from its constituent parts. This is
8038 * the public equivalend of derive_private_revocation_key - using only public keys to derive a
8039 * public key instead of private keys.
8041 * Only the cheating participant owns a valid witness to propagate a revoked
8042 * commitment transaction, thus per_commitment_point always come from cheater
8043 * and revocation_base_point always come from punisher, which is the broadcaster
8044 * of the transaction spending with this key knowledge.
8046 * Note that this is infallible iff we trust that at least one of the two input keys are randomly
8047 * generated (ie our own).
8049 struct LDKCResult_PublicKeyErrorZ derive_public_revocation_key(struct LDKPublicKey per_commitment_point, struct LDKPublicKey countersignatory_revocation_base_point);
8051 void TxCreationKeys_free(struct LDKTxCreationKeys this_ptr);
8054 * The broadcaster's per-commitment public key which was used to derive the other keys.
8056 struct LDKPublicKey TxCreationKeys_get_per_commitment_point(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
8059 * The broadcaster's per-commitment public key which was used to derive the other keys.
8061 void TxCreationKeys_set_per_commitment_point(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8064 * The revocation key which is used to allow the broadcaster of the commitment
8065 * transaction to provide their counterparty the ability to punish them if they broadcast
8068 struct LDKPublicKey TxCreationKeys_get_revocation_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
8071 * The revocation key which is used to allow the broadcaster of the commitment
8072 * transaction to provide their counterparty the ability to punish them if they broadcast
8075 void TxCreationKeys_set_revocation_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8078 * Broadcaster's HTLC Key
8080 struct LDKPublicKey TxCreationKeys_get_broadcaster_htlc_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
8083 * Broadcaster's HTLC Key
8085 void TxCreationKeys_set_broadcaster_htlc_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8088 * Countersignatory's HTLC Key
8090 struct LDKPublicKey TxCreationKeys_get_countersignatory_htlc_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
8093 * Countersignatory's HTLC Key
8095 void TxCreationKeys_set_countersignatory_htlc_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8098 * Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
8100 struct LDKPublicKey TxCreationKeys_get_broadcaster_delayed_payment_key(const struct LDKTxCreationKeys *NONNULL_PTR this_ptr);
8103 * Broadcaster's Payment Key (which isn't allowed to be spent from for some delay)
8105 void TxCreationKeys_set_broadcaster_delayed_payment_key(struct LDKTxCreationKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8107 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);
8109 struct LDKTxCreationKeys TxCreationKeys_clone(const struct LDKTxCreationKeys *NONNULL_PTR orig);
8111 struct LDKCVec_u8Z TxCreationKeys_write(const struct LDKTxCreationKeys *NONNULL_PTR obj);
8113 struct LDKCResult_TxCreationKeysDecodeErrorZ TxCreationKeys_read(struct LDKu8slice ser);
8115 void ChannelPublicKeys_free(struct LDKChannelPublicKeys this_ptr);
8118 * The public key which is used to sign all commitment transactions, as it appears in the
8119 * on-chain channel lock-in 2-of-2 multisig output.
8121 struct LDKPublicKey ChannelPublicKeys_get_funding_pubkey(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
8124 * The public key which is used to sign all commitment transactions, as it appears in the
8125 * on-chain channel lock-in 2-of-2 multisig output.
8127 void ChannelPublicKeys_set_funding_pubkey(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8130 * The base point which is used (with derive_public_revocation_key) to derive per-commitment
8131 * revocation keys. This is combined with the per-commitment-secret generated by the
8132 * counterparty to create a secret which the counterparty can reveal to revoke previous
8135 struct LDKPublicKey ChannelPublicKeys_get_revocation_basepoint(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
8138 * The base point which is used (with derive_public_revocation_key) to derive per-commitment
8139 * revocation keys. This is combined with the per-commitment-secret generated by the
8140 * counterparty to create a secret which the counterparty can reveal to revoke previous
8143 void ChannelPublicKeys_set_revocation_basepoint(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8146 * The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
8147 * spendable primary channel balance on the broadcaster's commitment transaction. This key is
8148 * static across every commitment transaction.
8150 struct LDKPublicKey ChannelPublicKeys_get_payment_point(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
8153 * The public key on which the non-broadcaster (ie the countersignatory) receives an immediately
8154 * spendable primary channel balance on the broadcaster's commitment transaction. This key is
8155 * static across every commitment transaction.
8157 void ChannelPublicKeys_set_payment_point(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8160 * The base point which is used (with derive_public_key) to derive a per-commitment payment
8161 * public key which receives non-HTLC-encumbered funds which are only available for spending
8162 * after some delay (or can be claimed via the revocation path).
8164 struct LDKPublicKey ChannelPublicKeys_get_delayed_payment_basepoint(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
8167 * The base point which is used (with derive_public_key) to derive a per-commitment payment
8168 * public key which receives non-HTLC-encumbered funds which are only available for spending
8169 * after some delay (or can be claimed via the revocation path).
8171 void ChannelPublicKeys_set_delayed_payment_basepoint(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8174 * The base point which is used (with derive_public_key) to derive a per-commitment public key
8175 * which is used to encumber HTLC-in-flight outputs.
8177 struct LDKPublicKey ChannelPublicKeys_get_htlc_basepoint(const struct LDKChannelPublicKeys *NONNULL_PTR this_ptr);
8180 * The base point which is used (with derive_public_key) to derive a per-commitment public key
8181 * which is used to encumber HTLC-in-flight outputs.
8183 void ChannelPublicKeys_set_htlc_basepoint(struct LDKChannelPublicKeys *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8185 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);
8187 struct LDKChannelPublicKeys ChannelPublicKeys_clone(const struct LDKChannelPublicKeys *NONNULL_PTR orig);
8189 struct LDKCVec_u8Z ChannelPublicKeys_write(const struct LDKChannelPublicKeys *NONNULL_PTR obj);
8191 struct LDKCResult_ChannelPublicKeysDecodeErrorZ ChannelPublicKeys_read(struct LDKu8slice ser);
8194 * Create per-state keys from channel base points and the per-commitment point.
8195 * Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
8197 MUST_USE_RES struct LDKCResult_TxCreationKeysErrorZ 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);
8200 * Generate per-state keys from channel static keys.
8201 * Key set is asymmetric and can't be used as part of counter-signatory set of transactions.
8203 MUST_USE_RES struct LDKCResult_TxCreationKeysErrorZ TxCreationKeys_from_channel_static_keys(struct LDKPublicKey per_commitment_point, const struct LDKChannelPublicKeys *NONNULL_PTR broadcaster_keys, const struct LDKChannelPublicKeys *NONNULL_PTR countersignatory_keys);
8206 * A script either spendable by the revocation
8207 * key or the broadcaster_delayed_payment_key and satisfying the relative-locktime OP_CSV constrain.
8208 * Encumbering a `to_holder` output on a commitment transaction or 2nd-stage HTLC transactions.
8210 struct LDKCVec_u8Z get_revokeable_redeemscript(struct LDKPublicKey revocation_key, uint16_t contest_delay, struct LDKPublicKey broadcaster_delayed_payment_key);
8212 void HTLCOutputInCommitment_free(struct LDKHTLCOutputInCommitment this_ptr);
8215 * Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
8216 * Note that this is not the same as whether it is ountbound *from us*. To determine that you
8217 * need to compare this value to whether the commitment transaction in question is that of
8218 * the counterparty or our own.
8220 bool HTLCOutputInCommitment_get_offered(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr);
8223 * Whether the HTLC was \"offered\" (ie outbound in relation to this commitment transaction).
8224 * Note that this is not the same as whether it is ountbound *from us*. To determine that you
8225 * need to compare this value to whether the commitment transaction in question is that of
8226 * the counterparty or our own.
8228 void HTLCOutputInCommitment_set_offered(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, bool val);
8231 * The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
8232 * this divided by 1000.
8234 uint64_t HTLCOutputInCommitment_get_amount_msat(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr);
8237 * The value, in msat, of the HTLC. The value as it appears in the commitment transaction is
8238 * this divided by 1000.
8240 void HTLCOutputInCommitment_set_amount_msat(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, uint64_t val);
8243 * The CLTV lock-time at which this HTLC expires.
8245 uint32_t HTLCOutputInCommitment_get_cltv_expiry(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr);
8248 * The CLTV lock-time at which this HTLC expires.
8250 void HTLCOutputInCommitment_set_cltv_expiry(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, uint32_t val);
8253 * The hash of the preimage which unlocks this HTLC.
8255 const uint8_t (*HTLCOutputInCommitment_get_payment_hash(const struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr))[32];
8258 * The hash of the preimage which unlocks this HTLC.
8260 void HTLCOutputInCommitment_set_payment_hash(struct LDKHTLCOutputInCommitment *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
8262 struct LDKHTLCOutputInCommitment HTLCOutputInCommitment_clone(const struct LDKHTLCOutputInCommitment *NONNULL_PTR orig);
8264 struct LDKCVec_u8Z HTLCOutputInCommitment_write(const struct LDKHTLCOutputInCommitment *NONNULL_PTR obj);
8266 struct LDKCResult_HTLCOutputInCommitmentDecodeErrorZ HTLCOutputInCommitment_read(struct LDKu8slice ser);
8269 * Gets the witness redeemscript for an HTLC output in a commitment transaction. Note that htlc
8270 * does not need to have its previous_output_index filled.
8272 struct LDKCVec_u8Z get_htlc_redeemscript(const struct LDKHTLCOutputInCommitment *NONNULL_PTR htlc, const struct LDKTxCreationKeys *NONNULL_PTR keys);
8275 * Gets the redeemscript for a funding output from the two funding public keys.
8276 * Note that the order of funding public keys does not matter.
8278 struct LDKCVec_u8Z make_funding_redeemscript(struct LDKPublicKey broadcaster, struct LDKPublicKey countersignatory);
8281 * panics if htlc.transaction_output_index.is_none()!
8283 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);
8285 void ChannelTransactionParameters_free(struct LDKChannelTransactionParameters this_ptr);
8288 * Holder public keys
8290 struct LDKChannelPublicKeys ChannelTransactionParameters_get_holder_pubkeys(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
8293 * Holder public keys
8295 void ChannelTransactionParameters_set_holder_pubkeys(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKChannelPublicKeys val);
8298 * The contest delay selected by the holder, which applies to counterparty-broadcast transactions
8300 uint16_t ChannelTransactionParameters_get_holder_selected_contest_delay(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
8303 * The contest delay selected by the holder, which applies to counterparty-broadcast transactions
8305 void ChannelTransactionParameters_set_holder_selected_contest_delay(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, uint16_t val);
8308 * Whether the holder is the initiator of this channel.
8309 * This is an input to the commitment number obscure factor computation.
8311 bool ChannelTransactionParameters_get_is_outbound_from_holder(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
8314 * Whether the holder is the initiator of this channel.
8315 * This is an input to the commitment number obscure factor computation.
8317 void ChannelTransactionParameters_set_is_outbound_from_holder(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, bool val);
8320 * The late-bound counterparty channel transaction parameters.
8321 * These parameters are populated at the point in the protocol where the counterparty provides them.
8323 struct LDKCounterpartyChannelTransactionParameters ChannelTransactionParameters_get_counterparty_parameters(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
8326 * The late-bound counterparty channel transaction parameters.
8327 * These parameters are populated at the point in the protocol where the counterparty provides them.
8329 void ChannelTransactionParameters_set_counterparty_parameters(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKCounterpartyChannelTransactionParameters val);
8332 * The late-bound funding outpoint
8334 struct LDKOutPoint ChannelTransactionParameters_get_funding_outpoint(const struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr);
8337 * The late-bound funding outpoint
8339 void ChannelTransactionParameters_set_funding_outpoint(struct LDKChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKOutPoint val);
8341 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);
8343 struct LDKChannelTransactionParameters ChannelTransactionParameters_clone(const struct LDKChannelTransactionParameters *NONNULL_PTR orig);
8345 void CounterpartyChannelTransactionParameters_free(struct LDKCounterpartyChannelTransactionParameters this_ptr);
8348 * Counter-party public keys
8350 struct LDKChannelPublicKeys CounterpartyChannelTransactionParameters_get_pubkeys(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr);
8353 * Counter-party public keys
8355 void CounterpartyChannelTransactionParameters_set_pubkeys(struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr, struct LDKChannelPublicKeys val);
8358 * The contest delay selected by the counterparty, which applies to holder-broadcast transactions
8360 uint16_t CounterpartyChannelTransactionParameters_get_selected_contest_delay(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr);
8363 * The contest delay selected by the counterparty, which applies to holder-broadcast transactions
8365 void CounterpartyChannelTransactionParameters_set_selected_contest_delay(struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR this_ptr, uint16_t val);
8367 MUST_USE_RES struct LDKCounterpartyChannelTransactionParameters CounterpartyChannelTransactionParameters_new(struct LDKChannelPublicKeys pubkeys_arg, uint16_t selected_contest_delay_arg);
8369 struct LDKCounterpartyChannelTransactionParameters CounterpartyChannelTransactionParameters_clone(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR orig);
8372 * Whether the late bound parameters are populated.
8374 MUST_USE_RES bool ChannelTransactionParameters_is_populated(const struct LDKChannelTransactionParameters *NONNULL_PTR this_arg);
8377 * Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
8378 * given that the holder is the broadcaster.
8380 * self.is_populated() must be true before calling this function.
8382 MUST_USE_RES struct LDKDirectedChannelTransactionParameters ChannelTransactionParameters_as_holder_broadcastable(const struct LDKChannelTransactionParameters *NONNULL_PTR this_arg);
8385 * Convert the holder/counterparty parameters to broadcaster/countersignatory-organized parameters,
8386 * given that the counterparty is the broadcaster.
8388 * self.is_populated() must be true before calling this function.
8390 MUST_USE_RES struct LDKDirectedChannelTransactionParameters ChannelTransactionParameters_as_counterparty_broadcastable(const struct LDKChannelTransactionParameters *NONNULL_PTR this_arg);
8392 struct LDKCVec_u8Z CounterpartyChannelTransactionParameters_write(const struct LDKCounterpartyChannelTransactionParameters *NONNULL_PTR obj);
8394 struct LDKCResult_CounterpartyChannelTransactionParametersDecodeErrorZ CounterpartyChannelTransactionParameters_read(struct LDKu8slice ser);
8396 struct LDKCVec_u8Z ChannelTransactionParameters_write(const struct LDKChannelTransactionParameters *NONNULL_PTR obj);
8398 struct LDKCResult_ChannelTransactionParametersDecodeErrorZ ChannelTransactionParameters_read(struct LDKu8slice ser);
8400 void DirectedChannelTransactionParameters_free(struct LDKDirectedChannelTransactionParameters this_ptr);
8403 * Get the channel pubkeys for the broadcaster
8405 MUST_USE_RES struct LDKChannelPublicKeys DirectedChannelTransactionParameters_broadcaster_pubkeys(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
8408 * Get the channel pubkeys for the countersignatory
8410 MUST_USE_RES struct LDKChannelPublicKeys DirectedChannelTransactionParameters_countersignatory_pubkeys(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
8413 * Get the contest delay applicable to the transactions.
8414 * Note that the contest delay was selected by the countersignatory.
8416 MUST_USE_RES uint16_t DirectedChannelTransactionParameters_contest_delay(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
8419 * Whether the channel is outbound from the broadcaster.
8421 * The boolean representing the side that initiated the channel is
8422 * an input to the commitment number obscure factor computation.
8424 MUST_USE_RES bool DirectedChannelTransactionParameters_is_outbound(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
8427 * The funding outpoint
8429 MUST_USE_RES struct LDKOutPoint DirectedChannelTransactionParameters_funding_outpoint(const struct LDKDirectedChannelTransactionParameters *NONNULL_PTR this_arg);
8431 void HolderCommitmentTransaction_free(struct LDKHolderCommitmentTransaction this_ptr);
8434 * Our counterparty's signature for the transaction
8436 struct LDKSignature HolderCommitmentTransaction_get_counterparty_sig(const struct LDKHolderCommitmentTransaction *NONNULL_PTR this_ptr);
8439 * Our counterparty's signature for the transaction
8441 void HolderCommitmentTransaction_set_counterparty_sig(struct LDKHolderCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKSignature val);
8444 * All non-dust counterparty HTLC signatures, in the order they appear in the transaction
8446 void HolderCommitmentTransaction_set_counterparty_htlc_sigs(struct LDKHolderCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKCVec_SignatureZ val);
8448 struct LDKHolderCommitmentTransaction HolderCommitmentTransaction_clone(const struct LDKHolderCommitmentTransaction *NONNULL_PTR orig);
8450 struct LDKCVec_u8Z HolderCommitmentTransaction_write(const struct LDKHolderCommitmentTransaction *NONNULL_PTR obj);
8452 struct LDKCResult_HolderCommitmentTransactionDecodeErrorZ HolderCommitmentTransaction_read(struct LDKu8slice ser);
8455 * Create a new holder transaction with the given counterparty signatures.
8456 * The funding keys are used to figure out which signature should go first when building the transaction for broadcast.
8458 MUST_USE_RES struct LDKHolderCommitmentTransaction HolderCommitmentTransaction_new(struct LDKCommitmentTransaction commitment_tx, struct LDKSignature counterparty_sig, struct LDKCVec_SignatureZ counterparty_htlc_sigs, struct LDKPublicKey holder_funding_key, struct LDKPublicKey counterparty_funding_key);
8460 void BuiltCommitmentTransaction_free(struct LDKBuiltCommitmentTransaction this_ptr);
8463 * The commitment transaction
8465 struct LDKTransaction BuiltCommitmentTransaction_get_transaction(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr);
8468 * The commitment transaction
8470 void BuiltCommitmentTransaction_set_transaction(struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKTransaction val);
8473 * The txid for the commitment transaction.
8475 * This is provided as a performance optimization, instead of calling transaction.txid()
8478 const uint8_t (*BuiltCommitmentTransaction_get_txid(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr))[32];
8481 * The txid for the commitment transaction.
8483 * This is provided as a performance optimization, instead of calling transaction.txid()
8486 void BuiltCommitmentTransaction_set_txid(struct LDKBuiltCommitmentTransaction *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
8488 MUST_USE_RES struct LDKBuiltCommitmentTransaction BuiltCommitmentTransaction_new(struct LDKTransaction transaction_arg, struct LDKThirtyTwoBytes txid_arg);
8490 struct LDKBuiltCommitmentTransaction BuiltCommitmentTransaction_clone(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR orig);
8492 struct LDKCVec_u8Z BuiltCommitmentTransaction_write(const struct LDKBuiltCommitmentTransaction *NONNULL_PTR obj);
8494 struct LDKCResult_BuiltCommitmentTransactionDecodeErrorZ BuiltCommitmentTransaction_read(struct LDKu8slice ser);
8497 * Get the SIGHASH_ALL sighash value of the transaction.
8499 * This can be used to verify a signature.
8501 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);
8504 * Sign a transaction, either because we are counter-signing the counterparty's transaction or
8505 * because we are about to broadcast a holder transaction.
8507 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);
8509 void CommitmentTransaction_free(struct LDKCommitmentTransaction this_ptr);
8511 struct LDKCommitmentTransaction CommitmentTransaction_clone(const struct LDKCommitmentTransaction *NONNULL_PTR orig);
8513 struct LDKCVec_u8Z CommitmentTransaction_write(const struct LDKCommitmentTransaction *NONNULL_PTR obj);
8515 struct LDKCResult_CommitmentTransactionDecodeErrorZ CommitmentTransaction_read(struct LDKu8slice ser);
8518 * The backwards-counting commitment number
8520 MUST_USE_RES uint64_t CommitmentTransaction_commitment_number(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
8523 * The value to be sent to the broadcaster
8525 MUST_USE_RES uint64_t CommitmentTransaction_to_broadcaster_value_sat(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
8528 * The value to be sent to the counterparty
8530 MUST_USE_RES uint64_t CommitmentTransaction_to_countersignatory_value_sat(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
8533 * The feerate paid per 1000-weight-unit in this commitment transaction.
8535 MUST_USE_RES uint32_t CommitmentTransaction_feerate_per_kw(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
8538 * Trust our pre-built transaction and derived transaction creation public keys.
8540 * Applies a wrapper which allows access to these fields.
8542 * This should only be used if you fully trust the builder of this object. It should not
8543 *\tbe used by an external signer - instead use the verify function.
8545 MUST_USE_RES struct LDKTrustedCommitmentTransaction CommitmentTransaction_trust(const struct LDKCommitmentTransaction *NONNULL_PTR this_arg);
8548 * Verify our pre-built transaction and derived transaction creation public keys.
8550 * Applies a wrapper which allows access to these fields.
8552 * An external validating signer must call this method before signing
8553 * or using the built transaction.
8555 MUST_USE_RES struct 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);
8557 void TrustedCommitmentTransaction_free(struct LDKTrustedCommitmentTransaction this_ptr);
8560 * The transaction ID of the built Bitcoin transaction
8562 MUST_USE_RES struct LDKThirtyTwoBytes TrustedCommitmentTransaction_txid(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg);
8565 * The pre-built Bitcoin commitment transaction
8567 MUST_USE_RES struct LDKBuiltCommitmentTransaction TrustedCommitmentTransaction_built_transaction(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg);
8570 * The pre-calculated transaction creation public keys.
8572 MUST_USE_RES struct LDKTxCreationKeys TrustedCommitmentTransaction_keys(const struct LDKTrustedCommitmentTransaction *NONNULL_PTR this_arg);
8575 * Get a signature for each HTLC which was included in the commitment transaction (ie for
8576 * which HTLCOutputInCommitment::transaction_output_index.is_some()).
8578 * The returned Vec has one entry for each HTLC, and in the same order.
8580 MUST_USE_RES struct 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);
8583 * Get the transaction number obscure factor
8585 uint64_t get_commitment_transaction_number_obscure_factor(struct LDKPublicKey broadcaster_payment_basepoint, struct LDKPublicKey countersignatory_payment_basepoint, bool outbound_from_broadcaster);
8587 struct LDKInitFeatures InitFeatures_clone(const struct LDKInitFeatures *NONNULL_PTR orig);
8589 struct LDKNodeFeatures NodeFeatures_clone(const struct LDKNodeFeatures *NONNULL_PTR orig);
8591 struct LDKChannelFeatures ChannelFeatures_clone(const struct LDKChannelFeatures *NONNULL_PTR orig);
8593 void InitFeatures_free(struct LDKInitFeatures this_ptr);
8595 void NodeFeatures_free(struct LDKNodeFeatures this_ptr);
8597 void ChannelFeatures_free(struct LDKChannelFeatures this_ptr);
8600 * Create a blank Features with no features set
8602 MUST_USE_RES struct LDKInitFeatures InitFeatures_empty(void);
8605 * Creates features known by the implementation as defined by [`T::KNOWN_FEATURE_FLAGS`].
8607 * [`T::KNOWN_FEATURE_FLAGS`]: sealed/trait.Context.html#associatedconstant.KNOWN_FEATURE_FLAGS
8609 MUST_USE_RES struct LDKInitFeatures InitFeatures_known(void);
8612 * Create a blank Features with no features set
8614 MUST_USE_RES struct LDKNodeFeatures NodeFeatures_empty(void);
8617 * Creates features known by the implementation as defined by [`T::KNOWN_FEATURE_FLAGS`].
8619 * [`T::KNOWN_FEATURE_FLAGS`]: sealed/trait.Context.html#associatedconstant.KNOWN_FEATURE_FLAGS
8621 MUST_USE_RES struct LDKNodeFeatures NodeFeatures_known(void);
8624 * Create a blank Features with no features set
8626 MUST_USE_RES struct LDKChannelFeatures ChannelFeatures_empty(void);
8629 * Creates features known by the implementation as defined by [`T::KNOWN_FEATURE_FLAGS`].
8631 * [`T::KNOWN_FEATURE_FLAGS`]: sealed/trait.Context.html#associatedconstant.KNOWN_FEATURE_FLAGS
8633 MUST_USE_RES struct LDKChannelFeatures ChannelFeatures_known(void);
8635 struct LDKCVec_u8Z InitFeatures_write(const struct LDKInitFeatures *NONNULL_PTR obj);
8637 struct LDKCVec_u8Z NodeFeatures_write(const struct LDKNodeFeatures *NONNULL_PTR obj);
8639 struct LDKCVec_u8Z ChannelFeatures_write(const struct LDKChannelFeatures *NONNULL_PTR obj);
8641 struct LDKCResult_InitFeaturesDecodeErrorZ InitFeatures_read(struct LDKu8slice ser);
8643 struct LDKCResult_NodeFeaturesDecodeErrorZ NodeFeatures_read(struct LDKu8slice ser);
8645 struct LDKCResult_ChannelFeaturesDecodeErrorZ ChannelFeatures_read(struct LDKu8slice ser);
8647 void RouteHop_free(struct LDKRouteHop this_ptr);
8650 * The node_id of the node at this hop.
8652 struct LDKPublicKey RouteHop_get_pubkey(const struct LDKRouteHop *NONNULL_PTR this_ptr);
8655 * The node_id of the node at this hop.
8657 void RouteHop_set_pubkey(struct LDKRouteHop *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8660 * The node_announcement features of the node at this hop. For the last hop, these may be
8661 * amended to match the features present in the invoice this node generated.
8663 struct LDKNodeFeatures RouteHop_get_node_features(const struct LDKRouteHop *NONNULL_PTR this_ptr);
8666 * The node_announcement features of the node at this hop. For the last hop, these may be
8667 * amended to match the features present in the invoice this node generated.
8669 void RouteHop_set_node_features(struct LDKRouteHop *NONNULL_PTR this_ptr, struct LDKNodeFeatures val);
8672 * The channel that should be used from the previous hop to reach this node.
8674 uint64_t RouteHop_get_short_channel_id(const struct LDKRouteHop *NONNULL_PTR this_ptr);
8677 * The channel that should be used from the previous hop to reach this node.
8679 void RouteHop_set_short_channel_id(struct LDKRouteHop *NONNULL_PTR this_ptr, uint64_t val);
8682 * The channel_announcement features of the channel that should be used from the previous hop
8683 * to reach this node.
8685 struct LDKChannelFeatures RouteHop_get_channel_features(const struct LDKRouteHop *NONNULL_PTR this_ptr);
8688 * The channel_announcement features of the channel that should be used from the previous hop
8689 * to reach this node.
8691 void RouteHop_set_channel_features(struct LDKRouteHop *NONNULL_PTR this_ptr, struct LDKChannelFeatures val);
8694 * The fee taken on this hop. For the last hop, this should be the full value of the payment.
8696 uint64_t RouteHop_get_fee_msat(const struct LDKRouteHop *NONNULL_PTR this_ptr);
8699 * The fee taken on this hop. For the last hop, this should be the full value of the payment.
8701 void RouteHop_set_fee_msat(struct LDKRouteHop *NONNULL_PTR this_ptr, uint64_t val);
8704 * The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
8705 * expected at the destination, in excess of the current block height.
8707 uint32_t RouteHop_get_cltv_expiry_delta(const struct LDKRouteHop *NONNULL_PTR this_ptr);
8710 * The CLTV delta added for this hop. For the last hop, this should be the full CLTV value
8711 * expected at the destination, in excess of the current block height.
8713 void RouteHop_set_cltv_expiry_delta(struct LDKRouteHop *NONNULL_PTR this_ptr, uint32_t val);
8715 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);
8717 struct LDKRouteHop RouteHop_clone(const struct LDKRouteHop *NONNULL_PTR orig);
8719 void Route_free(struct LDKRoute this_ptr);
8722 * The list of routes taken for a single (potentially-)multi-part payment. The pubkey of the
8723 * last RouteHop in each path must be the same.
8724 * Each entry represents a list of hops, NOT INCLUDING our own, where the last hop is the
8725 * destination. Thus, this must always be at least length one. While the maximum length of any
8726 * given path is variable, keeping the length of any path to less than 20 should currently
8727 * ensure it is viable.
8729 void Route_set_paths(struct LDKRoute *NONNULL_PTR this_ptr, struct LDKCVec_CVec_RouteHopZZ val);
8731 MUST_USE_RES struct LDKRoute Route_new(struct LDKCVec_CVec_RouteHopZZ paths_arg);
8733 struct LDKRoute Route_clone(const struct LDKRoute *NONNULL_PTR orig);
8735 struct LDKCVec_u8Z Route_write(const struct LDKRoute *NONNULL_PTR obj);
8737 struct LDKCResult_RouteDecodeErrorZ Route_read(struct LDKu8slice ser);
8739 void RouteHint_free(struct LDKRouteHint this_ptr);
8742 * The node_id of the non-target end of the route
8744 struct LDKPublicKey RouteHint_get_src_node_id(const struct LDKRouteHint *NONNULL_PTR this_ptr);
8747 * The node_id of the non-target end of the route
8749 void RouteHint_set_src_node_id(struct LDKRouteHint *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8752 * The short_channel_id of this channel
8754 uint64_t RouteHint_get_short_channel_id(const struct LDKRouteHint *NONNULL_PTR this_ptr);
8757 * The short_channel_id of this channel
8759 void RouteHint_set_short_channel_id(struct LDKRouteHint *NONNULL_PTR this_ptr, uint64_t val);
8762 * The fees which must be paid to use this channel
8764 struct LDKRoutingFees RouteHint_get_fees(const struct LDKRouteHint *NONNULL_PTR this_ptr);
8767 * The fees which must be paid to use this channel
8769 void RouteHint_set_fees(struct LDKRouteHint *NONNULL_PTR this_ptr, struct LDKRoutingFees val);
8772 * The difference in CLTV values between this node and the next node.
8774 uint16_t RouteHint_get_cltv_expiry_delta(const struct LDKRouteHint *NONNULL_PTR this_ptr);
8777 * The difference in CLTV values between this node and the next node.
8779 void RouteHint_set_cltv_expiry_delta(struct LDKRouteHint *NONNULL_PTR this_ptr, uint16_t val);
8782 * The minimum value, in msat, which must be relayed to the next hop.
8784 uint64_t RouteHint_get_htlc_minimum_msat(const struct LDKRouteHint *NONNULL_PTR this_ptr);
8787 * The minimum value, in msat, which must be relayed to the next hop.
8789 void RouteHint_set_htlc_minimum_msat(struct LDKRouteHint *NONNULL_PTR this_ptr, uint64_t val);
8791 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);
8793 struct LDKRouteHint RouteHint_clone(const struct LDKRouteHint *NONNULL_PTR orig);
8796 * Gets a route from us to the given target node.
8798 * Extra routing hops between known nodes and the target will be used if they are included in
8801 * If some channels aren't announced, it may be useful to fill in a first_hops with the
8802 * results from a local ChannelManager::list_usable_channels() call. If it is filled in, our
8803 * view of our local channels (from net_graph_msg_handler) will be ignored, and only those in first_hops
8806 * Panics if first_hops contains channels without short_channel_ids
8807 * (ChannelManager::list_usable_channels will never include such channels).
8809 * The fees on channels from us to next-hops are ignored (as they are assumed to all be
8810 * equal), however the enabled/disabled bit on such channels as well as the htlc_minimum_msat
8811 * *is* checked as they may change based on the receiving node.
8813 struct LDKCResult_RouteLightningErrorZ get_route(struct LDKPublicKey our_node_id, const struct LDKNetworkGraph *NONNULL_PTR network, struct LDKPublicKey target, struct LDKCVec_ChannelDetailsZ *first_hops, struct LDKCVec_RouteHintZ last_hops, uint64_t final_value_msat, uint32_t final_cltv, struct LDKLogger logger);
8815 void NetworkGraph_free(struct LDKNetworkGraph this_ptr);
8817 struct LDKNetworkGraph NetworkGraph_clone(const struct LDKNetworkGraph *NONNULL_PTR orig);
8819 void LockedNetworkGraph_free(struct LDKLockedNetworkGraph this_ptr);
8821 void NetGraphMsgHandler_free(struct LDKNetGraphMsgHandler this_ptr);
8824 * Creates a new tracker of the actual state of the network of channels and nodes,
8825 * assuming a fresh network graph.
8826 * Chain monitor is used to make sure announced channels exist on-chain,
8827 * channel data is correct, and that the announcement is signed with
8828 * channel owners' keys.
8830 MUST_USE_RES struct LDKNetGraphMsgHandler NetGraphMsgHandler_new(struct LDKThirtyTwoBytes genesis_hash, struct LDKAccess *chain_access, struct LDKLogger logger);
8833 * Creates a new tracker of the actual state of the network of channels and nodes,
8834 * assuming an existing Network Graph.
8836 MUST_USE_RES struct LDKNetGraphMsgHandler NetGraphMsgHandler_from_net_graph(struct LDKAccess *chain_access, struct LDKLogger logger, struct LDKNetworkGraph network_graph);
8839 * Take a read lock on the network_graph and return it in the C-bindings
8840 * newtype helper. This is likely only useful when called via the C
8841 * bindings as you can call `self.network_graph.read().unwrap()` in Rust
8844 MUST_USE_RES struct LDKLockedNetworkGraph NetGraphMsgHandler_read_locked_graph(const struct LDKNetGraphMsgHandler *NONNULL_PTR this_arg);
8847 * Get a reference to the NetworkGraph which this read-lock contains.
8849 MUST_USE_RES struct LDKNetworkGraph LockedNetworkGraph_graph(const struct LDKLockedNetworkGraph *NONNULL_PTR this_arg);
8851 struct LDKRoutingMessageHandler NetGraphMsgHandler_as_RoutingMessageHandler(const struct LDKNetGraphMsgHandler *NONNULL_PTR this_arg);
8853 struct LDKMessageSendEventsProvider NetGraphMsgHandler_as_MessageSendEventsProvider(const struct LDKNetGraphMsgHandler *NONNULL_PTR this_arg);
8855 void DirectionalChannelInfo_free(struct LDKDirectionalChannelInfo this_ptr);
8858 * When the last update to the channel direction was issued.
8859 * Value is opaque, as set in the announcement.
8861 uint32_t DirectionalChannelInfo_get_last_update(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
8864 * When the last update to the channel direction was issued.
8865 * Value is opaque, as set in the announcement.
8867 void DirectionalChannelInfo_set_last_update(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, uint32_t val);
8870 * Whether the channel can be currently used for payments (in this one direction).
8872 bool DirectionalChannelInfo_get_enabled(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
8875 * Whether the channel can be currently used for payments (in this one direction).
8877 void DirectionalChannelInfo_set_enabled(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, bool val);
8880 * The difference in CLTV values that you must have when routing through this channel.
8882 uint16_t DirectionalChannelInfo_get_cltv_expiry_delta(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
8885 * The difference in CLTV values that you must have when routing through this channel.
8887 void DirectionalChannelInfo_set_cltv_expiry_delta(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, uint16_t val);
8890 * The minimum value, which must be relayed to the next hop via the channel
8892 uint64_t DirectionalChannelInfo_get_htlc_minimum_msat(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
8895 * The minimum value, which must be relayed to the next hop via the channel
8897 void DirectionalChannelInfo_set_htlc_minimum_msat(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, uint64_t val);
8900 * Fees charged when the channel is used for routing
8902 struct LDKRoutingFees DirectionalChannelInfo_get_fees(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
8905 * Fees charged when the channel is used for routing
8907 void DirectionalChannelInfo_set_fees(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, struct LDKRoutingFees val);
8910 * Most recent update for the channel received from the network
8911 * Mostly redundant with the data we store in fields explicitly.
8912 * Everything else is useful only for sending out for initial routing sync.
8913 * Not stored if contains excess data to prevent DoS.
8915 struct LDKChannelUpdate DirectionalChannelInfo_get_last_update_message(const struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr);
8918 * Most recent update for the channel received from the network
8919 * Mostly redundant with the data we store in fields explicitly.
8920 * Everything else is useful only for sending out for initial routing sync.
8921 * Not stored if contains excess data to prevent DoS.
8923 void DirectionalChannelInfo_set_last_update_message(struct LDKDirectionalChannelInfo *NONNULL_PTR this_ptr, struct LDKChannelUpdate val);
8925 struct LDKDirectionalChannelInfo DirectionalChannelInfo_clone(const struct LDKDirectionalChannelInfo *NONNULL_PTR orig);
8927 struct LDKCVec_u8Z DirectionalChannelInfo_write(const struct LDKDirectionalChannelInfo *NONNULL_PTR obj);
8929 struct LDKCResult_DirectionalChannelInfoDecodeErrorZ DirectionalChannelInfo_read(struct LDKu8slice ser);
8931 void ChannelInfo_free(struct LDKChannelInfo this_ptr);
8934 * Protocol features of a channel communicated during its announcement
8936 struct LDKChannelFeatures ChannelInfo_get_features(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
8939 * Protocol features of a channel communicated during its announcement
8941 void ChannelInfo_set_features(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKChannelFeatures val);
8944 * Source node of the first direction of a channel
8946 struct LDKPublicKey ChannelInfo_get_node_one(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
8949 * Source node of the first direction of a channel
8951 void ChannelInfo_set_node_one(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8954 * Details about the first direction of a channel
8956 struct LDKDirectionalChannelInfo ChannelInfo_get_one_to_two(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
8959 * Details about the first direction of a channel
8961 void ChannelInfo_set_one_to_two(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKDirectionalChannelInfo val);
8964 * Source node of the second direction of a channel
8966 struct LDKPublicKey ChannelInfo_get_node_two(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
8969 * Source node of the second direction of a channel
8971 void ChannelInfo_set_node_two(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKPublicKey val);
8974 * Details about the second direction of a channel
8976 struct LDKDirectionalChannelInfo ChannelInfo_get_two_to_one(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
8979 * Details about the second direction of a channel
8981 void ChannelInfo_set_two_to_one(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKDirectionalChannelInfo val);
8984 * An initial announcement of the channel
8985 * Mostly redundant with the data we store in fields explicitly.
8986 * Everything else is useful only for sending out for initial routing sync.
8987 * Not stored if contains excess data to prevent DoS.
8989 struct LDKChannelAnnouncement ChannelInfo_get_announcement_message(const struct LDKChannelInfo *NONNULL_PTR this_ptr);
8992 * An initial announcement of the channel
8993 * Mostly redundant with the data we store in fields explicitly.
8994 * Everything else is useful only for sending out for initial routing sync.
8995 * Not stored if contains excess data to prevent DoS.
8997 void ChannelInfo_set_announcement_message(struct LDKChannelInfo *NONNULL_PTR this_ptr, struct LDKChannelAnnouncement val);
8999 struct LDKChannelInfo ChannelInfo_clone(const struct LDKChannelInfo *NONNULL_PTR orig);
9001 struct LDKCVec_u8Z ChannelInfo_write(const struct LDKChannelInfo *NONNULL_PTR obj);
9003 struct LDKCResult_ChannelInfoDecodeErrorZ ChannelInfo_read(struct LDKu8slice ser);
9005 void RoutingFees_free(struct LDKRoutingFees this_ptr);
9008 * Flat routing fee in satoshis
9010 uint32_t RoutingFees_get_base_msat(const struct LDKRoutingFees *NONNULL_PTR this_ptr);
9013 * Flat routing fee in satoshis
9015 void RoutingFees_set_base_msat(struct LDKRoutingFees *NONNULL_PTR this_ptr, uint32_t val);
9018 * Liquidity-based routing fee in millionths of a routed amount.
9019 * In other words, 10000 is 1%.
9021 uint32_t RoutingFees_get_proportional_millionths(const struct LDKRoutingFees *NONNULL_PTR this_ptr);
9024 * Liquidity-based routing fee in millionths of a routed amount.
9025 * In other words, 10000 is 1%.
9027 void RoutingFees_set_proportional_millionths(struct LDKRoutingFees *NONNULL_PTR this_ptr, uint32_t val);
9029 MUST_USE_RES struct LDKRoutingFees RoutingFees_new(uint32_t base_msat_arg, uint32_t proportional_millionths_arg);
9031 struct LDKRoutingFees RoutingFees_clone(const struct LDKRoutingFees *NONNULL_PTR orig);
9033 struct LDKCResult_RoutingFeesDecodeErrorZ RoutingFees_read(struct LDKu8slice ser);
9035 struct LDKCVec_u8Z RoutingFees_write(const struct LDKRoutingFees *NONNULL_PTR obj);
9037 void NodeAnnouncementInfo_free(struct LDKNodeAnnouncementInfo this_ptr);
9040 * Protocol features the node announced support for
9042 struct LDKNodeFeatures NodeAnnouncementInfo_get_features(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr);
9045 * Protocol features the node announced support for
9047 void NodeAnnouncementInfo_set_features(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKNodeFeatures val);
9050 * When the last known update to the node state was issued.
9051 * Value is opaque, as set in the announcement.
9053 uint32_t NodeAnnouncementInfo_get_last_update(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr);
9056 * When the last known update to the node state was issued.
9057 * Value is opaque, as set in the announcement.
9059 void NodeAnnouncementInfo_set_last_update(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, uint32_t val);
9062 * Color assigned to the node
9064 const uint8_t (*NodeAnnouncementInfo_get_rgb(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr))[3];
9067 * Color assigned to the node
9069 void NodeAnnouncementInfo_set_rgb(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKThreeBytes val);
9072 * Moniker assigned to the node.
9073 * May be invalid or malicious (eg control chars),
9074 * should not be exposed to the user.
9076 const uint8_t (*NodeAnnouncementInfo_get_alias(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr))[32];
9079 * Moniker assigned to the node.
9080 * May be invalid or malicious (eg control chars),
9081 * should not be exposed to the user.
9083 void NodeAnnouncementInfo_set_alias(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKThirtyTwoBytes val);
9086 * Internet-level addresses via which one can connect to the node
9088 void NodeAnnouncementInfo_set_addresses(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKCVec_NetAddressZ val);
9091 * An initial announcement of the node
9092 * Mostly redundant with the data we store in fields explicitly.
9093 * Everything else is useful only for sending out for initial routing sync.
9094 * Not stored if contains excess data to prevent DoS.
9096 struct LDKNodeAnnouncement NodeAnnouncementInfo_get_announcement_message(const struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr);
9099 * An initial announcement of the node
9100 * Mostly redundant with the data we store in fields explicitly.
9101 * Everything else is useful only for sending out for initial routing sync.
9102 * Not stored if contains excess data to prevent DoS.
9104 void NodeAnnouncementInfo_set_announcement_message(struct LDKNodeAnnouncementInfo *NONNULL_PTR this_ptr, struct LDKNodeAnnouncement val);
9106 MUST_USE_RES struct LDKNodeAnnouncementInfo NodeAnnouncementInfo_new(struct LDKNodeFeatures features_arg, uint32_t last_update_arg, struct LDKThreeBytes rgb_arg, struct LDKThirtyTwoBytes alias_arg, struct LDKCVec_NetAddressZ addresses_arg, struct LDKNodeAnnouncement announcement_message_arg);
9108 struct LDKNodeAnnouncementInfo NodeAnnouncementInfo_clone(const struct LDKNodeAnnouncementInfo *NONNULL_PTR orig);
9110 struct LDKCVec_u8Z NodeAnnouncementInfo_write(const struct LDKNodeAnnouncementInfo *NONNULL_PTR obj);
9112 struct LDKCResult_NodeAnnouncementInfoDecodeErrorZ NodeAnnouncementInfo_read(struct LDKu8slice ser);
9114 void NodeInfo_free(struct LDKNodeInfo this_ptr);
9117 * All valid channels a node has announced
9119 void NodeInfo_set_channels(struct LDKNodeInfo *NONNULL_PTR this_ptr, struct LDKCVec_u64Z val);
9122 * Lowest fees enabling routing via any of the enabled, known channels to a node.
9123 * The two fields (flat and proportional fee) are independent,
9124 * meaning they don't have to refer to the same channel.
9126 struct LDKRoutingFees NodeInfo_get_lowest_inbound_channel_fees(const struct LDKNodeInfo *NONNULL_PTR this_ptr);
9129 * Lowest fees enabling routing via any of the enabled, known channels to a node.
9130 * The two fields (flat and proportional fee) are independent,
9131 * meaning they don't have to refer to the same channel.
9133 void NodeInfo_set_lowest_inbound_channel_fees(struct LDKNodeInfo *NONNULL_PTR this_ptr, struct LDKRoutingFees val);
9136 * More information about a node from node_announcement.
9137 * Optional because we store a Node entry after learning about it from
9138 * a channel announcement, but before receiving a node announcement.
9140 struct LDKNodeAnnouncementInfo NodeInfo_get_announcement_info(const struct LDKNodeInfo *NONNULL_PTR this_ptr);
9143 * More information about a node from node_announcement.
9144 * Optional because we store a Node entry after learning about it from
9145 * a channel announcement, but before receiving a node announcement.
9147 void NodeInfo_set_announcement_info(struct LDKNodeInfo *NONNULL_PTR this_ptr, struct LDKNodeAnnouncementInfo val);
9149 MUST_USE_RES struct LDKNodeInfo NodeInfo_new(struct LDKCVec_u64Z channels_arg, struct LDKRoutingFees lowest_inbound_channel_fees_arg, struct LDKNodeAnnouncementInfo announcement_info_arg);
9151 struct LDKNodeInfo NodeInfo_clone(const struct LDKNodeInfo *NONNULL_PTR orig);
9153 struct LDKCVec_u8Z NodeInfo_write(const struct LDKNodeInfo *NONNULL_PTR obj);
9155 struct LDKCResult_NodeInfoDecodeErrorZ NodeInfo_read(struct LDKu8slice ser);
9157 struct LDKCVec_u8Z NetworkGraph_write(const struct LDKNetworkGraph *NONNULL_PTR obj);
9159 struct LDKCResult_NetworkGraphDecodeErrorZ NetworkGraph_read(struct LDKu8slice ser);
9162 * Creates a new, empty, network graph.
9164 MUST_USE_RES struct LDKNetworkGraph NetworkGraph_new(struct LDKThirtyTwoBytes genesis_hash);
9167 * For an already known node (from channel announcements), update its stored properties from a
9168 * given node announcement.
9170 * You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
9171 * RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
9172 * routing messages from a source using a protocol other than the lightning P2P protocol.
9174 MUST_USE_RES struct LDKCResult_NoneLightningErrorZ NetworkGraph_update_node_from_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKNodeAnnouncement *NONNULL_PTR msg);
9177 * For an already known node (from channel announcements), update its stored properties from a
9178 * given node announcement without verifying the associated signatures. Because we aren't
9179 * given the associated signatures here we cannot relay the node announcement to any of our
9182 MUST_USE_RES struct LDKCResult_NoneLightningErrorZ NetworkGraph_update_node_from_unsigned_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKUnsignedNodeAnnouncement *NONNULL_PTR msg);
9185 * Store or update channel info from a channel announcement.
9187 * You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
9188 * RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
9189 * routing messages from a source using a protocol other than the lightning P2P protocol.
9191 * If a `chain::Access` object is provided via `chain_access`, it will be called to verify
9192 * the corresponding UTXO exists on chain and is correctly-formatted.
9194 MUST_USE_RES struct LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel_from_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKChannelAnnouncement *NONNULL_PTR msg, struct LDKAccess *chain_access);
9197 * Store or update channel info from a channel announcement without verifying the associated
9198 * signatures. Because we aren't given the associated signatures here we cannot relay the
9199 * channel announcement to any of our peers.
9201 * If a `chain::Access` object is provided via `chain_access`, it will be called to verify
9202 * the corresponding UTXO exists on chain and is correctly-formatted.
9204 MUST_USE_RES struct LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel_from_unsigned_announcement(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKUnsignedChannelAnnouncement *NONNULL_PTR msg, struct LDKAccess *chain_access);
9207 * Close a channel if a corresponding HTLC fail was sent.
9208 * If permanent, removes a channel from the local storage.
9209 * May cause the removal of nodes too, if this was their last channel.
9210 * If not permanent, makes channels unavailable for routing.
9212 void NetworkGraph_close_channel_from_update(struct LDKNetworkGraph *NONNULL_PTR this_arg, uint64_t short_channel_id, bool is_permanent);
9215 * For an already known (from announcement) channel, update info about one of the directions
9218 * You probably don't want to call this directly, instead relying on a NetGraphMsgHandler's
9219 * RoutingMessageHandler implementation to call it indirectly. This may be useful to accept
9220 * routing messages from a source using a protocol other than the lightning P2P protocol.
9222 MUST_USE_RES struct LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKChannelUpdate *NONNULL_PTR msg);
9225 * For an already known (from announcement) channel, update info about one of the directions
9226 * of the channel without verifying the associated signatures. Because we aren't given the
9227 * associated signatures here we cannot relay the channel update to any of our peers.
9229 MUST_USE_RES struct LDKCResult_NoneLightningErrorZ NetworkGraph_update_channel_unsigned(struct LDKNetworkGraph *NONNULL_PTR this_arg, const struct LDKUnsignedChannelUpdate *NONNULL_PTR msg);
9231 /* Text to put at the end of the generated file */