Simulation

Simulation is bound to a revision#

Simulation consumes the selected path’s quotes and observed state. Its hash-linked artifacts feed policy, the Strategy Manifest and the execution plan. Quotes and state can expire; material workflow edits invalidate downstream references.

A read-only server preview#

const preview = await flofi.strategies.simulate(strategy.id, {
  simulationSubject: userAddress,
});
// preview: true, persisted: false, authorizable: false
// authority: "NONE"

The subject is a public address whose state the preview reads. It is not authenticated wallet ownership and grants no authority. The Developer API preview does not expose calldata or signatures. Multi-step API previews are refused with SIMULATE_ONE_STEP_AT_A_TIME.

Refresh before review#

1. 01
   Check provenance, freshness and any limitations.
2. 02
   Resolve blocking findings.
3. 03
   Re-simulate after material edits or quote expiration.
4. 04
   Review the new Strategy Manifest.

MOCKED previews retain MOCKED provenance. A successful preview cannot upgrade evidence to testnet or mainnet execution.