@ostium/builder-sdk 0.2.0 → 0.3.1

package/dist/cli.js

@@ -59,6 +59,32 @@ var ERC20_ABI = [
   }
 ];
 
+// src/internal/builder-fee.ts
+var MAX_BUILDER_FEE_BPS = 50;
+var MIN_BUILDER_FEE_BPS_STEP = 0.01;
+var MAX_BUILDER_FEE_CONTRACT = 5e5;
+var BPS_TO_CONTRACT = 1e4;
+function bpsToContractBuilderFee(feeBps) {
+  if (feeBps === 0) return 0n;
+  return BigInt(Math.round(feeBps * BPS_TO_CONTRACT));
+}
+function validateBuilderFeeBps(feeBps) {
+  if (!Number.isFinite(feeBps)) {
+    return "builder.feeBps must be a finite number";
+  }
+  if (feeBps < 0 || feeBps > MAX_BUILDER_FEE_BPS) {
+    return `builder.feeBps must be between 0 and ${MAX_BUILDER_FEE_BPS} (0%\u20130.5%)`;
+  }
+  const centiBps = Math.round(feeBps * 100);
+  if (Math.abs(feeBps * 100 - centiBps) > 1e-6) {
+    return `builder.feeBps must be a multiple of ${MIN_BUILDER_FEE_BPS_STEP} (0.01 bps)`;
+  }
+  if (bpsToContractBuilderFee(feeBps) > MAX_BUILDER_FEE_CONTRACT) {
+    return "builder.feeBps exceeds on-chain maximum (0.5%)";
+  }
+  return null;
+}
+
 // src/internal/decimal.ts
 function parseUsdc(amount) {
   const amountStr = typeof amount === "number" ? amount.toString() : amount;
@@ -215,7 +241,7 @@ function buildBuilderFee(builder) {
   }
   return {
     builder: builder.b,
-    builderFee: BigInt(builder.f)
+    builderFee: bpsToContractBuilderFee(builder.f)
   };
 }
 
@@ -2917,6 +2943,17 @@ query GetTraderOpenTrades($trader: String!, $skip: Int!, $first: Int!) {
     ${PAIR_FULL}
   }
 }`;
+var GetAllOpenTradesQuery = `
+query GetAllOpenTrades($skip: Int!, $first: Int!) {
+  trades(
+    where: { isOpen: true }
+    skip: $skip first: $first
+    orderBy: timestamp orderDirection: desc
+  ) {
+    ${TRADE_CORE}
+    ${PAIR_FULL}
+  }
+}`;
 var ORDER_FIELDS = `
     id tradeID limitID trader
     pair { id from to group { id name } }
@@ -2996,9 +3033,9 @@ query GetTraderActiveLimits($trader: String!, $skip: Int!, $first: Int!) {
 }`;
 
 // src/data/internal/pagination.ts
-async function paginateAll(fetcher, batchSize = 1e3, max = Infinity) {
+async function paginateAll(fetcher, batchSize = 1e3, max = Infinity, initialSkip = 0) {
   const results = [];
-  let skip = 0;
+  let skip = initialSkip;
   while (results.length < max) {
     const remaining = max - results.length;
     const fetchSize = Math.min(batchSize, remaining);
@@ -3927,15 +3964,28 @@ var OstiumSubgraphClient = class _OstiumSubgraphClient {
    *   PnL fields are zeroed.
    */
   async getOpenPositions(params) {
-    const { user, blockNumber } = params;
+    const { user, blockNumber, limit = Infinity, skip: initialSkip = 0 } = params;
+    const isGlobal = user === "ALL";
     const [trades, prices] = await Promise.all([
-      paginateAll(async (skip, first) => {
-        const data = await this.query(
-          GetTraderOpenTradesQuery,
-          { trader: user.toLowerCase(), skip, first }
-        );
-        return data.trades;
-      }),
+      paginateAll(
+        async (skip, first) => {
+          if (isGlobal) {
+            const data2 = await this.query(
+              GetAllOpenTradesQuery,
+              { skip, first }
+            );
+            return data2.trades;
+          }
+          const data = await this.query(
+            GetTraderOpenTradesQuery,
+            { trader: user.toLowerCase(), skip, first }
+          );
+          return data.trades;
+        },
+        1e3,
+        limit,
+        initialSkip
+      ),
       this.fetchLivePricesSafe()
     ]);
     const pairPositions = trades.map((trade) => {
@@ -4303,11 +4353,11 @@ function validateConfig(config) {
       "INVALID_CONFIG" /* INVALID_CONFIG */
     );
   }
-  if (config.builder !== void 0 && (config.builder.feeBps < 0 || config.builder.feeBps > 50)) {
-    throw new OstiumError(
-      "builder.feeBps must be between 0 and 50 (max 0.5%)",
-      "INVALID_CONFIG" /* INVALID_CONFIG */
-    );
+  if (config.builder !== void 0) {
+    const feeError = validateBuilderFeeBps(config.builder.feeBps);
+    if (feeError) {
+      throw new OstiumError(feeError, "INVALID_CONFIG" /* INVALID_CONFIG */);
+    }
   }
   let mode;
   try {
@@ -5103,11 +5153,18 @@ var OstiumClient = class _OstiumClient {
   /**
    * Open positions + margin summary for a user. Defaults to the connected
    * trader. Live prices and the current block number are fetched automatically.
+   *
+   * - `user`: pass an address to scope to a single trader, or `'ALL'` to fetch
+   *   positions across every trader (no trader filter).
+   * - `limit`: cap the number of positions returned (default: all).
+   * - `skip`: offset into the result set for pagination (default: `0`).
    */
   async getOpenPositions(params) {
     return this.subgraph.getOpenPositions({
       user: params?.user ?? this.getTraderAddress(),
-      blockNumber: params?.blockNumber ?? await this.publicClient.getBlockNumber()
+      blockNumber: params?.blockNumber ?? await this.publicClient.getBlockNumber(),
+      limit: params?.limit,
+      skip: params?.skip
     });
   }
   /**

package/dist/index.cjs

@@ -60,6 +60,32 @@ var ERC20_ABI = [
   }
 ];
 
+// src/internal/builder-fee.ts
+var MAX_BUILDER_FEE_BPS = 50;
+var MIN_BUILDER_FEE_BPS_STEP = 0.01;
+var MAX_BUILDER_FEE_CONTRACT = 5e5;
+var BPS_TO_CONTRACT = 1e4;
+function bpsToContractBuilderFee(feeBps) {
+  if (feeBps === 0) return 0n;
+  return BigInt(Math.round(feeBps * BPS_TO_CONTRACT));
+}
+function validateBuilderFeeBps(feeBps) {
+  if (!Number.isFinite(feeBps)) {
+    return "builder.feeBps must be a finite number";
+  }
+  if (feeBps < 0 || feeBps > MAX_BUILDER_FEE_BPS) {
+    return `builder.feeBps must be between 0 and ${MAX_BUILDER_FEE_BPS} (0%\u20130.5%)`;
+  }
+  const centiBps = Math.round(feeBps * 100);
+  if (Math.abs(feeBps * 100 - centiBps) > 1e-6) {
+    return `builder.feeBps must be a multiple of ${MIN_BUILDER_FEE_BPS_STEP} (0.01 bps)`;
+  }
+  if (bpsToContractBuilderFee(feeBps) > MAX_BUILDER_FEE_CONTRACT) {
+    return "builder.feeBps exceeds on-chain maximum (0.5%)";
+  }
+  return null;
+}
+
 // src/internal/decimal.ts
 function parseUsdc(amount) {
   const amountStr = typeof amount === "number" ? amount.toString() : amount;
@@ -218,7 +244,7 @@ function buildBuilderFee(builder) {
   }
   return {
     builder: builder.b,
-    builderFee: BigInt(builder.f)
+    builderFee: bpsToContractBuilderFee(builder.f)
   };
 }
 
@@ -2944,6 +2970,17 @@ query GetTraderOpenTrades($trader: String!, $skip: Int!, $first: Int!) {
     ${PAIR_FULL}
   }
 }`;
+var GetAllOpenTradesQuery = `
+query GetAllOpenTrades($skip: Int!, $first: Int!) {
+  trades(
+    where: { isOpen: true }
+    skip: $skip first: $first
+    orderBy: timestamp orderDirection: desc
+  ) {
+    ${TRADE_CORE}
+    ${PAIR_FULL}
+  }
+}`;
 var ORDER_FIELDS = `
     id tradeID limitID trader
     pair { id from to group { id name } }
@@ -3023,9 +3060,9 @@ query GetTraderActiveLimits($trader: String!, $skip: Int!, $first: Int!) {
 }`;
 
 // src/data/internal/pagination.ts
-async function paginateAll(fetcher, batchSize = 1e3, max = Infinity) {
+async function paginateAll(fetcher, batchSize = 1e3, max = Infinity, initialSkip = 0) {
   const results = [];
-  let skip = 0;
+  let skip = initialSkip;
   while (results.length < max) {
     const remaining = max - results.length;
     const fetchSize = Math.min(batchSize, remaining);
@@ -3954,15 +3991,28 @@ var OstiumSubgraphClient = class _OstiumSubgraphClient {
    *   PnL fields are zeroed.
    */
   async getOpenPositions(params) {
-    const { user, blockNumber } = params;
+    const { user, blockNumber, limit = Infinity, skip: initialSkip = 0 } = params;
+    const isGlobal = user === "ALL";
     const [trades, prices] = await Promise.all([
-      paginateAll(async (skip, first) => {
-        const data = await this.query(
-          GetTraderOpenTradesQuery,
-          { trader: user.toLowerCase(), skip, first }
-        );
-        return data.trades;
-      }),
+      paginateAll(
+        async (skip, first) => {
+          if (isGlobal) {
+            const data2 = await this.query(
+              GetAllOpenTradesQuery,
+              { skip, first }
+            );
+            return data2.trades;
+          }
+          const data = await this.query(
+            GetTraderOpenTradesQuery,
+            { trader: user.toLowerCase(), skip, first }
+          );
+          return data.trades;
+        },
+        1e3,
+        limit,
+        initialSkip
+      ),
       this.fetchLivePricesSafe()
     ]);
     const pairPositions = trades.map((trade) => {
@@ -4330,11 +4380,11 @@ function validateConfig(config) {
       "INVALID_CONFIG" /* INVALID_CONFIG */
     );
   }
-  if (config.builder !== void 0 && (config.builder.feeBps < 0 || config.builder.feeBps > 50)) {
-    throw new OstiumError(
-      "builder.feeBps must be between 0 and 50 (max 0.5%)",
-      "INVALID_CONFIG" /* INVALID_CONFIG */
-    );
+  if (config.builder !== void 0) {
+    const feeError = validateBuilderFeeBps(config.builder.feeBps);
+    if (feeError) {
+      throw new OstiumError(feeError, "INVALID_CONFIG" /* INVALID_CONFIG */);
+    }
   }
   let mode;
   try {
@@ -5130,11 +5180,18 @@ var OstiumClient = class _OstiumClient {
   /**
    * Open positions + margin summary for a user. Defaults to the connected
    * trader. Live prices and the current block number are fetched automatically.
+   *
+   * - `user`: pass an address to scope to a single trader, or `'ALL'` to fetch
+   *   positions across every trader (no trader filter).
+   * - `limit`: cap the number of positions returned (default: all).
+   * - `skip`: offset into the result set for pagination (default: `0`).
    */
   async getOpenPositions(params) {
     return this.subgraph.getOpenPositions({
       user: params?.user ?? this.getTraderAddress(),
-      blockNumber: params?.blockNumber ?? await this.publicClient.getBlockNumber()
+      blockNumber: params?.blockNumber ?? await this.publicClient.getBlockNumber(),
+      limit: params?.limit,
+      skip: params?.skip
     });
   }
   /**