@gera2ld/lib-dex 0.0.1

package/dist/node/index.d.ts

@@ -0,0 +1 @@
+export * from './wallets';

package/dist/node/index.js

@@ -0,0 +1,23 @@
+import { createHash as i } from "node:crypto";
+import { toHex as a } from "viem";
+function r(e) {
+  return a(e.slice(0, 8)).slice(2);
+}
+function o(e) {
+  const t = i("sha256").update(e).digest(), n = new Uint8Array(t);
+  return r(n);
+}
+function c(e) {
+  return o(
+    `global:${e.replace(/[A-Z]/g, (t) => "_" + t.toLowerCase())}`
+  );
+}
+const l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  getDiscriminator: o,
+  getDiscriminatorByInstructionName: c,
+  getDiscriminatorBySha256: r
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  l as solana
+};

package/dist/node/wallets/index.d.ts

@@ -0,0 +1 @@
+export * as solana from './solana';

package/dist/node/wallets/solana/index.d.ts

@@ -0,0 +1,3 @@
+export declare function getDiscriminatorBySha256(bytes: Uint8Array): string;
+export declare function getDiscriminator(input: string): string;
+export declare function getDiscriminatorByInstructionName(name: string): string;

package/dist/prices/coingecko.d.ts

@@ -0,0 +1,5 @@
+import { type ISupportedChains } from '../common';
+/**
+ * Use Jupiter/Pyth when possible, and use Lifi as a fallback.
+ */
+export declare const getTokenPriceFromCoinGecko: import("@gera2ld/async-memo").CachedFunction<[chain: ISupportedChains, address: string | string[]], Record<string, number>, Map<string, import("@gera2ld/async-memo").CacheData<unknown>>>;

package/dist/prices/coingecko.integration.d.ts

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

package/dist/prices/index.d.ts

@@ -0,0 +1,7 @@
+import type { ISupportedChains } from '@/common';
+import { getTokenPriceFromCoinGecko } from './coingecko';
+import { getTokenPriceFromLifi } from './lifi';
+export { getTokenPriceFromCoinGecko, getTokenPriceFromLifi };
+type PriceProvider = (chain: ISupportedChains, address: string[]) => Promise<Record<string, number>>;
+export declare function getTokenPrice(chain: ISupportedChains, address: string | string[]): Promise<Record<string, number>>;
+export declare function setTokenPriceProvider(newProvider: PriceProvider): void;

package/dist/prices/lifi.d.ts

@@ -0,0 +1,4 @@
+import type { ISupportedChains } from '@/common';
+export declare function getTokenPriceFromLifi(chain: ISupportedChains, address: string[]): Promise<{
+    [k: string]: number;
+}>;

package/dist/quotes/1inch/index.d.ts

@@ -0,0 +1,60 @@
+import { type ISupportedChains } from '@/common';
+import { type IWallet } from '@/wallets';
+import { type LimitOrderV4Struct } from '@1inch/fusion-sdk';
+import { Logger } from '@gera2ld/common';
+import { BaseProvider } from '../base';
+import type { ICheckQuoteResult } from '../types';
+export declare class OneInchProvider extends BaseProvider {
+    static readonly providerName = "1inch";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    static apiKey: string;
+    static setApiKey(key: string): void;
+    logger: Logger;
+    private _sdk;
+    private get sdk();
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<ICheckQuoteResult>;
+    _1inchPrepareData(data: {
+        quoteData: ICheckQuoteResult;
+    }): {
+        quoteId: string;
+        orderStruct: LimitOrderV4Struct;
+        extension: string;
+        dataToSign: Record<string, unknown>;
+    };
+    _1inchSendTransaction(payload: {
+        quoteId: string;
+        orderStruct: LimitOrderV4Struct;
+        extension: string;
+        signature: string;
+    }): Promise<{
+        hash: string;
+    }>;
+    sendTransaction(data: {
+        quoteData: ICheckQuoteResult;
+    }, options: {
+        wallet: IWallet;
+        maxGasAmountInflated?: number | bigint;
+    }): Promise<{
+        hash: string;
+    }>;
+    confirmTransaction(pending: {
+        provider: string;
+        response: {
+            hash: string;
+        };
+    }): Promise<{
+        hash: string;
+        chain: ISupportedChains;
+        chainId: number;
+        gasFee: number;
+        priorityFee: number;
+    }>;
+}

package/dist/quotes/1inch/index.integration.d.ts

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

package/dist/quotes/base.d.ts

@@ -0,0 +1,43 @@
+import type { ISupportedChains } from '@/common';
+import type { IPublicWallet, IWallet } from '../wallets';
+import type { ICheckQuoteResult } from './types';
+export declare abstract class BaseProvider {
+    chain: ISupportedChains;
+    static readonly providerName: string;
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    constructor(chain: ISupportedChains);
+    abstract checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<ICheckQuoteResult>;
+    /**
+     * The returned request must be JSON serializable.
+     */
+    buildRequest(_data: {
+        quoteData: ICheckQuoteResult;
+    }): Promise<{
+        request: unknown;
+    }>;
+    sendTransaction(data: {
+        quoteData: ICheckQuoteResult;
+    }, { wallet, maxGasAmountInflated, }: {
+        wallet: IWallet;
+        maxGasAmountInflated?: number | bigint;
+    }): Promise<unknown>;
+    confirmTransaction(pending: {
+        provider: string;
+        response: unknown;
+        /** Wallet may not be needed for some providers, e.g. 1inch */
+        wallet?: IPublicWallet;
+    }): Promise<{
+        hash: string;
+        chain: string;
+        chainId: number;
+        gasFee?: number;
+        priorityFee?: number;
+    }>;
+}

package/dist/quotes/deprecated-0x/index.d.ts

@@ -0,0 +1,46 @@
+import { type ISupportedChains } from '@/common';
+import { Logger } from '@gera2ld/common';
+import { BaseProvider } from '../base.ts';
+import type { ICheckQuoteResult, IQuoteInfo } from '../types.ts';
+import type { IQuote } from './types.ts';
+/**
+ * Price is not as good as others, and keeps sending spam emails.
+ */
+export declare class ZeroExProvider extends BaseProvider {
+    static readonly providerName = "0x";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    static apiKey: string;
+    static setApiKey(key: string): void;
+    logger: Logger;
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<{
+        provider: string;
+        quoteState: {
+            quote: IQuote;
+            createdAt: number;
+            expiresAt: number;
+        };
+        quoteInfo: IQuoteInfo;
+    }>;
+    buildRequest(data: {
+        quoteData: ICheckQuoteResult;
+    }): Promise<{
+        request: {
+            to: string;
+            data: string;
+            gas: string;
+            gasPrice: string;
+            value: string;
+        };
+        permit2: {
+            eip712?: unknown;
+        };
+    }>;
+}

package/dist/quotes/deprecated-0x/types.d.ts

@@ -0,0 +1,56 @@
+export interface IQuote {
+    blockNumber: string;
+    buyAmount: string;
+    buyToken: string;
+    gas: string;
+    gasPrice: string;
+    issues: {
+        allowance: {
+            actual: string;
+            spender: string;
+        };
+        balance: {
+            token: string;
+            actual: string;
+            expected: string;
+        };
+        simulationIncomplete: boolean;
+    };
+    liquidityAvailable: boolean;
+    minBuyAmount: string;
+    sellAmount: string;
+    sellToken: string;
+    totalNetworkFee: string;
+}
+export interface IFirmQuote {
+    blockNumber: string;
+    buyAmount: string;
+    buyToken: string;
+    issues: {
+        allowance: {
+            actual: string;
+            spender: string;
+        };
+        balance: {
+            token: string;
+            actual: string;
+            expected: string;
+        };
+        simulationIncomplete: boolean;
+    };
+    liquidityAvailable: boolean;
+    minBuyAmount: string;
+    permit2: {
+        eip712?: unknown;
+    };
+    sellAmount: string;
+    sellToken: string;
+    totalNetworkFee: string;
+    transaction: {
+        to: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        value: string;
+    };
+}

package/dist/quotes/index.d.ts

@@ -0,0 +1,22 @@
+import type { ISupportedChains } from '@/common';
+import { OneInchProvider } from './1inch/index.ts';
+import { BaseProvider } from './base.ts';
+import { JupiterMetisProvider, JupiterUltraProvider } from './jupiter/index.ts';
+import { KyberSwapProvider } from './kyberswap/index.ts';
+import { LiFiProvider } from './lifi/index.ts';
+import { OdosProvider } from './odos/index.ts';
+import { ParaSwapProvider } from './paraswap/index.ts';
+import type { IQuoteInfo } from './types';
+export * from './base';
+export * from './types';
+export { JupiterMetisProvider, JupiterUltraProvider, KyberSwapProvider, LiFiProvider, OdosProvider, OneInchProvider, ParaSwapProvider, };
+export declare const AllProviders: (typeof OneInchProvider | typeof JupiterMetisProvider | typeof JupiterUltraProvider | typeof KyberSwapProvider | typeof LiFiProvider | typeof OdosProvider | typeof ParaSwapProvider)[];
+export declare function setEnabledProviders(names?: string[]): string[];
+export declare function getProvider(chain: ISupportedChains, name: string): BaseProvider;
+export declare function getProviders(chain: ISupportedChains, allowedProviders?: string[]): BaseProvider[];
+export declare function getApprovalParams(quoteInfo: IQuoteInfo): {
+    address: string;
+    tokenAddress: string;
+    approvalAddress: string;
+    amount: bigint;
+} | undefined;

package/dist/quotes/jupiter/index.d.ts

@@ -0,0 +1,2 @@
+export * from './metis';
+export * from './ultra';

package/dist/quotes/jupiter/metis.d.ts

@@ -0,0 +1,35 @@
+import type { ISupportedChains } from '@/common';
+import { Logger } from '@gera2ld/common';
+import { BaseProvider } from '../base.ts';
+import type { ICheckQuoteResult, IQuoteInfo } from '../types.ts';
+import type { IQuote } from './metis.types.ts';
+export declare class JupiterMetisProvider extends BaseProvider {
+    static readonly providerName = "jupiter-metis";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    static apiKey: string;
+    static setApiKey(key: string): void;
+    logger: Logger;
+    private getHeaders;
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<{
+        provider: string;
+        quoteState: {
+            quote: IQuote;
+            createdAt: number;
+            expiresAt: number;
+        };
+        quoteInfo: IQuoteInfo;
+    }>;
+    buildRequest(data: {
+        quoteData: ICheckQuoteResult;
+    }): Promise<{
+        request: string;
+    }>;
+}

package/dist/quotes/jupiter/metis.integration.d.ts

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

package/dist/quotes/jupiter/metis.types.d.ts

@@ -0,0 +1,35 @@
+export interface IQuote {
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    slippageBps: number;
+    swapMode: string;
+    priceImpactPct: string;
+    swapUsdValue: string;
+}
+export interface IRequest {
+    swapTransaction: string;
+    lastValidBlockHeight: number;
+    prioritizationFeeLamports: number;
+    computeUnitLimit: number;
+    prioritizationType: {
+        computeBudget: {
+            microLamports: number;
+            estimatedMicroLamports: number;
+        };
+    };
+    dynamicSlippageReport: {
+        slippageBps: number;
+        otherAmount: number;
+        simulatedIncurredSlippageBps: number;
+        amplificationRatio: string;
+        categoryName: string;
+        heuristicMaxSlippageBps: number;
+    };
+    simulationError?: {
+        errorCode: string;
+        error: string;
+    };
+}

package/dist/quotes/jupiter/ultra.d.ts

@@ -0,0 +1,44 @@
+import { type ISupportedChains } from '@/common';
+import { Logger } from '@gera2ld/common';
+import type { IWallet } from '../../wallets/types.ts';
+import { BaseProvider } from '../base.ts';
+import type { ICheckQuoteResult, IQuoteInfo } from '../types.ts';
+import type { IQuote } from './ultra.types.ts';
+export declare class JupiterUltraProvider extends BaseProvider {
+    static readonly providerName = "jupiter-ultra";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    static apiKey: string;
+    static setApiKey(key: string): void;
+    logger: Logger;
+    private getHeaders;
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+    }): Promise<{
+        provider: string;
+        quoteState: {
+            quote: IQuote;
+            createdAt: number;
+            expiresAt: number;
+        };
+        quoteInfo: IQuoteInfo;
+    }>;
+    _ultraSendTransaction(payload: {
+        requestId: string;
+        signedTransaction: string;
+    }): Promise<{
+        hash: string;
+    }>;
+    sendTransaction(data: {
+        quoteData: ICheckQuoteResult;
+    }, options: {
+        wallet: IWallet;
+        maxGasAmountInflated?: number | bigint;
+    }): Promise<{
+        hash: string;
+    }>;
+}

package/dist/quotes/jupiter/ultra.integration.d.ts

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

package/dist/quotes/jupiter/ultra.types.d.ts

@@ -0,0 +1,20 @@
+export interface IQuote {
+    mode: string;
+    inputMint: string;
+    outputMint: string;
+    inAmount: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    slippageBps: number;
+    swapMode: string;
+    swapUsdValue: number;
+    inUsdValue: number;
+    outUsdValue: number;
+    priceImpact: number;
+    router: string;
+    transaction: string | null;
+    requestId: string;
+    expireAt?: string;
+    errorCode: number;
+    errorMessage: string;
+}

package/dist/quotes/kyberswap/index.d.ts

@@ -0,0 +1,39 @@
+import { type ISupportedChains } from '@/common';
+import { Logger } from '@gera2ld/common';
+import { type Address } from 'viem';
+import { BaseProvider } from '../base.ts';
+import type { ICheckQuoteResult, IQuoteInfo } from '../types.ts';
+import type { IQuote } from './types.ts';
+export declare class KyberSwapProvider extends BaseProvider {
+    static readonly providerName = "kyberswap";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    logger: Logger;
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<{
+        provider: string;
+        quoteState: {
+            quote: IQuote;
+            createdAt: number;
+            expiresAt: number;
+        };
+        quoteInfo: IQuoteInfo;
+    }>;
+    buildRequest(data: {
+        quoteData: ICheckQuoteResult;
+    }): Promise<{
+        request: {
+            data: `0x${string}`;
+            from: Address;
+            to: `0x${string}`;
+            gas: string;
+            gasPrice: string;
+        };
+    }>;
+}

package/dist/quotes/kyberswap/index.integration.d.ts

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

package/dist/quotes/kyberswap/types.d.ts

@@ -0,0 +1,18 @@
+export interface IQuote {
+    code: number;
+    message: string;
+    data: {
+        routeSummary: {
+            tokenIn: string;
+            amountIn: string;
+            amountInUsd: string;
+            tokenOut: string;
+            amountOut: string;
+            amountOutUsd: string;
+            gas: string;
+            gasPrice: string;
+            gasUsd: string;
+        };
+        routerAddress: string;
+    };
+}

package/dist/quotes/lifi/index.d.ts

@@ -0,0 +1,36 @@
+import { type ISupportedChains } from '@/common';
+import { Logger } from '@gera2ld/common';
+import { type TransactionRequest } from 'viem';
+import { BaseProvider } from '../base.ts';
+import type { ICheckQuoteResult, IQuoteInfo } from '../types.ts';
+import type { IQuote } from './types.ts';
+export * from './util';
+export declare class LiFiProvider extends BaseProvider {
+    static readonly providerName = "lifi";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    logger: Logger;
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<{
+        provider: string;
+        quoteState: {
+            quote: IQuote;
+            createdAt: number;
+            expiresAt: number;
+        };
+        quoteInfo: IQuoteInfo;
+    }>;
+    buildRequest(data: {
+        quoteData: ICheckQuoteResult;
+    }): Promise<{
+        request: `0x${string}` | undefined;
+    } | {
+        request: TransactionRequest;
+    }>;
+}

package/dist/quotes/lifi/types.d.ts

@@ -0,0 +1,53 @@
+export interface IQuoteToken {
+    address: string;
+    chainId: number;
+    symbol: string;
+    decimals: number;
+    name: string;
+    coinKey: string;
+    logoURI: string;
+    priceUSD: string;
+}
+export interface IQuoteGasCost {
+    type: 'SUM' | 'APPROVE' | 'SEND';
+    price: string;
+    estimate: string;
+    limit: string;
+    amount: string;
+    amountUSD: string;
+    token: IQuoteToken;
+}
+export interface IQuote {
+    id: string;
+    tool: string;
+    action: {
+        fromToken: IQuoteToken;
+        fromAmount: string;
+        toToken: IQuoteToken;
+        fromChainId: number;
+        toChainId: number;
+        slippage: number;
+        fromAddress: string;
+        toAddress: string;
+    };
+    estimate: {
+        tool: string;
+        approvalAddress: string;
+        toAmountMin: string;
+        toAmount: string;
+        fromAmount: string;
+        gasCosts: IQuoteGasCost[];
+        executionDuration: number;
+        fromAmountUSD: string;
+        toAmountUSD: string;
+    };
+    transactionRequest: {
+        chainId: number;
+        from: string;
+        to: string;
+        data: string;
+        value: string;
+        gasPrice: string;
+        gasLimit: string;
+    };
+}

package/dist/quotes/lifi/util.d.ts

@@ -0,0 +1,6 @@
+export declare function getLiFiTransactionDetail(txHash: string, fromChain: string): Promise<{
+    fromAmount: number;
+    fromGasAmount: number;
+    toAmount: number;
+    toGasAmount: number;
+}>;

package/dist/quotes/odos/index.d.ts

@@ -0,0 +1,32 @@
+import { type ISupportedChains } from '@/common';
+import { Logger } from '@gera2ld/common';
+import { BaseProvider } from '../base';
+import type { ICheckQuoteResult, IQuoteInfo } from '../types';
+import type { IQuote } from './types';
+export declare class OdosProvider extends BaseProvider {
+    static readonly providerName = "odos";
+    static supportedChains: ISupportedChains[];
+    static enabled: boolean;
+    logger: Logger;
+    private getQuote;
+    checkQuote(options: {
+        address: string;
+        fromAmount: number;
+        fromToken: string;
+        toToken: string;
+        slippage?: number;
+    }): Promise<{
+        provider: string;
+        quoteState: {
+            quote: IQuote;
+            createdAt: number;
+            expiresAt: number;
+        };
+        quoteInfo: IQuoteInfo;
+    }>;
+    buildRequest(data: {
+        quoteData: ICheckQuoteResult;
+    }): Promise<{
+        request: unknown;
+    }>;
+}

package/dist/quotes/odos/index.integration.d.ts

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

package/dist/quotes/odos/types.d.ts

@@ -0,0 +1,21 @@
+export interface IQuote {
+    traceId: string;
+    inTokens: string[];
+    outTokens: string[];
+    inAmounts: string[];
+    outAmounts: string[];
+    gasEstimate: number;
+    dataGasEstimate: number;
+    gweiPerGas: number;
+    gasEstimateValue: number;
+    inValues: number[];
+    outValues: number[];
+    netOutValue: number;
+    priceImpact: number;
+    percentDiff: number;
+    permit2Message: null;
+    permit2Hash: null;
+    partnerFeePercent: number;
+    pathId: string;
+    blockNumber: number;
+}