How Sooner works

Sooner is a non-custodial recovery service for depositors stuck in failing DeFi vaults, illiquid or insolvent. When a stuck vault regains liquidity, the payout is a first-come race that automated bots normally win. Sooner competes in that race for you, so you recover whatever the vault pays out, ahead of the bots watching the same balance.

The whole design rests on one property: you never hand your assets to Sooner. You sign a standard 1inch limit order that pays you an exact amount and stays in your own wallet until it fills. Nothing Sooner runs can take your shares, change your payout, or leave you half-settled.

• Non-custodial. Your shares never leave your wallet until the moment they are redeemed for your payout, in the same transaction.
• Success-only fee. You set a discount off net asset value; that discount is the fee, and it is charged only out of what is recovered. If nothing is recovered, you pay nothing.
• Atomic. The fill, the redemption, and your payout are one transaction. It settles in full or it reverts and nothing happens.
• On HyperEVM today (chain id 999), with more chains added as vaults are onboarded.

1. 01

   You sign an exit order

   A standard 1inch limit order: your vault shares for an exact amount of the underlying asset. You see that payout before you sign. The order names a single Sooner executor as the only address allowed to fill it, and it never reaches a public order book.

2. 02

   Nothing moves until you are paid

   The shares stay in your wallet. The order is a signature, not a transfer, and it costs nothing to make. If it never fills, nothing ever happened. You can revoke the allowance at any time, with no involvement from Sooner.

3. 03

   The keeper fills you first

   When the vault holds enough of the underlying to cover your payout, the keeper fills your order in the same block, ahead of rival bots. The fill pays you the exact figure you signed. The shares it receives are redeemed against the vault, and the proceeds cover the fill.

4. 04

   The spread is the fee

   Whatever is left after paying you is Sooner's fee, the discount you set. Nothing is transferred separately and nothing is invoiced, so there is never a step where Sooner holds your money. If the numbers do not clear, the transaction reverts and no one is worse off.

The order is an EIP-712 typed order for 1inch's Limit Order Protocol v4. You sign it in your wallet: an off-chain signature, no gas, and it is not posted to any public order book. It becomes fillable only by the one executor named in it.

makeraddress

Your wallet. The order is signed by it and pays out to it.

makerAssetaddress

The vault share token you are exiting.

takerAssetaddress

The underlying asset you are paid in.

makingAmountuint256

The share amount you are offering, in the share token's own decimals.

takingAmountuint256

The exact payout you receive, fixed at signing. It cannot change without invalidating the signature.

allowedSenderaddress

A single Sooner executor. Only this address can fill the order, which is what keeps it off the open market and unfillable by anyone else.

expiryuint256

When the order stops being valid. You choose it, from never to a fixed number of days.

salt / nonceuint256

Makes each order unique and lets you cancel or replace one without touching the others.

The only contract you approve and interact with is 1inch's Limit Order Protocol v4. HyperEVM had no 1inch deployment, so it was built from 1inch's public MIT source, unchanged, and verified on HyperEVMScan. You can read the verified source and compare it byte-for-byte against 1inch's own repository.

You grant one allowance, to the Limit Order Protocol, on the vault share token you are exiting. That is the only approval in the flow, and it is the standard allowance any 1inch order needs.

• Sooner cannot take your shares. The order pays you first, in the same transaction, or it does not execute at all.
• Sooner cannot change the amount. Your payout is inside the signature, and changing a single digit invalidates it.
• Sooner cannot leave you half-done. The fill, the redemption, and your payout are one transaction, so it all happens or none of it does.
• Sooner cannot sit on your position. You revoke the allowance whenever you like, with no involvement from us.

You set a discount off the order's net asset value. That discount is both the fee and your queue priority: the keeper fills the largest discount first, so a bigger discount buys a higher place in line. It is charged only out of recovered funds, and nothing if nothing is recovered.

An order fills only when the vault can pay and redeeming your shares covers what you are owed, so a small discount may sit unfilled. There is no fixed threshold that guarantees a fill, because it depends on the vault's live economics at the moment it can pay.

Some vaults return liquidity a little at a time rather than all at once. For those, your order fills in slices as the vault can pay, each slice paid at the same price per share, until your position is out. For all-or-nothing vaults, an order fills in one block when the vault can cover it in full, or not at all; a partial redemption never happens.

• Read the Limit Order Protocol source on HyperEVMScan and compare it byte-for-byte against 1inch's public repository.
• Inspect the order before you sign: check the maker, the assets, the payout, and the allowed sender in your wallet's signing view.
• Confirm the allowance you grant is to the Limit Order Protocol and no one else.
• Read the vault on its explorer to see how much of the underlying it holds right now.

If your protocol has depositors who cannot withdraw, whether from a paused vault, an illiquid market, or a wind-down, Sooner will build the integration for you.

• Building the integration is free. We do the work, on our side, at our cost.
• We are paid only when a user actually gets their money out. There is no retainer, no minimum, and nothing is invoiced to you.
• Your users are never asked to trust a Sooner contract with custody, because the mechanism above never gives us any.

Is Sooner custodial?

No. Your shares stay in your wallet until they are redeemed for your payout in the same transaction. There is no deposit step and no point where Sooner holds your funds.

What exactly do I approve?

One allowance, to the 1inch Limit Order Protocol, on the vault share token you are exiting. Nothing else.

Can Sooner change my payout?

No. The payout is fixed inside the order you sign. Any change produces a different order that your signature does not authorise.

What if nothing is ever recovered?

You pay nothing. The fee is the discount you set, taken only out of recovered funds. If the order never fills, it costs you nothing to have signed it.

Which chains are supported?

HyperEVM (chain id 999) today. More chains are added as vaults are onboarded.

Can I cancel?

Yes, at any time, by revoking the allowance or letting the order expire. No involvement from Sooner is needed.