@cowprotocol/sdk-trading 0.1.0-monorepo.0

package/dist/index.d.mts

@@ -0,0 +1,326 @@
+import { latest, AppDataParams, LatestAppDataDocVersion } from '@cowprotocol/sdk-app-data';
+import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi } from '@cowprotocol/sdk-order-book';
+import { AccountAddress, SignerLike, AbstractSigner, Signer, AbstractProviderAdapter, EthFlowContract } from '@cowprotocol/sdk-common';
+import { UnsignedOrder } from '@cowprotocol/sdk-order-signing';
+import { CowEnv, SupportedChainId } from '@cowprotocol/sdk-config';
+
+declare const ORDER_PRIMARY_TYPE: "Order";
+/**
+ * EIP-712 typed data domain.
+ */
+interface TypedDataDomain {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: string;
+}
+/**
+ * EIP-712 typed data field.
+ */
+interface TypedDataField {
+    name: string;
+    type: string;
+}
+/**
+ * EIP-712 typed data for an order.
+ */
+interface OrderTypedData {
+    domain: TypedDataDomain;
+    primaryType: typeof ORDER_PRIMARY_TYPE;
+    types: Record<string, TypedDataField[]>;
+    message: UnsignedOrder;
+}
+/**
+ * Minimal set of parameters to create a trade.
+ */
+interface TradeBaseParameters {
+    kind: OrderKind;
+    owner?: AccountAddress;
+    sellToken: OrderParameters['sellToken'];
+    sellTokenDecimals: number;
+    buyToken: OrderParameters['buyToken'];
+    buyTokenDecimals: number;
+    amount: TokenAmount;
+}
+/**
+ * Optional parameters to create a trade.
+ */
+interface TradeOptionalParameters {
+    env?: CowEnv;
+    partiallyFillable?: OrderParameters['partiallyFillable'];
+    /**
+     * Slippage in basis points.
+     * If not provided, it will use AUTO slippage, which would suggest a slippage based on the quote.
+     */
+    slippageBps?: latest.SlippageBips;
+    receiver?: OrderParameters['receiver'];
+    validFor?: OrderParameters['validTo'];
+    partnerFee?: latest.PartnerFee;
+}
+/**
+ * Information about the trader.
+ */
+interface TraderParameters {
+    chainId: SupportedChainId;
+    appCode: latest.AppCode;
+    signer?: SignerLike;
+    env?: CowEnv;
+}
+type QuoterParameters = Omit<TraderParameters, 'signer'> & {
+    account: AccountAddress;
+};
+/**
+ * Trade type, assets, amounts, and optional parameters.
+ */
+interface TradeParameters extends TradeBaseParameters, TradeOptionalParameters {
+}
+interface SwapParameters extends TradeParameters, TraderParameters {
+}
+interface LimitTradeParameters extends Omit<TradeParameters, 'amount'> {
+    sellAmount: OrderParameters['sellAmount'];
+    buyAmount: OrderParameters['buyAmount'];
+    /**
+     * Id of the quote to be used for the limit order.
+     */
+    quoteId?: number;
+    validTo?: OrderParameters['validTo'];
+}
+interface LimitTradeParametersFromQuote extends LimitTradeParameters {
+    quoteId: number;
+}
+interface LimitOrderParameters extends TraderParameters, LimitTradeParameters {
+}
+interface SwapAdvancedSettings {
+    quoteRequest?: Partial<Omit<OrderQuoteRequest, 'kind'> & {
+        validTo: number;
+    }>;
+    appData?: AppDataParams;
+    additionalParams?: PostTradeAdditionalParams;
+    quoteSigner?: SignerLike;
+}
+interface LimitOrderAdvancedSettings {
+    appData?: AppDataParams;
+    additionalParams?: PostTradeAdditionalParams;
+}
+/**
+ * Quote information for the CoW Protocol order, including information about the trade, quote, order, "app-data", and more.
+ *
+ * This data is used to create a trade, sign an order, and post it to the order book.
+ */
+interface QuoteResults {
+    /**
+     * Information about the trade, including the kind of order, the owner, the sell and buy tokens, and the amount.
+     */
+    tradeParameters: TradeParameters;
+    /**
+     * The suggested slippage based on the quote.
+     *
+     */
+    suggestedSlippageBps: number;
+    /**
+     * Details about costs and amounts, costs and fees of a quote.
+     */
+    amountsAndCosts: QuoteAmountsAndCosts;
+    /**
+     * Information about the order to be signed.
+     *
+     * For signining, please use orderTypedData (EIP-712 typed data, which also includes the unsigned order)
+     */
+    orderToSign: UnsignedOrder;
+    /**
+     * Information about the quote response from the order book API.
+     */
+    quoteResponse: OrderQuoteResponse;
+    /**
+     * Information about the app-data, including the JSON document and the keccak256 hash of the full document.
+     */
+    appDataInfo: TradingAppDataInfo;
+    /**
+     * EIP-712 typed data for the order ready to be signed.
+     */
+    orderTypedData: OrderTypedData;
+}
+interface QuoteResultsSerialized extends Omit<QuoteResults, 'amountsAndCosts'> {
+    amountsAndCosts: QuoteAmountsAndCosts<string>;
+}
+interface OrderPostingResult {
+    orderId: string;
+    txHash?: string;
+    signingScheme: SigningScheme;
+    signature: Signature;
+    orderToSign: UnsignedOrder;
+}
+interface QuoteAndPost {
+    quoteResults: QuoteResults;
+    postSwapOrderFromQuote(advancedSettings?: SwapAdvancedSettings): Promise<OrderPostingResult>;
+}
+type AppDataRootSchema = latest.AppDataRootSchema;
+interface BuildAppDataParams {
+    appCode: latest.AppCode;
+    slippageBps: latest.SlippageBips;
+    orderClass: latest.OrderClass['orderClass'];
+    partnerFee?: latest.PartnerFee;
+}
+/**
+ * Information about the app-data for trading operations, including the JSON document and the keccak256 hash of the full document.
+ *
+ * See https://github.com/cowprotocol/app-data
+ */
+interface TradingAppDataInfo {
+    doc: LatestAppDataDocVersion;
+    fullAppData: AppData;
+    appDataKeccak256: AppDataHash;
+}
+/**
+ * A standard Ethereum transaction object
+ */
+interface TradingTransactionParams {
+    data: string;
+    gasLimit: string;
+    to: string;
+    value: string;
+}
+interface EthFlowOrderExistsCallback {
+    (orderId: string, orderDigest: string): Promise<boolean>;
+}
+/**
+ * Additional parameters for posting orders.
+ * In most of the cases you don't need to use them.
+ */
+interface PostTradeAdditionalParams {
+    /**
+     * Selling native token orders are special, because they are created from smart-contract,
+     * and their validTo is always the same.
+     * Because of that, you might get the same orderId when trying to create an order with the same parameters
+     * The callback is needed to check if there is already an order with the same orderId
+     *
+     * @see https://github.com/cowprotocol/ethflowcontract/blob/main/src/libraries/EthFlowOrder.sol#L90
+     */
+    checkEthFlowOrderExists?: EthFlowOrderExistsCallback;
+    /**
+     * Cost of executing the order onchain.
+     * The value is used in getQuoteAmountsAndCosts in order to calculate proper amounts
+     */
+    networkCostsAmount?: string;
+    /**
+     * By default, is EIP712 for EOA wallets.
+     * You might need other types of signing, for example PRESIGN when sign order via Smart Contract wallets.
+     */
+    signingScheme?: SigningScheme;
+}
+
+type QuoteResultsWithSigner = {
+    result: QuoteResults & {
+        signer: AbstractSigner;
+    };
+    orderBookApi: OrderBookApi;
+};
+declare function getQuote(_tradeParameters: TradeParameters, trader: QuoterParameters, advancedSettings?: SwapAdvancedSettings, _orderBookApi?: OrderBookApi): Promise<{
+    result: QuoteResults;
+    orderBookApi: OrderBookApi;
+}>;
+declare function getQuoteWithSigner(swapParameters: SwapParameters, advancedSettings?: SwapAdvancedSettings, orderBookApi?: OrderBookApi): Promise<QuoteResultsWithSigner>;
+
+declare function postSellNativeCurrencyOrder(orderBookApi: OrderBookApi, appData: Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>, _params: LimitTradeParametersFromQuote, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<OrderPostingResult>;
+
+declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, account: string, orderId: string): Promise<TradingTransactionParams>;
+
+type WithPartialTraderParams<T> = T & Partial<TraderParameters>;
+declare let utmContent: string | undefined;
+declare let disableUtm: boolean;
+interface TradingSdkOptions {
+    enableLogging: boolean;
+    orderBookApi: OrderBookApi;
+    utmContent?: string;
+    disableUtm?: boolean;
+}
+declare class TradingSdk {
+    traderParams: Partial<TraderParameters>;
+    readonly options: Partial<TradingSdkOptions>;
+    constructor(traderParams?: Partial<TraderParameters>, options?: Partial<TradingSdkOptions>, adapter?: AbstractProviderAdapter);
+    setTraderParams(params: Partial<TraderParameters>): this;
+    getQuote(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<QuoteAndPost>;
+    getQuoteResults(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<QuoteResultsWithSigner>;
+    postSwapOrder(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<OrderPostingResult>;
+    postLimitOrder(params: WithPartialTraderParams<LimitTradeParameters>, advancedSettings?: LimitOrderAdvancedSettings): Promise<OrderPostingResult>;
+    /**
+     * Posts a sell order for native currency (e.g., ETH) using the EthFlow contract.
+     * This method creates an on-chain transaction for selling native tokens.
+     *
+     * @param params - The trade parameters including token addresses and amounts
+     * @param advancedSettings - Optional advanced settings for the swap
+     * @returns Promise resolving to the order posting result with transaction hash and order ID
+     *
+     * @example
+     * ```typescript
+     * const parameters: TradeParameters = {
+     *   kind: OrderKind.SELL,
+     *   sellToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', // Native ETH
+     *   sellTokenDecimals: 18,
+     *   buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59',
+     *   buyTokenDecimals: 18,
+     *   amount: '100000000000000000', // 0.1 ETH
+     * }
+     *
+     * const { orderId, txHash } = await sdk.postSellNativeCurrencyOrder(parameters)
+     * ```
+     */
+    postSellNativeCurrencyOrder(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<ReturnType<typeof postSellNativeCurrencyOrder>>;
+    getPreSignTransaction(params: WithPartialTraderParams<{
+        orderId: string;
+        account: string;
+    }>): ReturnType<typeof getPreSignTransaction>;
+    private mergeParams;
+}
+
+declare function getEthFlowTransaction(appDataKeccak256: string, _params: LimitTradeParametersFromQuote, chainId: SupportedChainId, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<{
+    orderId: string;
+    transaction: TradingTransactionParams;
+    orderToSign: UnsignedOrder;
+}>;
+declare function getEthFlowContract(signer: Signer, env?: CowEnv): EthFlowContract;
+
+interface OrderToSignParams {
+    from: string;
+    networkCostsAmount?: string;
+}
+declare function getOrderToSign({ from, networkCostsAmount }: OrderToSignParams, limitOrderParams: LimitTradeParameters, appDataKeccak256: string): UnsignedOrder;
+
+declare function postCoWProtocolTrade(orderBookApi: OrderBookApi, paramAppData: TradingAppDataInfo, params: LimitTradeParameters, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<OrderPostingResult>;
+
+declare function postLimitOrder(params: LimitOrderParameters, advancedSettings?: LimitOrderAdvancedSettings, _orderBookApi?: OrderBookApi): Promise<OrderPostingResult>;
+
+declare function postSwapOrder(params: SwapParameters, advancedSettings?: SwapAdvancedSettings, orderBookApi?: OrderBookApi): Promise<OrderPostingResult>;
+declare function postSwapOrderFromQuote({ orderBookApi, result: { signer, appDataInfo: _appDataInfo, quoteResponse, tradeParameters }, }: QuoteResultsWithSigner, advancedSettings?: SwapAdvancedSettings): Promise<OrderPostingResult>;
+
+interface SuggestSlippageBps {
+    tradeParameters: TradeParameters;
+    quote: OrderQuoteResponse;
+    trader: QuoterParameters;
+    advancedSettings?: SwapAdvancedSettings;
+}
+/**
+ * Return the slippage in BPS that would allow the fee to increase by the multiplying factor percent.
+ */
+declare function suggestSlippageBps(params: SuggestSlippageBps): number;
+
+declare function buildAppData({ slippageBps, appCode, orderClass: orderClassName, partnerFee }: BuildAppDataParams, advancedParams?: AppDataParams): Promise<TradingAppDataInfo>;
+declare function generateAppDataFromDoc(doc: AppDataRootSchema): Promise<Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>>;
+declare function mergeAppDataDoc(_doc: LatestAppDataDocVersion, appDataOverride: AppDataParams): Promise<TradingAppDataInfo>;
+
+declare function calculateUniqueOrderId(chainId: SupportedChainId, order: UnsignedOrder, checkEthFlowOrderExists?: EthFlowOrderExistsCallback, env?: CowEnv): Promise<string>;
+
+declare function getPartnerFeeBps(partnerFee: latest.PartnerFee | undefined): number | undefined;
+
+declare function swapParamsToLimitOrderParams(params: TradeParameters, quoteResponse: OrderQuoteResponse): LimitTradeParametersFromQuote;
+declare function mapQuoteAmountsAndCosts<T, R>(value: QuoteAmountsAndCosts<T>, mapper: (value: T) => R): QuoteAmountsAndCosts<R>;
+/**
+ * Set sell token to the initial one
+ * Because for ETH-flow orders we do quote requests with wrapped token
+ */
+declare function getTradeParametersAfterQuote({ quoteParameters, sellToken, }: {
+    quoteParameters: TradeParameters;
+    sellToken: string;
+}): TradeParameters;
+
+export { type AppDataRootSchema, type BuildAppDataParams, type EthFlowOrderExistsCallback, type LimitOrderAdvancedSettings, type LimitOrderParameters, type LimitTradeParameters, type LimitTradeParametersFromQuote, ORDER_PRIMARY_TYPE, type OrderPostingResult, type OrderTypedData, type PostTradeAdditionalParams, type QuoteAndPost, type QuoteResults, type QuoteResultsSerialized, type QuoteResultsWithSigner, type QuoterParameters, type SwapAdvancedSettings, type SwapParameters, type TradeBaseParameters, type TradeOptionalParameters, type TradeParameters, type TraderParameters, type TradingAppDataInfo, TradingSdk, type TradingSdkOptions, type TradingTransactionParams, type WithPartialTraderParams, buildAppData, calculateUniqueOrderId, disableUtm, generateAppDataFromDoc, getEthFlowContract, getEthFlowTransaction, getOrderToSign, getPartnerFeeBps, getPreSignTransaction, getQuote, getQuoteWithSigner, getTradeParametersAfterQuote, mapQuoteAmountsAndCosts, mergeAppDataDoc, postCoWProtocolTrade, postLimitOrder, postSellNativeCurrencyOrder, postSwapOrder, postSwapOrderFromQuote, suggestSlippageBps, swapParamsToLimitOrderParams, utmContent };

package/dist/index.d.ts

@@ -0,0 +1,326 @@
+import { latest, AppDataParams, LatestAppDataDocVersion } from '@cowprotocol/sdk-app-data';
+import { OrderKind, OrderParameters, TokenAmount, SigningScheme, OrderQuoteRequest, QuoteAmountsAndCosts, OrderQuoteResponse, AppData, AppDataHash, Signature, OrderBookApi } from '@cowprotocol/sdk-order-book';
+import { AccountAddress, SignerLike, AbstractSigner, Signer, AbstractProviderAdapter, EthFlowContract } from '@cowprotocol/sdk-common';
+import { UnsignedOrder } from '@cowprotocol/sdk-order-signing';
+import { CowEnv, SupportedChainId } from '@cowprotocol/sdk-config';
+
+declare const ORDER_PRIMARY_TYPE: "Order";
+/**
+ * EIP-712 typed data domain.
+ */
+interface TypedDataDomain {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: string;
+}
+/**
+ * EIP-712 typed data field.
+ */
+interface TypedDataField {
+    name: string;
+    type: string;
+}
+/**
+ * EIP-712 typed data for an order.
+ */
+interface OrderTypedData {
+    domain: TypedDataDomain;
+    primaryType: typeof ORDER_PRIMARY_TYPE;
+    types: Record<string, TypedDataField[]>;
+    message: UnsignedOrder;
+}
+/**
+ * Minimal set of parameters to create a trade.
+ */
+interface TradeBaseParameters {
+    kind: OrderKind;
+    owner?: AccountAddress;
+    sellToken: OrderParameters['sellToken'];
+    sellTokenDecimals: number;
+    buyToken: OrderParameters['buyToken'];
+    buyTokenDecimals: number;
+    amount: TokenAmount;
+}
+/**
+ * Optional parameters to create a trade.
+ */
+interface TradeOptionalParameters {
+    env?: CowEnv;
+    partiallyFillable?: OrderParameters['partiallyFillable'];
+    /**
+     * Slippage in basis points.
+     * If not provided, it will use AUTO slippage, which would suggest a slippage based on the quote.
+     */
+    slippageBps?: latest.SlippageBips;
+    receiver?: OrderParameters['receiver'];
+    validFor?: OrderParameters['validTo'];
+    partnerFee?: latest.PartnerFee;
+}
+/**
+ * Information about the trader.
+ */
+interface TraderParameters {
+    chainId: SupportedChainId;
+    appCode: latest.AppCode;
+    signer?: SignerLike;
+    env?: CowEnv;
+}
+type QuoterParameters = Omit<TraderParameters, 'signer'> & {
+    account: AccountAddress;
+};
+/**
+ * Trade type, assets, amounts, and optional parameters.
+ */
+interface TradeParameters extends TradeBaseParameters, TradeOptionalParameters {
+}
+interface SwapParameters extends TradeParameters, TraderParameters {
+}
+interface LimitTradeParameters extends Omit<TradeParameters, 'amount'> {
+    sellAmount: OrderParameters['sellAmount'];
+    buyAmount: OrderParameters['buyAmount'];
+    /**
+     * Id of the quote to be used for the limit order.
+     */
+    quoteId?: number;
+    validTo?: OrderParameters['validTo'];
+}
+interface LimitTradeParametersFromQuote extends LimitTradeParameters {
+    quoteId: number;
+}
+interface LimitOrderParameters extends TraderParameters, LimitTradeParameters {
+}
+interface SwapAdvancedSettings {
+    quoteRequest?: Partial<Omit<OrderQuoteRequest, 'kind'> & {
+        validTo: number;
+    }>;
+    appData?: AppDataParams;
+    additionalParams?: PostTradeAdditionalParams;
+    quoteSigner?: SignerLike;
+}
+interface LimitOrderAdvancedSettings {
+    appData?: AppDataParams;
+    additionalParams?: PostTradeAdditionalParams;
+}
+/**
+ * Quote information for the CoW Protocol order, including information about the trade, quote, order, "app-data", and more.
+ *
+ * This data is used to create a trade, sign an order, and post it to the order book.
+ */
+interface QuoteResults {
+    /**
+     * Information about the trade, including the kind of order, the owner, the sell and buy tokens, and the amount.
+     */
+    tradeParameters: TradeParameters;
+    /**
+     * The suggested slippage based on the quote.
+     *
+     */
+    suggestedSlippageBps: number;
+    /**
+     * Details about costs and amounts, costs and fees of a quote.
+     */
+    amountsAndCosts: QuoteAmountsAndCosts;
+    /**
+     * Information about the order to be signed.
+     *
+     * For signining, please use orderTypedData (EIP-712 typed data, which also includes the unsigned order)
+     */
+    orderToSign: UnsignedOrder;
+    /**
+     * Information about the quote response from the order book API.
+     */
+    quoteResponse: OrderQuoteResponse;
+    /**
+     * Information about the app-data, including the JSON document and the keccak256 hash of the full document.
+     */
+    appDataInfo: TradingAppDataInfo;
+    /**
+     * EIP-712 typed data for the order ready to be signed.
+     */
+    orderTypedData: OrderTypedData;
+}
+interface QuoteResultsSerialized extends Omit<QuoteResults, 'amountsAndCosts'> {
+    amountsAndCosts: QuoteAmountsAndCosts<string>;
+}
+interface OrderPostingResult {
+    orderId: string;
+    txHash?: string;
+    signingScheme: SigningScheme;
+    signature: Signature;
+    orderToSign: UnsignedOrder;
+}
+interface QuoteAndPost {
+    quoteResults: QuoteResults;
+    postSwapOrderFromQuote(advancedSettings?: SwapAdvancedSettings): Promise<OrderPostingResult>;
+}
+type AppDataRootSchema = latest.AppDataRootSchema;
+interface BuildAppDataParams {
+    appCode: latest.AppCode;
+    slippageBps: latest.SlippageBips;
+    orderClass: latest.OrderClass['orderClass'];
+    partnerFee?: latest.PartnerFee;
+}
+/**
+ * Information about the app-data for trading operations, including the JSON document and the keccak256 hash of the full document.
+ *
+ * See https://github.com/cowprotocol/app-data
+ */
+interface TradingAppDataInfo {
+    doc: LatestAppDataDocVersion;
+    fullAppData: AppData;
+    appDataKeccak256: AppDataHash;
+}
+/**
+ * A standard Ethereum transaction object
+ */
+interface TradingTransactionParams {
+    data: string;
+    gasLimit: string;
+    to: string;
+    value: string;
+}
+interface EthFlowOrderExistsCallback {
+    (orderId: string, orderDigest: string): Promise<boolean>;
+}
+/**
+ * Additional parameters for posting orders.
+ * In most of the cases you don't need to use them.
+ */
+interface PostTradeAdditionalParams {
+    /**
+     * Selling native token orders are special, because they are created from smart-contract,
+     * and their validTo is always the same.
+     * Because of that, you might get the same orderId when trying to create an order with the same parameters
+     * The callback is needed to check if there is already an order with the same orderId
+     *
+     * @see https://github.com/cowprotocol/ethflowcontract/blob/main/src/libraries/EthFlowOrder.sol#L90
+     */
+    checkEthFlowOrderExists?: EthFlowOrderExistsCallback;
+    /**
+     * Cost of executing the order onchain.
+     * The value is used in getQuoteAmountsAndCosts in order to calculate proper amounts
+     */
+    networkCostsAmount?: string;
+    /**
+     * By default, is EIP712 for EOA wallets.
+     * You might need other types of signing, for example PRESIGN when sign order via Smart Contract wallets.
+     */
+    signingScheme?: SigningScheme;
+}
+
+type QuoteResultsWithSigner = {
+    result: QuoteResults & {
+        signer: AbstractSigner;
+    };
+    orderBookApi: OrderBookApi;
+};
+declare function getQuote(_tradeParameters: TradeParameters, trader: QuoterParameters, advancedSettings?: SwapAdvancedSettings, _orderBookApi?: OrderBookApi): Promise<{
+    result: QuoteResults;
+    orderBookApi: OrderBookApi;
+}>;
+declare function getQuoteWithSigner(swapParameters: SwapParameters, advancedSettings?: SwapAdvancedSettings, orderBookApi?: OrderBookApi): Promise<QuoteResultsWithSigner>;
+
+declare function postSellNativeCurrencyOrder(orderBookApi: OrderBookApi, appData: Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>, _params: LimitTradeParametersFromQuote, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<OrderPostingResult>;
+
+declare function getPreSignTransaction(signer: Signer, chainId: SupportedChainId, account: string, orderId: string): Promise<TradingTransactionParams>;
+
+type WithPartialTraderParams<T> = T & Partial<TraderParameters>;
+declare let utmContent: string | undefined;
+declare let disableUtm: boolean;
+interface TradingSdkOptions {
+    enableLogging: boolean;
+    orderBookApi: OrderBookApi;
+    utmContent?: string;
+    disableUtm?: boolean;
+}
+declare class TradingSdk {
+    traderParams: Partial<TraderParameters>;
+    readonly options: Partial<TradingSdkOptions>;
+    constructor(traderParams?: Partial<TraderParameters>, options?: Partial<TradingSdkOptions>, adapter?: AbstractProviderAdapter);
+    setTraderParams(params: Partial<TraderParameters>): this;
+    getQuote(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<QuoteAndPost>;
+    getQuoteResults(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<QuoteResultsWithSigner>;
+    postSwapOrder(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<OrderPostingResult>;
+    postLimitOrder(params: WithPartialTraderParams<LimitTradeParameters>, advancedSettings?: LimitOrderAdvancedSettings): Promise<OrderPostingResult>;
+    /**
+     * Posts a sell order for native currency (e.g., ETH) using the EthFlow contract.
+     * This method creates an on-chain transaction for selling native tokens.
+     *
+     * @param params - The trade parameters including token addresses and amounts
+     * @param advancedSettings - Optional advanced settings for the swap
+     * @returns Promise resolving to the order posting result with transaction hash and order ID
+     *
+     * @example
+     * ```typescript
+     * const parameters: TradeParameters = {
+     *   kind: OrderKind.SELL,
+     *   sellToken: '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', // Native ETH
+     *   sellTokenDecimals: 18,
+     *   buyToken: '0x0625afb445c3b6b7b929342a04a22599fd5dbb59',
+     *   buyTokenDecimals: 18,
+     *   amount: '100000000000000000', // 0.1 ETH
+     * }
+     *
+     * const { orderId, txHash } = await sdk.postSellNativeCurrencyOrder(parameters)
+     * ```
+     */
+    postSellNativeCurrencyOrder(params: WithPartialTraderParams<TradeParameters>, advancedSettings?: SwapAdvancedSettings): Promise<ReturnType<typeof postSellNativeCurrencyOrder>>;
+    getPreSignTransaction(params: WithPartialTraderParams<{
+        orderId: string;
+        account: string;
+    }>): ReturnType<typeof getPreSignTransaction>;
+    private mergeParams;
+}
+
+declare function getEthFlowTransaction(appDataKeccak256: string, _params: LimitTradeParametersFromQuote, chainId: SupportedChainId, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<{
+    orderId: string;
+    transaction: TradingTransactionParams;
+    orderToSign: UnsignedOrder;
+}>;
+declare function getEthFlowContract(signer: Signer, env?: CowEnv): EthFlowContract;
+
+interface OrderToSignParams {
+    from: string;
+    networkCostsAmount?: string;
+}
+declare function getOrderToSign({ from, networkCostsAmount }: OrderToSignParams, limitOrderParams: LimitTradeParameters, appDataKeccak256: string): UnsignedOrder;
+
+declare function postCoWProtocolTrade(orderBookApi: OrderBookApi, paramAppData: TradingAppDataInfo, params: LimitTradeParameters, additionalParams?: PostTradeAdditionalParams, paramSigner?: SignerLike): Promise<OrderPostingResult>;
+
+declare function postLimitOrder(params: LimitOrderParameters, advancedSettings?: LimitOrderAdvancedSettings, _orderBookApi?: OrderBookApi): Promise<OrderPostingResult>;
+
+declare function postSwapOrder(params: SwapParameters, advancedSettings?: SwapAdvancedSettings, orderBookApi?: OrderBookApi): Promise<OrderPostingResult>;
+declare function postSwapOrderFromQuote({ orderBookApi, result: { signer, appDataInfo: _appDataInfo, quoteResponse, tradeParameters }, }: QuoteResultsWithSigner, advancedSettings?: SwapAdvancedSettings): Promise<OrderPostingResult>;
+
+interface SuggestSlippageBps {
+    tradeParameters: TradeParameters;
+    quote: OrderQuoteResponse;
+    trader: QuoterParameters;
+    advancedSettings?: SwapAdvancedSettings;
+}
+/**
+ * Return the slippage in BPS that would allow the fee to increase by the multiplying factor percent.
+ */
+declare function suggestSlippageBps(params: SuggestSlippageBps): number;
+
+declare function buildAppData({ slippageBps, appCode, orderClass: orderClassName, partnerFee }: BuildAppDataParams, advancedParams?: AppDataParams): Promise<TradingAppDataInfo>;
+declare function generateAppDataFromDoc(doc: AppDataRootSchema): Promise<Pick<TradingAppDataInfo, 'fullAppData' | 'appDataKeccak256'>>;
+declare function mergeAppDataDoc(_doc: LatestAppDataDocVersion, appDataOverride: AppDataParams): Promise<TradingAppDataInfo>;
+
+declare function calculateUniqueOrderId(chainId: SupportedChainId, order: UnsignedOrder, checkEthFlowOrderExists?: EthFlowOrderExistsCallback, env?: CowEnv): Promise<string>;
+
+declare function getPartnerFeeBps(partnerFee: latest.PartnerFee | undefined): number | undefined;
+
+declare function swapParamsToLimitOrderParams(params: TradeParameters, quoteResponse: OrderQuoteResponse): LimitTradeParametersFromQuote;
+declare function mapQuoteAmountsAndCosts<T, R>(value: QuoteAmountsAndCosts<T>, mapper: (value: T) => R): QuoteAmountsAndCosts<R>;
+/**
+ * Set sell token to the initial one
+ * Because for ETH-flow orders we do quote requests with wrapped token
+ */
+declare function getTradeParametersAfterQuote({ quoteParameters, sellToken, }: {
+    quoteParameters: TradeParameters;
+    sellToken: string;
+}): TradeParameters;
+
+export { type AppDataRootSchema, type BuildAppDataParams, type EthFlowOrderExistsCallback, type LimitOrderAdvancedSettings, type LimitOrderParameters, type LimitTradeParameters, type LimitTradeParametersFromQuote, ORDER_PRIMARY_TYPE, type OrderPostingResult, type OrderTypedData, type PostTradeAdditionalParams, type QuoteAndPost, type QuoteResults, type QuoteResultsSerialized, type QuoteResultsWithSigner, type QuoterParameters, type SwapAdvancedSettings, type SwapParameters, type TradeBaseParameters, type TradeOptionalParameters, type TradeParameters, type TraderParameters, type TradingAppDataInfo, TradingSdk, type TradingSdkOptions, type TradingTransactionParams, type WithPartialTraderParams, buildAppData, calculateUniqueOrderId, disableUtm, generateAppDataFromDoc, getEthFlowContract, getEthFlowTransaction, getOrderToSign, getPartnerFeeBps, getPreSignTransaction, getQuote, getQuoteWithSigner, getTradeParametersAfterQuote, mapQuoteAmountsAndCosts, mergeAppDataDoc, postCoWProtocolTrade, postLimitOrder, postSellNativeCurrencyOrder, postSwapOrder, postSwapOrderFromQuote, suggestSlippageBps, swapParamsToLimitOrderParams, utmContent };