Zoltar

Zoltar is a Bun + Solidity project for building and exploring prediction markets with forked universes. The repository is split into two main parts:

• solidity/ contains the contracts, tests, and generated contract artifacts
• ui/ contains the Preact frontend that reads from those contracts

Prerequisites

• Bun 1.3+
• Foundry anvil for local chain work

Setup

Install dependencies, generate contract artifacts, vendor the UI dependencies, and build the frontend:

bun run setup

Install anvil if it is not already available:

bun run install:anvil

Local Development

Start a local chain with anvil, then run the setup step once and launch the UI:

1. Start anvil
2. Run bun run setup
3. Run bun run ui:serve

If you are iterating on the frontend and want rebuilds, use:

bun run ui:watch

Common Commands

Run the UI in development mode:

bun run ui:serve

Watch and rebuild the UI assets:

bun run ui:watch

Build the UI:

bun run ui:build

Regenerate contract bindings and UI vendor assets:

bun run generate

Compile the Solidity contracts:

bun run compile-contracts

Run the full test suite:

bun run test

Type-check the TypeScript code:

bun run tsc

Format the codebase:

bun run format

Run linting:

bun run lint

Auto-fix lint issues:

bun run lint:fix

Run dead-code analysis:

bun run knip

Auto-fix dead-code findings:

bun run knip:fix

Measure Solidity gas costs:

bun run gas-costs

Notes

• bun run setup is the quickest way to bootstrap a fresh checkout.
• bun run test runs the TypeScript check first, then executes the test suite.
• The repo uses exact dependency versions for reproducible installs.