statebloat scenarios

.gitignore

@@ -8,3 +8,5 @@ bin
 spamoor.db*
 go.lib.mod
 go.lib.sum
+*.abi
+*.bin

README.md

@@ -53,6 +53,7 @@ RPC hosts support additional configuration parameters through URL prefixes:
 
 Spamoor provides multiple scenarios for different transaction types:
 
+
 | Scenario | Description |
 |----------|-------------|
 | [`eoatx`](./scenarios/eoatx/README.md) | **EOA Transactions**<br>Send standard EOA transactions with configurable amounts and targets |

scenarios/scenarios.go

@@ -16,6 +16,10 @@ import (
 	"github.com/ethpandaops/spamoor/scenarios/gasburnertx"
 	"github.com/ethpandaops/spamoor/scenarios/geastx"
 	"github.com/ethpandaops/spamoor/scenarios/setcodetx"
+	sbcontractdeploy "github.com/ethpandaops/spamoor/scenarios/statebloat/contract_deploy"
+	sbeoadelegation "github.com/ethpandaops/spamoor/scenarios/statebloat/eoa_delegation"
+	sberc20maxtransfers "github.com/ethpandaops/spamoor/scenarios/statebloat/erc20_max_transfers"
+	sbrandsstore "github.com/ethpandaops/spamoor/scenarios/statebloat/rand_sstore"
 	"github.com/ethpandaops/spamoor/scenarios/storagespam"
 	uniswapswaps "github.com/ethpandaops/spamoor/scenarios/uniswap-swaps"
 	"github.com/ethpandaops/spamoor/scenarios/wallets"
@@ -39,6 +43,10 @@ var ScenarioDescriptors = []*scenario.Descriptor{
 	&gasburnertx.ScenarioDescriptor,
 	&geastx.ScenarioDescriptor,
 	&setcodetx.ScenarioDescriptor,
+	&sbcontractdeploy.ScenarioDescriptor,
+	&sbeoadelegation.ScenarioDescriptor,
+	&sberc20maxtransfers.ScenarioDescriptor,
+	&sbrandsstore.ScenarioDescriptor,
 	&storagespam.ScenarioDescriptor,
 	&uniswapswaps.ScenarioDescriptor,
 	&wallets.ScenarioDescriptor,

scenarios/statebloat/README.md

@@ -0,0 +1,35 @@
+# State Bloat Scenarios
+
+This directory contains scenarios designed to test different vectors of state growth on Ethereum. Each scenario focuses on a specific method of increasing the state size while minimizing ETH cost.
+
+## Available Scenarios
+
+1. `contract-deploy` - Deploys 24kB contracts (EIP-170 limit)
+2. `delegate-flag` - Adds delegate flags to funded EOAs (EIP-7702)
+3. `fund-eoa` - Funds fresh EOAs with minimal ETH
+4. `empty-auth` - Creates EIP-7702 authorizations for empty addresses
+5. `storage-slots` - Fills new storage slots in contracts
+
+## Testing
+
+These scenarios can be tested using Anvil (Foundry's local Ethereum node) or any other EVM-compatible testnet. For local testing:
+
+```bash
+# Start Anvil
+anvil
+
+# Run a scenario (example)
+spamoor statebloat/contract-deploy [flags]
+```
+
+Each scenario directory contains its own README with specific configuration options and testing instructions.
+
+## Gas Efficiency Comparison
+
+| Rank | Scenario        | Gas/Byte | Max Units in 30M Gas Block |
+| ---- | --------------- | -------- | -------------------------- |
+| 1    | Contract Deploy | ~202     | 6 deployments              |
+| 2    | Delegate Flag   | ~232     | 960 tuples                 |
+| 3    | Fund EOA        | ~267     | 1000 accounts              |
+| 4    | Empty Auth      | ~289     | 767 tuples                 |
+| 5    | Storage Slots   | 625      | 1500 slots                 |

scenarios/statebloat/contract_deploy/README.md

@@ -0,0 +1,58 @@
+# 🏭 Contract Deployment State Bloat
+
+This scenario deploys contracts that are exactly 24kB in size (EIP-170 limit) to maximize state growth while minimizing gas cost.
+
+## How it Works
+
+1. Generates a contract with exactly 24,576 bytes of runtime code
+2. Deploys the contract using CREATE with a salt that makes the bytecode unique
+3. Uses batch-based deployment:
+   - Calculates how many contracts fit in one block based on gas limits
+   - Sends a batch of transactions that fit within the block gas limit
+   - Waits for a new block to be mined
+   - Repeats the process ("bombards" the RPC after each block)
+4. Each deployment adds:
+   - 24,576 bytes of runtime code
+   - Account trie node
+   - Total state growth: ~24.7kB per deployment
+
+## ⛽ Gas Cost Breakdown
+
+- 32,000 gas for CREATE
+- 20,000 gas for new account
+- 200 gas per byte for code deposit (24,576 bytes)
+- **Total: 4,967,200 gas per deployment**
+
+## Batch Strategy
+
+The scenario automatically calculates how many contracts can fit in one block:
+- Default block gas limit: 30,000,000 gas
+- Gas per contract: 4,967,200 gas
+- Contracts per batch: ~6 contracts per block
+
+This ensures optimal utilization of block space while maintaining predictable transaction inclusion patterns.
+
+## 🚀 Usage
+
+### Build
+```bash
+go build -o bin/spamoor cmd/spamoor/main.go
+```
+
+### Run
+```bash
+./bin/spamoor --privkey <PRIVATE_KEY> --rpchost http://localhost:8545 contract-deploy [flags]
+```
+
+#### Key Flags
+- `--max-transactions` - Total number of contracts to deploy (0 = infinite, default: 0)
+- `--max-wallets` - Max child wallets to use (0 = root wallet only, default: 0)
+- `--basefee` - Base fee per gas in gwei (default: 10)
+- `--tipfee` - Tip fee per gas in gwei (default: 2)
+
+#### Example with Anvil node
+```bash
+./bin/spamoor --privkey ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80 \
+  --rpchost http://localhost:8545 contract-deploy \
+  --max-transactions 0
+``` 

scenarios/statebloat/contract_deploy/contract/.gitignore

@@ -0,0 +1,3 @@
+*.output.json
+*.bin
+*.abi

scenarios/statebloat/contract_deploy/contract/README.md

@@ -0,0 +1,35 @@
+# Contract Compilation
+
+This directory contains the Solidity contract and its compiled artifacts. To compile the contract and generate Go bindings:
+
+1. Install solc (Solidity compiler):
+```bash
+# On macOS
+brew install solidity
+
+# On Ubuntu/Debian
+sudo add-apt-repository ppa:ethereum/ethereum
+sudo apt-get update
+sudo apt-get install solc
+```
+
+2. Install abigen (ABI generator):
+```bash
+go install github.com/ethereum/go-ethereum/cmd/abigen@latest
+```
+
+3. Compile the contract:
+```bash
+solc --abi StateBloatToken.sol -o . --overwrite
+solc --bin StateBloatToken.sol -o . --overwrite
+```
+
+4. Generate Go bindings:
+```bash
+abigen --bin=StateBloatToken.bin --abi=StateBloatToken.abi --pkg=contract --out=StateBloatToken.go
+```
+
+The generated files will be:
+- `StateBloatToken.abi` - Contract ABI
+- `StateBloatToken.bin` - Contract bytecode
+- `StateBloatToken.go` - Go bindings