Veyronn Documentation

Workspace

Navigate the Veyronn monorepo and its ownership boundaries.

Veyronn is an npm workspace with a Foundry contract package.

veyronn/
├── apps/web/            Next.js UI and Railway BFF routes
├── contracts/           Solidity contracts, scripts, and Foundry tests
├── deployments/         Public chain deployment manifests
├── packages/chain/      Chains, config, EIP-712 types, units, and ABIs
├── services/indexer/    Confirmation-aware EVM log indexer
├── services/keeper/     Oracle, automation, and delegated execution worker
└── scripts/             Deployment verification and end-to-end checks

Ownership boundaries

| Package | Owns | | --- | --- | | contracts | Authoritative financial state, authorization, risk, settlement, and oracle verification | | @veyronn/chain | Shared chain definitions, typed-data schemas, deployment config, fixed-point units, and generated ABIs | | @veyronn/web | Product UI, wallet connection, transaction building, BFF reads, and server-only provider adapters | | @veyronn/indexer | Log ingestion, checkpoints, reorg rollback, materialized reads, and candle persistence | | @veyronn/keeper | Hermes or Data Streams connectivity, report preparation, simulation, deduplication, and autonomous submission |

EVM architecture

Veyronn is implemented as an independent EVM protocol. Solidity contracts, EIP-712 authorization, EVM log indexing, injected-wallet flows, and Robinhood Chain deployment configuration share typed interfaces through @veyronn/chain.

Public configuration

deployments/46630.json is the machine-readable source for deployed testnet addresses, market IDs, deployment block, signer, and oracle policy. Private keys, database credentials, API tokens, and provider secrets must never be added to deployment manifests.