@aastar/sdk 0.16.11 → 0.16.14

package/dist/utils/userOp.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect } from 'vitest';
+import { UserOperationBuilder } from './userOp.js';
+import { concat } from 'viem';
+describe('UserOperationBuilder', () => {
+    const MOCK_ADDR = '0x1111111111111111111111111111111111111111';
+    const MOCK_PM = '0x2222222222222222222222222222222222222222';
+    const MOCK_TOKEN = '0x3333333333333333333333333333333333333333';
+    describe('Gas Packing', () => {
+        it('should pack account gas limits', () => {
+            const packed = UserOperationBuilder.packAccountGasLimits(100000n, 200000n);
+            expect(packed).toBeDefined();
+            expect(packed.length).toBeGreaterThan(2);
+        });
+        it('should pack gas fees', () => {
+            const packed = UserOperationBuilder.packGasFees(1000000000n, 2000000000n);
+            expect(packed).toBeDefined();
+            expect(packed.length).toBeGreaterThan(2);
+        });
+        it('should pack paymaster and data', () => {
+            const packed = UserOperationBuilder.packPaymasterAndData(MOCK_PM, 250000n, 50000n, '0x1234');
+            expect(packed).toBeDefined();
+            expect(packed.startsWith(MOCK_PM.toLowerCase())).toBe(true);
+        });
+        it('should pack PaymasterV4 deposit data', () => {
+            const validUntil = BigInt(Math.floor(Date.now() / 1000) + 3600);
+            const validAfter = BigInt(Math.floor(Date.now() / 1000));
+            const packed = UserOperationBuilder.packPaymasterV4DepositData(MOCK_PM, 250000n, 50000n, MOCK_TOKEN, validUntil, validAfter);
+            expect(packed).toBeDefined();
+            expect(packed.length).toBeGreaterThan(100);
+        });
+    });
+    describe('UserOp Formatting', () => {
+        it('should jsonify UserOp', () => {
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: 0n,
+                initCode: '0x',
+                callData: '0x',
+                accountGasLimits: UserOperationBuilder.packAccountGasLimits(100000n, 200000n),
+                preVerificationGas: 50000n,
+                gasFees: UserOperationBuilder.packGasFees(1000000000n, 2000000000n),
+                paymasterAndData: '0x',
+                signature: '0x'
+            };
+            const jsonified = UserOperationBuilder.jsonifyUserOp(userOp);
+            expect(jsonified).toBeDefined();
+            expect(jsonified.sender).toBe(MOCK_ADDR);
+        });
+        it('should convert to Alchemy format', () => {
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: '0x0',
+                initCode: '0x',
+                callData: '0x',
+                accountGasLimits: UserOperationBuilder.packAccountGasLimits(100000n, 200000n),
+                preVerificationGas: '0xc350',
+                gasFees: UserOperationBuilder.packGasFees(1000000000n, 2000000000n),
+                paymasterAndData: '0x', // no paymaster
+                signature: '0x'
+            };
+            const alchemy = UserOperationBuilder.toAlchemyUserOperation(userOp);
+            expect(alchemy).toBeDefined();
+            expect(alchemy.sender).toBe(MOCK_ADDR);
+            expect(alchemy.verificationGasLimit).toBeDefined();
+            expect(alchemy.callGasLimit).toBeDefined();
+        });
+        it('should unpack paymaster and data (full v0.7 format)', () => {
+            const pmData = UserOperationBuilder.packPaymasterAndData(MOCK_PM, 300000n, 100000n, '0x12345678');
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: '0x0',
+                initCode: '0x',
+                callData: '0x',
+                accountGasLimits: '0x',
+                preVerificationGas: '0x0',
+                gasFees: '0x',
+                paymasterAndData: pmData,
+                signature: '0x'
+            };
+            const alchemy = UserOperationBuilder.toAlchemyUserOperation(userOp);
+            expect(alchemy.paymaster).toBe(MOCK_PM);
+            expect(alchemy.paymasterVerificationGasLimit).toBeDefined();
+            expect(alchemy.paymasterPostOpGasLimit).toBeDefined();
+            expect(alchemy.paymasterData).toBe('0x12345678');
+        });
+        it('should unpack paymaster and data (legacy format fallback)', () => {
+            // Not enough bytes for Gas Limits, treated as paymaster + data
+            const legacyPmData = concat([MOCK_PM, '0xabcdef']);
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: '0x0',
+                initCode: '0x',
+                callData: '0x',
+                accountGasLimits: '0x',
+                preVerificationGas: '0x0',
+                gasFees: '0x',
+                paymasterAndData: legacyPmData,
+                signature: '0x'
+            };
+            const alchemy = UserOperationBuilder.toAlchemyUserOperation(userOp);
+            expect(alchemy.paymaster).toBe(MOCK_PM);
+            expect(alchemy.paymasterData).toBe('0xabcdef');
+            expect(alchemy.paymasterVerificationGasLimit).toBeDefined(); // defaults
+        });
+        it('should unpack initCode into factory and factoryData', () => {
+            const factory = MOCK_ADDR;
+            const factoryData = '0xdeadbeef';
+            const initCode = concat([factory, factoryData]);
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: '0x0',
+                initCode: initCode,
+                callData: '0x',
+                accountGasLimits: '0x',
+                preVerificationGas: '0x0',
+                gasFees: '0x',
+                paymasterAndData: '0x',
+                signature: '0x'
+            };
+            const alchemy = UserOperationBuilder.toAlchemyUserOperation(userOp);
+            expect(alchemy.factory.toLowerCase()).toBe(factory.toLowerCase());
+            expect(alchemy.factoryData).toBe(factoryData);
+        });
+        it('should jsonify various types', () => {
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: 123, // number
+                initCode: '0x',
+                callData: '0x',
+                accountGasLimits: '0x',
+                preVerificationGas: '0x10', // string
+                gasFees: '0x',
+                paymasterAndData: '0x',
+                signature: '0x'
+            };
+            const json = UserOperationBuilder.jsonifyUserOp(userOp);
+            expect(json.nonce).toBe('0x7b');
+            expect(json.preVerificationGas).toBe('0x10');
+        });
+        it('should handle leading zeros in string quantities for Alchemy', () => {
+            const userOp = {
+                sender: MOCK_ADDR,
+                nonce: '0x0001', // leading zeros
+                preVerificationGas: '0x0', // valid zero
+                // ... others
+            };
+            const json = UserOperationBuilder.jsonifyUserOp(userOp);
+            expect(json.nonce).toBe('0x1'); // compact
+            expect(json.preVerificationGas).toBe('0x0');
+        });
+    });
+});

package/package.json

@@ -1,70 +1,34 @@
 {
   "name": "@aastar/sdk",
-  "version": "0.16.11",
-  "private": false,
+  "version": "0.16.14",
+  "description": "AAStar SDK - The all-in-one package for Mycelium Network",
   "type": "module",
-  "workspaces": [
-    "packages/*"
-  ],
-  "devDependencies": {
-    "@types/jest": "30.0.0",
-    "@types/node": "20.11.5",
-    "@typescript-eslint/eslint-plugin": "8.50.1",
-    "@typescript-eslint/parser": "8.50.1",
-    "@vitest/coverage-v8": "4.0.17",
-    "cross-env": "10.1.0",
-    "dotenv": "17.2.3",
-    "eslint": "9.39.2",
-    "jest": "30.2.0",
-    "ts-jest": "29.4.6",
-    "ts-node": "10.9.2",
-    "tsx": "4.21.0",
-    "typedoc": "^0.28.15",
-    "typedoc-plugin-markdown": "^4.9.0",
-    "typescript": "5.6.3",
-    "vitest": "4.0.17"
+  "publishConfig": {
+    "access": "public"
   },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "dependencies": {
-    "@noble/bls12-381": "1.4.0",
-    "@noble/curves": "^1.9.7",
-    "abstractionkit": "0.2.30",
-    "axios": "1.13.2",
-    "cheerio": "1.1.2",
-    "csv-writer": "1.6.0",
-    "permissionless": "0.3.2",
-    "viem": "2.43.3"
+    "viem": "2.43.3",
+    "@aastar/account": "0.16.14",
+    "@aastar/enduser": "0.16.14",
+    "@aastar/dapp": "0.16.14",
+    "@aastar/identity": "0.16.14",
+    "@aastar/paymaster": "0.16.14",
+    "@aastar/tokens": "0.16.14",
+    "@aastar/core": "0.16.14"
+  },
+  "devDependencies": {
+    "typescript": "5.7.2"
   },
   "scripts": {
-    "build": "pnpm -r build",
-    "test": "pnpm -r test",
-    "test:coverage": "vitest run --coverage",
-    "test:fast": "ts-node scripts/99_bug_hunting_fast.ts",
-    "test:init": "bash run_full_regression.sh init",
-    "test:admin": "ts-node scripts/10_test_protocol_admin_full.ts",
-    "test:credit": "ts-node scripts/14_test_credit_redesign.ts",
-    "test:reentrancy": "ts-node scripts/98_edge_reentrancy.ts",
-    "test:full_anvil": "bash run_sdk_regression.sh",
-    "test:full_sdk": "bash run_sdk_regression.sh sdk",
-    "audit": "pnpm audit --audit-level=moderate",
-    "audit:fix": "pnpm audit --fix",
-    "audit:abi": "tsx scripts/analyze_abi_coverage.ts",
-    "security:check": "bash scripts/security_audit.sh",
-    "security:full": "pnpm audit && bash scripts/security_audit.sh",
-    "precommit": "pnpm security:check",
-    "example:local": "pnpm --filter @aastar/sdk run example:local",
-    "sync-config": "cp ../SuperPaymaster/script/v3/config.json ./packages/sdk/examples/config.json",
-    "lint": "pnpm -r lint",
-    "version:update": "bash update-version.sh",
-    "test:env": "tsx scripts/validate_env.ts",
-    "test:regression": "pnpm run test:regression:00 && pnpm run test:regression:01 && pnpm run test:regression:02 && pnpm run test:regression:03 && pnpm run test:regression:04 && pnpm run test:regression:05 && pnpm run test:regression:bls",
-    "test:regression:00": "tsx scripts/v2_regression/00_validate_env.ts",
-    "test:regression:01": "tsx scripts/v2_regression/01_setup_and_fund.ts",
-    "test:regression:02": "tsx scripts/v2_regression/02_operator_onboarding.ts",
-    "test:regression:03": "tsx scripts/v2_regression/03_community_registry.ts",
-    "test:regression:04": "tsx scripts/v2_regression/04_enduser_flow.ts",
-    "test:regression:05": "tsx scripts/v2_regression/05_admin_audit.ts",
-    "test:regression:bls": "ts-node scripts/15_test_bls_full.ts",
-    "docs:generate": "typedoc --options typedoc.json",
-    "docs:sync": "bash scripts/extract-docs.sh"
+    "clean": "find src -name '*.js' -o -name '*.d.ts' -o -name '*.map' | xargs rm -f",
+    "prebuild": "pnpm clean",
+    "build": "tsc",
+    "example:local": "tsx examples/regression_test.ts",
+    "test": "vitest run"
   }
 }

package/.github/workflows/gas-analytics-daily.yml

@@ -1,52 +0,0 @@
-name: Gas Analytics Daily Report
-
-on:
-  schedule:
-    # Run every day at 00:00 UTC
-    - cron: '0 0 * * *'
-  workflow_dispatch: # Allow manual trigger
-
-jobs:
-  analyze-and-report:
-    runs-on: ubuntu-latest
-    
-    env:
-      SEPOLIA_RPC_URL: ${{ secrets.SEPOLIA_RPC_URL }}
-      PRIVATE_KEY_SUPPLIER: ${{ secrets.PRIVATE_KEY_SUPPLIER }} # Needed if any tx is required, though analysis is read-only usually
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'pnpm'
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v3
-        with:
-          version: 8
-
-      - name: Install Dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Fetch External Data
-        # Ensure we have the latest benchmarks
-        run: npx tsx packages/analytics/src/gas-analyzer-v4.ts --fetch-only || true
-
-      - name: Generate Gas Analytics Report
-        run: |
-          mkdir -p packages/analytics/reports/daily
-          REPORT_NAME="gas_report_$(date +%Y%m%d).md"
-          npx tsx packages/analytics/src/gas-analyzer-v4.ts > packages/analytics/reports/daily/$REPORT_NAME
-          
-          # Also update the latest summary
-          cp packages/analytics/reports/daily/$REPORT_NAME packages/analytics/reports/LATEST.md
-
-      - name: Commit and Push Report
-        uses: stefanzweifel/git-auto-commit-action@v5
-        with:
-          commit_message: "chore(analytics): generate daily gas report [skip ci]"
-          file_pattern: 'packages/analytics/reports/**'

package/.gitmodules

@@ -1,9 +0,0 @@
-[submodule "ext/aastar-shared-config"]
-	path = ext/aastar-shared-config
-	url = https://github.com/AAStarCommunity/aastar-shared-config
-[submodule "ext/permissionless.js"]
-	path = ext/permissionless.js
-	url = https://github.com/pimlicolabs/permissionless.js
-[submodule "lib/shared-config"]
-	path = lib/shared-config
-	url = https://github.com/AAStarCommunity/aastar-shared-config.git

package/CHANGELOG.md

@@ -1,43 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [0.16.11] - 2026-01-19
-
-### 📊 Gas Analytics & Reporting (New Package)
-- **[NEW]** Added `@aastar/analytics` package for comprehensive gas analysis.
-- **[FEATURE]** `CostCalculator`: Calculates true L1/L2 gas costs, protocol profit (10% premium + buffer), and user savings.
-- **[FEATURE]** `AttributionAnalyzer`: Simulates L2 costs (Optimism model) to provide "Apple-to-Apple" competitiveness comparisons.
-- **[REPORT]** `gas-analyzer-v4.ts`: Generates detailed reports showing ~28% protocol profit margin and ~400x savings vs. Ethereum L1.
-
-### SDK & Core Enhancements
-- **[FIX]** **Anni Gasless Fix**: Updated `l4-setup.ts` to use `updatePriceDVT` for refreshing stale SuperPaymaster price cache, preventing "UserOperation expired" errors.
-- **[FIX]** **Duplicate Build Fix**: Resolved merge conflicts and duplicate identifiers in `packages/core` actions (e.g., `contracts.ts`, `actions/index.ts`).
-- **[FIX]** **Build System**: Removed residual `*.test.ts` files in modification directories to ensure clean `tsc` builds.
-
-### Regression & Testing
-- **[IMPROVED]** `L4 Regression`: Full automation for Setup -> Funding -> Gasless Transactions -> Analytics.
-- **[FEATURE]** `DVT Price Update`: Integrated DVT signature generation in test setup to simulate authenticated price updates.
-
-- **[BREAKING]** Decoupled development and production build configurations.
-  - Added `tsconfig.build.json` for strictly clean production builds (`pnpm build`).
-  - Updated root `tsconfig.json` to retain `paths` mappings for rapid development (`tsx`).
-  - Updated all `packages/*/tsconfig.json` to extend the build configuration.
-- Fixed `packages/core` build output to correctly generate type definitions (`.d.ts`).
-
-### SDK Core (`@aastar/core`)
-- **[CHANGED]** `BaseClient` visibility update.
-  - Changed `client` and `getStartPublicClient` from `protected` to `public` to allow easier extension and debugging in consuming applications.
-- **[Check]** Standardized ABI exports.
-  - Updated `abis/index.ts` to support both array-based and object-based (`{ abi: [] }`) ABI JSON formats, resolving compatibility issues with external artifacts.
-
-### SDK Operator (`@aastar/operator`)
-- **[FIXED]** ABI Property Access.
-  - Fixed runtime error where `PaymasterOperatorClient` attempted to access `.abi` on a raw ABI array. Now uses the standardized `PaymasterABI` export.
-
-### SDK EndUser (`@aastar/enduser`)
-- **[FIXED]** `UserClient` build failure due to `BaseClient` visibility issues.
-
-### Testing & Regression
-- **[ADDED]** `run_sdk_regression.sh` now supports a strict `sepolia` environment mode with correct `.env` loading (`set -a`).
-- **[ADDED]** `extract_v3_abis.sh` integration for reliable ABI synchronization from the SuperPaymaster project.

package/aastar-sdk.code-workspace

@@ -1,14 +0,0 @@
-{
-	"folders": [
-		{
-			"path": "."
-		},
-		{
-			"path": "../DSR-Research-Flow"
-		},
-		{
-			"path": "../SuperPaymaster"
-		}
-	],
-	"settings": {}
-}