,|
//| ,|
//,/ -~ |
// / | _-~ / ,
/'/ / / _-~ _/_-~ |
( ( / /' _ -~ _-~ ,/'
\~\/'/| __--~~__--\ _-~ _/,
,,)))))));, \/~-_ __--~~ --~~ __/~ _-~ /
__))))))))))))));,>/\ / __--~~ \-~~ _-~
-\(((((''''(((((((( >~\/ --~~ __--~' _-~ ~|
,----~--. --==//////=======)))))));'/~ __--~~__--~ / _-~
/////////////////\ -==//////========((((((((/ / \__~ __--~ ~ / /
//// ////////////////\\\\\, -==//////=======(((((((( / / ~-__^-~ /
//// ////////////////\\\\\\\\\ -==//////========(((((((/~ /| ) __--~
|//// ////////////////\\\\\\\\\\\\ -==//////=======((((((|~ _-| _/~~/~~~
|//// ////~~~~~~~~~~~ ~~~\\\\\\\\\\\\ -==//////=========\| -~)(_/ |
|// ////// \\\\\\\\\\\\\\\ -==//// ~~- / / \_/ \
|/// \\\\\\\\\\\\ \\ ' _~~/ _-~ -~_/ /
// \\\\\\\\\\\\\\ _ /.-^- __~ ~~ ____--~~ ~ _-~
\\\\\\\\\\\\\\\ / .-~~-* __~~ ~~~ ~~--~
\\\\\\\\\\\\\\\ ( _.-~~~ / __~-~ ~-_
\\\\\\\\\\\\\\>__ ~-__.-~~ _-~ /-~-~-_/ / ~~-~ .
~-_ /\\\\\\\\\\\\\X\ ~~ \\ ~ ~ -~~~ / ___ / _-~ /
~-_ _/^^^^^^^^\ \\\\\\\ ~~\\ \ \ ~~~~ /_-~~/ _-_-~ / ___---~.
~-__ _-~ ^^^/^^^^^ \ \\\\\\\ ~-\\ \_\ /~_-~~ / / _/~ /
~-_ _____________/_<<< XXXX. ^^ .\ _\\\\\\\ \\-\\ |_/_/ /~~ /
~-_/ (_ <<< XXXX / /'/.)-^\\\\\\\ ~-\\ |~|~| | | /
/ / (_< XXXX / ///) ^\\\\\\\ ~-\/~|~|~|_/ / / .
| | ^ XXXX//'/' ^\\\\\\\ \-|~|~| / / -~_
/ / / XXX/' ^\\\\\\\ ~-|~|~ |/ / .-~~^ ^
/ / / X/' ^\\\\\\\ \|~| / / / '
/ / /' ^^^^^^\\ |~|~/ / /
/ / ^ |~|/ / /
/ / /~| / /
/ / ~^ / /
/ / / /
/ / ~-_ / /
/ / ~-_ / /
/ / ~-_ / /
/ / ~--__ / /
/ / ~-_ _/ /
/ / ~--___ __--~ /
meteorite is a powerful tool designed to empower users to test and validate the performance and security claims of Cosmos-based blockchains. By providing an easy-to-use testing suite, meteorite enables advanced users to ensure that the blockchains they depend on are robust, secure, and capable of handling real-world conditions.
- Decentralized File Storage Testing: Utilize mainnet state to test decentralized file storage capabilities.
- Performance Testing: Simplify configuration for comprehensive performance evaluations.
- Fee Market Module Testing: Verify that gas prices increase as expected to prevent peer-to-peer (P2P) storms, ensuring network stability.
- IBC Security Testing: Assess the safety of a chain against potential threats like the "Banana King" exploit.
- CometBFT Testing: Evaluate chain resilience against P2P storms and other network stressors.
To install meteorite, run the following commands:
git clone https://github.com/somatic-labs/meteorite
cd meteorite
go install ./...Meteorite is designed with a zero-configuration approach by default. Simply run:
# Run meteorite with the interactive chain registry (zero-configuration mode)
meteoriteThis will:
- Download the Cosmos Chain Registry
- Present an interactive menu to select a chain
- Test RPC endpoints automatically
- Set up optimal configuration for testing
For advanced users who want more control, you can use a configuration file:
# Run with a specific configuration file
meteorite -config -f your_config.toml- Create a file named
seedphrasecontaining your seed phrase in the directory where you run meteorite - Optionally set up your own node with a larger mempool (e.g., 10 GB) for more thorough testing
Meteorite uses MultiSend transactions with 3000 recipients per transaction by default, which significantly improves testing efficiency.
When using MultiSend:
- Each transaction sends tokens to 3000 different addresses
- This creates more complex transaction patterns while using fewer overall transactions
- Gas is automatically adjusted for the higher requirements of MultiSend
- Responsible Use: meteorite is designed for use on mainnets. The tokens you own grant you the right to make any valid transaction. Like any user of any chain, meteorite can only make valid transactions.
- Test your favorite mainnet, yourself, and make sure that you can't get Luna'd
- Test your favorite mainnet, yourself, and make sure that you can't get Levana'd
Over $70,001,400,000 has been lost to the class of issues named p2p storms.
If you're investing, test the chain. It's free if you tweet about using meteorite.
- Valid Transactions Only: The tool operates within the bounds of valid transactions explicitly supported by the chains it tests.
- Reporting Issues: For questions about meteorite's capabilities or to report potential security issues, please contact the project maintainers through the appropriate channels listed in this repository.
meteorite was developed to enhance the testing capabilities for Cosmos-based blockchains after identifying areas where additional testing tools were needed. By simulating various scenarios, meteorite helps developers and users alike to better understand the limits and robustness of their chains.
- Banana King Exploit Testing: Initially reported in 2022, this test ensures that chains are secure against known exploits.
- P2P Storms Testing: Reported in 2021 and observed in networks like Luna Classic (2022) and Stride (2023), this test evaluates the chain's ability to handle network stress.
The release of meteorite has contributed to:
- Improved Awareness: Highlighting potential vulnerabilities and encouraging proactive improvements in network security.
- Enhanced Security Measures: Prompting fixes for issues like P2P storms after thorough testing and community engagement.
Additional information is available at faddat/fasf-report.
We welcome contributions from the community to enhance meteorite's features and capabilities. If you'd like to contribute or have feedback, please open an issue or submit a pull request on GitHub.
Meteorite now includes a built-in transaction visualizer that provides real-time insights into transaction processing and network status. The visualizer displays:
- Transaction statistics (total, successful, failed)
- Transactions per second (TPS) with a live chart
- Network node status (online, syncing, offline)
- Mempool state across discovered nodes
- Latest block height information
The visualizer is enabled by default and can be toggled with the -viz flag:
# Run with visualizer (default)
./meteorite -registry
# Run without visualizer
./meteorite -registry -viz=falseThe visualizer displays information in the terminal:
=== METEORITE TXN STATS ===
Total Txs: 1250 | Successful: 1230 | Failed: 20 | Success Rate: 98.40%
TPS: 12.50 | Avg Latency: 125ms | Latest Block: 123456
=== NETWORK NODES ===
Nodes: 25 | Online: 20 | Syncing: 3 | Offline: 2
Mempool Txs: 523 | Size: 4.2 MB
=== TPS CHART ===
▁▂▃▄▅▆▇█▇▆▅▄▃▂▁ (max: 25.0 TPS)
All visualization data is also saved to log files in the logs/ directory for later analysis.
Log files are created in the logs/ directory with timestamps in the filename format:
logs/meteorite_viz_2023-05-25_15-30-45.log