Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

evm

package module

Go to main page

Versions in this module

v1

v1.1.0

Jul 20, 2026

Changes in this version

+ type EnginePayloadEnvelope struct

+ BlobsBundle *engine.BlobsBundle

+ BlockValue *big.Int

+ ExecutionPayload *engine.ExecutableData

+ Override bool

+ RawExecutionPayload json.RawMessage

+ Requests [][]byte

+ Witness *hexutil.Bytes

+ func (e *EnginePayloadEnvelope) UnmarshalJSON(input []byte) error

+ func (e EnginePayloadEnvelope) MarshalJSON() ([]byte, error)

type EthRPCClient

+ GetNextProposer func(ctx context.Context, number *big.Int) (common.Hash, error)

v1.0.1

Apr 7, 2026

v1.0.0

Mar 12, 2026

Changes in this version

+ const ExecStageBuilt

+ const ExecStagePromoted

+ const ExecStageStarted

+ const ExecStageSubmitted

+ const FinalizedBlockLag

+ const FlagEvmEngineURL

+ const FlagEvmEthURL

+ const FlagEvmFeeRecipient

+ const FlagEvmGenesisHash

+ const FlagEvmJWTSecretFile

+ const InitialRetryBackoff

+ const MaxPayloadStatusRetries

+ const SafeBlockLag

+ var ErrInvalidPayloadStatus = errors.New("invalid payload status")

+ var ErrPayloadSyncing = errors.New("payload syncing")

+ func CheckTxIncluded(client *ethclient.Client, txHash common.Hash) bool

+ func GetRandomTransaction(t testing.TB, privateKeyHex, toAddressHex, chainID string, gasLimit uint64, ...) *types.Transaction

+ type EVMStore struct

+ func NewEVMStore(db ds.Batching) *EVMStore

+ func (s *EVMStore) GetExecMeta(ctx context.Context, height uint64) (*ExecMeta, error)

+ func (s *EVMStore) PruneExec(ctx context.Context, height uint64) error

+ func (s *EVMStore) SaveExecMeta(ctx context.Context, meta *ExecMeta) error

+ func (s *EVMStore) Sync(ctx context.Context) error

+ type EngineClient struct

+ func NewEngineExecutionClient(ethURL, engineURL string, jwtSecret string, genesisHash common.Hash, ...) (*EngineClient, error)

+ func (c *EngineClient) ExecuteTxs(ctx context.Context, txs [][]byte, blockHeight uint64, timestamp time.Time, ...) (updatedStateRoot []byte, err error)

+ func (c *EngineClient) FilterTxs(ctx context.Context, txs [][]byte, maxBytes, maxGas uint64, ...) ([]execution.FilterStatus, error)

+ func (c *EngineClient) GetExecutionInfo(ctx context.Context) (execution.ExecutionInfo, error)

+ func (c *EngineClient) GetLatestHeight(ctx context.Context) (uint64, error)

+ func (c *EngineClient) GetTxs(ctx context.Context) ([][]byte, error)

+ func (c *EngineClient) InitChain(ctx context.Context, genesisTime time.Time, initialHeight uint64, ...) ([]byte, error)

+ func (c *EngineClient) PruneExec(ctx context.Context, height uint64) error

+ func (c *EngineClient) ResumePayload(ctx context.Context, payloadIDBytes []byte) (stateRoot []byte, err error)

+ func (c *EngineClient) Rollback(ctx context.Context, targetHeight uint64) error

+ func (c *EngineClient) SetFinal(ctx context.Context, blockHeight uint64) error

+ func (c *EngineClient) SetFinalized(ctx context.Context, blockHash common.Hash) error

+ func (c *EngineClient) SetSafe(ctx context.Context, blockHash common.Hash) error

+ func (c *EngineClient) SetSafeByHeight(ctx context.Context, height uint64) error

+ type EngineRPCClient interface

+ ForkchoiceUpdated func(ctx context.Context, state engine.ForkchoiceStateV1, args map[string]any) (*engine.ForkChoiceResponse, error)

+ GetPayload func(ctx context.Context, payloadID engine.PayloadID) (*engine.ExecutionPayloadEnvelope, error)

+ NewPayload func(ctx context.Context, payload *engine.ExecutableData, blobHashes []string, ...) (*engine.PayloadStatusV1, error)

+ func NewEngineRPCClient(client *rpc.Client) EngineRPCClient

+ type EthRPCClient interface

+ GetTxs func(ctx context.Context) ([]string, error)

+ HeaderByNumber func(ctx context.Context, number *big.Int) (*types.Header, error)

+ func NewEthRPCClient(client *ethclient.Client) EthRPCClient

+ type ExecMeta struct

+ BlockHash []byte

+ Height uint64

+ ParentHash []byte

+ PayloadID []byte

+ Stage string

+ StateRoot []byte

+ Timestamp int64

+ TxHash []byte

+ UpdatedAtUnix int64

+ func (em *ExecMeta) FromProto(other *pb.ExecMeta) error

+ func (em *ExecMeta) ToProto() *pb.ExecMeta

v1.0.0-rc.4

Mar 9, 2026

v1.0.0-rc.3

Feb 10, 2026

v1.0.0-rc.2

Feb 3, 2026

v1.0.0-rc.1

Jan 28, 2026

v1.0.0-beta.3

Nov 3, 2025

v1.0.0-beta.2

Sep 18, 2025