@continuumdao/ctm-mpc-defi 0.2.5 → 0.2.6

package/dist/agent/skills/gmx/SKILL.md

@@ -0,0 +1,45 @@
+# GMX V2 (classic mode)
+
+Perpetuals on Arbitrum (42161) and Avalanche (43114) via `@gmx-io/sdk` v2 **classic** orders only.
+
+## Constraints
+
+- **No express mode** — MPC multi-sign requires on-chain calldata (`prepareOrder({ mode: "classic" })`).
+- **No subaccounts (1CT)** — incompatible with threshold MPC; executor is always `keyGen.ethereumaddress`.
+- **No spot swaps** in v1 — perps only (increase, decrease, limit, cancel).
+- Orders are **keeper-executed asynchronously** after broadcast; poll `fetchOrders` for status.
+
+## Typical agent flow
+
+1. `load_defi_protocol({ protocolId: "gmx" })`
+2. `ctm_gmx_fetch_markets({ chainId })` — pick `symbol` e.g. `ETH/USD [WETH-USDC]`; each row includes `maxLeverageLabel`
+3. `ctm_gmx_fetch_market_prices({ chainId, symbol, collateralSymbol })` — index/collateral USD mark
+4. `ctm_gmx_fetch_ohlcv({ chainId, symbol, timeframe: "15m" })` — tabular OHLCV candles (USD index)
+5. `ctm_gmx_fetch_positions({ chainId, executorAddress })` — for close flows
+6. `ctm_gmx_build_increase_multisign` or `ctm_gmx_build_decrease_multisign` with `keyGenId`, `chainId`, `purposeText`
+7. Base MPC: agree → trigger sign → broadcast
+
+## Limit orders
+
+Set `orderType: "limit"` and `triggerPriceUsdHuman` on increase/decrease builders.
+
+## Cancel
+
+Use `orderId` from `fetchOrders` with `ctm_gmx_build_cancel_multisign`.
+
+## GM liquidity (phase 2)
+
+GM pool deposit/withdraw uses **ExchangeRouter multicall** (not `prepareOrder`):
+
+1. `ctm_gmx_fetch_gm_markets({ chainId })` — GM markets + long/short collateral symbols + estimated APY
+2. `ctm_gmx_fetch_gm_apy({ chainId })` — same APY data sorted by yield (highest first)
+3. `ctm_gmx_build_gm_deposit_multisign` — approve + `multicall(sendWnt + sendTokens + createDeposit)`
+4. `ctm_gmx_build_gm_withdraw_multisign` — approve GM token + `multicall(sendWnt + sendTokens + createWithdrawal)`
+
+Keeper execution is asynchronous (same as perp orders). Execution fee is paid in native gas token via `sendWnt`.
+
+## GMX token staking (phase 2)
+
+1. `ctm_gmx_fetch_staking_power({ chainId, executorAddress })`
+2. `ctm_gmx_build_stake_gmx_multisign` — approve GMX + `RewardRouter.stakeGmx`
+3. `ctm_gmx_build_unstake_gmx_multisign` — `RewardRouter.unstakeGmx`