@continuumdao/ctm-mpc-defi 0.2.7 → 0.2.8

package/dist/agent/skills/_shared/multisign-mcp-gas.md

@@ -0,0 +1,20 @@
+## Gas and MCP submit (all `build_*_multisign` tools)
+
+All `ctm_*_build_*_multisign` tools **build, sign the management envelope, and POST** `/multiSignRequest`. They return **`{ requestId }`** — that is success. **Do not call the same build tool again** unless the user explicitly wants a new order; use `list_sign_requests` to verify pending requests.
+
+Before creating, call `get_multi_sign_gas_options({ chainId })` when gas preference is unclear:
+
+| Setting | Meaning |
+|---------|---------|
+| `useCustomGas: false` | Live RPC fee estimates at proposal time (default) |
+| `useCustomGas: true` | Chain registry Custom Gas Config — **empty or omitted `baseFee` / `priorityFee` is valid** (live RPC used at proposal; configured values are optional floors/multipliers) |
+
+- **`proposalTxParams`** on the sign request records gas limit and fee snapshot at create time.
+- **Get Sig** (`trigger_sign_result`) refreshes fees via `feeSpeedTier` (default from `defaultGetSigFeeSpeed`).
+
+### After submit (`{ requestId }`)
+
+1. `wait_for_sign_request_ready` (if needed)
+2. `sign_request_agree` (multi-agree)
+3. `trigger_sign_result`
+4. `broadcast_sign_result`

package/dist/agent/skills/aave-v4/SKILL.md

@@ -105,13 +105,6 @@ For **withdraw**, **borrow**, and **repay**, the server calls the Aave v4 previe
 
 Set `skipHealthPreview: true` only when the user explicitly accepts skipping simulation (not recommended).
 
-## After submit (`{ requestId }`)
-
-1. `wait_for_sign_request_ready` (if needed)
-2. `sign_request_agree` (multi-agree)
-3. `trigger_sign_result`
-4. `broadcast_sign_result`
-
 ## Example: deposit 0.001 ETH on Ethereum
 
 ```json

package/dist/agent/skills/curve-dao/SKILL.md

@@ -109,13 +109,6 @@ Ethereum (1), Optimism (10), BSC (56), Gnosis (100), Polygon (137), Sonic (146),
 }
 ```
 
-## After submit (`{ requestId }`)
-
-1. `wait_for_sign_request_ready` (if needed)
-2. `sign_request_agree` (multi-agree)
-3. `trigger_sign_result`
-4. `broadcast_sign_result`
-
 ## Troubleshooting
 
 | Symptom | Likely cause |

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

@@ -7,4 +7,4 @@ description: Ethena USDe stake, redeem, cooldown, and claim on Ethereum mainnet.
 
 Stake/redeem MCP tools target **mainnet (chainId 1)**. Use `get_defi_protocol_supported_tokens` for USDe/sUSDe addresses.
 
-Tools: `ctm_ethena_build_stake_multisign`, `_redeem_`, `_cooldown_`, `_claim_`.
+Tools: `ctm_ethena_build_stake_multisign`, `_redeem_`, `_cooldown_`, `_claim_`. Each returns `{ requestId }` on success (shared gas/submit section appended by the server).

package/dist/agent/skills/euler-v2/SKILL.md

@@ -7,4 +7,4 @@ description: Euler v2 isolated lend/borrow, vault withdraw, and collateral opera
 
 Supported chains from `get_defi_protocol_supported_chains` (subgraph map). Pass `vault` and asset addresses from Euler UI.
 
-Tools include isolated lend/borrow, collateral deposit/withdraw, vault withdraw, borrow repay.
+Tools include isolated lend/borrow, collateral deposit/withdraw, vault withdraw, borrow repay. All `ctm_euler_v2_build_*_multisign` tools return `{ requestId }` on success (shared gas/submit section appended by the server).

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

@@ -16,13 +16,32 @@ Perpetuals on Arbitrum (42161) and Avalanche (43114) via `@gmx-io/sdk` v2 **clas
 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
+6. `get_multi_sign_gas_options({ chainId })` — confirm `useCustomGas` with the user
+7. `ctm_gmx_build_increase_multisign` or `ctm_gmx_build_decrease_multisign` with `keyGenId`, `chainId`, `purposeText`, `useCustomGas` → **`{ requestId }`**
+8. Base MPC lifecycle (see shared gas/submit section below)
 
 ## Limit orders
 
 Set `orderType: "limit"` and `triggerPriceUsdHuman` on increase/decrease builders.
 
+Example short limit on Arbitrum (ETH/USDC collateral):
+
+```json
+{
+  "keyGenId": "<keygen-id>",
+  "chainId": 42161,
+  "purposeText": "GMX short ETH limit at 1750 USDC",
+  "useCustomGas": false,
+  "symbol": "ETH/USD [WETH-USDC]",
+  "direction": "short",
+  "orderType": "limit",
+  "triggerPriceUsdHuman": "1750",
+  "sizeUsdHuman": "200",
+  "collateralAmountHuman": "50",
+  "collateralSymbol": "USDC"
+}
+```
+
 ## Cancel
 
 Use `orderId` from `fetchOrders` with `ctm_gmx_build_cancel_multisign`.
@@ -43,3 +62,11 @@ Keeper execution is asynchronous (same as perp orders). Execution fee is paid in
 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`
+
+## Troubleshooting
+
+| Symptom | Likely cause |
+|---------|----------------|
+| Agent says custom gas "will fail" without baseFee | Wrong — empty registry fees are valid; use `get_multi_sign_gas_options` |
+| Multiple duplicate sign requests | Retried `ctm_gmx_build_*` after `{ requestId }` — do not retry on success |
+| Order pending after broadcast | Normal — GMX keeper executes asynchronously |

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

@@ -19,4 +19,4 @@ Mainnet only (`chainId: 1`). Use `get_defi_protocol_supported_chains` and confir
 | Wrap stETH → wstETH | `ctm_lido_build_wrap_steth_multisign` |
 | Unwrap wstETH | `ctm_lido_build_unwrap_wsteth_multisign` |
 
-Complete flow with base MCP: `trigger_sign_result` → `broadcast_sign_result`.
+All `ctm_lido_build_*_multisign` tools return `{ requestId }` on success (shared gas/submit section appended by the server).

package/dist/agent/skills/maple-syrup/SKILL.md

@@ -7,4 +7,4 @@ description: Maple Syrup pool deposit and redeem request flows.
 
 Chains: mainnet and Sepolia. Pass `syrupRouter`, `pool`, and `asset` from Maple UI/GraphQL.
 
-Tools: `ctm_maple_build_deposit_multisign`, `ctm_maple_build_request_redeem_multisign`.
+Tools: `ctm_maple_build_deposit_multisign`, `ctm_maple_build_request_redeem_multisign`. Each returns `{ requestId }` on success (shared gas/submit section appended by the server).

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

@@ -7,4 +7,4 @@ description: Sky Lockstake and sUSDS deposit/redeem on Ethereum mainnet.
 
 Mainnet only. Tools for Lockstake stake/draw/wipe/close/reward and sUSDS deposit/redeem.
 
-Use `get_defi_protocol_supported_chains` and base registry for USDS/SKY addresses.
+Use `get_defi_protocol_supported_chains` and base registry for USDS/SKY addresses. All `ctm_sky_build_*_multisign` tools return `{ requestId }` on success (shared gas/submit section appended by the server).

package/dist/agent/skills/uniswap-v4/SKILL.md

@@ -138,13 +138,6 @@ Use the same `swapTransactionDeadlineUnix` in step 2 and `swapDeadlineUnix` in s
 - **On-chain batch** may add approve headroom; for `EXACT_OUTPUT`, optional `slippagePercent` on build adjusts approval sizing.
 - Explain expected input/output from quote JSON before submitting the sign request.
 
-## After submit (`{ requestId }`)
-
-1. `wait_for_sign_request_ready` (if needed)
-2. `sign_request_agree` (multi-agree)
-3. `trigger_sign_result`
-4. `broadcast_sign_result`
-
 ## Troubleshooting
 
 | Symptom | Likely cause |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@continuumdao/ctm-mpc-defi",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "Continuum MPC DeFi protocol library — multiSignRequest builders for EVM and future chain categories",
   "repository": {
     "type": "git",