Veyronn Documentation
AI Intent Trading
Turn natural-language trade instructions into constrained, reviewable actions.

Intent trading separates language interpretation from transaction authority.
Parsing
When OPENAI_API_KEY is configured on the Railway BFF, Veyronn can use strict structured model output. If the provider is absent or fails, the tested deterministic parser remains available. Parsed fields include action, market, side, collateral, size, leverage, price condition, expiry, and risk controls.
The parser cannot submit a transaction. Its output must become either:
- a transaction explicitly approved by the connected wallet, or
- an exact EIP-712 message signed by the owner and checked against a live bounded session
Immediate intents
An immediate open or close can be signed for Railway execution. The BFF verifies the signature and queue payload. The keeper independently verifies it again, confirms on-chain session limits and nonce state, fetches a fresh price report, simulates, and submits only through the delegated protocol methods.
Conditional intents
Price conditions become on-chain orders rather than fragile browser jobs. The user signs the order creation transaction. The keeper may later execute it only when the contract's trigger and risk checks pass.
Safety properties
- Model output has no private key access.
- Every delegated message is domain-bound to chain ID and protocol address.
- Signed fields cannot be changed after signature.
- Expiry and nonce prevent indefinite or repeated use.
- Contract session limits bound market, action, collateral, size, and leverage.
- Revocation stops future session use.