/ethereum-api-tests

MEV Relay Test Files

This directory contains organized test files for MEV relay testing, copied from the flashbots-relay-spec repository.

Directory Structure

test_files/
├── relay/                          # Relay-specific test files
│   ├── bellatrix/                  # Bellatrix fork test files
│   ├── capella/                    # Capella fork test files
│   ├── deneb/                      # Deneb fork test files
│   └── electra/                    # Electra fork test files
├── builder/                        # Builder-specific test files
│   ├── bellatrix/                  # Bellatrix fork test files
│   ├── capella/                    # Capella fork test files
│   ├── deneb/                      # Deneb fork test files
│   └── electra/                    # Electra fork test files
├── schemas/                        # Type definitions and schemas
│   ├── types/                      # Relay type definitions
│   └── builder-types/              # Builder type definitions
├── specs/                          # OpenAPI specifications
│   ├── relay-oapi.yaml             # Main relay OpenAPI spec
│   └── builder-oapi.yaml           # Builder OpenAPI spec
└── apis/                           # API endpoint specifications
    ├── relay/                      # Relay API specs
    └── builder/                    # Builder API specs

File Types

Test Data Files

Relay Files

  • submit_block_request.json - Example block submission requests to the relay

Builder Files

  • execution_payload.json - Example execution payloads
  • signed_blinded_beacon_block.json - Example signed blinded beacon blocks
  • signed_builder_bid.json - Example signed builder bids
  • execution_payload_and_blobs_bundle.json - Example payload and blobs bundle (Deneb+)

Schema and Specification Files

OpenAPI Specifications

  • relay-oapi.yaml - Complete OpenAPI specification for relay endpoints
  • builder-oapi.yaml - Complete OpenAPI specification for builder endpoints

Type Definitions

  • types/ - YAML schema definitions for relay data structures
  • builder-types/ - YAML schema definitions for builder data structures

API Specifications

  • apis/relay/ - Detailed API endpoint specifications for relay
  • apis/builder/ - Detailed API endpoint specifications for builder

Usage

These files can be used for:

  • Unit testing MEV relay implementations
  • Integration testing with builders and proposers
  • Validation of message formats across different fork versions
  • Performance testing with realistic data structures
  • API contract validation using OpenAPI specifications
  • Schema validation for data structures
  • Mock server generation from OpenAPI specs
  • Client SDK generation

Fork Versions

  • Bellatrix: The merge fork introducing execution payloads
  • Capella: Shanghai fork with withdrawals support
  • Deneb: Cancun fork with blob transactions (EIP-4844)
  • Electra: Upcoming fork with additional features

Generated by organize_test_files.sh