@kaspacom/swap-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KASPACOM
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,246 @@
+# Kaspa Swap SDK
+
+A lightweight, headless swap SDK for Kaspa DeFi powered by Uniswap V2. Build your own UI and use the SDK to handle quotes, approvals, and swaps.
+
+
+## Features
+
+- 🔄 Token swapping with Uniswap V2 protocol
+- 💰 Support for ERC-20 tokens and native Kaspa wrappers
+- 🎛️ Headless controller: bring your own UI
+- 🔌 Simple wallet integration (EIP-1193 providers)
+- ⚡ Real-time quote calculations
+- 🛡️ Slippage protection and deadlines
+
+
+## Installation
+
+```bash
+npm install @kaspacom/swap-sdk
+```
+
+
+
+## Quick Start
+
+### Create the headless controller
+
+```typescript
+import {
+  createKaspaComSwapController,
+  LoaderStatuses,
+  Erc20Token,
+} from 'swap-widget';
+
+const controller = createKaspaComSwapController({
+  networkConfig: 'kasplex-testnet',
+  walletProvider: window.ethereum, // any EIP-1193 provider
+  onChange: async (state, patch) => {
+    console.log('state changed', patch, state);
+    // Render your UI from state.computed, state.tradeInfo, state.loader, etc.
+  },
+});
+```
+
+### Provide inputs and get a quote
+
+```typescript
+const kas: Erc20Token = {
+  address: '0x0000000000000000000000000000000000000000',
+  symbol: 'KAS',
+  name: 'Kaspa',
+  decimals: 18,
+};
+
+const usdt: Erc20Token = {
+  address: '0xD33d07ccfEd8038cEd1aa393FbEf7D7dA72be20e',
+  symbol: 'USDT',
+  name: 'Tether',
+  decimals: 6,
+};
+
+await controller.setData({
+  fromToken: kas,
+  toToken: usdt,
+  amount: 1.0,             // user-entered number
+  isOutputAmount: false,    // false = amount is input; true = amount is desired output (How much the user will receive)
+  settings: { maxSlippage: '0.5', swapDeadline: 20 },
+});
+
+// Quote results are in controller.getState().computed
+const { computed } = controller.getState();
+console.log('computed amounts', computed);
+```
+
+### Connect wallet, approve if needed, and swap
+
+```typescript
+await controller.connectWallet();
+
+// Optional: call approve explicitly
+await controller.approveIfNeeded();
+
+// Perform the swap
+const txHash = await controller.swap();
+console.log('Swap TX hash:', txHash);
+```
+
+### Load tokens from the subgraph (for token pickers)
+
+```typescript
+const tokens = await controller.getTokensFromGraph(100, 'kas');
+console.log(tokens);
+```
+
+
+## API Reference
+
+### createKaspaComSwapController(options)
+Creates and returns a `SwapSdkController` instance. Accepts either a preset string for `networkConfig` or a full `SwapSdkNetworkConfig` object.
+
+- **options.networkConfig**: `'kasplex-testnet'` or `SwapSdkNetworkConfig`
+- **options.walletProvider**: EIP-1193 provider (e.g., `window.ethereum`)
+- **options.partnerKey?**: Optional partner key string
+- **options.onChange?**: `(state, patch) => Promise<void>` callback invoked on any state change
+
+Returns: `SwapSdkController`
+
+
+### class SwapSdkController
+
+- **constructor(options: SwapSdkOptions)**: Normally use the factory `createKaspaComSwapController`.
+- **connectWallet(injectedProvider?: Eip1193Provider): Promise<string>**
+  - Connects the wallet and sets signer on the swap service.
+  - Returns the connected address.
+- **disconnectWallet(): void**
+  - Disconnects the wallet and clears signer.
+- **getState(): SwapControllerOutput**
+  - Returns the current controller state.
+- **setData(input: Partial<SwapControllerInput>): Promise<SwapControllerOutput>**
+  - Merges provided input, triggers a quote calculation if possible, and returns updated state.
+- **calculateQuoteIfNeeded(): Promise<void>**
+  - Re-calculates quote if `fromToken`, `toToken`, and `amount` are valid.
+- **approveIfNeeded(): Promise<string | undefined>**
+  - If allowance is insufficient, submits approval transaction and waits for confirmation.
+  - Returns approval transaction hash when submitted, otherwise `undefined` if already approved.
+- **swap(): Promise<string>**
+  - Executes the swap using last computed trade info and amounts. Returns swap transaction hash.
+- **getPartnerFee(): Promise<number>**
+  - Fetches the current partner fee in percentage (bps/divisor).
+- **getTokensFromGraph(limit?: number, search?: string): Promise<any[]>**
+  - Queries the subgraph for tokens. Use for token lists/search.
+
+
+## Types
+
+All types are exported from `swap-widget`.
+
+- **Erc20Token**
+  - `address: string`
+  - `symbol: string`
+  - `name: string`
+  - `decimals: number`
+
+- **SwapSettings**
+  - `maxSlippage: string` (e.g., `'0.5'` for 0.5%)
+  - `swapDeadline: number` (minutes)
+
+- **SwapSdkOptions**
+  - `networkConfig: SwapSdkNetworkConfig | string`
+  - `walletProvider: any` (EIP-1193)
+  - `partnerKey?: string`
+  - `onChange?: (state: SwapControllerOutput, patch: Partial<SwapControllerOutput>) => Promise<void>`
+
+- **SwapControllerInput** (used with `setData`)
+  - `fromToken?: Erc20Token | null`
+  - `toToken?: Erc20Token | null`
+  - `amount?: number` (user-entered number)
+  - `isOutputAmount?: boolean` (false = `amount` is input; true = `amount` is desired output)
+  - `settings?: Partial<SwapSettings>`
+
+- **LoaderStatuses**
+  - `CALCULATING_QUOTE = 1`
+  - `APPROVING = 2`
+  - `SWAPPING = 3`
+
+- **ComputedAmounts** (found in `SwapControllerOutput.computed`)
+
+  - `amountIn: string`  
+    The input amount as entered by the user, formatted for display.
+
+  - `amountOut: string`  
+    The output amount as calculated for the user, formatted for display.
+
+  - `amountInRaw: string`  
+    The exact input amount (in smallest token units, e.g. wei) that will be sent to the swap contract.
+
+  - `amountOutRaw: string`  
+    The exact output amount (in smallest token units, e.g. wei) that will be received from the swap contract.
+
+  - `maxAmountIn?: string`  
+    (Optional) The maximum input amount the user need to send to receive the desired output amount. Only present if `isOutputAmount` is `true`.
+
+  - `minAmountOut?: string`  
+    (Optional) The minimum output amount the user will receive, accounting for slippage.  Only present if `isOutputAmount` is `false`.
+
+  - `maxAmountInRaw?: string`  
+    (Optional) The raw (smallest units) value of `maxAmountIn`.
+
+  - `minAmountOutRaw?: string`  
+    (Optional) The raw (smallest units) value of `minAmountOut`.
+
+- **SwapControllerOutput**
+  - `error?: string`
+  - `txHash?: string` (Swap tx hash)
+  - `approveTxHash?: string` (Approval transaction tx hash)
+  - `tradeInfo?: Trade<Currency, Currency, TradeType>` (Uniswap V2 trade)
+  - `computed?: ComputedAmounts`
+  - `loader: LoaderStatuses | null`
+
+- **SwapSdkNetworkConfig** (also see presets in `NETWORKS`)
+  - `name: string`
+  - `chainId: number`
+  - `rpcUrl: string`
+  - `routerAddress: string`
+  - `factoryAddress: string`
+  - `proxyAddress?: string`
+  - `wethAddress: string`
+  - `graphEndpoint: string`
+  - `blockExplorerUrl?: string`
+  - `additionalJsonRpcApiProviderOptionsOptions?: any`
+
+- **NETWORKS**
+  - Preset map of network keys to `SwapSdkNetworkConfig` objects. Includes `'kasplex-testnet'`.
+
+
+## Usage Patterns
+
+- **Exact input vs exact output**
+  - Set `isOutputAmount` to `false` to quote "sell X get best Y".
+  - Set `isOutputAmount` to `true` to quote "get exactly X spend up to Y".
+- **React integration**
+  - Call `setData` on input changes; render from `controller.getState()`.
+  - Use `state.loader` to show spinners: `LoaderStatuses.CALCULATING_QUOTE`, `APPROVING`, `SWAPPING`.
+  
+
+## Development
+
+```bash
+git clone https://github.com/kaspacom/swap-widget.git
+cd swap-widget
+npm install
+npm run build
+```
+
+
+## License
+
+MIT License - see `LICENSE`.
+
+
+## Support
+
+- Open an issue on GitHub
+- Join our Telegram: https://t.me/KaspaComOfficial
+
+

package/dist/controllers/swap-sdk.controller.d.ts

@@ -0,0 +1,23 @@
+import { SwapSdkOptions, SwapControllerOutput, SwapControllerInput } from '../types';
+import { Eip1193Provider } from 'ethers';
+export declare class SwapSdkController {
+    private walletService;
+    private swapService;
+    private state;
+    private input;
+    private options;
+    constructor(options: SwapSdkOptions);
+    private initServices;
+    private setChange;
+    connectWallet(injectedProvider?: Eip1193Provider): Promise<string>;
+    disconnectWallet(): void;
+    getState(): SwapControllerOutput;
+    private get settings();
+    calculateQuoteIfNeeded(): Promise<void>;
+    setData(input: Partial<SwapControllerInput>): Promise<SwapControllerOutput>;
+    approveIfNeeded(): Promise<string | undefined>;
+    swap(): Promise<string>;
+    getPartnerFee(): Promise<number>;
+    getTokensFromGraph(limit?: number, search?: string): Promise<import("../types").Erc20Token[]>;
+}
+//# sourceMappingURL=swap-sdk.controller.d.ts.map

package/dist/controllers/swap-sdk.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap-sdk.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/swap-sdk.controller.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EAEd,oBAAoB,EACpB,mBAAmB,EAEpB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAOzC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,WAAW,CAA0B;IAE7C,OAAO,CAAC,KAAK,CAEX;IAIF,OAAO,CAAC,KAAK,CAMX;IAIF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,cAAc;IAMnC,OAAO,CAAC,YAAY;YAaN,SAAS;IAWjB,aAAa,CAAC,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAOxE,gBAAgB,IAAI,IAAI;IAKxB,QAAQ,IAAI,oBAAoB;IAIhC,OAAO,KAAK,QAAQ,GAKnB;IAGK,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BvC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAY3E,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmC9C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IA2DvB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKhC,kBAAkB,CAAC,KAAK,GAAE,MAAY,EAAE,MAAM,CAAC,EAAE,MAAM;CAO9D"}

package/dist/controllers/swap-sdk.controller.js

@@ -0,0 +1,166 @@
+import { WalletService } from '../services/wallet.service';
+import { PARTNER_FEE_BPS_DIVISOR, SwapService } from '../services/swap.service';
+import { LoaderStatuses, } from '../types';
+const DEFAULT_SETTINGS = {
+    maxSlippage: '0.5',
+    swapDeadline: 20,
+};
+export class SwapSdkController {
+    constructor(options) {
+        this.state = {
+            loader: null,
+        };
+        this.input = {
+            fromToken: null,
+            toToken: null,
+            amount: undefined,
+            isOutputAmount: false,
+            settings: DEFAULT_SETTINGS,
+        };
+        this.options = options;
+        this.initServices();
+    }
+    initServices() {
+        this.walletService = new WalletService(this.options.networkConfig, this.options.walletProvider);
+        this.swapService = new SwapService(this.walletService.getProvider(), this.options.networkConfig, this.options);
+    }
+    async setChange(patch) {
+        const next = {
+            ...this.state,
+            ...patch,
+        };
+        this.state = next;
+        if (typeof this.options.onChange === 'function') {
+            await this.options.onChange(next, patch);
+        }
+    }
+    async connectWallet(injectedProvider) {
+        const address = await this.walletService.connect(injectedProvider);
+        const signer = this.walletService.getSigner();
+        if (signer)
+            this.swapService.setSigner(signer);
+        return address;
+    }
+    disconnectWallet() {
+        this.walletService.disconnect();
+        this.swapService.setSigner(null);
+    }
+    getState() {
+        return this.state;
+    }
+    get settings() {
+        return {
+            ...DEFAULT_SETTINGS,
+            ...(this.input.settings || {}),
+        };
+    }
+    async calculateQuoteIfNeeded() {
+        const { fromToken, toToken, amount, isOutputAmount } = this.input;
+        if (!fromToken || !toToken || !amount || amount <= 0) {
+            return;
+        }
+        // Set loader to calculating
+        await this.setChange({ loader: LoaderStatuses.CALCULATING_QUOTE, error: undefined });
+        try {
+            // Use the calculateTrade method which returns both trade and computed amounts
+            const tradeResult = await this.swapService.calculateTrade(fromToken, toToken, String(amount), isOutputAmount == true, // isOutputAmount: true for input amount, false for output amount
+            this.settings.maxSlippage);
+            await this.setChange({
+                computed: tradeResult.computed,
+                tradeInfo: tradeResult.trade,
+                loader: null,
+            });
+        }
+        catch (error) {
+            await this.setChange({ error: error?.message || String(error), loader: null });
+        }
+    }
+    async setData(input) {
+        // Merge input and settings
+        this.input = {
+            ...this.input,
+            ...input,
+        };
+        await this.calculateQuoteIfNeeded();
+        return this.getState();
+    }
+    async approveIfNeeded() {
+        if (!this.input || !this.walletService.isConnected())
+            throw new Error('Wallet not connected or input missing');
+        const { fromToken, amount } = this.input;
+        if (!fromToken || amount === undefined || !this.state.computed?.amountInRaw)
+            throw new Error('fromToken or amount missing');
+        await this.setChange({ loader: LoaderStatuses.APPROVING });
+        try {
+            const tx = await this.swapService?.approveIfNeedApproval(fromToken, BigInt(this.state.computed.amountInRaw));
+            let receipt;
+            if (tx) {
+                await this.setChange({ approveTxHash: tx.hash });
+                receipt = await tx.wait();
+                if (!receipt) {
+                    throw new Error("Receipt not found, Please try again");
+                }
+                if (receipt.status != 1) {
+                    throw new Error("Transaction Rejected");
+                }
+            }
+            return receipt?.hash;
+        }
+        catch (error) {
+            await this.setChange({ error: error?.message || String(error), loader: null });
+            throw error;
+        }
+    }
+    async swap() {
+        try {
+            await this.setChange({
+                txHash: undefined,
+                approveTxHash: undefined,
+            });
+            const { fromToken, toToken, amount } = this.input;
+            if (!fromToken || !toToken || amount === undefined)
+                throw new Error('Tokens or amount not set');
+            await this.approveIfNeeded();
+            await this.setChange({ loader: LoaderStatuses.SWAPPING });
+            // Get the trade path from the tradeInfo
+            const trade = this.state.tradeInfo;
+            if (!trade)
+                throw new Error('Trade info missing - calculate quote first');
+            // Extract path from the trade route
+            const path = trade.route.path.map(token => token.address);
+            if (path.length === 0)
+                throw new Error('Trade path missing');
+            // Use the computed amounts for the swap
+            const computed = this.state.computed;
+            if (!computed)
+                throw new Error('Computed amounts missing');
+            const transaction = await this.swapService.swapTokens(fromToken, toToken, computed.maxAmountInRaw || computed.amountInRaw, computed.minAmountOutRaw || computed.amountOutRaw, path, this.input.isOutputAmount == true, this.settings.swapDeadline);
+            await this.setChange({ txHash: transaction.hash });
+            const receipt = await transaction.wait();
+            if (!receipt) {
+                throw new Error("Receipt not found, Please try again");
+            }
+            if (receipt.status != 1) {
+                throw new Error("Transaction Rejected");
+            }
+            await this.setChange({
+                loader: null,
+            });
+            return receipt.hash;
+        }
+        catch (error) {
+            await this.setChange({ error: error?.message || String(error), loader: null });
+            throw error;
+        }
+    }
+    async getPartnerFee() {
+        return Number(await this.swapService.loadPartnerFee()) / Number(PARTNER_FEE_BPS_DIVISOR);
+    }
+    async getTokensFromGraph(limit = 100, search) {
+        if (!this.swapService) {
+            throw new Error('Swap Service not exists');
+        }
+        return await this.swapService.getTokensFromGraph(limit, search);
+    }
+}
+//# sourceMappingURL=swap-sdk.controller.js.map

package/dist/controllers/swap-sdk.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap-sdk.controller.js","sourceRoot":"","sources":["../../src/controllers/swap-sdk.controller.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types';
+export { WalletService } from './services/wallet.service';
+export { SwapService } from './services/swap.service';
+import { SwapSdkController } from './controllers/swap-sdk.controller';
+export { SwapSdkController } from './controllers/swap-sdk.controller';
+import { SwapSdkOptions } from './types';
+/**
+ * Create a new headless swap controller
+ * @param options Configuration options for the controller
+ * @returns SwapSdkController instance
+ */
+export declare function createKaspaComSwapController(options: SwapSdkOptions): SwapSdkController;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAWvF"}

package/dist/index.js

@@ -0,0 +1,28 @@
+// Export types
+export * from './types';
+// Export services
+export { WalletService } from './services/wallet.service';
+export { SwapService } from './services/swap.service';
+// Export headless controller only
+import { SwapSdkController } from './controllers/swap-sdk.controller';
+export { SwapSdkController } from './controllers/swap-sdk.controller';
+import { NETWORKS } from './types/networks';
+/**
+ * Create a new headless swap controller
+ * @param options Configuration options for the controller
+ * @returns SwapSdkController instance
+ */
+export function createKaspaComSwapController(options) {
+    let resolvedOptions;
+    if ('networkConfig' in options && typeof options.networkConfig === 'string') {
+        const networkConfig = NETWORKS[options.networkConfig];
+        if (!networkConfig)
+            throw new Error(`Unknown network key: ${options.networkConfig}`);
+        resolvedOptions = { ...options, networkConfig };
+    }
+    else {
+        resolvedOptions = options;
+    }
+    return new SwapSdkController(resolvedOptions);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,SAAS,CAAC;AAExB,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,kCAAkC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAItE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAuB;IAClE,IAAI,eAA+B,CAAC;IACpC,IAAI,eAAe,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QAC5E,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACrF,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,eAAe,GAAG,OAAyB,CAAC;IAC9C,CAAC;IAED,OAAO,IAAI,iBAAiB,CAAC,eAAe,CAAC,CAAC;AAChD,CAAC"}

package/dist/services/swap.service.d.ts

@@ -0,0 +1,103 @@
+import { Signer, BrowserProvider, JsonRpcProvider, ContractTransactionResponse, TransactionResponse } from 'ethers';
+import { Currency, Token, TradeType } from '@uniswap/sdk-core';
+import { Trade, Pair } from '@uniswap/v2-sdk';
+import { ComputedAmounts, Erc20Token, SwapSdkOptions } from '../types';
+import { SwapSdkNetworkConfig } from '../types/networks';
+export declare const PARTNER_FEE_BPS_DIVISOR = 10000n;
+export declare class SwapService {
+    private config;
+    private swapOptions;
+    private provider;
+    private signer;
+    private routerContract;
+    private factoryContract;
+    private proxyContract?;
+    private wethAddress;
+    private chainId;
+    private pairs;
+    private pairsLoadedPromise;
+    private resolvePairsLoaded;
+    private partnerFeeLoadedPromise;
+    private resolvePartnerFeeLoaded;
+    private partnerFee;
+    private isFeeActive;
+    private wethToken;
+    constructor(provider: BrowserProvider | JsonRpcProvider, config: SwapSdkNetworkConfig, swapOptions: SwapSdkOptions);
+    loadPartnerFee(): Promise<bigint>;
+    setSigner(signer: Signer): void;
+    /**
+     * Rounds a number string to the specified number of decimal places
+     * to avoid parseUnits errors with too many decimals
+     */
+    private roundToDecimals;
+    /**
+     * Loads all pairs from The Graph and caches them as Uniswap SDK Pair instances.
+     * @param graphEndpoint The GraphQL endpoint URL
+     */
+    loadAllPairsFromGraph(): Promise<void>;
+    waitForPairsLoaded(): Promise<void>;
+    waitForPartnerFeeLoaded(): Promise<void>;
+    createSDKPair(pair: {
+        id: string;
+        token0: {
+            id: string;
+            symbol: string;
+            name: string;
+            decimals: string | number;
+        };
+        token1: {
+            id: string;
+            symbol: string;
+            name: string;
+            decimals: string | number;
+        };
+        reserve0?: string;
+        reserve1?: string;
+        positionValueUsd?: number;
+        totalTokens?: number;
+    }): Pair;
+    /**
+     * Returns the cached pairs for use in routing.
+     */
+    getPairs(): Pair[];
+    /**
+     * Finds the best trade path using Uniswap SDK for a given input amount.
+     * Returns the best path as an array of addresses, or null if no trade found.
+     */
+    private getBestTrade;
+    private trimTrailingZeros;
+    /**
+     *
+     * @param sellToken
+     * @param buyToken
+     * @param targetAmount
+     * @param isOutputAmount true if user input output (How much tokens to receive) and not input (how much tokens to sell)
+     * @param slippage
+     * @returns
+     */
+    calculateTrade(sellToken: Erc20Token, buyToken: Erc20Token, targetAmount: string, isOutputAmount: boolean, slippage: string): Promise<{
+        trade: Trade<Currency, Currency, TradeType.EXACT_INPUT> | Trade<Currency, Currency, TradeType.EXACT_OUTPUT>;
+        computed: ComputedAmounts;
+    }>;
+    checkApproval(tokenAddress: string, amount: string, spenderAddress: string): Promise<boolean>;
+    approveIfNeedApproval(fromToken: Erc20Token, amountInWei: bigint): Promise<ContractTransactionResponse | null>;
+    swapTokens(fromToken: Erc20Token, toToken: Erc20Token, amountInWei: string, amountOutWei: string, path: string[], isOutputAmount: boolean, deadline: number): Promise<TransactionResponse>;
+    getPairAddress(tokenA: string, tokenB: string): Promise<string>;
+    checkLiquidityExists(tokenA: string, tokenB: string): Promise<boolean>;
+    createTrade(fromToken: Erc20Token, toToken: Erc20Token, amountIn: string, slippageTolerance?: number): Promise<Trade<Token, Token, TradeType>>;
+    /**
+     * Fetch tokens from the graph endpoint (subgraph)
+     * @param graphEndpoint The GraphQL endpoint URL
+     * @param search Optional search string for symbol or name
+     */
+    getTokensFromGraph(limit?: number, search?: string): Promise<Erc20Token[]>;
+    /**
+     * Concatenates bytes: selector, array of bytes (each element is Uint8Array), array length (uint8, 1 byte), marker (bytes16(keccak256(markerString)))
+     * @param selectorBytes Uint8Array — function selector (usually 4 bytes)
+     * @param arrayOfBytes Uint8Array[] — array of bytes (each element is Uint8Array)
+     * @param markerString string — string from which bytes16(keccak256(...)) will be derived
+     * @returns Uint8Array — concatenated result
+     */
+    private concatSelectorAndParams;
+}
+//# sourceMappingURL=swap.service.d.ts.map

package/dist/services/swap.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap.service.d.ts","sourceRoot":"","sources":["../../src/services/swap.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,MAAM,EAAE,eAAe,EAAE,eAAe,EAAyD,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnM,OAAO,EAAE,QAAQ,EAA2B,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAS,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,SAAU,CAAC;AAE/C,qBAAa,WAAW;IAuBpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,WAAW;IAvBrB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,aAAa,CAAC,CAAW;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,uBAAuB,CAAgB;IAC/C,OAAO,CAAC,uBAAuB,CAA6B;IAC5D,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,WAAW,CAAkB;IAErC,OAAO,CAAC,SAAS,CAAyB;gBAMxC,QAAQ,EAAE,eAAe,GAAG,eAAe,EACnC,MAAM,EAAE,oBAAoB,EAC5B,WAAW,EAAE,cAAc;IA4D/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAsBvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU/B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAQvB;;;OAGG;IACU,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IA8DtC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrD,aAAa,CAAC,IAAI,EAAE;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE;YACN,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;SAC3B,CAAC;QACF,MAAM,EAAE;YACN,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;SAC3B,CAAC;QACF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI;IA2CR;;OAEG;IACI,QAAQ,IAAI,IAAI,EAAE;IAIzB;;;OAGG;YACW,YAAY;IA0D1B,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;;OAQG;IACG,cAAc,CAClB,SAAS,EAAE,UAAU,EACrB,QAAQ,EAAE,UAAU,EACpB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QACT,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAC5G,QAAQ,EAAE,eAAe,CAAC;KAC3B,CAAC;IAsFI,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAsBb,qBAAqB,CACzB,SAAS,EAAE,UAAU,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC;IAyBxC,UAAU,CACd,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,UAAU,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC;IAgGzB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAS/D,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtE,WAAW,CACf,SAAS,EAAE,UAAU,EACrB,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,GAAE,MAAY,GAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAsD1C;;;;OAIG;IACG,kBAAkB,CAAC,KAAK,GAAE,MAAY,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAsCrF;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;CA4ChC"}