Quick start

Requirements

• Foundry (forge on your PATH) and Node 20 or newer.
• A Foundry project with tests (the folder with foundry.toml).
• Optional: Slither and Aderyn for findings.

1. Install the tools

Skip this if forge --version and node --version already work.

curl -L https://foundry.paradigm.xyz | bash && foundryup

2. Get the exporter into your project

Seven plain Node scripts, no install. They are downloaded from the app, so they always match the version you use.

cd path/to/your-project
curl -fsSLO -w "saved %{filename_effective}\n" "https://www.luorasec.xyz/exporter/luora-{export,lib,atlas,findings,coverage,chains,bridge}.mjs"

3. Export a run

node luora-export.mjs

It runs forge test with traces, maps the contract, merges Slither and Aderyn reports from reports/ if you have them, and writes luora-data.json next to foundry.toml. Add that file to .gitignore.

4. Load it

Open luorasec.xyz/trace and drop luora-data.json on the Start page. The file is read in that tab only and never uploaded.

5. Optional: run tests from the page

Start the bridge in the same folder and open the link it prints. Start test, Test all and Reload trace then run forge on your computer. See Run tests from the browser.

node luora-bridge.mjs

No Foundry project at hand? Press Try the sample vault on the Start page: LuoraVault, a small demo vault bundled with the app.