blobs

package

v1.2.2 Latest Latest Go to latest Published: Jul 3, 2026 License: MIT Imports: 15 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/ethpandaops/spamoor

Links

Open Source Insights

README ¶

Blob Transactions

Send blob transactions with random data. This scenario focuses on basic blob transaction functionality without replacements or conflicts.

Usage

spamoor blobs [flags]

Configuration

Base Settings (required)

--privkey - Private key of the sending wallet
--rpchost - RPC endpoint(s) to send transactions to

Volume Control (either -c or -t required)

-c, --count - Total number of transactions to send
-t, --throughput - Transactions to send per slot
--max-pending - Maximum number of pending transactions
--throughput-increment-interval - Increment the throughput and pending limit every interval (in seconds). Useful for gradually increasing load over time.

Transaction Settings

--basefee - Max fee per gas in gwei (default: 20)
--tipfee - Max tip per gas in gwei (default: 2)
--blobfee - Max blob fee in gwei (default: 20)
--rebroadcast - Seconds to wait before rebroadcasting (default: 30)
--submit-count - Number of clients to submit transaction to (default: 3)

Blob Configuration

-b, --sidecars - Maximum number of blob sidecars per transaction (default: 3)

Wallet Management

--max-wallets - Maximum number of child wallets to use
--refill-amount - ETH amount to fund each child wallet (default: 5)
--refill-balance - Minimum ETH balance before refilling (default: 2)
--refill-interval - Seconds between balance checks (default: 300)

Client Settings

--client-group - Client group to use for sending transactions

Debug Options

-v, --verbose - Enable verbose output
--log-txs - Log all submitted transactions
--trace - Enable tracing output

Example

Send 1000 blob transactions:

spamoor blobs -p "<PRIVKEY>" -h http://rpc-host:8545 -c 1000

Send 2 blob transactions per slot with 4 sidecars each:

spamoor blobs -p "<PRIVKEY>" -h http://rpc-host:8545 -t 2 -b 4

Documentation ¶

Constants ¶

This section is empty.

Variables ¶

View Source

var ScenarioDefaultOptions = ScenarioOptions{
	TotalCount:                  0,
	Throughput:                  6,
	Sidecars:                    1,
	MaxPending:                  0,
	MaxWallets:                  0,
	Rebroadcast:                 1,
	BaseFee:                     20,
	TipFee:                      2,
	BlobFee:                     20,
	ThroughputIncrementInterval: 0,
	BlobV1Percent:               100,
	FuluActivation:              math.MaxInt64,
	Timeout:                     "",
	BlobData:                    "",
	ClientGroup:                 "",
	SubmitCount:                 3,
	LogTxs:                      false,
}

View Source

var ScenarioDescriptor = scenario.Descriptor{
	Name:           ScenarioName,
	Description:    "Send simple blob transactions",
	DefaultOptions: ScenarioDefaultOptions,
	NewScenario:    newScenario,
}

View Source

var ScenarioName = "blobs"

Functions ¶

This section is empty.

Types ¶

type Scenario ¶

type Scenario struct {
	// contains filtered or unexported fields
}

func (*Scenario) Flags ¶

func (s *Scenario) Flags(flags *pflag.FlagSet) error

func (*Scenario) Init ¶

func (s *Scenario) Init(options *scenario.Options) error

func (*Scenario) Run ¶

func (s *Scenario) Run(ctx context.Context) error

type ScenarioOptions ¶

type ScenarioOptions struct {
	TotalCount                  uint64                   `yaml:"total_count"`
	Throughput                  uint64                   `yaml:"throughput"`
	Sidecars                    uint64                   `yaml:"sidecars"`
	MaxPending                  uint64                   `yaml:"max_pending"`
	MaxWallets                  uint64                   `yaml:"max_wallets"`
	Rebroadcast                 uint64                   `yaml:"rebroadcast"`
	BaseFee                     float64                  `yaml:"base_fee"`
	TipFee                      float64                  `yaml:"tip_fee"`
	BaseFeeWei                  string                   `yaml:"base_fee_wei"`
	TipFeeWei                   string                   `yaml:"tip_fee_wei"`
	BlobFee                     float64                  `yaml:"blob_fee"`
	BlobV1Percent               uint64                   `yaml:"blob_v1_percent"`
	FuluActivation              utils.FlexibleJsonUInt64 `yaml:"fulu_activation"`
	ThroughputIncrementInterval uint64                   `yaml:"throughput_increment_interval"`
	Timeout                     string                   `yaml:"timeout"`
	BlobData                    string                   `yaml:"blob_data"`
	ClientGroup                 string                   `yaml:"client_group"`
	SubmitCount                 uint64                   `yaml:"submit_count"`
	LogTxs                      bool                     `yaml:"log_txs"`
}

Source Files ¶

View all Source files

blobs.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL