agentwallet-sdk 5.1.1 → 6.0.0

package/dist/swap/types.d.ts

@@ -1,6 +1,22 @@
+/**
+ * @module swap/types
+ * Type definitions and constants for the multi-chain Uniswap V3 SwapModule.
+ *
+ * Supported swap chains: Base, Arbitrum, Optimism, Polygon.
+ * All router/quoter addresses verified against official Uniswap V3 deployment docs:
+ * - Base: https://docs.uniswap.org/contracts/v3/reference/deployments/base-deployments
+ * - Arbitrum: https://docs.uniswap.org/contracts/v3/reference/deployments/arbitrum-deployments
+ * - Optimism: https://docs.uniswap.org/contracts/v3/reference/deployments/optimism-deployments
+ * - Polygon: https://docs.uniswap.org/contracts/v3/reference/deployments/polygon-deployments
+ *
+ * Note: Base uses a unique SwapRouter02 address; Arbitrum, Optimism, and Polygon
+ * share the same universal SwapRouter02 deployment address.
+ */
 import type { Address, Hash } from 'viem';
 /** Uniswap V3 fee tier options */
 export type UniswapFeeTier = 100 | 500 | 3000 | 10000;
+/** Chains supported for Uniswap V3 swap */
+export type SwapChain = 'base' | 'arbitrum' | 'optimism' | 'polygon';
 export interface SwapQuote {
     tokenIn: Address;
     tokenOut: Address;
@@ -31,6 +47,8 @@ export interface SwapModuleConfig {
     quoterAddress: Address;
     feeBps: number;
     feeWallet: Address;
+    /** Chain this SwapModule is configured for */
+    chain: SwapChain;
 }
 /** Well-known Base Mainnet token addresses */
 export declare const BASE_TOKENS: {
@@ -39,7 +57,46 @@ export declare const BASE_TOKENS: {
     cbETH: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22";
     WNATIVE: "0x4200000000000000000000000000000000000006";
 };
-/** Uniswap V3 contract addresses on Base Mainnet (chain 8453) */
+/** Well-known Arbitrum token addresses */
+export declare const ARBITRUM_TOKENS: {
+    USDC: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831";
+    WETH: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1";
+    WNATIVE: "0x82aF49447D8a07e3bd95BD0d56f35241523fBab1";
+};
+/** Well-known Optimism token addresses */
+export declare const OPTIMISM_TOKENS: {
+    USDC: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85";
+    WETH: "0x4200000000000000000000000000000000000006";
+    OP: "0x4200000000000000000000000000000000000042";
+    WNATIVE: "0x4200000000000000000000000000000000000006";
+};
+/** Well-known Polygon token addresses */
+export declare const POLYGON_TOKENS: {
+    USDC: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359";
+    WETH: "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619";
+    WMATIC: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270";
+    WNATIVE: "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270";
+};
+/**
+ * Uniswap V3 router and quoter addresses.
+ *
+ * Base has a different router (SwapRouter02 deployed at a unique address due to BASE chain launch).
+ * Arbitrum, Optimism, and Polygon use the same universal SwapRouter02 address.
+ *
+ * Sources:
+ *   - Base: https://docs.uniswap.org/contracts/v3/reference/deployments/base-deployments
+ *   - Arbitrum: https://docs.uniswap.org/contracts/v3/reference/deployments/arbitrum-deployments
+ *   - Optimism: https://docs.uniswap.org/contracts/v3/reference/deployments/optimism-deployments
+ *   - Polygon: https://docs.uniswap.org/contracts/v3/reference/deployments/polygon-deployments
+ */
+export declare const UNISWAP_V3_ADDRESSES: Record<SwapChain, {
+    ROUTER: Address;
+    QUOTER_V2: Address;
+}>;
+/**
+ * @deprecated Use UNISWAP_V3_ADDRESSES.base instead.
+ * Kept for backwards compatibility.
+ */
 export declare const UNISWAP_V3_BASE: {
     ROUTER: "0x2626664c2603336E57B271c5C0b26F421741e481";
     QUOTER_V2: "0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a";

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,cAAc,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;CAG3B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtD,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,cAAc,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;CAClB;AAID,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;CAI3B,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAiB3F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAG3B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC"}

package/dist/swap/types.js

@@ -1,3 +1,4 @@
+// ─── Token Addresses ───
 /** Well-known Base Mainnet token addresses */
 export const BASE_TOKENS = {
     USDC: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
@@ -5,7 +6,61 @@ export const BASE_TOKENS = {
     cbETH: '0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22',
     WNATIVE: '0x4200000000000000000000000000000000000006',
 };
-/** Uniswap V3 contract addresses on Base Mainnet (chain 8453) */
+/** Well-known Arbitrum token addresses */
+export const ARBITRUM_TOKENS = {
+    USDC: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
+    WETH: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+    WNATIVE: '0x82aF49447D8a07e3bd95BD0d56f35241523fBab1',
+};
+/** Well-known Optimism token addresses */
+export const OPTIMISM_TOKENS = {
+    USDC: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',
+    WETH: '0x4200000000000000000000000000000000000006',
+    OP: '0x4200000000000000000000000000000000000042',
+    WNATIVE: '0x4200000000000000000000000000000000000006',
+};
+/** Well-known Polygon token addresses */
+export const POLYGON_TOKENS = {
+    USDC: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',
+    WETH: '0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619',
+    WMATIC: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
+    WNATIVE: '0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270',
+};
+// ─── Uniswap V3 Contract Addresses ───
+/**
+ * Uniswap V3 router and quoter addresses.
+ *
+ * Base has a different router (SwapRouter02 deployed at a unique address due to BASE chain launch).
+ * Arbitrum, Optimism, and Polygon use the same universal SwapRouter02 address.
+ *
+ * Sources:
+ *   - Base: https://docs.uniswap.org/contracts/v3/reference/deployments/base-deployments
+ *   - Arbitrum: https://docs.uniswap.org/contracts/v3/reference/deployments/arbitrum-deployments
+ *   - Optimism: https://docs.uniswap.org/contracts/v3/reference/deployments/optimism-deployments
+ *   - Polygon: https://docs.uniswap.org/contracts/v3/reference/deployments/polygon-deployments
+ */
+export const UNISWAP_V3_ADDRESSES = {
+    base: {
+        ROUTER: '0x2626664c2603336E57B271c5C0b26F421741e481',
+        QUOTER_V2: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+    },
+    arbitrum: {
+        ROUTER: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        QUOTER_V2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+    },
+    optimism: {
+        ROUTER: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        QUOTER_V2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+    },
+    polygon: {
+        ROUTER: '0x68b3465833fb72A70ecDF485E0e4C7bD8665Fc45',
+        QUOTER_V2: '0x61fFE014bA17989E743c5F6cB21bF9697530B21e',
+    },
+};
+/**
+ * @deprecated Use UNISWAP_V3_ADDRESSES.base instead.
+ * Kept for backwards compatibility.
+ */
 export const UNISWAP_V3_BASE = {
     ROUTER: '0x2626664c2603336E57B271c5C0b26F421741e481',
     QUOTER_V2: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',

package/dist/swap/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAwCA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,4CAAqD;IAC3D,IAAI,EAAE,4CAAqD;IAC3D,KAAK,EAAE,4CAAqD;IAC5D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,4CAAqD;IAC7D,SAAS,EAAE,4CAAqD;CACjE,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AA2DA,0BAA0B;AAE1B,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,KAAK,EAAI,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,EAAE,EAAO,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAK,4CAAqD;IAC9D,IAAI,EAAK,4CAAqD;IAC9D,MAAM,EAAG,4CAAqD;IAC9D,OAAO,EAAE,4CAAqD;CAC/D,CAAC;AAEF,wCAAwC;AAExC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+D;IAC9F,IAAI,EAAE;QACJ,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;IACD,QAAQ,EAAE;QACR,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;IACD,QAAQ,EAAE;QACR,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;IACD,OAAO,EAAE;QACP,MAAM,EAAK,4CAA4C;QACvD,SAAS,EAAE,4CAA4C;KACxD;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAK,4CAAqD;IAChE,SAAS,EAAE,4CAAqD;CACjE,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}

package/dist/tokens/__tests__/decimals.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decimals.test.d.ts.map

package/dist/tokens/__tests__/decimals.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.test.d.ts","sourceRoot":"","sources":["../../../src/tokens/__tests__/decimals.test.ts"],"names":[],"mappings":""}

package/dist/tokens/__tests__/decimals.test.js

@@ -0,0 +1,107 @@
+/**
+ * Tests for token decimal normalization utilities.
+ */
+import { describe, it, expect } from 'vitest';
+import { toRaw, toHuman, formatBalance, parseAmount } from '../decimals.js';
+describe('toRaw', () => {
+    it('converts "1.5" with 6 decimals to 1500000n (USDC)', () => {
+        expect(toRaw('1.5', 6)).toBe(1500000n);
+    });
+    it('converts "1.0" with 18 decimals to 1000000000000000000n (WETH)', () => {
+        expect(toRaw('1.0', 18)).toBe(1000000000000000000n);
+    });
+    it('converts "0.001" with 8 decimals to 100000n (WBTC)', () => {
+        expect(toRaw('0.001', 8)).toBe(100000n);
+    });
+    it('converts integer "100" with 6 decimals correctly', () => {
+        expect(toRaw('100', 6)).toBe(100000000n);
+    });
+    it('converts "0" to 0n', () => {
+        expect(toRaw('0', 6)).toBe(0n);
+    });
+    it('handles string with more fractional digits than decimals (truncates)', () => {
+        // 1.9999999 with 6 decimals should truncate to 1.999999 → 1999999n
+        expect(toRaw('1.9999999', 6)).toBe(1999999n);
+    });
+    it('handles fractional-only strings', () => {
+        expect(toRaw('0.5', 6)).toBe(500000n);
+    });
+    it('handles bigint passthrough', () => {
+        expect(toRaw(12345n, 6)).toBe(12345n);
+    });
+    it('handles zero-padding short fractions', () => {
+        // "1.5" with 18 decimals → 1500000000000000000n
+        expect(toRaw('1.5', 18)).toBe(1500000000000000000n);
+    });
+    it('throws on invalid amount string', () => {
+        expect(() => toRaw('abc', 6)).toThrow();
+        expect(() => toRaw('1.2.3', 6)).toThrow();
+    });
+});
+describe('toHuman', () => {
+    it('converts 1500000n with 6 decimals to "1.5"', () => {
+        expect(toHuman(1500000n, 6)).toBe('1.5');
+    });
+    it('converts 1000000000000000000n with 18 decimals to "1.0"', () => {
+        expect(toHuman(1000000000000000000n, 18)).toBe('1.0');
+    });
+    it('converts 0n to "0.0"', () => {
+        expect(toHuman(0n, 6)).toBe('0.0');
+        expect(toHuman(0n, 18)).toBe('0.0');
+    });
+    it('converts 100000000n with 6 decimals to "100.0"', () => {
+        expect(toHuman(100000000n, 6)).toBe('100.0');
+    });
+    it('trims trailing zeros but keeps at least one decimal', () => {
+        expect(toHuman(1500000n, 6)).toBe('1.5');
+        expect(toHuman(1000000n, 6)).toBe('1.0');
+    });
+    it('handles 0 decimals', () => {
+        expect(toHuman(12345n, 0)).toBe('12345');
+    });
+});
+describe('formatBalance', () => {
+    it('formats USDC (6 decimals) with 2 decimal places', () => {
+        const token = { symbol: 'USDC', decimals: 6, address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' };
+        expect(formatBalance(1500000n, token)).toBe('1.50 USDC');
+    });
+    it('formats WETH (18 decimals) with 4 decimal places', () => {
+        const token = { symbol: 'WETH', decimals: 18, address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' };
+        expect(formatBalance(1000000000000000000n, token)).toBe('1.0000 WETH');
+    });
+    it('formats 0 balance correctly', () => {
+        const token = { symbol: 'USDC', decimals: 6, address: '0x0000000000000000000000000000000000000000' };
+        expect(formatBalance(0n, token)).toBe('0.00 USDC');
+    });
+    it('accepts custom displayDecimals', () => {
+        const token = { symbol: 'WETH', decimals: 18, address: '0x0000000000000000000000000000000000000000' };
+        expect(formatBalance(1000000000000000000n, token, 2)).toBe('1.00 WETH');
+    });
+});
+describe('parseAmount', () => {
+    it('parses string to raw bigint', () => {
+        expect(parseAmount('1.5', 6)).toBe(1500000n);
+    });
+    it('passes through bigint unchanged', () => {
+        expect(parseAmount(1500000n, 6)).toBe(1500000n);
+    });
+});
+describe('round-trip consistency', () => {
+    it('toRaw(toHuman(x)) === x for USDC amounts', () => {
+        const cases = [0n, 1n, 1000000n, 1500000n, 100000000n, 999999n];
+        for (const raw of cases) {
+            const human = toHuman(raw, 6);
+            const backToRaw = toRaw(human, 6);
+            expect(backToRaw).toBe(raw);
+        }
+    });
+    it('toRaw(toHuman(x)) === x for ETH amounts (selected)', () => {
+        const cases = [0n, 1000000000000000000n, 500000000000000000n];
+        for (const raw of cases) {
+            const human = toHuman(raw, 18);
+            const backToRaw = toRaw(human, 18);
+            expect(backToRaw).toBe(raw);
+        }
+    });
+});
+//# sourceMappingURL=decimals.test.js.map

package/dist/tokens/__tests__/decimals.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.test.js","sourceRoot":"","sources":["../../../src/tokens/__tests__/decimals.test.ts"],"names":[],"mappings":"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"}

package/dist/tokens/__tests__/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/tokens/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../../src/tokens/__tests__/registry.test.ts"],"names":[],"mappings":""}

package/dist/tokens/__tests__/registry.test.js

@@ -0,0 +1,191 @@
+/**
+ * Tests for the TokenRegistry — pre-populated multi-chain token registry.
+ */
+import { describe, it, expect } from 'vitest';
+import { TokenRegistry, getGlobalRegistry, BASE_REGISTRY, ETHEREUM_REGISTRY } from '../registry.js';
+import { zeroAddress } from 'viem';
+// Chain IDs
+const ETH = 1;
+const BASE = 8453;
+const ARB = 42161;
+const OP = 10;
+const POLY = 137;
+const AVAX = 43114;
+const SONIC = 146;
+describe('TokenRegistry — construction', () => {
+    it('creates a registry and has tokens pre-populated', () => {
+        const r = new TokenRegistry();
+        expect(r.size()).toBeGreaterThan(0);
+    });
+    it('populates tokens for Ethereum mainnet', () => {
+        const r = new TokenRegistry();
+        const tokens = r.listTokens(ETH);
+        expect(tokens.length).toBeGreaterThanOrEqual(10);
+        const symbols = tokens.map(t => t.symbol);
+        expect(symbols).toContain('USDC');
+        expect(symbols).toContain('WETH');
+        expect(symbols).toContain('WBTC');
+        expect(symbols).toContain('LINK');
+        expect(symbols).toContain('UNI');
+        expect(symbols).toContain('AAVE');
+        expect(symbols).toContain('DAI');
+        expect(symbols).toContain('MKR');
+        expect(symbols).toContain('ETH'); // native
+    });
+    it('populates tokens for Base mainnet', () => {
+        const r = new TokenRegistry();
+        const tokens = r.listTokens(BASE);
+        const symbols = tokens.map(t => t.symbol);
+        expect(symbols).toContain('USDC');
+        expect(symbols).toContain('WETH');
+        expect(symbols).toContain('cbETH');
+    });
+    it('populates ARB on Arbitrum', () => {
+        const r = new TokenRegistry();
+        const token = r.getToken('ARB', ARB);
+        expect(token).toBeDefined();
+        expect(token.address.toLowerCase()).toBe('0x912ce59144191c1204e64559fe8253a0e49e6548');
+    });
+    it('populates OP on Optimism', () => {
+        const r = new TokenRegistry();
+        const token = r.getToken('OP', OP);
+        expect(token).toBeDefined();
+        expect(token.address.toLowerCase()).toBe('0x4200000000000000000000000000000000000042');
+    });
+    it('populates WMATIC on Polygon', () => {
+        const r = new TokenRegistry();
+        const token = r.getToken('WMATIC', POLY);
+        expect(token).toBeDefined();
+        expect(token.address.toLowerCase()).toBe('0x0d500b1d8e8ef31e21c99d1db9a6444d3adf1270');
+    });
+    it('populates WAVAX on Avalanche', () => {
+        const r = new TokenRegistry();
+        const token = r.getToken('WAVAX', AVAX);
+        expect(token).toBeDefined();
+        expect(token.address.toLowerCase()).toBe('0xb31f66aa3c1e785363f0875a1b74e27b85fd66c7');
+    });
+    it('includes native gas tokens with isNative=true and zeroAddress', () => {
+        const r = new TokenRegistry();
+        const eth = r.getToken('ETH', BASE);
+        expect(eth).toBeDefined();
+        expect(eth.isNative).toBe(true);
+        expect(eth.address).toBe(zeroAddress);
+        const pol = r.getToken('POL', POLY);
+        expect(pol).toBeDefined();
+        expect(pol.isNative).toBe(true);
+        const avax = r.getToken('AVAX', AVAX);
+        expect(avax).toBeDefined();
+        expect(avax.isNative).toBe(true);
+        const s = r.getToken('S', SONIC);
+        expect(s).toBeDefined();
+        expect(s.isNative).toBe(true);
+    });
+});
+describe('TokenRegistry — getToken', () => {
+    it('returns undefined for unknown symbol', () => {
+        const r = new TokenRegistry();
+        expect(r.getToken('FAKECOIN', ETH)).toBeUndefined();
+    });
+    it('is case-insensitive for symbol lookup', () => {
+        const r = new TokenRegistry();
+        expect(r.getToken('usdc', ETH)).toBeDefined();
+        expect(r.getToken('USDC', ETH)).toBeDefined();
+        expect(r.getToken('Usdc', ETH)).toBeDefined();
+    });
+    it('USDC on Ethereum is correct address', () => {
+        const r = new TokenRegistry();
+        const usdc = r.getToken('USDC', ETH);
+        expect(usdc.address.toLowerCase()).toBe('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48');
+        expect(usdc.decimals).toBe(6);
+    });
+    it('USDC on Base is correct address', () => {
+        const r = new TokenRegistry();
+        const usdc = r.getToken('USDC', BASE);
+        expect(usdc.address.toLowerCase()).toBe('0x833589fcd6edb6e08f4c7c32d4f71b54bda02913');
+    });
+    it('WETH on Ethereum is correct address', () => {
+        const r = new TokenRegistry();
+        const weth = r.getToken('WETH', ETH);
+        expect(weth.address.toLowerCase()).toBe('0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2');
+        expect(weth.decimals).toBe(18);
+    });
+});
+describe('TokenRegistry — addToken (custom)', () => {
+    it('adds a custom token and retrieves it', () => {
+        const r = new TokenRegistry();
+        r.addToken({
+            symbol: 'MYTOKEN',
+            address: '0xDeadBeefDeadBeefDeadBeefDeadBeefDeadBeef',
+            decimals: 18,
+            chainId: BASE,
+            name: 'My Custom Token',
+        });
+        const t = r.getToken('MYTOKEN', BASE);
+        expect(t).toBeDefined();
+        expect(t.name).toBe('My Custom Token');
+        expect(t.decimals).toBe(18);
+    });
+    it('overwriting a token with addToken replaces it', () => {
+        const r = new TokenRegistry();
+        r.addToken({
+            symbol: 'USDC',
+            address: '0x1234567890123456789012345678901234567890',
+            decimals: 6,
+            chainId: BASE,
+            name: 'Test USDC',
+        });
+        const usdc = r.getToken('USDC', BASE);
+        expect(usdc.address.toLowerCase()).toBe('0x1234567890123456789012345678901234567890');
+    });
+});
+describe('TokenRegistry — listTokens', () => {
+    it('returns all tokens for a chain', () => {
+        const r = new TokenRegistry();
+        const tokens = r.listTokens(ARB);
+        expect(tokens.length).toBeGreaterThan(0);
+        // Every returned token should have chainId === ARB
+        for (const t of tokens) {
+            expect(t.chainId).toBe(ARB);
+        }
+    });
+    it('returns empty array for unknown chainId', () => {
+        const r = new TokenRegistry();
+        const tokens = r.listTokens(99999);
+        expect(tokens).toEqual([]);
+    });
+});
+describe('TokenRegistry — getTokenByAddress', () => {
+    it('finds a token by its address', () => {
+        const r = new TokenRegistry();
+        const usdc = r.getTokenByAddress('0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', ETH);
+        expect(usdc).toBeDefined();
+        expect(usdc.symbol).toBe('USDC');
+    });
+    it('is case-insensitive for address lookup', () => {
+        const r = new TokenRegistry();
+        const usdc = r.getTokenByAddress('0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48', // lower
+        ETH);
+        expect(usdc).toBeDefined();
+    });
+    it('returns undefined for unknown address', () => {
+        const r = new TokenRegistry();
+        const t = r.getTokenByAddress('0xDeadBeefDeadBeefDeadBeefDeadBeefDeadBeef', ETH);
+        expect(t).toBeUndefined();
+    });
+});
+describe('Pre-built registry exports', () => {
+    it('BASE_REGISTRY has Base tokens', () => {
+        const tokens = BASE_REGISTRY.listTokens(BASE);
+        expect(tokens.length).toBeGreaterThan(0);
+    });
+    it('ETHEREUM_REGISTRY has Ethereum tokens', () => {
+        const tokens = ETHEREUM_REGISTRY.listTokens(ETH);
+        expect(tokens.length).toBeGreaterThan(0);
+    });
+    it('getGlobalRegistry() returns consistent instance', () => {
+        const r1 = getGlobalRegistry();
+        const r2 = getGlobalRegistry();
+        expect(r1).toBe(r2);
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/tokens/__tests__/registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.js","sourceRoot":"","sources":["../../../src/tokens/__tests__/registry.test.ts"],"names":[],"mappings":"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"}

package/dist/tokens/__tests__/transfers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transfers.test.d.ts.map

package/dist/tokens/__tests__/transfers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfers.test.d.ts","sourceRoot":"","sources":["../../../src/tokens/__tests__/transfers.test.ts"],"names":[],"mappings":""}

package/dist/tokens/__tests__/transfers.test.js

@@ -0,0 +1,103 @@
+/**
+ * Tests for ERC-20 and native transfer encoding.
+ * Uses mocked publicClient/walletClient to avoid real RPC calls.
+ *
+ * NOTE: viem enforces EIP-55 checksummed addresses. All addresses here
+ * are checksummed via `getAddress()` from viem.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { encodeERC20Transfer } from '../transfers.js';
+import { toRaw } from '../decimals.js';
+// Checksummed test addresses (verified via viem's getAddress)
+// These are real EIP-55 addresses used only in tests
+const TO = '0xbBbBBBBbbBBBbbbBbbBbbbbBBbBbbbbBbBbbBBbB'; // BBBB... checksummed
+const ACCOUNT = '0xaAaAaAaaAaAaAaaAaAAAAAAAAaaaAaAaAaaAaaAa'; // AAAA... checksummed
+const USDC_ETH = '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48';
+const FAKE_HASH = ('0x' + 'a'.repeat(64));
+// ─── encodeERC20Transfer tests ────────────────────────────────────────────────
+describe('encodeERC20Transfer', () => {
+    it('produces correct 4-byte selector for transfer()', () => {
+        const data = encodeERC20Transfer(TO, 1000000n);
+        // transfer(address,uint256) selector = 0xa9059cbb
+        expect(data.slice(0, 10).toLowerCase()).toBe('0xa9059cbb');
+    });
+    it('encodes the recipient address in the calldata', () => {
+        const data = encodeERC20Transfer(TO, 1000000n);
+        // Recipient is ABI-encoded as 32-byte padded address starting at byte 4
+        const lowerTo = TO.toLowerCase().slice(2); // strip 0x
+        expect(data.toLowerCase()).toContain(lowerTo);
+    });
+    it('encodes the amount correctly', () => {
+        const amount = 1500000n; // 1.5 USDC
+        const data = encodeERC20Transfer(TO, amount);
+        // Amount 1500000 = 0x16e360
+        expect(data.toLowerCase()).toContain('16e360');
+    });
+    it('encodes zero amount', () => {
+        const data = encodeERC20Transfer(TO, 0n);
+        expect(data).toBeDefined();
+        expect(data.startsWith('0xa9059cbb')).toBe(true);
+    });
+    it('encodes large amounts (18 decimals, 1 WETH)', () => {
+        const oneWeth = toRaw('1.0', 18);
+        const data = encodeERC20Transfer(TO, oneWeth);
+        expect(data.startsWith('0xa9059cbb')).toBe(true);
+        // 1e18 = 0xde0b6b3a7640000
+        expect(data.toLowerCase()).toContain('de0b6b3a7640000');
+    });
+});
+// ─── Transfer function smoke tests (mocked clients) ──────────────────────────
+describe('sendToken (mocked)', () => {
+    it('calls walletClient.sendTransaction with transfer calldata', async () => {
+        const { sendToken } = await import('../transfers.js');
+        const sendTransaction = vi.fn().mockResolvedValue(FAKE_HASH);
+        const readContract = vi.fn().mockResolvedValue(6); // decimals
+        const ctx = {
+            publicClient: { readContract },
+            walletClient: { sendTransaction },
+            account: ACCOUNT,
+            chainId: 1,
+        };
+        const hash = await sendToken(ctx, TO, '1.5', USDC_ETH);
+        expect(hash).toBe(FAKE_HASH);
+        expect(sendTransaction).toHaveBeenCalledOnce();
+        const callArgs = sendTransaction.mock.calls[0][0];
+        // Should send to the token contract address
+        expect(callArgs.to).toBe(USDC_ETH);
+        // Data should start with transfer() selector
+        expect(callArgs.data.toLowerCase().startsWith('0xa9059cbb')).toBe(true);
+    });
+});
+describe('sendNative (mocked)', () => {
+    it('calls walletClient.sendTransaction with value and no data', async () => {
+        const { sendNative } = await import('../transfers.js');
+        const sendTransaction = vi.fn().mockResolvedValue(('0x' + 'b'.repeat(64)));
+        const ctx = {
+            publicClient: {},
+            walletClient: { sendTransaction },
+            account: ACCOUNT,
+        };
+        const _hash = await sendNative(ctx, TO, '0.5'); // 0.5 ETH
+        expect(sendTransaction).toHaveBeenCalledOnce();
+        const callArgs = sendTransaction.mock.calls[0][0];
+        expect(callArgs.to).toBe(TO);
+        expect(callArgs.value).toBe(500000000000000000n); // 0.5 * 10^18
+    });
+});
+describe('getNativeBalance (mocked)', () => {
+    it('returns correct balance info', async () => {
+        const { getNativeBalance } = await import('../transfers.js');
+        const getBalance = vi.fn().mockResolvedValue(1000000000000000000n); // 1 ETH
+        const ctx = {
+            publicClient: { getBalance },
+            walletClient: {},
+            account: ACCOUNT,
+            chainId: 8453,
+        };
+        const result = await getNativeBalance(ctx);
+        expect(result.rawBalance).toBe(1000000000000000000n);
+        expect(result.humanBalance).toBe('1.0');
+        expect(result.decimals).toBe(18);
+    });
+});
+//# sourceMappingURL=transfers.test.js.map

package/dist/tokens/__tests__/transfers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfers.test.js","sourceRoot":"","sources":["../../../src/tokens/__tests__/transfers.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,8DAA8D;AAC9D,qDAAqD;AACrD,MAAM,EAAE,GAAiB,4CAA4C,CAAC,CAAC,sBAAsB;AAC7F,MAAM,OAAO,GAAY,4CAA4C,CAAC,CAAC,sBAAsB;AAC7F,MAAM,QAAQ,GAAY,4CAA4C,CAAC;AACvE,MAAM,SAAS,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAkB,CAAC;AAE3D,iFAAiF;AAEjF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,EAAE,QAAU,CAAC,CAAC;QACjD,kDAAkD;QAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,EAAE,QAAU,CAAC,CAAC;QACjD,wEAAwE;QACxE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;QACtD,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,QAAU,CAAC,CAAC,WAAW;QACtC,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC7C,4BAA4B;QAC5B,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,2BAA2B;QAC3B,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAEhF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEtD,MAAM,eAAe,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW;QAE9D,MAAM,GAAG,GAAG;YACV,YAAY,EAAE,EAAE,YAAY,EAAS;YACrC,YAAY,EAAE,EAAE,eAAe,EAAS;YACxC,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,CAAC;SACX,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAE/C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,4CAA4C;QAC5C,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,6CAA6C;QAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAEvD,MAAM,eAAe,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAkB,CAAC,CAAC;QAE5F,MAAM,GAAG,GAAG;YACV,YAAY,EAAE,EAAS;YACvB,YAAY,EAAE,EAAE,eAAe,EAAS;YACxC,OAAO,EAAE,OAAO;SACjB,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,UAAU;QAE1D,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAE/C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAwB,CAAC,CAAC,CAAC,cAAc;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAE7D,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,oBAA0B,CAAC,CAAC,CAAC,QAAQ;QAElF,MAAM,GAAG,GAAG;YACV,YAAY,EAAE,EAAE,UAAU,EAAS;YACnC,YAAY,EAAE,EAAS;YACvB,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,IAAI;SACd,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,oBAA0B,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}