Arb recapture and Black Whale

Arb recapture (ArbExecutor)

Each market can have one reference pool (another Uniswap v4 pool of the same two tokens), set through the timelock. execute(id, zeroForOne, amountIn, minProfit) swaps through our market and back through the reference pool in one PoolManager unlock (flash accounting, no capital) and reverts unless it ends with at least minProfit. Anyone may call it; the profit never goes to the caller:

• 50% is donated at once to the market's in-range liquidity providers (in the same transaction);
• 20% goes to the market's Black Whale pot;
• the rest is the market's revenue (RevenueRouter).

The keeper checks every route every 15 seconds, sizes the trade by simulating the real call and sends it only when the profit is at least three times the gas. Outside bots still compete for the same gaps.

Black Whale (BlackWhale)

Each UTC day, the biggest buy of a market's base token (quote token paid in) is its Black Whale. The prize comes from the market's pot (arb profit and treasury top-ups, never a fee) and is capped twice:

prize ≤ 50% of the pot    and    prize ≤ 90% of the protocol fee the winning buy paid

The cap uses the protocol fee because nobody gets it back: a buyer who also holds the liquidity the buy goes through earns that liquidity's LP fee back, so a cap on the LP fee would let them win at a profit. Because the prize is always below a fee they lose, buying only to win never pays. The winner is the address that sent the winning transaction (team wallets and the keeper never win). After the day ends the publisher posts the award (within 3 days; older days lapse); anyone can pay it out 24 hours later, and until then the guardian can cancel a wrong one. No admin can withdraw a pot. Prize promotions are not offered where they are prohibited.