Struct TxSenderClient

pub struct TxSenderClient {
    pub db: TxSenderDb,
}

Fields

db: TxSenderDb

Implementations

impl TxSenderClient

pub fn new(db: TxSenderDb) -> Self

pub async fn insert_try_to_send( &self, dbtx: &mut TxSenderTransaction, tx_metadata: Option<TxMetadata>, signed_tx: &Transaction, fee_paying_type: FeePayingType, rbf_signing_info: Option<RbfSigningInfo>, cancel_outpoints: &[OutPoint], cancel_txids: &[Txid], activate_txids: &[ActivatedWithTxid], activate_outpoints: &[ActivatedWithOutpoint], ) -> Result<u32, BridgeError>

Saves a transaction to the database queue for sending/fee bumping.

This function determines the initial parameters for a transaction send attempt, including its [FeePayingType], associated metadata, and dependencies (cancellations/activations). It then persists this information in the database via [Database::save_tx] and related functions. The actual sending logic (CPFP/RBF) is handled later by the transaction sender’s task loop.

Default Activation and Cancellation Conditions

By default, this function automatically adds cancellation conditions for all outpoints spent by the signed_tx itself. If signed_tx confirms, these input outpoints are marked as spent/cancelled in the database.

There are no default activation conditions added implicitly; all activation prerequisites must be explicitly provided via the activate_txids and activate_outpoints arguments.

Arguments

• dbtx - An active database transaction.
• tx_metadata - Optional metadata about the transaction’s purpose.
• signed_tx - The transaction to be potentially sent.
• fee_paying_type - Whether to use CPFP or RBF for fee management.
• cancel_outpoints - Outpoints that should be marked invalid if this tx confirms (in addition to the tx’s own inputs).
• cancel_txids - Txids that should be marked invalid if this tx confirms.
• activate_txids - Txids that are prerequisites for this tx, potentially with a relative timelock.
• activate_outpoints - Outpoints that are prerequisites for this tx, potentially with a relative timelock.

Returns

• u32: The database ID (try_to_send_id) assigned to this send attempt.

pub async fn send_citrea_tx( &self, request: CitreaTxRequest, ) -> Result<i64, Report>

Trait Implementations

impl Clone for TxSenderClient

fn clone(&self) -> TxSenderClient

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TxSenderClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.