polygon-defi
GitHubPolygon DeFi操作技能，涵盖同链代币兑换、跨链桥接及Aave/Morpho收益存入。支持通过Trails API查询收益池，默认干跑模式需加--broadcast执行，需预置钱包会话及合约地址。
Trigger Scenarios
Install
npx skills add NeverSight/learn-skills.dev --skill polygon-defi -g -y
SKILL.md
Frontmatter
{
"name": "polygon-defi",
"description": "DeFi operations on Polygon using the Polygon Agent CLI. Covers same-chain token swaps, cross-chain bridging, and yield deposits into Aave v3 and Morpho vaults via Trails earn pool discovery. All commands dry-run by default — add --broadcast to execute."
}
Polygon DeFi Skill
Session Prerequisites
Before any DeFi operation, the wallet session must include the token contracts and pool contracts. If the user does not yet have a session, or has an older session that predates this list, create one now — do not wait until a deposit fails:
polygon-agent wallet create --usdc-limit 50 \
--contract 0xc2132D05D31c914a87C6611C10748AEb04B58e8F \
--contract 0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619 \
--contract 0x781fb7f6d845e3be129289833b04d43aa8558c42 \
--contract 0xf5c81d25ee174d83f1fd202ca94ae6070d073ccf \
--contract 0x3f33f9f7e2d7cfbcbdf8ea8b870a6e3d449664c2
Aave V3 Pool (0x794a61358d6845594f94dc1db02a252b5b4814ad) is auto-whitelisted in every session — no --contract flag needed for it. The above command adds:
- USDT:
0xc2132D05D31c914a87C6611C10748AEb04B58e8F - WETH:
0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619 - Morpho Compound USDC:
0x781fb7f6d845e3be129289833b04d43aa8558c42 - Morpho Compound WETH:
0xf5c81d25ee174d83f1fd202ca94ae6070d073ccf - Morpho Compound POL:
0x3f33f9f7e2d7cfbcbdf8ea8b870a6e3d449664c2
If the user already has a session but deposit/swap calls are rejected with a permission error, re-create the session with the above command to pick up all current contracts.
Swap Tokens (Same-Chain)
# Dry-run — shows route and output amount
polygon-agent swap --from USDC --to USDT --amount 5
# Execute
polygon-agent swap --from USDC --to USDT --amount 5 --broadcast
# Custom slippage (default 0.5%)
polygon-agent swap --from USDC --to USDT --amount 5 --slippage 0.005 --broadcast
Bridge Tokens (Cross-Chain)
# Bridge USDC from Polygon to Arbitrum
polygon-agent swap --from USDC --to USDC --amount 0.5 --to-chain arbitrum --broadcast
# Bridge to other supported chains
polygon-agent swap --from USDC --to USDC --amount 1 --to-chain optimism --broadcast
polygon-agent swap --from USDC --to USDC --amount 1 --to-chain base --broadcast
polygon-agent swap --from USDC --to USDC --amount 1 --to-chain mainnet --broadcast
Valid --to-chain values: polygon, amoy, mainnet, arbitrum, optimism, base.
Query Earn Pools
Use getEarnPools to discover live yield opportunities across protocols before deciding where to deposit.
HTTP
curl --request POST \
--url https://trails-api.sequence.app/rpc/Trails/GetEarnPools \
--header 'Content-Type: application/json' \
--data '{"chainIds": [137]}'
All request fields are optional — omit any you don't need to filter on.
| Field | Type | Description |
|---|---|---|
chainIds |
number[] |
Filter by chain (e.g. [137] for Polygon mainnet) |
protocols |
string[] |
Filter by protocol name, e.g. ["Aave"], ["Morpho"] |
minTvl |
number |
Minimum TVL in USD |
maxApy |
number |
Maximum APY (useful to exclude outlier/at-risk pools) |
Fetch (agent code)
The API key is the project access key already available to the agent (SEQUENCE_PROJECT_ACCESS_KEY).
const res = await fetch('https://trails-api.sequence.app/rpc/Trails/GetEarnPools', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ chainIds: [137] }),
});
const { pools } = await res.json();
Response Schema
interface GetEarnPoolsResponse {
pools: EarnPool[];
timestamp: string; // ISO-8601 fetch time
cached: boolean;
}
interface EarnPool {
id: string; // "{protocol}-{chainId}-{address}"
name: string; // e.g. "USDC Market"
protocol: string; // "Aave" | "Morpho"
chainId: number;
apy: number; // annualised yield as a percentage (e.g. 2.8 = 2.8% APY — NOT a decimal fraction)
tvl: number; // USD
token: PoolTokenInfo;
depositAddress: string; // contract to approve/send to
isActive: boolean;
poolUrl?: string;
protocolUrl?: string;
wrappedTokenGatewayAddress?: string; // non-null for Aave native-token markets
}
interface PoolTokenInfo {
symbol: string;
name: string;
address: string;
decimals: number;
logoUrl?: string;
}
Tip:
wrappedTokenGatewayAddressis set on Aave markets that accept a wrapped native token (WPOL, WETH). Pass this address instead ofdepositAddresswhen depositing POL/ETH directly.
Deposit to Earn Yield
Pool discovery uses TrailsApi.getEarnPools — picks the most liquid pool (highest TVL) for the asset on the requested chain. No hardcoded addresses — the pool is resolved at runtime. Supported chains: Polygon, Base, Arbitrum, Optimism, Ethereum mainnet (any chain Trails indexes).
Gas requirement: The wallet needs POL for gas, or a session created with --usdc-limit to enable USDC paymaster. If the wallet has no POL, create the session with --usdc-limit 50. The CLI always reserves 0.1 USDC for gas — never deposit the full balance. If the requested amount would leave less than 0.1 USDC, the CLI auto-reduces the deposit and prints a note.
Session setup: The wallet session must whitelist the token contract and the pool deposit contract, or the relay will reject the transaction with a 400 error. Run a dry-run first to get the exact addresses, then create (or re-create) the session with both contracts:
# 1. Dry-run to discover the token address and pool depositAddress
polygon-agent deposit --asset USDC --amount 1
# 2. Create session with those contracts whitelisted (prevents 400 permission error on broadcast)
polygon-agent wallet create --usdc-limit 50 --contract <tokenAddress> --contract <depositAddress>
# 3. Broadcast
polygon-agent deposit --asset USDC --amount 1 --broadcast
Omitting --contract for the deposit pool is the most common cause of a "Request aborted" (code 1005) error on broadcast.
# Dry-run — shows pool name, APY, TVL, and deposit address before committing
polygon-agent deposit --asset USDC --amount 0.3
# Execute — deposits into the highest-TVL active pool
polygon-agent deposit --asset USDC --amount 0.3 --broadcast
# Filter by protocol
polygon-agent deposit --asset USDC --amount 0.3 --protocol aave --broadcast
polygon-agent deposit --asset USDC --amount 0.3 --protocol morpho --broadcast
Supported Protocols
| Protocol | Encoding | Description |
|---|---|---|
| Aave v3 | supply(asset, amount, onBehalfOf, referralCode) |
Lending pool deposit |
| Morpho | deposit(assets, receiver) — ERC-4626 |
Vault deposit |
Vault/pool addresses are resolved dynamically from Trails — they are not hardcoded. The dry-run output includes depositAddress so you can inspect the exact contract before broadcasting.
Withdraw (Aave aToken or ERC-4626 vault)
Pass the position token you hold: an Aave aToken address, or a Morpho / ERC-4626 vault (share) address. The CLI resolves the Aave Pool via POOL() on the aToken, or uses redeem on the vault. Dry-run by default.
# Full exit from an Aave position (aToken from balances output)
polygon-agent withdraw --position 0x68215b6533c47ff9f7125ac95adf00fe4a62f79e --amount max --chain mainnet
# Partial Aave withdraw (underlying units, e.g. USDC)
polygon-agent withdraw --position <aToken> --amount 0.5 --chain mainnet --broadcast
# ERC-4626: max redeems all shares; partial amount is underlying units (convertToShares)
polygon-agent withdraw --position <vault> --amount max --chain polygon --broadcast
Whitelist the pool (Aave) or vault contract on the session if the wallet rejects the call (polygon-agent wallet create --contract <poolOrVault>).
Same chain as the transaction: if you use withdraw --chain mainnet, create or refresh the session with wallet create --chain mainnet (not only Polygon defaults). Include --contract for the pool and for the underlying ERC-20 on that chain (e.g. mainnet USDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) so fee / helper transfers are allowed. Tight --usdc-limit can block those — omit or relax for yield exits.
Session Whitelisting
If the deposit is rejected with a session permission error, both the token contract and the pool deposit contract must be whitelisted in the session:
# 1. Dry-run first — output includes both addresses under `transactions[0].to` (token) and `depositAddress` (pool)
polygon-agent deposit --asset USDC --amount 0.3
# → note the token contract address (e.g. USDC: 0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359)
# → note the depositAddress (e.g. Aave V3: 0x794a61358d6845594f94dc1db02a252b5b4814ad)
# 2. Re-create wallet session with BOTH contracts whitelisted
polygon-agent wallet create --contract <tokenAddress> --contract <depositAddress>
# 3. Retry
polygon-agent deposit --asset USDC --amount 0.3 --broadcast
Contracts auto-whitelisted in every session (no --contract flag needed):
- USDC:
0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359 - USDC.e:
0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 - Aave V3 Pool:
0x794a61358d6845594f94dc1db02a252b5b4814ad
Yield Vault Contract Whitelist
Polygon Mainnet (chainId 137)
| Protocol | Asset | Address |
|---|---|---|
| Aave V3 Pool (all markets) | USDC, USDT, WETH, WMATIC… | 0x794a61358d6845594f94dc1db02a252b5b4814ad |
| Morpho Compound USDC | USDC | 0x781fb7f6d845e3be129289833b04d43aa8558c42 |
| Morpho Compound WETH | WETH | 0xf5c81d25ee174d83f1fd202ca94ae6070d073ccf |
| Morpho Compound POL | POL | 0x3f33f9f7e2d7cfbcbdf8ea8b870a6e3d449664c2 |
Full DeFi Flow Example
# 1. Check balances
polygon-agent balances
# 2. Swap POL → USDC
polygon-agent swap --from POL --to USDC --amount 1 --broadcast
# 3. Deposit USDC into highest-TVL yield pool
polygon-agent deposit --asset USDC --amount 1 --broadcast
# → protocol: morpho (or aave, whichever has highest TVL at the time)
# → poolApy shown in dry-run output
# 4. Bridge remaining USDC to Arbitrum
polygon-agent swap --from USDC --to USDC --amount 0.5 --to-chain arbitrum --broadcast
wallet create — Key Options
| Flag | Purpose |
|---|---|
--usdc-limit <amt> |
Enable USDC gas paymaster. Required when the wallet has no POL. Recommended: --usdc-limit 50. |
--contract <addr> |
Whitelist an additional contract (repeatable). Use this if a deposit is rejected due to a missing contract permission. |
# New session with USDC gas enabled
polygon-agent wallet create --usdc-limit 50
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
Insufficient <token>: wallet has X |
Balance too low for the requested deposit amount | Run polygon-agent balances and adjust --amount |
Wallet has no POL for gas |
No native gas and no USDC paymaster | Fund with POL (polygon-agent fund) or re-create session with --usdc-limit 50 |
Transaction rejected by relay |
Session permissions missing for pool or token contract | Re-create with --contract <tokenAddress> --contract <depositAddress> |
Unable to pay gas |
No usable fee token found | Fund with POL or add --usdc-limit 50 to session |
Protocol X not yet supported |
Trails returned a protocol other than aave/morpho | Use polygon-agent swap to obtain the yield-bearing token manually |
swap: no route found |
Insufficient liquidity for the pair | Try a different amount or token pair |
Version History
- e0220ca Current 2026-07-05 20:36
