[!NOTE]

• This branch contains the upgraded version (v1.x.x) of this tool, with a custom program to support write locks.
• The first version of this tool (v0.x.x) that works with the SPL memo program is in the master branch.

[!IMPORTANT] This is an experimental feature, the custom program in this branch is deployed ONLY to the devnet at memos5eKsok4hXwxufkppaTBrfWRjFMhqxgomv5trJ6

I do NOT plan to deploy it to the mainnet due to monetary cost, Anyone interested in deploying it themselves is welcome to do so and submit a pull request with the deployement address.

memobench

Solana RPC benchmarking tool

This is a simple CLI tool that allows you to send transactions to an RPC endpoint and measure their success rate and confirmation time. The goal of this tool is to test the success rate of transactions landing on chain with any specified Solana RPC endpoint.

[!NOTE] Make sure you have enough SOL in your test account to cover the transaction fees.

[!CAUTION] This tool works by sending transactions to the blockchain, if configured with a high transaction count and/or high priority fees, it can lead to draining your test accounts. USE WITH CAUTION!

Usage

• Download the latest release for your OS and architecture from the releases page.
• Execute the binary in a command prompt or terminal.
  • Upon first execution it will create a sample config.json file and exit
  • Edit the config.json file as needed
• Execute the binary again to start the benchmark

Configuration

• private_key: The private key of the test account (in base58 format)
• rpc_url: The RPC endpoint to benchmark
• ws_url: The WS endpoint to listen for transactions (optional, if omitted, the RPC URL will be used)
• send_rpc_url: The RPC endpoint to send transactions (optional, if omitted, the RPC URL will be used)
• rate_limit: The rate limit (in requests per second)
• tx_count: The number of transactions to send
• prio_fee: The priority fee in Lamports per Compute Unit (optional, if omitted, no priority fee will be used)
• bench_type: The type of the test to perform, memo for the regular memo benchmark, lock for a custom benchmark with write lock
• node_retries: The number of retries the RPC will rebroadcast the transaction

[!IMPORTANT] The priority fee is in lamports not microlamports

How does it work?

This tool works by sending a predefined number (tx_count) of unique transactions to the specified RPC (send_rpc_url or rpc_url). And count how many of them made it to the blockchain.

The transactions are sent all at once in parallel if possible, the tool will make sure to stay under the defined rate_limit to avoid getting 429 errors from the RPC.

For the memo bench, the transactions sent are simple transactions that each contain a unique memo in the form of memobench(Memo): test=<test_id> round=<tx_number>. The round part is used to ensure the memo is unique and by extension the transaction is unique, the test part is used to differentiate between individual tests.

For the lock bench, the transactions sent increment a global counter, this a write lock on that account until the transaction is done, also contain a unique memo in the form of memobench(Lock): test=<test_id> round=<tx_number> n=<counter>.

You like this tool ?

Buy me a coffee :coffee: CoffeeFpEteoCSPgHeoj98Sb6LCzoG36PGdRbYwqSvLd

or hire me ;)