Statebloat scenarios

README.md

@@ -7,7 +7,7 @@
 [![License](https://img.shields.io/github/license/ethpandaops/spamoor)](LICENSE)
 [![Docker](https://img.shields.io/docker/pulls/ethpandaops/spamoor)](https://hub.docker.com/r/ethpandaops/spamoor)
 
-Spamoor is a robust transaction spamming tool designed for stress testing, network validation, and continuous transaction testing on Ethereum testnets. With 14+ different transaction scenarios and a powerful web-based daemon mode, it's the ultimate tool for Ethereum network testing.
+Spamoor is a robust transaction spamming tool designed for stress testing, network validation, and continuous transaction testing on Ethereum testnets. With 14+ different transaction scenarios and a powerful web-based daemon mode, it's the ultimate tool for Ethereum network testing
 
 ## 🚀 Quick Start
 
@@ -37,10 +37,10 @@ spamoor run <yaml-file> [flags]
 ```
 
 ### 🔑 Required Parameters
-| Parameter | Description |
-|-----------|-------------|
+| Parameter   | Description                                           |
+| ----------- | ----------------------------------------------------- |
 | `--privkey` | Private key for the root wallet (funds child wallets) |
-| `--rpchost` | RPC endpoint(s) to send transactions to |
+| `--rpchost` | RPC endpoint(s) to send transactions to               |
 
 ### 🔧 Advanced Configuration
 
@@ -96,14 +96,14 @@ spamoor run <yaml-file> [flags]
 ```
 
 ### Flags
-| Flag | Short | Description |
-|------|-------|-------------|
-| `--spammers` | `-s` | Indexes of spammers to run (e.g., `-s 0,2`). If not specified, runs all |
-| `--privkey` | `-p` | Private key for the root wallet |
-| `--rpchost` | `-h` | RPC endpoints (multiple allowed) |
-| `--rpchost-file` | - | File containing RPC endpoints |
-| `--verbose` | `-v` | Enable verbose logging |
-| `--trace` | - | Enable trace logging |
+| Flag             | Short | Description                                                             |
+| ---------------- | ----- | ----------------------------------------------------------------------- |
+| `--spammers`     | `-s`  | Indexes of spammers to run (e.g., `-s 0,2`). If not specified, runs all |
+| `--privkey`      | `-p`  | Private key for the root wallet                                         |
+| `--rpchost`      | `-h`  | RPC endpoints (multiple allowed)                                        |
+| `--rpchost-file` | -     | File containing RPC endpoints                                           |
+| `--verbose`      | `-v`  | Enable verbose logging                                                  |
+| `--trace`        | -     | Enable trace logging                                                    |
 
 ### Example Configuration
 ```yaml
@@ -170,21 +170,21 @@ spamoor-daemon [flags]
 
 ### ⚙️ Configuration Flags
 
-| Flag | Short | Description | Default |
-|------|-------|-------------|---------|
-| `--db` | `-d` | Database file location | `spamoor.db` |
-| `--rpchost` | `-h` | RPC endpoints (multiple allowed) | - |
-| `--rpchost-file` | - | File containing RPC endpoints | - |
-| `--privkey` | `-p` | Root wallet private key | - |
-| `--port` | `-P` | Web UI port | `8080` |
-| `--startup-spammer` | - | YAML file or URL with startup spammers | - |
-| `--startup-delay` | - | Delay in seconds before starting spammers on startup | `30` |
-| `--fulu-activation` | - | Unix timestamp of Fulu activation | `0` |
-| `--without-batcher` | - | Disable transaction batching | `false` |
-| `--disable-tx-metrics` | - | Disable transaction metrics collection | `false` |
-| `--verbose` | `-v` | Enable verbose logging | `false` |
-| `--debug` | - | Enable debug mode | `false` |
-| `--trace` | - | Enable trace logging | `false` |
+| Flag                   | Short | Description                                          | Default      |
+| ---------------------- | ----- | ---------------------------------------------------- | ------------ |
+| `--db`                 | `-d`  | Database file location                               | `spamoor.db` |
+| `--rpchost`            | `-h`  | RPC endpoints (multiple allowed)                     | -            |
+| `--rpchost-file`       | -     | File containing RPC endpoints                        | -            |
+| `--privkey`            | `-p`  | Root wallet private key                              | -            |
+| `--port`               | `-P`  | Web UI port                                          | `8080`       |
+| `--startup-spammer`    | -     | YAML file or URL with startup spammers               | -            |
+| `--startup-delay`      | -     | Delay in seconds before starting spammers on startup | `30`         |
+| `--fulu-activation`    | -     | Unix timestamp of Fulu activation                    | `0`          |
+| `--without-batcher`    | -     | Disable transaction batching                         | `false`      |
+| `--disable-tx-metrics` | -     | Disable transaction metrics collection               | `false`      |
+| `--verbose`            | `-v`  | Enable verbose logging                               | `false`      |
+| `--debug`              | -     | Enable debug mode                                    | `false`      |
+| `--trace`              | -     | Enable trace logging                                 | `false`      |
 
 ### 🌐 Web Interface Features
 

scenarios/scenarios.go

@@ -27,6 +27,8 @@ import (
 	replayeest "github.com/ethpandaops/spamoor/scenarios/replay-eest"
 	"github.com/ethpandaops/spamoor/scenarios/setcodetx"
 	erc20bloater "github.com/ethpandaops/spamoor/scenarios/statebloat/erc20_bloater"
+	extcodesizesetup "github.com/ethpandaops/spamoor/scenarios/statebloat/extcodesize_setup"
+	storagetriebrancher "github.com/ethpandaops/spamoor/scenarios/statebloat/storage_trie_brancher"
 	"github.com/ethpandaops/spamoor/scenarios/storagerefundtx"
 	"github.com/ethpandaops/spamoor/scenarios/storagespam"
 	"github.com/ethpandaops/spamoor/scenarios/taskrunner"
@@ -79,6 +81,8 @@ var nativeScenarioCategories = []*scenario.Category{
 		Description: "Scenarios specifically designed for state bloating",
 		Descriptors: []*scenario.Descriptor{
 			&erc20bloater.ScenarioDescriptor,
+			&extcodesizesetup.ScenarioDescriptor,
+			&storagetriebrancher.ScenarioDescriptor,
 		},
 	},
 	{