@continuumdao/ctm-mpc-defi 0.2.16 → 0.2.17

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

@@ -14,7 +14,10 @@ Before creating, call `get_multi_sign_gas_options({ chainId })` when gas prefere
 
 ### 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`
+Stop here unless the user asks to continue. **Do not** call `wait_for_sign_request_ready` — Join agreement (`sign_request_agree` on peers) may take **days**.
+
+When proceeding (user request or workflow, after quorum):
+
+1. `sign_request_agree` (multi-party Join)
+2. `trigger_sign_result` (originator Get Sig)
+3. `broadcast_sign_result`

package/dist/agent/skills/circle-cctp/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: circle-cctp
+description: Circle CCTP V2 cross-chain native USDC via Forwarding Service and Continuum MPC multisign.
+---
+
+# Circle CCTP (MCP)
+
+Cross-chain **native USDC** via Circle **CCTP V2** and the **Forwarding Service**. The MPC wallet signs **one source-chain batch** (`USDC.approve` + `TokenMessengerV2.depositForBurnWithHook` with `cctp-forward` hook data). Circle attests and submits the **destination mint** — no second sign request, no destination native gas from the KeyGen address.
+
+## Before any transfer
+
+1. `load_defi_protocol({ protocolId: "circle-cctp" })`
+2. `get_defi_protocol_skill`
+3. `get_chain_registry` — source chain needs `rpcGateway`
+4. `get_token_registry` — locate USDC on source chain
+
+## Tool flow
+
+| Step | Tool | Creates sign request? |
+|------|------|------------------------|
+| 1. Routes | `ctm_cctp_fetch_supported_routes` | No |
+| 2. Fees | `ctm_cctp_fetch_burn_fees` | No — **required before build** |
+| 3. Balance | `ctm_cctp_fetch_usdc_balance` | No — pre-check USDC ≥ transfer + maxFee |
+| 4. Submit | `ctm_cctp_build_burn_multisign` | Yes → `{ requestId, fees }` |
+| 5. (optional) Status | `ctm_cctp_fetch_transfer_status` | No — after source burn Execute |
+
+After `{ requestId }`: `sign_request_agree` → `trigger_sign_result` → `broadcast_sign_result`. **Do not** retry build on success. Fees refresh again at **trigger** on the node app.
+
+## `ctm_cctp_fetch_burn_fees`
+
+| Field | Required | Notes |
+|-------|----------|-------|
+| `sourceChainId` | yes | EIP-155 id where burn executes |
+| `destChainId` | yes | EIP-155 destination (mint chain) |
+| `transferAmountHuman` | no | USDC recipient receives (6 decimals); include for `totalBurn` / `totalBurnHuman` |
+| `feeTier` | no | `low` \| `med` (default) \| `high` |
+
+Returns `fees` object plus top-level fee fields: `maxFeeHuman`, `forwardFeeLowHuman` / `Med` / `High`, optional `totalBurnHuman`, and `feeSummary`. Pass the full output as `feeSnapshot` to build and balance tools.
+
+## `ctm_cctp_fetch_usdc_balance`
+
+Optional `transferAmountHuman` + `feeSnapshot` (from fetch_burn_fees) returns `requiredTotalBurnHuman`, `sufficientForTransfer`, and `feeSummary`.
+
+## `ctm_cctp_build_burn_multisign`
+
+| Field | Required | Notes |
+|-------|----------|-------|
+| `keyGenId` | yes | MPC KeyGen |
+| `chainId` | yes | **Source** chain (same as fee quote) |
+| `destChainId` | yes | Destination chain |
+| `purposeText` | yes | Human-readable purpose |
+| `transferAmountHuman` | yes | Same as fee quote |
+| `mintRecipient` | no | Destination address; default executor |
+| `feeSnapshot` | no | Pass `ctm_cctp_fetch_burn_fees` output |
+| `useCustomGas` | no | Chain registry custom gas |
+
+Returns `{ requestId, fees }` — `fees` echoes the proposed Forwarding Service max fee and total burn.
+
+## Important
+
+- **chainId** on build = **source** chain, not destination.
+- Manual `receiveMessage` on destination is **out of scope** — Forwarding Service only.
+- Solana/non-EVM recipients: follow Circle docs for `mintRecipient` encoding; UI v1 is EVM-only.