otomato-sdk 2.0.434 → 2.0.436

package/dist/src/constants/Blocks.js

@@ -2933,7 +2933,7 @@ export const TRIGGERS = {
                         "type": "erc20",
                         "description": "The token you want to fetch the yield",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {
@@ -3009,7 +3009,7 @@ export const TRIGGERS = {
                         "type": "erc20",
                         "description": "The token you want to fetch the borrow rate for",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {
@@ -3085,7 +3085,7 @@ export const TRIGGERS = {
                         "type": "erc20",
                         "description": "The asset to fetch the rate prediction for",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {
@@ -3171,7 +3171,7 @@ export const TRIGGERS = {
                         "type": "erc20",
                         "description": "The market you want to fetch the LTV for",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {
@@ -3251,7 +3251,7 @@ export const TRIGGERS = {
                         "type": "erc20",
                         "description": "The market you want to fetch the health factor for",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {
@@ -12413,7 +12413,7 @@ export const ACTIONS = {
                         "type": "erc20",
                         "description": "The token to deposit",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {
@@ -12528,7 +12528,7 @@ export const ACTIONS = {
                         "type": "erc20",
                         "description": "The token to withdraw",
                         "mandatory": true,
-                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
+                        "enum": "\n    (env) => {\n        if (!env.parameters.chainId)\n            throw new Error('You need to provide the chainId first');\n        \n        const availableTokens = {\n  \"1\": [\n    \"0xdac17f958d2ee523a2206206994597c13d831ec7\",\n    \"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0\",\n    \"0xdc035d45d973e3ec169d2276ddab16f1e407384f\",\n    \"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\",\n    \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n    \"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599\"\n  ],\n  \"8453\": [\n    \"0x820c137fa70c8691f0e44dc420a5e53c168921dc\",\n    \"0x4200000000000000000000000000000000000006\",\n    \"0x940181a94a35a4569e4529a3cdfb74e38fd98631\",\n    \"0xd9aaec86b65d86f6a7b5b1b0c42ffa531710b6ca\",\n    \"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"\n  ],\n  \"42161\": [\n    \"0x82af49447d8a07e3bd95bd0d56f35241523fbab1\",\n    \"0xaf88d065e77c8cc2239327c5edb3a432268e5831\",\n    \"0xff970a61a04b1ca14834a43f5de4533ebddb5cc8\",\n    \"0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9\"\n  ]\n};\n        const chainId = env.parameters.chainId;\n        return availableTokens[chainId] || [];\n    }",
                         "category": 0
                     },
                     {

package/dist/src/constants/version.js

@@ -1,4 +1,4 @@
-export const SDK_VERSION = '2.0.434';
+export const SDK_VERSION = '2.0.436';
 export function compareVersions(v1, v2) {
     // Split the version strings into parts
     const v1Parts = v1.split('.').map(Number);

package/dist/src/utils/helpers.js

@@ -494,3 +494,297 @@ export const callWithRetry = async (callback, maxRetries = 3, retryDelayMs = 100
         }
     }
 };
+const ERC20_ABI = [
+    'function decimals() external view returns (uint8)',
+    'function symbol() external view returns (string)',
+    'function name() external view returns (string)',
+];
+/**
+ * Fetches token information from an ERC20 contract.
+ * Generic function that works with any ERC20-compliant token.
+ */
+export async function getTokenInfo(tokenAddress, provider) {
+    const tokenContract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
+    try {
+        const [symbol, decimals, name] = await Promise.all([
+            tokenContract.symbol(),
+            tokenContract.decimals(),
+            tokenContract.name(),
+        ]);
+        return {
+            symbol: String(symbol),
+            decimals: Number(decimals),
+            name: String(name),
+            address: tokenAddress,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch token info for ${tokenAddress}: ${error.message}`);
+    }
+}
+/**
+ * Fetches token info with fallback values if contract call fails.
+ */
+export async function getTokenInfoWithFallback(tokenAddress, provider) {
+    try {
+        return await getTokenInfo(tokenAddress, provider);
+    }
+    catch (error) {
+        const truncatedAddress = `${tokenAddress.slice(0, 6)}...${tokenAddress.slice(-4)}`;
+        return {
+            symbol: truncatedAddress,
+            decimals: 18,
+            name: '',
+            address: tokenAddress,
+        };
+    }
+}
+/**
+ * Fetches multiple token info objects in parallel.
+ */
+export async function getMultipleTokenInfo(tokenAddresses, provider) {
+    return Promise.all(tokenAddresses.map(address => getTokenInfoWithFallback(address, provider)));
+}
+/**
+ * Known stablecoin symbols for token classification.
+ */
+export const KNOWN_STABLE_SYMBOLS = new Set([
+    'USDT', 'USDC', 'DAI', 'BUSD', 'TUSD',
+    'USDP', 'GUSD', 'LUSD', 'USDD', 'FRAX',
+    'USDC.E', 'USDC.N', 'USDC.B',
+    'FDUSD', 'PYUSD', 'XAUT',
+    'SUSD', 'MUSD', 'HUSD',
+    'USDN', 'USDX', 'USDJ',
+    'WUSDT', 'WUSDC', 'WDAI',
+    'USDB', 'USDE', 'USDL',
+    'USDbC', 'USDT0',
+]);
+/**
+ * Gas asset symbols by chain ID.
+ */
+export const GAS_ASSET_SYMBOLS = {
+    [CHAINS.BASE]: 'WETH',
+    [CHAINS.BINANCE]: 'WBNB',
+    [CHAINS.ETHEREUM]: 'WETH',
+    [CHAINS.POLYGON]: 'WMATIC',
+    [CHAINS.ARBITRUM]: 'WETH',
+    [CHAINS.AVALANCHE]: 'WAVAX',
+    [CHAINS.OPTIMISM]: 'WETH',
+    [CHAINS.HYPER_EVM]: 'WHYPE',
+};
+/**
+ * Check if a symbol is a known stablecoin.
+ */
+export function isStableCoin(symbol) {
+    if (!symbol || typeof symbol !== 'string') {
+        return false;
+    }
+    const upperSymbol = symbol.toUpperCase();
+    return upperSymbol.includes('USD') || KNOWN_STABLE_SYMBOLS.has(upperSymbol);
+}
+/**
+ * Check if a symbol is a gas asset for the given chain.
+ */
+export function isGasAsset(symbol, chainId) {
+    if (!symbol || typeof symbol !== 'string') {
+        return false;
+    }
+    const upperSymbol = symbol.toUpperCase();
+    const gasAsset = GAS_ASSET_SYMBOLS[chainId];
+    return gasAsset?.toUpperCase() === upperSymbol;
+}
+/**
+ * Get the gas asset symbol for a given chain.
+ */
+export function getGasAssetSymbol(chainId) {
+    return GAS_ASSET_SYMBOLS[chainId] || null;
+}
+/**
+ * Converts a Uniswap V3-style tick to a human-readable price.
+ * Price formula: price = 1.0001^tick * (10^(decimals1 - decimals0))
+ */
+export function tickToPrice(tick, decimals0, decimals1) {
+    const tickMathBase = 1.0001;
+    const powResult = Math.pow(tickMathBase, tick);
+    const decimalsAdjustment = Math.pow(10, decimals0 - decimals1);
+    const price = powResult * decimalsAdjustment;
+    if (!isFinite(price) || isNaN(price)) {
+        throw new Error(`Invalid price calculation: tick=${tick}, decimals0=${decimals0}, decimals1=${decimals1}`);
+    }
+    return price;
+}
+/**
+ * Converts a price to the nearest tick.
+ */
+export function priceToTick(price, decimals0, decimals1) {
+    const decimalsAdjustment = Math.pow(10, decimals0 - decimals1);
+    const adjustedPrice = price / decimalsAdjustment;
+    const tick = Math.log(adjustedPrice) / Math.log(1.0001);
+    return Math.round(tick);
+}
+/**
+ * Calculates price from sqrtPriceX96 (used in Uniswap V3 slot0).
+ */
+export function calculatePriceFromSqrtPriceX96(sqrtPriceX96, decimals0, decimals1) {
+    const sqrtPrice = Number(sqrtPriceX96) / Math.pow(2, 96);
+    const price = Math.pow(sqrtPrice, 2);
+    const decimalsAdjustment = Math.pow(10, decimals0 - decimals1);
+    return price * decimalsAdjustment;
+}
+/**
+ * Inverts a price (converts from token1/token0 to token0/token1).
+ */
+export function invertPrice(price) {
+    if (price === 0) {
+        throw new Error('Cannot invert zero price');
+    }
+    return 1 / price;
+}
+/**
+ * Format a price number to avoid scientific notation and round appropriately.
+ */
+export function formatPrice(price, isStableQuoted = false) {
+    if (price === null || price === undefined || isNaN(price) || !isFinite(price)) {
+        return null;
+    }
+    const decimals = isStableQuoted ? 2 : 6;
+    const rounded = Number(price.toFixed(decimals));
+    return rounded.toString();
+}
+/**
+ * Format two prices based on the difference between them.
+ */
+export function formatPriceRange(price1, price2) {
+    if (price1 === null || price1 === undefined || isNaN(price1) || !isFinite(price1) ||
+        price2 === null || price2 === undefined || isNaN(price2) || !isFinite(price2)) {
+        return {
+            price1: price1 !== null && price1 !== undefined ? formatPrice(price1, false) : null,
+            price2: price2 !== null && price2 !== undefined ? formatPrice(price2, false) : null,
+        };
+    }
+    const diff = Math.abs(price1 - price2);
+    let decimalPlaces;
+    if (diff < 0.0001) {
+        decimalPlaces = 5;
+    }
+    else if (diff < 0.001) {
+        decimalPlaces = 4;
+    }
+    else if (diff < 0.01) {
+        decimalPlaces = 4;
+    }
+    else if (diff < 0.1) {
+        decimalPlaces = 3;
+    }
+    else if (diff < 1) {
+        decimalPlaces = 2;
+    }
+    else if (diff < 10) {
+        decimalPlaces = 1;
+    }
+    else {
+        decimalPlaces = 0;
+    }
+    const formatted1 = price1.toFixed(decimalPlaces);
+    const formatted2 = price2.toFixed(decimalPlaces);
+    return {
+        price1: formatted1,
+        price2: formatted2,
+    };
+}
+/**
+ * Format a price with a specific number of decimal places.
+ */
+export function formatPriceWithDecimals(price, decimals) {
+    if (price === null || price === undefined || isNaN(price) || !isFinite(price)) {
+        return null;
+    }
+    return price.toFixed(decimals);
+}
+/**
+ * Rearrange token pair so stablecoin or gas asset is the quote token.
+ */
+export function rearrangeTokenPair(token1, token2, chainId) {
+    const symbol1 = typeof token1 === 'string' ? token1 : token1?.symbol;
+    const symbol2 = typeof token2 === 'string' ? token2 : token2?.symbol;
+    if (!symbol1 || !symbol2) {
+        throw new Error('Both tokens must have valid symbols');
+    }
+    const isToken1Stable = isStableCoin(symbol1);
+    const isToken2Stable = isStableCoin(symbol2);
+    if (isToken1Stable && !isToken2Stable) {
+        return {
+            base: typeof token2 === 'string' ? { symbol: symbol2 } : token2,
+            quote: typeof token1 === 'string' ? { symbol: symbol1 } : token1,
+            baseSymbol: symbol2,
+            quoteSymbol: symbol1,
+        };
+    }
+    if (!isToken1Stable && isToken2Stable) {
+        return {
+            base: typeof token1 === 'string' ? { symbol: symbol1 } : token1,
+            quote: typeof token2 === 'string' ? { symbol: symbol2 } : token2,
+            baseSymbol: symbol1,
+            quoteSymbol: symbol2,
+        };
+    }
+    if (!isToken1Stable && !isToken2Stable && chainId) {
+        const chainIdNum = Number(chainId);
+        const isToken1Gas = isGasAsset(symbol1, chainIdNum);
+        const isToken2Gas = isGasAsset(symbol2, chainIdNum);
+        if (isToken1Gas && !isToken2Gas) {
+            return {
+                base: typeof token2 === 'string' ? { symbol: symbol2 } : token2,
+                quote: typeof token1 === 'string' ? { symbol: symbol1 } : token1,
+                baseSymbol: symbol2,
+                quoteSymbol: symbol1,
+            };
+        }
+        if (!isToken1Gas && isToken2Gas) {
+            return {
+                base: typeof token1 === 'string' ? { symbol: symbol1 } : token1,
+                quote: typeof token2 === 'string' ? { symbol: symbol2 } : token2,
+                baseSymbol: symbol1,
+                quoteSymbol: symbol2,
+            };
+        }
+    }
+    return {
+        base: typeof token1 === 'string' ? { symbol: symbol1 } : token1,
+        quote: typeof token2 === 'string' ? { symbol: symbol2 } : token2,
+        baseSymbol: symbol1,
+        quoteSymbol: symbol2,
+    };
+}
+/**
+ * Get a formatted pair label from two token symbols.
+ */
+export function getPairLabel(baseSymbol, quoteSymbol) {
+    return `${baseSymbol}/${quoteSymbol}`;
+}
+/**
+ * Check if a current tick is within the specified range.
+ */
+export function isTickInRange(currentTick, tickLower, tickUpper) {
+    console.log('[nauht] - check currentTickdasdas', currentTick);
+    console.log('[nauht] - check tickLower', tickLower);
+    console.log('[nauht] - check tickUpper', tickUpper);
+    if (currentTick === null || currentTick === undefined) {
+        return false;
+    }
+    return currentTick >= tickLower && currentTick <= tickUpper;
+}
+/**
+ * Calculate the percentage of the range that the current tick occupies.
+ */
+export function calculateRangePercentage(currentTick, tickLower, tickUpper) {
+    if (currentTick === null || currentTick === undefined) {
+        return null;
+    }
+    const range = tickUpper - tickLower;
+    if (range === 0) {
+        return 0.5;
+    }
+    const position = currentTick - tickLower;
+    return position / range;
+}

package/dist/types/src/constants/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "2.0.434";
+export declare const SDK_VERSION = "2.0.436";
 export declare function compareVersions(v1: string, v2: string): number;

package/dist/types/src/utils/helpers.d.ts

@@ -131,3 +131,101 @@ export declare const findNewElements: (oldArray: string[], newArray: string[]) =
 export declare const createEthersContract: (chainId: number, contractAddress: string, abi: any[], rpcUrl?: string) => ethers.Contract;
 export declare const jsonStringifyCircularObject: (obj: any) => Promise<void>;
 export declare const callWithRetry: (callback: () => Promise<any>, maxRetries?: number, retryDelayMs?: number) => Promise<any>;
+export interface TokenInfo {
+    symbol: string;
+    decimals: number;
+    name: string;
+    address: string;
+}
+/**
+ * Fetches token information from an ERC20 contract.
+ * Generic function that works with any ERC20-compliant token.
+ */
+export declare function getTokenInfo(tokenAddress: string, provider: ethers.Provider): Promise<TokenInfo>;
+/**
+ * Fetches token info with fallback values if contract call fails.
+ */
+export declare function getTokenInfoWithFallback(tokenAddress: string, provider: ethers.Provider): Promise<TokenInfo>;
+/**
+ * Fetches multiple token info objects in parallel.
+ */
+export declare function getMultipleTokenInfo(tokenAddresses: string[], provider: ethers.Provider): Promise<TokenInfo[]>;
+/**
+ * Known stablecoin symbols for token classification.
+ */
+export declare const KNOWN_STABLE_SYMBOLS: Set<string>;
+/**
+ * Gas asset symbols by chain ID.
+ */
+export declare const GAS_ASSET_SYMBOLS: Record<number, string>;
+/**
+ * Check if a symbol is a known stablecoin.
+ */
+export declare function isStableCoin(symbol: string | null | undefined): boolean;
+/**
+ * Check if a symbol is a gas asset for the given chain.
+ */
+export declare function isGasAsset(symbol: string | null | undefined, chainId: number): boolean;
+/**
+ * Get the gas asset symbol for a given chain.
+ */
+export declare function getGasAssetSymbol(chainId: number): string | null;
+/**
+ * Converts a Uniswap V3-style tick to a human-readable price.
+ * Price formula: price = 1.0001^tick * (10^(decimals1 - decimals0))
+ */
+export declare function tickToPrice(tick: number, decimals0: number, decimals1: number): number;
+/**
+ * Converts a price to the nearest tick.
+ */
+export declare function priceToTick(price: number, decimals0: number, decimals1: number): number;
+/**
+ * Calculates price from sqrtPriceX96 (used in Uniswap V3 slot0).
+ */
+export declare function calculatePriceFromSqrtPriceX96(sqrtPriceX96: bigint | string, decimals0: number, decimals1: number): number;
+/**
+ * Inverts a price (converts from token1/token0 to token0/token1).
+ */
+export declare function invertPrice(price: number): number;
+/**
+ * Format a price number to avoid scientific notation and round appropriately.
+ */
+export declare function formatPrice(price: number | null | undefined, isStableQuoted?: boolean): string | null;
+/**
+ * Format two prices based on the difference between them.
+ */
+export declare function formatPriceRange(price1: number | null | undefined, price2: number | null | undefined): {
+    price1: string | null;
+    price2: string | null;
+};
+/**
+ * Format a price with a specific number of decimal places.
+ */
+export declare function formatPriceWithDecimals(price: number | null | undefined, decimals: number): string | null;
+export interface TokenPairInfo {
+    symbol: string;
+    address?: string;
+    decimals?: number;
+}
+export interface RearrangedPair {
+    base: TokenPairInfo;
+    quote: TokenPairInfo;
+    baseSymbol: string;
+    quoteSymbol: string;
+}
+/**
+ * Rearrange token pair so stablecoin or gas asset is the quote token.
+ */
+export declare function rearrangeTokenPair(token1: string | TokenPairInfo, token2: string | TokenPairInfo, chainId?: number | null): RearrangedPair;
+/**
+ * Get a formatted pair label from two token symbols.
+ */
+export declare function getPairLabel(baseSymbol: string, quoteSymbol: string): string;
+/**
+ * Check if a current tick is within the specified range.
+ */
+export declare function isTickInRange(currentTick: number | null, tickLower: number, tickUpper: number): boolean;
+/**
+ * Calculate the percentage of the range that the current tick occupies.
+ */
+export declare function calculateRangePercentage(currentTick: number | null, tickLower: number, tickUpper: number): number | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "otomato-sdk",
-  "version": "2.0.434",
+  "version": "2.0.436",
   "description": "An SDK for building and managing automations on Otomato",
   "main": "dist/src/index.js",
   "types": "dist/types/src/index.d.ts",