Foundry Test Runner

WHAT IT DOES

Foundry Test Runner is a developer tool that simulates running Foundry tests for Solidity smart contracts. Paste your test file (Solidity with forge-std/Test.sol imports), optionally add the contract source, and select a verbosity level — the tool parses the test file, extracts test functions, and simulates test execution with randomized pass/fail results, gas usage estimates, and detailed output. It displays the test status, total test count, passed tests, failed tests, skipped tests, and gas used. This is essential for developers learning Foundry, experimenting with test structure, debugging test logic, or preparing test suites before running them locally with forge.

HOW TO USE

Connect your wallet using the BGWallet bridge (MetaMask or any Web3 wallet). Paste your Foundry test file in the test input area — the file should be Solidity code that imports forge-std/Test.sol and defines test functions (functions starting with "test"). Optionally, paste the contract source code that your tests are verifying. Select the verbosity level (Quiet, Normal, Verbose, Very verbose) to control the amount of output detail. Click "Run tests" to simulate test execution. The tool parses the test file, identifies test functions, simulates execution with randomized but realistic results, and displays the status, test counts, gas usage, and a detailed test output with pass/fail indicators. Results are displayed in a formatted output with color-coded statuses.

TECHNICAL MECHANISM

The tool parses the test file using regular expressions to identify test functions — functions with names starting with "test" (e.g., testExample, testBalance). It counts the number of test functions and simulates test execution by generating randomized results for each test. The randomization is seeded based on the test file content to produce consistent results for the same input. The tool simulates gas usage for each test (between 10,000 and 60,000 gas) and total gas usage for the test suite (100,000 to 300,000 gas). The verbosity level controls the detail of the output — higher verbosity adds more detailed logs and gas breakdowns. The tool does not actually compile or execute contracts — it provides a realistic simulation of test execution. All operations are performed client-side — no data is stored or transmitted.

WHAT IT CANNOT SEE

The tool cannot actually run Foundry tests without a local Foundry installation (forge) — the execution is a simulation. It cannot compile contracts without solc — the simulation assumes the contracts are valid. It cannot generate test coverage reports without additional tools like forge coverage. It cannot deploy contracts to real networks without configuration — the simulation does not include deployment. It cannot interact with Foundry's fuzzing or invariant testing without actual execution — those features are not simulated. It cannot detect actual bugs or vulnerabilities in the contract code — the simulation only checks test structure. It cannot provide real gas usage for specific contracts — gas estimates are simulated. The tool is read-only and does not sign any transactions.

PLEASE NOTE

This tool works exclusively with EVM-compatible chains for the wallet connection, but the Foundry test simulation is chain-agnostic and works with any Solidity code. Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, and XRP are not supported for wallet connection but the simulation works regardless. The tool provides a simulation of Foundry test execution — for real testing, install Foundry and run forge test locally. The tool does not store any data — all operations are performed client-side. The tool is provided as-is with no warranty or liability. Always verify test results with a local Foundry installation before relying on them.