@shapeshiftoss/swapper 19.0.0 → 20.1.0

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

@@ -0,0 +1,68 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { estimateGasWithStateOverride } from '../../../utils/evm/index.js';
+import { USDC_MAINNET } from '../../../utils/test-data/assets.js';
+import { fetchPortalsTradeEstimate } from './fetchPortalsTradeOrder.js';
+import { getPortalsStepData } from './getPortalsStepData.js';
+vi.mock('../../../utils/evm', async (importOriginal) => ({
+    ...(await importOriginal()),
+    estimateGasWithStateOverride: vi.fn(),
+}));
+vi.mock('./fetchPortalsTradeOrder', async (importOriginal) => ({
+    ...(await importOriginal()),
+    fetchPortalsTradeEstimate: vi.fn(),
+}));
+const GAS_PRICE = '1000000000';
+const deps = {
+    assertGetEvmChainAdapter: () => ({
+        getGasFeeData: () => Promise.resolve({
+            average: { gasPrice: GAS_PRICE, maxFeePerGas: '0', maxPriorityFeePerGas: '0' },
+        }),
+    }),
+    config: {},
+};
+const tx = (gasLimit) => ({
+    to: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
+    from: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+    data: '0xdeadbeef',
+    value: '0',
+    gasLimit,
+});
+const rate = (portalsTx) => getPortalsStepData({
+    type: 'rate',
+    input: { supportsEIP1559: false },
+    deps,
+    tx: portalsTx,
+    sellAsset: USDC_MAINNET,
+    sellAmountCryptoBaseUnit: '1000000000',
+    spenderAddress: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
+    inputToken: 'ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+    outputToken: 'arbitrum:0xaf88d065e77c8cc2239327c5edb3a432268e5831',
+    inputAmount: '1000000000',
+    slippageTolerancePercentage: 2.5,
+});
+const estimateEndpointGasLimit = (gasLimit) => vi.mocked(fetchPortalsTradeEstimate).mockResolvedValue({
+    context: { gasLimit },
+});
+describe('getPortalsStepData rate gas limit', () => {
+    beforeEach(() => vi.clearAllMocks());
+    it('falls back to the order gas limit on bridge routes the estimate endpoint zeroes', async () => {
+        vi.mocked(estimateGasWithStateOverride).mockRejectedValue(new Error('execution reverted'));
+        estimateEndpointGasLimit(0);
+        const actual = await rate(tx('76384'));
+        expect(actual.unwrap()).toEqual({ networkFeeCryptoBaseUnit: '76384000000000' });
+        expect(fetchPortalsTradeEstimate).not.toHaveBeenCalled();
+    });
+    it('falls back to the estimate endpoint when the order carries no gas limit', async () => {
+        vi.mocked(estimateGasWithStateOverride).mockRejectedValue(new Error('execution reverted'));
+        estimateEndpointGasLimit(273203);
+        const actual = await rate(tx(undefined));
+        expect(actual.unwrap()).toEqual({ networkFeeCryptoBaseUnit: '273203000000000' });
+    });
+    it('errors rather than pricing a zero gas limit as a free trade', async () => {
+        vi.mocked(estimateGasWithStateOverride).mockRejectedValue(new Error('execution reverted'));
+        estimateEndpointGasLimit(0);
+        const actual = await rate(tx(undefined));
+        expect(actual.isErr()).toBe(true);
+        expect(actual.unwrapErr().message).toContain('getPortalsStepData');
+    });
+});

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

@@ -10,16 +10,17 @@ type PortalsTradeContext = {
     stepDataArgs: {
         deps: SwapperDeps;
         sellAsset: Asset;
+        sellAmountCryptoBaseUnit: string;
         spenderAddress: string;
         tx: PortalsTx;
     };
 };
-export declare const getPortalsTradeContext: ({ input, deps, sellChainId, inputToken, orderContext, tx, }: {
+export declare const getPortalsTradeContext: ({ input, deps, sellChainId, orderContext, outputToken, tx, }: {
     input: PortalsTradeQuoteInput | PortalsTradeRateInput;
     deps: SwapperDeps;
     sellChainId: PortalsSupportedChainId;
-    inputToken: string;
     orderContext: PortalsTradeOrderResponse['context'];
+    outputToken: string;
     tx: PortalsTx;
 }) => Result<PortalsTradeContext, SwapErrorRight>;
 export {};

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

@@ -1,14 +1,29 @@
-import { bn, bnOrZero } from '@shapeshiftoss/utils';
+import { BigNumber, bn, bnOrZero } from '@shapeshiftoss/utils';
 import { Err, Ok } from '@sniptt/monads';
 import { SwapperName, TradeQuoteError } from '../../../types.js';
 import { getInputOutputRate, makeSwapErrorRight } from '../../../utils/index.js';
 import { buildAffiliateFee } from '../../../utils/affiliateFee.js';
 import { getPortalsRouterAddressByChainId } from './helpers.js';
-export const getPortalsTradeContext = ({ input, deps, sellChainId, inputToken, orderContext, tx, }) => {
-    const { sellAsset, buyAsset, affiliateBps, sellAmountIncludingProtocolFeesCryptoBaseUnit } = input;
-    const { orderId, outputAmount, minOutputAmount, target, feeAmount, feeToken } = orderContext;
+export const getPortalsTradeContext = ({ input, deps, sellChainId, orderContext, outputToken, tx, }) => {
+    const { sellAsset, buyAsset, affiliateBps } = input;
+    const { orderId, inputAmount, outputAmount, minOutputAmount, target, feeAmount, feeToken, slippageTolerancePercentage, } = orderContext;
+    // Portals can fill less than we asked for - price against what the transaction actually spends
+    const sellAmountIncludingProtocolFeesCryptoBaseUnit = inputAmount;
     const isCrossChain = sellAsset.chainId !== buyAsset.chainId;
-    const buyAmountAfterFeesCryptoBaseUnit = isCrossChain ? minOutputAmount : outputAmount;
+    // Portals report the slippage they applied, not the one we requested - bridge routes apply none
+    const appliedSlippageDecimal = bnOrZero(slippageTolerancePercentage).div(100);
+    // Unvalidated orders report the post-slippage minimum in both amount fields
+    const hasSlippageBuffer = bnOrZero(outputAmount).gt(minOutputAmount);
+    const preSlippageOutputAmount = bnOrZero(minOutputAmount)
+        .div(bn(1).minus(appliedSlippageDecimal))
+        .toFixed(0);
+    const buyAmountAfterFeesCryptoBaseUnit = hasSlippageBuffer
+        ? outputAmount
+        : preSlippageOutputAmount;
+    const bufferSlippageDecimal = hasSlippageBuffer
+        ? bnOrZero(outputAmount).minus(minOutputAmount).div(outputAmount)
+        : appliedSlippageDecimal;
+    const slippageTolerancePercentageDecimal = BigNumber.max(appliedSlippageDecimal, bufferSlippageDecimal).toString();
     const rate = getInputOutputRate({
         sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
         buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
@@ -24,16 +39,13 @@ export const getPortalsTradeContext = ({ input, deps, sellChainId, inputToken, o
             details: { chainId: sellChainId },
         }));
     }
-    // Portals reports the slippage we requested, not what it applied — recover the actual buffer from the amounts
-    const actualBufferDecimal = bnOrZero(buyAmountAfterFeesCryptoBaseUnit)
-        .minus(minOutputAmount)
-        .div(buyAmountAfterFeesCryptoBaseUnit)
-        .toString();
-    // Reverse the buffer to recover the expected output (minOutput / (1 - buffer) = output)
-    const buyAmountBeforeFeesCryptoBaseUnit = bnOrZero(minOutputAmount)
-        .div(bn(1).minus(actualBufferDecimal))
-        .toFixed(0);
-    const protocolFeeAsset = feeToken === inputToken ? sellAsset : buyAsset;
+    // Portals lower-case echoed tokens, and take their fee in the sell asset on ERC20 sells
+    const isBuyAssetFee = feeToken?.toLowerCase() === outputToken.toLowerCase();
+    const protocolFeeAsset = isBuyAssetFee ? buyAsset : sellAsset;
+    // Portals report an output already net of their fee
+    const buyAmountBeforeFeesCryptoBaseUnit = isBuyAssetFee && feeAmount
+        ? bnOrZero(buyAmountAfterFeesCryptoBaseUnit).plus(feeAmount).toFixed(0)
+        : buyAmountAfterFeesCryptoBaseUnit;
     const protocolFees = (() => {
         if (!feeToken || !feeAmount)
             return;
@@ -51,7 +63,7 @@ export const getPortalsTradeContext = ({ input, deps, sellChainId, inputToken, o
             rate,
             swapperName: SwapperName.Portals,
             affiliateBps,
-            slippageTolerancePercentageDecimal: actualBufferDecimal,
+            slippageTolerancePercentageDecimal,
         },
         stepCommon: {
             estimatedExecutionTimeMs: isCrossChain ? 300000 : 0,
@@ -74,6 +86,12 @@ export const getPortalsTradeContext = ({ input, deps, sellChainId, inputToken, o
             }),
         },
         protocolFees,
-        stepDataArgs: { deps, sellAsset, spenderAddress: allowanceContract, tx },
+        stepDataArgs: {
+            deps,
+            sellAsset,
+            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            spenderAddress: allowanceContract,
+            tx,
+        },
     });
 };

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

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

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

@@ -0,0 +1,91 @@
+import { describe, expect, it } from 'vitest';
+import { USDC_ARBITRUM, USDC_MAINNET } from '../../../utils/test-data/assets.js';
+import { getPortalsTradeContext } from './getPortalsTradeContext.js';
+const deps = {};
+const tx = {
+    to: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
+    from: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045',
+    data: '0xdeadbeef',
+    value: '0',
+};
+const makeInput = (buyAsset = USDC_ARBITRUM) => ({
+    sellAsset: USDC_MAINNET,
+    buyAsset,
+    affiliateBps: '0',
+    sellAmountIncludingProtocolFeesCryptoBaseUnit: '4631313795',
+});
+const makeOrderContext = (overrides) => ({
+    orderId: 'eaae8ea5-30af-4463-97ab-1c5b1fe7def4',
+    target: '0x4cd00e387622c35bddb9b4c962c136462338bc31',
+    inputAmount: '4631313795',
+    ...overrides,
+});
+const unwrap = (args) => getPortalsTradeContext(args).unwrap();
+describe('getPortalsTradeContext', () => {
+    it('does not gross up a bridge route Portals applied no slippage to', () => {
+        const { stepCommon, tradeCommon } = unwrap({
+            input: makeInput(),
+            deps,
+            sellChainId: USDC_MAINNET.chainId,
+            orderContext: makeOrderContext({
+                outputAmount: '4616564490',
+                minOutputAmount: '4616564490',
+                slippageTolerancePercentage: 0,
+            }),
+            outputToken: 'arbitrum:0xaf88d065e77c8cc2239327c5edb3a432268e5831',
+            tx,
+        });
+        expect(stepCommon.buyAmountAfterFeesCryptoBaseUnit).toBe('4616564490');
+        expect(tradeCommon.slippageTolerancePercentageDecimal).toBe('0');
+    });
+    it('reverses the applied slippage on an unvalidated order collapsed to its minimum', () => {
+        const { stepCommon, tradeCommon } = unwrap({
+            input: makeInput(USDC_MAINNET),
+            deps,
+            sellChainId: USDC_MAINNET.chainId,
+            orderContext: makeOrderContext({
+                outputAmount: '2360574345',
+                minOutputAmount: '2360574345',
+                slippageTolerancePercentage: 2.5,
+            }),
+            outputToken: 'ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+            tx,
+        });
+        // Within 0.01% of the 2420957576 the same order returns when validated
+        expect(stepCommon.buyAmountAfterFeesCryptoBaseUnit).toBe('2421101892');
+        expect(tradeCommon.slippageTolerancePercentageDecimal).toBe('0.025');
+    });
+    it('keeps the reported output of a validated order and advertises the wider buffer', () => {
+        const { stepCommon, tradeCommon } = unwrap({
+            input: makeInput(USDC_MAINNET),
+            deps,
+            sellChainId: USDC_MAINNET.chainId,
+            orderContext: makeOrderContext({
+                outputAmount: '2420957576',
+                minOutputAmount: '2360574345',
+                slippageTolerancePercentage: 2.5,
+            }),
+            outputToken: 'ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
+            tx,
+        });
+        expect(stepCommon.buyAmountAfterFeesCryptoBaseUnit).toBe('2420957576');
+        expect(tradeCommon.slippageTolerancePercentageDecimal).toBe('0.025');
+    });
+    it('prices against the input amount Portals filled rather than the one requested', () => {
+        const { stepCommon } = unwrap({
+            input: makeInput(),
+            deps,
+            sellChainId: USDC_MAINNET.chainId,
+            orderContext: makeOrderContext({
+                // Portals withhold 0.01% of the requested 4631313795 on cross-chain orders
+                inputAmount: '4630850664',
+                outputAmount: '4616564490',
+                minOutputAmount: '4616564490',
+                slippageTolerancePercentage: 0,
+            }),
+            outputToken: 'arbitrum:0xaf88d065e77c8cc2239327c5edb3a432268e5831',
+            tx,
+        });
+        expect(stepCommon.sellAmountIncludingProtocolFeesCryptoBaseUnit).toBe('4630850664');
+    });
+});

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

@@ -6,11 +6,12 @@ import { getUnsignedSolanaTransaction } from '../../utils/solana/getUnsignedSola
 import { getTronTransactionFees, getUnsignedTronTransaction } from '../../utils/tron/index.js';
 import { getUnsignedUtxoTransaction, getUtxoTransactionFees } from '../../utils/utxo/index.js';
 import { chainIdToRelayChainId } from './constant.js';
-import { getTradeQuote } from './getTradeQuote/getTradeQuote.js';
-import { getTradeRate } from './getTradeRate/getTradeRate.js';
+import { getExactOutputTradeQuote, getTradeQuote } from './getTradeQuote/getTradeQuote.js';
+import { getExactOutputTradeRate, getTradeRate } from './getTradeRate/getTradeRate.js';
 import { getLatestRelayStatusMessage } from './utils/getLatestRelayStatusMessage.js';
 import { notifyTransactionIndexing } from './utils/notifyTransactionIndexing.js';
 import { getRelayRequestConfig, relayService } from './utils/relayService.js';
+import { getRelayTrackingLink, relayStatusToTxStatus } from './utils/relayStatus.js';
 // Keep track of the trades we already notified the relay indexer about
 const txIndexingMap = new Map();
 export const relayApi = {
@@ -20,6 +21,12 @@ export const relayApi = {
     getTradeRate: (input, deps) => {
         return getTradeRate(input, deps, chainIdToRelayChainId);
     },
+    getExactOutputTradeQuote: (input, deps) => {
+        return getExactOutputTradeQuote(input, deps, chainIdToRelayChainId);
+    },
+    getExactOutputTradeRate: (input, deps) => {
+        return getExactOutputTradeRate(input, deps, chainIdToRelayChainId);
+    },
     getEvmTransactionFees,
     getUnsignedEvmTransaction,
     getUnsignedUtxoTransaction,
@@ -60,7 +67,7 @@ export const relayApi = {
         }
         // relay.link tracks the swap by its origin chain transaction
         const swapperTxId = txHash;
-        const swapperTxLink = `https://relay.link/transaction/${txHash}`;
+        const swapperTxLink = getRelayTrackingLink(txHash);
         const maybeStatusResponse = await relayService.get(`${config.VITE_RELAY_API_URL}/intents/status/v3?requestId=${relayMetadata.relayId}`, getRelayRequestConfig(config));
         if (maybeStatusResponse.isErr()) {
             return {
@@ -72,23 +79,7 @@ export const relayApi = {
             };
         }
         const { data: statusResponse } = maybeStatusResponse.unwrap();
-        const status = (() => {
-            switch (statusResponse.status) {
-                case 'success':
-                    return TxStatus.Confirmed;
-                case 'waiting':
-                case 'delayed':
-                case 'pending':
-                case 'depositing':
-                case 'submitted':
-                    return TxStatus.Pending;
-                case 'failure':
-                case 'refund':
-                    return TxStatus.Failed;
-                default:
-                    return TxStatus.Unknown;
-            }
-        })();
+        const status = relayStatusToTxStatus(statusResponse.status);
         // Relay refers to in Txs as "inTxHashes" but to out Txs as simply "txHashes" when they really mean "outTxHashes"
         // One thing to note is that for same-chain Txs, there is no "out Tx" per se since the in Tx *is* the out Tx
         const outTxHashes = statusResponse.txHashes;

package/dist/esm/swappers/RelaySwapper/getTradeQuote/getTradeQuote.d.ts

@@ -1,5 +1,6 @@
 import type { Result } from '@sniptt/monads';
 import type { SwapErrorRight, SwapperDeps, TradeQuote } from '../../../types.js';
 import type { chainIdToRelayChainId as relayChainMapImplementation } from '../constant.js';
-import type { RelayTradeQuoteInput } from '../utils/types.js';
+import type { RelayExactOutputTradeQuoteInput, RelayTradeQuoteInput } from '../utils/types.js';
 export declare const getTradeQuote: (input: RelayTradeQuoteInput, deps: SwapperDeps, relayChainMap: typeof relayChainMapImplementation) => Promise<Result<TradeQuote[], SwapErrorRight>>;
+export declare const getExactOutputTradeQuote: (input: RelayExactOutputTradeQuoteInput, deps: SwapperDeps, relayChainMap: typeof relayChainMapImplementation) => Promise<Result<TradeQuote[], SwapErrorRight>>;

package/dist/esm/swappers/RelaySwapper/getTradeQuote/getTradeQuote.js

@@ -3,7 +3,7 @@ import { assertQuoteAddresses } from '../../../utils/index.js';
 import { FALLBACK_QUOTE_DEADLINE_MS } from '../../../utils/helpers.js';
 import { getRelayStepData } from '../utils/getRelayStepData.js';
 import { getRelayTradeContext } from '../utils/getRelayTradeContext.js';
-export const getTradeQuote = async (input, deps, relayChainMap) => {
+const getQuote = async (input, deps, relayChainMap) => {
     const { accountNumber } = input;
     const addresses = assertQuoteAddresses(input);
     if (addresses.isErr())
@@ -49,3 +49,5 @@ export const getTradeQuote = async (input, deps, relayChainMap) => {
     };
     return Ok([tradeQuote]);
 };
+export const getTradeQuote = (input, deps, relayChainMap) => getQuote(input, deps, relayChainMap);
+export const getExactOutputTradeQuote = (input, deps, relayChainMap) => getQuote(input, deps, relayChainMap);

package/dist/esm/swappers/RelaySwapper/getTradeRate/getTradeRate.d.ts

@@ -1,5 +1,6 @@
 import type { Result } from '@sniptt/monads';
 import type { SwapErrorRight, SwapperDeps, TradeRate } from '../../../types.js';
 import type { chainIdToRelayChainId as relayChainMapImplementation } from '../constant.js';
-import type { RelayTradeRateInput } from '../utils/types.js';
+import type { RelayExactOutputTradeRateInput, RelayTradeRateInput } from '../utils/types.js';
 export declare const getTradeRate: (input: RelayTradeRateInput, deps: SwapperDeps, relayChainMap: typeof relayChainMapImplementation) => Promise<Result<TradeRate[], SwapErrorRight>>;
+export declare const getExactOutputTradeRate: (input: RelayExactOutputTradeRateInput, deps: SwapperDeps, relayChainMap: typeof relayChainMapImplementation) => Promise<Result<TradeRate[], SwapErrorRight>>;

package/dist/esm/swappers/RelaySwapper/getTradeRate/getTradeRate.js

@@ -1,7 +1,7 @@
 import { Err, Ok } from '@sniptt/monads';
 import { getRelayStepData } from '../utils/getRelayStepData.js';
 import { getRelayTradeContext } from '../utils/getRelayTradeContext.js';
-export const getTradeRate = async (input, deps, relayChainMap) => {
+const getRate = async (input, deps, relayChainMap) => {
     const maybeContext = await getRelayTradeContext({ input, deps, relayChainMap });
     if (maybeContext.isErr())
         return Err(maybeContext.unwrapErr());
@@ -36,3 +36,5 @@ export const getTradeRate = async (input, deps, relayChainMap) => {
     };
     return Ok([tradeRate]);
 };
+export const getTradeRate = (input, deps, relayChainMap) => getRate(input, deps, relayChainMap);
+export const getExactOutputTradeRate = (input, deps, relayChainMap) => getRate(input, deps, relayChainMap);

package/dist/esm/swappers/RelaySwapper/utils/getRelayTradeContext.d.ts

@@ -2,7 +2,7 @@ import type { Result } from '@sniptt/monads';
 import type { QuoteFeeData, SwapErrorRight, SwapperDeps, TradeCommon, TradeStepCommon } from '../../../types.js';
 import type { chainIdToRelayChainId as relayChainMapImplementation } from '../constant.js';
 import type { GetRelayStepDataArgs } from './getRelayStepData.js';
-import type { RelayQuoteItem, RelayTradeQuoteInput, RelayTradeRateInput } from './types.js';
+import type { RelayExactOutputTradeQuoteInput, RelayExactOutputTradeRateInput, RelayQuoteItem, RelayTradeQuoteInput, RelayTradeRateInput } from './types.js';
 type RelayTradeContext = {
     tradeCommon: TradeCommon;
     stepCommon: Omit<TradeStepCommon, 'feeData' | 'allowanceContract'>;
@@ -15,7 +15,7 @@ type RelayTradeContext = {
     relayId: string;
 };
 export declare const getRelayTradeContext: ({ input, deps, relayChainMap, }: {
-    input: RelayTradeQuoteInput | RelayTradeRateInput;
+    input: RelayTradeQuoteInput | RelayTradeRateInput | RelayExactOutputTradeQuoteInput | RelayExactOutputTradeRateInput;
     deps: SwapperDeps;
     relayChainMap: typeof relayChainMapImplementation;
 }) => Promise<Result<RelayTradeContext, SwapErrorRight>>;

package/dist/esm/swappers/RelaySwapper/utils/getRelayTradeContext.js

@@ -7,7 +7,7 @@ import { zeroAddress } from 'viem';
 import { MixPanelEvent, SwapperName, TradeQuoteError } from '../../../types.js';
 import { getInputOutputRate, makeSwapErrorRight } from '../../../utils/index.js';
 import { buildAffiliateFee } from '../../../utils/affiliateFee.js';
-import { isNativeEvmAsset } from '../../../utils/helpers.js';
+import { getTradeAmount, isNativeEvmAsset } from '../../../utils/helpers.js';
 import { MAXIMUM_SUPPORTED_RELAY_STEPS, relayErrorCodeToTradeQuoteError } from '../constant.js';
 import { getRelayAssetAddress } from '../utils/getRelayAssetAddress.js';
 import { relayTokenToAsset } from '../utils/relayTokenToAsset.js';
@@ -16,7 +16,9 @@ import { fetchRelayTrade } from './fetchRelayTrade.js';
 import { assertValidTrade, getRelayAllowanceContract, resolveRelayAddresses } from './helpers.js';
 import { isRelayError } from './types.js';
 export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
-    const { sellAsset, buyAsset, sellAmountIncludingProtocolFeesCryptoBaseUnit, affiliateBps } = input;
+    const { sellAsset, buyAsset, affiliateBps } = input;
+    const amount = getTradeAmount(input);
+    const isExactOutput = amount.direction === 'exactOut';
     const xpub = 'xpub' in input ? input.xpub : undefined;
     const slippageToleranceBps = input.slippageTolerancePercentageDecimal
         ? convertDecimalPercentageToBasisPoints(input.slippageTolerancePercentageDecimal).toFixed()
@@ -35,8 +37,8 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
         originCurrency: getRelayAssetAddress(sellAsset),
         destinationChainId: buyRelayChainId,
         destinationCurrency: getRelayAssetAddress(buyAsset),
-        tradeType: 'EXACT_INPUT',
-        amount: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+        tradeType: isExactOutput ? 'EXACT_OUTPUT' : 'EXACT_INPUT',
+        amount: amount.cryptoBaseUnit,
         recipient,
         user: sendAddress,
         refundTo,
@@ -78,10 +80,19 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
             code: TradeQuoteError.UnknownError,
         }));
     }
-    const { slippageTolerance, currencyOut, timeEstimate } = quote.details;
-    const buyAmountAfterFeesCryptoBaseUnit = currencyOut.amount;
+    const { slippageTolerance, currencyIn, currencyOut, timeEstimate } = quote.details;
+    const sellAmountCryptoBaseUnit = currencyIn.amount;
+    const buyAmountAfterFeesCryptoBaseUnit = isExactOutput
+        ? currencyOut.minimumAmount
+        : currencyOut.amount;
+    if (isExactOutput && !bnOrZero(buyAmountAfterFeesCryptoBaseUnit).eq(amount.cryptoBaseUnit)) {
+        return Err(makeSwapErrorRight({
+            message: `Relay guarantees ${buyAmountAfterFeesCryptoBaseUnit} against a requested exact output of ${amount.cryptoBaseUnit}`,
+            code: TradeQuoteError.InvalidResponse,
+        }));
+    }
     const rate = getInputOutputRate({
-        sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+        sellAmountCryptoBaseUnit,
         buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
         sellAsset,
         buyAsset,
@@ -242,7 +253,7 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
     })();
     // Add back relayer service and gas fees (relayer is including both) since they are downsides,
     // and add appFees — these are quote-level and identical across every step
-    const buyAmountBeforeFeesCryptoBaseUnit = bnOrZero(currencyOut.amount)
+    const buyAmountBeforeFeesCryptoBaseUnit = bnOrZero(buyAmountAfterFeesCryptoBaseUnit)
         .plus(relayerFeesBuyAssetCryptoBaseUnit)
         .plus(appFeesBaseUnit)
         .toFixed();
@@ -256,6 +267,7 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
             id: relayId,
             rate,
             swapperName: SwapperName.Relay,
+            isExactOutput,
             affiliateBps,
             slippageTolerancePercentageDecimal,
         },
@@ -263,7 +275,7 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
             rate,
             buyAmountBeforeFeesCryptoBaseUnit,
             buyAmountAfterFeesCryptoBaseUnit,
-            sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmountCryptoBaseUnit,
             buyAsset,
             sellAsset,
             source: SwapperName.Relay,
@@ -273,7 +285,7 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
                 affiliateBps,
                 sellAsset,
                 buyAsset,
-                sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                sellAmountCryptoBaseUnit,
                 buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
                 fixedAssetId: chainIdToFeeAssetId(baseChainId),
                 fixedAsset: deps.assetsById[chainIdToFeeAssetId(baseChainId)],
@@ -291,7 +303,7 @@ export const getRelayTradeContext = async ({ input, deps, relayChainMap, }) => {
         relayStepInputs,
         stepDataArgs: {
             sellAsset,
-            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            sellAmountCryptoBaseUnit,
             orderId,
             from: sendAddress,
             xpub,

package/dist/esm/swappers/RelaySwapper/utils/helpers.d.ts

@@ -4,7 +4,7 @@ import type { Result } from '@sniptt/monads';
 import type { TransactionInstruction } from '@solana/web3.js';
 import type { SwapErrorRight } from '../../../types.js';
 import type { chainIdToRelayChainId as relayChainMapImplementation } from '../constant.js';
-import type { RelayQuoteItem, RelaySolanaInstruction, RelayTradeQuoteInput, RelayTradeRateInput } from './types.js';
+import type { RelayExactOutputTradeQuoteInput, RelayExactOutputTradeRateInput, RelayQuoteItem, RelaySolanaInstruction, RelayTradeQuoteInput, RelayTradeRateInput } from './types.js';
 export declare const assertValidTrade: ({ sellAsset, buyAsset, relayChainMap, }: {
     sellAsset: Asset;
     buyAsset: Asset;
@@ -14,7 +14,7 @@ export declare const assertValidTrade: ({ sellAsset, buyAsset, relayChainMap, }:
     buyRelayChainId: number;
 }, SwapErrorRight>;
 export declare const resolveRelayAddresses: ({ input, sellChainId, buyChainId, }: {
-    input: RelayTradeQuoteInput | RelayTradeRateInput;
+    input: RelayTradeQuoteInput | RelayTradeRateInput | RelayExactOutputTradeQuoteInput | RelayExactOutputTradeRateInput;
     sellChainId: ChainId;
     buyChainId: ChainId;
 }) => {

package/dist/esm/swappers/RelaySwapper/utils/relayStatus.d.ts

@@ -0,0 +1,8 @@
+import { TxStatus } from '@shapeshiftoss/unchained-client';
+import type { Result } from '@sniptt/monads';
+import type { SwapErrorRight, SwapperConfig } from '../../../types.js';
+import type { RelayRequest, RelayStatus } from './types.js';
+export declare const getRelayTrackingLink: (txHash: string) => string;
+export declare const relayStatusToTxStatus: (status: RelayStatus['status'] | undefined) => TxStatus;
+export declare const fetchRelayRequestByTxHash: (txHash: string, config: SwapperConfig) => Promise<Result<RelayRequest | undefined, SwapErrorRight>>;
+export declare const getRelayRequestFailureMessage: (request: RelayRequest) => string;

package/dist/esm/swappers/RelaySwapper/utils/relayStatus.js

@@ -0,0 +1,32 @@
+import { TxStatus } from '@shapeshiftoss/unchained-client';
+import { getRelayRequestConfig, relayService } from './relayService.js';
+export const getRelayTrackingLink = (txHash) => `https://relay.link/transaction/${txHash}`;
+export const relayStatusToTxStatus = (status) => {
+    switch (status) {
+        case 'success':
+            return TxStatus.Confirmed;
+        case 'waiting':
+        case 'delayed':
+        case 'pending':
+        case 'depositing':
+        case 'submitted':
+            return TxStatus.Pending;
+        case 'failure':
+        case 'refund':
+            return TxStatus.Failed;
+        default:
+            return TxStatus.Unknown;
+    }
+};
+// Relay index requests by origin tx hash, resolving a swap we hold no relayId for
+export const fetchRelayRequestByTxHash = async (txHash, config) => {
+    const maybeResponse = await relayService.get(`${config.VITE_RELAY_API_URL}/requests/v2?hash=${txHash}`, getRelayRequestConfig(config));
+    // Match the origin tx ourselves rather than trusting the listing to have filtered on it
+    return maybeResponse.map(({ data }) => data.requests?.find(({ data: request }) => request?.inTxs?.some(({ hash }) => hash?.toLowerCase() === txHash.toLowerCase())));
+};
+export const getRelayRequestFailureMessage = (request) => {
+    const { failReason, refundFailReason } = request.data ?? {};
+    // Relay report 'N/A' rather than omitting the reason when there isn't one
+    const reason = [failReason, refundFailReason].find(value => value && value !== 'N/A');
+    return reason ?? 'Bridge failed';
+};

package/dist/esm/swappers/RelaySwapper/utils/types.d.ts

@@ -1,6 +1,8 @@
-import type { GetEvmTradeQuoteInput, GetEvmTradeRateInput, GetSolanaTradeQuoteInput, GetSolanaTradeRateInput, GetTronTradeQuoteInput, GetTronTradeRateInput, GetUtxoTradeQuoteInput, GetUtxoTradeRateInput } from '../../../types.js';
+import type { GetEvmTradeQuoteInput, GetEvmTradeRateInput, GetSolanaTradeQuoteInput, GetSolanaTradeRateInput, GetTronTradeQuoteInput, GetTronTradeRateInput, GetUtxoTradeQuoteInput, GetUtxoTradeRateInput, WithExactBuyAmount } from '../../../types.js';
 export type RelayTradeQuoteInput = GetEvmTradeQuoteInput | GetUtxoTradeQuoteInput | GetSolanaTradeQuoteInput | GetTronTradeQuoteInput;
 export type RelayTradeRateInput = GetEvmTradeRateInput | GetUtxoTradeRateInput | GetSolanaTradeRateInput | GetTronTradeRateInput;
+export type RelayExactOutputTradeQuoteInput = WithExactBuyAmount<RelayTradeQuoteInput>;
+export type RelayExactOutputTradeRateInput = WithExactBuyAmount<RelayTradeRateInput>;
 export type RelayTransactionMetadata = {
     to?: string;
     data?: string;
@@ -10,6 +12,20 @@ export type RelayMetadata = {
     relayId: string;
     data?: string;
 };
+export type RelayRequestTransaction = {
+    hash?: string;
+    chainId?: number;
+};
+export type RelayRequestData = {
+    failReason?: string;
+    refundFailReason?: string;
+    inTxs?: RelayRequestTransaction[];
+    outTxs?: RelayRequestTransaction[];
+};
+export type RelayRequest = {
+    status?: RelayStatus['status'];
+    data?: RelayRequestData;
+};
 export type RelayStatus = {
     status: 'success' | 'failure' | 'pending' | 'submitted' | 'depositing' | 'refund' | 'delayed' | 'waiting';
     details?: string;
@@ -64,6 +80,7 @@ export type RelayFees = {
     app: RelayCurrencyData;
 };
 export type QuoteDetails = {
+    currencyIn: RelayCurrencyData;
     currencyOut: RelayCurrencyData;
     rate: string;
     slippageTolerance: {

package/dist/esm/swappers/SunioSwapper/utils/getSunioStepData.d.ts

@@ -3,6 +3,7 @@ import type { StepDataArgs, SwapErrorRight } from '../../../types.js';
 import type { SunioRoute, SunioTransactionData } from '../types.js';
 type BaseArgs = {
     route: SunioRoute;
+    sellAmountCryptoBaseUnit: string;
 };
 export type GetSunioStepDataArgs = StepDataArgs<BaseArgs>;
 type SunioRateStepData = {

package/dist/esm/swappers/SunioSwapper/utils/getSunioStepData.js

@@ -3,12 +3,12 @@ import { Err, Ok } from '@sniptt/monads';
 import { makeNetworkFeeEstimationFailedErr } from '../../../utils/index.js';
 import { estimateSunioNetworkFeeCryptoBaseUnit } from './estimateSunioNetworkFee.js';
 export async function getSunioStepData(args) {
-    const { type, route, sellAsset, from, input, deps } = args;
+    const { type, route, sellAsset, sellAmountCryptoBaseUnit, from, input, deps } = args;
     const estimateArgs = {
         rpcUrl: deps.config.VITE_TRON_NODE_URL,
         apiKey: deps.config.VITE_TRON_GRID_API_KEY,
         route,
-        sellAmountCryptoBaseUnit: input.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+        sellAmountCryptoBaseUnit,
         isSellingNativeTrx: !contractAddressOrUndefined(sellAsset.assetId),
         address: from,
         slippageTolerancePercentageDecimal: input.slippageTolerancePercentageDecimal,

package/dist/esm/swappers/SunioSwapper/utils/getSunioTradeContext.js

@@ -80,7 +80,12 @@ export const getSunioTradeContext = async ({ input, deps, }) => {
                 }),
             },
             protocolFees,
-            stepDataArgs: { deps, sellAsset, route: bestRoute },
+            stepDataArgs: {
+                deps,
+                sellAsset,
+                sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                route: bestRoute,
+            },
         });
     }
     catch (error) {

package/dist/esm/swappers/ThorchainSwapper/generated/generatedThorLongtailTokens.json

@@ -1016,6 +1016,7 @@
     "eip155:1/erc20:0x826180541412d574cf1336d22c0c0a287822678a",
     "eip155:1/erc20:0x2c06ba9e7f0daccbc1f6a33ea67e85bb68fbee3a",
     "eip155:1/erc20:0xcbb8f1bda10b9696c57e13bc128fe674769dcec0",
+    "eip155:1/erc20:0x72dfb2e44f59c5ad2bafe84314e5b99a7cd5075e",
     "eip155:43114/erc20:0xc891eb4cbdeff6e073e859e987815ed1505c2acd",
     "eip155:43114/erc20:0xd24c2ad096400b6fbcd2ad8b24e7acbc21a1da64",
     "eip155:43114/erc20:0x47c3118ad183712acd42648e9e522e13690f29a0",