@continuumdao/ctm-mpc-defi 0.2.48 → 0.2.49

package/dist/protocols/evm/hyperliquid/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
+var msgpack = require('@msgpack/msgpack');
 var viem = require('viem');
 var continuumNodeSdk = require('@continuumdao/continuum-node-sdk');
-var msgpack = require('@msgpack/msgpack');
 
 // src/core/registry.ts
 var modules = [];
@@ -65,6 +65,340 @@ var HYPERLIQUID_MAX_CANDLE_LIMIT = 200;
 var HYPERLIQUID_MAX_OHLCV_BARS = 2e3;
 var HYPERLIQUID_DEFAULT_LOOKBACK_DAYS = 14;
 var HYPERLIQUID_MAX_LOOKBACK_DAYS = 90;
+var EXCHANGE_DOMAIN = {
+  name: "Exchange",
+  version: "1",
+  chainId: 1337,
+  verifyingContract: "0x0000000000000000000000000000000000000000"
+};
+var AGENT_TYPES = {
+  Agent: [
+    { name: "source", type: "string" },
+    { name: "connectionId", type: "bytes32" }
+  ]
+};
+function adjustMsgpackValue(value) {
+  if (Array.isArray(value)) return value.map(adjustMsgpackValue);
+  if (typeof value === "object" && value !== null) {
+    const result = {};
+    for (const key of Object.keys(value)) {
+      const entry = value[key];
+      if (entry !== void 0) result[key] = adjustMsgpackValue(entry);
+    }
+    return result;
+  }
+  if (typeof value === "number" && Number.isInteger(value) && (value >= 4294967296 || value < -2147483648)) {
+    return BigInt(value);
+  }
+  return value;
+}
+function toUint64Bytes(n) {
+  const bytes = new Uint8Array(8);
+  new DataView(bytes.buffer).setBigUint64(0, BigInt(n));
+  return bytes;
+}
+function concatBytes(...parts) {
+  const total = parts.reduce((sum, p) => sum + p.length, 0);
+  const out = new Uint8Array(total);
+  let offset = 0;
+  for (const p of parts) {
+    out.set(p, offset);
+    offset += p.length;
+  }
+  return out;
+}
+function hexToBytes(hex) {
+  const h = hex.startsWith("0x") ? hex.slice(2) : hex;
+  const bytes = new Uint8Array(h.length / 2);
+  for (let i = 0; i < bytes.length; i++) {
+    bytes[i] = parseInt(h.slice(i * 2, i * 2 + 2), 16);
+  }
+  return bytes;
+}
+function createHyperliquidL1ActionHash(args) {
+  const { action, nonce, vaultAddress, expiresAfter } = args;
+  const actionBytes = msgpack.encode(adjustMsgpackValue(action));
+  const nonceBytes = toUint64Bytes(nonce);
+  const vaultMarker = vaultAddress ? new Uint8Array([1]) : new Uint8Array([0]);
+  const vaultBytes = vaultAddress ? hexToBytes(vaultAddress) : new Uint8Array();
+  const expiresMarker = expiresAfter !== void 0 ? new Uint8Array([0]) : new Uint8Array();
+  const expiresBytes = expiresAfter !== void 0 ? toUint64Bytes(expiresAfter) : new Uint8Array();
+  const bytes = concatBytes(actionBytes, nonceBytes, vaultMarker, vaultBytes, expiresMarker, expiresBytes);
+  return viem.keccak256(bytes);
+}
+function buildHyperliquidAgentTypedData(args) {
+  const connectionId = createHyperliquidL1ActionHash(args);
+  const source = args.isTestnet ? "b" : "a";
+  return {
+    domain: EXCHANGE_DOMAIN,
+    types: AGENT_TYPES,
+    primaryType: "Agent",
+    message: {
+      source,
+      connectionId
+    },
+    connectionId,
+    nonce: args.nonce,
+    action: args.action
+  };
+}
+function buildHyperliquidUpdateLeverageAction(args) {
+  const leverage = Math.trunc(args.leverage);
+  if (!Number.isFinite(leverage) || leverage < 1) {
+    throw new Error("leverage must be a positive integer");
+  }
+  return {
+    type: "updateLeverage",
+    asset: args.asset,
+    isCross: args.isCross !== false,
+    leverage
+  };
+}
+function parseHyperliquidBorrowLendAmount(amountHuman) {
+  if (amountHuman == null) return null;
+  const trimmed = String(amountHuman).trim();
+  if (!trimmed || trimmed.toLowerCase() === "max") return null;
+  return hyperliquidFloatToWire(trimmed);
+}
+function buildHyperliquidBorrowLendAction(args) {
+  const operation = args.operation;
+  if (operation !== "supply" && operation !== "withdraw" && operation !== "repay" && operation !== "borrow") {
+    throw new Error("operation must be supply, withdraw, repay, or borrow");
+  }
+  const token = Math.trunc(args.token);
+  if (!Number.isFinite(token) || token < 0) {
+    throw new Error("token must be a non-negative integer token index");
+  }
+  return {
+    type: "borrowLend",
+    operation,
+    token,
+    amount: args.amount
+  };
+}
+function hyperliquidFloatToWire(value) {
+  const n = typeof value === "number" ? value : Number.parseFloat(String(value).trim());
+  if (!Number.isFinite(n)) throw new Error("Invalid Hyperliquid wire number.");
+  const rounded = n.toFixed(8);
+  if (Math.abs(Number.parseFloat(rounded) - n) >= 1e-12) {
+    throw new Error(`Hyperliquid wire value ${value} has too many decimal places.`);
+  }
+  const normalized = Number(rounded === "-0" ? "0" : rounded);
+  return String(normalized);
+}
+function hyperliquidL1TifFromKey(tif) {
+  const key = String(tif ?? "gtc").trim().toLowerCase();
+  if (key === "alo") return "Alo";
+  if (key === "ioc") return "Ioc";
+  if (key === "gtc") return "Gtc";
+  throw new Error(`Unknown time-in-force: ${tif}. Use alo, gtc, or ioc.`);
+}
+function buildHyperliquidLimitOrderWire(args) {
+  return {
+    a: args.asset,
+    b: args.isBuy,
+    p: hyperliquidFloatToWire(args.limitPxHuman),
+    s: hyperliquidFloatToWire(args.szHuman),
+    r: Boolean(args.reduceOnly),
+    t: { limit: { tif: hyperliquidL1TifFromKey(args.tif) } }
+  };
+}
+function buildHyperliquidTriggerOrderWire(args) {
+  const mode = args.tpslExecMode ?? "limit_at_trigger";
+  const triggerPx = hyperliquidFloatToWire(args.triggerPxHuman);
+  const limitPx = mode === "market" ? triggerPx : hyperliquidFloatToWire(args.limitPxHuman ?? args.triggerPxHuman);
+  return {
+    a: args.asset,
+    b: args.isBuy,
+    p: limitPx,
+    s: hyperliquidFloatToWire(args.szHuman),
+    r: true,
+    t: {
+      trigger: {
+        isMarket: mode === "market",
+        triggerPx,
+        tpsl: args.tpsl
+      }
+    }
+  };
+}
+function validateHyperliquidTpslGeometry(args) {
+  const entry = Number.parseFloat(String(args.entryPxHuman).trim());
+  const tp = args.takeProfitTriggerPxHuman?.trim() != null && args.takeProfitTriggerPxHuman.trim() !== "" ? Number.parseFloat(args.takeProfitTriggerPxHuman.trim()) : null;
+  const sl = args.stopLossTriggerPxHuman?.trim() != null && args.stopLossTriggerPxHuman.trim() !== "" ? Number.parseFloat(args.stopLossTriggerPxHuman.trim()) : null;
+  if (!Number.isFinite(entry)) throw new Error("Invalid entry limit price for TP/SL validation.");
+  if (tp != null && !Number.isFinite(tp)) throw new Error("Invalid take-profit trigger price.");
+  if (sl != null && !Number.isFinite(sl)) throw new Error("Invalid stop-loss trigger price.");
+  if (args.isBuy) {
+    if (sl != null && sl >= entry) {
+      throw new Error("Long stop-loss must be below entry price.");
+    }
+    if (tp != null && tp <= entry) {
+      throw new Error("Long take-profit must be above entry price.");
+    }
+  } else {
+    if (sl != null && sl <= entry) {
+      throw new Error("Short stop-loss must be above entry price.");
+    }
+    if (tp != null && tp >= entry) {
+      throw new Error("Short take-profit must be below entry price.");
+    }
+  }
+}
+function buildHyperliquidNormalTpslOrderWires(args) {
+  validateHyperliquidTpslGeometry({
+    isBuy: args.isBuy,
+    entryPxHuman: args.limitPxHuman,
+    takeProfitTriggerPxHuman: args.takeProfitTriggerPxHuman,
+    stopLossTriggerPxHuman: args.stopLossTriggerPxHuman
+  });
+  const orders = [
+    buildHyperliquidLimitOrderWire({
+      asset: args.asset,
+      isBuy: args.isBuy,
+      limitPxHuman: args.limitPxHuman,
+      szHuman: args.szHuman,
+      tif: args.tif
+    })
+  ];
+  const closeIsBuy = !args.isBuy;
+  const tp = args.takeProfitTriggerPxHuman?.trim();
+  const sl = args.stopLossTriggerPxHuman?.trim();
+  if (tp) {
+    orders.push(
+      buildHyperliquidTriggerOrderWire({
+        asset: args.asset,
+        isBuy: closeIsBuy,
+        szHuman: args.szHuman,
+        triggerPxHuman: tp,
+        tpsl: "tp",
+        tpslExecMode: args.tpslExecMode
+      })
+    );
+  }
+  if (sl) {
+    orders.push(
+      buildHyperliquidTriggerOrderWire({
+        asset: args.asset,
+        isBuy: closeIsBuy,
+        szHuman: args.szHuman,
+        triggerPxHuman: sl,
+        tpsl: "sl",
+        tpslExecMode: args.tpslExecMode
+      })
+    );
+  }
+  return orders;
+}
+function buildHyperliquidOrderAction(args) {
+  return {
+    type: "order",
+    orders: args.orders,
+    grouping: args.grouping ?? "na"
+  };
+}
+var TRAILING_PCT_DECIMALS = 4;
+function parseHyperliquidTrailingOffsetType(value) {
+  const key = String(value ?? "percentage").trim().toLowerCase();
+  if (key === "price" || key === "px" || key === "distance") return "price";
+  if (key === "percentage" || key === "percent" || key === "pct" || key === "%") return "percentage";
+  throw new Error("trailingOffsetType must be price or percentage.");
+}
+function hyperliquidTrailingPercentToWire(value) {
+  const raw = typeof value === "number" ? String(value) : String(value).trim();
+  const stripped = raw.endsWith("%") ? raw.slice(0, -1).trim() : raw;
+  const n = Number.parseFloat(stripped);
+  if (!Number.isFinite(n) || n <= 0) {
+    throw new Error("Trailing retracement percentage must be greater than zero.");
+  }
+  return `${n.toFixed(TRAILING_PCT_DECIMALS)}%`;
+}
+function buildHyperliquidTrailingRetracement(args) {
+  const offset = String(args.offsetHuman ?? "").trim();
+  if (!offset) throw new Error("trailingOffsetHuman is required.");
+  if (args.offsetType === "percentage") {
+    return { pct: hyperliquidTrailingPercentToWire(offset) };
+  }
+  const px = hyperliquidFloatToWire(offset);
+  if (Number.parseFloat(px) <= 0) {
+    throw new Error("Trailing retracement distance must be greater than zero.");
+  }
+  return { px };
+}
+var HYPERLIQUID_TRAILING_ACTIVATION_PX_ERROR = "Invalid trailing activation price.";
+var POSITIVE_DECIMAL_RE = /^\d+(\.\d+)?$/;
+function parseHyperliquidTrailingActivationPx(value) {
+  if (value == null) return null;
+  const raw = String(value).trim().replace(/,/g, "");
+  if (!raw) return null;
+  if (!POSITIVE_DECIMAL_RE.test(raw)) {
+    throw new Error(HYPERLIQUID_TRAILING_ACTIVATION_PX_ERROR);
+  }
+  const px = Number.parseFloat(raw);
+  if (!Number.isFinite(px) || px <= 0) {
+    throw new Error(HYPERLIQUID_TRAILING_ACTIVATION_PX_ERROR);
+  }
+  hyperliquidFloatToWire(raw);
+  return raw;
+}
+function isHyperliquidTrailingActivationPxHuman(value) {
+  try {
+    parseHyperliquidTrailingActivationPx(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function validateHyperliquidTrailingStopParams(args) {
+  buildHyperliquidTrailingRetracement({
+    offsetType: args.offsetType,
+    offsetHuman: args.offsetHuman
+  });
+  parseHyperliquidTrailingActivationPx(args.activationPxHuman);
+}
+function parseHyperliquidTrailingStopParams(args) {
+  const offset = args.trailingOffsetHuman?.trim();
+  if (!offset) return null;
+  const params = {
+    offsetType: parseHyperliquidTrailingOffsetType(args.trailingOffsetType),
+    offsetHuman: offset,
+    activationPxHuman: args.trailingActivationPxHuman?.trim() || void 0
+  };
+  validateHyperliquidTrailingStopParams(params);
+  return params;
+}
+function buildHyperliquidTrailingStopAction(args) {
+  const asset = Math.trunc(args.asset);
+  if (!Number.isFinite(asset) || asset < 0) {
+    throw new Error("asset must be a non-negative integer.");
+  }
+  const retracement = buildHyperliquidTrailingRetracement({
+    offsetType: args.offsetType,
+    offsetHuman: args.offsetHuman
+  });
+  const activation = parseHyperliquidTrailingActivationPx(args.activationPxHuman);
+  return {
+    type: "trailingStop",
+    asset,
+    isBuy: Boolean(args.isBuy),
+    sz: hyperliquidFloatToWire(args.szHuman),
+    reduceOnly: Boolean(args.reduceOnly),
+    retracement,
+    activationPx: activation ? hyperliquidFloatToWire(activation) : null
+  };
+}
+function parseHyperliquidTrailingTriggerCondition(triggerCondition) {
+  const text = String(triggerCondition ?? "").trim();
+  if (!text) return null;
+  const retracement = text.match(/(?:^|,\s*)retracement\s+([^,]+)/i)?.[1]?.trim();
+  if (!retracement) return null;
+  const activationRaw = text.match(/(?:^|,\s*)activation\s+(?:above|below)\s+([^,]+)/i)?.[1]?.trim();
+  const bestMatch = text.match(/(?:^|,\s*)best\s+([^,]+)/i);
+  const bestRaw = bestMatch?.[1]?.trim();
+  const bestPx = bestRaw && bestRaw.toLowerCase() !== "waiting" && Number.isFinite(Number.parseFloat(bestRaw)) ? bestRaw : null;
+  const activationPx = activationRaw && Number.isFinite(Number.parseFloat(activationRaw)) ? activationRaw : null;
+  return { retracement, activationPx, bestPx };
+}
 
 // src/protocols/evm/hyperliquid/api.ts
 async function hyperliquidInfoPost(chainId, body) {
@@ -343,6 +677,12 @@ async function hyperliquidFetchActiveAssetData(args) {
     }
   };
 }
+function enrichHyperliquidFrontendOpenOrder(order) {
+  const parsed = order.trailingStop ?? parseHyperliquidTrailingTriggerCondition(order.triggerCondition);
+  const looksTrailing = parsed != null || String(order.orderType ?? "").toLowerCase().includes("trailing");
+  if (!looksTrailing) return order;
+  return { ...order, trailingStop: parsed ?? order.trailingStop ?? null };
+}
 async function hyperliquidFetchOpenOrders(args) {
   const req = { type: "openOrders", user: args.user };
   if (args.dex?.trim()) req.dex = args.dex.trim();
@@ -353,7 +693,7 @@ async function hyperliquidFetchFrontendOpenOrders(args) {
   const req = { type: "frontendOpenOrders", user: args.user };
   if (args.dex?.trim()) req.dex = args.dex.trim();
   const orders = await hyperliquidInfoPost(args.chainId, req);
-  return { orders: orders ?? [] };
+  return { orders: (orders ?? []).map(enrichHyperliquidFrontendOpenOrder) };
 }
 async function hyperliquidFetchUserVaultEquities(args) {
   const rows = await hyperliquidInfoPost(args.chainId, {
@@ -822,7 +1162,7 @@ async function hyperliquidFetchPositionDisplayRows(args) {
   return { rows };
 }
 async function hyperliquidFetchOrdersForExecutor(args) {
-  return hyperliquidFetchOpenOrders({
+  return hyperliquidFetchFrontendOpenOrders({
     chainId: args.chainId,
     user: args.executorAddress.trim().toLowerCase(),
     dex: args.dex
@@ -1507,308 +1847,203 @@ function buildEip712Multisign(args) {
     legs
   });
 }
-var EXCHANGE_DOMAIN = {
-  name: "Exchange",
-  version: "1",
-  chainId: 1337,
-  verifyingContract: "0x0000000000000000000000000000000000000000"
-};
-var AGENT_TYPES = {
-  Agent: [
-    { name: "source", type: "string" },
-    { name: "connectionId", type: "bytes32" }
-  ]
-};
-function adjustMsgpackValue(value) {
-  if (Array.isArray(value)) return value.map(adjustMsgpackValue);
-  if (typeof value === "object" && value !== null) {
-    const result = {};
-    for (const key of Object.keys(value)) {
-      const entry = value[key];
-      if (entry !== void 0) result[key] = adjustMsgpackValue(entry);
-    }
-    return result;
-  }
-  if (typeof value === "number" && Number.isInteger(value) && (value >= 4294967296 || value < -2147483648)) {
-    return BigInt(value);
-  }
-  return value;
-}
-function toUint64Bytes(n) {
-  const bytes = new Uint8Array(8);
-  new DataView(bytes.buffer).setBigUint64(0, BigInt(n));
-  return bytes;
-}
-function concatBytes(...parts) {
-  const total = parts.reduce((sum, p) => sum + p.length, 0);
-  const out = new Uint8Array(total);
-  let offset = 0;
-  for (const p of parts) {
-    out.set(p, offset);
-    offset += p.length;
-  }
-  return out;
-}
-function hexToBytes(hex) {
-  const h = hex.startsWith("0x") ? hex.slice(2) : hex;
-  const bytes = new Uint8Array(h.length / 2);
-  for (let i = 0; i < bytes.length; i++) {
-    bytes[i] = parseInt(h.slice(i * 2, i * 2 + 2), 16);
-  }
-  return bytes;
-}
-function createHyperliquidL1ActionHash(args) {
-  const { action, nonce, vaultAddress, expiresAfter } = args;
-  const actionBytes = msgpack.encode(adjustMsgpackValue(action));
-  const nonceBytes = toUint64Bytes(nonce);
-  const vaultMarker = vaultAddress ? new Uint8Array([1]) : new Uint8Array([0]);
-  const vaultBytes = vaultAddress ? hexToBytes(vaultAddress) : new Uint8Array();
-  const expiresMarker = expiresAfter !== void 0 ? new Uint8Array([0]) : new Uint8Array();
-  const expiresBytes = expiresAfter !== void 0 ? toUint64Bytes(expiresAfter) : new Uint8Array();
-  const bytes = concatBytes(actionBytes, nonceBytes, vaultMarker, vaultBytes, expiresMarker, expiresBytes);
-  return viem.keccak256(bytes);
-}
-function buildHyperliquidAgentTypedData(args) {
-  const connectionId = createHyperliquidL1ActionHash(args);
-  const source = args.isTestnet ? "b" : "a";
-  return {
-    domain: EXCHANGE_DOMAIN,
-    types: AGENT_TYPES,
-    primaryType: "Agent",
-    message: {
-      source,
-      connectionId
-    },
-    connectionId,
+
+// src/protocols/evm/hyperliquid/exchangeMultisign.ts
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+function hyperliquidExchangeLeg(args) {
+  const isTestnet = args.chainId === 998;
+  const typed = buildHyperliquidAgentTypedData({
+    action: args.action,
     nonce: args.nonce,
-    action: args.action
-  };
-}
-function buildHyperliquidUpdateLeverageAction(args) {
-  const leverage = Math.trunc(args.leverage);
-  if (!Number.isFinite(leverage) || leverage < 1) {
-    throw new Error("leverage must be a positive integer");
-  }
+    isTestnet
+  });
   return {
-    type: "updateLeverage",
-    asset: args.asset,
-    isCross: args.isCross !== false,
-    leverage
+    typedData: {
+      domain: typed.domain,
+      types: typed.types,
+      primaryType: typed.primaryType,
+      message: typed.message
+    },
+    delivery: {
+      kind: "hyperliquid_exchange",
+      chainId: args.chainId,
+      isTestnet,
+      action: args.action,
+      nonce: args.nonce
+    },
+    audit: {
+      ...args.audit,
+      nonce: args.nonce,
+      connectionId: typed.connectionId
+    }
   };
 }
-function parseHyperliquidBorrowLendAmount(amountHuman) {
-  if (amountHuman == null) return null;
-  const trimmed = String(amountHuman).trim();
-  if (!trimmed || trimmed.toLowerCase() === "max") return null;
-  return hyperliquidFloatToWire(trimmed);
+function resolveTrailingForLimit(args) {
+  return parseHyperliquidTrailingStopParams({
+    trailingOffsetHuman: args.trailingOffsetHuman,
+    trailingOffsetType: args.trailingOffsetType,
+    trailingActivationPxHuman: args.trailingActivationPxHuman
+  });
 }
-function buildHyperliquidBorrowLendAction(args) {
-  const operation = args.operation;
-  if (operation !== "supply" && operation !== "withdraw" && operation !== "repay" && operation !== "borrow") {
-    throw new Error("operation must be supply, withdraw, repay, or borrow");
-  }
-  const token = Math.trunc(args.token);
-  if (!Number.isFinite(token) || token < 0) {
-    throw new Error("token must be a non-negative integer token index");
+async function buildHyperliquidLimitOrderWithTpslMultisign(args) {
+  const marketKind = args.marketKind ?? "perp";
+  const trailing = resolveTrailingForLimit(args);
+  const tp = args.takeProfitTriggerPxHuman?.trim();
+  const sl = args.stopLossTriggerPxHuman?.trim();
+  if (trailing && sl) {
+    throw new Error("Cannot combine a trailing stop with a fixed stopLossTriggerPxHuman.");
   }
-  return {
-    type: "borrowLend",
-    operation,
-    token,
-    amount: args.amount
-  };
-}
-function hyperliquidFloatToWire(value) {
-  const n = typeof value === "number" ? value : Number.parseFloat(String(value).trim());
-  if (!Number.isFinite(n)) throw new Error("Invalid Hyperliquid wire number.");
-  const rounded = n.toFixed(8);
-  if (Math.abs(Number.parseFloat(rounded) - n) >= 1e-12) {
-    throw new Error(`Hyperliquid wire value ${value} has too many decimal places.`);
+  if (!tp && !sl && !trailing) {
+    throw new Error(
+      "At least one of takeProfitTriggerPxHuman, stopLossTriggerPxHuman, or trailingOffsetHuman is required for L1 bracket orders."
+    );
   }
-  const normalized = Number(rounded === "-0" ? "0" : rounded);
-  return String(normalized);
-}
-function hyperliquidL1TifFromKey(tif) {
-  const key = String(tif ?? "gtc").trim().toLowerCase();
-  if (key === "alo") return "Alo";
-  if (key === "ioc") return "Ioc";
-  if (key === "gtc") return "Gtc";
-  throw new Error(`Unknown time-in-force: ${tif}. Use alo, gtc, or ioc.`);
-}
-function buildHyperliquidLimitOrderWire(args) {
-  return {
-    a: args.asset,
-    b: args.isBuy,
-    p: hyperliquidFloatToWire(args.limitPxHuman),
-    s: hyperliquidFloatToWire(args.szHuman),
-    r: Boolean(args.reduceOnly),
-    t: { limit: { tif: hyperliquidL1TifFromKey(args.tif) } }
-  };
-}
-function buildHyperliquidTriggerOrderWire(args) {
-  const mode = args.tpslExecMode ?? "limit_at_trigger";
-  const triggerPx = hyperliquidFloatToWire(args.triggerPxHuman);
-  const limitPx = mode === "market" ? triggerPx : hyperliquidFloatToWire(args.limitPxHuman ?? args.triggerPxHuman);
-  return {
-    a: args.asset,
-    b: args.isBuy,
-    p: limitPx,
-    s: hyperliquidFloatToWire(args.szHuman),
-    r: true,
-    t: {
-      trigger: {
-        isMarket: mode === "market",
-        triggerPx,
-        tpsl: args.tpsl
-      }
-    }
-  };
-}
-function validateHyperliquidTpslGeometry(args) {
-  const entry = Number.parseFloat(String(args.entryPxHuman).trim());
-  const tp = args.takeProfitTriggerPxHuman?.trim() != null && args.takeProfitTriggerPxHuman.trim() !== "" ? Number.parseFloat(args.takeProfitTriggerPxHuman.trim()) : null;
-  const sl = args.stopLossTriggerPxHuman?.trim() != null && args.stopLossTriggerPxHuman.trim() !== "" ? Number.parseFloat(args.stopLossTriggerPxHuman.trim()) : null;
-  if (!Number.isFinite(entry)) throw new Error("Invalid entry limit price for TP/SL validation.");
-  if (tp != null && !Number.isFinite(tp)) throw new Error("Invalid take-profit trigger price.");
-  if (sl != null && !Number.isFinite(sl)) throw new Error("Invalid stop-loss trigger price.");
-  if (args.isBuy) {
-    if (sl != null && sl >= entry) {
-      throw new Error("Long stop-loss must be below entry price.");
-    }
-    if (tp != null && tp <= entry) {
-      throw new Error("Long take-profit must be above entry price.");
-    }
-  } else {
-    if (sl != null && sl <= entry) {
-      throw new Error("Short stop-loss must be above entry price.");
-    }
-    if (tp != null && tp >= entry) {
-      throw new Error("Short take-profit must be below entry price.");
-    }
+  if (trailing && marketKind !== "perp") {
+    throw new Error("Trailing stops are available for perp markets only.");
   }
-}
-function buildHyperliquidNormalTpslOrderWires(args) {
-  validateHyperliquidTpslGeometry({
-    isBuy: args.isBuy,
-    entryPxHuman: args.limitPxHuman,
-    takeProfitTriggerPxHuman: args.takeProfitTriggerPxHuman,
-    stopLossTriggerPxHuman: args.stopLossTriggerPxHuman
+  const { asset } = await hyperliquidResolveAsset({
+    chainId: args.chainId,
+    coin: args.coin,
+    marketKind,
+    dex: args.dex
   });
-  const orders = [
+  const hasFixedTpsl = Boolean(tp || sl);
+  const orderWires = hasFixedTpsl ? buildHyperliquidNormalTpslOrderWires({
+    asset,
+    isBuy: args.isBuy,
+    limitPxHuman: args.limitPxHuman,
+    szHuman: args.szHuman,
+    tif: args.tif,
+    takeProfitTriggerPxHuman: tp || void 0,
+    stopLossTriggerPxHuman: sl || void 0,
+    tpslExecMode: args.tpslExecMode
+  }) : [
     buildHyperliquidLimitOrderWire({
-      asset: args.asset,
+      asset,
       isBuy: args.isBuy,
       limitPxHuman: args.limitPxHuman,
       szHuman: args.szHuman,
       tif: args.tif
     })
   ];
-  const closeIsBuy = !args.isBuy;
-  const tp = args.takeProfitTriggerPxHuman?.trim();
-  const sl = args.stopLossTriggerPxHuman?.trim();
-  if (tp) {
-    orders.push(
-      buildHyperliquidTriggerOrderWire({
-        asset: args.asset,
-        isBuy: closeIsBuy,
-        szHuman: args.szHuman,
-        triggerPxHuman: tp,
-        tpsl: "tp",
-        tpslExecMode: args.tpslExecMode
-      })
-    );
-  }
-  if (sl) {
-    orders.push(
-      buildHyperliquidTriggerOrderWire({
-        asset: args.asset,
-        isBuy: closeIsBuy,
+  const grouping = hasFixedTpsl ? "normalTpsl" : "na";
+  const orderAction = buildHyperliquidOrderAction({
+    orders: orderWires,
+    grouping
+  });
+  const nonce = args.nonce ?? Date.now();
+  const legs = [
+    hyperliquidExchangeLeg({
+      action: orderAction,
+      nonce,
+      chainId: args.chainId,
+      audit: {
+        protocol: "hyperliquid",
+        action: hasFixedTpsl ? "limitOrderWithTpsl" : "limitOrderWithTrailingStop",
+        coin: args.coin,
+        marketKind,
+        asset,
+        isBuy: args.isBuy,
+        limitPxHuman: args.limitPxHuman,
         szHuman: args.szHuman,
-        triggerPxHuman: sl,
-        tpsl: "sl",
-        tpslExecMode: args.tpslExecMode
+        takeProfitTriggerPxHuman: tp ?? null,
+        stopLossTriggerPxHuman: sl ?? null,
+        tpslExecMode: hasFixedTpsl ? args.tpslExecMode ?? "limit_at_trigger" : null,
+        grouping,
+        trailingOffsetHuman: trailing?.offsetHuman ?? null,
+        trailingOffsetType: trailing?.offsetType ?? null,
+        trailingActivationPxHuman: trailing?.activationPxHuman ?? null
+      }
+    })
+  ];
+  if (trailing) {
+    const trailingAction = buildHyperliquidTrailingStopAction({
+      asset,
+      isBuy: !args.isBuy,
+      szHuman: args.szHuman,
+      reduceOnly: true,
+      offsetType: trailing.offsetType,
+      offsetHuman: trailing.offsetHuman,
+      activationPxHuman: trailing.activationPxHuman
+    });
+    legs.push(
+      hyperliquidExchangeLeg({
+        action: trailingAction,
+        nonce: nonce + 1,
+        chainId: args.chainId,
+        audit: {
+          protocol: "hyperliquid",
+          action: "trailingStop",
+          coin: args.coin,
+          marketKind,
+          asset,
+          isBuy: trailingAction.isBuy,
+          szHuman: args.szHuman,
+          reduceOnly: true,
+          trailingOffsetHuman: trailing.offsetHuman,
+          trailingOffsetType: trailing.offsetType,
+          trailingActivationPxHuman: trailing.activationPxHuman ?? null
+        }
       })
     );
   }
-  return orders;
-}
-function buildHyperliquidOrderAction(args) {
-  return {
-    type: "order",
-    orders: args.orders,
-    grouping: args.grouping ?? "na"
-  };
+  return buildEip712Multisign({
+    keyGen: args.keyGen,
+    purposeText: args.purposeText,
+    destinationChainID: String(args.chainId),
+    destinationAddress: ZERO_ADDRESS,
+    legs
+  });
 }
-
-// src/protocols/evm/hyperliquid/exchangeMultisign.ts
-var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
-async function buildHyperliquidLimitOrderWithTpslMultisign(args) {
-  const marketKind = args.marketKind ?? "perp";
+async function buildHyperliquidTrailingStopMultisign(args) {
+  const trailing = parseHyperliquidTrailingStopParams({
+    trailingOffsetHuman: args.trailingOffsetHuman,
+    trailingOffsetType: args.trailingOffsetType,
+    trailingActivationPxHuman: args.trailingActivationPxHuman
+  });
+  if (!trailing) {
+    throw new Error("trailingOffsetHuman is required for a trailing stop.");
+  }
   const { asset } = await hyperliquidResolveAsset({
     chainId: args.chainId,
     coin: args.coin,
-    marketKind,
+    marketKind: "perp",
     dex: args.dex
   });
-  const tp = args.takeProfitTriggerPxHuman?.trim();
-  const sl = args.stopLossTriggerPxHuman?.trim();
-  if (!tp && !sl) {
-    throw new Error("At least one of takeProfitTriggerPxHuman or stopLossTriggerPxHuman is required for bracket orders.");
-  }
-  const orderWires = buildHyperliquidNormalTpslOrderWires({
+  const action = buildHyperliquidTrailingStopAction({
     asset,
     isBuy: args.isBuy,
-    limitPxHuman: args.limitPxHuman,
     szHuman: args.szHuman,
-    tif: args.tif,
-    takeProfitTriggerPxHuman: tp || void 0,
-    stopLossTriggerPxHuman: sl || void 0,
-    tpslExecMode: args.tpslExecMode
-  });
-  const action = buildHyperliquidOrderAction({
-    orders: orderWires,
-    grouping: "normalTpsl"
+    reduceOnly: args.reduceOnly !== false,
+    offsetType: trailing.offsetType,
+    offsetHuman: trailing.offsetHuman,
+    activationPxHuman: trailing.activationPxHuman
   });
   const nonce = args.nonce ?? Date.now();
-  const isTestnet = args.chainId === 998;
-  const typed = buildHyperliquidAgentTypedData({ action, nonce, isTestnet });
   return buildEip712Multisign({
     keyGen: args.keyGen,
     purposeText: args.purposeText,
     destinationChainID: String(args.chainId),
     destinationAddress: ZERO_ADDRESS,
     legs: [
-      {
-        typedData: {
-          domain: typed.domain,
-          types: typed.types,
-          primaryType: typed.primaryType,
-          message: typed.message
-        },
-        delivery: {
-          kind: "hyperliquid_exchange",
-          chainId: args.chainId,
-          isTestnet,
-          action,
-          nonce
-        },
+      hyperliquidExchangeLeg({
+        action,
+        nonce,
+        chainId: args.chainId,
         audit: {
           protocol: "hyperliquid",
-          action: "limitOrderWithTpsl",
+          action: "trailingStop",
           coin: args.coin,
-          marketKind,
+          marketKind: "perp",
           asset,
-          isBuy: args.isBuy,
-          limitPxHuman: args.limitPxHuman,
+          isBuy: action.isBuy,
           szHuman: args.szHuman,
-          takeProfitTriggerPxHuman: tp ?? null,
-          stopLossTriggerPxHuman: sl ?? null,
-          tpslExecMode: args.tpslExecMode ?? "limit_at_trigger",
-          grouping: "normalTpsl",
-          nonce,
-          connectionId: typed.connectionId
+          reduceOnly: action.reduceOnly,
+          trailingOffsetHuman: trailing.offsetHuman,
+          trailingOffsetType: trailing.offsetType,
+          trailingActivationPxHuman: trailing.activationPxHuman ?? null
         }
-      }
+      })
     ]
   });
 }
@@ -1917,7 +2152,9 @@ async function buildHyperliquidBorrowLendMultisign(args) {
 
 // src/protocols/evm/hyperliquid/multisign.ts
 function hasHyperliquidBracketTpsl(args) {
-  return Boolean(args.takeProfitTriggerPxHuman?.trim() || args.stopLossTriggerPxHuman?.trim());
+  return Boolean(
+    args.takeProfitTriggerPxHuman?.trim() || args.stopLossTriggerPxHuman?.trim() || args.trailingOffsetHuman?.trim()
+  );
 }
 async function buildCoreWriterMultisign(common, data, signatureMeta) {
   const step = coreWriterStep(data);
@@ -1945,7 +2182,14 @@ async function buildCoreWriterMultisign(common, data, signatureMeta) {
 async function buildEvmMultisignBodyHyperliquidLimitOrderBatch(args) {
   if (hasHyperliquidBracketTpsl(args)) {
     if (args.reduceOnly) {
-      throw new Error("reduceOnly cannot be combined with takeProfitTriggerPxHuman or stopLossTriggerPxHuman.");
+      throw new Error("reduceOnly cannot be combined with takeProfitTriggerPxHuman, stopLossTriggerPxHuman, or a trailing stop.");
+    }
+    if (args.trailingOffsetHuman?.trim()) {
+      parseHyperliquidTrailingStopParams({
+        trailingOffsetHuman: args.trailingOffsetHuman,
+        trailingOffsetType: args.trailingOffsetType,
+        trailingActivationPxHuman: args.trailingActivationPxHuman
+      });
     }
     return buildHyperliquidLimitOrderWithTpslMultisign({
       keyGen: args.keyGen,
@@ -1960,7 +2204,10 @@ async function buildEvmMultisignBodyHyperliquidLimitOrderBatch(args) {
       tif: args.tif,
       takeProfitTriggerPxHuman: args.takeProfitTriggerPxHuman,
       stopLossTriggerPxHuman: args.stopLossTriggerPxHuman,
-      tpslExecMode: args.tpslExecMode
+      tpslExecMode: args.tpslExecMode,
+      trailingOffsetHuman: args.trailingOffsetHuman,
+      trailingOffsetType: args.trailingOffsetType,
+      trailingActivationPxHuman: args.trailingActivationPxHuman
     });
   }
   const marketKind = args.marketKind ?? "perp";
@@ -2324,7 +2571,7 @@ function hyperliquidOrderClosesPosition(position, orderSide) {
   return position.isLong ? side === "A" : side === "B";
 }
 function hyperliquidOrderCountsAsPendingClose(order) {
-  return Boolean(order.reduceOnly) || Boolean(order.isTrigger);
+  return Boolean(order.reduceOnly) || Boolean(order.isTrigger) || Boolean(order.trailingStop) || String(order.orderType ?? "").toLowerCase().includes("trailing");
 }
 function hyperliquidPendingCloseForPosition(args) {
   const positionSize = parsePositiveSize(args.position.size);
@@ -2381,7 +2628,26 @@ var hyperliquidProtocolModule = {
         dex: { type: "string", required: false, description: "HIP-3 dex name when applicable" },
         takeProfitTriggerPxHuman: { type: "string", required: false, description: "TP trigger \u2014 enables L1 bracket with SL" },
         stopLossTriggerPxHuman: { type: "string", required: false, description: "SL trigger \u2014 enables L1 bracket with TP" },
-        tpslExecMode: { type: "string", required: false, description: "limit_at_trigger (default) or market" }
+        tpslExecMode: { type: "string", required: false, description: "limit_at_trigger (default) or market" },
+        trailingOffsetHuman: { type: "string", required: false, description: "Trailing retracement \u2014 EIP-712 trailingStop (cannot combine with SL)" },
+        trailingOffsetType: { type: "string", required: false, description: "price or percentage" },
+        trailingActivationPxHuman: { type: "string", required: false, description: "Optional activation mark price" }
+      }
+    },
+    {
+      id: "hyperliquid.trailingStop",
+      protocolId: HYPERLIQUID_PROTOCOL_ID,
+      chainCategory: "evm",
+      description: "Place a Hyperliquid perp trailing stop via L1 trailingStop action (EIP-712 /exchange)",
+      commonParams: ["keyGen", "purposeText"],
+      params: {
+        coin: { type: "string", required: true, description: "Perp coin" },
+        isBuy: { type: "boolean", required: true, description: "false closes a long / opens a short" },
+        szHuman: { type: "string", required: true, description: "Size in coin units" },
+        trailingOffsetHuman: { type: "string", required: true, description: "Retracement distance or percent" },
+        trailingOffsetType: { type: "string", required: false, description: "price or percentage (default)" },
+        trailingActivationPxHuman: { type: "string", required: false, description: "Optional activation mark price" },
+        reduceOnly: { type: "boolean", required: false, description: "true (default) reduces a position" }
       }
     },
     {
@@ -2554,6 +2820,7 @@ exports.HYPERLIQUID_PROTOCOL_ID = HYPERLIQUID_PROTOCOL_ID;
 exports.HYPERLIQUID_SPOT_ASSET_OFFSET = HYPERLIQUID_SPOT_ASSET_OFFSET;
 exports.HYPERLIQUID_SUPPORTED_CHAIN_IDS = HYPERLIQUID_SUPPORTED_CHAIN_IDS;
 exports.HYPERLIQUID_TIF = HYPERLIQUID_TIF;
+exports.HYPERLIQUID_TRAILING_ACTIVATION_PX_ERROR = HYPERLIQUID_TRAILING_ACTIVATION_PX_ERROR;
 exports.HYPERLIQUID_USER_SIGNED_DOMAIN = HYPERLIQUID_USER_SIGNED_DOMAIN;
 exports.HYPERLIQUID_USER_SIGNED_SIGNATURE_CHAIN_ID = HYPERLIQUID_USER_SIGNED_SIGNATURE_CHAIN_ID;
 exports.HYPERLIQUID_WITHDRAW_SIGN_TYPES = HYPERLIQUID_WITHDRAW_SIGN_TYPES;
@@ -2585,6 +2852,9 @@ exports.buildHyperliquidLimitOrderWire = buildHyperliquidLimitOrderWire;
 exports.buildHyperliquidLimitOrderWithTpslMultisign = buildHyperliquidLimitOrderWithTpslMultisign;
 exports.buildHyperliquidNormalTpslOrderWires = buildHyperliquidNormalTpslOrderWires;
 exports.buildHyperliquidOrderAction = buildHyperliquidOrderAction;
+exports.buildHyperliquidTrailingRetracement = buildHyperliquidTrailingRetracement;
+exports.buildHyperliquidTrailingStopAction = buildHyperliquidTrailingStopAction;
+exports.buildHyperliquidTrailingStopMultisign = buildHyperliquidTrailingStopMultisign;
 exports.buildHyperliquidTriggerOrderWire = buildHyperliquidTriggerOrderWire;
 exports.buildHyperliquidUpdateLeverageAction = buildHyperliquidUpdateLeverageAction;
 exports.buildHyperliquidUpdateLeverageMultisign = buildHyperliquidUpdateLeverageMultisign;
@@ -2592,6 +2862,7 @@ exports.buildHyperliquidWithdraw3Action = buildHyperliquidWithdraw3Action;
 exports.buildHyperliquidWithdraw3TypedData = buildHyperliquidWithdraw3TypedData;
 exports.coreWriterStep = coreWriterStep;
 exports.createHyperliquidL1ActionHash = createHyperliquidL1ActionHash;
+exports.enrichHyperliquidFrontendOpenOrder = enrichHyperliquidFrontendOpenOrder;
 exports.hyperliquidApiBaseUrl = hyperliquidApiBaseUrl;
 exports.hyperliquidBridgeArbitrumChainId = hyperliquidBridgeArbitrumChainId;
 exports.hyperliquidBridgeConfig = hyperliquidBridgeConfig;
@@ -2666,15 +2937,22 @@ exports.hyperliquidResolveSpotToken = hyperliquidResolveSpotToken;
 exports.hyperliquidResolveTif = hyperliquidResolveTif;
 exports.hyperliquidSearchMarkets = hyperliquidSearchMarkets;
 exports.hyperliquidSearchMarketsSummary = hyperliquidSearchMarketsSummary;
+exports.hyperliquidTrailingPercentToWire = hyperliquidTrailingPercentToWire;
 exports.hyperliquidVaultStatsUrl = hyperliquidVaultStatsUrl;
 exports.isHyperliquidBridgeArbitrumChainSupported = isHyperliquidBridgeArbitrumChainSupported;
 exports.isHyperliquidBridgeArbitrumUsdcRow = isHyperliquidBridgeArbitrumUsdcRow;
 exports.isHyperliquidChainSupported = isHyperliquidChainSupported;
 exports.isHyperliquidHyperEvmUsdcRow = isHyperliquidHyperEvmUsdcRow;
+exports.isHyperliquidTrailingActivationPxHuman = isHyperliquidTrailingActivationPxHuman;
 exports.mapHyperliquidLendMarketRows = mapHyperliquidLendMarketRows;
 exports.parseHyperliquidBorrowLendAmount = parseHyperliquidBorrowLendAmount;
 exports.parseHyperliquidBorrowLendReserveTuples = parseHyperliquidBorrowLendReserveTuples;
 exports.parseHyperliquidBorrowLendUserState = parseHyperliquidBorrowLendUserState;
+exports.parseHyperliquidTrailingActivationPx = parseHyperliquidTrailingActivationPx;
+exports.parseHyperliquidTrailingOffsetType = parseHyperliquidTrailingOffsetType;
+exports.parseHyperliquidTrailingStopParams = parseHyperliquidTrailingStopParams;
+exports.parseHyperliquidTrailingTriggerCondition = parseHyperliquidTrailingTriggerCondition;
 exports.validateHyperliquidTpslGeometry = validateHyperliquidTpslGeometry;
+exports.validateHyperliquidTrailingStopParams = validateHyperliquidTrailingStopParams;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map