ClaimYourETH

1. Abstract

ClaimYourETH is a non-custodial recovery protocol that finds and returns forgotten on-chain value across Ethereum, Base, Arbitrum and Robinhood Chain. One scan uncovers seven categories of dormant assets — wrapped ETH, live bonding-curve positions, Uniswap V2 liquidity positions, uncollected Uniswap V3 fees, Pons creator fees, ERC-20 dust and stale approvals — plus informational surfaces for yield vaults, NFTs and airdrop eligibility. Recovery executes as batched, user-signed transactions preceded by an on-chain dry-run that predicts per-call success before any signature is requested.

2. The Problem

Every ERC-20 trade leaves value behind. Routers return change as WETH instead of ETH; bonding-curve launches leave positions and fees; liquidity provision leaves LP tokens and uncollected fees; every DEX interaction leaves standing approvals. Industry analyses report tens of millions of dollars in unclaimed tokens across smart wallets. This value is fragmented across chains, protocols and years of history — invisible to the owner, too small individually to chase manually, and unaddressed by dashboards that show positions but never execute recovery.

3. The Solution

A single scan that walks the wallet's full on-chain history — optionally back to chain genesis via Deep Scan — classifies every finding, values it, and stages recovery in as few signed transactions as technically possible. The user reviews a plain-language plan; a dry-run simulates it against the live chain; every transfer is visible before signing. Nothing custodial: no accounts, no deposits, no seed phrases — the tool builds transactions, the user's wallet executes them.

4. Recovery Categories

Wrapped ETH — unwrapped 1:1 into spendable native ETH, across all four chains.

Curve positions — live bonding-curve holdings sold back for their quote asset.

Uniswap V2 LP positions — exited in-batch; both underlying assets return to the owner.

Uniswap V3 fees — positionsOwed read directly from the canonical PositionManager and collected in the same batch.

Pons creator fees — launch trading fees accrued in the Pons V2 fee escrow, claimed via its permissionless claim().

Dead ERC-20 dust — burned to the dead address at the user's explicit, unselected-by-default choice.

Stale approvals — revoked in bulk, free apart from gas.

Informational: ERC-4626 yield vault shares surfaced with live underlying value; forgotten NFT holdings; retroactive airdrop radar.

5. Architecture

Client-side scanning: Transfer, Approval and protocol events are walked from public RPCs with adaptive chunking per chain's limits, nonce-pruning for dormant wallets, and curated-token fallbacks for older holdings. Contract reads batch through Multicall3.

Transaction planning: pure builders construct the exact payloads the user will sign — sells, LP exits, V3 collects, burns, revokes and donations in one aggregate. Unwraps execute as direct transactions to keep native ETH with the user.

Dry-run: before signing, each planned transaction is simulated via eth_call; multicall results decode per-call success flags, predicting scam-token failures in advance.

Privacy: Whale Mode strips wallet and transaction hashes from all public surfaces (ticker, leaderboards, API) while still counting claims in totals. The WETH watcher stores watchlists exclusively in browser local storage.

6. Fee Model

Scanning, results, revokes and burns are free. Recovery of WETH includes a 10% donation from the recovered amount, shown to the cent before signing. LP exits and V3 fee collections contribute 5% of their WETH-side. A referral program pays 30% of every donation to the referring wallet, settled inside the same transaction — instantly, on-chain, verifiable by anyone.

Fees are transparent by design: every donation is a visible transfer in the user's own transaction, and the public ledger records total recovered value.

7. Chains

Ethereum mainnet, Base, Arbitrum and Robinhood Chain — with per-chain walk tuning for public RPC limits. Robinhood Chain receives Pons-specific enrichment: curve states, graduation tracking and the creator-fee escrow integration reverse-engineered from its bytecode.

8. Roadmap

Gasless recovery via EIP-7702 delegation. Vesting and streaming claims (Sablier-style). Protocol reward collection (lending and staking incentives). Intent-based execution with competitive solvers. A native token with fee-reduction utility for holders, launched when network usage justifies it.

9. Disclaimer

ClaimYourETH is a self-custody tool, not a financial service. Nothing here is financial or tax advice. ClaimYourETH is an independent project, not affiliated with Robinhood Markets, the Ethereum Foundation, Coinbase or Uniswap Labs. Blockchain transactions are irreversible; users sign every action.