ledger/com.midnight.kuira.core.ledger.api/TransactionSubmitter

TransactionSubmitter

class TransactionSubmitter(nodeRpcClient: NodeRpcClient, proofServerClient: ProofServerClient, indexerClient: IndexerClient, serializer: TransactionSerializer, utxoManager: UtxoManager, dustActionsBuilder: DustActionsBuilder? = null, dustRepository: DustRepository? = null, provingKeyManager: <Error class: unknown class>? = null, var provingMode: <Error class: unknown class> = ProvingMode.DEFAULT, networkClientProvider: TransactionSubmitter.NetworkClientProvider? = null)

Orchestrates transaction submission and confirmation for Midnight blockchain.

Process (WebSocket-based - the correct way):

Serialize signed transaction (SCALE codec)
Prove transaction via proof server
Seal proven transaction
Submit via WebSocket and wait for finalization from NODE
Mark UTXOs as SPENT only after node confirms finalization
Return result

Why WebSocket instead of Indexer:

Indexer can lag behind the node (causes race conditions)
WebSocket gives us real-time confirmation directly from the node
This matches the Midnight SDK's implementation exactly

Dust Fee Payment: Use submitWithFees() to automatically build and pay dust fees.

Constructors

TransactionSubmitter

constructor(nodeRpcClient: NodeRpcClient, proofServerClient: ProofServerClient, indexerClient: IndexerClient, serializer: TransactionSerializer, utxoManager: UtxoManager, dustActionsBuilder: DustActionsBuilder? = null, dustRepository: DustRepository? = null, provingKeyManager: <Error class: unknown class>? = null, provingMode: <Error class: unknown class> = ProvingMode.DEFAULT, networkClientProvider: TransactionSubmitter.NetworkClientProvider? = null)

Types

Companion

object Companion

NetworkClientProvider

fun interface NetworkClientProvider

Functional interface for resolving network-aware clients. Injected by the Hilt module; creates fresh clients for the currently-selected network.

ResolvedClients

data class ResolvedClients(val networkId: String, val node: NodeRpcClient, val proofServer: ProofServerClient, val indexer: IndexerClient)

Clients bound to a specific network, identified by networkId. The networkId is used for cache-invalidation: when the user switches networks in Settings, the next resolveClients call detects the name change and creates fresh HTTP clients.

SubmissionResult

sealed class SubmissionResult

Result of transaction submission.

Properties

lastProvingMode

var lastProvingMode: <Error class: unknown class>

Which proving mode was used for the last transaction (for display).

provingMode

@Volatile

var provingMode: <Error class: unknown class>

Current proving mode — LOCAL or REMOTE. Defaults to LOCAL when keys are available.

Functions

submitAndWait

suspend fun submitAndWait(signedIntent: Intent, fromAddress: String, timeoutMs: Long = DEFAULT_TIMEOUT_MS): TransactionSubmitter.SubmissionResult

Submit a signed transaction and wait for finalization.

submitOnly

suspend fun submitOnly(signedIntent: Intent): String

Submit transaction without waiting for confirmation (fire-and-forget).

submitPrebuiltTransaction

suspend fun submitPrebuiltTransaction(unprovenTxHex: String, timeoutMs: Long = DEFAULT_TIMEOUT_MS): TransactionSubmitter.SubmissionResult

Submit a pre-built unproven transaction (e.g., from ZswapTransferBuilder).

submitWithFees

suspend fun submitWithFees(signedIntent: Intent, ledgerParamsHex: String, fromAddress: String, seed: ByteArray, timeoutMs: Long = DEFAULT_TIMEOUT_MS): TransactionSubmitter.SubmissionResult

Submit transaction WITH automatic dust fee payment.