Prop AMM

Compile and execute submitted Rust strategies against the fixed prop-amm evaluator runtime. Supports native and BPF evaluation paths, validation, and artifact compilation.

Current public support: shared placement on CPU workers only. Submit via POST /api/v1/recipes/prop_amm/jobs or POST /api/v1/jobs with "recipe": "prop_amm".

Operations

Operation	Description
`eval`	Compile natively and run the standard simulation batch
`eval_chunk`	Run one deterministic contiguous seed chunk of the native batch
`validate`	Fast BPF validation suite (skips native parity)
`validate_full`	Full validation including native/BPF parity checks
`bpf_eval`	Compile for BPF and evaluate with the constrained runtime
`bpf_eval_chunk`	Run one seed chunk through the BPF evaluator
`build`	Compile and publish native and BPF submission artifacts
`concavity_check`	Fast validation with explicit buy/sell concavity checks

Payload Fields

Field	Type	Required	Description
`operation`	string	yes	One of the operations above
`strategy_ref`	string	yes (most ops)	Artifact ID of the Rust strategy source
`rs_source_b64`	string	alt	Base64-encoded Rust source (alternative to strategy_ref)
`seed_base`	integer	no	Starting seed for simulation
`start`	integer	no	Start offset for chunk operations
`count`	integer	no	Number of seeds to run
`steps`	integer	no	Simulation steps
`strict_curves`	boolean	no	Enable strict curve validation
`per_seed`	boolean	no	Return per-seed edge data

Either strategy_ref or rs_source_b64 must be provided.

Examples

Validate a strategy (fast path)


POST /api/v1/recipes/prop_amm/jobs
{
  "payload": {
    "operation": "validate",
    "strategy_ref": "art_123"
  },
  "timeout_s": 900
}

Full evaluation


POST /api/v1/recipes/prop_amm/jobs
{
  "payload": {
    "operation": "eval",
    "strategy_ref": "art_123",
    "seed_base": 0,
    "count": 1000,
    "steps": 200
  },
  "timeout_s": 1800
}

Build artifacts


POST /api/v1/recipes/prop_amm/jobs
{
  "payload": {
    "operation": "build",
    "strategy_ref": "art_123"
  },
  "timeout_s": 600
}

The build operation publishes compiled native and BPF artifacts.

Result Fields

Eval operations return: success, avg_edge, n_seeds, returncode, output_tail

Chunk operations also return: chunk_index, chunk_count, start

Build returns: success, source_hash, native_path, bpf_path, native_cache_hit, bpf_cache_hit

Concavity check returns: success, buy_side_concave, sell_side_concave