@aastar/sdk 0.16.6 → 0.16.11

package/packages/analytics/src/utils/LogParser.ts

@@ -0,0 +1,220 @@
+/**
+ * LogParser - 批量解析历史测试日志
+ * 
+ * 功能：
+ * - 遍历 logs/*.log 文件
+ * - 提取 transaction hash, userOp hash, test type
+ * - 支持 Anvil 和 Sepolia 两种环境
+ * - 返回标准化的交易记录
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+export interface TransactionRecord {
+  txHash: string;           // 交易哈希
+  userOpHash?: string;      // UserOperation 哈希
+  testType: string;         // 测试类型 (jason1-gasless, anni-gasless, etc.)
+  network: 'anvil' | 'sepolia'; // 网络环境
+  timestamp: Date;          // 日志时间戳
+  logFile: string;          // 来源日志文件
+  success: boolean;         // 是否成功
+}
+
+export class LogParser {
+  private logsDir: string;
+
+  constructor(logsDir?: string) {
+    this.logsDir = logsDir || path.resolve(__dirname, '../../../../logs');
+  }
+
+  /**
+   * 解析所有日志文件
+   */
+  async parseAll(): Promise<TransactionRecord[]> {
+    const logFiles = this.getLogFiles();
+    const records: TransactionRecord[] = [];
+
+    for (const logFile of logFiles) {
+      const fileRecords = await this.parseFile(logFile);
+      records.push(...fileRecords);
+    }
+
+    console.log(`✅ 解析完成：从 ${logFiles.length} 个日志文件中提取 ${records.length} 条交易记录`);
+    return records;
+  }
+
+  /**
+   * 解析单个日志文件
+   */
+  private async parseFile(filePath: string): Promise<TransactionRecord[]> {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const fileName = path.basename(filePath);
+    
+    // 从文件名提取网络和时间戳
+    const network = fileName.includes('anvil') ? 'anvil' : 'sepolia';
+    const timestampMatch = fileName.match(/(\d{8}_\d{6})/);
+    const timestamp = timestampMatch 
+      ? this.parseTimestamp(timestampMatch[1])
+      : new Date(fs.statSync(filePath).mtime);
+
+    const records: TransactionRecord[] = [];
+    const lines = content.split('\n');
+
+    let currentTest: string | null = null;
+    let currentSuccess = false;
+
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+
+      // 识别测试类型
+      const testMatch = line.match(/📋 Test: (.+)/);
+      if (testMatch) {
+        currentTest = testMatch[1].trim();
+        currentSuccess = false;
+        continue;
+      }
+
+      // 提取交易哈希
+      const txHashMatch = line.match(/(?:Transaction|transaction):\s*(0x[a-fA-F0-9]{64})/);
+      if (txHashMatch && currentTest) {
+        const txHash = txHashMatch[1];
+        
+        // 尝试查找关联的 UserOp Hash
+        const userOpHash = this.findUserOpHash(lines, i);
+
+        records.push({
+          txHash,
+          userOpHash,
+          testType: currentTest,
+          network,
+          timestamp,
+          logFile: fileName,
+          success: true, // 如果记录了 tx，默认认为成功
+        });
+      }
+
+      // 检测成功标志
+      if (line.includes('🎉') || line.includes('SUCCESS') || line.includes('✅')) {
+        currentSuccess = true;
+      }
+
+      // 提取 UserOp Hash（独立出现的情况）
+      const userOpMatch = line.match(/UserOp(?:\s+submitted!?)?\s+Hash:\s*(0x[a-fA-F0-9]{64})/i);
+      if (userOpMatch && currentTest) {
+        const userOpHash = userOpMatch[1];
+        
+        // 检查是否已有对应的 tx 记录
+        const existing = records.find(r => r.userOpHash === userOpHash);
+        if (!existing) {
+          // 尝试向后查找对应的 tx hash
+          const txHash = this.findTxHash(lines, i);
+          
+          if (txHash) {
+            records.push({
+              txHash,
+              userOpHash,
+              testType: currentTest,
+              network,
+              timestamp,
+              logFile: fileName,
+              success: true,
+            });
+          }
+        }
+      }
+    }
+
+    return records;
+  }
+
+  /**
+   * 在指定行附近查找 UserOp Hash
+   */
+  private findUserOpHash(lines: string[], startLine: number): string | undefined {
+    const searchRange = 20; // 向前后各搜索20行
+    
+    for (let i = Math.max(0, startLine - searchRange); i < Math.min(lines.length, startLine + searchRange); i++) {
+      const match = lines[i].match(/UserOp(?:\s+submitted!?)?\s+Hash:\s*(0x[a-fA-F0-9]{64})/i);
+      if (match) {
+        return match[1];
+      }
+    }
+    
+    return undefined;
+  }
+
+  /**
+   * 在指定行之后查找 Transaction Hash
+   */
+  private findTxHash(lines: string[], startLine: number): string | undefined {
+    const searchRange = 30; // 向后搜索30行
+    
+    for (let i = startLine; i < Math.min(lines.length, startLine + searchRange); i++) {
+      const match = lines[i].match(/(?:Transaction|transaction):\s*(0x[a-fA-F0-9]{64})/);
+      if (match) {
+        return match[1];
+      }
+    }
+    
+    return undefined;
+  }
+
+  /**
+   * 解析时间戳字符串
+   */
+  private parseTimestamp(timestampStr: string): Date {
+    // 格式: YYYYMMDD_HHMMSS
+    const year = parseInt(timestampStr.substring(0, 4));
+    const month = parseInt(timestampStr.substring(4, 6)) - 1;
+    const day = parseInt(timestampStr.substring(6, 8));
+    const hour = parseInt(timestampStr.substring(9, 11));
+    const minute = parseInt(timestampStr.substring(11, 13));
+    const second = parseInt(timestampStr.substring(13, 15));
+    
+    return new Date(year, month, day, hour, minute, second);
+  }
+
+  /**
+   * 获取所有日志文件路径
+   */
+  private getLogFiles(): string[] {
+    if (!fs.existsSync(this.logsDir)) {
+      throw new Error(`日志目录不存在: ${this.logsDir}`);
+    }
+
+    const files = fs.readdirSync(this.logsDir)
+      .filter(f => f.endsWith('.log'))
+      .map(f => path.join(this.logsDir, f))
+      .sort(); // 按文件名排序
+
+    return files;
+  }
+
+  /**
+   * 统计概览
+   */
+  getStatistics(records: TransactionRecord[]): {
+    total: number;
+    byNetwork: Record<string, number>;
+    byTestType: Record<string, number>;
+    successRate: number;
+  } {
+    const byNetwork: Record<string, number> = {};
+    const byTestType: Record<string, number> = {};
+    let successCount = 0;
+
+    for (const record of records) {
+      byNetwork[record.network] = (byNetwork[record.network] || 0) + 1;
+      byTestType[record.testType] = (byTestType[record.testType] || 0) + 1;
+      if (record.success) successCount++;
+    }
+
+    return {
+      total: records.length,
+      byNetwork,
+      byTestType,
+      successRate: records.length > 0 ? successCount / records.length : 0,
+    };
+  }
+}

package/packages/analytics/src/utils/PriceOracle.ts

@@ -0,0 +1,117 @@
+/**
+ * PriceOracle - ETH 价格查询与缓存
+ * 
+ * 支持：
+ * - CoinGecko API (主要)
+ * - 本地缓存 (每小时更新)
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+interface PriceCache {
+  eth_usd: number;
+  apnts_usd: number;
+  timestamp: number; // Unix timestamp
+}
+
+export class PriceOracle {
+  private cacheFile: string;
+  private cacheDuration: number; // 缓存有效期（秒）
+
+  constructor(cacheFile?: string, cacheDuration = 3600) {
+    this.cacheFile = cacheFile || path.resolve(__dirname, '../../../../packages/analytics/data/eth_price_cache.json');
+    this.cacheDuration = cacheDuration;
+  }
+
+  /**
+   * 获取 ETH 价格（USD）
+   */
+  async getEthPrice(): Promise<number> {
+    // 检查缓存
+    const cached = this.loadCache();
+    const now = Math.floor(Date.now() / 1000);
+
+    if (cached && (now - cached.timestamp) < this.cacheDuration) {
+      console.log(`💵 使用缓存 ETH 价格: $${cached.eth_usd} (更新于 ${new Date(cached.timestamp * 1000).toISOString()})`);
+      return cached.eth_usd;
+    }
+
+    // 从 CoinGecko 获取
+    try {
+      const ethPrice = await this.fetchETHFromCoinGecko();
+      const currentAPNTs = cached?.apnts_usd || 0.02; // 默认 0.02
+
+      this.saveCache({ 
+        eth_usd: ethPrice, 
+        apnts_usd: currentAPNTs,
+        timestamp: now 
+      });
+      return ethPrice;
+    } catch (error) {
+      console.warn('⚠️  无法获取价格，使用默认值');
+      return 3300; // 默认值
+    }
+  }
+
+  /**
+   * 获取 aPNTs 价格（USD）
+   * 未来可扩展为从 SuperPaymaster 合约查询
+   */
+  async getAPNTsPrice(): Promise<number> {
+    const cached = this.loadCache();
+    const now = Math.floor(Date.now() / 1000);
+
+    if (cached && (now - cached.timestamp) < this.cacheDuration) {
+      return cached.apnts_usd || 0.02;
+    }
+
+    // 默认保持 0.02，但预留更新逻辑
+    return 0.02;
+  }
+
+  /**
+   * 从 CoinGecko API 获取 ETH 价格
+   */
+  private async fetchETHFromCoinGecko(): Promise<number> {
+    const url = 'https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd';
+    
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`CoinGecko API 错误: ${response.status}`);
+    }
+
+    const data = await response.json();
+    return data.ethereum.usd;
+  }
+
+  /**
+   * 加载缓存
+   */
+  private loadCache(): PriceCache | null {
+    try {
+      if (fs.existsSync(this.cacheFile)) {
+        const content = fs.readFileSync(this.cacheFile, 'utf8');
+        return JSON.parse(content);
+      }
+    } catch (e) {
+      // Ignore
+    }
+    return null;
+  }
+
+  /**
+   * 保存缓存
+   */
+  private saveCache(cache: PriceCache): void {
+    try {
+      const dir = path.dirname(this.cacheFile);
+      if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+      }
+      fs.writeFileSync(this.cacheFile, JSON.stringify(cache, null, 2), 'utf8');
+    } catch (e) {
+      console.warn('⚠️  缓存保存失败:', e);
+    }
+  }
+}

package/packages/analytics/test/AttributionAnalyzer.test.ts

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { AttributionAnalyzer } from '../src/analyzers/AttributionAnalyzer';
+import type { CostBreakdown } from '../src/core/CostCalculator';
+
+describe('AttributionAnalyzer', () => {
+    const analyzer = new AttributionAnalyzer();
+    const ethPrice = 3000;
+
+    it('should simulate L2 costs with dynamic calldata pricing', () => {
+        const mockBreakdown: CostBreakdown = {
+            intrinsic: {
+                gasUsed: 200000n,
+                aPNTsConsumed: 0n,
+                overheadGas: 0n,
+                efficiency: 1
+            },
+            economic: {
+                l1EthCost: 200000n * 1000000000n, // 0.0002 ETH (1 Gwei gas price)
+                l1UsdCost: 0.60, // $0.60
+                protocolUsdRevenue: 0.70,
+                protocolUsdProfit: 0.10,
+                protocolUsdSubsidy: 0
+            },
+            meta: {
+                txHash: '0x',
+                blockNumber: 1n,
+                timestamp: 1n,
+                mode: 'v4'
+            }
+        };
+
+        const sim = analyzer.simulateL2Cost(mockBreakdown, ethPrice);
+
+        // 1. L2 Execution: 200k gas * 0.001 Gwei = 0.0000002 ETH = $0.0006
+        expect(sim.totalL2Usd).toBeGreaterThan(0);
+        expect(sim.totalL2Usd).toBeLessThan(0.01); // Should be very cheap
+        
+        // 2. Savings Ratio
+        // $0.60 / ~$0.001 should be around 600x
+        expect(sim.savingsRatio).toBeGreaterThan(50);
+    });
+});

package/packages/analytics/test/CostCalculator.test.ts

@@ -0,0 +1,75 @@
+import { describe, it, expect } from 'vitest';
+import { CostCalculator } from '../src/core/CostCalculator';
+import type { OnChainData } from '../src/core/DataCollector';
+import { parseEther } from 'viem';
+
+describe('CostCalculator', () => {
+    // Mock Prices: ETH = $3000, aPNTs = $0.02
+    const calculator = new CostCalculator(3000, 0.02);
+
+    it('should calculate SuperPaymaster (V3) costs correctly', () => {
+        const mockData: OnChainData = {
+            txHash: '0x123',
+            gasUsed: 100000n,
+            effectiveGasPrice: parseEther('0.000000001'), // 1 Gwei
+            blockNumber: 1n,
+            blockTimestamp: 1000n,
+            paymasterEvents: [
+                {
+                    type: 'TransactionSponsored',
+                    user: '0xUser',
+                    apntsConsumed: 1000000000000000000n // 1 aPNTs (18 decimals)
+                }
+            ],
+            // Layer 1 Cost = 100k gas * 1 gwei = 0.0001 ETH ($0.30)
+        };
+
+        const result = calculator.calculate(mockData);
+
+        expect(result.meta.mode).toBe('super');
+        
+        // Revenue: 1 aPNTs * $0.02 = $0.02
+        expect(result.economic.protocolUsdRevenue).toBeCloseTo(0.02);
+        
+        // Cost: 0.0001 ETH * $3000 = $0.30
+        expect(result.economic.l1UsdCost).toBeCloseTo(0.30);
+        
+        // Profit: $0.02 - $0.30 = -$0.28
+        expect(result.economic.protocolUsdProfit).toBeCloseTo(-0.28);
+    });
+
+    it('should calculate Paymaster V4 costs correctly (Token)', () => {
+        const mockData: OnChainData = {
+            txHash: '0x456',
+            gasUsed: 100000n,
+            effectiveGasPrice: parseEther('0.000000001'), // 1 Gwei
+            blockNumber: 1n,
+            blockTimestamp: 1000n,
+            paymasterEvents: [
+                {
+                    type: 'PostOpProcessed',
+                    user: '0xUser',
+                    token: '0xToken',
+                    tokenCost: 1000000000000000000n, // 1 Unit ($1 assumed for non-ETH)
+                    actualGasCostWei: parseEther('0.0001'),
+                    protocolRevenue: 0n
+                }
+            ]
+        };
+
+        const result = calculator.calculate(mockData);
+
+        expect(result.meta.mode).toBe('v4');
+        
+        // Revenue: 1 Unit * $1 (implicit assumption for general tokens in V4 logic)
+        // Wait, current logic for V4 non-ETH is formatUnits(tokenCost, 18). 
+        // If 1 unit = 1e18 wei, then revenue is 1.0
+        expect(result.economic.protocolUsdRevenue).toBeCloseTo(1.0);
+        
+        // Cost: $0.30
+        expect(result.economic.l1UsdCost).toBeCloseTo(0.30);
+        
+        // Profit: $0.70
+        expect(result.economic.protocolUsdProfit).toBeCloseTo(0.70);
+    });
+});

package/packages/analytics/tsconfig.json

@@ -1,7 +1,8 @@
 {
-  "extends": "../../tsconfig.json",
+  "extends": "../../tsconfig.build.json",
   "compilerOptions": {
     "outDir": "./dist",
+    "rootDir": "./src",
     "declaration": true,
     "declarationMap": true,
     "emitDeclarationOnly": false,

package/packages/community/__tests__/index.test.ts

@@ -0,0 +1,9 @@
+
+import { describe, it, expect } from 'vitest';
+import * as Exports from '../src/index';
+
+describe('Community Package Exports', () => {
+    it('should have exports', () => {
+        expect(Exports).toBeDefined();
+    });
+});

package/packages/community/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/tsc" "$@"
+fi

package/packages/community/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/typescript@5.7.2/node_modules:/Users/jason/Dev/mycelium/my-exploration/projects/aastar-sdk/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../../../../node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../../../../node_modules/.pnpm/typescript@5.7.2/node_modules/typescript/bin/tsserver" "$@"
+fi

package/packages/community/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.0.17","results":[[":__tests__/index.test.ts",{"duration":3.6658239999999296,"failed":false}]]}

package/packages/community/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@aastar/community",
+  "version": "0.16.11",
+  "description": "Community management client for AAstar SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "aastar",
+    "community",
+    "dao",
+    "web3"
+  ],
+  "author": "AAstar Team",
+  "license": "MIT",
+  "dependencies": {
+    "@aastar/core": "workspace:*",
+    "@aastar/tokens": "workspace:*",
+    "viem": "2.43.3"
+  },
+  "devDependencies": {
+    "typescript": "5.7.2"
+  }
+}