Veyronn Documentation

Contracts

Responsibilities and trust boundaries of the Veyronn Solidity system.

VeyronnProtocol

The core state machine owns:

  • markets and risk parameters
  • margin account ledgers
  • positions and open interest
  • open, reduce, close, and liquidation
  • funding indexes
  • bounded trading sessions and nonces
  • intent commitments and approvals
  • conditional orders
  • keeper authorization

It uses Ownable2Step and ReentrancyGuard. User-facing financial paths check ownership, state, market mode, oracle output, slippage, margin, leverage, open interest, skew, and vault liquidity.

CollateralVault

The vault holds the six-decimal collateral token and permits protocol-directed deposits and payouts. It separates token custody from the protocol's internal free and reserved collateral accounting.

SignedOracleRouter

The deployed testnet router verifies EIP-712 reports from the configured signer. Reports are bound to chain, router, market, validity window, observation time, benchmark, bid, ask, confidence, and round. Quotes exist only during executeWithReports and are cleared before return.

OracleRouter

The mainnet router implements Chainlink Data Streams v3 and v8 report verification, bid/ask selection, source-time checks, reference-feed deviation checks, market-status enforcement, sequencer safeguards, and dynamic LINK fee-manager support. It is implemented and tested locally but not deployed.

StrategyNFT

An ERC-721 strategy container stores reusable weighted market legs and their side and leverage bounds. Protocol execution requires strategy ownership.

ConditionalEvaluator

This pure decision component evaluates supported trigger and comparator combinations. The protocol remains responsible for order status, authorization, price verification, action execution, and final state changes.

TestCollateral

The testnet vUSD token supports the faucet and first-time margin funding workflow used by the current public deployment.