The app runs entirely locally with no required onchain setup. Contract addresses are optional: leave them empty and Watchtowers and receipts fall back to an offchain simulation mode.
Install and run
$ npm install
$ npm run dev
# serves on http://localhost:3000
Environment
Copy .env.example to .env and fill in what you need.
SESSION_SECRETiron-session encryption key, 32+ random chars in production
NEXT_PUBLIC_PASS_ADDRESSdeployed KansokuPass address (optional)
NEXT_PUBLIC_REGISTRY_ADDRESSdeployed WatchtowerRegistry address (optional)
OLLAMA_URL / OLLAMA_MODELlocal LLM for analyst briefs (optional — degrades to raw findings)
WHITELISTED_ADDRESSEScomma-separated wallets granted founder access (optional)
Compiling and deploying contracts
Generate ABIs and bytecode from contracts/, then deploy to Robinhood Chain with Foundry, Remix, or the bundled deploy script.
$ node scripts/compile-contracts.mjs
# writes ABIs + bytecode to src/lib/abi/
$ node scripts/deploy.mjs
# reads DEPLOYER_PRIVATE_KEY from .env, writes deployed addresses back