@bitzy-app/bitzy-sdk 0.0.1

package/dist/types/index.d.ts

@@ -0,0 +1,259 @@
+import { Address, PublicClient } from "viem";
+import BigNumber from "bignumber.js";
+export interface UseSwapV3RoutesAddressConfig {
+    /**
+     * Address of the Bitzy router contract
+     * Used for executing swap transactions
+     * @example "0xA5E0AE4e5103dc71cA290AA3654830442357A489"
+     */
+    routerAddress: Address;
+    /**
+     * Address of the Bitzy query contract
+     * Used for fetching swap routes and pricing data
+     * @example "0x5b5079587501Bd85d3CDf5bFDf299f4eaAe98c23"
+     */
+    bitzyQueryAddress: Address;
+    /**
+     * Address of the wrapped native token (e.g., pBTC on Botanix)
+     * Used for handling native token swaps
+     * @example "0x0D2437F93Fed6EA64Ef01cCde385FB1263910C56"
+     */
+    wrappedAddress: Address;
+    /**
+     * Address representing the native token (ETH/BTC)
+     * Standard address used across all networks for native tokens
+     * @example "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"
+     */
+    nativeAddress: Address;
+}
+export interface UseSwapV3RoutesConfig {
+    /**
+     * Base URL for the Bitzy API
+     * @default "https://api-public.bitzy.app"
+     * @example "https://api-public.bitzy.app"
+     */
+    apiBaseUrl?: string;
+    /**
+     * API key for authentication (optional)
+     * Used for premium features and rate limiting
+     * @example "your-api-key-here"
+     */
+    apiKey?: string;
+    /**
+     * Contract addresses configuration for the specific network
+     * Contains router, query, wrapped, and native token addresses
+     */
+    config?: UseSwapV3RoutesAddressConfig;
+    /**
+     * Default number of routes to split large swaps into
+     * Higher values provide better execution but increase gas costs
+     * @default 5
+     * @example 5
+     */
+    defaultPartCount?: number;
+    /**
+     * Request timeout in milliseconds
+     * @default 30000 (30 seconds)
+     * @example 30000
+     */
+    timeout?: number;
+    /**
+     * Additional HTTP headers to include with API requests
+     * @example { "authen-key": "token" }
+     */
+    headers?: Record<string, string>;
+    /**
+     * Interval in milliseconds for automatic route refresh
+     * Set to 0 to disable automatic refresh
+     * @default 10000 (10 seconds)
+     * @example 10000
+     */
+    refreshInterval?: number;
+    /**
+     * Viem PublicClient instance for blockchain interactions
+     * Used for contract calls and blockchain state queries
+     * @example publicClient from useAccount() hook
+     */
+    publicClient?: PublicClient;
+    /**
+     * Array of liquidity source types to include
+     * 1 = V2, 2 = V3
+     * @default [1, 2] (both V2 and V3)
+     * @example [2] (V3 only)
+     */
+    types?: number[];
+    /**
+     * Array of enabled liquidity sources
+     * 1 = BITZY, 2 = Other sources
+     * @default [1] (BITZY only)
+     * @example [1, 2] (BITZY and other sources)
+     */
+    enabledSources?: number[];
+    /**
+     * Override partCount calculation logic (offline mode only)
+     * - If provided, this value will be used instead of automatic calculation
+     * - **IGNORED when useOnlinePartCount is true** (best practice)
+     * - If not provided, uses intelligent address-based logic:
+     *   - High-value tokens (BTC, ETH, USDC, USDT): partCount = 5 (better routing)
+     *   - Low-value tokens (meme tokens, small caps): partCount = 1 (simpler routing)
+     *
+     * IMPORTANT EXCEPTIONS & CONCERNS:
+     *
+     * ## Pair Liquidity Impact:
+     * Even high-value tokens can cause issues in low-liquidity pairs:
+     *
+     * ### Problem Examples:
+     * - **BTC-X pair** with only $100 liquidity → Using 5 parts for $1000 swap = 50% impact per part
+     * - **USDC-X pair** with $100,000 liquidity → Using 5 parts for $1000 swap = 1% impact per part
+     *
+     * ### When to Override (offline mode only):
+     * ```typescript
+     * // Low liquidity pair - force single route
+     * const result = useSwapV3Routes(srcToken, dstToken, amountIn, chainId, {
+     *   ...config,
+     *   useOnlinePartCount: false, // Disable online mode
+     *   forcePartCount: 1, // Avoid splitting in low liquidity
+     * });
+     *
+     * // High liquidity pair - allow more routes
+     * const result = useSwapV3Routes(srcToken, dstToken, amountIn, chainId, {
+     *   ...config,
+     *   useOnlinePartCount: false, // Disable online mode
+     *   forcePartCount: 5, // Safe to split in high liquidity
+     * });
+     * ```
+     *
+     * ### Concerns to Consider:
+     * - **Slippage**: Too many parts in low liquidity = higher slippage
+     * - **Gas costs**: More routes = higher transaction costs
+     * - **Execution time**: More routes = longer execution
+     * - **Price impact**: Each part affects price, compounding impact
+     *
+     * ### Recommended Approach:
+     * 1. **Use useOnlinePartCount: true** for automatic pair liquidity detection
+     * 2. **Use forcePartCount** only when online mode is disabled
+     * 3. **Monitor slippage** and adjust accordingly
+     */
+    forcePartCount?: number;
+    /**
+     * Use online API to determine optimal partCount based on real pair liquidity
+     * - If true, calls API to get actual pair liquidity and calculates optimal partCount
+     * - If false or undefined, uses offline address-based logic
+     * - Falls back to offline logic if API call fails
+     * - Uses sensible defaults: 5% max impact, $10,000 min liquidity
+     *
+     * @example
+     * ```typescript
+     * // Use online API for accurate partCount calculation
+     * const result = useSwapV3Routes(srcToken, dstToken, amountIn, chainId, {
+     *   ...config,
+     *   useOnlinePartCount: true, // Get real-time pair liquidity data
+     * });
+     * ```
+     */
+    useOnlinePartCount?: boolean;
+}
+export type BN = BigNumber;
+export { BigNumber };
+export declare const ensureBigNumber: (value: any) => BigNumber;
+export declare const isBigNumber: (value: any) => value is BigNumber;
+export interface SwapV3AddressConfig extends UseSwapV3RoutesAddressConfig {
+    /**
+     * Gas limit for transactions
+     * @default BigInt(50_000_000_000)
+     * @example BigInt(50_000_000_000)
+     */
+    gasLimit?: bigint;
+    /**
+     * Gas price for transactions (optional)
+     * If not provided, uses network default
+     * @example BigInt(20_000_000_000) // 20 gwei
+     */
+    gasPrice?: bigint;
+}
+export interface Token {
+    address: Address;
+    symbol: string;
+    name: string;
+    decimals: number;
+    logoURI?: string;
+    chainId?: number;
+}
+export interface SwapRoute {
+    routerAddress: Address;
+    lpAddress: Address;
+    fromToken: Address;
+    toToken: Address;
+    from: Address;
+    to: Address;
+    part: string;
+    amountAfterFee: string;
+    dexInterface: number;
+}
+export interface SwapResult {
+    routes: SwapRoute[][];
+    distributions: number[];
+    amountOutRoutes: BigNumber[];
+    amountOutBN: BigNumber;
+    amountInParts: BigNumber[];
+    isAmountOutError: boolean;
+    isWrap?: "wrap" | "unwrap";
+}
+export interface SwapOptions {
+    amountIn: string;
+    srcToken: Token;
+    dstToken: Token;
+    chainId: number;
+    partCount?: number;
+    liquiditySources?: LiquiditySource[];
+    types?: number[];
+    enabledSources?: number[];
+    /**
+     * Force a specific partCount, overriding intelligent calculation
+     * - If provided, this value will be used instead of automatic calculation
+     * - If not provided, uses intelligent address-based logic:
+     *   - High-value tokens (BTC, ETH, USDC, USDT): partCount = 5 (better routing)
+     *   - Low-value tokens (meme tokens, small caps): partCount = 1 (simpler routing)
+     */
+    forcePartCount?: number;
+}
+export interface LiquiditySource {
+    type: "V2" | "V3";
+    source: string;
+    enabled: boolean;
+}
+export interface NetworkConfig {
+    routerAddress: Address;
+    bitzyQueryAddress: Address;
+    wrappedAddress: Address;
+    nativeAddress: Address;
+}
+export interface PathV3Response {
+    data: {
+        hops: any[];
+        validPath: any[];
+    };
+}
+export declare class SwapError extends Error {
+    code: string;
+    details?: any;
+    constructor(options: {
+        message: string;
+        code: string;
+        details?: any;
+    });
+}
+export type ChainWrap<T> = {
+    [chainId: number]: T;
+};
+export interface LiquiditySourcesConfig {
+    types: number[];
+    enabledSources: number[];
+}
+export interface SDKConfig {
+    networks: Record<number, NetworkConfig>;
+    defaultPartCount: number;
+    apiBaseUrl?: string;
+    timeout?: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/PartCount.d.ts

@@ -0,0 +1,101 @@
+import { Token, ChainWrap } from "../types";
+/**
+ * Clear the minimum amounts cache
+ * Useful for testing or when you need fresh data immediately
+ */
+declare function clearMinimumAmountsCache(): void;
+/**
+ * High-value tokens that benefit from multi-route optimization
+ * These tokens typically have high liquidity and benefit from route splitting
+ * Network-specific token addresses using ChainWrap pattern
+ */
+declare const HIGH_VALUE_TOKENS: ChainWrap<string[]>;
+/**
+ * Check if a token is considered high-value based on its address and chain
+ * @param token - The token to check
+ * @param chainId - The chain ID to get network-specific tokens
+ * @returns true if the token is high-value, false otherwise
+ */
+export declare function isHighValueToken(token: Token | undefined | null, chainId: number): boolean;
+/**
+ * Get partCount based on token pair addresses (offline logic)
+ * This function uses hardcoded address-based logic to determine optimal partCount
+ * Considers both tokens in the pair for better decision making
+ *
+ * IMPORTANT: This is a simplified approach that doesn't consider actual pair liquidity!
+ * For more accurate results, use getPartCountOnline() which checks actual pair liquidity.
+ *
+ * @param srcToken - The source token
+ * @param dstToken - The destination token
+ * @param chainId - The chain ID to get network-specific tokens
+ * @param defaultPartCount - Default partCount for high-value pairs (default: 5)
+ * @returns partCount: 5 for high-value pairs, 1 for others
+ *
+ * @example
+ * ```typescript
+ * // High-value pair (BTC-USDC) → returns 5
+ * const highValuePartCount = getPartCountOffline(btcToken, usdcToken, 3637, 5);
+ *
+ * // Low-value pair (BTC-MEME) → returns 1
+ * const lowValuePartCount = getPartCountOffline(btcToken, memeToken, 3637, 5);
+ * ```
+ */
+export declare function getPartCountOffline(srcToken: Token | undefined | null, dstToken: Token | undefined | null, chainId: number, defaultPartCount?: number): number;
+/**
+ * Get partCount using online API data (minimum amount-based)
+ * Checks if the swap amount meets the minimum threshold for multi-route optimization
+ *
+ * @param srcToken - Source token
+ * @param dstToken - Destination token
+ * @param amountIn - Input amount
+ * @param chainId - Chain ID
+ * @param apiBaseUrl - API base URL
+ * @param apiKey - Optional API key
+ * @returns Promise<number> - partCount (5 if amount >= minimum for both tokens, otherwise fallback)
+ */
+export declare function getPartCountOnline(srcToken: Token, dstToken: Token, amountIn: string, chainId: number, apiBaseUrl: string, apiKey?: string, fallbackPartCount?: number): Promise<number>;
+/**
+ * Get partCount with fallback strategy
+ * Tries online API first, falls back to offline logic if API fails
+ * Uses sensible defaults: 5% max impact, $10,000 min liquidity
+ *
+ * @param srcToken - The source token
+ * @param dstToken - The destination token
+ * @param amountIn - The swap amount
+ * @param chainId - The chain ID
+ * @param apiBaseUrl - The API base URL
+ * @param fallbackPartCount - PartCount to use if API fails (default: 5)
+ * @returns Promise<number> - Optimal partCount
+ *
+ * @example
+ * ```typescript
+ * // Try online first, fallback to offline
+ * const partCount = await getPartCountWithFallback(
+ *   srcToken,
+ *   dstToken,
+ *   amountIn,
+ *   chainId,
+ *   apiBaseUrl,
+ *   5 // fallback partCount
+ * );
+ * ```
+ */
+export declare function getPartCountWithFallback(srcToken: Token, dstToken: Token, amountIn: string, chainId: number, apiBaseUrl: string, fallbackPartCount?: number, apiKey?: string): Promise<number>;
+/**
+ * Calculate price impact for a given swap
+ * @param swapAmount - The swap amount in USD
+ * @param pairLiquidity - The pair liquidity in USD
+ * @param partCount - The number of parts to split the swap
+ * @returns The price impact percentage
+ */
+export declare function calculatePriceImpact(swapAmount: number, pairLiquidity: number, partCount: number): number;
+/**
+ * Determine optimal partCount based on price impact thresholds
+ * @param swapAmount - The swap amount in USD
+ * @param pairLiquidity - The pair liquidity in USD
+ * @param maxImpactThreshold - Maximum acceptable impact per part (default: 5%)
+ * @returns Optimal partCount (1 or 5)
+ */
+export declare function getOptimalPartCount(swapAmount: number, pairLiquidity: number, maxImpactThreshold?: number): number;
+export { HIGH_VALUE_TOKENS, clearMinimumAmountsCache };
+//# sourceMappingURL=PartCount.d.ts.map

package/dist/utils/PartCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartCount.d.ts","sourceRoot":"","sources":["../../src/utils/PartCount.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAyD5C;;;GAGG;AACH,iBAAS,wBAAwB,IAAI,IAAI,CAGxC;AAED;;;;GAIG;AACH,QAAA,MAAM,iBAAiB,EAAE,SAAS,CAAC,MAAM,EAAE,CAiB1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,EAC/B,OAAO,EAAE,MAAM,GACd,OAAO,CAST;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,EAClC,QAAQ,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,EAClC,OAAO,EAAE,MAAM,EACf,gBAAgB,GAAE,MAAU,GAC3B,MAAM,CAOR;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,iBAAiB,GAAE,MAAU,GAC5B,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,KAAK,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,iBAAiB,GAAE,MAAU,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAChB,MAAM,CAKR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,kBAAkB,GAAE,MAAU,GAC7B,MAAM,CAQR;AAGD,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,68 @@
+import BigNumber from "bignumber.js";
+import { Address } from "viem";
+import { Token } from "../types";
+/**
+ * Convert token amount from human readable format to wei
+ * @param amount - Human readable amount (e.g., "1.5")
+ * @param decimals - Token decimals
+ * @returns BigNumber representation in wei
+ */
+export declare function fromTokenAmount(amount: string, decimals: number): BigNumber;
+/**
+ * Convert token amount from wei to human readable format
+ * @param amount - Amount in wei
+ * @param decimals - Token decimals
+ * @returns Human readable amount string
+ */
+export declare function toTokenAmount(amount: BigNumber | string, decimals: number): string;
+/**
+ * Check if a token is native (ETH, BNB, etc.)
+ * @param token - Token to check
+ * @param nativeAddress - Native token address for the network
+ * @returns boolean
+ */
+export declare function isNativeToken(token: Token, nativeAddress: Address): boolean;
+/**
+ * Check if a token is wrapped (WETH, WBNB, etc.)
+ * @param token - Token to check
+ * @param wrappedAddress - Wrapped token address for the network
+ * @returns boolean
+ */
+export declare function isWrappedToken(token: Token, wrappedAddress: Address): boolean;
+/**
+ * Validate token addresses
+ * @param srcToken - Source token
+ * @param dstToken - Destination token
+ * @returns boolean
+ */
+export declare function validateTokens(srcToken: Token, dstToken: Token): boolean;
+/**
+ * Validate amount input
+ * @param amount - Amount to validate
+ * @returns boolean
+ */
+export declare function validateAmount(amount: string): boolean;
+/**
+ * Calculate optimal part count of a route based on amount and price
+ * @param amount - Input amount
+ * @param price - Token price in USD
+ * @param partCount - Default part count of a route
+ * @returns number
+ */
+export declare function calculatePartCount(amount: string, price: number, partCount?: number): number;
+/**
+ * Format error message
+ * @param error - Error object or string
+ * @returns Formatted error string
+ */
+export declare function formatError(error: any): string;
+/**
+ * Debounce function
+ * @param func - Function to debounce
+ * @param wait - Wait time in milliseconds
+ * @returns Debounced function with cancel method
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAK3E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,OAAO,CASxE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAW,GACrB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAW9C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,GACX,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAa7D"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@bitzy-app/bitzy-sdk",
+  "version": "0.0.1",
+  "description": "Bitzy Swap V3 Routes SDK for frontend and backend applications",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "jest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [
+    "bitzy",
+    "swap",
+    "defi",
+    "ethereum",
+    "botanix",
+    "v3",
+    "liquidity",
+    "routing"
+  ],
+  "author": "Bitzy Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bitzy-app/bitzy-sdk"
+  },
+  "dependencies": {
+    "bignumber.js": "^9.1.2",
+    "lodash": "^4.17.21",
+    "viem": "^2.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/jest": "^30.0.0",
+    "@types/lodash": "^4.14.202",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.7.0",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.0.0",
+    "rollup-plugin-dts": "^6.0.0",
+    "ts-jest": "^29.4.1",
+    "tslib": "^2.6.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0",
+    "react": ">=16.8.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/bitzy/bitzy-swap-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/bitzy/bitzy-swap-sdk/issues"
+  }
+}