@aastar/sdk 0.16.22 → 0.17.0

package/README.md

@@ -48,6 +48,7 @@ npm install @aastar/sdk viem
 - **Configuration Sync**: https://docs.aastar.io/guide/docs/Configuration_Sync
 - **Regression Testing**: https://docs.aastar.io/guide/docs/Regression_Testing_Guide
 - **Gasless Tester Guide**: https://docs.aastar.io/guide/docs/TESTER_GUIDE_GASLESS
+- **Price Keeper Guide**: [docs/guide/keeper.md](../../docs/guide/keeper.md)
 
 ---
 

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from './clients/ExperimentClient.js';
 export * from '@aastar/enduser';
 export * from '@aastar/operator';
 export * from '@aastar/admin';
+export * as AirAccount from '@aastar/airaccount';
 export * from './utils/roleData.js';
 export * from './utils/keys.js';
 export * from './utils/funding.js';

package/dist/index.js

@@ -15,6 +15,8 @@ export * from './clients/ExperimentClient.js';
 export * from '@aastar/enduser';
 export * from '@aastar/operator';
 export * from '@aastar/admin';
+// Export AirAccount SDK (ERC-4337 + KMS + BLS)
+export * as AirAccount from '@aastar/airaccount';
 // Export Utils & Errors
 export * from './utils/roleData.js';
 export * from './utils/keys.js';

package/dist/utils/userOp.d.ts

@@ -33,6 +33,17 @@ export declare class UserOperationBuilder {
      * Packs maxPriorityFeePerGas and maxFeePerGas into a bytes32 Hex string.
      */
     static packGasFees(maxPriorityFeePerGas: bigint, maxFeePerGas: bigint): Hex;
+    static estimatePreVerificationGasV07(userOp: {
+        sender: Address;
+        nonce: bigint | Hex | number | string;
+        initCode: Hex;
+        callData: Hex;
+        accountGasLimits: Hex;
+        preVerificationGas: bigint | Hex | number | string;
+        gasFees: Hex;
+        paymasterAndData: Hex;
+        signature: Hex;
+    }): bigint;
     /**
      * Packs Paymaster parameters into the v0.7 paymasterAndData format.
      */

package/dist/utils/userOp.js

@@ -1,4 +1,4 @@
-import { concat, pad } from 'viem';
+import { concat, pad, encodeAbiParameters, parseAbiParameters, toBytes } from 'viem';
 export class UserOperationBuilder {
     /**
      * Packs verificationGasLimit and callGasLimit into a bytes32 Hex string.
@@ -18,6 +18,36 @@ export class UserOperationBuilder {
             pad(`0x${maxFeePerGas.toString(16)}`, { dir: 'left', size: 16 })
         ]);
     }
+    static estimatePreVerificationGasV07(userOp) {
+        const nonce = typeof userOp.nonce === 'bigint'
+            ? userOp.nonce
+            : typeof userOp.nonce === 'number'
+                ? BigInt(userOp.nonce)
+                : BigInt(userOp.nonce);
+        const preVerificationGas = typeof userOp.preVerificationGas === 'bigint'
+            ? userOp.preVerificationGas
+            : typeof userOp.preVerificationGas === 'number'
+                ? BigInt(userOp.preVerificationGas)
+                : BigInt(userOp.preVerificationGas);
+        const encoded = encodeAbiParameters(parseAbiParameters('(address,uint256,bytes,bytes,bytes32,uint256,bytes32,bytes,bytes)'), [
+            [
+                userOp.sender,
+                nonce,
+                userOp.initCode,
+                userOp.callData,
+                userOp.accountGasLimits,
+                preVerificationGas,
+                userOp.gasFees,
+                userOp.paymasterAndData,
+                userOp.signature
+            ]
+        ]);
+        const bytes = toBytes(encoded);
+        let calldataCost = 0n;
+        for (const b of bytes)
+            calldataCost += b === 0 ? 4n : 16n;
+        return calldataCost + 26000n;
+    }
     /**
      * Packs Paymaster parameters into the v0.7 paymasterAndData format.
      */
@@ -127,9 +157,20 @@ export class UserOperationBuilder {
      * @param options.paymasterPostOpGasLimit - Gas limit for paymaster postOp (default: 200000)
      */
     static toAlchemyUserOperation(userOp, options) {
+        const toHexStr = (val) => {
+            if (val === undefined || val === null)
+                return undefined;
+            if (typeof val === 'bigint')
+                return `0x${val.toString(16)}`;
+            if (typeof val === 'number')
+                return `0x${val.toString(16)}`;
+            if (typeof val === 'string' && !val.startsWith('0x'))
+                return `0x${val}`;
+            return val;
+        };
         const result = {
             sender: userOp.sender,
-            nonce: userOp.nonce,
+            nonce: toHexStr(userOp.nonce),
             callData: userOp.callData,
             signature: userOp.signature
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aastar/sdk",
-  "version": "0.16.22",
+  "version": "0.17.0",
   "description": "AAStar SDK - The all-in-one package for Mycelium Network",
   "type": "module",
   "publishConfig": {
@@ -14,15 +14,16 @@
   ],
   "dependencies": {
     "viem": "2.43.3",
-    "@aastar/core": "0.16.22",
-    "@aastar/dapp": "0.16.22",
-    "@aastar/identity": "0.16.22",
-    "@aastar/account": "0.16.22",
-    "@aastar/enduser": "0.16.22",
-    "@aastar/paymaster": "0.16.22",
-    "@aastar/tokens": "0.16.22",
-    "@aastar/admin": "0.16.22",
-    "@aastar/operator": "0.16.22"
+    "@aastar/enduser": "0.17.0",
+    "@aastar/core": "0.17.0",
+    "@aastar/account": "0.17.0",
+    "@aastar/dapp": "0.17.0",
+    "@aastar/tokens": "0.17.0",
+    "@aastar/identity": "0.17.0",
+    "@aastar/airaccount": "0.17.0",
+    "@aastar/paymaster": "0.17.0",
+    "@aastar/admin": "0.17.0",
+    "@aastar/operator": "0.17.0"
   },
   "devDependencies": {
     "typescript": "5.7.2"

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

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

package/dist/clients/ExperimentClient.test.js

@@ -1,53 +0,0 @@
-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.test.d.ts

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

package/dist/clients/admin.test.js

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

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

package/dist/clients/clients.test.js

@@ -1,91 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import { createEndUserClient } from './endUser.js';
-import { createCommunityClient } from './community.js';
-import { createOperatorClient } from './operator.js';
-import { createAdminClient } from './admin.js';
-import { http } from 'viem';
-import { mainnet } from 'viem/chains';
-describe('SDK L2 Clients', () => {
-    let mockTransport;
-    let mockChain;
-    let mockAccount;
-    const MOCK_ADDR = '0x1111111111111111111111111111111111111111';
-    beforeEach(() => {
-        mockTransport = http('http://localhost:8545');
-        mockChain = mainnet;
-        mockAccount = {
-            address: MOCK_ADDR,
-            type: 'json-rpc',
-            signMessage: vi.fn().mockResolvedValue('0xsignature')
-        };
-    });
-    describe('EndUserClient', () => {
-        let client;
-        beforeEach(() => {
-            client = createEndUserClient({ chain: mockChain, transport: mockTransport, account: mockAccount });
-            client.readContract = vi.fn();
-            client.writeContract = vi.fn().mockResolvedValue('0xhash');
-            client.waitForTransactionReceipt = vi.fn().mockResolvedValue({ logs: [] });
-            client.getBytecode = vi.fn().mockResolvedValue('0x123');
-        });
-        it('should create EndUserClient', () => {
-            expect(client.onboard).toBeDefined();
-        });
-        it('should create smart account', async () => {
-            client.readContract.mockResolvedValue(MOCK_ADDR);
-            const result = await client.createSmartAccount({ owner: MOCK_ADDR });
-            expect(result.accountAddress).toBe(MOCK_ADDR);
-            expect(result.initCode).toBeDefined();
-        });
-        it('should execute gasless transaction', async () => {
-            client.readContract.mockResolvedValue(0n); // nonce
-            client.readContract.mockResolvedValueOnce(0n).mockResolvedValueOnce('0xhash'); // nonce, userOpHash
-            client.createSmartAccount = vi.fn().mockResolvedValue({ accountAddress: MOCK_ADDR, initCode: '0x' });
-            const result = await client.executeGasless({
-                target: MOCK_ADDR,
-                data: '0x',
-                operator: MOCK_ADDR
-            });
-            expect(result.hash).toBe('0xhash');
-        });
-    });
-    describe('CommunityClient', () => {
-        it('should launch community', async () => {
-            const client = createCommunityClient({ chain: mockChain, transport: mockTransport, account: mockAccount });
-            client.writeContract = vi.fn().mockResolvedValue('0xhash');
-            client.simulateContract = vi.fn().mockResolvedValue({ request: {} });
-            client.waitForTransactionReceipt = vi.fn().mockResolvedValue({ logs: [] });
-            client.readContract = vi.fn().mockResolvedValue(MOCK_ADDR);
-            const result = await client.launch({
-                name: 'Test',
-                tokenName: 'TT',
-                tokenSymbol: 'TT'
-            });
-            expect(result.tokenAddress).toBe(MOCK_ADDR);
-            expect(result.results.length).toBeGreaterThan(0);
-        });
-    });
-    describe('OperatorClient', () => {
-        it('should setup operator', async () => {
-            const client = createOperatorClient({ chain: mockChain, transport: mockTransport, account: mockAccount });
-            client.readContract = vi.fn().mockResolvedValue(['', 0n]); // roleConfig
-            client.writeContract = vi.fn().mockResolvedValue('0xhash');
-            client.waitForTransactionReceipt = vi.fn().mockResolvedValue({ logs: [] });
-            client.registryHasRole = vi.fn().mockResolvedValue(false);
-            const result = await client.setup({
-                stakeAmount: 100n,
-                depositAmount: 100n,
-                roleId: '0x1'
-            });
-            expect(result.txs.length).toBeGreaterThan(0);
-        });
-    });
-    describe('AdminClient', () => {
-        it('should have namespaces', () => {
-            const client = createAdminClient({ chain: mockChain, transport: mockTransport, account: mockAccount });
-            expect(client.system).toBeDefined();
-            expect(client.finance).toBeDefined();
-            expect(client.operators).toBeDefined();
-        });
-    });
-});

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

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

package/dist/clients/community.test.js

@@ -1,99 +0,0 @@
-import { describe, it, expect, vi } from 'vitest';
-import { createCommunityClient } from './community.js';
-import { mainnet } from 'viem/chains';
-import { http } from 'viem';
-vi.mock('@aastar/core', async () => {
-    const actual = await vi.importActual('@aastar/core');
-    return {
-        ...actual,
-        registryActions: vi.fn(() => vi.fn(() => ({
-            registerRoleSelf: vi.fn().mockResolvedValue('0xhash'),
-            hasRole: vi.fn(),
-            roleMetadata: vi.fn()
-        }))),
-        sbtActions: vi.fn(() => vi.fn(() => ({
-            getUserSBT: vi.fn().mockResolvedValue(123n)
-        }))),
-        reputationActions: vi.fn(() => vi.fn(() => ({
-            setReputationRule: vi.fn().mockResolvedValue('0xhash')
-        }))),
-    };
-});
-describe('CommunityClient', () => {
-    const MOCK_ADDR = '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266';
-    it('should create community client', () => {
-        const client = createCommunityClient({ chain: mainnet, transport: http() });
-        expect(client.launch).toBeDefined();
-    });
-    describe('launch', () => {
-        it('should launch community with token and governance', async () => {
-            const client = createCommunityClient({
-                chain: mainnet,
-                transport: http(),
-                account: { address: MOCK_ADDR }
-            });
-            // Mock base client methods
-            client.readContract = vi.fn().mockResolvedValue('0x0000000000000000000000000000000000000000');
-            client.simulateContract = vi.fn().mockResolvedValue({ request: {} });
-            client.writeContract = vi.fn().mockResolvedValue('0xhash');
-            client.waitForTransactionReceipt = vi.fn().mockResolvedValue({ logs: [] });
-            const result = await client.launch({
-                name: 'Test',
-                tokenName: 'T',
-                tokenSymbol: 'T',
-                governance: { initialReputationRule: true }
-            });
-            expect(result.results.length).toBeGreaterThanOrEqual(2);
-            expect(client.writeContract).toHaveBeenCalled();
-        });
-    });
-    describe('getCommunityInfo', () => {
-        it('should return info for registered community', async () => {
-            const client = createCommunityClient({ chain: mainnet, transport: http() });
-            client.readContract = vi.fn()
-                .mockResolvedValueOnce(true) // hasRole
-                .mockResolvedValueOnce('0xtoken') // getTokenAddress
-                .mockResolvedValueOnce('0x'); // roleMetadata
-            const info = await client.getCommunityInfo(MOCK_ADDR);
-            expect(info.hasRole).toBe(true);
-            expect(info.tokenAddress).toBe('0xtoken');
-        });
-    });
-    describe('Launch', () => {
-        it('should validate launch inputs', async () => {
-            const communityClient = createCommunityClient({ chain: mainnet, transport: http(), account: { address: MOCK_ADDR } });
-            await expect(communityClient.launch({
-                name: '',
-                tokenName: 'T',
-                tokenSymbol: 'T'
-            })).rejects.toThrow('Community Name is required');
-            await expect(communityClient.launch({
-                name: 'Test',
-                tokenName: '',
-                tokenSymbol: 'T'
-            })).rejects.toThrow('Token Name is required');
-            await expect(communityClient.launch({
-                name: 'Test',
-                tokenName: 'Test',
-                tokenSymbol: ''
-            })).rejects.toThrow('Token Symbol is required');
-        });
-        it('should handle registration failure gracefully in launch', async () => {
-            const communityClient = createCommunityClient({ chain: mainnet, transport: http(), account: { address: MOCK_ADDR } });
-            // Mock writeContract failure (Already registered)
-            communityClient.writeContract = vi.fn().mockRejectedValueOnce(new Error('Already registered'));
-            // Mock deployToken to succeed
-            communityClient.readContract = vi.fn().mockResolvedValue('0x0000000000000000000000000000000000000000');
-            communityClient.deployToken = vi.fn().mockResolvedValue('0xtoken');
-            // Mock setGovernance
-            communityClient.setReputationRule = vi.fn().mockResolvedValue('0xrule');
-            communityClient.waitForTransactionReceipt = vi.fn().mockResolvedValue({ logs: [] });
-            await communityClient.launch({
-                name: 'Test',
-                tokenName: 'Test',
-                tokenSymbol: 'TST'
-            });
-            expect(true).toBe(true);
-        });
-    });
-});

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

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