agentwallet-sdk 6.0.1 → 6.0.2

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":"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"}

package/dist/tokens/decimals.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @module tokens/decimals
+ * Token decimal normalization utilities for multi-token agent wallets.
+ *
+ * Handles safe conversion between human-readable amounts ("1.5") and raw
+ * on-chain bigint amounts (1500000n for USDC with 6 decimals). All arithmetic
+ * is done in integer domain to avoid floating point precision errors.
+ */
+import type { Address } from 'viem';
+/** Minimal token info required for formatting */
+export interface TokenInfo {
+    symbol: string;
+    decimals: number;
+    address: Address;
+    name?: string;
+    chainId?: number;
+}
+/**
+ * Convert a human-readable amount string to raw bigint (on-chain units).
+ *
+ * @param amount - Human-readable amount, e.g. "1.5" or "1000"
+ * @param decimals - Token decimal places (e.g. 6 for USDC, 18 for WETH)
+ * @returns Raw on-chain amount as bigint
+ *
+ * @example
+ * toRaw("1.5", 6)   // → 1500000n  (1.5 USDC)
+ * toRaw("1.0", 18)  // → 1000000000000000000n  (1 WETH)
+ * toRaw("0.001", 8) // → 100000n  (0.001 WBTC)
+ */
+export declare function toRaw(amount: string | bigint, decimals: number): bigint;
+/**
+ * Convert a raw bigint on-chain amount to a human-readable string.
+ *
+ * @param amount - Raw on-chain amount
+ * @param decimals - Token decimal places
+ * @returns Human-readable string, trimmed trailing zeros
+ *
+ * @example
+ * toHuman(1500000n, 6)               // → "1.5"
+ * toHuman(1000000000000000000n, 18)  // → "1.0"
+ * toHuman(0n, 6)                     // → "0.0"
+ */
+export declare function toHuman(amount: bigint, decimals: number): string;
+/**
+ * Format a raw bigint amount with token symbol for display.
+ *
+ * @param amount - Raw on-chain amount
+ * @param token - Token info (symbol + decimals required)
+ * @param displayDecimals - Max decimal places to show (default: 4 for high-precision, 2 for stablecoins)
+ * @returns Formatted string e.g. "1.50 USDC" or "0.0023 WETH"
+ *
+ * @example
+ * formatBalance(1500000n, { symbol: 'USDC', decimals: 6, address: '0x...' })
+ * // → "1.50 USDC"
+ */
+export declare function formatBalance(amount: bigint, token: Pick<TokenInfo, 'symbol' | 'decimals'>, displayDecimals?: number): string;
+/**
+ * Parse amount that may be either a string (human-readable) or bigint (raw).
+ * Returns raw bigint. Used in transfer functions to accept flexible input.
+ *
+ * @param amount - Either a human-readable string "1.5" or a raw bigint
+ * @param decimals - Required only when amount is a string
+ */
+export declare function parseAmount(amount: string | bigint, decimals: number): bigint;
+//# sourceMappingURL=decimals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decimals.d.ts","sourceRoot":"","sources":["../../src/tokens/decimals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoCvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAkBhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC,EAC7C,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7E"}

package/dist/tokens/decimals.js

@@ -0,0 +1,112 @@
+/**
+ * @module tokens/decimals
+ * Token decimal normalization utilities for multi-token agent wallets.
+ *
+ * Handles safe conversion between human-readable amounts ("1.5") and raw
+ * on-chain bigint amounts (1500000n for USDC with 6 decimals). All arithmetic
+ * is done in integer domain to avoid floating point precision errors.
+ */
+/**
+ * Convert a human-readable amount string to raw bigint (on-chain units).
+ *
+ * @param amount - Human-readable amount, e.g. "1.5" or "1000"
+ * @param decimals - Token decimal places (e.g. 6 for USDC, 18 for WETH)
+ * @returns Raw on-chain amount as bigint
+ *
+ * @example
+ * toRaw("1.5", 6)   // → 1500000n  (1.5 USDC)
+ * toRaw("1.0", 18)  // → 1000000000000000000n  (1 WETH)
+ * toRaw("0.001", 8) // → 100000n  (0.001 WBTC)
+ */
+export function toRaw(amount, decimals) {
+    if (typeof amount === 'bigint')
+        return amount;
+    const str = amount.trim();
+    if (!str || str === '0')
+        return 0n;
+    // Validate: only digits and one optional decimal point, optional leading minus
+    if (!/^-?\d+(\.\d+)?$/.test(str)) {
+        throw new Error(`toRaw: invalid amount string "${amount}"`);
+    }
+    const negative = str.startsWith('-');
+    const abs = negative ? str.slice(1) : str;
+    const dotIndex = abs.indexOf('.');
+    if (dotIndex === -1) {
+        // Integer amount
+        const result = BigInt(abs) * (10n ** BigInt(decimals));
+        return negative ? -result : result;
+    }
+    const intPart = abs.slice(0, dotIndex);
+    let fracPart = abs.slice(dotIndex + 1);
+    // Truncate or pad fractional part to `decimals` digits
+    if (fracPart.length > decimals) {
+        fracPart = fracPart.slice(0, decimals); // truncate (floor for positive amounts)
+    }
+    else {
+        fracPart = fracPart.padEnd(decimals, '0');
+    }
+    const raw = BigInt(intPart || '0') * (10n ** BigInt(decimals)) +
+        BigInt(fracPart);
+    return negative ? -raw : raw;
+}
+/**
+ * Convert a raw bigint on-chain amount to a human-readable string.
+ *
+ * @param amount - Raw on-chain amount
+ * @param decimals - Token decimal places
+ * @returns Human-readable string, trimmed trailing zeros
+ *
+ * @example
+ * toHuman(1500000n, 6)               // → "1.5"
+ * toHuman(1000000000000000000n, 18)  // → "1.0"
+ * toHuman(0n, 6)                     // → "0.0"
+ */
+export function toHuman(amount, decimals) {
+    if (decimals === 0)
+        return amount.toString();
+    const negative = amount < 0n;
+    const abs = negative ? -amount : amount;
+    const divisor = 10n ** BigInt(decimals);
+    const intPart = abs / divisor;
+    const fracRaw = abs % divisor;
+    // Pad fractional part to `decimals` digits
+    const fracStr = fracRaw.toString().padStart(decimals, '0');
+    // Trim trailing zeros but keep at least one decimal digit
+    const trimmed = fracStr.replace(/0+$/, '') || '0';
+    const result = `${intPart}.${trimmed}`;
+    return negative ? `-${result}` : result;
+}
+/**
+ * Format a raw bigint amount with token symbol for display.
+ *
+ * @param amount - Raw on-chain amount
+ * @param token - Token info (symbol + decimals required)
+ * @param displayDecimals - Max decimal places to show (default: 4 for high-precision, 2 for stablecoins)
+ * @returns Formatted string e.g. "1.50 USDC" or "0.0023 WETH"
+ *
+ * @example
+ * formatBalance(1500000n, { symbol: 'USDC', decimals: 6, address: '0x...' })
+ * // → "1.50 USDC"
+ */
+export function formatBalance(amount, token, displayDecimals) {
+    const human = toHuman(amount, token.decimals);
+    const maxDisplay = displayDecimals ?? (token.decimals <= 6 ? 2 : 4);
+    // Parse the human string and reformat to maxDisplay decimal places
+    const [intPart, fracPart = ''] = human.split('.');
+    const padded = fracPart.padEnd(maxDisplay, '0').slice(0, maxDisplay);
+    // If all fraction digits are zero, still show them for consistent formatting
+    return `${intPart}.${padded} ${token.symbol}`;
+}
+/**
+ * Parse amount that may be either a string (human-readable) or bigint (raw).
+ * Returns raw bigint. Used in transfer functions to accept flexible input.
+ *
+ * @param amount - Either a human-readable string "1.5" or a raw bigint
+ * @param decimals - Required only when amount is a string
+ */
+export function parseAmount(amount, decimals) {
+    if (typeof amount === 'bigint')
+        return amount;
+    return toRaw(amount, decimals);
+}
+//# sourceMappingURL=decimals.js.map

package/dist/tokens/decimals.js.map

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