@atxp/base 0.2.17 → 0.2.18

package/dist/testHelpers.js

@@ -0,0 +1,202 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { vi, expect } from 'vitest';
+import { USDC_CONTRACT_ADDRESS_BASE } from '@atxp/client';
+import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
+import { base } from 'viem/chains';
+// Common test constants
+export const TEST_API_KEY = 'test-api-key';
+export const TEST_WALLET_ADDRESS = '0x1234567890123456789012345678901234567890';
+export const TEST_SMART_WALLET_ADDRESS = '0xabcdefabcdefabcdefabcdefabcdefabcdefabcd';
+export const TEST_RECEIVER_ADDRESS = '0x1234567890123456789012345678901234567890';
+export const TEST_PRIVATE_KEY = generatePrivateKey();
+export const TEST_PAYMASTER_URL = 'https://api.developer.coinbase.com/rpc/v1/base/snPdXqIzOGhRkGNJvEHM5bl9Hm3yRO3m';
+export const TEST_BUNDLER_URL = 'https://api.developer.coinbase.com/rpc/v1/base';
+// Mock provider
+export function mockProvider({ request = vi.fn() } = {}) {
+    return {
+        request
+    };
+}
+// Mock SDK
+export function mockBaseAccountSDK({ provider = mockProvider() } = {}) {
+    return {
+        getProvider: vi.fn(() => provider)
+    };
+}
+// Mock spend permission
+export function mockSpendPermission({ signature = '0xmocksignature', account = TEST_WALLET_ADDRESS, spender = TEST_SMART_WALLET_ADDRESS, token = USDC_CONTRACT_ADDRESS_BASE, allowance = '10000000', // 10 USDC
+period = 604800, // 7 days
+start = Math.floor(Date.now() / 1000), end = Math.floor(Date.now() / 1000) + 604800, salt = '1', extraData = '0x', chainId = base.id } = {}) {
+    return {
+        signature,
+        permission: {
+            account,
+            spender,
+            token,
+            allowance,
+            period,
+            start,
+            end,
+            salt,
+            extraData,
+            chainId
+        }
+    };
+}
+// Helper to remove timestamp fields from any object (for test comparisons)
+export function removeTimestamps(obj) {
+    // Common timestamp field names
+    const timestampFields = ['timestamp', 'start', 'end', 'createdAt', 'updatedAt', 'expiresAt', 'issuedAt'];
+    // Deep clone the object to avoid mutations
+    const result = JSON.parse(JSON.stringify(obj));
+    // Recursive function to remove timestamps
+    function removeFromObject(target) {
+        if (!target || typeof target !== 'object')
+            return;
+        // Handle arrays
+        if (Array.isArray(target)) {
+            target.forEach(item => removeFromObject(item));
+            return;
+        }
+        // Handle objects
+        for (const key in target) {
+            if (timestampFields.includes(key)) {
+                // Validate it looks like a timestamp (number between year 2000 and 2100)
+                const value = target[key];
+                if (typeof value === 'number' && value > 946684800 && value < 4102444800) {
+                    delete target[key];
+                }
+            }
+            else if (typeof target[key] === 'object') {
+                removeFromObject(target[key]);
+            }
+        }
+    }
+    removeFromObject(result);
+    return result;
+}
+// Helper to check if a timestamp is within a certain range of an expected time
+// This uses toBeGreaterThanOrEqual/toBeLessThanOrEqual because toBeCloseTo is for
+// floating-point precision, not range checking
+export function expectTimestampAround(timestamp, expectedOffset = 0, tolerance = 60) {
+    const now = Math.floor(Date.now() / 1000);
+    const expected = now + expectedOffset;
+    expect(timestamp).toBeGreaterThanOrEqual(expected - tolerance);
+    expect(timestamp).toBeLessThanOrEqual(expected + tolerance);
+}
+// Mock expired spend permission
+export function mockExpiredSpendPermission(overrides = {}) {
+    const now = Math.floor(Date.now() / 1000);
+    return mockSpendPermission({
+        start: now - 1000000,
+        end: now - 1000, // Expired
+        ...overrides
+    });
+}
+// Mock smart account
+export function mockSmartAccount({ address = TEST_SMART_WALLET_ADDRESS, signMessage = vi.fn().mockResolvedValue('0xmocksignature') } = {}) {
+    return {
+        address,
+        signMessage
+    };
+}
+// Mock bundler client
+export function mockBundlerClient({ sendUserOperation = vi.fn().mockResolvedValue('0xoperationhash'), waitForUserOperationReceipt = vi.fn().mockResolvedValue({
+    success: true,
+    userOpHash: '0xoperationhash',
+    receipt: { transactionHash: '0xtxhash' }
+}), waitForTransactionReceipt = vi.fn().mockResolvedValue({}) } = {}) {
+    return {
+        sendUserOperation,
+        waitForUserOperationReceipt,
+        account: {
+            client: {
+                waitForTransactionReceipt
+            }
+        }
+    };
+}
+// Mock failed bundler client
+export function mockFailedBundlerClient({ failureType = 'receipt' } = {}) {
+    if (failureType === 'receipt') {
+        return mockBundlerClient({
+            waitForUserOperationReceipt: vi.fn().mockResolvedValue(null)
+        });
+    }
+    else if (failureType === 'deployment') {
+        return mockBundlerClient({
+            waitForUserOperationReceipt: vi.fn().mockResolvedValue({
+                success: false,
+                receipt: { transactionHash: '0xtxhash' }
+            })
+        });
+    }
+    else if (failureType === 'noTxHash') {
+        return mockBundlerClient({
+            waitForUserOperationReceipt: vi.fn().mockResolvedValue({
+                success: true,
+                userOpHash: '0xoperationhash',
+                receipt: {} // No transactionHash
+            })
+        });
+    }
+    return mockBundlerClient();
+}
+// Mock ephemeral smart wallet
+export function mockEphemeralSmartWallet({ address = TEST_SMART_WALLET_ADDRESS, account = mockSmartAccount({ address }), client = mockBundlerClient(), privateKey = TEST_PRIVATE_KEY } = {}) {
+    const signer = privateKeyToAccount(privateKey);
+    return {
+        address,
+        account,
+        client,
+        signer: {
+            ...signer,
+            signMessage: vi.fn().mockResolvedValue('0xmocksignature'),
+            signTypedData: vi.fn().mockResolvedValue('0xmocksignature'),
+            signTransaction: vi.fn().mockResolvedValue('0xmocksignature'),
+            getAddress: vi.fn().mockResolvedValue(address)
+        }
+    };
+}
+// Mock spend permission calls for payment
+export function mockSpendCalls({ calls = [
+    { to: '0xcontract1', data: '0xdata1', value: '0x0' },
+    { to: '0xcontract2', data: '0xdata2', value: '0x0' }
+] } = {}) {
+    return calls;
+}
+// Helper to setup initialization mocks
+export async function setupInitializationMocks({ provider = mockProvider(), spendPermission = mockSpendPermission(), smartAccount = mockSmartAccount(), bundlerClient = mockBundlerClient() } = {}) {
+    const { createBaseAccountSDK } = await import('@base-org/account');
+    const { requestSpendPermission } = await import('@base-org/account/spend-permission');
+    const { toCoinbaseSmartAccount, createBundlerClient } = await import('viem/account-abstraction');
+    const { createPublicClient } = await import('viem');
+    const sdk = mockBaseAccountSDK({ provider });
+    createBaseAccountSDK.mockReturnValue(sdk);
+    createPublicClient.mockReturnValue({});
+    toCoinbaseSmartAccount.mockResolvedValue(smartAccount);
+    createBundlerClient.mockReturnValue(bundlerClient);
+    requestSpendPermission.mockResolvedValue(spendPermission);
+    return {
+        createBaseAccountSDK,
+        requestSpendPermission,
+        toCoinbaseSmartAccount,
+        createBundlerClient,
+        createPublicClient,
+        provider,
+        sdk
+    };
+}
+// Helper to setup payment mocks
+export async function setupPaymentMocks({ spendCalls = mockSpendCalls() } = {}) {
+    const { prepareSpendCallData } = await import('@base-org/account/spend-permission');
+    prepareSpendCallData.mockResolvedValue(spendCalls);
+    return {
+        prepareSpendCallData
+    };
+}
+// Storage key helper
+export function getStorageKey(walletAddress) {
+    return `atxp-base-permission-${walletAddress}`;
+}
+//# sourceMappingURL=testHelpers.js.map

package/dist/testHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHelpers.js","sourceRoot":"","sources":["../src/testHelpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atxp/base",
-  "version": "0.2.17",
+  "version": "0.2.18",
   "description": "ATXP for Base Mini Apps",
   "license": "MIT",
   "repository": {
@@ -22,8 +22,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@atxp/client": "0.2.17",
-    "@atxp/common": "0.2.17",
+    "@atxp/client": "0.2.18",
+    "@atxp/common": "0.2.18",
     "@base-org/account": "^2.0.2",
     "bignumber.js": "^9.3.0",
     "viem": "^2.34.0"