@bitzy-app/bitzy-sdk 0.0.6 → 0.1.0

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+## [0.1.1](https://github.com/bitzy-app/bitzy-sdk/compare/v0.1.0...v0.1.1) (2026-01-15)
+
+
+
+# [0.1.0](https://github.com/bitzy-app/bitzy-sdk/compare/v0.0.8...v0.1.0) (2026-01-15)
+
+
+### Bug Fixes
+
+* build setup ([53a9fed](https://github.com/bitzy-app/bitzy-sdk/commit/53a9fed4774a36c8d5f14d2699873c48d2daae68))
+
+
+
+## [0.0.8](https://github.com/bitzy-app/bitzy-sdk/compare/v0.0.7...v0.0.8) (2026-01-15)
+
+
+### Features
+
+* add automatic publicClient creation and RPC configuration ([4376ec3](https://github.com/bitzy-app/bitzy-sdk/commit/4376ec33161e18133126ea49835bcb4f19200a57))
+
+
+
+## [0.0.7](https://github.com/bitzy-app/bitzy-sdk/compare/v0.0.6...v0.0.7) (2025-09-17)
+
+
+
 ## [0.0.6](https://github.com/bitzy-app/bitzy-sdk/compare/v0.0.5...v0.0.6) (2025-09-08)
 
 

package/README.md

@@ -1,14 +1,23 @@
-# Bitzy Swap V3 - Common Function & Hot Hook
+# Bitzy Aggregator SDK - Multi-DEX Route Aggregation
 
-A comprehensive SDK for fetching swap routes and executing swaps on Bitzy's decentralized exchange. Provides both **common functions** for any environment and **React hooks** for frontend applications.
+A comprehensive SDK for aggregating swap routes across multiple decentralized exchanges and executing optimal swaps. Provides both **common functions** for any environment and **React hooks** for frontend applications with intelligent route aggregation.
 
 ## **What This Package Provides**
 
+- **Multi-DEX Aggregation** - Automatically finds the best routes across multiple decentralized exchanges
 - **Common Functions** - Work in Node.js, browser, or any JavaScript environment
 - **React Hooks** - Hot reloading with automatic updates and error handling
 - **TypeScript Support** - Full type safety throughout
-- **Intelligent Routing** - Automatic optimization based on token characteristics
+- **Intelligent Route Optimization** - Automatic aggregation based on token characteristics and liquidity
 - **Multiple Networks** - Support for Botanix Mainnet and Testnet
+- **Split Routing** - Distributes large swaps across multiple routes for optimal execution
+
+## **Current Support Notice**
+
+**Currently supports Bitzy V2 and Bitzy V3 liquidity sources only.**
+
+This aggregator SDK begins with Bitzy's own DEX implementations. **Integration with additional external DEXs is planned for very soon.**
+
 
 ## **Quick Start**
 
@@ -24,7 +33,7 @@ pnpm add @bitzy-app/bitzy-sdk
 
 ## **1. Using Functions**
 
-### **1.1 `fetchSwapRoute()` - Main Route Finding Function**
+### **1.1 `fetchSwapRoute()` - Main Route Aggregation Function**
 
 ```typescript
 import { fetchSwapRoute } from '@bitzy-app/bitzy-sdk';
@@ -54,7 +63,57 @@ console.log('Amount out:', result.amountOutBN.toFixed());
 console.log('Distributions:', result.distributions);
 ```
 
-### **1.2 `fetchBatchSwapRoutes()` - Multiple Routes at Once**
+**With Custom PublicClient (Optional):**
+
+```typescript
+import { fetchSwapRoute } from '@bitzy-app/bitzy-sdk';
+import { createPublicClient, http, defineChain } from 'viem';
+
+// Create your own PublicClient (e.g., from wagmi, or custom RPC)
+const publicClient = createPublicClient({
+  chain: defineChain({
+    id: 3637,
+    name: 'Botanix Mainnet',
+    network: 'botanix-mainnet',
+    nativeCurrency: {
+      name: 'Bitcoin',
+      symbol: 'BTC',
+      decimals: 18,
+    },
+    rpcUrls: {
+      default: { http: ['https://rpc.botanixlabs.com'] },
+    },
+  }),
+  transport: http(),
+});
+
+// Use your custom PublicClient for better performance and connection reuse
+const result = await fetchSwapRoute(
+  {
+    amountIn: '1.5',
+    srcToken: btcToken,
+    dstToken: usdcToken,
+    chainId: 3637,
+  },
+  {
+    publicClient: publicClient, // Optional: inject your own client
+    headers: {
+      'authen-key': 'your-api-key', // Optional: API key for authentication
+    },
+  }
+);
+```
+
+**Note:** If you don't provide `publicClient`, the SDK will automatically create one using default RPC endpoints:
+- **Botanix Mainnet (3637)**: `https://rpc.botanixlabs.com`
+- **Botanix Testnet (3636)**: `https://node.botanixlabs.dev`
+
+Injecting your own client is useful when:
+- You already have a `PublicClient` instance (e.g., from wagmi's `useAccount()`)
+- You want to reuse connections for better performance
+- You need to use a custom RPC endpoint
+
+### **1.2 `fetchBatchSwapRoutes()` - Batch Route Aggregation**
 
 ```typescript
 import { fetchBatchSwapRoutes } from '@bitzy-app/bitzy-sdk';
@@ -91,7 +150,7 @@ results.forEach((result, index) => {
 });
 ```
 
-### **1.3 `getSwapQuote()` - Simple Price Quote**
+### **1.3 `getSwapQuote()` - Aggregated Price Quote**
 
 ```typescript
 import { getSwapQuote } from '@bitzy-app/bitzy-sdk';
@@ -109,7 +168,7 @@ console.log('Amount out:', quote.amountOut);
 console.log('Route count:', quote.routes);
 ```
 
-### **1.4 `fetchSwapRouteSimple()` - Minimal Configuration**
+### **1.4 `fetchSwapRouteSimple()` - Simple Aggregation**
 
 ```typescript
 import { fetchSwapRouteSimple } from '@bitzy-app/bitzy-sdk';
@@ -128,7 +187,7 @@ console.log('Best route:', result.routes[0]);
 
 ## **2. Using React Hooks**
 
-### **2.1 `useSwapV3Routes()` - Main React Hook**
+### **2.1 `useSwapV3Routes()` - Main Aggregation React Hook**
 
 ```tsx
 import { useSwapV3Routes } from '@bitzy-app/bitzy-sdk';
@@ -139,6 +198,7 @@ function SwapComponent() {
   const [amountIn, setAmountIn] = useState('1.0');
 
   // Basic usage with defaults
+  // Get aggregated routes using SDK
   const {
     routes,
     distributions,
@@ -154,7 +214,7 @@ function SwapComponent() {
     clearError
   } = useSwapV3Routes(srcToken, dstToken, amountIn, 3637);
 
-  // Advanced usage with custom configuration
+  // Advanced usage with custom aggregation configuration
   const swapConfig = {
     apiBaseUrl: 'https://api-public.bitzy.app',
     config: {
@@ -212,11 +272,11 @@ function SwapComponent() {
 
 ## **3. Prepare to Swap Using Response**
 
-Based on the main repository implementation, here's how to use the SDK response to prepare and execute swaps:
+Based on the main repository implementation, here's how to use the aggregator SDK response to prepare and execute optimized swaps:
 
-### **3.1 Complete Swap Implementation**
+### **3.1 Complete Aggregated Swap Implementation**
 
-Here are generic examples showing how to execute swaps using direct contract calls with the SDK response data:
+Here are generic examples showing how to execute aggregated swaps using direct contract calls with the SDK response data:
 
 #### **Example 1: Using Viem with BitzyAggregator Contract**
 
@@ -234,7 +294,7 @@ function SwapComponent() {
   const { address, publicClient } = useAccount();
   const { writeContract } = useWriteContract();
 
-  // Get swap routes using SDK
+  // Get aggregated routes using SDK
   const {
     routes,
     distributions,
@@ -263,7 +323,7 @@ function SwapComponent() {
     useOnlinePartCount: true,
   });
 
-  // Execute swap using direct contract call
+  // Execute aggregated swap using direct contract call
   const handleSwap = useCallback(async () => {
     if (!srcToken || !dstToken || !routes.length || !address) return;
 
@@ -311,7 +371,7 @@ function SwapComponent() {
       return;
     }
 
-    // Regular swap using splitTrade
+    // Regular aggregated swap using splitTrade
     const tradeRoutes = routes.map((route, i) => {
       const amountInPart = amountInParts[i];
       const amountOutMinPart = amountOutRoutes[i].times(1 - slippageBN);
@@ -408,7 +468,7 @@ function SwapWithEthers() {
   const [provider, setProvider] = useState<ethers.BrowserProvider | null>(null);
   const [signer, setSigner] = useState<ethers.JsonRpcSigner | null>(null);
 
-  // Get swap routes using SDK
+  // Get aggregated routes using SDK
   const {
     routes,
     distributions,
@@ -421,7 +481,7 @@ function SwapWithEthers() {
     fetchRoute
   } = useSwapV3Routes(srcToken, dstToken, amountIn, 3637);
 
-  // Execute swap using ethers.js
+  // Execute aggregated swap using ethers.js
   const executeSwap = async () => {
     if (!signer || !routes.length) return;
 
@@ -491,7 +551,7 @@ function SwapWithWeb3() {
   const [web3, setWeb3] = useState<Web3 | null>(null);
   const [account, setAccount] = useState<string | null>(null);
 
-  // Get swap routes using SDK
+  // Get aggregated routes using SDK
   const {
     routes,
     distributions,
@@ -503,7 +563,7 @@ function SwapWithWeb3() {
     fetchRoute
   } = useSwapV3Routes(srcToken, dstToken, amountIn, 3637);
 
-  // Execute swap using web3.js
+  // Execute aggregated swap using web3.js
   const executeSwap = async () => {
     if (!web3 || !account || !routes.length) return;
 
@@ -572,9 +632,9 @@ function SwapWithWeb3() {
 }
 ```
 
-### **3.2 Key Data from SDK Response**
+### **3.2 Key Data from Aggregator SDK Response**
 
-The SDK provides all the necessary data for swap execution:
+The aggregator SDK provides all the necessary data for optimized swap execution:
 
 ```typescript
 interface SwapResult {
@@ -586,16 +646,16 @@ interface SwapResult {
   isWrap?: "wrap" | "unwrap";   // Wrap/unwrap indicator
 }
 
-// Example usage in your swap function:
+// Example usage in your aggregated swap function:
 swap(
   srcToken,
   dstToken,
   amountIn,        // User input
   amountOut,       // Calculated from amountOutBN
-  routes,          // From SDK - route details
-  distributions,   // From SDK - how to split liquidity
-  amountOutRoutes, // From SDK - amounts per route
-  amountInParts,   // From SDK - input amounts per part
+  routes,          // From aggregator SDK - optimized route details
+  distributions,   // From aggregator SDK - how to split liquidity across DEXs
+  amountOutRoutes, // From aggregator SDK - amounts per route
+  amountInParts,   // From aggregator SDK - input amounts per part
   slippageNumber   // User setting
 );
 ```
@@ -609,7 +669,7 @@ NEXT_PUBLIC_BITZY_API_URL=https://api-public.bitzy.app
 ```
 
 ```typescript
-// The SDK will automatically use these environment variables
+// The aggregator SDK will automatically use these environment variables
 const result = useSwapV3Routes(srcToken, dstToken, amountIn, chainId);
 // Uses process.env.NEXT_PUBLIC_BITZY_API_KEY if available
 ```
@@ -620,20 +680,20 @@ const result = useSwapV3Routes(srcToken, dstToken, amountIn, chainId);
 
 The `useSwapV3Routes` hook is designed for **hot reloading** and **real-time updates**:
 
-- **Auto-updates** - Fetches fresh routes every 10 seconds
+- **Auto-updates** - Fetches fresh aggregated routes every 10 seconds
 - **Debounced** - Prevents excessive API calls
 - **Error handling** - Built-in error state and recovery
 - **Hot reload** - Automatically reinitializes when config changes
 - **📱 React Native ready** - Works in any React environment
 
-### **Intelligent Routing**
+### **Intelligent Route Aggregation**
 
-The SDK automatically optimizes swap execution based on token characteristics:
+The aggregator SDK automatically optimizes swap execution by aggregating routes across multiple DEXs based on token characteristics:
 
-- **High-value pairs** (BTC-USDC, ETH-USDT): Uses `partCount = 5` for optimal execution
-- **Mixed pairs** (BTC-MEME, ETH-SHIB): Uses `partCount = 1` for simplicity  
-- **Low-value pairs** (MEME-SHIB): Uses `partCount = 1` for simplicity
-- **Online mode**: Checks minimum amount thresholds from API to determine if multi-route is beneficial
+- **High-value pairs** (BTC-USDC, ETH-USDT): Uses `partCount = 5` for optimal multi-DEX aggregation
+- **Mixed pairs** (BTC-MEME, ETH-SHIB): Uses `partCount = 1` for simplified aggregation  
+- **Low-value pairs** (MEME-SHIB): Uses `partCount = 1` for simplified aggregation
+- **Online mode**: Checks minimum amount thresholds from API to determine if multi-route aggregation is beneficial
 
 ### **High-Value Tokens (Network-Specific)**
 
@@ -661,7 +721,7 @@ const highValueTokens = [
 ### **Functions**
 
 #### **`fetchSwapRoute(options, config?)`**
-Main function for fetching swap routes in any environment.
+Main function for aggregating swap routes across multiple DEXs in any environment.
 
 **Parameters:**
 - `options: SwapOptions` - Swap parameters
@@ -669,8 +729,10 @@ Main function for fetching swap routes in any environment.
 
 **Returns:** `Promise<SwapResult>`
 
+**Note:** The `publicClient` is automatically created using default RPC endpoints if not provided. You can optionally inject your own `PublicClient` instance (e.g., from wagmi) for better performance and connection reuse.
+
 #### **`fetchBatchSwapRoutes(requests)`**
-Fetch multiple routes simultaneously.
+Aggregate multiple routes simultaneously across different token pairs.
 
 **Parameters:**
 - `requests: Array<{options: SwapOptions, config?: FetchSwapRouteConfig}>`
@@ -678,18 +740,19 @@ Fetch multiple routes simultaneously.
 **Returns:** `Promise<Array<{success: boolean, data?: SwapResult, error?: string}>>`
 
 #### **`getSwapQuote(srcToken, dstToken, amountIn, chainId, config?)`**
-Get a simple price quote without full routing details.
+Get an aggregated price quote without full routing details.
 
 **Returns:** `Promise<{amountOut: string, routes: number}>`
 
 #### **`fetchSwapRouteSimple(srcToken, dstToken, amountIn, chainId)`**
-Simplified function with minimal parameters.
+Simplified aggregation function with minimal parameters.
 
 **Returns:** `Promise<SwapResult>`
 
 ### **React Hooks**
 
 #### **`useSwapV3Routes(srcToken, dstToken, amountIn, chainId, config?)`**
+Aggregation React hook for real-time route optimization.
 
 **Parameters:**
 - `srcToken: Token | null` - Source token
@@ -725,7 +788,7 @@ interface SwapOptions {
   srcToken: Token;            // Source token
   dstToken: Token;            // Destination token
   chainId: number;            // Network chain ID
-  partCount?: number;         // Optional: Liquidity parts
+  partCount?: number;         // Optional: Aggregation parts
 }
 ```
 
@@ -734,10 +797,11 @@ interface SwapOptions {
 interface FetchSwapRouteConfig {
   apiBaseUrl?: string;         // Optional: API base URL (defaults to https://api-public.bitzy.app)
   networks?: Record<number, any>; // Optional: Custom network configs
-  defaultPartCount?: number;  // Optional: Default parts (defaults to 5)
+  defaultPartCount?: number;  // Optional: Default aggregation parts (defaults to 5)
   timeout?: number;           // Optional: Request timeout (defaults to 30000)
   headers?: Record<string, string>; // Optional: Custom HTTP headers (defaults to {})
   forcePartCount?: number;    // Optional: Force specific partCount, overriding intelligent calculation
+  publicClient?: PublicClient; // Optional: Viem PublicClient instance (auto-created if not provided)
 }
 ```
 
@@ -797,7 +861,7 @@ app.post('/api/swap/routes', async (req, res) => {
   }
 });
 
-// Batch processing
+// Batch aggregation processing
 app.post('/api/swap/batch', async (req, res) => {
   const { swaps } = req.body;
   
@@ -866,11 +930,14 @@ The package includes default configurations for:
 
 ### **Default Values**
 
-When no config is provided, the SDK uses these sensible defaults:
+When no config is provided, the aggregator SDK uses these sensible defaults:
 
 - **API URL**: `https://api-public.bitzy.app` (from `DEFAULT_API_BASE_URL`)
 - **API Key**: From `NEXT_PUBLIC_BITZY_API_KEY` environment variable or fallback
 - **Addresses**: Network-specific defaults from `CONTRACT_ADDRESSES`
+- **RPC Endpoints**: 
+  - Botanix Mainnet (3637): `https://rpc.botanixlabs.com`
+  - Botanix Testnet (3636): `https://node.botanixlabs.dev`
 - **PartCount**: `5` for high-value pairs, `1` for others
 - **Timeout**: `30` seconds
 - **Refresh**: `10` seconds
@@ -914,11 +981,11 @@ src/
 
 ## **Why This Design?**
 
-- **Focused** - Just the essential swap functionality
-- **Hot Reload** - Perfect for React development
-- **Universal** - Common functions work everywhere
-- **Lightweight** - Minimal dependencies
-- **Type Safe** - Full TypeScript support
+- **Focused** - Just the essential aggregation functionality
+- **Hot Reload** - Perfect for React development with real-time aggregation
+- **Universal** - Common functions work everywhere for multi-DEX aggregation
+- **Lightweight** - Minimal dependencies for efficient aggregation
+- **Type Safe** - Full TypeScript support for aggregation operations
 
 ## 📄 **License**
 

package/dist/api/Client.d.ts

@@ -37,6 +37,8 @@ export declare class APIClient {
     getAssetMinimum(): Promise<any>;
     /**
      * Build query string from parameters
+     * Arrays are formatted as JSON strings with quotes encoded as %22, brackets not encoded
+     * Example: typeId=["1","2"] becomes typeId=[%221%22,%222%22]
      */
     private buildQueryString;
 }

package/dist/api/Client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/api/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,cAAc,EAAE,MAAM,UAAU,CAAC;AAIlE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO;IAIP;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS;IAqBtD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;OAEG;YACW,OAAO;IAoDrB;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,CAAC;IAgB1B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAMrC;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAczB"}
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../src/api/Client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,cAAc,EAAE,MAAM,UAAU,CAAC;AAIlE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO;IAIP;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS;IAoBtD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;OAEG;YACW,OAAO;IAoDrB;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,CAAC;IAgB1B;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAMrC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/common/FetchSwapRoute.d.ts

@@ -14,6 +14,13 @@ export interface FetchSwapRouteConfig {
      *   - Low-value tokens (meme tokens, small caps): partCount = 1 (simpler routing)
      */
     forcePartCount?: number;
+    /**
+     * Optional PublicClient from viem
+     * - If provided, will be used for contract calls
+     * - If not provided, SDK will automatically create one using RPC_CONFIG
+     * - Useful when you already have a PublicClient instance (e.g., from wagmi)
+     */
+    publicClient?: PublicClient;
 }
 /**
  * Common function to fetch swap routes

package/dist/common/FetchSwapRoute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FetchSwapRoute.d.ts","sourceRoot":"","sources":["../../src/common/FetchSwapRoute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAuB,MAAM,UAAU,CAAC;AAS/E,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,EACpB,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAoCrB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC,GACnE,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAyBzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAehD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAcrB;AAGD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"FetchSwapRoute.d.ts","sourceRoot":"","sources":["../../src/common/FetchSwapRoute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAuB,MAAM,UAAU,CAAC;AAS/E,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,WAAW,EACpB,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC,GACnE,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAyBzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAehD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,GAAE,oBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAcrB;AAGD,eAAe,cAAc,CAAC"}

package/dist/constants/index.d.ts

@@ -24,6 +24,15 @@ export declare const CONTRACT_ADDRESSES: ChainWrap<{
     nativeAddress: Address;
     gasLimit: bigint;
 }>;
+export declare const RPC_CONFIG: ChainWrap<{
+    rpcUrls: string[];
+    name: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+}>;
 export declare const LIQUIDITY_SOURCES: ChainWrap<LiquiditySourcesConfig>;
 export declare const getLiquiditySources: (chainId: number) => LiquiditySourcesConfig;
 export declare const getContractAddresses: (chainId: number) => {
@@ -41,6 +50,15 @@ export declare const getContractAddresses: (chainId: number) => {
     gasLimit: bigint;
 };
 export declare const getDexRouters: (chainId: number) => Record<string, `0x${string}`>;
+export declare const getRpcConfig: (chainId: number) => {
+    rpcUrls: string[];
+    name: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+};
 export declare const DEFAULT_NETWORKS: ChainWrap<{
     factoryAddress: Address;
     v3FactoryAddress: Address;

package/dist/constants/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAG7D,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,WAAW,EAAE,OACoB,CAAC;AAC/C,eAAO,MAAM,aAAa,EAAE,OACkB,CAAC;AAG/C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAGnE,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa1D,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;IAClC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,CA+BA,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,sBAAsB,CAW/D,CAAC;AAGF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,KACd,sBAEF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM;oBAlElC,OAAO;sBACL,OAAO;8BACC,OAAO;2BACV,OAAO;mBACf,OAAO;uBACH,OAAO;gBACd,OAAO;wBACC,OAAO;uBACR,OAAO;oBACV,OAAO;mBACR,OAAO;cACZ,MAAM;CAyDjB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,kCAE5C,CAAC;AAGF,eAAO,MAAM,gBAAgB;oBA3EX,OAAO;sBACL,OAAO;8BACC,OAAO;2BACV,OAAO;mBACf,OAAO;uBACH,OAAO;gBACd,OAAO;wBACC,OAAO;uBACR,OAAO;oBACV,OAAO;mBACR,OAAO;cACZ,MAAM;EAgEgC,CAAC;AACnD,eAAO,MAAM,UAAU,+BAA0B,CAAC;AAGlD,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAG7D,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,WAAW,EAAE,OACoB,CAAC;AAC/C,eAAO,MAAM,aAAa,EAAE,OACkB,CAAC;AAG/C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAGnE,eAAO,MAAM,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa1D,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC;IACzC,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;IAClC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,CA+BA,CAAC;AAGF,eAAO,MAAM,UAAU,EAAE,SAAS,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAqBA,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,SAAS,CAAC,sBAAsB,CAW/D,CAAC;AAGF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,KACd,sBAEF,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM;oBAlGlC,OAAO;sBACL,OAAO;8BACC,OAAO;2BACV,OAAO;mBACf,OAAO;uBACH,OAAO;gBACd,OAAO;wBACC,OAAO;uBACR,OAAO;oBACV,OAAO;mBACR,OAAO;cACZ,MAAM;CAyFjB,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,kCAE5C,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM;aA3DjC,MAAM,EAAE;UACX,MAAM;oBACI;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB;CAuDF,CAAC;AAGF,eAAO,MAAM,gBAAgB;oBA/GX,OAAO;sBACL,OAAO;8BACC,OAAO;2BACV,OAAO;mBACf,OAAO;uBACH,OAAO;gBACd,OAAO;wBACC,OAAO;uBACR,OAAO;oBACV,OAAO;mBACR,OAAO;cACZ,MAAM;EAoGgC,CAAC;AACnD,eAAO,MAAM,UAAU,+BAA0B,CAAC;AAGlD,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAGX,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC"}

package/dist/index.d.ts

@@ -274,6 +274,13 @@ interface FetchSwapRouteConfig {
      *   - Low-value tokens (meme tokens, small caps): partCount = 1 (simpler routing)
      */
     forcePartCount?: number;
+    /**
+     * Optional PublicClient from viem
+     * - If provided, will be used for contract calls
+     * - If not provided, SDK will automatically create one using RPC_CONFIG
+     * - Useful when you already have a PublicClient instance (e.g., from wagmi)
+     */
+    publicClient?: PublicClient;
 }
 /**
  * Common function to fetch swap routes
@@ -454,6 +461,8 @@ declare class APIClient {
     getAssetMinimum(): Promise<any>;
     /**
      * Build query string from parameters
+     * Arrays are formatted as JSON strings with quotes encoded as %22, brackets not encoded
+     * Example: typeId=["1","2"] becomes typeId=[%221%22,%222%22]
      */
     private buildQueryString;
 }
@@ -467,6 +476,11 @@ interface SwapV3ServiceConfig {
 declare class SwapV3Service {
     private config;
     constructor(config: SwapV3ServiceConfig);
+    /**
+     * Get or create publicClient for the given chainId
+     * Returns existing publicClient if provided, otherwise creates a default one
+     */
+    private getPublicClient;
     /**
      * Fetch swap routes for V3 swaps
      * This is the core function extracted from the React hook