Skip to main content

quai_browser/
transaction_wait.rs

1//! Window/worker waits for indexed transactions without requiring a receipt.
2use crate::receipt_wait::{WaitObservation, WaitPoll, wait_for_observation};
3use crate::{BrowserReceiptWaitError, BrowserWaitConfig};
4use quai_primitives::{Hash32, Zone};
5use quai_provider::{ConfirmedTransaction, Provider, ProviderError, TransactionConfirmation};
6use quai_rpc::Transport;
7/// Shared deadline, completed-observation and provider-error information.
8pub type BrowserTransactionWaitError = BrowserReceiptWaitError;
9struct TransactionPoll<'a, T> {
10    provider: &'a Provider<T>,
11    zone: Zone,
12    hash: Hash32,
13    confirmations: u64,
14}
15impl<T: Transport> WaitPoll for TransactionPoll<'_, T> {
16    type Output = ConfirmedTransaction;
17    async fn poll(&mut self) -> Result<WaitObservation<Self::Output>, ProviderError> {
18        Ok(
19            match self
20                .provider
21                .observe_transaction_confirmation(self.zone, self.hash, self.confirmations)
22                .await?
23            {
24                TransactionConfirmation::Confirmed(tx) => WaitObservation::Ready(*tx),
25                TransactionConfirmation::Pending {
26                    last_observed_inclusion,
27                } => WaitObservation::Pending {
28                    inclusion: last_observed_inclusion,
29                    immediate: false,
30                },
31            },
32        )
33    }
34}
35/// Wait for rechecked transaction inclusion, including Qi without receipts.
36/// Explicit monotonic deadline covers stalled RPCs; max_polls bounds completed
37/// observations. Browser suspension can delay delivery but not permit success
38/// after observed expiry. Drop clears timers and active reads. No submission,
39/// signature verification, replacement adoption or release of custody claims.
40pub async fn wait_for_transaction<T: Transport>(
41    provider: &Provider<T>,
42    zone: Zone,
43    transaction_hash: Hash32,
44    config: BrowserWaitConfig,
45) -> Result<ConfirmedTransaction, BrowserTransactionWaitError> {
46    if transaction_hash == Hash32::ZERO {
47        return Err(BrowserTransactionWaitError::InvalidConfig);
48    }
49    wait_for_observation(
50        transaction_hash,
51        config,
52        TransactionPoll {
53            provider,
54            zone,
55            hash: transaction_hash,
56            confirmations: config.confirmations,
57        },
58    )
59    .await
60}