@heyanon/sdk 2.3.8 → 2.3.9

package/dist/index.js

@@ -606,6 +606,32 @@ function isAddress(value) {
 
 // src/utils/get-timestamp.ts
 var getTimestamp = () => Math.floor(Date.now() / 1e3);
+var { NATIVE_ADDRESS: NATIVE_ADDRESS2, WETH9: WETH92 } = evm_exports.constants;
+var { isEvmChain: isEvmChain2 } = evm_exports.utils;
+function normalizeAddress(chain, address) {
+  const { valid } = isAddress(address);
+  if (!valid)
+    throw new Error(`This is not a address: ${address}`);
+  if (address.toLowerCase() === NATIVE_ADDRESS2.toLowerCase()) {
+    if (isEvmChain2(chain)) {
+      const weth9 = WETH92[chain];
+      if (!weth9)
+        throw new Error(`WETH9 not found for ${chain}`);
+      return weth9.address;
+    }
+    if (chain === "solana" /* SOLANA */) {
+      return "So11111111111111111111111111111111111111112";
+    }
+    if (chain === "ton" /* TON */) {
+      return "0:0000000000000000000000000000000000000000000000000000000000000000";
+    }
+  }
+  if (chain === "ton" /* TON */) {
+    const tonAddress = ton.Address.parse(address);
+    return tonAddress.toRawString();
+  }
+  return address;
+}
 
 // src/adapter/transformers/toResult.ts
 function toResult(data, error = false) {
@@ -643,6 +669,7 @@ exports.allChains = allChains;
 exports.allEvmChains = allEvmChains;
 exports.getTimestamp = getTimestamp;
 exports.isAddress = isAddress;
+exports.normalizeAddress = normalizeAddress;
 exports.retry = retry;
 exports.sleep = sleep;
 exports.stringify = stringify;

package/dist/index.mjs

@@ -604,6 +604,32 @@ function isAddress(value) {
 
 // src/utils/get-timestamp.ts
 var getTimestamp = () => Math.floor(Date.now() / 1e3);
+var { NATIVE_ADDRESS: NATIVE_ADDRESS2, WETH9: WETH92 } = evm_exports.constants;
+var { isEvmChain: isEvmChain2 } = evm_exports.utils;
+function normalizeAddress(chain, address) {
+  const { valid } = isAddress(address);
+  if (!valid)
+    throw new Error(`This is not a address: ${address}`);
+  if (address.toLowerCase() === NATIVE_ADDRESS2.toLowerCase()) {
+    if (isEvmChain2(chain)) {
+      const weth9 = WETH92[chain];
+      if (!weth9)
+        throw new Error(`WETH9 not found for ${chain}`);
+      return weth9.address;
+    }
+    if (chain === "solana" /* SOLANA */) {
+      return "So11111111111111111111111111111111111111112";
+    }
+    if (chain === "ton" /* TON */) {
+      return "0:0000000000000000000000000000000000000000000000000000000000000000";
+    }
+  }
+  if (chain === "ton" /* TON */) {
+    const tonAddress = Address.parse(address);
+    return tonAddress.toRawString();
+  }
+  return address;
+}
 
 // src/adapter/transformers/toResult.ts
 function toResult(data, error = false) {
@@ -631,4 +657,4 @@ var AdapterTag = /* @__PURE__ */ ((AdapterTag2) => {
   return AdapterTag2;
 })(AdapterTag || {});
 
-export { AdapterTag, Chain, evm_exports as EVM, solana_exports as Solana, ton_exports as TON, WalletType, allChains, allEvmChains, getTimestamp, isAddress, retry, sleep, stringify, toResult };
+export { AdapterTag, Chain, evm_exports as EVM, solana_exports as Solana, ton_exports as TON, WalletType, allChains, allEvmChains, getTimestamp, isAddress, normalizeAddress, retry, sleep, stringify, toResult };

package/dist/utils/index.d.ts

@@ -3,3 +3,4 @@ export * from './sleep';
 export * from './stringify';
 export * from './is-address';
 export * from './get-timestamp';
+export * from './normalize-address';

package/dist/utils/normalize-address.d.ts

@@ -0,0 +1,82 @@
+import { Chain } from '../blockchain';
+/**
+ * Normalizes a blockchain address to its canonical form for a specific chain
+ *
+ * This function performs chain-specific address normalization:
+ * - Converts native token address (0xEee...eEe) to wrapped token address (WETH, WMATIC, etc.)
+ * - Converts TON addresses to raw string format
+ * - Validates address format before normalization
+ *
+ * @param chain - The blockchain network (Ethereum, Polygon, Solana, TON, etc.)
+ * @param address - The address to normalize
+ * @returns Normalized address in canonical format
+ * @throws Error if address is invalid or WETH9 is not found for the chain
+ *
+ * @example
+ * ```typescript
+ * // EVM: Convert native address to WETH9
+ * const normalized = normalizeAddress(
+ *   Chain.ETHEREUM,
+ *   '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'
+ * );
+ * // Returns: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' (WETH on Ethereum)
+ *
+ * // Polygon: Native to Wrapped
+ * const wmatic = normalizeAddress(
+ *   Chain.POLYGON,
+ *   '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'
+ * );
+ * // Returns: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270' (WMATIC)
+ *
+ * // Solana: Native address to wrapped SOL
+ * const wsol = normalizeAddress(
+ *   Chain.SOLANA,
+ *   '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE'
+ * );
+ * // Returns: 'So11111111111111111111111111111111111111112' (Wrapped SOL)
+ *
+ * // TON: Convert to raw format
+ * const tonRaw = normalizeAddress(
+ *   Chain.TON,
+ *   'EQD4FPq-PRDieyQKkizFTRtSDyucUIqrj0v_zXJmqaDp6_0t'
+ * );
+ * // Returns: '0:...' (raw format)
+ *
+ * // Regular EVM address (no change)
+ * const usdcAddress = normalizeAddress(
+ *   Chain.ETHEREUM,
+ *   '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48'
+ * );
+ * // Returns: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' (unchanged)
+ *
+ * // Token swap with normalization
+ * async function swapTokens(
+ *   chain: Chain,
+ *   tokenIn: string,
+ *   tokenOut: string,
+ *   amount: bigint
+ * ) {
+ *   // Normalize addresses for consistent processing
+ *   const normalizedTokenIn = normalizeAddress(chain, tokenIn);
+ *   const normalizedTokenOut = normalizeAddress(chain, tokenOut);
+ *
+ *   const swapData = await buildSwapTransaction(
+ *     chain,
+ *     normalizedTokenIn,
+ *     normalizedTokenOut,
+ *     amount
+ *   );
+ *
+ *   return swapData;
+ * }
+ *
+ * // Usage: Swap native ETH to USDC
+ * await swapTokens(
+ *   Chain.ETHEREUM,
+ *   '0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE', // Native ETH
+ *   '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
+ *   BigInt('1000000000000000000')
+ * );
+ * ```
+ */
+export declare function normalizeAddress(chain: Chain, address: string): string;

package/dist/utils/normalize-address.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyanon/sdk",
-  "version": "2.3.8",
+  "version": "2.3.9",
   "license": "MIT",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",