@silentswap/sdk 0.0.43 → 0.0.45

package/dist/chain.d.ts

@@ -1,4 +1,4 @@
-import type { WalletClient, SendTransactionParameters, Hex, PublicClient } from 'viem';
+import type { WalletClient, SendTransactionParameters, Hex, PublicClient, Chain } from 'viem';
 import type { Connector } from 'wagmi';
 /**
  * Ensure the correct chain is active
@@ -9,6 +9,25 @@ import type { Connector } from 'wagmi';
  * @returns The wallet client (after ensuring correct chain)
  */
 export declare function ensureChain(chainId: number, walletClient: WalletClient, connector: Connector): Promise<WalletClient>;
+/**
+ * Create a public client with RPC fallback configuration
+ *
+ * This function creates a viem public client for a given chain ID, using custom RPC URLs
+ * from H_RPCS configuration when available. If the custom RPC is unavailable, it falls back
+ * to the default RPC from the chain definition and logs an error.
+ *
+ * @param chainId - The chain ID to create a public client for
+ * @param chain - Optional chain definition (will be looked up if not provided)
+ * @returns A configured public client for the chain
+ * @throws Error if chain is not supported
+ *
+ * @example
+ * ```typescript
+ * const publicClient = createPublicClientWithRpc(43114); // Avalanche
+ * const receipt = await publicClient.waitForTransactionReceipt({ hash });
+ * ```
+ */
+export declare function createPublicClientWithRpc(chainId: number, chain?: Chain): PublicClient;
 /**
  * Wait for transaction confirmation using viem's waitForTransactionReceipt
  *

package/dist/chain.js

@@ -1,3 +1,6 @@
+import { createPublicClient, http, fallback } from 'viem';
+import { getChainById } from './chains.js';
+import { H_RPCS } from './rpc.js';
 /**
  * Ensure the correct chain is active
  *
@@ -35,6 +38,76 @@ export async function ensureChain(chainId, walletClient, connector) {
     }
     return walletClient;
 }
+/**
+ * Create a public client with RPC fallback configuration
+ *
+ * This function creates a viem public client for a given chain ID, using custom RPC URLs
+ * from H_RPCS configuration when available. If the custom RPC is unavailable, it falls back
+ * to the default RPC from the chain definition and logs an error.
+ *
+ * @param chainId - The chain ID to create a public client for
+ * @param chain - Optional chain definition (will be looked up if not provided)
+ * @returns A configured public client for the chain
+ * @throws Error if chain is not supported
+ *
+ * @example
+ * ```typescript
+ * const publicClient = createPublicClientWithRpc(43114); // Avalanche
+ * const receipt = await publicClient.waitForTransactionReceipt({ hash });
+ * ```
+ */
+export function createPublicClientWithRpc(chainId, chain) {
+    const chainDefinition = chain || getChainById(chainId);
+    if (!chainDefinition) {
+        throw new Error(`Unsupported chain ID: ${chainId}. Please ensure the chain is supported.`);
+    }
+    // Get custom RPC URL if available
+    const customRpcUrl = H_RPCS[chainId];
+    // Create transport with fallback: try custom RPC first, then default RPC
+    // The fallback transport will automatically try the default if custom RPC fails
+    let transport;
+    if (customRpcUrl) {
+        // Create a custom fetch function that logs errors for the custom RPC
+        const customFetch = async (input, init) => {
+            try {
+                const response = await fetch(input, init);
+                if (!response.ok) {
+                    // Log error when custom RPC returns non-OK response
+                    if (typeof console !== 'undefined' && console.error) {
+                        console.error(`[SilentSwap SDK] Custom RPC request failed for chain ${chainId} (${customRpcUrl}):`, `HTTP ${response.status} ${response.statusText}`);
+                        console.error(`[SilentSwap SDK] Falling back to default RPC for chain ${chainId}`);
+                    }
+                }
+                return response;
+            }
+            catch (error) {
+                // Log error when custom RPC fails
+                if (typeof console !== 'undefined' && console.error) {
+                    console.error(`[SilentSwap SDK] Custom RPC unavailable for chain ${chainId} (${customRpcUrl}):`, error instanceof Error ? error.message : String(error));
+                    console.error(`[SilentSwap SDK] Falling back to default RPC for chain ${chainId}`);
+                }
+                throw error; // Re-throw to let fallback transport handle it
+            }
+        };
+        const customTransport = http(customRpcUrl, {
+            fetchFn: customFetch,
+        });
+        const defaultTransport = http();
+        // Create fallback transport: tries custom RPC first, falls back to default if it fails
+        transport = fallback([customTransport, defaultTransport], {
+            rank: false, // Try custom first, then default
+            retryCount: 0, // Don't retry failed transports, just fall back
+        });
+    }
+    else {
+        // No custom RPC, use default
+        transport = http();
+    }
+    return createPublicClient({
+        chain: chainDefinition,
+        transport,
+    });
+}
 /**
  * Wait for transaction confirmation using viem's waitForTransactionReceipt
  *

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export * from './wallet.js';
 export * from './storage.js';
 export * from './chain.js';
 export * from './chains.js';
+export * from './rpc.js';
 export * from './assets.js';
 export * from './encoding.js';
 export * from './refund.js';

package/dist/index.js

@@ -13,6 +13,7 @@ export * from './wallet.js';
 export * from './storage.js';
 export * from './chain.js';
 export * from './chains.js';
+export * from './rpc.js';
 export * from './assets.js';
 export * from './encoding.js';
 export * from './refund.js';

package/dist/rpc.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Custom RPC endpoint configuration for EVM chains and Solana
+ *
+ * This allows you to specify custom RPC endpoints (like QuickNode) for specific chains
+ * to improve performance and reliability. These will be used as fallback transports
+ * when creating Viem public clients.
+ *
+ * Usage:
+ * - Add chain ID as key and RPC URL as value
+ * - Chain IDs: 1 = Ethereum, 43114 = Avalanche, etc.
+ * - Applications can override these values by merging with their own configuration
+ *
+ * Note: For environment variable overrides, applications should handle this in their
+ * own configuration layer (e.g., Next.js config) and merge with this default config.
+ */
+export declare const H_RPCS: Record<number, string>;

package/dist/rpc.js

@@ -0,0 +1,37 @@
+import { arbitrum, avalanche, base, berachain, bsc, mainnet, optimism, polygon } from 'viem/chains';
+import { SOLANA_CHAIN_ID } from './chains.js';
+/**
+ * Custom RPC endpoint configuration for EVM chains and Solana
+ *
+ * This allows you to specify custom RPC endpoints (like QuickNode) for specific chains
+ * to improve performance and reliability. These will be used as fallback transports
+ * when creating Viem public clients.
+ *
+ * Usage:
+ * - Add chain ID as key and RPC URL as value
+ * - Chain IDs: 1 = Ethereum, 43114 = Avalanche, etc.
+ * - Applications can override these values by merging with their own configuration
+ *
+ * Note: For environment variable overrides, applications should handle this in their
+ * own configuration layer (e.g., Next.js config) and merge with this default config.
+ */
+export const H_RPCS = {
+    // Ethereum Mainnet
+    [mainnet.id]: 'https://cosmopolitan-tiniest-mound.quiknode.pro/a0b29975a900134513a2b6fb3b623cca22308617/',
+    // Solana
+    [SOLANA_CHAIN_ID]: 'https://neat-ancient-glitter.solana-mainnet.quiknode.pro/fe9fef29e2e14ae248ca32e8dac33f423813c9d7/',
+    // Optimism
+    [optimism.id]: 'https://cold-white-mountain.optimism.quiknode.pro/dd00719b96a7c719aa6065c476ef928e465c6799/',
+    // Avalanche
+    [avalanche.id]: 'https://winter-nameless-surf.avalanche-mainnet.quiknode.pro/59d54d4b83077a8340587766212a5c641e94dd61/ext/bc/C/rpc/',
+    // Base
+    [base.id]: 'https://polished-winter-layer.base-mainnet.quiknode.pro/33626d7c49fda94bad79a0598606b0e87f4f66ba/',
+    // Polygon
+    [polygon.id]: 'https://alpha-responsive-pine.matic.quiknode.pro/9be752c95c9334332615e80c52b72a9a939fa0e2/',
+    // Arbitrum
+    [arbitrum.id]: 'https://convincing-dark-cloud.arbitrum-mainnet.quiknode.pro/e84b58f4fa4b4895282223f8170f0c7272737d26/',
+    // BSC
+    [bsc.id]: 'https://yolo-wandering-fire.bsc.quiknode.pro/07aae5c8f9c95c4d596a6997e6a28a786dc3d4a0/',
+    // Berachain
+    [berachain.id]: 'https://capable-purple-dream.bera-mainnet.quiknode.pro/11502780a6ec104db00d7940f6a61c90868a4402/',
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@silentswap/sdk",
   "type": "module",
-  "version": "0.0.43",
+  "version": "0.0.45",
   "license": "MIT",
   "main": "dist/index.js",
   "files": [