Struct StakingTransactions 

pub struct StakingTransactions<P> {
    processor: TransactionProcessor<P>,
    queues: TransactionQueues,
}

Fields

processor: TransactionProcessor<P>

queues: TransactionQueues

Implementations

impl<P: Provider + Clone> StakingTransactions<P>

pub async fn apply_all(&mut self) -> Result<Vec<TransactionReceipt>>

Sends and awaits all transactions with high concurrency.

This is the preferred way to make the changes to the stake table contract as quickly as possible, while still allowing alloy’s implicit estimateGas calls to succeed.

Ensures that dependent transactions are finalized before continuing.

The synchronization points are after

1. Ether + token funding
2. Approvals
3. Registrations
4. Delegations

For each them at least one L1 block will be required.

pub async fn apply_prerequisites(&mut self) -> Result<Vec<TransactionReceipt>>

Sends and awaits receipts on all funding and approval transactions

If the caller wants more control but quickly get to a point where actual changes are made to the stake table it is useful to call this function first.

This processes funding and approvals with a synchronization point between them.

pub async fn apply_one(&mut self) -> Result<Option<TransactionReceipt>>

Sends and awaits one transaction

The caller can use this function to rate limit changes to the L1 stake table contract during setup.

pub fn registrations(&self) -> Vec<RegistrationInfo>

Returns pending validator registrations for staking UI service tests.

Retrieves validator addresses that were set up by staking_cli::demo::create(). Tests use these addresses to verify registration event processing.

pub fn delegations(&self) -> Vec<DelegationInfo>

Returns pending delegations for staking UI service tests.

Used to retrieve delegator and validator addresses after calling staking_cli::demo::create(). Tests use this data to verify delegation event processing in the staking UI service.

pub fn provider(&self, address: Address) -> Option<&P>

Returns the provider for a given address.

This is useful when you need to get the provider for a delegator or validator that was created during StakingTransactions::create().

Currently this is used by staking UI service to get the provider so that we can also undelegate stake because we need the signer that signed the delegate transaction

impl StakingTransactions<HttpProviderWithWallet>

pub async fn create( rpc_url: Url, token_holder: &(impl Provider + WalletProvider<Wallet = EthereumWallet>), stake_table: Address, validators: Vec<(PrivateKeySigner, BLSKeyPair, StateKeyPair)>, num_delegators_per_validator: Option<u64>, config: DelegationConfig, ) -> Result<Self, CreateTransactionsError>

Create staking transactions for test setup

Prepares all transactions needed to setup the stake table with validators and delegations. The transactions can be applied with different levels of concurrency using the methods on the returned instance.

Amounts used for funding, delegations, number of delegators are chosen somewhat arbitrarily.

Assumptions:

• Full control of Validators Ethereum wallets and the Ethereum node. Transactions are constructed in a way that they should always apply, if some (but not all) transactions fail to apply the easiest fix is probably to re-deploy the Ethereum network. Recovery, replacing of transactions is not implemented.

• Nobody else is using the Ethereum accounts for anything else between calling this function and applying the returned transactions.

Requirements:

• token_holder: Requires Eth to fund validators and delegators, ESP tokens to fund delegators.

Errors:

• If Eth or ESP balances of the token_holder are insufficient.
• If any RPC request to the Ethereum node or contract calls fail.

Trait Implementations

impl<P: Clone> Clone for StakingTransactions<P>

fn clone(&self) -> StakingTransactions<P>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<P: Debug> Debug for StakingTransactions<P>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.