@ostium/builder-sdk 0.3.0 → 0.3.1

package/dist/index.d.cts

@@ -191,7 +191,7 @@ interface CommonParams {
     slippageBps?: number;
     /**
      * Optional builder fee sharing.
-     * `feeBps` is in basis points — max 50 (0.5%).
+     * `feeBps` in basis points (e.g. 10 = 10 bps / 0.1%, 2.55 = 2.55 bps). Max 50 (0.5%), step 0.01 bps.
      */
     builder?: {
         address: Address;

package/dist/index.d.ts

@@ -191,7 +191,7 @@ interface CommonParams {
     slippageBps?: number;
     /**
      * Optional builder fee sharing.
-     * `feeBps` is in basis points — max 50 (0.5%).
+     * `feeBps` in basis points (e.g. 10 = 10 bps / 0.1%, 2.55 = 2.55 bps). Max 50 (0.5%), step 0.01 bps.
      */
     builder?: {
         address: Address;

package/dist/index.js

@@ -54,6 +54,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;
@@ -212,7 +238,7 @@ function buildBuilderFee(builder) {
   }
   return {
     builder: builder.b,
-    builderFee: BigInt(builder.f)
+    builderFee: bpsToContractBuilderFee(builder.f)
   };
 }
 
@@ -4348,11 +4374,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 {