HypurrStudio | Illusio

🧠 Project Name

HypurrStudio | illusio

🔍 Description

Illusio is a powerful transaction simulator specifically designed for HyperEVM, enabling developers to test, analyze, and debug smart contract interactions before deploying them to the network. It provides detailed insights into transaction execution, state changes, and potential vulnerabilities.

🛠️ How It Works

Illusio is a powerful transaction simulator for HyperEVM that helps developers test, analyze, and debug smart contract interactions before pushing them to mainnet.

Here’s how it works under the hood:

1. Local Hardfork Environment

1. Illusio spins up a local fork of the HyperEVM using an archive node at a chosen block number.
2. This fork mirrors the exact chain state at that block (balances, contracts, storage).
3. Developers can then test transactions in this fork without risking real funds or contracts.
4. Essentially, it’s like having a sandboxed clone of mainnet, where you can run “what if” scenarios.

2. Transaction Simulation

1. When a developer submits a transaction (e.g., a swap, a liquidity add, an NFT mint), Illusio executes it locally on the forked chain.
2. No transaction is broadcasted to the real network.
3. This allows safe testing of whether the transaction will succeed, how much gas it will cost, and what state changes will occur.

3. HyperEVM Trace Calls

1. Illusio leverages debug trace APIs provided by HyperEVM (debug_traceTransaction, debug_traceCall, debug_traceCallMany) with callTracer, prestateTracer and custom tracers.
2. These traces give low-level execution details:
   1. Function calls and return values
   2. Internal contract calls
   3. Event logs (ERC20/721 transfers, etc.)
   4. Gas usage at each step
   5. State changes (storage diffs, balance updates)

4. Developer Power Tools

1. On top of traces, Illusio adds advanced simulation controls:
   1. Impersonation: Run a transaction as if you were any address (test whales, multisigs, bots).
   2. State Overrides: Override balances, storage, or contract code to test extreme scenarios.
   3. Balance Overrides: Pretend you have more/less tokens to simulate edge cases.
   4. Historical Replay: Fork from any past block to replay and debug historical transactions.
   5. Bundle Simulation

5. Debugging & Insights

1. Illusio turns trace data into a developer-friendly view:
   1. ERC20/ERC721 asset flow detection (who received/sent what).
   2. Gas breakdown across internal calls.
   3. Error surfacing (why a tx reverts, with detailed reason).
   4. State diff viewer (before vs after storage changes).
2. We also provide a light-weight SDK for integration in the application, that could easily be used in the wallets to simulate the tx and show the exact error before broadcasting the tx

📂 Project Links

Website: https://illusio.vercel.app/
Documentation: https://hypurrstudio.github.io/illusio-docs/intro/
Github: https://github.com/HypurrStudio
X/Twitter: https://x.com/hypurrstudio
Swagger UI: https://hypurrstudio.onrender.com/swagger

👥 Team

1. Nilesh Gupta [ X/Twitter | Discord | Github ]
2. Sumith Prabhu [ X/Twitter | Discord | Github ]