@blazephoenix/sdk 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -145,7 +145,8 @@ interface QuoteRequest {
     amountIn?: bigint | string;
     /** Input in HUMAN units ("1.5"); decimals are read from the token on your RPC. */
     amount?: string;
-    /** Tighten the on-chain floor with your own minimum (base units of tokenOut). */
+    /** Your own minimum (base units of tokenOut). In buildSwap it is the signed minimum as given,
+     *  and it is refused (`min_implausible`) below the quote net of slippageBps or the on-chain floor. */
     userMinOut?: bigint | string;
     /** Protocol version for this call (default: the client's, itself 'latest'). */
     version?: string;
@@ -211,6 +212,15 @@ interface SwapRequest extends QuoteRequest {
     mode?: 'route' | 'best';
     /** Allowance to request when approval is needed: 'exact' (default) or 'max'. */
     approve?: 'exact' | 'max';
+    /**
+     * true — also read previewPlanExact (every concentrated leg dry-run) in the same block and
+     * derive minOut from its exactOut: a fixed 50 bps safety margin first, then slippageBps off
+     * that, never below the default minimum. The calldata still executes the route of the default
+     * path; the exact read must price that same route, or buildSwap refuses. A userMinOut above
+     * exactOut less the margin is refused (`min_above_exact`). One more eth_call; the swap reverts
+     * instead of filling short when the pool moves past the tolerance.
+     */
+    exact?: boolean;
 }
 interface ApprovalStep {
     token: Address;
@@ -237,6 +247,8 @@ interface SwapPlan {
     unwrapAfter: boolean;
     /** Ordered transactions to send: [approval?, swap]. */
     steps: TxRequest[];
+    /** With `exact: true`: the previewPlanExact output minOut was derived from. */
+    exactOut?: bigint;
 }
 interface SimulationResult {
     ok: boolean;
@@ -4249,7 +4261,7 @@ declare const CAUTION_IMPACT_BPS = 200;
 declare function routeIsConsistent(route: Route, tokenIn: Address, tokenOut: Address): boolean;
 declare function phoenixCheck(pv: Preview, tokenIn: Address, tokenOut: Address): QuoteChecks;
 
-type BlazeErrorCode = 'rpc_required' | 'rpc_chain_mismatch' | 'rpc_error' | 'bad_request' | 'not_deployed' | 'unsupported_by_version' | 'no_route' | 'not_executable' | 'calldata_mismatch' | 'deployment_unverified' | 'reverted' | 'wallet_chain_mismatch';
+type BlazeErrorCode = 'rpc_required' | 'rpc_chain_mismatch' | 'rpc_error' | 'bad_request' | 'not_deployed' | 'unsupported_by_version' | 'no_route' | 'not_executable' | 'calldata_mismatch' | 'min_implausible' | 'min_above_exact' | 'deployment_unverified' | 'reverted' | 'wallet_chain_mismatch';
 declare class BlazeError extends Error {
     readonly code: BlazeErrorCode;
     readonly details?: Record<string, unknown>;

package/dist/index.d.ts

@@ -145,7 +145,8 @@ interface QuoteRequest {
     amountIn?: bigint | string;
     /** Input in HUMAN units ("1.5"); decimals are read from the token on your RPC. */
     amount?: string;
-    /** Tighten the on-chain floor with your own minimum (base units of tokenOut). */
+    /** Your own minimum (base units of tokenOut). In buildSwap it is the signed minimum as given,
+     *  and it is refused (`min_implausible`) below the quote net of slippageBps or the on-chain floor. */
     userMinOut?: bigint | string;
     /** Protocol version for this call (default: the client's, itself 'latest'). */
     version?: string;
@@ -211,6 +212,15 @@ interface SwapRequest extends QuoteRequest {
     mode?: 'route' | 'best';
     /** Allowance to request when approval is needed: 'exact' (default) or 'max'. */
     approve?: 'exact' | 'max';
+    /**
+     * true — also read previewPlanExact (every concentrated leg dry-run) in the same block and
+     * derive minOut from its exactOut: a fixed 50 bps safety margin first, then slippageBps off
+     * that, never below the default minimum. The calldata still executes the route of the default
+     * path; the exact read must price that same route, or buildSwap refuses. A userMinOut above
+     * exactOut less the margin is refused (`min_above_exact`). One more eth_call; the swap reverts
+     * instead of filling short when the pool moves past the tolerance.
+     */
+    exact?: boolean;
 }
 interface ApprovalStep {
     token: Address;
@@ -237,6 +247,8 @@ interface SwapPlan {
     unwrapAfter: boolean;
     /** Ordered transactions to send: [approval?, swap]. */
     steps: TxRequest[];
+    /** With `exact: true`: the previewPlanExact output minOut was derived from. */
+    exactOut?: bigint;
 }
 interface SimulationResult {
     ok: boolean;
@@ -4249,7 +4261,7 @@ declare const CAUTION_IMPACT_BPS = 200;
 declare function routeIsConsistent(route: Route, tokenIn: Address, tokenOut: Address): boolean;
 declare function phoenixCheck(pv: Preview, tokenIn: Address, tokenOut: Address): QuoteChecks;
 
-type BlazeErrorCode = 'rpc_required' | 'rpc_chain_mismatch' | 'rpc_error' | 'bad_request' | 'not_deployed' | 'unsupported_by_version' | 'no_route' | 'not_executable' | 'calldata_mismatch' | 'deployment_unverified' | 'reverted' | 'wallet_chain_mismatch';
+type BlazeErrorCode = 'rpc_required' | 'rpc_chain_mismatch' | 'rpc_error' | 'bad_request' | 'not_deployed' | 'unsupported_by_version' | 'no_route' | 'not_executable' | 'calldata_mismatch' | 'min_implausible' | 'min_above_exact' | 'deployment_unverified' | 'reverted' | 'wallet_chain_mismatch';
 declare class BlazeError extends Error {
     readonly code: BlazeErrorCode;
     readonly details?: Record<string, unknown>;

package/dist/index.js

@@ -4736,8 +4736,7 @@ var CHAINS = {
     explorer: "https://basescan.org",
     weth: "0x4200000000000000000000000000000000000006",
     usdc: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-    bzpx: "0x23113e72165a034265Ab8Bf2277CCB7a85Cb7483",
-    staking: "0x3f60C7aa0c36a78D200405feBE143d2Cf3fA0c77",
+    bzpx: "0x053D75c00FdD571538492e3B1686Bd963a0911A7",
     blockTime: 2
   },
   10: {
@@ -6033,6 +6032,60 @@ var BlazePhoenix = class {
     let encodedBy = "sdk";
     let entry;
     let minOut;
+    let at;
+    if (req.exact) {
+      try {
+        at = await ctx.client.getBlockNumber();
+      } catch (e) {
+        this.wrapReadError(e, "block number");
+      }
+    }
+    const pin = at !== void 0 ? { blockNumber: at } : {};
+    let exactOut;
+    const exactRead = async (route) => {
+      let ex;
+      try {
+        ex = await ctx.client.readContract({
+          address: ctx.dep.contracts.quoter,
+          abi: QUOTER_ABI,
+          functionName: "previewPlanExact",
+          args: [tIn.address, tOut.address, amountIn],
+          ...pin
+        });
+      } catch (e) {
+        this.wrapReadError(e, "exact quote");
+      }
+      if (!samePath(ex[0], route)) {
+        throw new BlazeError("calldata_mismatch", "previewPlanExact priced a different route than the one to execute");
+      }
+      exactOut = ex[1];
+      return ex[1];
+    };
+    const settleMin = async (p) => {
+      let floor = minOutFor(p.netOut, slippageBps, p.ironFloor);
+      let ceil;
+      if (req.exact) {
+        const ex = await exactRead(p.route);
+        ceil = minOutFor(ex, EXACT_MARGIN_BPS, 0n);
+        floor = maxBig(floor, minOutFor(ceil, slippageBps, 0n));
+      }
+      if (userMinOut === 0n) return floor;
+      if (userMinOut < floor) {
+        throw new BlazeError(
+          "min_implausible",
+          `userMinOut is below ${floor} (this quote net of slippageBps): set it from a price you trust, or raise slippageBps if a lower minimum is intended`,
+          { details: { userMinOut: userMinOut.toString(), floor: floor.toString() } }
+        );
+      }
+      if (ceil !== void 0 && userMinOut > ceil && userMinOut > floor) {
+        throw new BlazeError(
+          "min_above_exact",
+          `userMinOut is above ${ceil} (exactOut less ${EXACT_MARGIN_BPS} bps): an honest swap at this minimum may revert`,
+          { details: { userMinOut: userMinOut.toString(), ceiling: ceil.toString() } }
+        );
+      }
+      return userMinOut;
+    };
     if (features.previewAndEncode && !tIn.native && mode === "route") {
       let call;
       try {
@@ -6040,19 +6093,21 @@ var BlazePhoenix = class {
           address: ctx.dep.contracts.quoter,
           abi: QUOTER_ABI,
           functionName: "previewAndEncodeWithMinOut",
-          args: [tIn.address, tOut.address, amountIn, userMinOut, recipient, deadline]
+          args: [tIn.address, tOut.address, amountIn, userMinOut, recipient, deadline],
+          ...pin
         }) : await ctx.client.readContract({
           address: ctx.dep.contracts.quoter,
           abi: QUOTER_ABI,
           functionName: "previewAndEncode",
-          args: [tIn.address, tOut.address, amountIn, recipient, deadline]
+          args: [tIn.address, tOut.address, amountIn, recipient, deadline],
+          ...pin
         });
         [pv, call] = r;
       } catch (e) {
         this.wrapReadError(e, "previewAndEncode");
       }
       assertExecutable(pv, tIn.address, tOut.address, call);
-      minOut = maxBig(minOutFor(pv.netOut, slippageBps, pv.effectiveMinOut), userMinOut);
+      minOut = await settleMin(pv);
       verifySwapExactIn(call, {
         tokenIn: tIn.address,
         tokenOut: tOut.address,
@@ -6066,9 +6121,9 @@ var BlazePhoenix = class {
       encodedBy = "quoter";
       entry = "swapExactIn";
     } else {
-      ({ pv, fb } = await this.readPreview(ctx, tIn.address, tOut.address, amountIn, userMinOut));
+      ({ pv, fb } = await this.readPreview(ctx, tIn.address, tOut.address, amountIn, userMinOut, at));
       assertExecutable(pv, tIn.address, tOut.address);
-      minOut = maxBig(minOutFor(pv.netOut, slippageBps, pv.effectiveMinOut), userMinOut);
+      minOut = await settleMin(pv);
       if (mode === "best") {
         entry = "swapBestExactIn";
         data = encodeSwapBestExactIn(tIn.address, tOut.address, amountIn, minOut, recipient, deadline);
@@ -6115,7 +6170,8 @@ var BlazePhoenix = class {
       slippageBps,
       approval,
       unwrapAfter: tOut.native,
-      steps: approval ? [approval.tx, tx] : [tx]
+      steps: approval ? [approval.tx, tx] : [tx],
+      ...exactOut !== void 0 ? { exactOut } : {}
     };
   }
   /** eth_call the swap from `from` on your RPC: the realised amountOut if it
@@ -6356,6 +6412,17 @@ function checkDeadlineSec(n) {
   return n;
 }
 var maxBig = (a, b) => a > b ? a : b;
+var EXACT_MARGIN_BPS = 50;
+function samePath(a, b) {
+  const eqA = (x, y) => x.toLowerCase() === y.toLowerCase();
+  return a.hops.length === b.hops.length && a.hops.every((h, i) => {
+    const g = b.hops[i];
+    return eqA(h.tokenIn, g.tokenIn) && eqA(h.tokenOut, g.tokenOut) && h.legs.length === g.legs.length && h.legs.every((l, j) => {
+      const m = g.legs[j];
+      return eqA(l.pool, m.pool) && eqA(l.hooks, m.hooks) && l.kind === m.kind && l.fee === m.fee && l.tickSpacing === m.tickSpacing && l.zeroForOne === m.zeroForOne && l.stable === m.stable;
+    });
+  });
+}
 function deepLink(opts = {}) {
   const base = (opts.baseUrl ?? "https://blazephoenix.xyz").replace(/\/+$/, "");
   const sp = new URLSearchParams();