recover-eco-funds
Recover USDC from a legacy Circle CLI Gateway --method eco deposit whose fixed refund recipient is the SCA's backing EOA. Use this skill for legacy Eco intents that are stuck, expired, waiting for refund, refunded to eoaOwnerAddress, missing from Gateway, or need a permissionless self-refund. Do not use its executable recovery phases for current Gateway v2 deposits, which set refundRecipient to the SCA. It covers calling Eco's Portal refund(...) with exact onchain intent data, then moving refunded USDC from the backing EOA to the linked SCA with ERC-3009, relayed by the SCA so the backing EOA needs no gas.
Pinned to revision 4e8964e24a5a, so it is the text this page describes rather than whatever the author pushed since.
Pre-approved tools experimental
Experimental field. Support varies between clients, so this list is what the author declared, not what your client will enforce.
- Read
- Bash(mkdir -p ./eco-recovery-evidence)
- Bash(circle --version)
- Bash(circle wallet status --output json)
- Bash(circle gateway deposit --help)
- Bash(circle wallet execute --help)
- Bash(circle contract query --help)
- Bash(circle wallet list --chain * --type agent --output json)
- Bash(circle wallet balance --address * --chain * --output json)
- Bash(circle gateway balance --address * --chain * --output json)
- Bash(circle transaction list --address * --chain * --operation transfer --tx-type outbound --state confirmed --output json)
- Bash(curl -fsS "https://api.eco.com/circle-gateway/v2/depositAddresses/*")
- Bash(curl -fsS --request POST --url https://quotes.eco.com/api/v3/intents/intentStatus --header "Content-Type: application/json" --data '{"intentHash":"*"}')
- Bash(curl -fsS --request POST --url https://quotes.eco.com/api/v3/intents/intentStatus --header "Content-Type: application/json" --data '{"intentCreatedHash":"*"}')
- Bash(*/node_modules/.bin/tsx */scripts/eco-self-refund.mjs *)
- Bash(*/node_modules/.bin/tsx */scripts/eoa-to-sca.mjs *)
Files
- skills/recover-eco-funds/SKILL.md
- skills/recover-eco-funds/references/eoa-to-sca.md
- skills/recover-eco-funds/references/self-refund.md
- skills/recover-eco-funds/scripts/_shared.mjs
- skills/recover-eco-funds/scripts/eco-self-refund.mjs
- skills/recover-eco-funds/scripts/eoa-to-sca.mjs
Every link opens the file at its source, pinned to the revision this page describes.