@continuumdao/ctm-mpc-defi 0.2.55 → 0.2.56

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

@@ -32,10 +32,11 @@ After `{ requestId }`: `sign_request_agree` → `trigger_sign_result` → `broad
 |-------|----------|-------|
 | `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` |
+| `transferAmountHuman` | yes for a usable maxFee | USDC the recipient receives (6 decimals). Protocol fee is this amount times Iris `minimumFee` bps. Omit only to inspect raw forwarding tiers. |
 | `feeTier` | no | `low` \| `med` (default) \| `high` |
+| `minFinalityThreshold` | no | `1000` fast (default, has protocol fee) or `2000` standard |
 
-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.
+`maxFee = forwardFee[tier] + protocolFee`. `forwardFee*` is the Forwarding Service component only. `maxFeeLow` / `Med` / `High` are the combined caps. Returns `fees` plus the same fields at the top level, including `protocolFeeHuman`, `minimumFeeBps`, and `totalBurnHuman` when an amount was passed. Pass that output as `feeSnapshot` to build and balance tools. Do not add `minimumFee` again on top of `maxFee`.
 
 ## `ctm_cctp_fetch_usdc_balance`
 
@@ -51,10 +52,10 @@ Optional `transferAmountHuman` + `feeSnapshot` (from fetch_burn_fees) returns `r
 | `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 |
+| `feeSnapshot` | no | Pass `ctm_cctp_fetch_burn_fees` output. Build re-quotes Iris. A snapshot `maxFee` below the live forward+protocol total is raised; a higher snapshot is kept. |
 | `useCustomGas` | no | Chain registry custom gas |
 
-Returns `{ requestId, fees }` — `fees` echoes the proposed Forwarding Service max fee and total burn.
+Returns `{ requestId, fees }` — `fees.maxFee` is the forwarding tier plus the protocol fee, and `totalBurn` is the recipient amount plus that max fee.
 
 ## Important
 

package/dist/agent/skills/continuum-dao-marketplace/SKILL.md

@@ -32,14 +32,14 @@ If the user already said how to order them, pass that on the first search:
 
 If they only said they want to buy a veCTM, ask once which of those they want, then search. Do not fetch the raw book first.
 
-`kind` defaults to listings, which is an immediate buy. Use `auction` or `both` only when they want to bid. Pass `executor` (the KeyGen) so veCTMs this address already sells are left out. An attached KeyGen comes back with `fillable: false`; do not offer to buy it. After they pick a token id, build the fulfill-listing or auction-bid multisign.
+`kind` defaults to listings, which is an immediate buy. Use `auction` or `both` only when they want to bid. Pass `executor` (the KeyGen). A listing that address already sells comes back with `action: "delist"` and `fillable: false`. Call `ctm_continuum_dao_marketplace_build_delist_multisign` for that row. Do not buy it. An attached KeyGen comes back with `fillable: false`; do not offer to buy it. After they pick someone else's token id, build the fulfill-listing or auction-bid multisign.
 
 ## Catalog
 
 Prefer `https://app-api.continuumdao.org/marketplace`. If that API fails, the same tools replay marketplace logs from block 32100001 and say `source: "logs"`.
 
 - `ctm_continuum_dao_marketplace_search` — the ranked short list for a buy. It walks catalog pages. `fetch_listings` does not.
-- `ctm_continuum_dao_marketplace_fetch_auctions` — live auctions (`Pending`, `Active`, `Complete`). Set `includeInactive` for sold, canceled, and expired. Every auction includes `bids` (bidder, price, tx, time).
+- `ctm_continuum_dao_marketplace_fetch_auctions` — live auctions. `derivedStatus` is `Active` while the deadline is still ahead, including when no bid has met the reserve. `storedStatus` stays `Pending` until a qualifying bid, then `Active`. `Complete` still needs settle. Set `includeInactive` for sold, canceled, and expired. Every auction includes `bids` (bidder, price, tx, time). Cancel is still allowed while `storedStatus` is `Pending` and no bid has reached the reserve.
 - `ctm_continuum_dao_marketplace_fetch_listings` / `fetch_offerings` — unfiltered pages in created order, with `nextCursor`. `includeInactive` is the past-sales list. A fulfilled listing is a completed sale.
 - `ctm_continuum_dao_marketplace_fetch_token` — one veCTM, including `history` of closed listings, offerings, and auctions.
 - `ctm_continuum_dao_marketplace_fetch_activity` — one address as seller, buyer, or bidder.
@@ -49,10 +49,10 @@ Prefer `https://app-api.continuumdao.org/marketplace`. If that API fails, the sa
 
 Builders are the same functions the node app calls. They preflight on-chain. Do not prepend billing legs.
 
-Refuse a buy, an offering, or an auction bid when this KeyGen already owns the veCTM (`ownerOf`) or is the listing or auction seller. A live auction escrows the NFT in the marketplace, so the seller check is what blocks bidding on your own auction.
+Refuse a buy, an offering, or an auction bid when this KeyGen already owns the veCTM (`ownerOf`) or is the listing or auction seller. When the KeyGen is the listing seller, delist that listing. A live auction escrows the NFT in the marketplace, so the seller check is what blocks bidding on your own auction.
 
 WETH orders send `msg.value` equal to the price or bid. Other payment tokens approve the marketplace for the amount. `createOffering` with WETH still approves WETH, because the contract wraps ETH back to the buyer and the seller pulls WETH later.
 
-Creating a listing or auction approves the marketplace for that token id when it is not already approved. Auctions escrow the NFT. An attached KeyGen cannot be auctioned or used to accept an offering.
+Creating a listing or auction approves the marketplace for that token id when it is not already approved. Auctions escrow the NFT. An attached KeyGen cannot be listed, offered on, or auctioned, and cannot be used to accept an offering.
 
 After `fulfillListing`, or `settleAuction` when this KeyGen is the highest bidder, add the veCTM to the node assets if it is not already there.

package/dist/protocols/evm/circle-cctp/index.cjs

@@ -228,6 +228,12 @@ function cctpSupportedRoutes(network) {
 }
 
 // src/protocols/evm/circle-cctp/fees.ts
+function cctpProtocolFeeBaseUnits(transferAmount, minimumFeeBps) {
+  if (transferAmount <= 0n || !Number.isFinite(minimumFeeBps) || minimumFeeBps <= 0) return 0n;
+  const scaledBps = BigInt(Math.round(minimumFeeBps * 100));
+  if (scaledBps <= 0n) return 0n;
+  return transferAmount * scaledBps / 1000000n;
+}
 function pickForwardFeeTier(row, tier) {
   const forwardFee = row.forwardFee;
   if (forwardFee && typeof forwardFee === "object") {
@@ -236,11 +242,25 @@ function pickForwardFeeTier(row, tier) {
     if (v != null) return BigInt(String(v));
   }
   const maxFee = row.maximumFee ?? row.maxFee ?? row.forwardFee;
-  if (maxFee != null) return BigInt(String(maxFee));
+  if (maxFee != null && typeof maxFee !== "object") return BigInt(String(maxFee));
   throw new Error("Iris fee response missing forwardFee tiers.");
 }
+function feeRows(json) {
+  if (Array.isArray(json)) return json.filter((row) => row && typeof row === "object");
+  if (json && typeof json === "object") {
+    const data = json.data;
+    if (Array.isArray(data)) return data.filter((row) => row && typeof row === "object");
+    return [json];
+  }
+  return [];
+}
+function selectCctpIrisFeeRow(rows, finalityThreshold) {
+  const match = rows.find((row) => Number(row.finalityThreshold) === finalityThreshold);
+  return match ?? rows[0] ?? {};
+}
 async function fetchCctpBurnFees(args) {
   const tier = args.feeTier ?? "med";
+  const finalityThreshold = args.minFinalityThreshold ?? CCTP_DEFAULT_MIN_FINALITY_THRESHOLD;
   const base = irisApiBaseForChainId(args.sourceChainId);
   const url = `${base}/v2/burn/USDC/fees/${args.sourceDomain}/${args.destDomain}?forward=true`;
   const res = await fetch(url, { headers: { Accept: "application/json" } });
@@ -248,20 +268,28 @@ async function fetchCctpBurnFees(args) {
     const text = await res.text().catch(() => "");
     throw new Error(`Iris fee quote failed (${res.status}): ${text.slice(0, 200)}`);
   }
-  const json = await res.json();
-  const rows = Array.isArray(json) ? json : Array.isArray(json.data) ? json.data : [json];
-  const row = rows[0] ?? {};
+  const row = selectCctpIrisFeeRow(feeRows(await res.json()), finalityThreshold);
   const low = pickForwardFeeTier(row, "low");
   const med = pickForwardFeeTier(row, "med");
   const high = pickForwardFeeTier(row, "high");
-  const maxFee = tier === "low" ? low : tier === "high" ? high : med;
+  const minimumFeeRaw = row.minimumFee;
+  const minimumFeeBps = typeof minimumFeeRaw === "number" ? minimumFeeRaw : Number(minimumFeeRaw ?? 0);
+  const transferAmount = args.transferAmount ?? 0n;
+  const protocolFee = cctpProtocolFeeBaseUnits(transferAmount, minimumFeeBps);
+  const forwardForTier = tier === "low" ? low : tier === "high" ? high : med;
   return {
     sourceDomain: args.sourceDomain,
     destDomain: args.destDomain,
-    maxFee,
+    finalityThreshold: Number(row.finalityThreshold ?? finalityThreshold),
+    minimumFeeBps: Number.isFinite(minimumFeeBps) ? minimumFeeBps : 0,
+    protocolFee,
+    maxFee: forwardForTier + protocolFee,
     forwardFeeLow: low,
     forwardFeeMed: med,
     forwardFeeHigh: high,
+    maxFeeLow: low + protocolFee,
+    maxFeeMed: med + protocolFee,
+    maxFeeHigh: high + protocolFee,
     feeTierUsed: tier
   };
 }
@@ -625,6 +653,8 @@ async function buildEvmMultisignBodyCctpBurnBatch(args) {
   const executor = viem.getAddress(args.executorAddress);
   const mintRecipient = viem.getAddress(args.mintRecipient ?? executor);
   const minFinality = args.minFinalityThreshold ?? CCTP_DEFAULT_MIN_FINALITY_THRESHOLD;
+  const transferAmountForFee = viem.parseUnits(args.transferAmountHuman.trim(), CCTP_USDC_DECIMALS);
+  if (transferAmountForFee <= 0n) throw new Error("Transfer amount must be greater than zero.");
   let maxFee = args.maxFee;
   let proposalMaxFee = args.proposalMaxFee ?? maxFee;
   if (maxFee == null) {
@@ -632,7 +662,9 @@ async function buildEvmMultisignBodyCctpBurnBatch(args) {
       sourceChainId: args.sourceChainId,
       sourceDomain: src.domain,
       destDomain: dst.domain,
-      feeTier: args.feeTier
+      feeTier: args.feeTier,
+      transferAmount: transferAmountForFee,
+      minFinalityThreshold: minFinality
     });
     maxFee = fees.maxFee;
     proposalMaxFee = fees.maxFee;
@@ -722,11 +754,22 @@ async function buildEvmMultisignBodyCctpBurnBatch(args) {
   return result;
 }
 async function buildEvmMultisignBodyCctpBurnBatchFromMcp(args) {
-  let maxFee;
-  let proposalMaxFee;
+  const src = cctpChainConfig(args.chainId);
+  const dst = cctpChainConfig(args.destChainId);
+  if (!src || !dst) throw new Error("Unsupported CCTP source or destination chain.");
+  const transferAmount = viem.parseUnits(args.transferAmountHuman.trim(), CCTP_USDC_DECIMALS);
+  const fees = await fetchCctpBurnFees({
+    sourceChainId: args.chainId,
+    sourceDomain: src.domain,
+    destDomain: dst.domain,
+    feeTier: args.feeTier,
+    transferAmount,
+    minFinalityThreshold: args.minFinalityThreshold
+  });
+  let maxFee = fees.maxFee;
   if (args.feeSnapshot?.maxFee != null) {
-    maxFee = BigInt(String(args.feeSnapshot.maxFee));
-    proposalMaxFee = maxFee;
+    const snapshotMaxFee = BigInt(String(args.feeSnapshot.maxFee));
+    if (snapshotMaxFee > maxFee) maxFee = snapshotMaxFee;
   }
   return buildEvmMultisignBodyCctpBurnBatch({
     keyGen: args.keyGen,
@@ -741,7 +784,7 @@ async function buildEvmMultisignBodyCctpBurnBatchFromMcp(args) {
     executorAddress: args.executorAddress,
     purposeText: args.purposeText,
     maxFee,
-    proposalMaxFee,
+    proposalMaxFee: maxFee,
     feeTier: args.feeTier,
     minFinalityThreshold: args.minFinalityThreshold
   });
@@ -855,14 +898,15 @@ function buildCctpMcpFeeFields(args) {
   const forwardFeeLowHuman = formatCctpUsdcHuman(fees.forwardFeeLow);
   const forwardFeeMedHuman = formatCctpUsdcHuman(fees.forwardFeeMed);
   const forwardFeeHighHuman = formatCctpUsdcHuman(fees.forwardFeeHigh);
+  const protocolFeeHuman = formatCctpUsdcHuman(fees.protocolFee);
   let totalBurn;
   let totalBurnHuman;
-  if (transferAmount != null) {
+  if (transferAmount != null && transferAmount > 0n) {
     totalBurn = transferAmount + fees.maxFee;
     totalBurnHuman = formatCctpUsdcHuman(totalBurn);
   }
-  const recipientPart = transferAmountHuman != null ? ` Recipient receives ${transferAmountHuman} USDC; wallet burns ${totalBurnHuman} USDC total (transfer + max fee).` : "";
-  const feeSummary = `Forwarding Service max fee (${fees.feeTierUsed} tier): ${maxFeeHuman} USDC.${recipientPart} Fee tiers \u2014 low: ${forwardFeeLowHuman}, med: ${forwardFeeMedHuman}, high: ${forwardFeeHighHuman} USDC. Fees refresh again at Get Sig.`;
+  const recipientPart = transferAmountHuman != null && totalBurnHuman != null ? ` Recipient receives ${transferAmountHuman} USDC; wallet burns ${totalBurnHuman} USDC total (transfer + max fee).` : " Pass transferAmountHuman so maxFee includes the fast-transfer protocol fee.";
+  const feeSummary = `CCTP max fee (${fees.feeTierUsed} tier): ${maxFeeHuman} USDC = forwarding ${formatCctpUsdcHuman(fees.feeTierUsed === "low" ? fees.forwardFeeLow : fees.feeTierUsed === "high" ? fees.forwardFeeHigh : fees.forwardFeeMed)} + protocol ${protocolFeeHuman} (${fees.minimumFeeBps} bps, finality ${fees.finalityThreshold}).${recipientPart} Combined tiers \u2014 low: ${formatCctpUsdcHuman(fees.maxFeeLow)}, med: ${formatCctpUsdcHuman(fees.maxFeeMed)}, high: ${formatCctpUsdcHuman(fees.maxFeeHigh)} USDC. Fees refresh again at Get Sig.`;
   return {
     feeTierUsed: fees.feeTierUsed,
     maxFee: fees.maxFee.toString(),
@@ -873,6 +917,16 @@ function buildCctpMcpFeeFields(args) {
     forwardFeeMedHuman,
     forwardFeeHigh: fees.forwardFeeHigh.toString(),
     forwardFeeHighHuman,
+    maxFeeLow: fees.maxFeeLow.toString(),
+    maxFeeLowHuman: formatCctpUsdcHuman(fees.maxFeeLow),
+    maxFeeMed: fees.maxFeeMed.toString(),
+    maxFeeMedHuman: formatCctpUsdcHuman(fees.maxFeeMed),
+    maxFeeHigh: fees.maxFeeHigh.toString(),
+    maxFeeHighHuman: formatCctpUsdcHuman(fees.maxFeeHigh),
+    minimumFeeBps: fees.minimumFeeBps,
+    protocolFee: fees.protocolFee.toString(),
+    protocolFeeHuman,
+    finalityThreshold: fees.finalityThreshold,
     ...transferAmount != null ? { transferAmount: transferAmount.toString() } : {},
     ...transferAmountHuman != null ? { transferAmountHuman } : {},
     ...totalBurn != null ? { totalBurn: totalBurn.toString() } : {},
@@ -970,14 +1024,16 @@ async function cctpFetchBurnFeesForRoute(args) {
   if (!src || !dst) throw new Error("Unsupported source or destination chain for CCTP.");
   if (src.network !== dst.network) throw new Error("Source and destination must be on the same network (mainnet or testnet).");
   if (src.chainId === dst.chainId) throw new Error("Source and destination must differ.");
+  const transferHuman = args.transferAmountHuman?.trim();
+  const transferAmount = transferHuman ? viem.parseUnits(transferHuman, CCTP_USDC_DECIMALS) : void 0;
   const fees = await fetchCctpBurnFees({
     sourceChainId: args.sourceChainId,
     sourceDomain: src.domain,
     destDomain: dst.domain,
-    feeTier: args.feeTier
+    feeTier: args.feeTier,
+    transferAmount,
+    minFinalityThreshold: args.minFinalityThreshold
   });
-  const transferHuman = args.transferAmountHuman?.trim();
-  const transferAmount = transferHuman ? viem.parseUnits(transferHuman, CCTP_USDC_DECIMALS) : void 0;
   const feeFields = buildCctpMcpFeeFields({
     fees,
     transferAmount,
@@ -1022,7 +1078,7 @@ var circleCctpProtocolModule = {
       id: "circle-cctp.fetch-fees",
       protocolId: CIRCLE_CCTP_PROTOCOL_ID,
       chainCategory: "evm",
-      description: "Quote Iris Forwarding Service burn fees for a route",
+      description: "Quote Iris forwarding fee plus fast-transfer protocol fee for a route",
       commonParams: [],
       params: {
         sourceChainId: { type: "number", required: true, description: "Source EIP-155 chain id" },
@@ -1071,6 +1127,7 @@ exports.cctpFetchSupportedRoutes = cctpFetchSupportedRoutes;
 exports.cctpFetchTransferStatus = cctpFetchTransferStatus;
 exports.cctpFetchUsdcBalance = cctpFetchUsdcBalance;
 exports.cctpMintRecipientAddressFromExtra = cctpMintRecipientAddressFromExtra;
+exports.cctpProtocolFeeBaseUnits = cctpProtocolFeeBaseUnits;
 exports.cctpSupportedRoutes = cctpSupportedRoutes;
 exports.chainIdToDomain = chainIdToDomain;
 exports.circleCctpProtocolModule = circleCctpProtocolModule;
@@ -1087,5 +1144,6 @@ exports.parseCctpBurnExtraJSON = parseCctpBurnExtraJSON;
 exports.parseCctpEvmChainId = parseCctpEvmChainId;
 exports.rebuildCctpBurnCalldataAtGetSig = rebuildCctpBurnCalldataAtGetSig;
 exports.resolveCctpBatchStepGasFromSignRequest = resolveCctpBatchStepGasFromSignRequest;
+exports.selectCctpIrisFeeRow = selectCctpIrisFeeRow;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map