0.1.0-alpha05

wallet-runtime/com.midnight.kuira.sdk.walletruntime/ReceivePollWorker

ReceivePollWorker

class ReceivePollWorker(appContext: Context, params: WorkerParameters) : CoroutineWorker

Doze-aware background poll for incoming UNSHIELDED NIGHT (#271). Scheduled by WalletForegroundService.attach — periodically (~15 min) and as an expedited one-shot when the app backgrounds — so a receipt is noticed even while the app is backgrounded / the device is locked, when the live observer isn't running.

Flow: read the poll target (ReceiveTargetStore) → seed-free one-shot catch-up (BackgroundReceiveChecker.newReceipts) that returns per-transaction inbound NIGHT receipts classified by UTXO-set provenance (#284 — our own change is never a receipt) → announce each one not yet seen (ReceiveCheckpointStore tx-id cursor, shared with the live observer). Skipped when the wallet UI is foreground (the live observer covers that, and there's no point summoning someone who's already here).

Shielded receipts are out of scope here — they need the seed-derived viewing key (#280).

Constructors

ReceivePollWorker

constructor(appContext: Context, params: WorkerParameters)

Types

object Companion

Properties

coroutineContext

open val ~~coroutineContext~~: CoroutineDispatcher

Functions

open suspend override fun doWork(): ListenableWorker.Result

getApplicationContext

fun getApplicationContext(): Context

getBackgroundExecutor

@RestrictTo(value = [RestrictTo.Scope.LIBRARY_GROUP])

open fun getBackgroundExecutor(): Executor

getForegroundInfo

open suspend fun getForegroundInfo(): ForegroundInfo

getForegroundInfoAsync

override fun getForegroundInfoAsync(): ListenableFuture<ForegroundInfo>

fun getId(): UUID

fun getInputData(): Data

@RequiresApi(value = 28)

fun getNetwork(): Network?

getRunAttemptCount

@IntRange(from = 0)

fun getRunAttemptCount(): Int

@RequiresApi(value = 31)

fun getStopReason(): Int

fun getTags(): MutableSet<String>

getTaskExecutor

@RestrictTo(value = [RestrictTo.Scope.LIBRARY_GROUP])

open fun getTaskExecutor(): TaskExecutor

getTriggeredContentAuthorities

@RequiresApi(value = 24)

fun getTriggeredContentAuthorities(): MutableList<String>

getTriggeredContentUris

@RequiresApi(value = 24)

fun getTriggeredContentUris(): MutableList<Uri>

getWorkerFactory

@RestrictTo(value = [RestrictTo.Scope.LIBRARY_GROUP])

open fun getWorkerFactory(): WorkerFactory

fun isStopped(): Boolean

@RestrictTo(value = [RestrictTo.Scope.LIBRARY_GROUP])

fun isUsed(): Boolean

override fun onStopped()

suspend fun setForeground(foregroundInfo: ForegroundInfo)

setForegroundAsync

fun setForegroundAsync(@NonNull foregroundInfo: ForegroundInfo): ListenableFuture

suspend fun setProgress(data: Data)

setProgressAsync

open fun setProgressAsync(@NonNull data: Data): ListenableFuture

@RestrictTo(value = [RestrictTo.Scope.LIBRARY_GROUP])

override fun startWork(): ListenableFuture<ListenableWorker.Result>

@RestrictTo(value = [RestrictTo.Scope.LIBRARY_GROUP])

fun stop(reason: Int)