@aastar/sdk 0.16.11 → 0.16.12

package/README.md

@@ -1,161 +1,140 @@
-# AAStar SDK (Mycelium Network)
+# AAstar SDK
 
-<p align="left">
-  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" style="display:inline-block; margin-right: 10px;" />
-  <img src="https://img.shields.io/badge/TypeScript-5.0-blue" alt="TypeScript" style="display:inline-block; margin-right: 10px;" />
-  <img src="https://img.shields.io/badge/Status-0.14.0-green" alt="Status" style="display:inline-block;" />
-</p>
+The ultimate TypeScript SDK for the AAstar Protocol - a decentralized, community-driven Account Abstraction ecosystem.  
+AAstar 协议的终极 TypeScript SDK —— 构建去中心化、社区驱动的账户抽象生态系统。
 
-**Comprehensive Account Abstraction Infrastructure SDK - Powering the Mycelium Network**
-**完整的账户抽象基础设施 SDK - 为 Mycelium 网络提供动力**
+[![npm version](https://img.shields.io/npm/v/@aastar/sdk.svg)](https://www.npmjs.com/package/@aastar/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 ---
 
-## 📚 Contents / 目录
-
-- [AAStar SDK (Mycelium Network)](#aastar-sdk-mycelium-network)
-  - [📚 Contents / 目录](#-contents--目录)
-  - [Introduction / 简介](#introduction--简介)
-    - [Core Features / 核心特性](#core-features--核心特性)
-  - [SDK v2 Architecture / 架构设计](#sdk-v2-architecture--架构设计)
-  - [Installation / 安装](#installation--安装)
-  - [Quick Start / 快速开始](#quick-start--快速开始)
-    - [End User Gasless Transaction / 终端用户 Gasless 流程](#end-user-gasless-transaction--终端用户-gasless-流程)
-  - [Testing Commands / 测试命令](#testing-commands--测试命令)
-    - [SDK Regression (Using SDK Clients)](#sdk-regression-using-sdk-clients)
-    - [Full Protocol Regression (Anvil Dedicated)](#full-protocol-regression-anvil-dedicated)
-  - [Academic Research / 学术研究](#academic-research--学术研究)
-  - [Support / 支援](#support--支援)
-
----
-
-## Introduction / 简介
-
-**AAStar SDK** is a high-integration toolkit for the Mycelium network. We've refactored 17 fragmented modules into 7 professional core packages, providing a unified, high-performance, and easy-to-maintain development experience.
+## 🌟 Introduction | 简介
 
-**AAStar SDK** 是 Mycelium 网络的高集成度开发工具包。我们将原有的 17 个碎片化模块重构为 7 个专业核心包，旨在提供统一、高性能且易于维护的开发体验。
+AAstar SDK provides a complete suite of tools to interact with the AAstar Protocol. It is designed with a **"Pre-check first, Action second"** philosophy, helping developers build robust dApps with minimal errors.
 
-### Core Features / 核心特性
+AAstar SDK 提供了一套完整的工具集用于交互 AAstar 协议。它采用了 **"先检查，后执行"** 的设计理念，帮助开发者构建低错误率、健壮的去中心化应用。
 
-- ✅ **Role-Based Clients**: Specific APIs for End Users, Communities, Operators, and Admins. (**角色化客户端**)
-- ✅ **Infrastructure Ready**: Deep integration with SuperPaymaster and EOA Bridge. (**基础设施就绪**)
-- ✅ **Seamless User Experience**: Gasless transactions via community credit system. (**无感交互体验**)
-- ✅ **DVT Security Module**: Decentralized verification and aggregate signatures. (**DVT 安全模块**)
-- ✅ **Scientific Reproducibility**: Version-locked for academic research. (**科学可复现**)
+### Core Modules | 核心模块
 
----
-
-## SDK v2 Architecture / 架构设计
-
-AAStar SDK v2 采用 **「装饰器 (Actions-Decorator)」** 模式。它将低层次的合约交互与高层次的业务逻辑解耦，为生态系统中的四种角色提供专属的 Client 封装。
-
-| Client / 客户端 | Targeted Developer / 目标开发者 | Core Responsibility / 核心职责 |
-| :--- | :--- | :--- |
-| **`EndUserClient`** | dApp Developer | Gasless UX, Smart Account management, Credit queries |
-| **`CommunityClient`** | Community/DAO Admin | Auto-onboarding, xPNTs deployment, SBT & Reputation |
-| **`OperatorClient`** | Node/Operator | SuperPaymaster registration, Staking, Pool management |
-| **`AdminClient`** | Protocol Admin | DVT aggregations, Slashing, Global parameters |
+- **`@aastar/community`**: Launch & manage DAOs. (启动和管理 DAO)
+- **`@aastar/operator`**: Run Paymasters & earn rewards. (运行 Paymaster 并赚取收益)
+- **`@aastar/enduser`**: Join communities & enjoy gasless txs. (加入社区并享受免 Gas 交易)
+- **`@aastar/analytics`**: Monitor ecosystem data. (监控生态系统数据)
+- **`@aastar/tokens`**: GToken & XPNTs finance tools. (GToken 和 XPNTs 金融工具)
+- **`@aastar/identity`**: Reputation & SBT management. (声誉和 SBT 管理)
+- **`@aastar/account`**: Smart Account (ERC-4337) utilities. (智能账户工具)
 
 ---
 
-## Installation / 安装
+## 📦 Installation | 安装
 
 ```bash
-pnpm install @aastar/sdk @aastar/core viem
+pnpm add @aastar/sdk viem
+# or
+npm install @aastar/sdk viem
 ```
 
 ---
 
-## Quick Start / 快速开始
+## 🚀 Usage | 使用指南
 
-### End User Gasless Transaction / 终端用户 Gasless 流程
+### 1. Initialize Client | 初始化客户端
 
 ```typescript
-import { createEndUserClient } from '@aastar/sdk';
+import { createPublicClient, createWalletClient, http } from 'viem';
+import { sepolia } from 'viem/chains';
+import { CommunityClient, OperatorClient } from '@aastar/sdk';
 
-const user = createEndUserClient({ 
-  account, 
-  paymasterUrl: 'https://paymaster.aastar.io' 
-});
+// 1. Setup VIEM clients
+const publicClient = createPublicClient({ chain: sepolia, transport: http() });
+const walletClient = createWalletClient({ chain: sepolia, transport: http() });
 
-// Send sponsored transaction / 使用社区信用代付 Gas
-await user.sendGaslessTransaction({
-  to: TARGET_ADDR,
-  data: CALL_DATA
-});
+// 2. Initialize AAstar Clients
+const communityClient = new CommunityClient(publicClient, walletClient);
+const operatorClient = new OperatorClient(publicClient, walletClient);
 ```
 
----
+### 2. "Pre-check" Pattern | "预检查" 模式
 
-## Testing Commands / 测试命令
+Avoid reverts and save gas by checking requirements off-chain first.  
+通过链下预检查避免交易回滚并节省 Gas。
 
-### SDK Regression (Using SDK Clients)
-```bash
-pnpm run test:full_sdk
+```typescript
+// ❌ Old Way (Prone to errors)
+// await communityClient.launchCommunity(...); 
+
+// ✅ New AAstar Way
+const check = await communityClient.checkLaunchRequirements(myAddress, parseEther("33"));
+
+if (!check.hasEnoughGToken) {
+    console.error(`Missing Requirements: ${check.missingRequirements.join(', ')}`);
+    // Output: "Need 33 GT, have 10 GT"
+} else {
+    // Safe to execute
+    await communityClient.launchCommunity({
+        name: "My DAO",
+        tokenSymbol: "MDAO"
+    });
+}
 ```
 
+### 3. Key Scenarios | 核心场景
 
-### Full Protocol Regression (Anvil Dedicated)
-```bash
-pnpm run test:full_anvil
-```
+#### 🏛️ For Community Owners (社区创建者)
 
----
+```typescript
+// Configure SBT rules for your community
+await communityClient.configureSBTRules({
+    communityId: myCommunityId,
+    rule: {
+        minScore: 100,
+        requiredTags: ["OG"]
+    }
+});
+```
 
-## Development Guides / 开发指南
+#### ⚙️ For Operators (运营商)
 
-### ABI Maintenance / ABI 维护
-- [ABI Maintenance Plan](./docs/ABI_MAINTENANCE_PLAN.md) - 合约 ABI 自动同步和维护策略
+```typescript
+// Check if you are ready to be a Super Paymaster
+const status = await operatorClient.checkResources(myAddress);
+
+if (status.hasRole) {
+    await operatorClient.withdrawCollateral(parseEther("50"));
+} else {
+    console.log(status.recommendations); 
+    // "Fund aPNTs for collateral", "Stake GToken"
+}
+```
 
----
+#### 📊 For Analysts (分析师)
 
-## Development Workflow / 开发者工作流
+```typescript
+import { AnalyticsClient } from '@aastar/sdk';
 
-A step-by-step guide for contributors from contract modification to Sepolia deployment.
+const analytics = new AnalyticsClient(publicClient);
 
-### Step 1: Modify Contracts / 修改合约
-Edit Solidity files in `superpaymaster/contracts/src`.
-```bash
-cd projects/SuperPaymaster
-# Edit .sol files...
+// Get real-time GToken metrics
+const metrics = await analytics.getSupplyMetrics();
+console.log(`Deflation Rate: ${metrics.deflationRate}%`);
 ```
 
-### Step 2: Local Build & Deploy (Anvil) / 本地构建与部署
-Auto-start Anvil, compile contracts, deploy, and sync config to SDK.
-```bash
-cd projects/aastar-sdk
-# Runs Anvil + Deploy + Sync .env.anvil
-./run_full_regression.sh --env anvil
-```
+---
 
-### Step 3: Run Local Tests / 运行本地测试
-Validate your changes with the full regression suite.
-```bash
-# Run all SDK & Protocol tests
-./run_sdk_regression.sh
-```
+## 🔧 Architecture | 架构
 
-### Step 4: Deploy to Sepolia / 部署至 Sepolia
-1. Configure `aastar-sdk/.env.sepolia` with `ADMIN_KEY` and `SEPOLIA_RPC_URL`.
-2. Run the deployment script (with resume capability).
-```bash
-cd projects/SuperPaymaster/contracts
-# Deploy Core + Modules
-export $(grep -v '^#' ../../aastar-sdk/.env.sepolia | xargs) && \
-export PRIVATE_KEY=$ADMIN_KEY && \
-forge script script/DeployV3FullSepolia.s.sol \
-  --rpc-url $SEPOLIA_RPC_URL \
-  --broadcast --verify --slow --resume
-```
-3. Update `aastar-sdk/.env.sepolia` with new contract addresses from `script/v3/config.json`.
+AAstar SDK is built on top of **viem**, ensuring lightweight and type-safe interactions. It abstracts complex contract logic into intuitive business primitives.
 
-### Step 5: Verify on Sepolia / Sepolia 验证
-Run the regression suite against the live testnet.
-```bash
-cd projects/aastar-sdk
-./run_full_regression.sh --env sepolia
-```
+AAstar SDK 基于 **viem** 构建，确保轻量级和类型安全的交互。它将复杂的合约逻辑抽象为直观的业务原语。
 
+| Package | Functionality (功能) |
+|---------|---------------------|
+| `@aastar/core` | Shared logic, Roles, RequirementChecker |
+| `@aastar/community` | DAO Registry, XPNTs issuance |
+| `@aastar/operator` | Paymaster ops, Staking management |
+| `@aastar/enduser` | User onboarding, SBT minting |
+| `@aastar/tokens` | Finance, Tokenomics, Approval flows |
+| `@aastar/identity` | Reputation, Credit limits, ZK Proofs |
 
 ---
 
@@ -180,20 +159,13 @@ npx tsx packages/analytics/src/gas-analyzer-v4.ts
 
 ---
 
-## Academic Research / 学术研究
-
-The SDK supports doctoral data collection for the SuperPaymaster paper. Official experiment logger is available at `scripts/19_sdk_experiment_runner.ts`.
+## 🤝 Contributing | 贡献
 
-本 SDK 支撑了 SuperPaymaster 论文的博士实验数据采集。官方实验记录器位于 `scripts/19_sdk_experiment_runner.ts`。
-
-- [Stage 3 Scenario Experiment Plan](./docs/STAGE_3_SCENARIO_EXP_PLAN.md)
-- [Reputation-to-Credit Mapping Whitepaper](./docs/Reputation-to-Credit_Mapping_Whitepaper.md) - 声誉与信用体系映射技术白皮书
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.  
+欢迎贡献！更多详情请参考 [贡献指南](CONTRIBUTING.md)。
 
 ---
 
-## Support / 支援
-
-- **Documentation**: [docs.aastar.io](https://docs.aastar.io)
-- **GitHub**: [AAStarCommunity/aastar-sdk](https://github.com/AAStarCommunity/aastar-sdk)
-
-MIT © AAStar Community
+<p align="center">
+  Built with ❤️ by the AAstar Community
+</p>

package/dist/clients/ExperimentClient.d.ts

@@ -0,0 +1,34 @@
+import { Hash } from 'viem';
+export interface ExperimentRecord {
+    id: string;
+    scenario: string;
+    group: 'EOA' | 'AA' | 'SuperPaymaster';
+    txHash: string;
+    gasUsed: bigint;
+    gasPrice: bigint;
+    costETH: string;
+    status: 'Success' | 'Failed';
+    timestamp: number;
+    meta?: any;
+}
+/**
+ * ExperimentClient: Business-layer tool for measuring and recording execution metrics
+ */
+export declare class ExperimentClient {
+    private records;
+    private scenarioId;
+    private group;
+    constructor(scenarioId: string, group: 'EOA' | 'AA' | 'SuperPaymaster');
+    /**
+     * Record a transaction result
+     */
+    recordTx(txHash: Hash, receipt: {
+        gasUsed: any;
+        effectiveGasPrice: any;
+    }, status: 'Success' | 'Failed', meta?: any): ExperimentRecord;
+    /**
+     * Measure an async task (transaction) automatically
+     */
+    measureTx(taskName: string, txPromise: Promise<Hash>, publicClient: any): Promise<Hash>;
+    getRecords(): ExperimentRecord[];
+}

package/{packages/sdk/src/clients/ExperimentClient.ts → dist/clients/ExperimentClient.js}

@@ -1,40 +1,23 @@
-import { Hash, formatEther } from 'viem';
-
-export interface ExperimentRecord {
-    id: string;
-    scenario: string;
-    group: 'EOA' | 'AA' | 'SuperPaymaster';
-    txHash: string;
-    gasUsed: bigint;
-    gasPrice: bigint;
-    costETH: string;
-    status: 'Success' | 'Failed';
-    timestamp: number;
-    meta?: any;
-}
-
+import { formatEther } from 'viem';
 /**
  * ExperimentClient: Business-layer tool for measuring and recording execution metrics
  */
 export class ExperimentClient {
-    private records: ExperimentRecord[] = [];
-    private scenarioId: string;
-    private group: 'EOA' | 'AA' | 'SuperPaymaster';
-
-    constructor(scenarioId: string, group: 'EOA' | 'AA' | 'SuperPaymaster') {
+    records = [];
+    scenarioId;
+    group;
+    constructor(scenarioId, group) {
         this.scenarioId = scenarioId;
         this.group = group;
     }
-
     /**
      * Record a transaction result
      */
-    public recordTx(txHash: Hash, receipt: { gasUsed: any, effectiveGasPrice: any }, status: 'Success' | 'Failed', meta?: any) {
+    recordTx(txHash, receipt, status, meta) {
         const gasUsed = BigInt(receipt.gasUsed || 0);
         const gasPrice = BigInt(receipt.effectiveGasPrice || 0);
         const costBN = gasUsed * gasPrice;
-        
-        const record: ExperimentRecord = {
+        const record = {
             id: `${Date.now()}-${Math.floor(Math.random() * 1000)}`,
             scenario: this.scenarioId,
             group: this.group,
@@ -46,35 +29,30 @@ export class ExperimentClient {
             timestamp: Date.now(),
             meta
         };
-        
         this.records.push(record);
         return record;
     }
-
     /**
      * Measure an async task (transaction) automatically
      */
-    public async measureTx(taskName: string, txPromise: Promise<Hash>, publicClient: any): Promise<Hash> {
+    async measureTx(taskName, txPromise, publicClient) {
         console.log(`[Experiment: ${this.group}] Executing: ${taskName}...`);
         const start = Date.now();
         try {
             const hash = await txPromise;
             const receipt = await publicClient.waitForTransactionReceipt({ hash });
-            
             this.recordTx(hash, receipt, 'Success', { latency: Date.now() - start });
-            
             const gasUsed = BigInt(receipt.gasUsed || 0);
             const gasPrice = BigInt(receipt.effectiveGasPrice || 0);
-            
             console.log(`   ✅ Success! Gas: ${gasUsed} | Cost: ${formatEther(gasUsed * gasPrice)} ETH`);
             return hash;
-        } catch (e: any) {
+        }
+        catch (e) {
             console.error(`   ❌ Failed: ${taskName}`, e);
             throw e;
         }
     }
-
-    public getRecords() {
+    getRecords() {
         return this.records;
     }
 }

package/dist/clients/ExperimentClient.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clients/ExperimentClient.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect, vi } from 'vitest';
+import { ExperimentClient } from './ExperimentClient.js';
+describe('ExperimentClient', () => {
+    it('should record transaction result', () => {
+        const client = new ExperimentClient('test-scenario', 'AA');
+        const receipt = { gasUsed: 21000n, effectiveGasPrice: 1000000000n };
+        const record = client.recordTx('0xhash', receipt, 'Success');
+        expect(record.txHash).toBe('0xhash');
+        expect(record.group).toBe('AA');
+        expect(record.status).toBe('Success');
+        expect(record.costETH).toBe('0.000021');
+        expect(client.getRecords()).toHaveLength(1);
+    });
+    it('should measure transaction automatically', async () => {
+        const client = new ExperimentClient('test-scenario', 'SuperPaymaster');
+        const mockPublicClient = {
+            waitForTransactionReceipt: vi.fn().mockResolvedValue({
+                gasUsed: 50000n,
+                effectiveGasPrice: 2000000000n
+            })
+        };
+        const txPromise = Promise.resolve('0xhash');
+        const hash = await client.measureTx('test-task', txPromise, mockPublicClient);
+        expect(hash).toBe('0xhash');
+        expect(client.getRecords()).toHaveLength(1);
+        expect(client.getRecords()[0].status).toBe('Success');
+    });
+    it('should handle failed measureTx', async () => {
+        const client = new ExperimentClient('test-scenario', 'EOA');
+        const txPromise = Promise.reject(new Error('tx failed'));
+        await expect(client.measureTx('test-task', txPromise, {})).rejects.toThrow('tx failed');
+    });
+    it('should handle missing gas fields in receipt', () => {
+        const client = new ExperimentClient('test-scenario', 'AA');
+        const record = client.recordTx('0xhash', {}, 'Success');
+        expect(record.gasUsed).toBe(0n);
+        expect(record.gasPrice).toBe(0n);
+        expect(record.costETH).toBe('0');
+    });
+    it('should record latency in measureTx', async () => {
+        const client = new ExperimentClient('test-scenario', 'AA');
+        const mockPublicClient = {
+            waitForTransactionReceipt: vi.fn().mockResolvedValue({
+                gasUsed: 21000n,
+                effectiveGasPrice: 1000000000n
+            })
+        };
+        await client.measureTx('test', Promise.resolve('0xhash'), mockPublicClient);
+        const record = client.getRecords()[0];
+        expect(record.meta?.latency).toBeDefined();
+        expect(typeof record.meta.latency).toBe('number');
+    });
+});

package/dist/clients/admin.d.ts

@@ -0,0 +1,11 @@
+import { type Client, type Transport, type Chain, type Account, type PublicActions, type WalletActions, type Address } from 'viem';
+import { type RegistryActions, type SuperPaymasterActions, type PaymasterActions, type StakingActions, type SBTActions, type DVTActions, type XPNTsFactoryActions, type AggregatorActions } from '@aastar/core';
+export type AdminClient = Client<Transport, Chain, Account | undefined> & PublicActions<Transport, Chain, Account | undefined> & WalletActions<Chain, Account | undefined> & RegistryActions & SuperPaymasterActions & PaymasterActions & StakingActions & SBTActions & DVTActions & XPNTsFactoryActions & AggregatorActions;
+export declare function createAdminClient({ chain, transport, account, addresses }: {
+    chain: Chain;
+    transport: Transport;
+    account?: Account;
+    addresses?: {
+        [key: string]: Address;
+    };
+}): AdminClient;

package/dist/clients/admin.js

@@ -0,0 +1,20 @@
+import { createClient, publicActions, walletActions } from 'viem';
+import { registryActions, superPaymasterActions, paymasterActions, stakingActions, sbtActions, dvtActions, xPNTsFactoryActions, aggregatorActions, CORE_ADDRESSES, TOKEN_ADDRESSES } from '@aastar/core';
+const ADDRESS_PLACEHOLDER = '0x0000000000000000000000000000000000000000';
+export function createAdminClient({ chain, transport, account, addresses }) {
+    const baseClient = createClient({ chain, transport, account })
+        .extend(publicActions)
+        .extend(walletActions);
+    const usedAddresses = { ...CORE_ADDRESSES, ...TOKEN_ADDRESSES, ...addresses };
+    const actions = {
+        ...registryActions(usedAddresses.registry)(baseClient),
+        ...superPaymasterActions(usedAddresses.superPaymaster)(baseClient),
+        ...paymasterActions(usedAddresses.paymasterV4)(baseClient),
+        ...stakingActions(usedAddresses.gTokenStaking)(baseClient),
+        ...sbtActions(usedAddresses.mySBT)(baseClient),
+        ...dvtActions(ADDRESS_PLACEHOLDER)(baseClient),
+        ...xPNTsFactoryActions(usedAddresses.xPNTsFactory || '0x')(baseClient),
+        ...aggregatorActions(ADDRESS_PLACEHOLDER)(baseClient),
+    };
+    return Object.assign(baseClient, actions);
+}

package/dist/clients/admin.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clients/admin.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createAdminClient } from './admin.js';
+import { mainnet } from 'viem/chains';
+import { http } from 'viem';
+describe('AdminClient', () => {
+    const MOCK_ADDR = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266';
+    it('should create admin client and access modules', () => {
+        const client = createAdminClient({ chain: mainnet, transport: http() });
+        expect(client.system).toBeDefined();
+        expect(client.finance).toBeDefined();
+        expect(client.operators).toBeDefined();
+    });
+    describe('SystemModule', () => {
+        it('should grant role', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.registryRegisterRole = spy;
+            const hash = await client.system.grantRole({ roleId: '0x1', user: MOCK_ADDR, data: '0x' });
+            expect(hash).toBe('0xhash');
+            expect(spy).toHaveBeenCalled();
+        });
+        it('should revoke role', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.registryUnRegisterRole = spy;
+            const hash = await client.system.revokeRole({ roleId: '0x1', user: MOCK_ADDR });
+            expect(hash).toBe('0xhash');
+            expect(spy).toHaveBeenCalled();
+        });
+        it('should set super paymaster', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.registrySetSuperPaymaster = spy;
+            const hash = await client.system.setSuperPaymaster(MOCK_ADDR);
+            expect(hash).toBe('0xhash');
+        });
+    });
+    describe('FinanceModule', () => {
+        it('should deposit', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.superPaymasterDeposit = spy;
+            const hash = await client.finance.deposit({ amount: 100n });
+            expect(hash).toBe('0xhash');
+        });
+        it('should depositForOperator', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.superPaymasterDepositFor = spy;
+            const hash = await client.finance.depositForOperator({ operator: MOCK_ADDR, amount: 100n });
+            expect(hash).toBe('0xhash');
+        });
+        it('should withdrawTo', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.superPaymasterWithdrawTo = spy;
+            const hash = await client.finance.withdrawTo({ to: MOCK_ADDR, amount: 100n });
+            expect(hash).toBe('0xhash');
+        });
+    });
+    describe('OperatorsModule', () => {
+        it('should ban/unban operator', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.registryUpdateOperatorBlacklist = spy;
+            await client.operators.ban(MOCK_ADDR);
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({ statuses: [true] }));
+            await client.operators.unban(MOCK_ADDR);
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({ statuses: [false] }));
+        });
+        it('should setPaused', async () => {
+            const client = createAdminClient({ chain: mainnet, transport: http() });
+            const spy = vi.fn().mockResolvedValue('0xhash');
+            client.superPaymasterSetOperatorPaused = spy;
+            await client.operators.setPaused(MOCK_ADDR, true);
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({ paused: true }));
+        });
+    });
+});

package/dist/clients/clients.test.d.ts

@@ -0,0 +1 @@
+export {};