fix: normalize LiFi EVM quote addresses

Author: iJaack

docs/releases/RELEASE_NOTES_1.9.5.md

@@ -0,0 +1,16 @@
+## Highlights
+
+- Fixed Li.Fi EVM quote normalization so Base → Polygon USDC bridge requests strip CAIP-10 `eip155:<chain>:` prefixes before sending `fromAddress` / `toAddress` to Li.Fi.
+- Added regression coverage for Base → Polygon native USDC quote construction, matching Mony’s Polymarket buffer top-up path.
+
+## Validation
+
+- `npm test -- test/bridge/lifi.test.ts`
+- `npm run typecheck`
+- `npm run build`
+- live bridge quote smoke: Base USDC → Polygon native USDC with CAIP-10 `fromAddress`
+
+## Notes
+
+- This unblocks autonomous Polymarket cash-buffer top-ups where the wallet needs to bridge small Base USDC balances onto Polygon before PM collateral conversion.
+- Scope is intentionally narrow: quote address normalization only, with no behavior change for already-flat EVM addresses.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "evalanche",
-  "version": "1.9.2",
+  "version": "1.9.5",
   "description": "Multi-EVM agent wallet SDK with unified holdings discovery, onchain identity (ERC-8004), x402 payments, cross-chain liquidity (Li.Fi + Gas.zip), prediction markets, DeFi, and perpetual futures",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package.json

@@ -212,15 +212,19 @@ export class LiFiClient {
     const decimals = await this.resolveFromDecimals(params);
     const fromAmount = parseUnits(String(params.fromAmount), decimals).toString();
     const routeOptions = this.resolveRouteOptions(params);
+    const fromAddress = this.normalizeEvmQuoteAddress(params.fromAddress, params.fromChainId, 'fromAddress');
+    const toAddress = params.toAddress
+      ? this.normalizeEvmQuoteAddress(params.toAddress, params.toChainId, 'toAddress')
+      : fromAddress;
 
     const searchParams = new URLSearchParams({
       fromChain: params.fromChainId.toString(),
       toChain: params.toChainId.toString(),
       fromToken: params.fromToken,
       toToken: params.toToken,
       fromAmount,
-      fromAddress: params.fromAddress,
-      toAddress: params.toAddress ?? params.fromAddress,
+      fromAddress,
+      toAddress,
       slippage: (routeOptions.slippage ?? 0.03).toString(),
       integrator: 'evalanche',
     });
@@ -262,15 +266,19 @@ export class LiFiClient {
     const decimals = await this.resolveFromDecimals(params);
     const fromAmount = parseUnits(String(params.fromAmount), decimals).toString();
     const routeOptions = this.resolveRouteOptions(params);
+    const fromAddress = this.normalizeEvmQuoteAddress(params.fromAddress, params.fromChainId, 'fromAddress');
+    const toAddress = params.toAddress
+      ? this.normalizeEvmQuoteAddress(params.toAddress, params.toChainId, 'toAddress')
+      : fromAddress;
 
     const body = {
       fromChainId: params.fromChainId,
       toChainId: params.toChainId,
       fromTokenAddress: params.fromToken,
       toTokenAddress: params.toToken,
       fromAmount,
-      fromAddress: params.fromAddress,
-      toAddress: params.toAddress ?? params.fromAddress,
+      fromAddress,
+      toAddress,
       options: {
         slippage: routeOptions.slippage ?? 0.03,
         integrator: 'evalanche',
@@ -733,6 +741,31 @@ export class LiFiClient {
     });
   }
 
+  private normalizeEvmQuoteAddress(address: string, chainId: number, field: string): string {
+    const value = String(address ?? '').trim();
+    const caip10 = value.match(/^eip155:(\d+):(0x[0-9a-fA-F]{40})$/);
+
+    if (caip10) {
+      const prefixedChainId = Number(caip10[1]);
+      if (prefixedChainId !== chainId) {
+        throw new EvalancheError(
+          `${field} chain prefix ${prefixedChainId} does not match chain ${chainId}`,
+          EvalancheErrorCode.INVALID_PARAMS,
+        );
+      }
+      return caip10[2].toLowerCase();
+    }
+
+    if (/^0x[0-9a-fA-F]{40}$/.test(value)) {
+      return value.toLowerCase();
+    }
+
+    throw new EvalancheError(
+      `${field} must be a single EVM address for Li.Fi EVM quote requests`,
+      EvalancheErrorCode.INVALID_PARAMS,
+    );
+  }
+
   private expectString(value: unknown, field: string): string {
     if (typeof value === 'string' && value.length > 0) return value;
     throw new EvalancheError(

src/bridge/lifi.ts

@@ -78,6 +78,49 @@ describe('LiFiClient', () => {
       expect(quote.estimatedTime).toBe(120);
     });
 
+    it('should flatten CAIP-style EVM sender addresses for Base to Polygon USDC quotes', async () => {
+      const walletAddress = '0x0fE61780BD5508b3C99E420662050E5560608cA4';
+      const baseUsdc = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+      const polygonNativeUsdc = '0x3c499c542cef5e3811e1192ce70d8cc03d5c3359';
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({
+          id: 'base-polygon-usdc',
+          tool: 'across',
+          action: {
+            fromChainId: 8453,
+            toChainId: 137,
+            fromToken: { address: baseUsdc },
+            toToken: { address: polygonNativeUsdc },
+            fromAmount: '5000000',
+          },
+          estimate: {
+            toAmount: '4990000',
+            gasCosts: [{ amountUSD: '0.02' }],
+            executionDuration: 45,
+          },
+        }),
+      });
+
+      await client.getQuote({
+        fromChainId: 8453,
+        toChainId: 137,
+        fromToken: baseUsdc,
+        toToken: polygonNativeUsdc,
+        fromAmount: '5',
+        fromDecimals: 6,
+        fromAddress: `eip155:8453:${walletAddress}`,
+      });
+
+      const callUrl = new URL(mockFetch.mock.calls[0][0] as string);
+      expect(callUrl.searchParams.get('fromChain')).toBe('8453');
+      expect(callUrl.searchParams.get('toChain')).toBe('137');
+      expect(callUrl.searchParams.get('fromAmount')).toBe('5000000');
+      expect(callUrl.searchParams.get('fromAddress')).toBe(walletAddress.toLowerCase());
+      expect(callUrl.searchParams.get('toAddress')).toBe(walletAddress.toLowerCase());
+    });
+
     it('should throw on API error', async () => {
       mockFetch.mockResolvedValueOnce({
         ok: false,