@polymarbot/shared 0.1.0

package/basic.cjs

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/basic.ts
+var basic_exports = {};
+__export(basic_exports, {
+  isUrl: () => isUrl,
+  safeJsonParse: () => safeJsonParse,
+  sleep: () => sleep,
+  stableStringify: () => stableStringify
+});
+module.exports = __toCommonJS(basic_exports);
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function safeJsonParse(str, defaultValue) {
+  try {
+    return JSON.parse(str);
+  } catch (e) {
+    console.error(e);
+    return defaultValue ?? {};
+  }
+}
+function isUrl(str) {
+  return str.startsWith("http://") || str.startsWith("https://");
+}
+function stableStringify(value, sortArray = false) {
+  if (value === null || value === void 0) {
+    return JSON.stringify(value);
+  }
+  if (typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    const processedArray = value.map((item) => {
+      if (item !== null && typeof item === "object") {
+        return stableStringify(item, sortArray);
+      }
+      return item;
+    });
+    const finalProcessedArray = sortArray ? [...processedArray].sort((a, b) => {
+      const strA = typeof a === "string" ? a : JSON.stringify(a);
+      const strB = typeof b === "string" ? b : JSON.stringify(b);
+      return strA.localeCompare(strB);
+    }) : processedArray;
+    const finalArray = finalProcessedArray.map((item) => {
+      if (typeof item === "string" && (item.startsWith("{") || item.startsWith("["))) {
+        return JSON.parse(item);
+      }
+      return item;
+    });
+    return JSON.stringify(finalArray);
+  }
+  const sortedKeys = Object.keys(value).sort();
+  const sortedObj = {};
+  for (const key of sortedKeys) {
+    const val = value[key];
+    if (val !== null && typeof val === "object") {
+      sortedObj[key] = JSON.parse(stableStringify(val, sortArray));
+    } else {
+      sortedObj[key] = val;
+    }
+  }
+  return JSON.stringify(sortedObj);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isUrl,
+  safeJsonParse,
+  sleep,
+  stableStringify
+});

package/basic.d.cts

@@ -0,0 +1,34 @@
+/**
+ * 等待指定毫秒
+ * @param ms
+ * @returns {Promise<any>}
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * 安全解析Json
+ * @param str - 需要解析的字符串
+ * @param defaultValue - 解析失败时的默认值
+ */
+declare function safeJsonParse<T extends object | unknown[]>(str?: string, defaultValue?: T): T;
+/**
+ * 判断字符串是否为 URL
+ * @param str - 需要判断的字符串
+ * @returns 是否为 URL
+ */
+declare function isUrl(str: string): boolean;
+/**
+ * 将对象序列化为稳定的 JSON 字符串
+ * 通过深度遍历对象，对所有 key 进行排序，确保相同值的对象序列化结果一致
+ *
+ * 处理策略：
+ * - 对象：按 key 字母序排序
+ * - 数组：当 sortArray 为 true 时，对基本类型直接排序，对对象类型先序列化再排序；为 false 时保持原顺序
+ * - 从底层向上递归处理，确保嵌套结构都被正确处理
+ *
+ * @param value - 需要序列化的值
+ * @param sortArray - 是否对数组进行排序，默认为 false
+ * @returns 稳定的 JSON 字符串
+ */
+declare function stableStringify(value: unknown, sortArray?: boolean): string;
+
+export { isUrl, safeJsonParse, sleep, stableStringify };

package/basic.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 等待指定毫秒
+ * @param ms
+ * @returns {Promise<any>}
+ */
+declare function sleep(ms: number): Promise<void>;
+/**
+ * 安全解析Json
+ * @param str - 需要解析的字符串
+ * @param defaultValue - 解析失败时的默认值
+ */
+declare function safeJsonParse<T extends object | unknown[]>(str?: string, defaultValue?: T): T;
+/**
+ * 判断字符串是否为 URL
+ * @param str - 需要判断的字符串
+ * @returns 是否为 URL
+ */
+declare function isUrl(str: string): boolean;
+/**
+ * 将对象序列化为稳定的 JSON 字符串
+ * 通过深度遍历对象，对所有 key 进行排序，确保相同值的对象序列化结果一致
+ *
+ * 处理策略：
+ * - 对象：按 key 字母序排序
+ * - 数组：当 sortArray 为 true 时，对基本类型直接排序，对对象类型先序列化再排序；为 false 时保持原顺序
+ * - 从底层向上递归处理，确保嵌套结构都被正确处理
+ *
+ * @param value - 需要序列化的值
+ * @param sortArray - 是否对数组进行排序，默认为 false
+ * @returns 稳定的 JSON 字符串
+ */
+declare function stableStringify(value: unknown, sortArray?: boolean): string;
+
+export { isUrl, safeJsonParse, sleep, stableStringify };

package/basic.js

@@ -0,0 +1,60 @@
+// src/utils/basic.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function safeJsonParse(str, defaultValue) {
+  try {
+    return JSON.parse(str);
+  } catch (e) {
+    console.error(e);
+    return defaultValue ?? {};
+  }
+}
+function isUrl(str) {
+  return str.startsWith("http://") || str.startsWith("https://");
+}
+function stableStringify(value, sortArray = false) {
+  if (value === null || value === void 0) {
+    return JSON.stringify(value);
+  }
+  if (typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    const processedArray = value.map((item) => {
+      if (item !== null && typeof item === "object") {
+        return stableStringify(item, sortArray);
+      }
+      return item;
+    });
+    const finalProcessedArray = sortArray ? [...processedArray].sort((a, b) => {
+      const strA = typeof a === "string" ? a : JSON.stringify(a);
+      const strB = typeof b === "string" ? b : JSON.stringify(b);
+      return strA.localeCompare(strB);
+    }) : processedArray;
+    const finalArray = finalProcessedArray.map((item) => {
+      if (typeof item === "string" && (item.startsWith("{") || item.startsWith("["))) {
+        return JSON.parse(item);
+      }
+      return item;
+    });
+    return JSON.stringify(finalArray);
+  }
+  const sortedKeys = Object.keys(value).sort();
+  const sortedObj = {};
+  for (const key of sortedKeys) {
+    const val = value[key];
+    if (val !== null && typeof val === "object") {
+      sortedObj[key] = JSON.parse(stableStringify(val, sortArray));
+    } else {
+      sortedObj[key] = val;
+    }
+  }
+  return JSON.stringify(sortedObj);
+}
+export {
+  isUrl,
+  safeJsonParse,
+  sleep,
+  stableStringify
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@polymarbot/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./basic.cjs",
+  "module": "./basic.js",
+  "types": "./basic.d.ts",
+  "exports": {
+    "./basic": {
+      "import": "./basic.js",
+      "require": "./basic.cjs",
+      "types": "./basic.d.ts"
+    },
+    "./relayer-client": {
+      "import": "./relayer-client.js",
+      "require": "./relayer-client.cjs",
+      "types": "./relayer-client.d.ts"
+    },
+    "./trade-strategy/normalize": {
+      "import": "./trade-strategy/normalize.js",
+      "require": "./trade-strategy/normalize.cjs",
+      "types": "./trade-strategy/normalize.d.ts"
+    },
+    "./trade-strategy/types": {
+      "import": "./trade-strategy/types.js",
+      "require": "./trade-strategy/types.cjs",
+      "types": "./trade-strategy/types.d.ts"
+    },
+    "./wallet": {
+      "import": "./wallet.js",
+      "require": "./wallet.cjs",
+      "types": "./wallet.d.ts"
+    }
+  },
+  "files": [
+    "**/*.js",
+    "**/*.cjs",
+    "**/*.d.ts",
+    "**/*.d.cts"
+  ],
+  "dependencies": {
+    "viem": "^2.38.6",
+    "@polymarket/builder-relayer-client": "^0.0.6",
+    "@polymarket/builder-signing-sdk": "^0.0.8",
+    "@polymarket/clob-client": "^4.22.8"
+  }
+}

package/relayer-client.cjs

@@ -0,0 +1,64 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/relayer-client.ts
+var relayer_client_exports = {};
+__export(relayer_client_exports, {
+  createRelayerClient: () => createRelayerClient,
+  getBuilderCredsFromEnv: () => getBuilderCredsFromEnv
+});
+module.exports = __toCommonJS(relayer_client_exports);
+var import_viem = require("viem");
+var import_accounts = require("viem/accounts");
+var import_chains = require("viem/chains");
+var import_builder_relayer_client = require("@polymarket/builder-relayer-client");
+var import_builder_signing_sdk = require("@polymarket/builder-signing-sdk");
+function getBuilderCredsFromEnv() {
+  const key = process.env.POLYMARKET_BUILDER_API_KEY;
+  const secret = process.env.POLYMARKET_BUILDER_SECRET;
+  const passphrase = process.env.POLYMARKET_BUILDER_PASSPHRASE;
+  const missingVars = [];
+  if (!key) missingVars.push("POLYMARKET_BUILDER_API_KEY");
+  if (!secret) missingVars.push("POLYMARKET_BUILDER_SECRET");
+  if (!passphrase) missingVars.push("POLYMARKET_BUILDER_PASSPHRASE");
+  if (missingVars.length > 0) {
+    throw new Error(`Missing required environment variables: ${missingVars.join(", ")}`);
+  }
+  return { key, secret, passphrase };
+}
+function createRelayerClient(privateKey) {
+  const POLYGON_RPC = process.env.POLYGON_RPC || import_chains.polygon.rpcUrls.default.http[0];
+  const CHAIN_ID = Number(process.env.CHAIN_ID) || import_chains.polygon.id;
+  const RELAYER_URL = "https://relayer-v2.polymarket.com/";
+  const builderConfig = new import_builder_signing_sdk.BuilderConfig({
+    localBuilderCreds: getBuilderCredsFromEnv()
+  });
+  const account = (0, import_accounts.privateKeyToAccount)(privateKey);
+  const wallet = (0, import_viem.createWalletClient)({
+    account,
+    chain: import_chains.polygon,
+    transport: (0, import_viem.http)(POLYGON_RPC)
+  });
+  return new import_builder_relayer_client.RelayClient(RELAYER_URL, CHAIN_ID, wallet, builderConfig);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRelayerClient,
+  getBuilderCredsFromEnv
+});

package/relayer-client.d.cts

@@ -0,0 +1,27 @@
+import { Hex } from 'viem';
+import { RelayClient } from '@polymarket/builder-relayer-client';
+import { BuilderApiKeyCreds } from '@polymarket/builder-signing-sdk';
+
+/**
+ * Polymarket Relayer Client Utility
+ *
+ * Features: Create Relayer Client, manage Builder API credentials
+ * Documentation: https://docs.polymarket.com/developers/builders/relayer-client
+ */
+
+/**
+ * Read Builder API credentials from environment variables
+ *
+ * @returns Builder API credentials
+ * @throws Throws an error when environment variables are missing
+ */
+declare function getBuilderCredsFromEnv(): BuilderApiKeyCreds;
+/**
+ * Create a Relayer Client instance
+ *
+ * @param privateKey - User wallet private key
+ * @returns RelayClient instance
+ */
+declare function createRelayerClient(privateKey: Hex): RelayClient;
+
+export { createRelayerClient, getBuilderCredsFromEnv };

package/relayer-client.d.ts

@@ -0,0 +1,27 @@
+import { Hex } from 'viem';
+import { RelayClient } from '@polymarket/builder-relayer-client';
+import { BuilderApiKeyCreds } from '@polymarket/builder-signing-sdk';
+
+/**
+ * Polymarket Relayer Client Utility
+ *
+ * Features: Create Relayer Client, manage Builder API credentials
+ * Documentation: https://docs.polymarket.com/developers/builders/relayer-client
+ */
+
+/**
+ * Read Builder API credentials from environment variables
+ *
+ * @returns Builder API credentials
+ * @throws Throws an error when environment variables are missing
+ */
+declare function getBuilderCredsFromEnv(): BuilderApiKeyCreds;
+/**
+ * Create a Relayer Client instance
+ *
+ * @param privateKey - User wallet private key
+ * @returns RelayClient instance
+ */
+declare function createRelayerClient(privateKey: Hex): RelayClient;
+
+export { createRelayerClient, getBuilderCredsFromEnv };

package/relayer-client.js

@@ -0,0 +1,38 @@
+// src/utils/relayer-client.ts
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { polygon } from "viem/chains";
+import { RelayClient } from "@polymarket/builder-relayer-client";
+import { BuilderConfig } from "@polymarket/builder-signing-sdk";
+function getBuilderCredsFromEnv() {
+  const key = process.env.POLYMARKET_BUILDER_API_KEY;
+  const secret = process.env.POLYMARKET_BUILDER_SECRET;
+  const passphrase = process.env.POLYMARKET_BUILDER_PASSPHRASE;
+  const missingVars = [];
+  if (!key) missingVars.push("POLYMARKET_BUILDER_API_KEY");
+  if (!secret) missingVars.push("POLYMARKET_BUILDER_SECRET");
+  if (!passphrase) missingVars.push("POLYMARKET_BUILDER_PASSPHRASE");
+  if (missingVars.length > 0) {
+    throw new Error(`Missing required environment variables: ${missingVars.join(", ")}`);
+  }
+  return { key, secret, passphrase };
+}
+function createRelayerClient(privateKey) {
+  const POLYGON_RPC = process.env.POLYGON_RPC || polygon.rpcUrls.default.http[0];
+  const CHAIN_ID = Number(process.env.CHAIN_ID) || polygon.id;
+  const RELAYER_URL = "https://relayer-v2.polymarket.com/";
+  const builderConfig = new BuilderConfig({
+    localBuilderCreds: getBuilderCredsFromEnv()
+  });
+  const account = privateKeyToAccount(privateKey);
+  const wallet = createWalletClient({
+    account,
+    chain: polygon,
+    transport: http(POLYGON_RPC)
+  });
+  return new RelayClient(RELAYER_URL, CHAIN_ID, wallet, builderConfig);
+}
+export {
+  createRelayerClient,
+  getBuilderCredsFromEnv
+};

package/trade-strategy/normalize.cjs

@@ -0,0 +1,168 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/trade-strategy/normalize.ts
+var normalize_exports = {};
+__export(normalize_exports, {
+  hasBuySteps: () => hasBuySteps,
+  normalizeStrategy: () => normalizeStrategy
+});
+module.exports = __toCommonJS(normalize_exports);
+var import_clob_client = require("@polymarket/clob-client");
+function normalizeBuyStep(step, options) {
+  const { start, end, price, size } = step;
+  const { minPrice, minSize } = options;
+  if (start === void 0 || start === null || start < 0) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u4E70\u5165\u6B65\u9AA4: start \u5FC5\u987B >= 0\uFF0C\u5F53\u524D\u503C: ${start}`);
+    return null;
+  }
+  if (end === void 0 || end === null || end <= 0) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u4E70\u5165\u6B65\u9AA4: end \u5FC5\u987B > 0\uFF0C\u5F53\u524D\u503C: ${end}`);
+    return null;
+  }
+  if (start >= end) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u4E70\u5165\u6B65\u9AA4: start \u5FC5\u987B\u5C0F\u4E8E end\uFF0C\u5F53\u524D start: ${start}, end: ${end}`);
+    return null;
+  }
+  if (price === void 0 || price === null || price < minPrice || price >= 1) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u4E70\u5165\u6B65\u9AA4: price \u5FC5\u987B >= ${minPrice} \u4E14 < 1\uFF0C\u5F53\u524D\u503C: ${price}`);
+    return null;
+  }
+  if (size === void 0 || size === null || size < minSize) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u4E70\u5165\u6B65\u9AA4: size \u5FC5\u987B >= ${minSize}\uFF0C\u5F53\u524D\u503C: ${size}`);
+    return null;
+  }
+  const normalized = {
+    side: import_clob_client.Side.BUY,
+    price,
+    size,
+    start,
+    end
+  };
+  if (step.once === true) {
+    normalized.once = true;
+  }
+  if (step.outcome === "Up" || step.outcome === "Down") {
+    normalized.outcome = step.outcome;
+  }
+  const isLowPriceMode = price <= 0.5;
+  const isChaseMode = price > 0.5;
+  if (isLowPriceMode) {
+    if (step.maxUnderlyingDiff !== void 0) {
+      if (step.maxUnderlyingDiff >= 1 && step.maxUnderlyingDiff <= 1e3) {
+        normalized.maxUnderlyingDiff = step.maxUnderlyingDiff;
+      } else {
+        console.warn(`   \u2514\u2500 \u5DF2\u79FB\u9664\u65E0\u6548\u5B57\u6BB5 maxUnderlyingDiff: \u503C\u5FC5\u987B\u5728 1-1000 \u8303\u56F4\u5185\uFF0C\u5F53\u524D\u503C: ${step.maxUnderlyingDiff}`);
+      }
+    }
+    if (step.minUnderlyingDiff !== void 0) {
+      console.warn(`   \u2514\u2500 \u5DF2\u79FB\u9664\u65E0\u6548\u5B57\u6BB5 minUnderlyingDiff: \u4F4E\u4F4D\u4E70\u5165\u6A21\u5F0F(price=${price})\u4E0D\u652F\u6301\u6B64\u5B57\u6BB5`);
+    }
+  }
+  if (isChaseMode) {
+    if (step.minUnderlyingDiff !== void 0) {
+      if (step.minUnderlyingDiff >= 1 && step.minUnderlyingDiff <= 1e3) {
+        normalized.minUnderlyingDiff = step.minUnderlyingDiff;
+      } else {
+        console.warn(`   \u2514\u2500 \u5DF2\u79FB\u9664\u65E0\u6548\u5B57\u6BB5 minUnderlyingDiff: \u503C\u5FC5\u987B\u5728 1-1000 \u8303\u56F4\u5185\uFF0C\u5F53\u524D\u503C: ${step.minUnderlyingDiff}`);
+      }
+    }
+    if (step.maxUnderlyingDiff !== void 0) {
+      console.warn(`   \u2514\u2500 \u5DF2\u79FB\u9664\u65E0\u6548\u5B57\u6BB5 maxUnderlyingDiff: \u8FFD\u6DA8\u4E70\u5165\u6A21\u5F0F(price=${price})\u4E0D\u652F\u6301\u6B64\u5B57\u6BB5`);
+    }
+  }
+  return normalized;
+}
+function normalizeSellStep(step, options) {
+  const { start, end, price, size } = step;
+  const { minPrice, minSize } = options;
+  if (start === void 0 || start === null || start < 0) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u5356\u51FA\u6B65\u9AA4: start \u5FC5\u987B >= 0\uFF0C\u5F53\u524D\u503C: ${start}`);
+    return null;
+  }
+  if (end === void 0 || end === null || end <= 0) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u5356\u51FA\u6B65\u9AA4: end \u5FC5\u987B > 0\uFF0C\u5F53\u524D\u503C: ${end}`);
+    return null;
+  }
+  if (start >= end) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u5356\u51FA\u6B65\u9AA4: start \u5FC5\u987B\u5C0F\u4E8E end\uFF0C\u5F53\u524D start: ${start}, end: ${end}`);
+    return null;
+  }
+  if (price === void 0 || price === null || price < minPrice || price >= 1) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u5356\u51FA\u6B65\u9AA4: price \u5FC5\u987B >= ${minPrice} \u4E14 < 1\uFF0C\u5F53\u524D\u503C: ${price}`);
+    return null;
+  }
+  if (size === void 0 || size === null || size < minSize) {
+    console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u5356\u51FA\u6B65\u9AA4: size \u5FC5\u987B >= ${minSize}\uFF0C\u5F53\u524D\u503C: ${size}`);
+    return null;
+  }
+  const normalized = {
+    side: import_clob_client.Side.SELL,
+    price,
+    size,
+    start,
+    end
+  };
+  const stepAsTradeStep = step;
+  const invalidFields = [];
+  if ("once" in stepAsTradeStep && stepAsTradeStep.once !== void 0) invalidFields.push("once");
+  if ("outcome" in stepAsTradeStep && stepAsTradeStep.outcome !== void 0) invalidFields.push("outcome");
+  if ("maxUnderlyingDiff" in stepAsTradeStep && stepAsTradeStep.maxUnderlyingDiff !== void 0) invalidFields.push("maxUnderlyingDiff");
+  if ("minUnderlyingDiff" in stepAsTradeStep && stepAsTradeStep.minUnderlyingDiff !== void 0) invalidFields.push("minUnderlyingDiff");
+  if (invalidFields.length > 0) {
+    console.warn(`   \u2514\u2500 \u5DF2\u79FB\u9664\u5356\u51FA\u6B65\u9AA4\u4E2D\u7684\u65E0\u6548\u5B57\u6BB5: ${invalidFields.join(", ")}`);
+  }
+  return normalized;
+}
+function normalizeStrategy(config, options = {}) {
+  if (!config || !Array.isArray(config) || config.length === 0) {
+    console.warn("\u26A0\uFE0F \u7B56\u7565\u914D\u7F6E\u4E3A\u7A7A\u6216\u683C\u5F0F\u9519\u8BEF");
+    return [];
+  }
+  const normalizeOptions = {
+    minPrice: options.minPrice ?? 0.01,
+    minSize: options.minSize ?? 5
+  };
+  const normalized = [];
+  config.forEach((step, index) => {
+    console.debug(`\u9A8C\u8BC1\u6B65\u9AA4 ${index + 1}/${config.length}: ${step.side}`);
+    let normalizedStep = null;
+    if (step.side === import_clob_client.Side.BUY) {
+      normalizedStep = normalizeBuyStep(step, normalizeOptions);
+    } else if (step.side === import_clob_client.Side.SELL) {
+      normalizedStep = normalizeSellStep(step, normalizeOptions);
+    } else {
+      const unknownStep = step;
+      console.warn(`\u26A0\uFE0F \u5DF2\u8FC7\u6EE4\u65E0\u6548\u6B65\u9AA4: \u672A\u77E5\u7684 side \u7C7B\u578B: ${unknownStep.side}`);
+    }
+    if (normalizedStep) {
+      normalized.push(normalizedStep);
+    }
+  });
+  console.info(`\u2705 \u7B56\u7565\u4FEE\u6B63\u5B8C\u6210: \u539F\u59CB\u6B65\u9AA4 ${config.length} \u4E2A\uFF0C\u6709\u6548\u6B65\u9AA4 ${normalized.length} \u4E2A`);
+  return normalized;
+}
+function hasBuySteps(config) {
+  return config.some((step) => step.side === import_clob_client.Side.BUY);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  hasBuySteps,
+  normalizeStrategy
+});

package/trade-strategy/normalize.d.cts

@@ -0,0 +1,29 @@
+import { StrategyConfig } from './types.cjs';
+import '@polymarket/clob-client';
+
+/**
+ * 策略修正选项
+ */
+interface NormalizeStrategyOptions {
+    /** 最小价格，默认 0.01 */
+    minPrice?: number;
+    /** 最小数量，默认 5 */
+    minSize?: number;
+}
+/**
+ * 修正策略配置
+ * 对输入的策略进行验证、修正和过滤
+ *
+ * @param config - 原始策略配置
+ * @param options - 修正选项
+ * @returns 修正后的策略配置
+ */
+declare function normalizeStrategy(config: StrategyConfig, options?: NormalizeStrategyOptions): StrategyConfig;
+/**
+ * 检查策略是否包含买入步骤
+ * @param config - 策略配置
+ * @returns 是否包含买入步骤
+ */
+declare function hasBuySteps(config: StrategyConfig): boolean;
+
+export { type NormalizeStrategyOptions, hasBuySteps, normalizeStrategy };

package/trade-strategy/normalize.d.ts

@@ -0,0 +1,29 @@
+import { StrategyConfig } from './types.js';
+import '@polymarket/clob-client';
+
+/**
+ * 策略修正选项
+ */
+interface NormalizeStrategyOptions {
+    /** 最小价格，默认 0.01 */
+    minPrice?: number;
+    /** 最小数量，默认 5 */
+    minSize?: number;
+}
+/**
+ * 修正策略配置
+ * 对输入的策略进行验证、修正和过滤
+ *
+ * @param config - 原始策略配置
+ * @param options - 修正选项
+ * @returns 修正后的策略配置
+ */
+declare function normalizeStrategy(config: StrategyConfig, options?: NormalizeStrategyOptions): StrategyConfig;
+/**
+ * 检查策略是否包含买入步骤
+ * @param config - 策略配置
+ * @returns 是否包含买入步骤
+ */
+declare function hasBuySteps(config: StrategyConfig): boolean;
+
+export { type NormalizeStrategyOptions, hasBuySteps, normalizeStrategy };