@shapeshiftoss/swapper 20.3.0 → 20.5.0

package/dist/cjs/swappers/FyndSwapper/utils/getFyndTradeContext.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFyndTradeContext = void 0;
+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 helpers_1 = require("../../../utils/helpers");
+const fetchFromFynd_1 = require("./fetchFromFynd");
+const helpers_2 = require("./helpers");
+const getFyndTradeContext = async ({ input, deps, from, to, }) => {
+    const { sellAsset, buyAsset, sellAmountIncludingProtocolFeesCryptoBaseUnit, affiliateBps } = input;
+    const maybeChainId = (0, helpers_2.assertValidTrade)({ sellAsset, buyAsset });
+    if (maybeChainId.isErr())
+        return (0, monads_1.Err)(maybeChainId.unwrapErr());
+    const chainId = maybeChainId.unwrap();
+    const slippageTolerancePercentageDecimal = input.slippageTolerancePercentageDecimal ??
+        (0, constants_1.getDefaultSlippageDecimalPercentageForSwapper)(types_1.SwapperName.Fynd);
+    const clientFeeBps = (0, helpers_2.getFyndClientFeeBps)(affiliateBps);
+    const maybeQuote = await (0, fetchFromFynd_1.fetchFromFynd)({
+        input,
+        chainId,
+        sender: from,
+        receiver: to,
+        slippageTolerancePercentageDecimal,
+        clientFeeBps,
+        baseUrl: deps.config.VITE_FYND_BASE_URL,
+    });
+    if (maybeQuote.isErr())
+        return (0, monads_1.Err)(maybeQuote.unwrapErr());
+    const quote = maybeQuote.unwrap();
+    const { router_fee: routerFee, client_fee: clientFee } = quote.fee_breakdown;
+    const buyAmountBeforeFeesCryptoBaseUnit = quote.amount_out;
+    const buyAmountAfterFeesCryptoBaseUnit = (0, utils_1.bn)(quote.amount_out)
+        .minus(routerFee)
+        .minus(clientFee)
+        .toFixed();
+    const rate = (0, utils_2.getInputOutputRate)({
+        sellAmountCryptoBaseUnit: quote.amount_in,
+        buyAmountCryptoBaseUnit: buyAmountAfterFeesCryptoBaseUnit,
+        sellAsset,
+        buyAsset,
+    });
+    const protocols = (0, helpers_2.getFyndRouteProtocols)(quote.route?.swaps);
+    const source = protocols.length
+        ? `${types_1.SwapperName.Fynd} • ${protocols.join(', ')}`
+        : types_1.SwapperName.Fynd;
+    const allowanceContract = (0, helpers_1.isNativeEvmAsset)(sellAsset.assetId) ? '' : quote.transaction.to;
+    const protocolFees = (0, utils_1.bn)(routerFee).gt(0)
+        ? {
+            [buyAsset.assetId]: {
+                amountCryptoBaseUnit: routerFee,
+                asset: buyAsset,
+                requiresBalance: false,
+            },
+        }
+        : {};
+    return (0, monads_1.Ok)({
+        tradeCommon: {
+            id: (0, uuid_1.v4)(),
+            rate,
+            swapperName: types_1.SwapperName.Fynd,
+            affiliateBps,
+            slippageTolerancePercentageDecimal,
+        },
+        stepCommon: {
+            estimatedExecutionTimeMs: 0,
+            allowanceContract,
+            rate,
+            sellAsset,
+            buyAsset,
+            sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            buyAmountBeforeFeesCryptoBaseUnit,
+            buyAmountAfterFeesCryptoBaseUnit,
+            source,
+            affiliateFee: (0, utils_1.bn)(clientFee).gt(0)
+                ? { assetId: buyAsset.assetId, amountCryptoBaseUnit: clientFee, asset: buyAsset }
+                : undefined,
+        },
+        protocolFees,
+        deadline: quote.client_fee_deadline ? (0, helpers_1.normalizeEpochToMs)(quote.client_fee_deadline) : undefined,
+        stepDataArgs: {
+            quote,
+            sellAsset,
+            sellAmountCryptoBaseUnit: sellAmountIncludingProtocolFeesCryptoBaseUnit,
+            spenderAddress: allowanceContract,
+            from,
+            deps,
+        },
+    });
+};
+exports.getFyndTradeContext = getFyndTradeContext;

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

@@ -0,0 +1,24 @@
+import type { AssetId } from '@shapeshiftoss/caip';
+import type { Asset } from '@shapeshiftoss/types';
+import type { Result } from '@sniptt/monads';
+import type { Address } from 'viem';
+import type { SwapErrorRight } from '../../../types';
+import type { FyndEncodedQuote, FyndQuoteResponse, FyndRouteSwap } from '../types';
+import type { FyndSupportedChainId } from './constants';
+export declare const getFyndRouteProtocols: (swaps: FyndRouteSwap[] | undefined) => string[];
+export declare const getFyndClientFeeBps: (affiliateBps: string) => number;
+export declare const convertAssetIdToFyndToken: (assetId: AssetId) => Address;
+export declare const assertValidTrade: ({ sellAsset, buyAsset, }: {
+    sellAsset: Asset;
+    buyAsset: Asset;
+}) => Result<FyndSupportedChainId, SwapErrorRight>;
+export declare const getFyndRequestError: (error: SwapErrorRight) => SwapErrorRight;
+type FyndQuoteContext = {
+    chainId: FyndSupportedChainId;
+    sellAsset: Asset;
+    sellAmountCryptoBaseUnit: string;
+    slippageTolerancePercentageDecimal: string;
+    clientFeeBps: number;
+};
+export declare const validateFyndQuoteResponse: (response: FyndQuoteResponse, context: FyndQuoteContext) => Result<FyndEncodedQuote, SwapErrorRight>;
+export {};

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

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFyndQuoteResponse = exports.getFyndRequestError = exports.assertValidTrade = exports.convertAssetIdToFyndToken = exports.getFyndClientFeeBps = exports.getFyndRouteProtocols = void 0;
+const caip_1 = require("@shapeshiftoss/caip");
+const utils_1 = require("@shapeshiftoss/utils");
+const monads_1 = require("@sniptt/monads");
+const axios_1 = __importDefault(require("axios"));
+const viem_1 = require("viem");
+const types_1 = require("../../../types");
+const utils_2 = require("../../../utils");
+const helpers_1 = require("../../../utils/helpers");
+const constants_1 = require("./constants");
+const isFyndSupportedChainId = (chainId) => chainId in constants_1.FYND_CHAINS;
+// Protocol ids look like uniswap_v3, vm:balancer_v2 or fallback:rfq:bebop
+const formatFyndProtocol = (protocol) => protocol
+    .slice(protocol.lastIndexOf(':') + 1)
+    .split('_')
+    .map(word => /^v\d+$/.test(word) ? word.toUpperCase() : word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+// The native_wrapper hop is only the WETH wrap/unwrap around the real venues
+const getFyndRouteProtocols = (swaps) => {
+    const venues = (swaps ?? [])
+        .map(swap => swap.protocol)
+        .filter(protocol => !protocol.endsWith('native_wrapper'));
+    return [...new Set(venues)].map(formatFyndProtocol);
+};
+exports.getFyndRouteProtocols = getFyndRouteProtocols;
+const getFyndClientFeeBps = (affiliateBps) => (0, utils_1.bn)(affiliateBps).div(constants_1.FYND_CLIENT_FEE_SHARE).integerValue(utils_1.BigNumber.ROUND_CEIL).toNumber();
+exports.getFyndClientFeeBps = getFyndClientFeeBps;
+const convertAssetIdToFyndToken = (assetId) => {
+    if ((0, helpers_1.isNativeEvmAsset)(assetId))
+        return viem_1.zeroAddress;
+    return (0, viem_1.getAddress)((0, caip_1.fromAssetId)(assetId).assetReference);
+};
+exports.convertAssetIdToFyndToken = convertAssetIdToFyndToken;
+const assertValidTrade = ({ sellAsset, buyAsset, }) => {
+    if (sellAsset.chainId !== buyAsset.chainId) {
+        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
+            message: 'Fynd does not support cross-chain trades',
+            code: types_1.TradeQuoteError.CrossChainNotSupported,
+        }));
+    }
+    if (!isFyndSupportedChainId(sellAsset.chainId)) {
+        return (0, monads_1.Err)((0, utils_2.makeSwapErrorRight)({
+            message: 'Fynd only supports configured EVM chains',
+            code: types_1.TradeQuoteError.UnsupportedChain,
+        }));
+    }
+    return (0, monads_1.Ok)(sellAsset.chainId);
+};
+exports.assertValidTrade = assertValidTrade;
+const getFyndStatusError = (status, detail) => {
+    const code = (() => {
+        switch (status.toLowerCase()) {
+            case 'no_route_found':
+            case 'insufficient_liquidity':
+                return types_1.TradeQuoteError.NoRouteFound;
+            case 'timeout':
+                return types_1.TradeQuoteError.Timeout;
+            default:
+                return types_1.TradeQuoteError.QueryFailed;
+        }
+    })();
+    return (0, utils_2.makeSwapErrorRight)({
+        message: `Fynd quote failed: ${status}${detail ? ` (${detail})` : ''}`,
+        code,
+    });
+};
+const isFyndErrorResponse = (value) => typeof value === 'object' &&
+    value !== null &&
+    'error' in value &&
+    typeof value.error === 'string' &&
+    'code' in value &&
+    typeof value.code === 'string';
+const getFyndRequestError = (error) => {
+    const { cause } = error;
+    if (!axios_1.default.isAxiosError(cause))
+        return error;
+    if (cause.response?.status === 429) {
+        return (0, utils_2.makeSwapErrorRight)({
+            message: 'Fynd rate limit exceeded',
+            code: types_1.TradeQuoteError.RateLimitExceeded,
+        });
+    }
+    const body = cause.response?.data;
+    if (isFyndErrorResponse(body))
+        return getFyndStatusError(body.code, body.error);
+    return (0, utils_2.makeSwapErrorRight)({
+        message: `Fynd request failed with status ${cause.response?.status}`,
+        code: types_1.TradeQuoteError.QueryFailed,
+        cause,
+    });
+};
+exports.getFyndRequestError = getFyndRequestError;
+const invalidResponse = (message, details) => (0, utils_2.makeSwapErrorRight)({ message, details, code: types_1.TradeQuoteError.InvalidResponse });
+const getQuoteError = (quote, { chainId, sellAsset, sellAmountCryptoBaseUnit, slippageTolerancePercentageDecimal, clientFeeBps, }) => {
+    const { transaction, fee_breakdown: fees } = quote;
+    const pinnedRouter = constants_1.FYND_CHAINS[chainId].routerAddress;
+    if (!(0, viem_1.isAddress)(transaction.to, { strict: false }) ||
+        !(0, viem_1.isAddressEqual)(transaction.to, pinnedRouter)) {
+        return invalidResponse(`Fynd router ${transaction.to} is not the pinned router ${pinnedRouter} for ${chainId}`);
+    }
+    if (!(0, utils_1.bn)(quote.amount_in).eq(sellAmountCryptoBaseUnit)) {
+        return invalidResponse('Fynd quoted a different sell amount', {
+            amountIn: quote.amount_in,
+            sellAmountCryptoBaseUnit,
+        });
+    }
+    const expectedValue = (0, helpers_1.isNativeEvmAsset)(sellAsset.assetId) ? sellAmountCryptoBaseUnit : '0';
+    if (!(0, utils_1.bn)(transaction.value).eq(expectedValue)) {
+        return invalidResponse('Fynd transaction value does not match the sell amount', {
+            value: transaction.value,
+            expectedValue,
+        });
+    }
+    // The router enforces min_amount_received, which may not be looser than the requested slippage
+    const netOutput = (0, utils_1.bn)(quote.amount_out).minus(fees.router_fee).minus(fees.client_fee);
+    const outputFloor = netOutput
+        .times((0, utils_1.bn)(1).minus(slippageTolerancePercentageDecimal))
+        .integerValue(utils_1.BigNumber.ROUND_DOWN);
+    if ((0, utils_1.bn)(fees.min_amount_received).lt(outputFloor)) {
+        return invalidResponse('Fynd output floor is below the requested slippage', {
+            minAmountReceived: fees.min_amount_received,
+            outputFloor: outputFloor.toFixed(),
+            slippageTolerancePercentageDecimal,
+        });
+    }
+    if (clientFeeBps === 0) {
+        if (!(0, utils_1.bn)(fees.client_fee).isZero()) {
+            return invalidResponse('Fynd returned an unexpected client fee', {
+                clientFee: fees.client_fee,
+            });
+        }
+        return;
+    }
+    // Our share of the gross client fee, allowing one unit of rounding
+    const minClientFee = (0, utils_1.bn)(quote.amount_out)
+        .times(clientFeeBps)
+        .div(10_000)
+        .times(constants_1.FYND_CLIENT_FEE_SHARE)
+        .integerValue(utils_1.BigNumber.ROUND_DOWN)
+        .minus(1);
+    if ((0, utils_1.bn)(fees.client_fee).lt(minClientFee)) {
+        return invalidResponse('Fynd client fee is below the requested share', {
+            clientFee: fees.client_fee,
+            amountOut: quote.amount_out,
+            clientFeeBps,
+        });
+    }
+    // The proxy patches the signature over Fynd's zeroed placeholder at the reported offset
+    const offset = transaction.client_fee_signature_offset;
+    const signature = typeof offset === 'number'
+        ? transaction.data.slice(2 + offset * 2, 2 + (offset + constants_1.FYND_CLIENT_FEE_SIGNATURE_BYTES) * 2)
+        : '';
+    if (signature.length !== constants_1.FYND_CLIENT_FEE_SIGNATURE_BYTES * 2 || /^0+$/.test(signature)) {
+        return invalidResponse('Fynd quote is not signed for the client fee', { offset });
+    }
+    if (!quote.client_fee_deadline) {
+        return invalidResponse('Fynd quote is missing its client fee deadline');
+    }
+};
+const validateFyndQuoteResponse = (response, context) => {
+    const order = Array.isArray(response?.orders) ? response.orders[0] : undefined;
+    if (!order)
+        return (0, monads_1.Err)(invalidResponse('Fynd returned no order'));
+    if (order.status !== 'success')
+        return (0, monads_1.Err)(getFyndStatusError(order.status));
+    const error = getQuoteError(order, context);
+    return error ? (0, monads_1.Err)(error) : (0, monads_1.Ok)(order);
+};
+exports.validateFyndQuoteResponse = validateFyndQuoteResponse;

package/dist/cjs/swappers/FyndSwapper/utils/helpers.test.d.ts

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

package/dist/cjs/swappers/FyndSwapper/utils/helpers.test.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const types_1 = require("@shapeshiftoss/types");
+const vitest_1 = require("vitest");
+const assets_1 = require("../../../utils/test-data/assets");
+const constants_1 = require("./constants");
+const helpers_1 = require("./helpers");
+(0, vitest_1.describe)('getFyndClientFeeBps', () => {
+    vitest_1.it.each([
+        ['nets the default fee after the 20% share', '60', 75],
+        ['rounds up so the net never falls short', '55', 69],
+        ['requests nothing for a fee-free swap', '0', 0],
+    ])('%s', (_label, affiliateBps, grossBps) => {
+        (0, vitest_1.expect)((0, helpers_1.getFyndClientFeeBps)(affiliateBps)).toBe(grossBps);
+    });
+});
+(0, vitest_1.describe)('validateFyndQuoteResponse', () => {
+    const router = constants_1.FYND_CHAINS['eip155:1'].routerAddress;
+    const unpinnedRouter = '0x1111111111111111111111111111111111111111';
+    const transaction = {
+        to: router,
+        value: '0',
+        data: '0x12345678',
+        client_fee_signature_offset: null,
+    };
+    const fees = { router_fee: '10', client_fee: '0', max_slippage: '4', min_amount_received: '986' };
+    const order = {
+        status: 'success',
+        amount_in: '1000',
+        amount_out: '1000',
+        gas_estimate: '21000',
+        transaction,
+        fee_breakdown: fees,
+    };
+    const context = {
+        chainId: types_1.KnownChainIds.EthereumMainnet,
+        sellAsset: assets_1.WETH,
+        sellAmountCryptoBaseUnit: '1000',
+        slippageTolerancePercentageDecimal: '0.005',
+        clientFeeBps: 0,
+    };
+    const validate = (overrides, contextOverrides = {}) => (0, helpers_1.validateFyndQuoteResponse)({ orders: [{ ...order, ...overrides }] }, { ...context, ...contextOverrides });
+    (0, vitest_1.it)('accepts a quote that matches the request', () => {
+        (0, vitest_1.expect)(validate({}).isOk()).toBe(true);
+    });
+    vitest_1.it.each([
+        ['an unpinned router', { transaction: { ...transaction, to: unpinnedRouter } }],
+        ['a different sell amount', { amount_in: '999' }],
+        ['native value on a token sell', { transaction: { ...transaction, value: '1' } }],
+        [
+            'an output floor looser than the slippage',
+            { fee_breakdown: { ...fees, min_amount_received: '984' } },
+        ],
+        ['a client fee we did not request', { fee_breakdown: { ...fees, client_fee: '1' } }],
+    ])('rejects %s', (_label, overrides) => {
+        (0, vitest_1.expect)(validate(overrides).isErr()).toBe(true);
+    });
+    (0, vitest_1.it)('binds native transaction value to the requested sell amount', () => {
+        (0, vitest_1.expect)(validate({}, { sellAsset: assets_1.ETH }).isErr()).toBe(true);
+        (0, vitest_1.expect)(validate({ transaction: { ...transaction, value: '1000' } }, { sellAsset: assets_1.ETH }).isOk()).toBe(true);
+    });
+    (0, vitest_1.it)('maps a missing route to NoRouteFound', () => {
+        const result = (0, helpers_1.validateFyndQuoteResponse)({ orders: [{ status: 'no_route_found' }] }, context);
+        (0, vitest_1.expect)(result.unwrapErr().code).toBe('NoRouteFound');
+    });
+    (0, vitest_1.describe)('with a client fee', () => {
+        const feeContext = { clientFeeBps: 75 };
+        const feeOrder = {
+            transaction: {
+                ...transaction,
+                data: `0x12345678${'ab'.repeat(65)}`,
+                client_fee_signature_offset: 4,
+            },
+            fee_breakdown: {
+                router_fee: '2',
+                client_fee: '6',
+                max_slippage: '4',
+                min_amount_received: '988',
+            },
+            client_fee_deadline: 1_900_000_000,
+        };
+        (0, vitest_1.it)('accepts a signed quote carrying our share of the fee', () => {
+            (0, vitest_1.expect)(validate(feeOrder, feeContext).isOk()).toBe(true);
+        });
+        vitest_1.it.each([
+            [
+                'a fee below our share',
+                {
+                    fee_breakdown: { ...feeOrder.fee_breakdown, client_fee: '4', min_amount_received: '990' },
+                },
+            ],
+            [
+                'an unsigned placeholder',
+                { transaction: { ...feeOrder.transaction, data: `0x12345678${'00'.repeat(65)}` } },
+            ],
+            ['a missing deadline', { client_fee_deadline: null }],
+        ])('rejects %s', (_label, overrides) => {
+            (0, vitest_1.expect)(validate({ ...feeOrder, ...overrides }, feeContext).isErr()).toBe(true);
+        });
+    });
+});

package/dist/cjs/swappers/KyberSwapper/KyberSwapper.d.ts

@@ -0,0 +1,2 @@
+import type { Swapper } from '../../types';
+export declare const kyberSwapper: Swapper;

package/dist/cjs/swappers/KyberSwapper/KyberSwapper.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kyberSwapper = void 0;
+const utils_1 = require("../../utils");
+exports.kyberSwapper = { executeEvmTransaction: utils_1.executeEvmTransaction };

package/dist/cjs/swappers/KyberSwapper/endpoints.d.ts

@@ -0,0 +1,2 @@
+import type { SwapperApi } from '../../types';
+export declare const kyberApi: SwapperApi;

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kyberApi = void 0;
+const utils_1 = require("../../utils");
+const evm_1 = require("../../utils/evm");
+const getKyberTradeQuote_1 = require("./swapperApi/getKyberTradeQuote");
+const getKyberTradeRate_1 = require("./swapperApi/getKyberTradeRate");
+exports.kyberApi = {
+    getTradeQuote: (input, deps) => (0, getKyberTradeQuote_1.getKyberTradeQuote)(input, deps),
+    getTradeRate: (input, deps) => (0, getKyberTradeRate_1.getKyberTradeRate)(input, deps),
+    getUnsignedEvmTransaction: evm_1.getUnsignedEvmTransaction,
+    getEvmTransactionFees: evm_1.getEvmTransactionFees,
+    checkTradeStatus: utils_1.checkEvmSwapStatus,
+};

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

@@ -0,0 +1,2 @@
+export { kyberApi } from './endpoints';
+export { kyberSwapper } from './KyberSwapper';

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kyberSwapper = exports.kyberApi = void 0;
+var endpoints_1 = require("./endpoints");
+Object.defineProperty(exports, "kyberApi", { enumerable: true, get: function () { return endpoints_1.kyberApi; } });
+var KyberSwapper_1 = require("./KyberSwapper");
+Object.defineProperty(exports, "kyberSwapper", { enumerable: true, get: function () { return KyberSwapper_1.kyberSwapper; } });

package/dist/cjs/swappers/KyberSwapper/swapperApi/getKyberTradeQuote.d.ts

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

package/dist/cjs/swappers/KyberSwapper/swapperApi/getKyberTradeQuote.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKyberTradeQuote = void 0;
+const monads_1 = require("@sniptt/monads");
+const utils_1 = require("../../../utils");
+const constants_1 = require("../utils/constants");
+const fetchFromKyber_1 = require("../utils/fetchFromKyber");
+const getKyberStepData_1 = require("../utils/getKyberStepData");
+const getKyberTradeContext_1 = require("../utils/getKyberTradeContext");
+const helpers_1 = require("../utils/helpers");
+const getKyberTradeQuote = async (input, deps) => {
+    const { accountNumber } = input;
+    const maybeAddresses = (0, utils_1.assertQuoteAddresses)(input);
+    if (maybeAddresses.isErr())
+        return (0, monads_1.Err)(maybeAddresses.unwrapErr());
+    const { sendAddress, receiveAddress } = maybeAddresses.unwrap();
+    const maybeContext = await (0, getKyberTradeContext_1.getKyberTradeContext)({ input, deps });
+    if (maybeContext.isErr())
+        return (0, monads_1.Err)(maybeContext.unwrapErr());
+    const { tradeCommon, stepCommon, protocolFees, chainId, route, stepDataArgs } = maybeContext.unwrap();
+    const deadline = Math.floor(Date.now() / 1000) + constants_1.KYBER_DEADLINE_SECONDS;
+    const maybeBuild = await (0, fetchFromKyber_1.fetchKyberBuild)({
+        chainId,
+        route,
+        slippageTolerancePercentageDecimal: tradeCommon.slippageTolerancePercentageDecimal,
+        baseUrl: deps.config.VITE_KYBER_BASE_URL,
+        sendAddress,
+        receiveAddress,
+        deadline,
+    });
+    if (maybeBuild.isErr())
+        return (0, monads_1.Err)(maybeBuild.unwrapErr());
+    const build = maybeBuild.unwrap();
+    // Kyber re-prices at build time and derives the calldata's minimum return from the built amount
+    const tradeAmounts = (0, helpers_1.getKyberTradeAmounts)({ input, amountOut: build.amountOut });
+    const maybeStepData = await (0, getKyberStepData_1.getKyberStepData)({
+        ...stepDataArgs,
+        type: 'quote',
+        input,
+        from: sendAddress,
+        build,
+    });
+    if (maybeStepData.isErr())
+        return (0, monads_1.Err)(maybeStepData.unwrapErr());
+    const { transactionData, networkFeeCryptoBaseUnit } = maybeStepData.unwrap();
+    const tradeQuote = {
+        ...tradeCommon,
+        rate: tradeAmounts.rate,
+        quoteOrRate: 'quote',
+        receiveAddress,
+        deadline: deadline * 1000,
+        steps: [
+            {
+                ...stepCommon,
+                ...tradeAmounts,
+                accountNumber,
+                transactionData,
+                feeData: { networkFeeCryptoBaseUnit, protocolFees },
+            },
+        ],
+    };
+    return (0, monads_1.Ok)([tradeQuote]);
+};
+exports.getKyberTradeQuote = getKyberTradeQuote;

package/dist/cjs/swappers/KyberSwapper/swapperApi/getKyberTradeRate.d.ts

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

package/dist/cjs/swappers/KyberSwapper/swapperApi/getKyberTradeRate.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKyberTradeRate = void 0;
+const monads_1 = require("@sniptt/monads");
+const getKyberStepData_1 = require("../utils/getKyberStepData");
+const getKyberTradeContext_1 = require("../utils/getKyberTradeContext");
+const getKyberTradeRate = async (input, deps) => {
+    const { accountNumber, receiveAddress } = input;
+    const maybeContext = await (0, getKyberTradeContext_1.getKyberTradeContext)({ input, deps });
+    if (maybeContext.isErr())
+        return (0, monads_1.Err)(maybeContext.unwrapErr());
+    const { tradeCommon, stepCommon, protocolFees, stepDataArgs } = maybeContext.unwrap();
+    const maybeStepData = await (0, getKyberStepData_1.getKyberStepData)({ ...stepDataArgs, type: 'rate', input });
+    if (maybeStepData.isErr())
+        return (0, monads_1.Err)(maybeStepData.unwrapErr());
+    const { networkFeeCryptoBaseUnit } = maybeStepData.unwrap();
+    const tradeRate = {
+        ...tradeCommon,
+        quoteOrRate: 'rate',
+        receiveAddress,
+        steps: [
+            {
+                ...stepCommon,
+                accountNumber,
+                feeData: { networkFeeCryptoBaseUnit, protocolFees },
+            },
+        ],
+    };
+    return (0, monads_1.Ok)([tradeRate]);
+};
+exports.getKyberTradeRate = getKyberTradeRate;

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

@@ -0,0 +1,62 @@
+import type { Address, Hex } from 'viem';
+import type { GetEvmTradeQuoteInput, GetEvmTradeRateInput } from '../../types';
+export type KyberTradeQuoteInput = GetEvmTradeQuoteInput;
+export type KyberTradeRateInput = GetEvmTradeRateInput;
+export type KyberExtraFee = {
+    feeAmount: string;
+    chargeFeeBy: '' | 'currency_in' | 'currency_out';
+    isInBps: boolean;
+    feeReceiver: string;
+};
+export type KyberFeeParams = {
+    feeAmount: string;
+    chargeFeeBy: 'currency_out';
+    isInBps: true;
+    feeReceiver: Address;
+};
+export type KyberRouteSummary = {
+    tokenIn: string;
+    amountIn: string;
+    amountInUsd: string;
+    tokenOut: string;
+    amountOut: string;
+    amountOutUsd: string;
+    gas: string;
+    gasPrice: string;
+    gasUsd: string;
+    l1FeeUsd: string;
+    extraFee: KyberExtraFee;
+    route: unknown;
+    routerAddress: Address;
+    routeID: string;
+    checksum: string;
+    timestamp: number;
+};
+export type KyberRouteData = {
+    routeSummary: KyberRouteSummary;
+    routerAddress: Address;
+};
+export type KyberRoutesResponse = {
+    code: number;
+    message: string;
+    data?: KyberRouteData;
+    requestId: string;
+};
+export type KyberBuildData = {
+    amountOut: string;
+    gas: string;
+    data: Hex;
+    routerAddress: Address;
+    transactionValue: string;
+};
+export type KyberBuildResponse = {
+    code: number;
+    message: string;
+    data?: KyberBuildData;
+    requestId: string;
+};
+export type KyberErrorResponse = {
+    code: number;
+    message: string;
+    requestId?: string;
+};

package/dist/cjs/swappers/KyberSwapper/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/swappers/KyberSwapper/utils/constants.d.ts

@@ -0,0 +1,21 @@
+import type { Address } from 'viem';
+export declare const KYBER_CLIENT_ID = "shapeshift";
+export declare const KYBER_DEADLINE_SECONDS = 1200;
+export declare const KYBER_CHAINS: {
+    readonly "eip155:1": "ethereum";
+    readonly "eip155:10": "optimism";
+    readonly "eip155:56": "bsc";
+    readonly "eip155:137": "polygon";
+    readonly "eip155:42161": "arbitrum";
+    readonly "eip155:8453": "base";
+    readonly "eip155:43114": "avalanche";
+    readonly "eip155:130": "unichain";
+    readonly "eip155:4663": "robinhood";
+    readonly "eip155:143": "monad";
+    readonly "eip155:999": "hyperevm";
+    readonly "eip155:4326": "megaeth";
+    readonly "eip155:9745": "plasma";
+};
+export type KyberSupportedChainId = keyof typeof KYBER_CHAINS;
+export declare const KYBER_ROUTER_ADDRESS: Address;
+export declare const KYBER_NATIVE_TOKEN: Address;

package/dist/cjs/swappers/KyberSwapper/utils/constants.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KYBER_NATIVE_TOKEN = exports.KYBER_ROUTER_ADDRESS = exports.KYBER_CHAINS = exports.KYBER_DEADLINE_SECONDS = exports.KYBER_CLIENT_ID = void 0;
+const types_1 = require("@shapeshiftoss/types");
+exports.KYBER_CLIENT_ID = 'shapeshift';
+exports.KYBER_DEADLINE_SECONDS = 1200;
+exports.KYBER_CHAINS = {
+    [types_1.KnownChainIds.EthereumMainnet]: 'ethereum',
+    [types_1.KnownChainIds.OptimismMainnet]: 'optimism',
+    [types_1.KnownChainIds.BnbSmartChainMainnet]: 'bsc',
+    [types_1.KnownChainIds.PolygonMainnet]: 'polygon',
+    [types_1.KnownChainIds.ArbitrumMainnet]: 'arbitrum',
+    [types_1.KnownChainIds.BaseMainnet]: 'base',
+    [types_1.KnownChainIds.AvalancheMainnet]: 'avalanche',
+    [types_1.KnownChainIds.UnichainMainnet]: 'unichain',
+    [types_1.KnownChainIds.RobinhoodMainnet]: 'robinhood',
+    [types_1.KnownChainIds.MonadMainnet]: 'monad',
+    [types_1.KnownChainIds.HyperEvmMainnet]: 'hyperevm',
+    [types_1.KnownChainIds.MegaEthMainnet]: 'megaeth',
+    [types_1.KnownChainIds.PlasmaMainnet]: 'plasma',
+};
+// MetaAggregationRouterV2, same address on every chain: https://docs.kyberswap.com/developer-guide/aggregator-api/contracts
+exports.KYBER_ROUTER_ADDRESS = '0x6131B5fae19EA4f9D964eAc0408E4408b66337b5';
+exports.KYBER_NATIVE_TOKEN = '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE';