Overview

Heron — Verifiable AI Yield Agent

The heron strikes only when the edge is real.

Heron is a non-custodial, verifiable AI yield agent that autonomously allocates user funds into DeFi protocols — the agent signs transactions within policy-enforced budget limits, pays for market data via pay.sh (opens in a new tab) x402 micro-payments, and stores secrets in GCP Secret Manager.

What it does

  1. User deposits assets into their own isolated vault (non-custodial)
  2. AI agent evaluates market conditions using paid data from pay.sh marketplace
  3. Net-Edge gate ensures the expected return exceeds ALL costs (gas, slippage, signal cost)
  4. On-chain policy contract enforces caps — the agent cannot exceed per-action, epoch, or position limits
  5. Venue CPI/call executes the allocation — real yield accrues from borrower interest
  6. Every decision is hash-chained in a Verifiable Debate Ledger (VDL), replayable and auditable

Key Properties

PropertyHow
Non-custodialUser withdraws anytime, even while paused; agent cannot block
VerifiableEvery decision hash-chained in VDL, replay reproduces plan_hash
Policy-enforcedMerkle mandate, per-action cap, epoch cap, position limit — all on-chain
Net-edge disciplineAgent stands still when edge ≤ 0 after all costs
Per-user isolationEach wallet gets its own vault PDA/contract, policy, pay.sh wallet
Paid signalsReal USDC spent on x402 data gateway, receipt in decision record

Supported Chains

ChainNetworkAssetVenue
SolanaDevnetwSOLSolend
ArcTestnetUSDCMeridian
GIWASepoliaWETHGiwaLend

Tech Stack

LayerTechnology
ProgramsAnchor (Rust), Solana devnet
BackendPython 3.12, FastAPI, uvicorn
FrontendNext.js 15, React, TypeScript, Tailwind
WalletReown AppKit (Solana adapter)
Paymentspay.sh x402 SDK, Solana mainnet USDC
SecretsGCP Secret Manager
TEEAWS Nitro Enclave (optional attestation)
Testing420 backend tests (pytest), Anchor integration tests

Quick Links

Architecture