Struct NtxBuilderConfig 

pub struct NtxBuilderConfig {

    pub store_url: Url,
    pub block_producer_url: Url,
    pub validator_url: Url,
    pub tx_prover_url: Option<Url>,
    pub script_cache_size: NonZeroUsize,
    pub max_concurrent_txs: usize,
    pub max_notes_per_tx: NonZeroUsize,
    pub max_note_attempts: usize,
    pub max_block_count: usize,
    pub account_channel_capacity: usize,
    pub idle_timeout: Duration,
    pub max_account_crashes: usize,
    pub max_cycles: u32,
    pub database_filepath: PathBuf,
}

Configuration for the Network Transaction Builder.

This struct contains all the settings needed to create and run a NetworkTransactionBuilder.

Fields

store_url: Url

Address of the store gRPC server (ntx-builder API).

block_producer_url: Url

Address of the block producer gRPC server.

validator_url: Url

Address of the validator gRPC server.

tx_prover_url: Option<Url>

Address of the remote transaction prover. If None, transactions will be proven locally.

script_cache_size: NonZeroUsize

Size of the LRU cache for note scripts. Scripts are fetched from the store and cached to avoid repeated gRPC calls.

max_concurrent_txs: usize

Maximum number of network transactions which should be in progress concurrently across all account actors.

max_notes_per_tx: NonZeroUsize

Maximum number of network notes a single transaction is allowed to consume.

max_note_attempts: usize

Maximum number of attempts to execute a failing note before dropping it. Notes use exponential backoff between attempts.

max_block_count: usize

Maximum number of blocks to keep in the chain MMR. Older blocks are pruned.

account_channel_capacity: usize

Channel capacity for loading accounts from the store during startup.

idle_timeout: Duration

Duration after which an idle network account will deactivate.

An account is considered idle once it has no viable notes to consume. A deactivated account will reactivate if targeted with new notes.

max_account_crashes: usize

Maximum number of crashes before an account deactivated.

Once this limit is reached, no new transactions will be created for this account.

max_cycles: u32

Maximum number of VM execution cycles allowed for a single network transaction.

Network transactions that exceed this limit will fail with an execution error. Defaults to 2^18 cycles.

database_filepath: PathBuf

Path to the SQLite database file used for persistent state.

Implementations

impl NtxBuilderConfig

pub fn new( store_url: Url, block_producer_url: Url, validator_url: Url, database_filepath: PathBuf, ) -> Self

pub fn with_tx_prover_url(self, url: Option<Url>) -> Self

Sets the remote transaction prover URL.

If not set, transactions will be proven locally.

pub fn with_script_cache_size(self, size: NonZeroUsize) -> Self

Sets the script cache size.

pub fn with_max_concurrent_txs(self, max: usize) -> Self

Sets the maximum number of concurrent transactions.

pub fn with_max_notes_per_tx(self, max: NonZeroUsize) -> Self

Sets the maximum number of notes per transaction.

Panics

Panics if max exceeds miden_tx::MAX_NUM_CHECKER_NOTES.

pub fn with_max_note_attempts(self, max: usize) -> Self

Sets the maximum number of note execution attempts.

pub fn with_max_block_count(self, max: usize) -> Self

Sets the maximum number of blocks to keep in the chain MMR.

pub fn with_account_channel_capacity(self, capacity: usize) -> Self

Sets the account channel capacity for startup loading.

pub fn with_idle_timeout(self, timeout: Duration) -> Self

Sets the idle timeout for actors.

Actors that remain idle (no viable notes) for this duration will be deactivated.

pub fn with_max_account_crashes(self, max: usize) -> Self

Sets the maximum number of crashes before an account actor is deactivated.

pub fn with_max_cycles(self, max: u32) -> Self

Sets the maximum number of VM execution cycles for network transactions.

pub async fn build(self) -> Result<NetworkTransactionBuilder>

Builds and initializes the network transaction builder.

This method connects to the store and block producer services, fetches the current chain tip, and subscribes to mempool events.

Errors

Returns an error if:

• The store connection fails
• The mempool subscription fails (after retries)
• The store contains no blocks (not bootstrapped)

Trait Implementations

impl Clone for NtxBuilderConfig

fn clone(&self) -> NtxBuilderConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NtxBuilderConfig

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

Formats the value using the given formatter.