@shapeshiftoss/swapper 19.0.0 → 20.0.0

package/dist/cjs/exactOutputFiltering.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/exactOutputFiltering.test.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const constants_1 = require("./constants");
+const swapper_1 = require("./swapper");
+const types_1 = require("./types");
+const assets_1 = require("./utils/test-data/assets");
+// Exact-output support is structural - a swapper cannot claim it without implementing it
+(0, vitest_1.describe)('exact output capability', () => {
+    (0, vitest_1.it)('is implemented by the swappers whose upstream API can honour an exact buy amount', () => {
+        for (const swapperName of [types_1.SwapperName.NearIntents, types_1.SwapperName.Relay]) {
+            (0, vitest_1.expect)(constants_1.swappers[swapperName]?.getExactOutputTradeRate).toBeDefined();
+            (0, vitest_1.expect)(constants_1.swappers[swapperName]?.getExactOutputTradeQuote).toBeDefined();
+        }
+    });
+    (0, vitest_1.it)('is absent everywhere else', () => {
+        const exactOutputCapable = Object.values(types_1.SwapperName).filter(swapperName => constants_1.swappers[swapperName]?.getExactOutputTradeRate !== undefined);
+        (0, vitest_1.expect)(exactOutputCapable).toEqual([types_1.SwapperName.Relay, types_1.SwapperName.NearIntents]);
+    });
+});
+const exactOutputInput = {
+    sellAsset: assets_1.ETH,
+    buyAsset: assets_1.BTC,
+    buyAmountCryptoBaseUnit: '100000',
+    affiliateBps: '0',
+    allowMultiHop: true,
+    receiveAddress: undefined,
+    accountNumber: undefined,
+    quoteOrRate: 'rate',
+};
+const deps = {};
+(0, vitest_1.describe)('getTradeRates on an exact buy amount', () => {
+    // Silently omitting these would read as the swapper being unavailable rather than unable
+    (0, vitest_1.it)('reports an error for a swapper that cannot quote one', async () => {
+        const result = await (0, swapper_1.getTradeRates)(exactOutputInput, types_1.SwapperName.Thorchain, deps);
+        (0, vitest_1.expect)(result).toBeDefined();
+        (0, vitest_1.expect)(result?.isErr()).toBe(true);
+        (0, vitest_1.expect)(result?.unwrapErr().code).toEqual(types_1.TradeQuoteError.ExactOutputNotSupported);
+        (0, vitest_1.expect)(result?.swapperName).toEqual(types_1.SwapperName.Thorchain);
+    });
+    (0, vitest_1.it)('skips entirely on a zero buy amount', async () => {
+        const result = await (0, swapper_1.getTradeRates)({ ...exactOutputInput, buyAmountCryptoBaseUnit: '0' }, types_1.SwapperName.Thorchain, deps);
+        (0, vitest_1.expect)(result).toBeUndefined();
+    });
+    // The base-unit regex upstream admits padded zeros, so the check can't be a string comparison
+    (0, vitest_1.it)('skips entirely on a padded zero buy amount', async () => {
+        const result = await (0, swapper_1.getTradeRates)({ ...exactOutputInput, buyAmountCryptoBaseUnit: '00' }, types_1.SwapperName.Thorchain, deps);
+        (0, vitest_1.expect)(result).toBeUndefined();
+    });
+});
+// Quotes dispatch on the same input shape as rates, so they gate the same way
+(0, vitest_1.describe)('getTradeQuotes on an exact buy amount', () => {
+    const exactOutputQuoteInput = {
+        ...exactOutputInput,
+        receiveAddress: 'bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq',
+        accountNumber: 0,
+        quoteOrRate: 'quote',
+    };
+    (0, vitest_1.it)('reports an error for a swapper that cannot quote one', async () => {
+        const result = await (0, swapper_1.getTradeQuotes)(exactOutputQuoteInput, types_1.SwapperName.Thorchain, deps);
+        (0, vitest_1.expect)(result).toBeDefined();
+        (0, vitest_1.expect)(result?.isErr()).toBe(true);
+        (0, vitest_1.expect)(result?.unwrapErr().code).toEqual(types_1.TradeQuoteError.ExactOutputNotSupported);
+        (0, vitest_1.expect)(result?.swapperName).toEqual(types_1.SwapperName.Thorchain);
+    });
+    (0, vitest_1.it)('skips entirely on a zero buy amount', async () => {
+        const result = await (0, swapper_1.getTradeQuotes)({ ...exactOutputQuoteInput, buyAmountCryptoBaseUnit: '0' }, types_1.SwapperName.Thorchain, deps);
+        (0, vitest_1.expect)(result).toBeUndefined();
+    });
+});

package/dist/cjs/swapper.d.ts

@@ -1,3 +1,3 @@
-import type { GetTradeQuoteInput, GetTradeRateInput, QuoteResult, RateResult, SwapperDeps, SwapperName } from './types';
-export declare const getTradeQuotes: (getTradeQuoteInput: GetTradeQuoteInput, swapperName: SwapperName, deps: SwapperDeps) => Promise<QuoteResult | undefined>;
-export declare const getTradeRates: (getTradeRateInput: GetTradeRateInput, swapperName: SwapperName, deps: SwapperDeps, quoteTimeoutMs?: number) => Promise<RateResult | undefined>;
+import type { GetExactOutputTradeQuoteInput, GetExactOutputTradeRateInput, GetTradeQuoteInput, GetTradeRateInput, QuoteResult, RateResult, SwapperDeps, SwapperName } from './types';
+export declare const getTradeQuotes: (getTradeQuoteInput: GetTradeQuoteInput | GetExactOutputTradeQuoteInput, swapperName: SwapperName, deps: SwapperDeps) => Promise<QuoteResult | undefined>;
+export declare const getTradeRates: (getTradeRateInput: GetTradeRateInput | GetExactOutputTradeRateInput, swapperName: SwapperName, deps: SwapperDeps, quoteTimeoutMs?: number) => Promise<RateResult | undefined>;

package/dist/cjs/swapper.js

@@ -2,19 +2,33 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTradeRates = exports.getTradeQuotes = void 0;
 const utils_1 = require("@shapeshiftoss/utils");
+const monads_1 = require("@sniptt/monads");
 const constants_1 = require("./constants");
 const types_1 = require("./types");
 const utils_2 = require("./utils");
+const EXACT_OUTPUT_NOT_SUPPORTED_ERROR = (0, utils_2.makeSwapErrorRight)({
+    code: types_1.TradeQuoteError.ExactOutputNotSupported,
+    message: 'This swapper cannot derive a sell amount from an exact buy amount',
+});
 const getTradeQuotes = async (getTradeQuoteInput, swapperName, deps) => {
     if ((0, utils_1.bnOrZero)(getTradeQuoteInput.affiliateBps).lt(0))
         return;
-    if (getTradeQuoteInput.sellAmountIncludingProtocolFeesCryptoBaseUnit === '0')
-        return;
     const swapper = constants_1.swappers[swapperName];
     if (swapper === undefined)
         return;
+    // Compared numerically so a padded zero can't slip through as an amount
+    const drivingAmount = 'buyAmountCryptoBaseUnit' in getTradeQuoteInput
+        ? getTradeQuoteInput.buyAmountCryptoBaseUnit
+        : getTradeQuoteInput.sellAmountIncludingProtocolFeesCryptoBaseUnit;
+    if ((0, utils_1.bnOrZero)(drivingAmount).isZero())
+        return;
+    const quotePromise = 'buyAmountCryptoBaseUnit' in getTradeQuoteInput
+        ? swapper.getExactOutputTradeQuote?.(getTradeQuoteInput, deps)
+        : swapper.getTradeQuote(getTradeQuoteInput, deps);
+    if (!quotePromise)
+        return { ...(0, monads_1.Err)(EXACT_OUTPUT_NOT_SUPPORTED_ERROR), swapperName };
     try {
-        const quote = await (0, utils_1.timeoutMonadic)(swapper.getTradeQuote(getTradeQuoteInput, deps), constants_1.QUOTE_TIMEOUT_MS, constants_1.QUOTE_TIMEOUT_ERROR);
+        const quote = await (0, utils_1.timeoutMonadic)(quotePromise, constants_1.QUOTE_TIMEOUT_MS, constants_1.QUOTE_TIMEOUT_ERROR);
         return {
             ...quote,
             swapperName,
@@ -30,13 +44,22 @@ exports.getTradeQuotes = getTradeQuotes;
 const getTradeRates = async (getTradeRateInput, swapperName, deps, quoteTimeoutMs = constants_1.QUOTE_TIMEOUT_MS) => {
     if ((0, utils_1.bnOrZero)(getTradeRateInput.affiliateBps).lt(0))
         return;
-    if (getTradeRateInput.sellAmountIncludingProtocolFeesCryptoBaseUnit === '0')
-        return;
     const swapper = constants_1.swappers[swapperName];
     if (swapper === undefined)
         return;
+    // Compared numerically so a padded zero can't slip through as an amount
+    const drivingAmount = 'buyAmountCryptoBaseUnit' in getTradeRateInput
+        ? getTradeRateInput.buyAmountCryptoBaseUnit
+        : getTradeRateInput.sellAmountIncludingProtocolFeesCryptoBaseUnit;
+    if ((0, utils_1.bnOrZero)(drivingAmount).isZero())
+        return;
+    const ratePromise = 'buyAmountCryptoBaseUnit' in getTradeRateInput
+        ? swapper.getExactOutputTradeRate?.(getTradeRateInput, deps)
+        : swapper.getTradeRate(getTradeRateInput, deps);
+    if (!ratePromise)
+        return { ...(0, monads_1.Err)(EXACT_OUTPUT_NOT_SUPPORTED_ERROR), swapperName };
     try {
-        const { timed, original } = (0, utils_1.timeoutMonadicWithOriginal)(swapper.getTradeRate(getTradeRateInput, deps), quoteTimeoutMs, (0, utils_2.makeSwapErrorRight)({
+        const { timed, original } = (0, utils_1.timeoutMonadicWithOriginal)(ratePromise, quoteTimeoutMs, (0, utils_2.makeSwapErrorRight)({
             code: types_1.TradeQuoteError.Timeout,
             message: `quote timed out after ${quoteTimeoutMs / 1000}s`,
         }));

package/dist/cjs/swappers/AcrossSwapper/utils/getAcrossStepData.d.ts

@@ -3,6 +3,7 @@ import type { StepDataArgs, SwapErrorRight, TxBuildData } from '../../../types';
 import type { AcrossSwapTx } from './types';
 type BaseArgs = {
     swapTx: AcrossSwapTx;
+    sellAmountCryptoBaseUnit: string;
     spenderAddress: string;
     fallbackNetworkFeeCryptoBaseUnit: string;
 };

package/dist/cjs/swappers/AcrossSwapper/utils/getAcrossStepData.js

@@ -10,7 +10,7 @@ const utils_2 = require("../../../utils");
 const evm_1 = require("../../../utils/evm");
 const solana_1 = require("../../../utils/solana");
 async function getAcrossStepData(args) {
-    const { swapTx, sellAsset, spenderAddress, from, type, input, fallbackNetworkFeeCryptoBaseUnit, deps, } = args;
+    const { swapTx, sellAsset, sellAmountCryptoBaseUnit, spenderAddress, from, type, input, fallbackNetworkFeeCryptoBaseUnit, deps, } = args;
     const supportsEIP1559 = 'supportsEIP1559' in input ? input.supportsEIP1559 : false;
     switch (swapTx.ecosystem) {
         case 'evm': {
@@ -25,7 +25,7 @@ async function getAcrossStepData(args) {
             };
             const stateOverride = {
                 sellAsset,
-                sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                sellAmountCryptoBaseUnit,
                 spenderAddress,
             };
             if (type === 'rate') {

package/dist/cjs/swappers/AcrossSwapper/utils/getAcrossTradeContext.js

@@ -173,6 +173,7 @@ const getAcrossTradeContext = async ({ input, deps, depositor, recipient, }) =>
         stepDataArgs: {
             swapTx: quote.swapTx,
             sellAsset,
+            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
             from: depositor,
             spenderAddress: allowanceContract,
             fallbackNetworkFeeCryptoBaseUnit: quote.fees.originGas.amount,

package/dist/cjs/swappers/BebopSwapper/utils/getBebopStepData.d.ts

@@ -3,6 +3,7 @@ import type { StepDataArgs, SwapErrorRight, TxBuildData } from '../../../types';
 import type { BebopQuoteResponse } from '../types';
 type BaseArgs = {
     tx: BebopQuoteResponse['tx'];
+    sellAmountCryptoBaseUnit: string;
     spenderAddress: string;
 };
 export type GetBebopStepDataArgs = StepDataArgs<BaseArgs, {

package/dist/cjs/swappers/BebopSwapper/utils/getBebopStepData.js

@@ -8,7 +8,7 @@ const viem_1 = require("viem");
 const utils_2 = require("../../../utils");
 const evm_1 = require("../../../utils/evm");
 async function getBebopStepData(args) {
-    const { tx, spenderAddress, sellAsset, type, input, from, deps } = args;
+    const { tx, spenderAddress, sellAsset, sellAmountCryptoBaseUnit, type, input, from, deps } = args;
     const adapter = deps.assertGetEvmChainAdapter(sellAsset.chainId);
     const supportsEIP1559 = 'supportsEIP1559' in input ? input.supportsEIP1559 : false;
     if (type === 'rate') {
@@ -43,7 +43,7 @@ async function getBebopStepData(args) {
             supportsEIP1559,
             stateOverride: {
                 sellAsset,
-                sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                sellAmountCryptoBaseUnit,
                 spenderAddress,
             },
         });

package/dist/cjs/swappers/BebopSwapper/utils/getBebopTradeContext.js

@@ -78,6 +78,7 @@ const getBebopTradeContext = async ({ input, deps, from, receiver, }) => {
             tx: quote.tx,
             spenderAddress: allowanceContract,
             sellAsset,
+            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
             from,
             deps,
         },

package/dist/cjs/swappers/DebridgeSwapper/utils/getDebridgeStepData.d.ts

@@ -3,6 +3,7 @@ import type { StepDataArgs, SwapErrorRight, TxBuildData } from '../../../types';
 import type { DebridgeTx } from './types';
 type BaseArgs = {
     tx: DebridgeTx;
+    sellAmountCryptoBaseUnit: string;
     gasLimit: string | undefined;
     spenderAddress: string;
     fallbackNetworkFeeCryptoBaseUnit: string | undefined;

package/dist/cjs/swappers/DebridgeSwapper/utils/getDebridgeStepData.js

@@ -6,7 +6,7 @@ const monads_1 = require("@sniptt/monads");
 const utils_1 = require("../../../utils");
 const evm_1 = require("../../../utils/evm");
 async function getDebridgeStepData(args) {
-    const { tx, gasLimit, spenderAddress, fallbackNetworkFeeCryptoBaseUnit, sellAsset, from, type, input, deps, } = args;
+    const { tx, sellAmountCryptoBaseUnit, gasLimit, spenderAddress, fallbackNetworkFeeCryptoBaseUnit, sellAsset, from, type, input, deps, } = args;
     const adapter = deps.assertGetEvmChainAdapter(sellAsset.chainId);
     const supportsEIP1559 = 'supportsEIP1559' in input ? input.supportsEIP1559 : false;
     const transactionData = {
@@ -19,7 +19,7 @@ async function getDebridgeStepData(args) {
     };
     const stateOverride = {
         sellAsset,
-        sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+        sellAmountCryptoBaseUnit,
         spenderAddress,
     };
     if (type === 'rate') {

package/dist/cjs/swappers/DebridgeSwapper/utils/getDebridgeTradeContext.js

@@ -84,6 +84,7 @@ const getDebridgeTradeContext = async ({ input, deps, senderAddress, recipientAd
         protocolFees: quote.protocolFees,
         stepDataArgs: {
             tx: quote.tx,
+            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
             gasLimit: quote.gasLimit,
             fallbackNetworkFeeCryptoBaseUnit: quote.fallbackNetworkFeeCryptoBaseUnit,
             sellAsset,

package/dist/cjs/swappers/NearIntentsSwapper/endpoints.js

@@ -14,6 +14,8 @@ const oneClickService_1 = require("./utils/oneClickService");
 exports.nearIntentsApi = {
     getTradeQuote: (input, deps) => (0, getTradeQuote_1.getTradeQuote)(input, deps),
     getTradeRate: (input, deps) => (0, getTradeRate_1.getTradeRate)(input, deps),
+    getExactOutputTradeQuote: (input, deps) => (0, getTradeQuote_1.getExactOutputTradeQuote)(input, deps),
+    getExactOutputTradeRate: (input, deps) => (0, getTradeRate_1.getExactOutputTradeRate)(input, deps),
     getUnsignedEvmTransaction: evm_1.getUnsignedEvmTransaction,
     getEvmTransactionFees: evm_1.getEvmTransactionFees,
     getUnsignedUtxoTransaction: utxo_1.getUnsignedUtxoTransaction,

package/dist/cjs/swappers/NearIntentsSwapper/swapperApi/getTradeQuote.d.ts

@@ -1,4 +1,5 @@
 import type { Result } from '@sniptt/monads';
 import type { SwapErrorRight, SwapperDeps, TradeQuote } from '../../../types';
-import type { NearIntentsTradeQuoteInput } from '../types';
+import type { NearIntentsExactOutputTradeQuoteInput, NearIntentsTradeQuoteInput } from '../types';
 export declare const getTradeQuote: (input: NearIntentsTradeQuoteInput, deps: SwapperDeps) => Promise<Result<TradeQuote[], SwapErrorRight>>;
+export declare const getExactOutputTradeQuote: (input: NearIntentsExactOutputTradeQuoteInput, deps: SwapperDeps) => Promise<Result<TradeQuote[], SwapErrorRight>>;

package/dist/cjs/swappers/NearIntentsSwapper/swapperApi/getTradeQuote.js

@@ -1,37 +1,39 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTradeQuote = void 0;
+exports.getExactOutputTradeQuote = exports.getTradeQuote = void 0;
 const monads_1 = require("@sniptt/monads");
 const utils_1 = require("../../../utils");
+const helpers_1 = require("../../../utils/helpers");
 const types_1 = require("../types");
 const getNearIntentsStepData_1 = require("../utils/getNearIntentsStepData");
 const getNearIntentsTradeContext_1 = require("../utils/getNearIntentsTradeContext");
-const helpers_1 = require("../utils/helpers");
+const helpers_2 = require("../utils/helpers");
 const oneClickService_1 = require("../utils/oneClickService");
-const getTradeQuote = async (input, deps) => {
-    const { sellAsset, buyAsset, accountNumber, affiliateBps, sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount, } = input;
+const getQuote = async (input, deps) => {
+    const { sellAsset, buyAsset, accountNumber, affiliateBps } = input;
     const addresses = (0, utils_1.assertQuoteAddresses)(input);
     if (addresses.isErr())
         return (0, monads_1.Err)(addresses.unwrapErr());
     const { sendAddress, receiveAddress } = addresses.unwrap();
     (0, oneClickService_1.initializeOneClickService)(deps.config.VITE_NEAR_INTENTS_API_KEY);
-    const maybeAssets = await (0, helpers_1.resolveNearIntentsAssets)({ sellAsset, buyAsset });
+    const amount = (0, helpers_1.getTradeAmount)(input);
+    const maybeAssets = await (0, helpers_2.resolveNearIntentsAssets)({ sellAsset, buyAsset });
     if (maybeAssets.isErr())
         return (0, monads_1.Err)(maybeAssets.unwrapErr());
     const { originAsset, destinationAsset } = maybeAssets.unwrap();
-    const quoteRequest = (0, helpers_1.buildNearIntentsQuoteRequest)({
+    const quoteRequest = (0, helpers_2.buildNearIntentsQuoteRequest)({
         originAsset,
         destinationAsset,
-        sellAmountCryptoBaseUnit: sellAmount,
+        amount,
         slippageTolerancePercentageDecimal: input.slippageTolerancePercentageDecimal,
         affiliateBps,
         refundTo: sendAddress,
         recipient: receiveAddress,
         refundType: types_1.QuoteRequest.refundType.ORIGIN_CHAIN,
         recipientType: types_1.QuoteRequest.recipientType.DESTINATION_CHAIN,
-        deadline: (0, helpers_1.getNearIntentsQuoteDeadline)({ sellAsset, buyAsset }),
+        deadline: (0, helpers_2.getNearIntentsQuoteDeadline)({ sellAsset, buyAsset }),
     });
-    const maybeQuoteResponse = await (0, helpers_1.fetchNearIntentsQuote)({ quoteRequest, sellAsset });
+    const maybeQuoteResponse = await (0, helpers_2.fetchNearIntentsQuote)({ quoteRequest, sellAsset });
     if (maybeQuoteResponse.isErr())
         return (0, monads_1.Err)(maybeQuoteResponse.unwrapErr());
     const { quote } = maybeQuoteResponse.unwrap();
@@ -75,4 +77,7 @@ const getTradeQuote = async (input, deps) => {
     };
     return (0, monads_1.Ok)([tradeQuote]);
 };
+const getTradeQuote = (input, deps) => getQuote(input, deps);
 exports.getTradeQuote = getTradeQuote;
+const getExactOutputTradeQuote = (input, deps) => getQuote(input, deps);
+exports.getExactOutputTradeQuote = getExactOutputTradeQuote;

package/dist/cjs/swappers/NearIntentsSwapper/swapperApi/getTradeRate.d.ts

@@ -1,4 +1,5 @@
 import type { Result } from '@sniptt/monads';
 import type { SwapErrorRight, SwapperDeps, TradeRate } from '../../../types';
-import type { NearIntentsTradeRateInput } from '../types';
+import type { NearIntentsExactOutputTradeRateInput, NearIntentsTradeRateInput } from '../types';
 export declare const getTradeRate: (input: NearIntentsTradeRateInput, deps: SwapperDeps) => Promise<Result<TradeRate[], SwapErrorRight>>;
+export declare const getExactOutputTradeRate: (input: NearIntentsExactOutputTradeRateInput, deps: SwapperDeps) => Promise<Result<TradeRate[], SwapErrorRight>>;

package/dist/cjs/swappers/NearIntentsSwapper/swapperApi/getTradeRate.js

@@ -1,23 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getTradeRate = void 0;
+exports.getExactOutputTradeRate = exports.getTradeRate = void 0;
 const monads_1 = require("@sniptt/monads");
+const helpers_1 = require("../../../utils/helpers");
 const types_1 = require("../types");
 const getNearIntentsStepData_1 = require("../utils/getNearIntentsStepData");
 const getNearIntentsTradeContext_1 = require("../utils/getNearIntentsTradeContext");
-const helpers_1 = require("../utils/helpers");
+const helpers_2 = require("../utils/helpers");
 const oneClickService_1 = require("../utils/oneClickService");
-const getTradeRate = async (input, deps) => {
-    const { accountNumber, sellAsset, buyAsset, affiliateBps, sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount, receiveAddress, sendAddress, } = input;
+const getRate = async (input, deps) => {
+    const { accountNumber, sellAsset, buyAsset, affiliateBps, receiveAddress, sendAddress } = input;
     (0, oneClickService_1.initializeOneClickService)(deps.config.VITE_NEAR_INTENTS_API_KEY);
-    const maybeAssets = await (0, helpers_1.resolveNearIntentsAssets)({ sellAsset, buyAsset });
+    const amount = (0, helpers_1.getTradeAmount)(input);
+    const maybeAssets = await (0, helpers_2.resolveNearIntentsAssets)({ sellAsset, buyAsset });
     if (maybeAssets.isErr())
         return (0, monads_1.Err)(maybeAssets.unwrapErr());
     const { originAsset, destinationAsset } = maybeAssets.unwrap();
-    const quoteRequest = (0, helpers_1.buildNearIntentsQuoteRequest)({
+    const quoteRequest = (0, helpers_2.buildNearIntentsQuoteRequest)({
         originAsset,
         destinationAsset,
-        sellAmountCryptoBaseUnit: sellAmount,
+        amount,
         slippageTolerancePercentageDecimal: input.slippageTolerancePercentageDecimal,
         affiliateBps,
         refundTo: sendAddress ?? 'check-price',
@@ -28,9 +30,9 @@ const getTradeRate = async (input, deps) => {
         recipientType: sendAddress
             ? types_1.QuoteRequest.recipientType.DESTINATION_CHAIN
             : types_1.QuoteRequest.recipientType.INTENTS,
-        deadline: (0, helpers_1.getNearIntentsQuoteDeadline)({ sellAsset, buyAsset }),
+        deadline: (0, helpers_2.getNearIntentsQuoteDeadline)({ sellAsset, buyAsset }),
     });
-    const maybeQuoteResponse = await (0, helpers_1.fetchNearIntentsQuote)({ quoteRequest, sellAsset });
+    const maybeQuoteResponse = await (0, helpers_2.fetchNearIntentsQuote)({ quoteRequest, sellAsset });
     if (maybeQuoteResponse.isErr())
         return (0, monads_1.Err)(maybeQuoteResponse.unwrapErr());
     const { quote } = maybeQuoteResponse.unwrap();
@@ -61,4 +63,7 @@ const getTradeRate = async (input, deps) => {
     };
     return (0, monads_1.Ok)([tradeRate]);
 };
+const getTradeRate = (input, deps) => getRate(input, deps);
 exports.getTradeRate = getTradeRate;
+const getExactOutputTradeRate = (input, deps) => getRate(input, deps);
+exports.getExactOutputTradeRate = getExactOutputTradeRate;

package/dist/cjs/swappers/NearIntentsSwapper/types.d.ts

@@ -1,7 +1,9 @@
 import { KnownChainIds } from '@shapeshiftoss/types';
-import type { GetEvmTradeQuoteInput, GetEvmTradeRateInput, GetNearTradeQuoteInput, GetNearTradeRateInput, GetSolanaTradeQuoteInput, GetSolanaTradeRateInput, GetStarknetTradeQuoteInput, GetStarknetTradeRateInput, GetSuiTradeQuoteInput, GetSuiTradeRateInput, GetTonTradeQuoteInput, GetTonTradeRateInput, GetTronTradeQuoteInput, GetTronTradeRateInput, GetUtxoTradeQuoteInput, GetUtxoTradeRateInput } from '../../types';
+import type { GetEvmTradeQuoteInput, GetEvmTradeRateInput, GetNearTradeQuoteInput, GetNearTradeRateInput, GetSolanaTradeQuoteInput, GetSolanaTradeRateInput, GetStarknetTradeQuoteInput, GetStarknetTradeRateInput, GetSuiTradeQuoteInput, GetSuiTradeRateInput, GetTonTradeQuoteInput, GetTonTradeRateInput, GetTronTradeQuoteInput, GetTronTradeRateInput, GetUtxoTradeQuoteInput, GetUtxoTradeRateInput, WithExactBuyAmount } from '../../types';
 export type NearIntentsTradeQuoteInput = GetEvmTradeQuoteInput | GetUtxoTradeQuoteInput | GetSolanaTradeQuoteInput | GetTronTradeQuoteInput | GetSuiTradeQuoteInput | GetStarknetTradeQuoteInput | GetNearTradeQuoteInput | GetTonTradeQuoteInput;
 export type NearIntentsTradeRateInput = GetEvmTradeRateInput | GetUtxoTradeRateInput | GetSolanaTradeRateInput | GetTronTradeRateInput | GetSuiTradeRateInput | GetStarknetTradeRateInput | GetNearTradeRateInput | GetTonTradeRateInput;
+export type NearIntentsExactOutputTradeQuoteInput = WithExactBuyAmount<NearIntentsTradeQuoteInput>;
+export type NearIntentsExactOutputTradeRateInput = WithExactBuyAmount<NearIntentsTradeRateInput>;
 export type NearIntentsMetadata = {
     name: 'nearIntents';
     depositAddress: string;

package/dist/cjs/swappers/NearIntentsSwapper/utils/exactOutput.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/swappers/NearIntentsSwapper/utils/exactOutput.test.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const types_1 = require("../types");
+const helpers_1 = require("./helpers");
+const BASE_ARGS = {
+    originAsset: 'nep141:base-0x833589fcd6edb6e08f4c7c32d4f71b54bda02913.omft.near',
+    destinationAsset: 'nep141:btc.omft.near',
+    amount: { direction: 'exactIn', cryptoBaseUnit: '65000000' },
+    slippageTolerancePercentageDecimal: '0.01',
+    affiliateBps: '10',
+    refundTo: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+    recipient: 'bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4',
+    refundType: types_1.QuoteRequest.refundType.ORIGIN_CHAIN,
+    recipientType: types_1.QuoteRequest.recipientType.DESTINATION_CHAIN,
+    deadline: '2026-08-10T23:59:00.000Z',
+};
+const EXACT_OUTPUT_AMOUNT = {
+    direction: 'exactOut',
+    cryptoBaseUnit: '100000',
+};
+(0, vitest_1.describe)('buildNearIntentsQuoteRequest', () => {
+    (0, vitest_1.describe)('exact input', () => {
+        (0, vitest_1.it)('requests EXACT_INPUT with the sell amount', () => {
+            const request = (0, helpers_1.buildNearIntentsQuoteRequest)(BASE_ARGS);
+            (0, vitest_1.expect)(request.swapType).toEqual(types_1.QuoteRequest.swapType.EXACT_INPUT);
+            (0, vitest_1.expect)(request.amount).toEqual('65000000');
+        });
+        (0, vitest_1.it)('passes the requested slippage through untouched', () => {
+            const request = (0, helpers_1.buildNearIntentsQuoteRequest)({
+                ...BASE_ARGS,
+                slippageTolerancePercentageDecimal: '0',
+            });
+            (0, vitest_1.expect)(request.slippageTolerance).toEqual(0);
+        });
+    });
+    (0, vitest_1.describe)('exact output', () => {
+        (0, vitest_1.it)('requests EXACT_OUTPUT with the buy amount', () => {
+            const request = (0, helpers_1.buildNearIntentsQuoteRequest)({ ...BASE_ARGS, amount: EXACT_OUTPUT_AMOUNT });
+            (0, vitest_1.expect)(request.swapType).toEqual(types_1.QuoteRequest.swapType.EXACT_OUTPUT);
+            (0, vitest_1.expect)(request.amount).toEqual('100000');
+        });
+        // A tighter band is the user's call - the failure mode is a refund, not a loss
+        (0, vitest_1.it)('passes a requested zero slippage through untouched, as exact input does', () => {
+            const request = (0, helpers_1.buildNearIntentsQuoteRequest)({
+                ...BASE_ARGS,
+                amount: EXACT_OUTPUT_AMOUNT,
+                slippageTolerancePercentageDecimal: '0',
+            });
+            (0, vitest_1.expect)(request.slippageTolerance).toEqual(0);
+        });
+        (0, vitest_1.it)('honours a requested slippage', () => {
+            const request = (0, helpers_1.buildNearIntentsQuoteRequest)({
+                ...BASE_ARGS,
+                amount: EXACT_OUTPUT_AMOUNT,
+                slippageTolerancePercentageDecimal: '0.05',
+            });
+            (0, vitest_1.expect)(request.slippageTolerance).toEqual(500);
+        });
+    });
+});

package/dist/cjs/swappers/NearIntentsSwapper/utils/getNearIntentsTradeContext.d.ts

@@ -1,7 +1,7 @@
 import type { Asset } from '@shapeshiftoss/types';
 import type { Result } from '@sniptt/monads';
 import type { QuoteFeeData, SwapErrorRight, SwapperDeps, TradeCommon, TradeStepCommon } from '../../../types';
-import type { NearIntentsTradeQuoteInput, NearIntentsTradeRateInput, QuoteResponse } from '../types';
+import type { NearIntentsExactOutputTradeQuoteInput, NearIntentsExactOutputTradeRateInput, NearIntentsTradeQuoteInput, NearIntentsTradeRateInput, QuoteResponse } from '../types';
 type NearIntentsTradeContext = {
     tradeCommon: TradeCommon;
     stepCommon: Omit<TradeStepCommon, 'feeData'>;
@@ -14,7 +14,7 @@ type NearIntentsTradeContext = {
     };
 };
 export declare const getNearIntentsTradeContext: ({ input, deps, quote, }: {
-    input: NearIntentsTradeQuoteInput | NearIntentsTradeRateInput;
+    input: NearIntentsTradeQuoteInput | NearIntentsTradeRateInput | NearIntentsExactOutputTradeQuoteInput | NearIntentsExactOutputTradeRateInput;
     deps: SwapperDeps;
     quote: QuoteResponse['quote'];
 }) => Result<NearIntentsTradeContext, SwapErrorRight>;

package/dist/cjs/swappers/NearIntentsSwapper/utils/getNearIntentsTradeContext.js

@@ -10,7 +10,7 @@ const types_1 = require("../../../types");
 const utils_2 = require("../../../utils");
 const affiliateFee_1 = require("../../../utils/affiliateFee");
 const getNearIntentsTradeContext = ({ input, deps, quote, }) => {
-    const { sellAsset, buyAsset, affiliateBps, sellAmountIncludingProtocolFeesCryptoBaseUnit, slippageTolerancePercentageDecimal, } = input;
+    const { sellAsset, buyAsset, affiliateBps, slippageTolerancePercentageDecimal } = input;
     if (!quote.depositAddress)
         return (0, monads_1.Err)((0, utils_2.makeTradeStepBuildFailedErr)('getNearIntentsTradeContext'));
     const rate = (0, utils_2.getInputOutputRate)({
@@ -19,11 +19,13 @@ const getNearIntentsTradeContext = ({ input, deps, quote, }) => {
         sellAsset,
         buyAsset,
     });
+    const isExactOutput = 'buyAmountCryptoBaseUnit' in input;
     return (0, monads_1.Ok)({
         tradeCommon: {
             id: (0, uuid_1.v4)(),
             rate,
             swapperName: types_1.SwapperName.NearIntents,
+            isExactOutput,
             affiliateBps,
             slippageTolerancePercentageDecimal: slippageTolerancePercentageDecimal ??
                 (0, constants_1.getDefaultSlippageDecimalPercentageForSwapper)(types_1.SwapperName.NearIntents),
@@ -54,7 +56,7 @@ const getNearIntentsTradeContext = ({ input, deps, quote, }) => {
         stepDataArgs: {
             deps,
             sellAsset,
-            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            sellAmountCryptoBaseUnit: quote.amountIn,
             depositAddress: quote.depositAddress,
         },
     });

package/dist/cjs/swappers/NearIntentsSwapper/utils/helpers.d.ts

@@ -1,7 +1,7 @@
 import type { Asset } from '@shapeshiftoss/types';
 import { TxStatus } from '@shapeshiftoss/unchained-client';
 import type { Result } from '@sniptt/monads';
-import type { SwapErrorRight } from '../../../types';
+import type { SwapErrorRight, TradeAmount } from '../../../types';
 import type { GetExecutionStatusResponse, QuoteResponse } from '../types';
 import { QuoteRequest } from '../types';
 export declare const getNearIntentsAsset: ({ nearNetwork, contractAddress, }: {
@@ -20,10 +20,10 @@ export declare const getNearIntentsQuoteDeadline: ({ sellAsset, buyAsset, }: {
     sellAsset: Asset;
     buyAsset: Asset;
 }) => string;
-export declare const buildNearIntentsQuoteRequest: ({ originAsset, destinationAsset, sellAmountCryptoBaseUnit, slippageTolerancePercentageDecimal, affiliateBps, refundTo, recipient, refundType, recipientType, deadline, }: {
+export declare const buildNearIntentsQuoteRequest: ({ originAsset, destinationAsset, amount, slippageTolerancePercentageDecimal, affiliateBps, refundTo, recipient, refundType, recipientType, deadline, }: {
     originAsset: string;
     destinationAsset: string;
-    sellAmountCryptoBaseUnit: string;
+    amount: TradeAmount;
     slippageTolerancePercentageDecimal: string | undefined;
     affiliateBps: string;
     refundTo: string;

package/dist/cjs/swappers/NearIntentsSwapper/utils/helpers.js

@@ -134,29 +134,33 @@ const getNearIntentsQuoteDeadline = ({ sellAsset, buyAsset, }) => {
     return new Date(Date.now() + deadlineMs).toISOString();
 };
 exports.getNearIntentsQuoteDeadline = getNearIntentsQuoteDeadline;
-const buildNearIntentsQuoteRequest = ({ originAsset, destinationAsset, sellAmountCryptoBaseUnit, slippageTolerancePercentageDecimal, affiliateBps, refundTo, recipient, refundType, recipientType, deadline, }) => ({
-    dry: false,
-    swapType: types_2.QuoteRequest.swapType.EXACT_INPUT,
-    slippageTolerance: slippageTolerancePercentageDecimal
-        ? (0, utils_1.bnOrZero)(slippageTolerancePercentageDecimal).times(10000).toNumber()
-        : constants_1.DEFAULT_SLIPPAGE_BPS,
-    originAsset,
-    destinationAsset,
-    amount: sellAmountCryptoBaseUnit,
-    depositType: types_2.QuoteRequest.depositType.ORIGIN_CHAIN,
-    refundTo,
-    refundType,
-    recipient,
-    recipientType,
-    deadline,
-    referral: 'shapeshift',
-    appFees: [
-        {
-            recipient: utils_1.DAO_TREASURY_NEAR,
-            fee: Number(affiliateBps),
-        },
-    ],
-});
+const buildNearIntentsQuoteRequest = ({ originAsset, destinationAsset, amount, slippageTolerancePercentageDecimal, affiliateBps, refundTo, recipient, refundType, recipientType, deadline, }) => {
+    return {
+        dry: false,
+        swapType: amount.direction === 'exactOut'
+            ? types_2.QuoteRequest.swapType.EXACT_OUTPUT
+            : types_2.QuoteRequest.swapType.EXACT_INPUT,
+        slippageTolerance: slippageTolerancePercentageDecimal
+            ? (0, utils_1.bnOrZero)(slippageTolerancePercentageDecimal).times(10000).toNumber()
+            : constants_1.DEFAULT_SLIPPAGE_BPS,
+        originAsset,
+        destinationAsset,
+        amount: amount.cryptoBaseUnit,
+        depositType: types_2.QuoteRequest.depositType.ORIGIN_CHAIN,
+        refundTo,
+        refundType,
+        recipient,
+        recipientType,
+        deadline,
+        referral: 'shapeshift',
+        appFees: [
+            {
+                recipient: utils_1.DAO_TREASURY_NEAR,
+                fee: Number(affiliateBps),
+            },
+        ],
+    };
+};
 exports.buildNearIntentsQuoteRequest = buildNearIntentsQuoteRequest;
 // One retry loop for the SDK's flaky WebSocket transport; maps provider errors to swap errors
 const fetchNearIntentsQuote = async ({ quoteRequest, sellAsset, }) => {

package/dist/cjs/swappers/PortalsSwapper/utils/getPortalsStepData.d.ts

@@ -3,6 +3,7 @@ import type { StepDataArgs, SwapErrorRight, TxBuildData } from '../../../types';
 import type { PortalsTx } from './fetchPortalsTradeOrder';
 type BaseArgs = {
     tx: PortalsTx;
+    sellAmountCryptoBaseUnit: string;
     spenderAddress: string;
 };
 export type GetPortalsStepDataArgs = StepDataArgs<BaseArgs, {