@shapeshiftoss/swapper 19.0.0 → 20.0.0

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

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

package/dist/esm/exactOutputFiltering.test.js

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

package/dist/esm/swapper.d.ts

@@ -1,3 +1,3 @@
-import type { GetTradeQuoteInput, GetTradeRateInput, QuoteResult, RateResult, SwapperDeps, SwapperName } from './types.js';
-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.js';
+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/esm/swapper.js

@@ -1,17 +1,31 @@
 import { bnOrZero, timeoutMonadic, timeoutMonadicWithOriginal } from '@shapeshiftoss/utils';
+import { Err } from '@sniptt/monads';
 import { QUOTE_TIMEOUT_ERROR, QUOTE_TIMEOUT_MS, swappers } from './constants.js';
 import { TradeQuoteError } from './types.js';
 import { makeSwapErrorRight } from './utils/index.js';
+const EXACT_OUTPUT_NOT_SUPPORTED_ERROR = makeSwapErrorRight({
+    code: TradeQuoteError.ExactOutputNotSupported,
+    message: 'This swapper cannot derive a sell amount from an exact buy amount',
+});
 export const getTradeQuotes = async (getTradeQuoteInput, swapperName, deps) => {
     if (bnOrZero(getTradeQuoteInput.affiliateBps).lt(0))
         return;
-    if (getTradeQuoteInput.sellAmountIncludingProtocolFeesCryptoBaseUnit === '0')
-        return;
     const swapper = 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 (bnOrZero(drivingAmount).isZero())
+        return;
+    const quotePromise = 'buyAmountCryptoBaseUnit' in getTradeQuoteInput
+        ? swapper.getExactOutputTradeQuote?.(getTradeQuoteInput, deps)
+        : swapper.getTradeQuote(getTradeQuoteInput, deps);
+    if (!quotePromise)
+        return { ...Err(EXACT_OUTPUT_NOT_SUPPORTED_ERROR), swapperName };
     try {
-        const quote = await timeoutMonadic(swapper.getTradeQuote(getTradeQuoteInput, deps), QUOTE_TIMEOUT_MS, QUOTE_TIMEOUT_ERROR);
+        const quote = await timeoutMonadic(quotePromise, QUOTE_TIMEOUT_MS, QUOTE_TIMEOUT_ERROR);
         return {
             ...quote,
             swapperName,
@@ -26,13 +40,22 @@ export const getTradeQuotes = async (getTradeQuoteInput, swapperName, deps) => {
 export const getTradeRates = async (getTradeRateInput, swapperName, deps, quoteTimeoutMs = QUOTE_TIMEOUT_MS) => {
     if (bnOrZero(getTradeRateInput.affiliateBps).lt(0))
         return;
-    if (getTradeRateInput.sellAmountIncludingProtocolFeesCryptoBaseUnit === '0')
-        return;
     const swapper = 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 (bnOrZero(drivingAmount).isZero())
+        return;
+    const ratePromise = 'buyAmountCryptoBaseUnit' in getTradeRateInput
+        ? swapper.getExactOutputTradeRate?.(getTradeRateInput, deps)
+        : swapper.getTradeRate(getTradeRateInput, deps);
+    if (!ratePromise)
+        return { ...Err(EXACT_OUTPUT_NOT_SUPPORTED_ERROR), swapperName };
     try {
-        const { timed, original } = timeoutMonadicWithOriginal(swapper.getTradeRate(getTradeRateInput, deps), quoteTimeoutMs, makeSwapErrorRight({
+        const { timed, original } = timeoutMonadicWithOriginal(ratePromise, quoteTimeoutMs, makeSwapErrorRight({
             code: TradeQuoteError.Timeout,
             message: `quote timed out after ${quoteTimeoutMs / 1000}s`,
         }));

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

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

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

@@ -7,7 +7,7 @@ import { makeNetworkFeeEstimationFailedErr, makeSwapErrorRight, makeTradeStepBui
 import { getEvmNetworkFeeCryptoBaseUnit } from '../../../utils/evm/index.js';
 import { getSolanaNetworkFeeCryptoBaseUnit } from '../../../utils/solana/index.js';
 export 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': {
@@ -22,7 +22,7 @@ export async function getAcrossStepData(args) {
             };
             const stateOverride = {
                 sellAsset,
-                sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                sellAmountCryptoBaseUnit,
                 spenderAddress,
             };
             if (type === 'rate') {

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

@@ -167,6 +167,7 @@ export 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/esm/swappers/BebopSwapper/utils/getBebopStepData.d.ts

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

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

@@ -5,7 +5,7 @@ import { fromHex } from 'viem';
 import { makeNetworkFeeEstimationFailedErr } from '../../../utils/index.js';
 import { getEvmNetworkFeeCryptoBaseUnit } from '../../../utils/evm/index.js';
 export 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') {
@@ -40,7 +40,7 @@ export async function getBebopStepData(args) {
             supportsEIP1559,
             stateOverride: {
                 sellAsset,
-                sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                sellAmountCryptoBaseUnit,
                 spenderAddress,
             },
         });

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

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

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

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

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

@@ -3,7 +3,7 @@ import { Err, Ok } from '@sniptt/monads';
 import { makeNetworkFeeEstimationFailedErr } from '../../../utils/index.js';
 import { getEvmNetworkFeeCryptoBaseUnit } from '../../../utils/evm/index.js';
 export 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 = {
@@ -16,7 +16,7 @@ export async function getDebridgeStepData(args) {
     };
     const stateOverride = {
         sellAsset,
-        sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+        sellAmountCryptoBaseUnit,
         spenderAddress,
     };
     if (type === 'rate') {

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

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

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

@@ -4,13 +4,15 @@ import { getEvmTransactionFees, getUnsignedEvmTransaction } from '../../utils/ev
 import { getSolanaTransactionFees, getUnsignedSolanaTransaction } from '../../utils/solana/index.js';
 import { getTronTransactionFees, getUnsignedTronTransaction } from '../../utils/tron/index.js';
 import { getUnsignedUtxoTransaction, getUtxoTransactionFees } from '../../utils/utxo/index.js';
-import { getTradeQuote } from './swapperApi/getTradeQuote.js';
-import { getTradeRate } from './swapperApi/getTradeRate.js';
+import { getExactOutputTradeQuote, getTradeQuote } from './swapperApi/getTradeQuote.js';
+import { getExactOutputTradeRate, getTradeRate } from './swapperApi/getTradeRate.js';
 import { getNearIntentsStatusMessage, mapNearIntentsStatus } from './utils/helpers.js';
 import { initializeOneClickService, OneClickService } from './utils/oneClickService.js';
 export const nearIntentsApi = {
     getTradeQuote: (input, deps) => getTradeQuote(input, deps),
     getTradeRate: (input, deps) => getTradeRate(input, deps),
+    getExactOutputTradeQuote: (input, deps) => getExactOutputTradeQuote(input, deps),
+    getExactOutputTradeRate: (input, deps) => getExactOutputTradeRate(input, deps),
     getUnsignedEvmTransaction,
     getEvmTransactionFees,
     getUnsignedUtxoTransaction,

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

@@ -1,4 +1,5 @@
 import type { Result } from '@sniptt/monads';
 import type { SwapErrorRight, SwapperDeps, TradeQuote } from '../../../types.js';
-import type { NearIntentsTradeQuoteInput } from '../types.js';
+import type { NearIntentsExactOutputTradeQuoteInput, NearIntentsTradeQuoteInput } from '../types.js';
 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/esm/swappers/NearIntentsSwapper/swapperApi/getTradeQuote.js

@@ -1,17 +1,19 @@
 import { Err, Ok } from '@sniptt/monads';
 import { assertQuoteAddresses } from '../../../utils/index.js';
+import { getTradeAmount } from '../../../utils/helpers.js';
 import { QuoteRequest } from '../types.js';
 import { getNearIntentsStepData } from '../utils/getNearIntentsStepData.js';
 import { getNearIntentsTradeContext } from '../utils/getNearIntentsTradeContext.js';
 import { buildNearIntentsQuoteRequest, fetchNearIntentsQuote, getNearIntentsQuoteDeadline, resolveNearIntentsAssets, } from '../utils/helpers.js';
 import { initializeOneClickService } from '../utils/oneClickService.js';
-export 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 = assertQuoteAddresses(input);
     if (addresses.isErr())
         return Err(addresses.unwrapErr());
     const { sendAddress, receiveAddress } = addresses.unwrap();
     initializeOneClickService(deps.config.VITE_NEAR_INTENTS_API_KEY);
+    const amount = getTradeAmount(input);
     const maybeAssets = await resolveNearIntentsAssets({ sellAsset, buyAsset });
     if (maybeAssets.isErr())
         return Err(maybeAssets.unwrapErr());
@@ -19,7 +21,7 @@ export const getTradeQuote = async (input, deps) => {
     const quoteRequest = buildNearIntentsQuoteRequest({
         originAsset,
         destinationAsset,
-        sellAmountCryptoBaseUnit: sellAmount,
+        amount,
         slippageTolerancePercentageDecimal: input.slippageTolerancePercentageDecimal,
         affiliateBps,
         refundTo: sendAddress,
@@ -72,3 +74,5 @@ export const getTradeQuote = async (input, deps) => {
     };
     return Ok([tradeQuote]);
 };
+export const getTradeQuote = (input, deps) => getQuote(input, deps);
+export const getExactOutputTradeQuote = (input, deps) => getQuote(input, deps);

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

@@ -1,4 +1,5 @@
 import type { Result } from '@sniptt/monads';
 import type { SwapErrorRight, SwapperDeps, TradeRate } from '../../../types.js';
-import type { NearIntentsTradeRateInput } from '../types.js';
+import type { NearIntentsExactOutputTradeRateInput, NearIntentsTradeRateInput } from '../types.js';
 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/esm/swappers/NearIntentsSwapper/swapperApi/getTradeRate.js

@@ -1,12 +1,14 @@
 import { Err, Ok } from '@sniptt/monads';
+import { getTradeAmount } from '../../../utils/helpers.js';
 import { QuoteRequest } from '../types.js';
 import { getNearIntentsStepData } from '../utils/getNearIntentsStepData.js';
 import { getNearIntentsTradeContext } from '../utils/getNearIntentsTradeContext.js';
 import { buildNearIntentsQuoteRequest, fetchNearIntentsQuote, getNearIntentsQuoteDeadline, resolveNearIntentsAssets, } from '../utils/helpers.js';
 import { initializeOneClickService } from '../utils/oneClickService.js';
-export 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;
     initializeOneClickService(deps.config.VITE_NEAR_INTENTS_API_KEY);
+    const amount = getTradeAmount(input);
     const maybeAssets = await resolveNearIntentsAssets({ sellAsset, buyAsset });
     if (maybeAssets.isErr())
         return Err(maybeAssets.unwrapErr());
@@ -14,7 +16,7 @@ export const getTradeRate = async (input, deps) => {
     const quoteRequest = buildNearIntentsQuoteRequest({
         originAsset,
         destinationAsset,
-        sellAmountCryptoBaseUnit: sellAmount,
+        amount,
         slippageTolerancePercentageDecimal: input.slippageTolerancePercentageDecimal,
         affiliateBps,
         refundTo: sendAddress ?? 'check-price',
@@ -58,3 +60,5 @@ export const getTradeRate = async (input, deps) => {
     };
     return Ok([tradeRate]);
 };
+export const getTradeRate = (input, deps) => getRate(input, deps);
+export const getExactOutputTradeRate = (input, deps) => getRate(input, deps);

package/dist/esm/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.js';
+import type { GetEvmTradeQuoteInput, GetEvmTradeRateInput, GetNearTradeQuoteInput, GetNearTradeRateInput, GetSolanaTradeQuoteInput, GetSolanaTradeRateInput, GetStarknetTradeQuoteInput, GetStarknetTradeRateInput, GetSuiTradeQuoteInput, GetSuiTradeRateInput, GetTonTradeQuoteInput, GetTonTradeRateInput, GetTronTradeQuoteInput, GetTronTradeRateInput, GetUtxoTradeQuoteInput, GetUtxoTradeRateInput, WithExactBuyAmount } from '../../types.js';
 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/esm/swappers/NearIntentsSwapper/utils/exactOutput.test.d.ts

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

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

@@ -0,0 +1,59 @@
+import { describe, expect, it } from 'vitest';
+import { QuoteRequest } from '../types.js';
+import { buildNearIntentsQuoteRequest } from './helpers.js';
+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: QuoteRequest.refundType.ORIGIN_CHAIN,
+    recipientType: QuoteRequest.recipientType.DESTINATION_CHAIN,
+    deadline: '2026-08-10T23:59:00.000Z',
+};
+const EXACT_OUTPUT_AMOUNT = {
+    direction: 'exactOut',
+    cryptoBaseUnit: '100000',
+};
+describe('buildNearIntentsQuoteRequest', () => {
+    describe('exact input', () => {
+        it('requests EXACT_INPUT with the sell amount', () => {
+            const request = buildNearIntentsQuoteRequest(BASE_ARGS);
+            expect(request.swapType).toEqual(QuoteRequest.swapType.EXACT_INPUT);
+            expect(request.amount).toEqual('65000000');
+        });
+        it('passes the requested slippage through untouched', () => {
+            const request = buildNearIntentsQuoteRequest({
+                ...BASE_ARGS,
+                slippageTolerancePercentageDecimal: '0',
+            });
+            expect(request.slippageTolerance).toEqual(0);
+        });
+    });
+    describe('exact output', () => {
+        it('requests EXACT_OUTPUT with the buy amount', () => {
+            const request = buildNearIntentsQuoteRequest({ ...BASE_ARGS, amount: EXACT_OUTPUT_AMOUNT });
+            expect(request.swapType).toEqual(QuoteRequest.swapType.EXACT_OUTPUT);
+            expect(request.amount).toEqual('100000');
+        });
+        // A tighter band is the user's call - the failure mode is a refund, not a loss
+        it('passes a requested zero slippage through untouched, as exact input does', () => {
+            const request = buildNearIntentsQuoteRequest({
+                ...BASE_ARGS,
+                amount: EXACT_OUTPUT_AMOUNT,
+                slippageTolerancePercentageDecimal: '0',
+            });
+            expect(request.slippageTolerance).toEqual(0);
+        });
+        it('honours a requested slippage', () => {
+            const request = buildNearIntentsQuoteRequest({
+                ...BASE_ARGS,
+                amount: EXACT_OUTPUT_AMOUNT,
+                slippageTolerancePercentageDecimal: '0.05',
+            });
+            expect(request.slippageTolerance).toEqual(500);
+        });
+    });
+});

package/dist/esm/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.js';
-import type { NearIntentsTradeQuoteInput, NearIntentsTradeRateInput, QuoteResponse } from '../types.js';
+import type { NearIntentsExactOutputTradeQuoteInput, NearIntentsExactOutputTradeRateInput, NearIntentsTradeQuoteInput, NearIntentsTradeRateInput, QuoteResponse } from '../types.js';
 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/esm/swappers/NearIntentsSwapper/utils/getNearIntentsTradeContext.js

@@ -7,7 +7,7 @@ import { SwapperName } from '../../../types.js';
 import { getInputOutputRate, makeTradeStepBuildFailedErr } from '../../../utils/index.js';
 import { buildAffiliateFee } from '../../../utils/affiliateFee.js';
 export const getNearIntentsTradeContext = ({ input, deps, quote, }) => {
-    const { sellAsset, buyAsset, affiliateBps, sellAmountIncludingProtocolFeesCryptoBaseUnit, slippageTolerancePercentageDecimal, } = input;
+    const { sellAsset, buyAsset, affiliateBps, slippageTolerancePercentageDecimal } = input;
     if (!quote.depositAddress)
         return Err(makeTradeStepBuildFailedErr('getNearIntentsTradeContext'));
     const rate = getInputOutputRate({
@@ -16,11 +16,13 @@ export const getNearIntentsTradeContext = ({ input, deps, quote, }) => {
         sellAsset,
         buyAsset,
     });
+    const isExactOutput = 'buyAmountCryptoBaseUnit' in input;
     return Ok({
         tradeCommon: {
             id: uuid(),
             rate,
             swapperName: SwapperName.NearIntents,
+            isExactOutput,
             affiliateBps,
             slippageTolerancePercentageDecimal: slippageTolerancePercentageDecimal ??
                 getDefaultSlippageDecimalPercentageForSwapper(SwapperName.NearIntents),
@@ -51,7 +53,7 @@ export const getNearIntentsTradeContext = ({ input, deps, quote, }) => {
         stepDataArgs: {
             deps,
             sellAsset,
-            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            sellAmountCryptoBaseUnit: quote.amountIn,
             depositAddress: quote.depositAddress,
         },
     });

package/dist/esm/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.js';
+import type { SwapErrorRight, TradeAmount } from '../../../types.js';
 import type { GetExecutionStatusResponse, QuoteResponse } from '../types.js';
 import { QuoteRequest } from '../types.js';
 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/esm/swappers/NearIntentsSwapper/utils/helpers.js

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

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

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

package/dist/esm/swappers/PortalsSwapper/utils/getPortalsStepData.js

@@ -4,7 +4,7 @@ import { makeNetworkFeeEstimationFailedErr } from '../../../utils/index.js';
 import { estimateGasWithStateOverride, getEvmNetworkFeeCryptoBaseUnit } from '../../../utils/evm/index.js';
 import { fetchPortalsTradeEstimate } from './fetchPortalsTradeOrder.js';
 export async function getPortalsStepData(args) {
-    const { tx, sellAsset, spenderAddress, input, deps } = args;
+    const { tx, sellAsset, sellAmountCryptoBaseUnit, spenderAddress, input, deps } = args;
     const adapter = deps.assertGetEvmChainAdapter(sellAsset.chainId);
     const supportsEIP1559 = 'supportsEIP1559' in input ? input.supportsEIP1559 : false;
     if (args.type === 'rate') {
@@ -15,7 +15,7 @@ export async function getPortalsStepData(args) {
                 try {
                     const gasLimit = await estimateGasWithStateOverride({
                         sellAsset,
-                        sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                        sellAmountCryptoBaseUnit,
                         from: tx.from,
                         spenderAddress,
                         to: tx.to,
@@ -65,7 +65,7 @@ export async function getPortalsStepData(args) {
             supportsEIP1559,
             stateOverride: {
                 sellAsset,
-                sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                sellAmountCryptoBaseUnit,
                 spenderAddress,
             },
         });

package/dist/esm/swappers/PortalsSwapper/utils/getPortalsTradeContext.d.ts

@@ -10,6 +10,7 @@ type PortalsTradeContext = {
     stepDataArgs: {
         deps: SwapperDeps;
         sellAsset: Asset;
+        sellAmountCryptoBaseUnit: string;
         spenderAddress: string;
         tx: PortalsTx;
     };

package/dist/esm/swappers/PortalsSwapper/utils/getPortalsTradeContext.js

@@ -74,6 +74,12 @@ export const getPortalsTradeContext = ({ input, deps, sellChainId, inputToken, o
             }),
         },
         protocolFees,
-        stepDataArgs: { deps, sellAsset, spenderAddress: allowanceContract, tx },
+        stepDataArgs: {
+            deps,
+            sellAsset,
+            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            spenderAddress: allowanceContract,
+            tx,
+        },
     });
 };