Update auto-generated bindings

Author: TheBlueMatt

src/main/java/org/ldk/enums/AccessError.java

@@ -4,7 +4,13 @@
  * An error when accessing the chain via [`Access`].
  */
 public enum AccessError {
+	/**
+	 * The requested chain is unknown.
+	 */
 	LDKAccessError_UnknownChain,
+	/**
+	 * The requested transaction doesn't exist or hasn't confirmed.
+	 */
 	LDKAccessError_UnknownTx,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/ChannelMonitorUpdateErr.java

@@ -4,7 +4,69 @@
  * An error enum representing a failure to persist a channel monitor update.
  */
 public enum ChannelMonitorUpdateErr {
+	/**
+	 * Used to indicate a temporary failure (eg connection to a watchtower or remote backup of
+	 * our state failed, but is expected to succeed at some point in the future).
+	 * 
+	 * Such a failure will \"freeze\" a channel, preventing us from revoking old states or
+	 * submitting new commitment transactions to the counterparty. Once the update(s) that failed
+	 * have been successfully applied, a [`MonitorEvent::UpdateCompleted`] event should be returned
+	 * via [`Watch::release_pending_monitor_events`] which will then restore the channel to an
+	 * operational state.
+	 * 
+	 * Note that a given ChannelManager will *never* re-generate a given ChannelMonitorUpdate. If
+	 * you return a TemporaryFailure you must ensure that it is written to disk safely before
+	 * writing out the latest ChannelManager state.
+	 * 
+	 * Even when a channel has been \"frozen\" updates to the ChannelMonitor can continue to occur
+	 * (eg if an inbound HTLC which we forwarded was claimed upstream resulting in us attempting
+	 * to claim it on this channel) and those updates must be applied wherever they can be. At
+	 * least one such updated ChannelMonitor must be persisted otherwise PermanentFailure should
+	 * be returned to get things on-chain ASAP using only the in-memory copy. Obviously updates to
+	 * the channel which would invalidate previous ChannelMonitors are not made when a channel has
+	 * been \"frozen\".
+	 * 
+	 * Note that even if updates made after TemporaryFailure succeed you must still provide a
+	 * [`MonitorEvent::UpdateCompleted`] to ensure you have the latest monitor and re-enable
+	 * normal channel operation. Note that this is normally generated through a call to
+	 * [`ChainMonitor::channel_monitor_updated`].
+	 * 
+	 * Note that the update being processed here will not be replayed for you when you return a
+	 * [`MonitorEvent::UpdateCompleted`] event via [`Watch::release_pending_monitor_events`], so
+	 * you must store the update itself on your own local disk prior to returning a
+	 * TemporaryFailure. You may, of course, employ a journaling approach, storing only the
+	 * ChannelMonitorUpdate on disk without updating the monitor itself, replaying the journal at
+	 * reload-time.
+	 * 
+	 * For deployments where a copy of ChannelMonitors and other local state are backed up in a
+	 * remote location (with local copies persisted immediately), it is anticipated that all
+	 * updates will return TemporaryFailure until the remote copies could be updated.
+	 * 
+	 * [`ChainMonitor::channel_monitor_updated`]: chainmonitor::ChainMonitor::channel_monitor_updated
+	 */
 	LDKChannelMonitorUpdateErr_TemporaryFailure,
+	/**
+	 * Used to indicate no further channel monitor updates will be allowed (eg we've moved on to a
+	 * different watchtower and cannot update with all watchtowers that were previously informed
+	 * of this channel).
+	 * 
+	 * At reception of this error, ChannelManager will force-close the channel and return at
+	 * least a final ChannelMonitorUpdate::ChannelForceClosed which must be delivered to at
+	 * least one ChannelMonitor copy. Revocation secret MUST NOT be released and offchain channel
+	 * update must be rejected.
+	 * 
+	 * This failure may also signal a failure to update the local persisted copy of one of
+	 * the channel monitor instance.
+	 * 
+	 * Note that even when you fail a holder commitment transaction update, you must store the
+	 * update to ensure you can claim from it in case of a duplicate copy of this ChannelMonitor
+	 * broadcasts it (e.g distributed channel-monitor deployment)
+	 * 
+	 * In case of distributed watchtowers deployment, the new version must be written to disk, as
+	 * state may have been stored but rejected due to a block forcing a commitment broadcast. This
+	 * storage is used to claim outputs of rejected state confirmed onchain by another watchtower,
+	 * lagging behind on block processing.
+	 */
 	LDKChannelMonitorUpdateErr_PermanentFailure,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/ConfirmationTarget.java

@@ -5,8 +5,17 @@
  * estimation.
  */
 public enum ConfirmationTarget {
+	/**
+	 * We are happy with this transaction confirming slowly when feerate drops some.
+	 */
 	LDKConfirmationTarget_Background,
+	/**
+	 * We'd like this transaction to confirm without major delay, but 12-18 blocks is fine.
+	 */
 	LDKConfirmationTarget_Normal,
+	/**
+	 * We'd like this transaction to confirm in the next few blocks.
+	 */
 	LDKConfirmationTarget_HighPriority,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/CreationError.java

@@ -4,9 +4,21 @@
  * Errors that may occur when constructing a new `RawInvoice` or `Invoice`
  */
 public enum CreationError {
+	/**
+	 * The supplied description string was longer than 639 __bytes__ (see [`Description::new(...)`](./struct.Description.html#method.new))
+	 */
 	LDKCreationError_DescriptionTooLong,
+	/**
+	 * The specified route has too many hops and can't be encoded
+	 */
 	LDKCreationError_RouteTooLong,
+	/**
+	 * The unix timestamp of the supplied date is <0 or can't be represented as `SystemTime`
+	 */
 	LDKCreationError_TimestampOutOfBounds,
+	/**
+	 * The supplied expiry time could cause an overflow if added to a `PositiveTimestamp`
+	 */
 	LDKCreationError_ExpiryTimeOutOfBounds,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/Currency.java

@@ -4,10 +4,25 @@
  * Enum representing the crypto currencies (or networks) supported by this library
  */
 public enum Currency {
+	/**
+	 * Bitcoin mainnet
+	 */
 	LDKCurrency_Bitcoin,
+	/**
+	 * Bitcoin testnet
+	 */
 	LDKCurrency_BitcoinTestnet,
+	/**
+	 * Bitcoin regtest
+	 */
 	LDKCurrency_Regtest,
+	/**
+	 * Bitcoin simnet
+	 */
 	LDKCurrency_Simnet,
+	/**
+	 * Bitcoin signet
+	 */
 	LDKCurrency_Signet,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/Level.java

@@ -4,10 +4,25 @@
  * An enum representing the available verbosity levels of the logger.
  */
 public enum Level {
+	/**
+	 * Designates very low priority, often extremely verbose, information
+	 */
 	LDKLevel_Trace,
+	/**
+	 * Designates lower priority information
+	 */
 	LDKLevel_Debug,
+	/**
+	 * Designates useful information
+	 */
 	LDKLevel_Info,
+	/**
+	 * Designates hazardous situations
+	 */
 	LDKLevel_Warn,
+	/**
+	 * Designates very serious errors
+	 */
 	LDKLevel_Error,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/Network.java

@@ -4,9 +4,21 @@
  * An enum representing the possible Bitcoin or test networks which we can run on
  */
 public enum Network {
+	/**
+	 * The main Bitcoin blockchain.
+	 */
 	LDKNetwork_Bitcoin,
+	/**
+	 * The testnet3 blockchain.
+	 */
 	LDKNetwork_Testnet,
+	/**
+	 * A local test blockchain.
+	 */
 	LDKNetwork_Regtest,
+	/**
+	 * A blockchain on which blocks are signed instead of mined.
+	 */
 	LDKNetwork_Signet,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/Secp256k1Error.java

@@ -4,14 +4,41 @@
  * Represents an error returned from libsecp256k1 during validation of some secp256k1 data
  */
 public enum Secp256k1Error {
+	/**
+	 * Signature failed verification
+	 */
 	LDKSecp256k1Error_IncorrectSignature,
+	/**
+	 * Badly sized message ("messages" are actually fixed-sized digests; see the MESSAGE_SIZE constant)
+	 */
 	LDKSecp256k1Error_InvalidMessage,
+	/**
+	 * Bad public key
+	 */
 	LDKSecp256k1Error_InvalidPublicKey,
+	/**
+	 * Bad signature
+	 */
 	LDKSecp256k1Error_InvalidSignature,
+	/**
+	 * Bad secret key
+	 */
 	LDKSecp256k1Error_InvalidSecretKey,
+	/**
+	 * Bad recovery id
+	 */
 	LDKSecp256k1Error_InvalidRecoveryId,
+	/**
+	 * Invalid tweak for add_assign or mul_assign
+	 */
 	LDKSecp256k1Error_InvalidTweak,
+	/**
+	 * tweak_add_check failed on an xonly public key
+	 */
 	LDKSecp256k1Error_TweakCheckFailed,
+	/**
+	 * Didn't pass enough memory to context creation with preallocated memory
+	 */
 	LDKSecp256k1Error_NotEnoughMemory,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/SemanticError.java

@@ -5,15 +5,46 @@
  * requirements sections in BOLT #11
  */
 public enum SemanticError {
+	/**
+	 * The invoice is missing the mandatory payment hash
+	 */
 	LDKSemanticError_NoPaymentHash,
+	/**
+	 * The invoice has multiple payment hashes which isn't allowed
+	 */
 	LDKSemanticError_MultiplePaymentHashes,
+	/**
+	 * No description or description hash are part of the invoice
+	 */
 	LDKSemanticError_NoDescription,
+	/**
+	 * The invoice contains multiple descriptions and/or description hashes which isn't allowed
+	 */
 	LDKSemanticError_MultipleDescriptions,
+	/**
+	 * The invoice is missing the mandatory payment secret, which all modern lightning nodes
+	 * should provide.
+	 */
 	LDKSemanticError_NoPaymentSecret,
+	/**
+	 * The invoice contains multiple payment secrets
+	 */
 	LDKSemanticError_MultiplePaymentSecrets,
+	/**
+	 * The invoice's features are invalid
+	 */
 	LDKSemanticError_InvalidFeatures,
+	/**
+	 * The recovery id doesn't fit the signature/pub key
+	 */
 	LDKSemanticError_InvalidRecoveryId,
+	/**
+	 * The invoice's signature is invalid
+	 */
 	LDKSemanticError_InvalidSignature,
+	/**
+	 * The invoice's amount was not a whole number of millisatoshis
+	 */
 	LDKSemanticError_ImpreciseAmount,
 	; static native void init();
 	static { init(); }

src/main/java/org/ldk/enums/SiPrefix.java

@@ -4,9 +4,21 @@
  * SI prefixes for the human readable part
  */
 public enum SiPrefix {
+	/**
+	 * 10^-3
+	 */
 	LDKSiPrefix_Milli,
+	/**
+	 * 10^-6
+	 */
 	LDKSiPrefix_Micro,
+	/**
+	 * 10^-9
+	 */
 	LDKSiPrefix_Nano,
+	/**
+	 * 10^-12
+	 */
 	LDKSiPrefix_Pico,
 	; static native void init();
 	static { init(); }