recover-eco-funds
Recover Legacy Eco Funds
Overview
Recover funds from a legacy Circle CLI Eco deposit without guessing intent data, refund recipients, or transaction state. The workflow is evidence-first and defaults to read-only inspection.
Legacy-only recovery: The executable recovery phases in this skill are for deposits whose already-published intent fixes
reward.creatorto the Circle SCA's API-verifiedeoaOwnerAddress. Current Gateway v2/Circle CLI deposits setrefundRecipientto the SCA and should refund directly there. For a current deposit, use the read-only status checks below, reconcile the SCA and Gateway balances, and escalate through the normal support path if necessary; do not run the legacy backing-EOA sweep.
Do not classify a deposit as legacy from its age or endpoint version alone. Decode the IntentPublished event and compare the fixed reward.creator with both the SCA and its API-verified eoaOwnerAddress:
reward.creator == eoaOwnerAddress: legacy recovery may apply after all read-only checks.reward.creator == SCA: current direct-to-SCA refund behavior; stop before the executable legacy phases.- neither: stop because the selected Circle wallet does not own the fixed refund recipient.
If there is no Eco deposit and USDC was simply sent to an Agent Wallet's backing EOA (the CLI reports "Wallet not found" for that address), skip Phases 1 and 2 and go straight to Phase 3.
Use the use-circle-cli and use-agent-wallet skills first if the Circle CLI is not installed, the Terms gate is unresolved, or the agent session is invalid. Do not trigger multiple login requests: each fresh request invalidates the prior OTP.