Vault Agent decision pipeline

The Vault Agent’s decision pipeline evaluates candidate vaults before proposing a portfolio change.

flowchart LR
  Candidates[Candidate vaults] --> Eligibility[Eligibility]
  Eligibility --> Assessment[Opportunity assessment]
  Assessment --> Constraints[Portfolio and user constraints]
  Constraints --> Execution[Execution request]

Candidate discovery

The system gathers opportunities from supported protocols and configured assets. Unregistered or unsupported opportunities are excluded before scoring.

Eligibility

Candidates must satisfy the current protocol, vault type, asset, operational, and safety requirements. A candidate that fails a mandatory requirement is not eligible for allocation.

Opportunity assessment

Eligible candidates are evaluated using the current yield, liquidity, collateral, market, and protocol data available to the Vault Agent.

The highest displayed APY is not the only input and does not guarantee selection.

Allocation constraints

The Vault Agent applies portfolio diversification, concentration, exposure, profile, and user-preference constraints before producing target allocations.

A highly ranked vault can receive no allocation or only part of the portfolio when a broader constraint prevents the proposed change.

Execution handoff

The pipeline proposes an action; the shared execution framework validates and submits only permitted protocol interactions. See Execution framework.

Explaining a decision

The API can expose decision and action details for supported runs. These details explain the inputs available at the time and are not a promise about future allocations.