@shapeshiftoss/swapper 17.8.0 → 18.1.0

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

@@ -7,44 +7,18 @@ const starknet_1 = require("starknet");
 const utils_1 = require("../../utils");
 const getTradeQuote_1 = require("./swapperApi/getTradeQuote");
 const getTradeRate_1 = require("./swapperApi/getTradeRate");
-/**
- * Normalize a value to hex format for Starknet RPC
- * Handles various input types: decimal strings, hex strings (with/without 0x), numbers, BigInts
- */
-const toHexString = (value) => {
-    const strValue = String(value);
-    // Already a proper hex string with 0x prefix
-    if (strValue.startsWith('0x')) {
-        return strValue;
-    }
-    // Check if it looks like a hex string without 0x prefix (contains a-f characters)
-    // Starknet addresses and felts often come as hex without 0x prefix
-    if (/^[0-9a-fA-F]+$/.test(strValue) && /[a-fA-F]/.test(strValue)) {
-        return `0x${strValue}`;
-    }
-    // Otherwise treat as decimal and convert to hex
-    try {
-        return starknet_1.num.toHex(strValue);
-    }
-    catch {
-        // If conversion fails, assume it's already hex and add prefix
-        return `0x${strValue}`;
-    }
-};
+const helpers_1 = require("./utils/helpers");
 exports.avnuApi = {
-    getTradeQuote: getTradeQuote_1.getTradeQuote,
-    getTradeRate: (input, deps) => {
-        return (0, getTradeRate_1.getTradeRate)(input, deps);
-    },
+    getTradeQuote: (input, deps) => (0, getTradeQuote_1.getTradeQuote)(input, deps),
+    getTradeRate: (input, deps) => (0, getTradeRate_1.getTradeRate)(input, deps),
     getUnsignedStarknetTransaction: async ({ stepIndex, tradeQuote, from, slippageTolerancePercentageDecimal, assertGetStarknetChainAdapter, }) => {
         if (!(0, utils_1.isExecutableTradeQuote)(tradeQuote))
             throw new Error('Unable to execute a trade rate quote');
         const step = (0, utils_1.getExecutableTradeStep)(tradeQuote, stepIndex);
-        const { accountNumber, sellAsset, avnuSpecific } = step;
-        if (!avnuSpecific)
-            throw new Error('avnuSpecific is required');
-        if (!avnuSpecific.quoteId)
-            throw new Error('quoteId is required in avnuSpecific');
+        const { accountNumber, sellAsset } = step;
+        const { quoteId } = (0, utils_1.getSwapMetadata)(step.swapperMetadata, 'avnu');
+        if (!quoteId)
+            throw new Error('quoteId is required in avnu swapper metadata');
         const adapter = assertGetStarknetChainAdapter(sellAsset.chainId);
         // Normalize the from address to ensure consistent format
         // Starknet addresses can have different representations (with/without leading zeros)
@@ -56,7 +30,7 @@ exports.avnuApi = {
             : 0.02;
         // Get the swap calls from AVNU SDK
         const { calls: avnuCalls } = await (0, avnu_sdk_1.quoteToCalls)({
-            quoteId: avnuSpecific.quoteId,
+            quoteId,
             slippage,
             takerAddress: normalizedFrom,
         });
@@ -75,7 +49,7 @@ exports.avnuApi = {
             fullCalldata.push(normalizedContractAddress, selector, calldataArray.length.toString(), ...calldataArray.map(cd => String(cd)));
         }
         // Format calldata for RPC (convert all values to proper hex format)
-        const formattedCalldata = fullCalldata.map(toHexString);
+        const formattedCalldata = fullCalldata.map(helpers_1.toHexString);
         // Get nonce using adapter method (checks deployment status and returns appropriate nonce)
         const chainIdHex = await adapter.getStarknetProvider().getChainId();
         const nonce = await adapter.getNonce(normalizedFrom);

package/dist/cjs/swappers/AvnuSwapper/index.d.ts

@@ -1 +1,3 @@
 export { AVNU_SUPPORTED_CHAIN_IDS } from './utils/constants';
+export { avnuApi } from './endpoints';
+export { avnuSwapper } from './AvnuSwapper';

package/dist/cjs/swappers/AvnuSwapper/index.js

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AVNU_SUPPORTED_CHAIN_IDS = void 0;
+exports.avnuSwapper = exports.avnuApi = exports.AVNU_SUPPORTED_CHAIN_IDS = void 0;
 var constants_1 = require("./utils/constants");
 Object.defineProperty(exports, "AVNU_SUPPORTED_CHAIN_IDS", { enumerable: true, get: function () { return constants_1.AVNU_SUPPORTED_CHAIN_IDS; } });
+var endpoints_1 = require("./endpoints");
+Object.defineProperty(exports, "avnuApi", { enumerable: true, get: function () { return endpoints_1.avnuApi; } });
+var AvnuSwapper_1 = require("./AvnuSwapper");
+Object.defineProperty(exports, "avnuSwapper", { enumerable: true, get: function () { return AvnuSwapper_1.avnuSwapper; } });

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

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

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

@@ -1,154 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTradeQuote = void 0;
-const avnu_sdk_1 = require("@avnu/avnu-sdk");
-const caip_1 = require("@shapeshiftoss/caip");
-const utils_1 = require("@shapeshiftoss/utils");
 const monads_1 = require("@sniptt/monads");
 const starknet_1 = require("starknet");
-const uuid_1 = require("uuid");
-const constants_1 = require("../../../constants");
 const types_1 = require("../../../types");
-const utils_2 = require("../../../utils");
-const affiliateFee_1 = require("../../utils/affiliateFee");
-const helpers_1 = require("../../utils/helpers/helpers");
-const constants_2 = require("../utils/constants");
-const helpers_2 = require("../utils/helpers");
+const utils_1 = require("../../../utils");
+const getAvnuTradeContext_1 = require("../utils/getAvnuTradeContext");
 const getTradeQuote = async (input, deps) => {
-    const { sellAsset, buyAsset, accountNumber, sendAddress, receiveAddress, sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount, slippageTolerancePercentageDecimal, affiliateBps, } = input;
-    if (!constants_2.AVNU_SUPPORTED_CHAIN_IDS.includes(sellAsset.chainId)) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `Chain ${sellAsset.chainId} is not supported by AVNU`,
-            code: types_1.TradeQuoteError.UnsupportedChain,
-        }));
-    }
-    if (!constants_2.AVNU_SUPPORTED_CHAIN_IDS.includes(buyAsset.chainId)) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `Chain ${buyAsset.chainId} is not supported by AVNU`,
-            code: types_1.TradeQuoteError.UnsupportedChain,
-        }));
-    }
-    if (accountNumber === undefined) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `accountNumber is required`,
-            code: types_1.TradeQuoteError.UnknownError,
-        }));
-    }
-    if (sendAddress === undefined) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `sendAddress is required`,
-            code: types_1.TradeQuoteError.UnknownError,
-        }));
-    }
-    if (receiveAddress === undefined) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `receiveAddress is required`,
-            code: types_1.TradeQuoteError.UnknownError,
-        }));
-    }
+    const { sellAsset, accountNumber } = input;
+    const maybeAddresses = (0, utils_1.assertQuoteAddresses)(input);
+    if (maybeAddresses.isErr())
+        return (0, monads_1.Err)(maybeAddresses.unwrapErr());
+    const { sendAddress, receiveAddress } = maybeAddresses.unwrap();
     try {
-        const sellTokenAddress = (0, helpers_2.getTokenAddress)(sellAsset);
-        const buyTokenAddress = (0, helpers_2.getTokenAddress)(buyAsset);
-        // Normalize addresses to ensure consistent format across quote and execution
-        // Starknet addresses can have different representations (with/without leading zeros)
+        // Starknet addresses can have different representations (with/without leading zeros) - normalize
+        // to keep the quote and execution consistent
         const normalizedSendAddress = (0, starknet_1.validateAndParseAddress)(sendAddress);
         const normalizedReceiveAddress = (0, starknet_1.validateAndParseAddress)(receiveAddress);
-        const quotes = await (0, avnu_sdk_1.getQuotes)({
-            sellTokenAddress,
-            buyTokenAddress,
-            sellAmount: BigInt(sellAmount),
-            takerAddress: normalizedSendAddress,
-            size: 1,
-            integratorFees: affiliateBps ? BigInt(affiliateBps) : undefined,
-            integratorFeeRecipient: (0, helpers_1.getTreasuryAddressFromChainId)(caip_1.starknetChainId),
-            integratorName: 'shapeshift',
-        });
-        if (!quotes || quotes.length === 0) {
-            return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-                message: 'No quotes available for this trade pair',
-                code: types_1.TradeQuoteError.NoRouteFound,
-            }));
-        }
-        const bestQuote = quotes[0];
-        if (!bestQuote) {
-            return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-                message: 'No valid quote returned from AVNU',
-                code: types_1.TradeQuoteError.QueryFailed,
-            }));
-        }
-        const buyAmountAfterFeesCryptoBaseUnit = bestQuote.buyAmount.toString();
-        const sellAdapter = deps.assertGetStarknetChainAdapter(sellAsset.chainId);
-        const feeData = await sellAdapter.getFeeData({
+        const maybeContext = await (0, getAvnuTradeContext_1.getAvnuTradeContext)({ input, takerAddress: normalizedSendAddress });
+        if (maybeContext.isErr())
+            return (0, monads_1.Err)(maybeContext.unwrapErr());
+        const { tradeCommon, stepCommon, protocolFees, quoteId, sellTokenAddress } = maybeContext.unwrap();
+        const adapter = deps.assertGetStarknetChainAdapter(sellAsset.chainId);
+        const feeData = await adapter.getFeeData({
             to: normalizedReceiveAddress,
-            value: sellAmount,
+            value: stepCommon.sellAmountIncludingProtocolFeesCryptoBaseUnit,
             chainSpecific: {
                 from: normalizedSendAddress,
                 tokenContractAddress: sellTokenAddress,
             },
             sendMax: false,
         });
-        const rate = (0, utils_2.getInputOutputRate)({
-            sellAmountCryptoBaseUnit: sellAmount,
-            buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
-            sellAsset,
-            buyAsset,
-        });
-        const protocolFees = affiliateBps
-            ? {
-                [buyAsset.assetId]: {
-                    amountCryptoBaseUnit: (0, utils_1.bn)(buyAmountAfterFeesCryptoBaseUnit)
-                        .times(affiliateBps)
-                        .div(10000)
-                        .toFixed(0),
-                    requiresBalance: false,
-                    asset: buyAsset,
-                },
-            }
-            : {};
         const tradeQuote = {
-            id: (0, uuid_1.v4)(),
+            ...tradeCommon,
             receiveAddress: normalizedReceiveAddress,
-            affiliateBps,
-            rate,
-            slippageTolerancePercentageDecimal: slippageTolerancePercentageDecimal ??
-                (0, constants_1.getDefaultSlippageDecimalPercentageForSwapper)(types_1.SwapperName.Avnu),
             quoteOrRate: 'quote',
-            swapperName: types_1.SwapperName.Avnu,
             steps: [
                 {
+                    ...stepCommon,
                     accountNumber,
-                    allowanceContract: '0x0',
-                    buyAmountBeforeFeesCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
-                    buyAmountAfterFeesCryptoBaseUnit,
-                    buyAsset,
-                    feeData: {
-                        protocolFees,
-                        networkFeeCryptoBaseUnit: feeData.fast.txFee,
-                    },
-                    rate,
-                    sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount,
-                    sellAsset,
-                    source: types_1.SwapperName.Avnu,
-                    estimatedExecutionTimeMs: undefined,
-                    avnuSpecific: {
-                        quoteId: bestQuote.quoteId,
-                        routes: bestQuote.routes,
-                    },
-                    affiliateFee: (0, affiliateFee_1.buildAffiliateFee)({
-                        strategy: 'buy_asset',
-                        affiliateBps,
-                        sellAsset,
-                        buyAsset,
-                        sellAmountCryptoBaseUnit: sellAmount,
-                        buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
-                    }),
+                    feeData: { protocolFees, networkFeeCryptoBaseUnit: feeData.fast.txFee },
+                    swapperMetadata: { name: 'avnu', quoteId },
                 },
             ],
         };
         return (0, monads_1.Ok)([tradeQuote]);
     }
     catch (error) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
+        return (0, monads_1.Err)((0, utils_1.makeSwapErrorRight)({
             message: error instanceof Error ? error.message : 'Unknown error getting AVNU quote',
             code: types_1.TradeQuoteError.QueryFailed,
             cause: error,

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

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

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

@@ -1,133 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTradeRate = void 0;
-const avnu_sdk_1 = require("@avnu/avnu-sdk");
-const utils_1 = require("@shapeshiftoss/utils");
 const monads_1 = require("@sniptt/monads");
 const starknet_1 = require("starknet");
-const uuid_1 = require("uuid");
-const constants_1 = require("../../../constants");
-const types_1 = require("../../../types");
-const utils_2 = require("../../../utils");
-const affiliateFee_1 = require("../../utils/affiliateFee");
-const helpers_1 = require("../../utils/helpers/helpers");
-const constants_2 = require("../utils/constants");
-const helpers_2 = require("../utils/helpers");
+const getAvnuTradeContext_1 = require("../utils/getAvnuTradeContext");
 const getTradeRate = async (input, deps) => {
-    const { sellAsset, buyAsset, sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount, slippageTolerancePercentageDecimal, affiliateBps, receiveAddress, } = input;
-    if (!constants_2.AVNU_SUPPORTED_CHAIN_IDS.includes(sellAsset.chainId)) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `Chain ${sellAsset.chainId} is not supported by AVNU`,
-            code: types_1.TradeQuoteError.UnsupportedChain,
-        }));
-    }
-    if (!constants_2.AVNU_SUPPORTED_CHAIN_IDS.includes(buyAsset.chainId)) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: `Chain ${buyAsset.chainId} is not supported by AVNU`,
-            code: types_1.TradeQuoteError.UnsupportedChain,
-        }));
-    }
-    try {
-        const sellTokenAddress = (0, helpers_2.getTokenAddress)(sellAsset);
-        const buyTokenAddress = (0, helpers_2.getTokenAddress)(buyAsset);
-        // Normalize receive address if provided (for fee estimation)
-        // Rate quotes may not have a receive address, so this is optional
-        const normalizedReceiveAddress = receiveAddress ? (0, starknet_1.validateAndParseAddress)(receiveAddress) : '';
-        const quotes = await (0, avnu_sdk_1.getQuotes)({
-            sellTokenAddress,
-            buyTokenAddress,
-            sellAmount: BigInt(sellAmount),
-            size: 1,
-            integratorFees: affiliateBps ? BigInt(affiliateBps) : undefined,
-            integratorFeeRecipient: (0, helpers_1.getTreasuryAddressFromChainId)(sellAsset.chainId),
-        });
-        if (!quotes || quotes.length === 0) {
-            return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-                message: 'No quotes available for this trade pair',
-                code: types_1.TradeQuoteError.NoRouteFound,
-            }));
+    const { accountNumber, sellAsset, receiveAddress } = input;
+    const maybeContext = await (0, getAvnuTradeContext_1.getAvnuTradeContext)({ input, takerAddress: undefined });
+    if (maybeContext.isErr())
+        return (0, monads_1.Err)(maybeContext.unwrapErr());
+    const { tradeCommon, stepCommon, protocolFees, sellTokenAddress } = maybeContext.unwrap();
+    // Rates may be walletless - normalize the receive address only when present, and use it as a
+    // stand-in sender for fee estimation
+    const normalizedReceiveAddress = receiveAddress
+        ? (0, starknet_1.validateAndParseAddress)(receiveAddress)
+        : undefined;
+    // Rates are best-effort display: without an address, or if estimation fails, degrade to a zero fee
+    const networkFeeCryptoBaseUnit = await (async () => {
+        if (!normalizedReceiveAddress)
+            return '0';
+        try {
+            const feeData = await deps.assertGetStarknetChainAdapter(sellAsset.chainId).getFeeData({
+                to: normalizedReceiveAddress,
+                value: stepCommon.sellAmountIncludingProtocolFeesCryptoBaseUnit,
+                chainSpecific: {
+                    from: normalizedReceiveAddress,
+                    tokenContractAddress: sellTokenAddress,
+                },
+                sendMax: false,
+            });
+            return feeData.fast.txFee;
         }
-        const bestQuote = quotes[0];
-        if (!bestQuote) {
-            return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-                message: 'No valid quote returned from AVNU',
-                code: types_1.TradeQuoteError.QueryFailed,
-            }));
+        catch {
+            return '0';
         }
-        const buyAmountAfterFeesCryptoBaseUnit = bestQuote.buyAmount.toString();
-        const sellAdapter = deps.assertGetStarknetChainAdapter(sellAsset.chainId);
-        // For rate quotes, use receiveAddress as a dummy from/to for fee estimation
-        const feeData = await sellAdapter.getFeeData({
-            to: normalizedReceiveAddress,
-            value: sellAmount,
-            chainSpecific: {
-                from: normalizedReceiveAddress,
-                tokenContractAddress: sellTokenAddress,
+    })();
+    const tradeRate = {
+        ...tradeCommon,
+        receiveAddress: normalizedReceiveAddress,
+        quoteOrRate: 'rate',
+        steps: [
+            {
+                ...stepCommon,
+                accountNumber,
+                feeData: { protocolFees, networkFeeCryptoBaseUnit },
             },
-            sendMax: false,
-        });
-        const rate = (0, utils_2.getInputOutputRate)({
-            sellAmountCryptoBaseUnit: sellAmount,
-            buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
-            sellAsset,
-            buyAsset,
-        });
-        const protocolFees = affiliateBps
-            ? {
-                [buyAsset.assetId]: {
-                    amountCryptoBaseUnit: (0, utils_1.bn)(buyAmountAfterFeesCryptoBaseUnit)
-                        .times(affiliateBps)
-                        .div(10000)
-                        .toFixed(0),
-                    requiresBalance: false,
-                    asset: buyAsset,
-                },
-            }
-            : {};
-        const tradeRate = {
-            id: (0, uuid_1.v4)(),
-            receiveAddress: normalizedReceiveAddress || receiveAddress,
-            affiliateBps,
-            rate,
-            slippageTolerancePercentageDecimal: slippageTolerancePercentageDecimal ??
-                (0, constants_1.getDefaultSlippageDecimalPercentageForSwapper)(types_1.SwapperName.Avnu),
-            quoteOrRate: 'rate',
-            swapperName: types_1.SwapperName.Avnu,
-            steps: [
-                {
-                    accountNumber: undefined,
-                    allowanceContract: '0x0',
-                    buyAmountBeforeFeesCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
-                    buyAmountAfterFeesCryptoBaseUnit,
-                    buyAsset,
-                    feeData: {
-                        protocolFees,
-                        networkFeeCryptoBaseUnit: feeData.fast.txFee,
-                    },
-                    rate,
-                    sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount,
-                    sellAsset,
-                    source: types_1.SwapperName.Avnu,
-                    estimatedExecutionTimeMs: undefined,
-                    affiliateFee: (0, affiliateFee_1.buildAffiliateFee)({
-                        strategy: 'buy_asset',
-                        affiliateBps,
-                        sellAsset,
-                        buyAsset,
-                        sellAmountCryptoBaseUnit: sellAmount,
-                        buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
-                    }),
-                },
-            ],
-        };
-        return (0, monads_1.Ok)([tradeRate]);
-    }
-    catch (error) {
-        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
-            message: error instanceof Error ? error.message : 'Unknown error getting AVNU rate',
-            code: types_1.TradeQuoteError.QueryFailed,
-            cause: error,
-        }));
-    }
+        ],
+    };
+    return (0, monads_1.Ok)([tradeRate]);
 };
 exports.getTradeRate = getTradeRate;

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

@@ -1,2 +1,9 @@
 import type { KnownChainIds } from '@shapeshiftoss/types';
+import type { GetStarknetTradeQuoteInput, GetStarknetTradeRateInput } from '../../types';
+export type AvnuTradeQuoteInput = GetStarknetTradeQuoteInput;
+export type AvnuTradeRateInput = GetStarknetTradeRateInput;
 export type AvnuSupportedChainId = typeof KnownChainIds.StarknetMainnet;
+export type AvnuMetadata = {
+    name: 'avnu';
+    quoteId: string;
+};

package/dist/cjs/swappers/AvnuSwapper/utils/getAvnuTradeContext.d.ts

@@ -0,0 +1,14 @@
+import type { Result } from '@sniptt/monads';
+import type { GetStarknetTradeQuoteInput, GetStarknetTradeRateInput, QuoteFeeData, SwapErrorRight, TradeCommon, TradeStepCommon } from '../../../types';
+type AvnuTradeContext = {
+    tradeCommon: TradeCommon;
+    stepCommon: Omit<TradeStepCommon, 'feeData'>;
+    protocolFees: QuoteFeeData['protocolFees'];
+    quoteId: string;
+    sellTokenAddress: string;
+};
+export declare const getAvnuTradeContext: ({ input, takerAddress, }: {
+    input: GetStarknetTradeQuoteInput | GetStarknetTradeRateInput;
+    takerAddress: string | undefined;
+}) => Promise<Result<AvnuTradeContext, SwapErrorRight>>;
+export {};

package/dist/cjs/swappers/AvnuSwapper/utils/getAvnuTradeContext.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAvnuTradeContext = void 0;
+const avnu_sdk_1 = require("@avnu/avnu-sdk");
+const caip_1 = require("@shapeshiftoss/caip");
+const utils_1 = require("@shapeshiftoss/utils");
+const monads_1 = require("@sniptt/monads");
+const uuid_1 = require("uuid");
+const constants_1 = require("../../../constants");
+const types_1 = require("../../../types");
+const utils_2 = require("../../../utils");
+const affiliateFee_1 = require("../../../utils/affiliateFee");
+const helpers_1 = require("../../../utils/helpers");
+const helpers_2 = require("./helpers");
+const getAvnuTradeContext = async ({ input, takerAddress, }) => {
+    const { sellAsset, buyAsset, sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount, slippageTolerancePercentageDecimal, affiliateBps, } = input;
+    const assertion = (0, helpers_2.assertValidTrade)({ sellAsset, buyAsset });
+    if (assertion.isErr())
+        return (0, monads_1.Err)(assertion.unwrapErr());
+    const sellTokenAddress = (0, helpers_2.getTokenAddress)(sellAsset);
+    const buyTokenAddress = (0, helpers_2.getTokenAddress)(buyAsset);
+    try {
+        const quotes = await (0, avnu_sdk_1.getQuotes)({
+            sellTokenAddress,
+            buyTokenAddress,
+            sellAmount: BigInt(sellAmount),
+            takerAddress,
+            size: 1,
+            integratorFees: affiliateBps ? BigInt(affiliateBps) : undefined,
+            integratorFeeRecipient: (0, helpers_1.getTreasuryAddressFromChainId)(caip_1.starknetChainId),
+            integratorName: 'shapeshift',
+        });
+        if (!quotes || quotes.length === 0) {
+            return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
+                message: 'No quotes available for this trade pair',
+                code: types_1.TradeQuoteError.NoRouteFound,
+            }));
+        }
+        const bestQuote = quotes[0];
+        if (!bestQuote) {
+            return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
+                message: 'No valid quote returned from AVNU',
+                code: types_1.TradeQuoteError.QueryFailed,
+            }));
+        }
+        const buyAmountAfterFeesCryptoBaseUnit = bestQuote.buyAmount.toString();
+        const rate = (0, utils_2.getInputOutputRate)({
+            sellAmountCryptoBaseUnit: sellAmount,
+            buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
+            sellAsset,
+            buyAsset,
+        });
+        const protocolFees = affiliateBps
+            ? {
+                [buyAsset.assetId]: {
+                    amountCryptoBaseUnit: (0, utils_1.bn)(buyAmountAfterFeesCryptoBaseUnit)
+                        .times(affiliateBps)
+                        .div(10000)
+                        .toFixed(0),
+                    requiresBalance: false,
+                    asset: buyAsset,
+                },
+            }
+            : {};
+        return (0, monads_1.Ok)({
+            tradeCommon: {
+                id: (0, uuid_1.v4)(),
+                rate,
+                affiliateBps,
+                slippageTolerancePercentageDecimal: slippageTolerancePercentageDecimal ??
+                    (0, constants_1.getDefaultSlippageDecimalPercentageForSwapper)(types_1.SwapperName.Avnu),
+                swapperName: types_1.SwapperName.Avnu,
+            },
+            stepCommon: {
+                allowanceContract: '',
+                buyAmountBeforeFeesCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
+                buyAmountAfterFeesCryptoBaseUnit,
+                buyAsset,
+                rate,
+                sellAmountIncludingProtocolFeesCryptoBaseUnit: sellAmount,
+                sellAsset,
+                source: types_1.SwapperName.Avnu,
+                estimatedExecutionTimeMs: undefined,
+                affiliateFee: (0, affiliateFee_1.buildAffiliateFee)({
+                    strategy: 'buy_asset',
+                    affiliateBps,
+                    sellAsset,
+                    buyAsset,
+                    sellAmountCryptoBaseUnit: sellAmount,
+                    buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
+                }),
+            },
+            protocolFees,
+            quoteId: bestQuote.quoteId,
+            sellTokenAddress,
+        });
+    }
+    catch (error) {
+        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
+            message: error instanceof Error ? error.message : 'Unknown error getting AVNU quote',
+            code: types_1.TradeQuoteError.QueryFailed,
+            cause: error,
+        }));
+    }
+};
+exports.getAvnuTradeContext = getAvnuTradeContext;

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

@@ -1,7 +1,18 @@
 import type { Asset } from '@shapeshiftoss/types';
+import type { Result } from '@sniptt/monads';
+import type { SwapErrorRight } from '../../../types';
 /**
  * Get the token address for AVNU swaps
  * For native STRK token (slip44 namespace), returns the STRK contract address
  * For other tokens, returns the token contract address from assetReference
  */
 export declare const getTokenAddress: (asset: Asset) => string;
+export declare const assertValidTrade: ({ sellAsset, buyAsset, }: {
+    sellAsset: Asset;
+    buyAsset: Asset;
+}) => Result<void, SwapErrorRight>;
+/**
+ * Normalize a value to hex format for Starknet RPC
+ * Handles various input types: decimal strings, hex strings (with/without 0x), numbers, BigInts
+ */
+export declare const toHexString: (value: unknown) => string;