Package org.ldk.structs
Interface Confirm.ConfirmInterface
-
- Enclosing class:
- Confirm
public static interface Confirm.ConfirmInterface
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
best_block_updated(byte[] header, int height)
Processes an update to the best header connected at the given height.byte[][]
get_relevant_txids()
Returns transactions that should be monitored for reorganization out of the chain.void
transaction_unconfirmed(byte[] txid)
Processes a transaction that is no longer confirmed as result of a chain reorganization.void
transactions_confirmed(byte[] header, TwoTuple<Long,byte[]>[] txdata, int height)
Processes transactions confirmed in a block with a given header and height.
-
-
-
Method Detail
-
transactions_confirmed
void transactions_confirmed(byte[] header, TwoTuple<Long,byte[]>[] txdata, int height)
Processes transactions confirmed in a block with a given header and height. Should be called for any transactions registered by [`Filter::register_tx`] or any transactions spending an output registered by [`Filter::register_output`]. Such transactions appearing in the same block do not need to be included in the same call; instead, multiple calls with additional transactions may be made so long as they are made in [chain order]. May be called before or after [`best_block_updated`] for the corresponding block. However, in the event of a chain reorganization, it must not be called with a `header` that is no longer in the chain as of the last call to [`best_block_updated`]. [chain order]: Confirm#Order [`best_block_updated`]: Self::best_block_updated
-
transaction_unconfirmed
void transaction_unconfirmed(byte[] txid)
Processes a transaction that is no longer confirmed as result of a chain reorganization. Should be called for any transaction returned by [`get_relevant_txids`] if it has been reorganized out of the best chain. Once called, the given transaction should not be returned by [`get_relevant_txids`] unless it has been reconfirmed via [`transactions_confirmed`]. [`get_relevant_txids`]: Self::get_relevant_txids [`transactions_confirmed`]: Self::transactions_confirmed
-
best_block_updated
void best_block_updated(byte[] header, int height)
Processes an update to the best header connected at the given height. Should be called when a new header is available but may be skipped for intermediary blocks if they become available at the same time.
-
get_relevant_txids
byte[][] get_relevant_txids()
Returns transactions that should be monitored for reorganization out of the chain. Should include any transactions passed to [`transactions_confirmed`] that have insufficient confirmations to be safe from a chain reorganization. Should not include any transactions passed to [`transaction_unconfirmed`] unless later reconfirmed. May be called to determine the subset of transactions that must still be monitored for reorganization. Will be idempotent between calls but may change as a result of calls to the other interface methods. Thus, this is useful to determine which transactions may need to be given to [`transaction_unconfirmed`]. [`transactions_confirmed`]: Self::transactions_confirmed [`transaction_unconfirmed`]: Self::transaction_unconfirmed
-
-