Agent
Net-Edge Gate

Net-Edge Gate

The Net-Edge gate is Heron's core risk control: the agent strikes only when the edge is real.

Formula

gross_edge = venue_carry + signal_edge
costs      = gas + slippage + lockup + uncertainty + hurdle
net_edge   = gross_edge - costs

If net_edge ≤ 0 → the agent declines. The reason is recorded in the VDL.

Cost Components

CostDescription
GasTransaction fee on the target chain
SlippageExpected price impact for the allocation size
LockupOpportunity cost of capital being deployed (time value)
UncertaintyConfidence discount on the signal quality
HurdleMinimum margin above zero required to act

Edge Components

EdgeSource
Venue carryOn-chain supply APY from the lending protocol (e.g., Solend 1.27%)
Signal edgeAdditional alpha from paid market data (Vybe Analytics via pay.sh)

Why This Matters

Without a net-edge gate, a yield agent would:

  1. Pay gas to move $10 into a pool returning $0.001/year
  2. Accumulate signal costs that exceed the yield
  3. Churn positions when the expected gain is noise

The gate ensures every action the agent takes is expected to be profitable after ALL friction costs. When it can't find edge, it stands still — and that inaction is recorded as a verified decision.

Decision Outcomes

OutcomeRecorded AsMeaning
net_edge > 0acted: trueAgent allocated into venue
net_edge ≤ 0acted: falseAgent declined, stood still
No drift detectedNot recordedNo evaluation needed

Example

# Real numbers from a Solend cycle:
venue_carry = 0.0127      # 1.27% APY from Solend
signal_edge = 0.0005      # Small alpha from token momentum signal
gross_edge  = 0.0132
 
gas       = 0.000005      # ~5000 lamports
slippage  = 0.0001        # Minimal for SOL/cSOL
lockup    = 0.001         # Opportunity cost at current rates
uncertainty = 0.002       # Signal confidence discount
hurdle    = 0.005         # Minimum acceptable margin
 
costs     = 0.008105
net_edge  = 0.0132 - 0.008105 = 0.005095  # > 0 → ALLOCATE

Integration with Keeper

The net-edge gate sits between signal acquisition and on-chain submission in the decision loop:

Signals purchased → Net-Edge evaluated → If positive → Submit → Record
                                        → If negative → Decline → Record

Both outcomes are part of the verifiable record.