@moveindustries/near-intents-sdk 0.0.1 → 0.0.2

package/README.md

@@ -25,6 +25,7 @@ const res = await quoteDeposit({
   amount: "1000000",        // 1.0 USDC, in the origin asset's smallest units
   recipient: "0xYourMovementAddress",
   refundTo: "0xYourEthereumAddress",
+  minAmountOut: "995000",   // required floor in the destination asset's smallest units; throws if the quote's guaranteed output is lower. Pass "0" to opt out.
   // slippageTolerance: 100, // basis points, defaults to 100 (1%); raise it for `destinationAsset: "move"`
 });
 const { depositAddress, amountOut, deadline } = res.quote;

package/dist/quote.d.ts

@@ -8,6 +8,7 @@ export type QuoteDepositParams = {
     recipient: string;
     refundTo: string;
     slippageTolerance?: number;
+    minAmountOut: string;
     deadline?: string;
     dry?: boolean;
 };

package/dist/quote.js

@@ -15,7 +15,10 @@ export async function quoteDeposit(p) {
     const deadline = p.deadline ?? new Date(Date.now() + 600_000).toISOString();
     if (Date.parse(deadline) <= Date.now())
         throw new Error(`deadline is in the past: ${deadline}`);
-    return OneClickService.getQuote({
+    if (!/^[0-9]+$/.test(p.minAmountOut)) {
+        throw new Error(`minAmountOut must be a non-negative integer string ("0" opts out of the floor): ${p.minAmountOut}`);
+    }
+    const res = await OneClickService.getQuote({
         dry: p.dry ?? false,
         swapType: QuoteRequest.swapType.EXACT_INPUT,
         slippageTolerance: p.slippageTolerance ?? 100,
@@ -29,4 +32,12 @@ export async function quoteDeposit(p) {
         refundType: QuoteRequest.refundType.ORIGIN_CHAIN,
         deadline,
     });
+    // Guard against a poorly-priced quote: compare the caller's floor against the quote's
+    // guaranteed output (minAmountOut after slippage), not the expected amountOut, so the check
+    // holds even in the worst-case execution the quote permits. A floor of 0 opts out.
+    const floor = BigInt(p.minAmountOut);
+    if (floor > 0n && BigInt(res.quote.minAmountOut) < floor) {
+        throw new Error(`quote below floor: guaranteed minAmountOut ${res.quote.minAmountOut} < minAmountOut ${p.minAmountOut}`);
+    }
+    return res;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moveindustries/near-intents-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Thin SDK: USDT/USDC -> Movement USDCx/MOVE over NEAR Intents 1Click.",
   "type": "module",
   "main": "dist/index.js",