#!/usr/bin/env node /** * Token List Validator * Validates token lists against the Uniswap Token Lists JSON schema * Based on: https://github.com/Uniswap/token-lists * Schema: https://uniswap.org/tokenlist.schema.json */ import { readFileSync } from 'fs'; import { fileURLToPath } from 'url'; import { dirname, resolve } from 'path'; const __filename = fileURLToPath(import.meta.url); const __dirname = dirname(__filename); // Fetch schema from Uniswap const SCHEMA_URL = 'https://uniswap.org/tokenlist.schema.json'; async function fetchSchema() { try { const response = await fetch(SCHEMA_URL); if (!response.ok) { throw new Error(`Failed to fetch schema: ${response.statusText}`); } return await response.json(); } catch (error) { console.error('Error fetching schema:', error.message); console.error('Falling back to basic validation...'); return null; } } // Basic validation when schema is unavailable function basicValidation(tokenList) { const errors = []; const warnings = []; // Required fields if (!tokenList.name || typeof tokenList.name !== 'string') { errors.push('Missing or invalid "name" field'); } if (!tokenList.version) { errors.push('Missing "version" field'); } else { if (typeof tokenList.version.major !== 'number') { errors.push('version.major must be a number'); } if (typeof tokenList.version.minor !== 'number') { errors.push('version.minor must be a number'); } if (typeof tokenList.version.patch !== 'number') { errors.push('version.patch must be a number'); } } if (!tokenList.tokens || !Array.isArray(tokenList.tokens)) { errors.push('Missing or invalid "tokens" array'); return { errors, warnings, valid: false }; } // Validate each token tokenList.tokens.forEach((token, index) => { const prefix = `Token[${index}]`; // Required token fields if (typeof token.chainId !== 'number') { errors.push(`${prefix}: Missing or invalid "chainId"`); } if (!token.address || typeof token.address !== 'string') { errors.push(`${prefix}: Missing or invalid "address"`); } else { // Validate Ethereum address format if (!/^0x[a-fA-F0-9]{40}$/.test(token.address)) { errors.push(`${prefix}: Invalid Ethereum address format: ${token.address}`); } } if (!token.name || typeof token.name !== 'string') { errors.push(`${prefix}: Missing or invalid "name"`); } if (!token.symbol || typeof token.symbol !== 'string') { errors.push(`${prefix}: Missing or invalid "symbol"`); } if (typeof token.decimals !== 'number' || token.decimals < 0 || token.decimals > 255) { errors.push(`${prefix}: Invalid "decimals" (must be 0-255)`); } // Optional fields (warnings) if (!token.logoURI) { warnings.push(`${prefix}: Missing "logoURI" (optional but recommended)`); } else if (typeof token.logoURI !== 'string' || (!token.logoURI.startsWith('http://') && !token.logoURI.startsWith('https://') && !token.logoURI.startsWith('ipfs://'))) { warnings.push(`${prefix}: Invalid "logoURI" format (should be HTTP/HTTPS/IPFS URL)`); } }); return { errors, warnings, valid: errors.length === 0 }; } async function validateTokenList(filePath) { console.log(`\nšŸ” Validating token list: ${filePath}\n`); // Read token list file let tokenList; try { const fileContent = readFileSync(filePath, 'utf-8'); tokenList = JSON.parse(fileContent); } catch (error) { console.error('āŒ Error reading or parsing token list file:'); console.error(` ${error.message}`); process.exit(1); } // Try to fetch and use Uniswap schema const schema = await fetchSchema(); let validationResult; if (schema) { // Use AJV if available, otherwise fall back to basic validation try { // Try to use dynamic import for ajv (if installed) const { default: Ajv } = await import('ajv'); const addFormats = (await import('ajv-formats')).default; const ajv = new Ajv({ allErrors: true, verbose: true }); addFormats(ajv); const validate = ajv.compile(schema); const valid = validate(tokenList); if (valid) { validationResult = { errors: [], warnings: [], valid: true }; } else { const errors = validate.errors?.map(err => { const path = err.instancePath || err.schemaPath || ''; return `${path}: ${err.message}`; }) || []; validationResult = { errors, warnings: [], valid: false }; } } catch (importError) { // AJV not available, use basic validation console.log('āš ļø AJV not available, using basic validation'); validationResult = basicValidation(tokenList); } } else { // Schema fetch failed, use basic validation validationResult = basicValidation(tokenList); } // Display results if (validationResult.valid) { console.log('āœ… Token list is valid!\n'); // Display token list info console.log('šŸ“‹ Token List Info:'); console.log(` Name: ${tokenList.name}`); if (tokenList.version) { console.log(` Version: ${tokenList.version.major}.${tokenList.version.minor}.${tokenList.version.patch}`); } if (tokenList.timestamp) { console.log(` Timestamp: ${tokenList.timestamp}`); } console.log(` Tokens: ${tokenList.tokens.length}`); console.log(''); // List tokens console.log('šŸŖ™ Tokens:'); tokenList.tokens.forEach((token, index) => { console.log(` ${index + 1}. ${token.symbol} (${token.name})`); console.log(` Address: ${token.address}`); console.log(` Chain ID: ${token.chainId}`); console.log(` Decimals: ${token.decimals}`); if (token.logoURI) { console.log(` Logo: ${token.logoURI}`); } console.log(''); }); if (validationResult.warnings.length > 0) { console.log('āš ļø Warnings:'); validationResult.warnings.forEach(warning => { console.log(` - ${warning}`); }); console.log(''); } process.exit(0); } else { console.error('āŒ Token list validation failed!\n'); if (validationResult.errors.length > 0) { console.error('Errors:'); validationResult.errors.forEach(error => { console.error(` āŒ ${error}`); }); console.log(''); } if (validationResult.warnings.length > 0) { console.log('Warnings:'); validationResult.warnings.forEach(warning => { console.log(` āš ļø ${warning}`); }); console.log(''); } process.exit(1); } } // Main const filePath = process.argv[2] || resolve(__dirname, '../docs/METAMASK_TOKEN_LIST.json'); if (!filePath) { console.error('Usage: node validate-token-list.js [path/to/token-list.json]'); process.exit(1); } validateTokenList(filePath).catch(error => { console.error('Unexpected error:', error); process.exit(1); });