starknet-replay is a CLI application to replay Starknet transactions. The
state of the blockchain is queried using the Starknet RPC protocol. It also
reports the frequency with which each libfunc has been called when replaying
the transactions.
It's possible to export the histogram of the most frequently used libfuncs by number of calls. The data plotted in the histogram is filtered to only include the libfuncs that amount to 80% of the total calls in the replay. This helps readability and visual analysis.
Only INVOKE transactions of Sierra contracts are used for this report because
only Sierra contracts use libfuncs and only INVOKE transactions execute Sierra
code. Rejected transactions are included because they are still useful to
indicate which libfunc users need.
Gathering this data allows actions to be taken based on libfunc usage, examples of which include designating certain functions for extra scrutiny based on their popularity and allowing deprecation of less-used libfuncs. This information allows allows analysis of how libfunc usage changes over time, and how new functions are adopted by the community.
cargo run --release -- --rpc-url <STARKNET_JSONRPC_ENDPOINT> --start-block <BLOCK_NUM> --end-block <BLOCK_NUM>STARKNET_JSONRPC_ENDPOINT is the url of the RPC enpoint.
This tool makes use of tracing library for log purposes. For this reason set
RUST_LOG at least at info level to see the raw output of libfunc statistics.
cargo run --release -- --rpc-url https://starknet-mainnet.public.blastapi.io/rpc/v0_7 --start-block 632917 --end-block 632917 --svg-out "histogram.svg"The command above replays all transactions of block
632917 and saves the libfunc
histogram in the file named "histogram.svg".
This crate is compatible with Rust 1.78. Both x86 and ARM are supported.
blockifier dependency is not compatible with Rust 1.81+. pathfinder_simp
dependency is not compatible with Rust 1.83+ on ARM.