Struct MaxTpsArgs 

pub struct MaxTpsArgs {

    tps: u64,
    duration: u64,
    accounts: NonZeroU64,
    mnemonic: MnemonicArg,
    from_mnemonic_index: u32,
    fee_token: Address,
    target_urls: Vec<Url>,
    max_concurrent_requests: usize,
    max_concurrent_transactions: usize,
    fd_limit: Option<u64>,
    node_commit_sha: Option<String>,
    build_profile: Option<String>,
    benchmark_mode: Option<String>,
    tip20_weight: f64,
    place_order_weight: f64,
    swap_weight: f64,
    erc20_weight: f64,
    mpp_weight: f64,
    mpp_contract_address: Option<Address>,
    existing_recipients: bool,
    sample_size: usize,
    faucet: bool,
    faucet_url: Option<Url>,
    clear_txpool: bool,
    use_2d_nonces: bool,
    use_standard_nonces: bool,
}

Run maximum TPS throughput benchmarking

Fields

tps: u64

Target transactions per second

duration: u64

Test duration in seconds

accounts: NonZeroU64

Number of accounts for pre-generation

mnemonic: MnemonicArg

Mnemonic for generating accounts

from_mnemonic_index: u32

fee_token: Address

target_urls: Vec<Url>

Target URLs for network connections (comma-separated or multiple –target-urls)

max_concurrent_requests: usize

A limit of the maximum number of concurrent requests, prevents issues with too many connections open at once.

max_concurrent_transactions: usize

A number of transaction to send, before waiting for their receipts, that should be likely safe.

Large amount of transactions in a block will result in system transaction OutOfGas error.

fd_limit: Option<u64>

File descriptor limit to set

node_commit_sha: Option<String>

Node commit SHA for metadata

build_profile: Option<String>

Build profile for metadata (e.g., “release”, “debug”, “maxperf”)

benchmark_mode: Option<String>

Benchmark mode for metadata (e.g., “max_tps”, “stress_test”)

tip20_weight: f64

A weight that determines the likelihood of generating a TIP-20 transfer transaction.

place_order_weight: f64

A weight that determines the likelihood of generating a DEX place transaction.

swap_weight: f64

A weight that determines the likelihood of generating a DEX swapExactAmountIn transaction.

erc20_weight: f64

A weight that determines the likelihood of generating an ERC-20 transfer transaction.

mpp_weight: f64

A weight that determines the likelihood of generating an MPP channel open+close transaction. Requires --mpp-contract-address.

mpp_contract_address: Option<Address>

Address of a deployed TempoStreamChannel contract. Required when --mpp-weight > 0.

existing_recipients: bool

Send transfers to existing signer accounts instead of random new addresses.

When enabled, TIP-20 and ERC-20 transfers are sent to the bench’s own signer addresses (which already exist on-chain), avoiding cold SSTORE for account creation. This tests pure transfer throughput without state growth.

sample_size: usize

An amount of receipts to wait for after sending all the transactions.

faucet: bool

Fund accounts from the faucet before running the benchmark.

Calls tempo_fundAddress for each account.

faucet_url: Option<Url>

URL for the faucet service. If not provided, uses the first target URL.

clear_txpool: bool

Clear the transaction pool before running the benchmark.

Calls admin_clearTxpool.

use_2d_nonces: bool

Use 2D nonces instead of expiring nonces.

By default, tempo-bench uses expiring nonces (TIP-1009) which use a circular buffer for replay protection, avoiding state bloat. Use this flag to switch to 2D nonces which store nonce state per (address, nonce_key) pair.

use_standard_nonces: bool

Use standard sequential nonces instead of expiring nonces.

This disables both expiring nonces and 2D nonces, using traditional sequential nonce management.

Implementations

impl MaxTpsArgs

const WEIGHT_PRECISION: f64 = 1000.0

pub async fn run(self) -> Result<()>

async fn run_with_manager<F: TxFiller<TempoNetwork> + 'static>( self, signer_provider_manager: SignerProviderManager<F>, ) -> Result<()>

Trait Implementations

impl Args for MaxTpsArgs

fn group_id() -> Option<Id>

Report the [ArgGroup::id][crate::ArgGroup::id] for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate Self via [FromArgMatches::from_arg_matches_mut]

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to [Command] so it can instantiate self via [FromArgMatches::update_from_arg_matches_mut]

impl CommandFactory for MaxTpsArgs

fn command<'b>() -> Command

Build a [Command] that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a [Command] that can update self.

impl Debug for MaxTpsArgs

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

Formats the value using the given formatter.

impl FromArgMatches for MaxTpsArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from [ArgMatches], parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for MaxTpsArgs

fn parse() -> Self

Parse from std::env::args_os(), [exit][Error::exit] on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, [exit][Error::exit] on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, [exit][Error::exit] on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 368 bytes