Ethereum Tests

Common tests for all clients to test against. The git repo updated regulary with new tests.

This section describes basic test concepts and templates which are created by cpp-client.

Note

See Contribute to Docs if you want to help improve this documentation.

Tutorial:

• Retesteth
  • Retesteth through the Web
    • Request Helper
    • Request Single File
    • Custom Command
  • Retesteth in a Docker Container
    • How Does This Work?
  • Test Against Your Client
    • Replace geth Inside the Docker
    • Client Outside the Docker, Keep Configuration Files Intact
    • Client Inside the Docker, Modify Configuration Files
    • Client Outside the Docker, Modify Configuration Files
  • Running Multiple Threads
  • Using the Latest Version
  • Conclusion
• State Transition Tests
  • The Environment
  • Compiling Your First Test
    • The Source Code
    • Failing a Test
    • Tests that are Supposed to Fail
  • Yul Tests
  • Solidity Tests
    • ABI values
  • Multitest Files
    • Multiple Tests, Same Result
  • Conclusion
• Blockchain Tests
  • The Environment
  • Types of Blockchain Tests
  • Valid Block Tests
    • Test Source Code
    • Tests using the blockchain random value
  • Invalid Block Tests
    • Getting Exception Names
  • Transition Tests
  • Conclusion
• Ethereum Object Format Tests
  • Fillers
    • Overall Structure
    • The Data Section
    • The Expect Section
• Testing EIPs
  • Environment
  • Test Cases
  • Testing new Opcodes
  • Conclusion
• Blocktests with Ommer / Uncle Blocks
  • Uncle Blocks
  • Writing Tests
    • Writing the Filler File
    • Correcting the State Root
  • Conclusion
• Test Internals
  • Compiled Tests
  • Virtual Machine Trace
    • Normal Virtual Machine Trace
    • Raw Virtual Machine Trace
  • Conclusion
• How to Contribute Tests
  • Generalizing Tests
  • Files
    • State Tests
    • Blockchain Tests
  • Conclusion
• Adding Transition Tool Support to your Execution Layer Client
  • Why Do This?
  • Configuration
  • Command line parameters
    • Transaction tests
    • State transition tests
    • Blockchain tests
  • Minimal t8ntool client
• Custom compiler support
  • Why Do This?
  • Install Huff as part of the Docker
  • Update the client configuration
  • Create a test file that uses Huff

Retesteth Reference:

• Using Retesteth
  • Command Line Options
    • Set The Suite
    • Retesteth Options
    • Setting the Test Suite and Test
    • Debugging
    • Additional Tests
    • Test Generation
  • Examples
• The Retesteth Config Directory
• Transition Tool
  • Command Line Parameters
    • Test Parameters
    • Input Files
    • Output Files
  • File Structures
    • Transaction File
    • Environment File
    • Allocation Files
    • Result File
    • Trace Files
  • Using Standard Input and Output
    • Input
    • Output
• The RPC Interface
  • Retesteth-Specific RPCs
    • debug_accountRange
    • debug_storageRangeAt
    • debug_traceTransaction
    • test_mineBlocks
    • test_modifyTimestamp
    • test_rewindToBlock
    • test_setChainParams
  • Standard RPCs Retesteth Uses

Test Reference:

• Blockchain Tests
  • Blockchain Tests Source Code
    • Subfolders
    • Test Structure
    • Genesis Block
    • Pre
    • Blocks
    • Transaction
    • Expect
  • Generated Blockchain Tests
    • Test Structure
    • Info Section
    • Pre/preState Section
    • GenesisBlockHeader Section
    • Valid Block Section
    • Invalid Block Section
    • Transaction Section
• Ethereum Object Format Tests
  • Ethereum Test Format Source Code
    • Test Structure
    • Transaction
    • Expect
  • Generated Ethereum Object Format
    • Test Structure
• State Transition Tests
  • State Transition Tests Source Code
    • Test Structure
    • Env
    • Pre
    • Transaction
    • Expect
  • Generated State Transition Tests
    • Test Structure
    • Info Section
    • Env Section
    • Post Section
    • Pre/preState Section
    • Transaction Section
• Sample Values
  • ABI Tests
  • Difficulty Test
    • Test Implementation
    • Test Structure
  • RLP Test
    • Test Implementation
    • Test Structure
  • Transaction Test
    • Test Implementation
    • Test Structure
    • Transaction Section
  • Trie Tests
    • Next and Previous Test
  • Miscellaneous Tests
    • Cryptographic Tests
    • Encoding Tests
    • Genesis Block Tests
• Contribute to Docs

Indices and tables

• Index
• Module Index
• Search Page