Protocol overview · v1.0

Explore DefiLords

Automate the full spectrum of on-chain earning — so anyone with a wallet can access strategies that today require a trading desk. Here is what the protocol does, why it exists, and where it is headed.

1

Mission & Vision

Automate the full spectrum of on-chain earning — so anyone with a wallet can access strategies that today require a trading desk.

Every meaningful way to earn on-chain — lending, staking, liquidity provision, delta-neutral basis trades, directional trading, perpetuals — is operationally demanding. Each requires monitoring, timing, rebalancing, and risk management that most capital cannot justify paying for.

DefiLords is building a single deposit surface over all of it: you deposit once, the protocol runs the strategy, and the accounting tells you the truth about what you earned.

01

Every earning primitive, one roof

Lending and borrowing markets. Staking. Concentrated liquidity. Market-neutral yield. Directional trading. Perpetuals. Each as a vault you can enter with a single deposit, each managed by automation that never sleeps.

02

Every number traces to an on-chain fact

The industry norm is dashboards showing gross yield without impermanent loss, APYs annualised from a single lucky day, and 'total earned' figures that quietly include your own returned principal. We build the opposite.

The second commitment is the harder one, and it is what we intend to be known for.

2

The Problem

On-chain earning is operationally expensive

A concentrated Uniswap V3 position stops earning the moment price exits its range. Lending positions need monitoring for rate changes and utilisation risk. Trading strategies need constant execution discipline. Doing any of these properly is a full-time job — and doing all of them is a team.

Yield reporting across DeFi is systematically misleading

Three failure modes we have measured in our own contracts and fixed:

FailureWhat the user seesReality
Recycled principal counted as yield“You earned $35 this harvest”Most of it was the vault's own capital being swept back and taxed as profit
Withdrawals liquidating shared positionsSmall exit, whole vault's LP closedEvery remaining depositor pays swap costs and stops earning until redeployment
Yield shown gross of impermanent loss“$8.57 in fees earned”Position simultaneously below its cost basis

We do not present these as hypotheticals. Each was found in our own code, reproduced with tests, and fixed — details in Engineering.

There is no per-user yield attribution in most vaults

Auto-compounding vaults fold yield into share price. That is efficient, but neither the protocol nor the user can then answer “how much did I actually earn?” without off-chain reconstruction that breaks whenever someone deposits or withdraws between harvests.

3

How It Works

Live architecture
User deposit
ERC-4626 Vault
Strategy Adapter
Aave · Morpho · Uniswap V3 · Pendle
Keeper (automation) · deployIdle · rebalance · harvest

Vaults hold deposits and issue ERC-4626 shares (or an ERC-721 receipt for the NFT-based LP vault). Adapters are swappable modules holding the actual position — this is what lets the protocol add new strategies without migrating user funds. The keeper is an off-chain bot executing on cron schedules, restricted on-chain to onlyKeeper functions: it can operate positions but cannot change ownership, alter fees, or withdraw funds.

Signal engine — current status

A Python service computes market signals across on-chain metrics, social sentiment (FinBERT), macro regime classification, and portfolio optimisation (mean-variance / Black-Litterman / risk parity by regime).

Status

Research and monitoring. These signals inform operator decisions and are surfaced on the platform. They do not currently execute on-chain allocation — live vault behaviour is governed by deterministic rules. Connecting the engine to live allocation is a roadmap item, gated on the safety work in Security.

Security model

RoleHolderPowers
OwnerCold wallet (hardware)Set adapter/keeper/fees, pause, emergency exit
KeeperHot EOA (automation)deployIdle, harvest, rebalance only
GuardianOptional fast-response keypause only
4

Engineering

Three accounting failures were found in our own contracts, reproduced with tests, and fixed. Each one had been silently inflating what a depositor was told they earned.

Fixed

Recycled principal

harvest() swept idle USDC from rebalances alongside genuine fee income, then charged a performance fee on the whole amount. Fixed by isolating fee-collection accounting from position accounting.

Fixed

Socialised exit cost

A single small withdrawal closed the entire shared LP. Fixed in the hybrid design — a reserve leg absorbs exits so the concentrated position stays open.

Fixed

IL-blind yield display

Fee income was reported without netting the position's mark against cost basis. Fixed by reporting net realized alongside gross on every surface.

5

How We Compare

Typical yield aggregatorDefiLords
Yield reportingGross, IL-blindGross and net, IL-aware
Exit costSocialised across depositorsIsolated per position
Risk limitsOff-chain policyOn-chain circuit breakers
Strategy additionFund migrationSwappable adapter
CustodyVariesNon-custodial, ERC-4626
6

Roadmap

  1. Shipped

    ERC-4626 vaults on Arbitrum

    dlSTABLE, dlGROWTH, dlFLOW, dlFLOW Hybrid, dlLP live with keeper automation.

  2. Shipped

    Hybrid withdrawal fairness

    Reserve leg absorbs exits so the shared LP position is never force-closed.

  3. In progress

    Signal engine → live allocation

    Connecting the Python signal service to on-chain allocation, gated on safety work.

  4. Next

    Base, BNB Chain, Solana

    Cross-chain expansion via LayerZero, Wormhole, Across, CCIP, deBridge, Stargate.

  5. Next

    Third-party audit

    Contracts are unaudited beta software today. Audit precedes any deposit-cap increase.

7

Security & Risk

Unaudited beta

These contracts have not been through a third-party audit. Treat every deposit as capital you can afford to lose entirely. Deposit caps are deliberately small while that remains true.

  • Smart contract risk — unaudited beta software; bugs may result in total loss.
  • Variable yield — displayed APY is historical, not a forecast. Returns can be zero or negative.
  • Impermanent loss — concentrated LP positions lose value versus holding when price exits range.
  • Keeper dependency — if automation stops, yield pauses; deposits stay safe and redeemable.
  • Stablecoin depeg — USDC depeg is monitored at ±1% but cannot be prevented by the protocol.
  • Regulatory — DeFi regulation is unsettled and may change how the protocol operates.