README
¶
generate_eoa_transactions Task
Description
The generate_eoa_transactions task creates and sends standard transactions from End-User Owned Accounts (EOAs) to the network, essential for testing regular transaction processing.
The task is intended for mass transaction generation.
Configuration Parameters
-
limitPerBlock:
The maximum number of transactions to generate per block. -
limitTotal:
The total limit on the number of transactions to be generated. -
limitPending:
The limit based on the number of pending transactions. -
privateKey:
The private key of the main wallet. -
childWallets:
The number of child wallets to be created and funded. (If 0, send blob transactions directly from privateKey wallet) -
walletSeed:
The seed phrase used for generating child wallets. (Will be used in combination with privateKey to generate unique child wallets that do not collide with other tasks) -
refillPendingLimit:
The maximum number of pending refill transactions allowed. This limit is used to control the refill process for child wallets, ensuring that the number of refill transactions does not exceed this threshold. -
refillFeeCap:
The maximum fee cap for refilling transactions. -
refillTipCap:
The maximum tip cap for refill transactions. -
refillAmount:
The amount to refill in each child wallet. -
refillMinBalance:
The minimum balance required before triggering a refill. -
legacyTxType:
Determines whether to use the legacy type for transactions. -
feeCap:
The maximum fee cap for transactions. -
tipCap:
The tip cap for transactions. -
gasLimit:
The gas limit for each transaction. -
targetAddress:
The target address for transactions. -
randomTarget:
If true, transactions are sent to random addresses. -
contractDeployment:
Determines whether the transactions are for contract deployment. -
callData:
Call data included in the transactions. -
randomAmount:
If true, the transaction amount is randomized. -
amount:
The amount of ETH (in wei) to be sent in each transaction. -
awaitReceipt:
Iffalse, the task succeeds immediately after sending the transactions without waiting for the receipts. Iftrue, it waits for all receipts. -
failOnReject:
Iftrue, the task fails if any transaction is rejected. -
failOnSuccess:
Iftrue, the task fails if any transaction is successful and not rejected. -
clientPattern:
A regex pattern for selecting specific client endpoints for sending the transactions. This allows targeting particular clients or groups for transaction dispatch. -
excludeClientPattern:
A regex pattern to exclude certain client endpoints from being used to send the transactions. This feature provides an additional layer of control by allowing the exclusion of specific clients, which can be useful for testing under various network scenarios.
Defaults
Default settings for the generate_eoa_transactions task:
- name: generate_eoa_transactions
config:
limitPerBlock: 0
limitTotal: 0
limitPending: 0
privateKey: ""
childWallets: 0
walletSeed: ""
refillPendingLimit: 200
refillFeeCap: "500000000000"
refillTipCap: "1000000000"
refillAmount: "1000000000000000000"
refillMinBalance: "500000000000000000"
legacyTxType: false
feeCap: "100000000000"
tipCap: "1000000000"
gasLimit: 50000
targetAddress: ""
randomTarget: false
contractDeployment: false
callData: ""
randomAmount: false
amount: "0"
awaitReceipt: false
failOnReject: false
failOnSuccess: false
clientPattern: ""
excludeClientPattern: ""
Documentation
¶
Index ¶
Constants ¶
This section is empty.
Variables ¶
var ( TaskName = "generate_eoa_transactions" TaskDescriptor = &types.TaskDescriptor{ Name: TaskName, Description: "Generates normal eoa transactions and sends them to the network", Category: "transaction", Config: DefaultConfig(), Outputs: []types.TaskOutputDefinition{}, NewTask: NewTask, } )
Functions ¶
func NewTask ¶
func NewTask(ctx *types.TaskContext, options *types.TaskOptions) (types.Task, error)
Types ¶
type Config ¶
type Config struct {
LimitPerBlock int `yaml:"limitPerBlock" json:"limitPerBlock" require:"A.1" desc:"Maximum number of transactions to generate per block."`
LimitTotal int `yaml:"limitTotal" json:"limitTotal" require:"A.2" desc:"Total limit on the number of transactions to generate."`
LimitPending int `yaml:"limitPending" json:"limitPending" require:"A.3" desc:"Maximum number of pending transactions to allow before waiting."`
PrivateKey string `yaml:"privateKey" json:"privateKey" require:"B" desc:"Private key of the wallet used to send transactions."`
ChildWallets uint64 `yaml:"childWallets" json:"childWallets" desc:"Number of child wallets to use for parallel transaction sending."`
WalletSeed string `yaml:"walletSeed" json:"walletSeed" desc:"Seed used to derive child wallet addresses deterministically."`
RefillPendingLimit uint64 `yaml:"refillPendingLimit" json:"refillPendingLimit" desc:"Maximum pending refill transactions before waiting."`
RefillFeeCap *big.Int `yaml:"refillFeeCap" json:"refillFeeCap" desc:"Maximum fee cap (in wei) for refill transactions."`
RefillTipCap *big.Int `yaml:"refillTipCap" json:"refillTipCap" desc:"Maximum priority tip (in wei) for refill transactions."`
RefillAmount *big.Int `yaml:"refillAmount" json:"refillAmount" desc:"Amount (in wei) to transfer when refilling child wallets."`
RefillMinBalance *big.Int `yaml:"refillMinBalance" json:"refillMinBalance" desc:"Minimum balance (in wei) before triggering a refill."`
LegacyTxType bool `yaml:"legacyTxType" json:"legacyTxType" desc:"If true, use legacy transaction type instead of EIP-1559."`
FeeCap *big.Int `yaml:"feeCap" json:"feeCap" desc:"Maximum fee cap (in wei) for generated transactions."`
TipCap *big.Int `yaml:"tipCap" json:"tipCap" desc:"Maximum priority tip (in wei) for generated transactions."`
GasLimit uint64 `yaml:"gasLimit" json:"gasLimit" desc:"Gas limit for generated transactions."`
TargetAddress string `yaml:"targetAddress" json:"targetAddress" desc:"Target address to send transactions to."`
RandomTarget bool `yaml:"randomTarget" json:"randomTarget" desc:"If true, send transactions to random addresses."`
ContractDeployment bool `yaml:"contractDeployment" json:"contractDeployment" desc:"If true, deploy contracts instead of simple transfers."`
CallData string `yaml:"callData" json:"callData" desc:"Hex-encoded call data to include in transactions."`
RandomAmount bool `yaml:"randomAmount" json:"randomAmount" desc:"If true, use random amounts for each transaction."`
Amount *big.Int `yaml:"amount" json:"amount" desc:"Amount (in wei) to send in each transaction."`
AwaitReceipt bool `yaml:"awaitReceipt" json:"awaitReceipt" desc:"Wait for transaction receipts before completing."`
FailOnReject bool `yaml:"failOnReject" json:"failOnReject" desc:"Fail the task if any transaction is rejected."`
FailOnSuccess bool `yaml:"failOnSuccess" json:"failOnSuccess" desc:"Fail the task if any transaction succeeds (for negative testing)."`
ClientPattern string `` /* 127-byte string literal not displayed */
ExcludeClientPattern string `yaml:"excludeClientPattern" json:"excludeClientPattern" desc:"Regex pattern to exclude certain client endpoints."`
}
func DefaultConfig ¶
func DefaultConfig() Config
type Task ¶
type Task struct {
// contains filtered or unexported fields
}
Source Files