agentwallet-sdk 6.0.2 → 6.0.3

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

@@ -1,191 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

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

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

@@ -1,103 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,65 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,112 +0,0 @@
-/**
- * @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

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

package/dist/tokens/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * @module tokens
- * Multi-token support for AgentWallet v6.
- * Exports TokenRegistry, decimal utilities, EVM transfer helpers, and Solana SPL support.
- */
-export { toRaw, toHuman, formatBalance, parseAmount } from './decimals.js';
-export type { TokenInfo } from './decimals.js';
-export { TokenRegistry, getGlobalRegistry, getNativeToken, ETHEREUM_REGISTRY, BASE_REGISTRY, ARBITRUM_REGISTRY, OPTIMISM_REGISTRY, POLYGON_REGISTRY, AVALANCHE_REGISTRY, UNICHAIN_REGISTRY, LINEA_REGISTRY, SONIC_REGISTRY, WORLDCHAIN_REGISTRY, BASE_SEPOLIA_REGISTRY, } from './registry.js';
-export type { TokenEntry, AddTokenParams } from './registry.js';
-export { sendToken, sendNative, getTokenBalance, getNativeBalance, getBalances, encodeERC20Transfer, } from './transfers.js';
-export type { TransferContext, TransferOptions, TokenBalanceResult, NativeBalanceResult, } from './transfers.js';
-export { SolanaWallet, createSolanaWallet, SOLANA_TOKENS, SOLANA_TOKEN_DECIMALS } from './solana.js';
-export type { SolanaWalletConfig, SolanaTokenInfo, SolanaTokenSymbol, SolBalanceResult, SplBalanceResult, SolanaTxResult, } from './solana.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGhE,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACrG,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/tokens/index.js

@@ -1,14 +0,0 @@
-/**
- * @module tokens
- * Multi-token support for AgentWallet v6.
- * Exports TokenRegistry, decimal utilities, EVM transfer helpers, and Solana SPL support.
- */
-// Decimal normalization
-export { toRaw, toHuman, formatBalance, parseAmount } from './decimals.js';
-// Token Registry
-export { TokenRegistry, getGlobalRegistry, getNativeToken, ETHEREUM_REGISTRY, BASE_REGISTRY, ARBITRUM_REGISTRY, OPTIMISM_REGISTRY, POLYGON_REGISTRY, AVALANCHE_REGISTRY, UNICHAIN_REGISTRY, LINEA_REGISTRY, SONIC_REGISTRY, WORLDCHAIN_REGISTRY, BASE_SEPOLIA_REGISTRY, } from './registry.js';
-// EVM Transfers
-export { sendToken, sendNative, getTokenBalance, getNativeBalance, getBalances, encodeERC20Transfer, } from './transfers.js';
-// Solana (optional)
-export { SolanaWallet, createSolanaWallet, SOLANA_TOKENS, SOLANA_TOKEN_DECIMALS } from './solana.js';
-//# sourceMappingURL=index.js.map

package/dist/tokens/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tokens/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAwB;AACxB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG3E,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,gBAAgB;AAChB,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAQxB,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/tokens/registry.d.ts

@@ -1,82 +0,0 @@
-/**
- * @module tokens/registry
- * TokenRegistry — multi-chain token address registry for AgentWallet v6.
- *
- * Ships pre-populated with top tokens for all 11 supported EVM chains.
- * All addresses sourced from:
- *   - EVM: CoinGecko official token lists + chain explorers
- *   - USDC: https://developers.circle.com/stablecoins/usdc-contract-addresses
- *   - WBTC: https://wbtc.network/dashboard/order
- *   - WETH: official wrapped ETH contracts per chain
- *   - L2 native tokens: official L2 documentation
- *
- * Chain IDs follow the CHAIN_IDS map in src/types.ts.
- */
-import type { Address } from 'viem';
-import type { TokenInfo } from './decimals.js';
-export type { TokenInfo };
-/** Full token entry stored in the registry */
-export interface TokenEntry extends TokenInfo {
-    chainId: number;
-    name: string;
-    isNative?: boolean;
-}
-/** Params for adding a custom token */
-export interface AddTokenParams {
-    symbol: string;
-    address: Address;
-    decimals: number;
-    chainId: number;
-    name?: string;
-    isNative?: boolean;
-}
-export declare class TokenRegistry {
-    private readonly tokens;
-    constructor(initialTokens?: TokenEntry[]);
-    private _key;
-    private _store;
-    /**
-     * Add or overwrite a token in the registry.
-     */
-    addToken(params: AddTokenParams): void;
-    /**
-     * Look up a token by symbol and chainId.
-     * Returns undefined if not found.
-     */
-    getToken(symbol: string, chainId: number): TokenEntry | undefined;
-    /**
-     * List all tokens registered for a given chainId.
-     */
-    listTokens(chainId: number): TokenEntry[];
-    /**
-     * Find a token by its contract address on a given chain.
-     */
-    getTokenByAddress(address: Address, chainId: number): TokenEntry | undefined;
-    /**
-     * Returns all registered tokens (all chains).
-     */
-    getAllTokens(): TokenEntry[];
-    /**
-     * Returns number of registered tokens.
-     */
-    size(): number;
-}
-/** Global registry with all supported chains pre-populated. */
-export declare function getGlobalRegistry(): TokenRegistry;
-/** Create a fresh registry pre-populated for a single chain.
- * @internal — reserved for future per-chain filtering API
- */
-export declare function createChainRegistry(_chainId: number): TokenRegistry;
-export declare const ETHEREUM_REGISTRY: TokenRegistry;
-export declare const BASE_REGISTRY: TokenRegistry;
-export declare const ARBITRUM_REGISTRY: TokenRegistry;
-export declare const OPTIMISM_REGISTRY: TokenRegistry;
-export declare const POLYGON_REGISTRY: TokenRegistry;
-export declare const AVALANCHE_REGISTRY: TokenRegistry;
-export declare const UNICHAIN_REGISTRY: TokenRegistry;
-export declare const LINEA_REGISTRY: TokenRegistry;
-export declare const SONIC_REGISTRY: TokenRegistry;
-export declare const WORLDCHAIN_REGISTRY: TokenRegistry;
-export declare const BASE_SEPOLIA_REGISTRY: TokenRegistry;
-export declare function getNativeToken(chainId: number): TokenEntry | undefined;
-//# sourceMappingURL=registry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tokens/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,8CAA8C;AAC9C,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA0LD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAEjD,aAAa,CAAC,EAAE,UAAU,EAAE;IAiBxC,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;IAKd;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAYtC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIjE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAQzC;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAU5E;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf;AAOD,+DAA+D;AAC/D,wBAAgB,iBAAiB,IAAI,aAAa,CAGjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAEnE;AAID,eAAO,MAAM,iBAAiB,eAAuB,CAAC;AACtD,eAAO,MAAM,aAAa,eAA2B,CAAC;AACtD,eAAO,MAAM,iBAAiB,eAAuB,CAAC;AACtD,eAAO,MAAM,iBAAiB,eAAuB,CAAC;AACtD,eAAO,MAAM,gBAAgB,eAAwB,CAAC;AACtD,eAAO,MAAM,kBAAkB,eAAsB,CAAC;AACtD,eAAO,MAAM,iBAAiB,eAAuB,CAAC;AACtD,eAAO,MAAM,cAAc,eAA0B,CAAC;AACtD,eAAO,MAAM,cAAc,eAA0B,CAAC;AACtD,eAAO,MAAM,mBAAmB,eAAsB,CAAC;AACvD,eAAO,MAAM,qBAAqB,eAAsB,CAAC;AAGzD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAKtE"}