Veyronn Documentation

Local Development

Install, configure, build, test, and run Veyronn locally.

Prerequisites

Node.js 20 or newer
npm
Foundry (forge, cast, and anvil)
PostgreSQL for service integration
an injected EVM wallet for browser testing

Install

git clone https://github.com/divi2806/veyronn.git
cd veyronn
npm install --legacy-peer-deps

Configure

Start from the committed examples:

cp apps/web/.env.testnet.example apps/web/.env.local
cp services/indexer/.env.example services/indexer/.env.local
cp services/keeper/.env.example services/keeper/.env.local

Populate public addresses from deployments/46630.json. Keep DATABASE_URL, KEEPER_PRIVATE_KEY, KEEPER_API_TOKEN, provider keys, and all other secrets server-only.

Run the web app

npm --workspace @veyronn/web run dev

Build and test

npm test
npm run build

Targeted checks:

npm run test:contracts
npm run test:indexer
npm run test:keeper
npm run typecheck:web
npm run build:web

Deployment verification

npm run verify:testnet
npm run e2e:testnet
npm run e2e:realtime-oracle
npm run e2e:delegated-intents