Interface MutableWorldState

All Superinterfaces:
AutoCloseable, org.hyperledger.besu.evm.worldstate.MutableWorldView, org.hyperledger.besu.evm.worldstate.WorldState, org.hyperledger.besu.evm.worldstate.WorldView
public interface MutableWorldState extends org.hyperledger.besu.evm.worldstate.WorldState, org.hyperledger.besu.evm.worldstate.MutableWorldView
Represents a mutable view of the Ethereum world state, allowing queries and modifications to account balances, nonces, code, and storage.

Implementations manage the state root hash and persist changes to underlying storage through StateRootCommitter.

Extends both WorldState and MutableWorldView.

  • Nested Class Summary

    Nested classes/interfaces inherited from interface org.hyperledger.besu.evm.worldstate.WorldState

    org.hyperledger.besu.evm.worldstate.WorldState.StreamableAccount

  • Field Summary

    Fields inherited from interface org.hyperledger.besu.evm.worldstate.WorldView

    EMPTY

  • Method Summary

    Modifier and Type
    Method
    Description
    default MutableWorldState
    disableTrie()
    Disables the trie structure used for storage indexing.
    default MutableWorldState
    freezeStorage()
    Freezes the storage by preventing any further changes to it
    default void
    persist(BlockHeader blockHeader)
    Persist accumulated changes to underlying storage.
    void
    persist(BlockHeader blockHeader, StateRootCommitter committer)
    Persist accumulated changes to underlying storage.

    Methods inherited from interface org.hyperledger.besu.evm.worldstate.MutableWorldView

    updater

    Methods inherited from interface org.hyperledger.besu.evm.worldstate.WorldState

    close, frontierRootHash, rootHash, streamAccounts

    Methods inherited from interface org.hyperledger.besu.evm.worldstate.WorldView

    get

  • Method Details

    • persist

      void persist(BlockHeader blockHeader, StateRootCommitter committer)
      Persist accumulated changes to underlying storage.
      Parameters:
      blockHeader - If persisting for an imported block, the block hash of the world state this represents. If this does not represent a forward transition from one block to the next `null` should be passed in.
      committer - An implementation of StateRootCommitter responsible for recomputing the state root and committing the state changes to storage.

    • persist

      default void persist(BlockHeader blockHeader)
      Persist accumulated changes to underlying storage.
      Parameters:
      blockHeader - If persisting for an imported block, the block hash of the world state this represents. If this does not represent a forward transition from one block to the next `null` should be passed in.

    • freezeStorage

      default MutableWorldState freezeStorage()
      Freezes the storage by preventing any further changes to it
      Returns:
      this instance

    • disableTrie

      default MutableWorldState disableTrie()
      Disables the trie structure used for storage indexing.
      Returns:
      this instance