KYVRANEPRE-EXECUTION FIREWALL
Open workspace

Product documentation

How Kyvrane proves a trade.

A practical reference for the assessment pipeline, deterministic verdicts, provider modes, receipt model, and server API.

LAST UPDATED JUL 12, 2026

01 · OVERVIEW

Pre-execution control before capital moves.

Kyvrane accepts an AI-assisted trade proposal, verifies market evidence and execution conditions, applies deterministic risk policies, and returns an auditable receipt. It doesn’t hold funds, place trades, generate strategies, or authorize capital through an AI model.

02 · PIPELINE

One ordered assessment path.

  1. ProposalSymbol, side, quantity, and expected gross return enter the server API.
  2. EvidenceSoSoValue data is normalized when a configured live response is available.
  3. ExecutionSoDEX order-book conditions are converted into estimated fill and slippage.
  4. PolicyPure TypeScript checks calculate the verdict and reason codes.
  5. ReceiptCanonical inputs and output are recorded with a deterministic SHA-256 content hash.

03 · VERDICTS

Policy code owns the decision.

APPROVE

All deterministic limits pass.

REVIEW

A declared review threshold requires human attention.

BLOCK

One or more blocking limits fail.

AI may summarize evidence, but it can’t return or override an authorization verdict.

04 · PROVENANCE

Source mode stays visible.

Provider adapters expose source metadata. The interface labels configured provider responses as live. When live data isn’t available, the assessment uses declared local input values and labels them local input. Local input must never be presented as live provider data.

05 · RECEIPTS

Every result is addressable and replayable.

A receipt records the proposal, normalized assessment input, execution calculation, reason codes, provider metadata, policy version, verdict, and creation time. Server receipts are process-local in the current build. The interface also saves receipt history in the user’s browser under kyvrane.receipts.v1.

06 · API ROUTES

Server orchestration boundaries.

POST /api/trades/analyzeEvaluate a validated trade assessment.
GET /api/receiptsList process-local receipts newest first.
GET /api/receipts/:idRetrieve one receipt.
POST /api/receipts/:id/replayReevaluate captured inputs.
GET /api/healthRead application health.

07 · RUN LOCALLY

Verify the repository.

npm install
npm run dev
npm run verify

Keep SOSOVALUE_API_KEY in server-side environment configuration. Don’t commit credentials, tokens, wallets, or private keys.