gokite-aa-sdk 1.0.3 → 1.0.4

package/dist/config.d.ts

@@ -5,5 +5,10 @@ export interface NetworkConfig {
     accountImplementation: string;
     bundlerUrl?: string;
     paymaster?: string;
+    supportedTokens: {
+        address: string;
+        symbol: string;
+        decimals: number;
+    }[];
 }
 export declare const NETWORKS: Record<string, NetworkConfig>;

package/dist/config.js

@@ -7,6 +7,10 @@ exports.NETWORKS = {
         entryPoint: '0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108',
         accountFactory: '0xF0Fc19F0dc393867F19351d25EDfc5E099561cb7',
         accountImplementation: '0x93F5310eFd0f09db0666CA5146E63CA6Cdc6FC21',
-        paymaster: '0x122E0e1F7fFc0f5d64F5470CF42c6bA0abdF7158',
+        paymaster: '0x9Adcbf85D5c724611a490Ba9eDc4d38d6F39e92d',
+        supportedTokens: [
+            { address: '0x0000000000000000000000000000000000000000', symbol: 'KITE', decimals: 18 },
+            { address: '0x0fF5393387ad2f9f691FD6Fd28e07E3969e27e63', symbol: 'Test USD', decimals: 18 },
+        ],
     },
 };

package/dist/example-token-paymaster.d.ts

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

package/dist/example-token-paymaster.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ethers_1 = require("ethers");
+const gokite_aa_sdk_1 = require("./gokite-aa-sdk");
+async function simpleExample() {
+    const sdk = new gokite_aa_sdk_1.GokiteAASDK('kite_testnet', 'https://rpc-testnet.gokite.ai', 'https://bundler-service.staging.gokite.ai/rpc/');
+    const signer = new ethers_1.ethers.Wallet(process.env.PRIVATE_KEY);
+    const request = {
+        target: '0x0000000000000000000000000000000000000000',
+        value: BigInt(0),
+        callData: '0x'
+    };
+    console.log('📊 Estimate transaction...');
+    const estimate = await sdk.estimateUserOperation(signer.address, request);
+    console.log('Total cost:', estimate.totalCostKITEFormatted);
+    console.log('Cost with token:', estimate.supportedTokens);
+    console.log('Sponsorship available:', estimate.sponsorshipAvailable);
+    console.log('Remaining sponsorships:', estimate.remainingSponsorships);
+    console.log('Payment options:', estimate.supportedTokens.map(t => `${t.tokenSymbol}: ${t.formattedCost}`));
+    // Step 2: Select payment method and execute
+    const tokenAddress = estimate.sponsorshipAvailable
+        ? '0x0000000000000000000000000000000000000000' // Use sponsorship/KITE
+        : '0x0fF5393387ad2f9f691FD6Fd28e07E3969e27e63'; // Use Test USD
+    console.log('\n🚀 Execute transaction...');
+    const result = await sdk.sendUserOperationWithPayment(signer.address, request, estimate.userOp, tokenAddress, async (hash) => signer.signMessage(ethers_1.ethers.getBytes(hash)));
+    console.log('✅ Done!');
+    console.log('UserOp Hash:', result.userOpHash);
+    console.log('Status:', result.status.status);
+}
+// Run
+if (require.main === module) {
+    simpleExample().catch(console.error);
+}

package/dist/example.js

@@ -437,42 +437,58 @@ async function exampleUsage() {
     const userEoa = '0x4A50DCA63d541372ad36E5A36F1D542d51164F19';
     // actual token recipient address
     const toAddress = '0x4A50DCA63d541372ad36E5A36F1D542d51164F19';
-    // 1. Transfer ERC20 tokens
-    console.log('\n=== 1. ERC20 Transfer ===');
-    const transferResult = await transferERC20(userEoa, toAddress, '10', ADDRESSES.SETTLEMENT_TOKEN, 18, signFunction);
-    console.log('Transfer result:', transferResult);
+    // // 1. Transfer ERC20 tokens
+    // console.log('\n=== 1. ERC20 Transfer ===');
+    // const transferResult = await transferERC20(
+    //   userEoa,
+    //   toAddress,
+    //   '10',
+    //   ADDRESSES.SETTLEMENT_TOKEN,
+    //   18,
+    //   signFunction
+    // );
+    // console.log('Transfer result:', transferResult);
     // 2. Deploy KitePass
     console.log('\n=== 2. Deploy KitePass ===');
     const deployResult = await deployKitePass(userEoa, signFunction);
     console.log('Deploy result:', deployResult);
-    if (deployResult.success && deployResult.proxyAddress) {
-        // 3. Configure spending rules
-        console.log('\n=== 3. Configure Spending Rules ===');
-        const configResult = await configureSpendingRules(userEoa, deployResult.proxyAddress, signFunction);
-        console.log('Config result:', configResult);
-        // 4. View spending rules
-        console.log('\n=== 4. View Spending Rules ===');
-        const rulesResult = await viewSpendingRules(deployResult.proxyAddress);
-        console.log('Rules result:', rulesResult);
-    }
-    // 5. Register service
-    console.log('\n=== 5. Register Service ===');
-    // serviceId, get from backend
-    const serviceId = ethers_1.ethers.hexlify((0, ethers_1.randomBytes)(32));
-    const sdk = initializeSDK();
-    const serviceOwner = sdk.getAccountAddress(userEoa);
-    const serviceResult = await registerService(userEoa, serviceId, {
-        serviceOwner: serviceOwner,
-        priceModel: 0,
-        unitPrice: 100,
-        // provider Id, bytes32
-        provider: ethers_1.ethers.hexlify((0, ethers_1.randomBytes)(32)),
-        // service metadata, currently not used
-        metadata: '0x',
-        name: 'Test Service',
-        isPublic: true
-    }, signFunction);
-    console.log('Service result:', serviceResult);
+    // if (deployResult.success && deployResult.proxyAddress) {
+    //   // 3. Configure spending rules
+    //   console.log('\n=== 3. Configure Spending Rules ===');
+    //   const configResult = await configureSpendingRules(
+    //     userEoa,
+    //     deployResult.proxyAddress,
+    //     signFunction
+    //   );
+    //   console.log('Config result:', configResult);
+    //   // 4. View spending rules
+    //   console.log('\n=== 4. View Spending Rules ===');
+    //   const rulesResult = await viewSpendingRules(deployResult.proxyAddress);
+    //   console.log('Rules result:', rulesResult);
+    // }
+    // // 5. Register service
+    // console.log('\n=== 5. Register Service ===');
+    // // serviceId, get from backend
+    // const serviceId = ethers.hexlify(randomBytes(32));
+    // const sdk = initializeSDK();
+    // const serviceOwner = sdk.getAccountAddress(userEoa);
+    // const serviceResult = await registerService(
+    //   userEoa,
+    //   serviceId,
+    //   {
+    //     serviceOwner: serviceOwner,
+    //     priceModel: 0,
+    //     unitPrice: 100,
+    //     // provider Id, bytes32
+    //     provider: ethers.hexlify(randomBytes(32)),
+    //     // service metadata, currently not used
+    //     metadata: '0x',
+    //     name: 'Test Service',
+    //     isPublic: true
+    //   },
+    //   signFunction
+    // );
+    // console.log('Service result:', serviceResult);
 }
 // Run example if executed directly
 if (require.main === module) {

package/dist/gokite-aa-sdk.d.ts

@@ -1,4 +1,4 @@
-import { UserOperation, UserOperationRequest, BatchUserOperationRequest, UserOperationGasEstimate, UserOperationStatus, SignFunction, PollingOptions } from './types';
+import { UserOperation, UserOperationRequest, BatchUserOperationRequest, UserOperationGasEstimate, UserOperationStatus, SignFunction, PollingOptions, UserOperationEstimate } from './types';
 /**
  * Main Gokite AA SDK class
  */
@@ -38,7 +38,7 @@ export declare class GokiteAASDK {
     /**
      * Create user operation
      */
-    createUserOperation(owner: string, request: UserOperationRequest | BatchUserOperationRequest, salt?: bigint, paymasterAddress?: string): Promise<Partial<UserOperation>>;
+    createUserOperation(owner: string, request: UserOperationRequest | BatchUserOperationRequest, salt?: bigint, paymasterAddress?: string, tokenAddress?: string): Promise<Partial<UserOperation>>;
     /**
      * Estimate gas for user operation
      */
@@ -46,7 +46,7 @@ export declare class GokiteAASDK {
     /**
      * Sign and send user operation
      */
-    sendUserOperation(owner: string, request: UserOperationRequest | BatchUserOperationRequest, signFn: SignFunction, salt?: bigint, paymasterAddress?: string): Promise<string>;
+    sendUserOperation(owner: string, request: UserOperationRequest | BatchUserOperationRequest, signFn: SignFunction, salt?: bigint, paymasterAddress?: string, tokenAddress?: string): Promise<string>;
     /**
      * Send user operation directly to EntryPoint contract (bypassing bundler)
      * Note: This requires a signer to pay for gas. For now, we'll try with the read-only provider.
@@ -60,9 +60,30 @@ export declare class GokiteAASDK {
      * Enhanced polling for user operation status with detailed result parsing
      */
     pollUserOperationStatus(userOpHash: string, options?: PollingOptions): Promise<UserOperationStatus>;
+    /**
+     * Estimate user operation costs and get paymaster information
+     */
+    estimateUserOperation(owner: string, request: UserOperationRequest | BatchUserOperationRequest): Promise<UserOperationEstimate>;
+    /**
+     * Get paymaster information including sponsorship status and supported tokens
+     */
+    private getPaymasterInfo;
     /**
      * Send user operation and wait for completion with detailed status
      */
+    /**
+     * Send user operation with specified payment token and wait for completion
+     */
+    sendUserOperationWithPayment(owner: string, request: UserOperationRequest | BatchUserOperationRequest, baseUserOp: Partial<UserOperation>, // base userOp from estimate
+    tokenAddress: string, // token address for payment
+    signFn: SignFunction, salt?: bigint, pollingOptions?: PollingOptions): Promise<{
+        userOpHash: string;
+        status: UserOperationStatus;
+    }>;
+    /**
+     * Add ERC20 approve operations to the request (approve 0 first, then max)
+     */
+    private addApproveOperation;
     sendUserOperationAndWait(owner: string, request: UserOperationRequest | BatchUserOperationRequest, signFn: SignFunction, salt?: bigint, paymasterAddress?: string, pollingOptions?: PollingOptions): Promise<{
         userOpHash: string;
         status: UserOperationStatus;

package/dist/gokite-aa-sdk.js

@@ -254,7 +254,7 @@ class GokiteAASDK {
     /**
      * Create user operation
      */
-    async createUserOperation(owner, request, salt, paymasterAddress) {
+    async createUserOperation(owner, request, salt, paymasterAddress, tokenAddress) {
         const actualSalt = salt || (0, utils_1.generateSalt)();
         const accountAddress = this.getAccountAddress(owner, actualSalt);
         const isDeployed = await this.isAccountDeloyed(accountAddress);
@@ -274,9 +274,13 @@ class GokiteAASDK {
             paymasterAddress = this.config.paymaster;
         }
         // Pack paymaster data (paymasterAddress, paymasterVerificationGasLimit, postOpGasLimit, paymasterData) 
-        const paymasterAndData = paymasterAddress
-            ? (0, utils_1.packPaymasterAndData)(paymasterAddress, BigInt(100000), BigInt(100000), '0x')
-            : '0x';
+        let paymasterAndData = '0x';
+        if (paymasterAddress) {
+            // For token payments, append token address to paymaster data
+            tokenAddress = tokenAddress || this.config.supportedTokens[1].address;
+            const paymasterData = ethers_1.ethers.solidityPacked(['address'], [tokenAddress]);
+            paymasterAndData = (0, utils_1.packPaymasterAndData)(paymasterAddress, BigInt(500000), BigInt(500000), paymasterData);
+        }
         return {
             sender: accountAddress,
             nonce: await this.getAccountNonce(accountAddress),
@@ -300,9 +304,9 @@ class GokiteAASDK {
     /**
      * Sign and send user operation
      */
-    async sendUserOperation(owner, request, signFn, salt, paymasterAddress) {
+    async sendUserOperation(owner, request, signFn, salt, paymasterAddress, tokenAddress) {
         // Create user operation
-        const userOp = await this.createUserOperation(owner, request, salt, paymasterAddress);
+        const userOp = await this.createUserOperation(owner, request, salt, paymasterAddress, tokenAddress);
         // Add dummy signature for gas estimation
         const userOpWithDummy = (0, utils_1.createUserOpForEstimation)(userOp);
         // Estimate gas using bundler
@@ -410,9 +414,150 @@ class GokiteAASDK {
         }
         throw new Error(`UserOp polling timeout: ${userOpHash} (attempt ${retryCount})`);
     }
+    /**
+     * Estimate user operation costs and get paymaster information
+     */
+    async estimateUserOperation(owner, request) {
+        console.log('Estimating UserOp costs...');
+        const paymasterAddress = this.config.paymaster;
+        try {
+            // Always estimate with paymaster for higher gas limits
+            const userOp = await this.createUserOperation(owner, request, undefined, paymasterAddress);
+            console.log('[estimateUserOperation]userOp:', userOp);
+            const gasEstimate = await this.estimateGas(userOp);
+            gasEstimate.callGasLimit = gasEstimate.callGasLimit + 5000000n;
+            gasEstimate.verificationGasLimit = gasEstimate.verificationGasLimit + 1000000n;
+            gasEstimate.preVerificationGas = gasEstimate.preVerificationGas + 1000000n;
+            gasEstimate.maxFeePerGas = BigInt(10000000);
+            // Calculate total cost in KITE
+            const totalGas = gasEstimate.callGasLimit + gasEstimate.verificationGasLimit + gasEstimate.preVerificationGas;
+            const totalCostWei = totalGas * gasEstimate.maxFeePerGas;
+            const totalCostKITE = totalCostWei.toString();
+            const totalCostKITEFormatted = ethers_1.ethers.formatEther(totalCostWei);
+            // Get paymaster info
+            const { sponsorshipAvailable, remainingSponsorships, supportedTokens } = await this.getPaymasterInfo(paymasterAddress, userOp.sender, totalCostWei);
+            return {
+                totalCostKITE,
+                totalCostKITEFormatted,
+                gasEstimate,
+                sponsorshipAvailable,
+                remainingSponsorships,
+                supportedTokens,
+                paymasterAddress,
+                userOp
+            };
+        }
+        catch (error) {
+            throw new types_1.AASDKError(classifyError(error, 'estimate user operation'));
+        }
+    }
+    /**
+     * Get paymaster information including sponsorship status and supported tokens
+     */
+    async getPaymasterInfo(paymasterAddress, userAddress, estimatedCost) {
+        const paymasterABI = [
+            'function maxSponsoredTransactions() view returns (uint256)',
+            'function userSponsorship(address user) view returns (uint256)',
+            'function supportedTokens(address token) view returns (uint256)',
+            'function maxCostPerSponsoredTransaction() view returns (uint256)'
+        ];
+        const paymaster = new ethers_1.ethers.Contract(paymasterAddress, paymasterABI, this.ethersProvider);
+        // Get sponsorship info
+        const [maxSponsorships, userSponsorships, maxCostPerSponsorship] = await Promise.all([
+            paymaster.maxSponsoredTransactions(),
+            paymaster.userSponsorship(userAddress),
+            paymaster.maxCostPerSponsoredTransaction()
+        ]);
+        const remainingSponsorships = Math.max(0, Number(maxSponsorships) - Number(userSponsorships));
+        const sponsorshipAvailable = remainingSponsorships > 0 && estimatedCost <= maxCostPerSponsorship;
+        // Check supported tokens from config
+        const supportedTokens = [];
+        for (const token of this.config.supportedTokens) {
+            try {
+                const exchangeRate = await paymaster.supportedTokens(token.address);
+                if (exchangeRate > 0) {
+                    const tokenCost = (estimatedCost * BigInt(1e18)) / exchangeRate;
+                    const formattedCost = `${ethers_1.ethers.formatUnits(tokenCost, token.decimals)} ${token.symbol}`;
+                    supportedTokens.push({
+                        tokenAddress: token.address,
+                        tokenSymbol: token.symbol,
+                        tokenDecimals: token.decimals,
+                        estimatedCost: tokenCost.toString(),
+                        formattedCost
+                    });
+                }
+            }
+            catch (error) {
+                console.warn(`Failed to check token ${token.symbol}:`, error);
+            }
+        }
+        return {
+            sponsorshipAvailable,
+            remainingSponsorships,
+            supportedTokens
+        };
+    }
     /**
      * Send user operation and wait for completion with detailed status
      */
+    /**
+     * Send user operation with specified payment token and wait for completion
+     */
+    async sendUserOperationWithPayment(owner, request, baseUserOp, // base userOp from estimate
+    tokenAddress, // token address for payment
+    signFn, salt, pollingOptions) {
+        console.log('Sending UserOp with token:', tokenAddress);
+        let finalRequest = request;
+        let finalUserOp = { ...baseUserOp };
+        // If using ERC20 token (not 0x0), add approve operations
+        if (tokenAddress !== '0x0000000000000000000000000000000000000000') {
+            // Add approve operations to the request
+            finalRequest = await this.addApproveOperation(owner, request, tokenAddress, this.config.paymaster);
+            // Rebuild userOp with approve operations
+            finalUserOp = await this.createUserOperation(owner, finalRequest, salt, this.config.paymaster, tokenAddress);
+            // Copy gas estimates from base userOp
+            finalUserOp.accountGasLimits = baseUserOp.accountGasLimits;
+            finalUserOp.preVerificationGas = baseUserOp.preVerificationGas;
+            finalUserOp.gasFees = baseUserOp.gasFees;
+        }
+        // Get user operation hash
+        const userOpHash = await this.getUserOpHash(finalUserOp);
+        // Sign user operation
+        const signature = await signFn(userOpHash);
+        finalUserOp.signature = signature;
+        // Send to bundler
+        const sentUserOpHash = await this.provider.sendUserOperation(finalUserOp, this.config.entryPoint);
+        console.log(`UserOp sent: ${sentUserOpHash}`);
+        // Poll for status
+        const status = await this.pollUserOperationStatus(sentUserOpHash, pollingOptions);
+        return {
+            userOpHash: sentUserOpHash,
+            status
+        };
+    }
+    /**
+     * Add ERC20 approve operations to the request (approve 0 first, then max)
+     */
+    async addApproveOperation(owner, request, tokenAddress, paymasterAddress) {
+        // Create approve call data - first approve 0, then approve max
+        const approve0CallData = (0, utils_1.encodeFunctionCall)(['function approve(address,uint256) returns (bool)'], 'approve', [paymasterAddress, '0']);
+        const approveMaxCallData = (0, utils_1.encodeFunctionCall)(['function approve(address,uint256) returns (bool)'], 'approve', [paymasterAddress, ethers_1.ethers.MaxUint256.toString()]);
+        // Convert single request to batch if needed
+        if ('target' in request) {
+            return {
+                targets: [tokenAddress, tokenAddress, request.target],
+                values: [BigInt(0), BigInt(0), request.value || BigInt(0)],
+                callDatas: [approve0CallData, approveMaxCallData, request.callData]
+            };
+        }
+        else {
+            return {
+                targets: [tokenAddress, tokenAddress, ...request.targets],
+                values: [BigInt(0), BigInt(0), ...(request.values || [])],
+                callDatas: [approve0CallData, approveMaxCallData, ...request.callDatas]
+            };
+        }
+    }
     async sendUserOperationAndWait(owner, request, signFn, salt, paymasterAddress, pollingOptions) {
         console.log('Sending UserOp and waiting for completion...');
         // Step 1: Send user operation

package/dist/types.d.ts

@@ -41,6 +41,23 @@ export interface PollingOptions {
     timeout?: number;
     maxRetries?: number;
 }
+export interface PaymasterTokenCost {
+    tokenAddress: string;
+    tokenSymbol?: string;
+    tokenDecimals?: number;
+    estimatedCost: string;
+    formattedCost: string;
+}
+export interface UserOperationEstimate {
+    totalCostKITE: string;
+    totalCostKITEFormatted: string;
+    gasEstimate: UserOperationGasEstimate;
+    sponsorshipAvailable: boolean;
+    remainingSponsorships: number;
+    supportedTokens: PaymasterTokenCost[];
+    paymasterAddress?: string;
+    userOp: Partial<UserOperation>;
+}
 export interface AAError {
     type: 'ESTIMATE_GAS_FAILED' | 'SEND_USEROP_FAILED' | 'INSUFFICIENT_FUNDS' | 'INVALID_SIGNATURE' | 'BUNDLER_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
     message: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gokite-aa-sdk",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Simple and clean Account Abstraction SDK for Gokite",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/example.old.d.ts

@@ -1,47 +0,0 @@
-import { GokiteAASDK } from './gokite-aa-sdk';
-import "dotenv/config";
-declare function handleAAError(error: any): {
-    type: string;
-    message: string;
-    details?: any;
-};
-/**
- * ClientAgentVault Integration Tests
- *
- * these tests show how to use the AA wallet to:
- * 1. deploy the ClientAgentVault proxy contract (via performCreate)
- * 2. configure spending rules (Spending Rules)
- * 3. view spending rules (read-only)
- * 4. withdraw funds (withdrawFunds)
- * 5. check token balance (read-only)
- *
- * how to use:
- * - modify the contract addresses and parameters as needed
- */
-declare function clientAgentVaultIntegrationTests(): Promise<void>;
-/**
- * Test 1: Deploy ClientAgentVault Proxy via AA wallet's performCreate
- */
-declare function DeployClientAgentVaultProxy(sdk: GokiteAASDK, eoa: string, aa: string, signFunction: any): Promise<string | null>;
-/**
- * Test 2: Configure Spending Rules
- */
-declare function ConfigureSpendingRules(sdk: GokiteAASDK, owner: string, proxyAddress: string, signFunction: any): Promise<void>;
-/**
- * Test 3: View Spending Rules (Read-only, no transaction sent)
- */
-declare function ViewSpendingRules(sdk: GokiteAASDK, proxyAddress: string): Promise<void>;
-/**
- * Test 4: Withdraw Funds
- */
-declare function WithdrawFunds(sdk: GokiteAASDK, owner: string, proxyAddress: string, signFunction: any): Promise<void>;
-/**
- * Test 5: Check Token Balance (Read-only)
- */
-declare function CheckTokenBalance(sdk: GokiteAASDK, proxyAddress: string): Promise<void>;
-/**
- * Legacy example for basic AA operations
- */
-declare function basicExample(): Promise<void>;
-export { clientAgentVaultIntegrationTests, basicExample, DeployClientAgentVaultProxy, ConfigureSpendingRules, ViewSpendingRules, WithdrawFunds, CheckTokenBalance, handleAAError, };
-export declare const example: typeof basicExample;

package/dist/example.old.js

@@ -1,426 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.example = exports.handleAAError = exports.CheckTokenBalance = exports.WithdrawFunds = exports.ViewSpendingRules = exports.ConfigureSpendingRules = exports.DeployClientAgentVaultProxy = exports.basicExample = exports.clientAgentVaultIntegrationTests = void 0;
-const gokite_aa_sdk_1 = require("./gokite-aa-sdk");
-const types_1 = require("./types");
-const ethers_1 = require("ethers");
-require("dotenv/config");
-// Contract addresses on kite_testnet
-const ADDRESSES = {
-    SETTLEMENT_TOKEN: '0x0fF5393387ad2f9f691FD6Fd28e07E3969e27e63',
-    SETTLEMENT_CONTRACT: '0x8d9FaD78d5Ce247aA01C140798B9558fd64a63E3',
-    CLIENT_AGENT_VAULT_IMPL: '0xB5AAFCC6DD4DFc2B80fb8BCcf406E1a2Fd559e23'
-};
-function handleAAError(error) {
-    if (error instanceof types_1.AASDKError) {
-        return {
-            type: error.type,
-            message: error.message,
-            details: error.details
-        };
-    }
-    // Fallback for other errors
-    return {
-        type: 'UNKNOWN_ERROR',
-        message: error.message || 'An unknown error occurred',
-        details: error
-    };
-}
-exports.handleAAError = handleAAError;
-/**
- * Get TransparentUpgradeableProxy bytecode
- */
-function getTransparentProxyBytecode() {
-    // This is the bytecode for TransparentUpgradeableProxy
-    return '0x60a0604052610b278038038061001481610293565b928339810160608282031261028e5761002c826102b8565b610038602084016102b8565b604084015190936001600160401b03821161028e570182601f8201121561028e5780519061006d610068836102cc565b610293565b938285526020838301011161028e5760005b828110610279575050602060009184010152803b15610258577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80546001600160a01b0319166001600160a01b0383169081179091557fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b600080a281511561023f5760008083602061013595519101845af43d15610237573d91610125610068846102cc565b9283523d6000602085013e6102e7565b505b604051906104918083016001600160401b0381118482101761022157602092849261067684396001600160a01b031681520301906000f080156102155760018060a01b031680608052600080516020610b07833981519152547f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6040805160018060a01b0384168152846020820152a181156101ff576001600160a01b03191617600080516020610b078339815191525560405161032d908161034982396080518160070152f35b633173bdd160e11b600052600060045260246000fd5b6040513d6000823e3d90fd5b634e487b7160e01b600052604160045260246000fd5b6060916102e7565b505034156101375763b398979f60e01b60005260046000fd5b634c9c8ce360e01b60009081526001600160a01b0391909116600452602490fd5b8060208092840101518282880101520161007f565b600080fd5b6040519190601f01601f191682016001600160401b0381118382101761022157604052565b51906001600160a01b038216820361028e57565b6001600160401b03811161022157601f01601f191660200190565b9061030d57508051156102fc57805190602001fd5b630a12f52160e11b60005260046000fd5b8151158061033f575b61031e575090565b639996b31560e01b60009081526001600160a01b0391909116600452602490fd5b50803b1561031656fe6080604052337f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031603610069576000356001600160e01b03191663278f794360e11b1461005f576334ad5dbb60e21b60005260046000fd5b610067610113565b005b7f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc5460009081906001600160a01b0316368280378136915af43d6000803e156100b1573d6000f35b3d6000fd5b634e487b7160e01b600052604160045260246000fd5b6040519190601f01601f1916820167ffffffffffffffff8111838210176100f257604052565b6100b6565b67ffffffffffffffff81116100f257601f01601f191660200190565b3660041161019d57604036600319011261019d576004356001600160a01b0381169081900361019d576024359067ffffffffffffffff821161019d573660238301121561019d5781600401359061017161016c836100f7565b6100cc565b91808352366024828601011161019d57602081600092602461019b970183870137840101526101a2565b565b600080fd5b90813b15610239577f360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc80546001600160a01b0319166001600160a01b0384169081179091557fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b600080a280511561021f5761021c9161025b565b50565b50503461022857565b63b398979f60e01b60005260046000fd5b50634c9c8ce360e01b60009081526001600160a01b0391909116600452602490fd5b60008061028f93602081519101845af43d15610292573d9161027f61016c846100f7565b9283523d6000602085013e610296565b90565b6060915b906102bc57508051156102ab57805190602001fd5b630a12f52160e11b60005260046000fd5b815115806102ee575b6102cd575090565b639996b31560e01b60009081526001600160a01b0391909116600452602490fd5b50803b156102c556fea2646970667358221220597147005a6fe654561cbab25a93153cc233180473a65a90bd427f0c1f41018764736f6c634300081c003360803460bc57601f61049138819003918201601f19168301916001600160401b0383118484101760c15780849260209460405283398101031260bc57516001600160a01b0381169081900360bc57801560a657600080546001600160a01b031981168317825560405192916001600160a01b03909116907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09080a36103b990816100d88239f35b631e4fbdf760e01b600052600060045260246000fd5b600080fd5b634e487b7160e01b600052604160045260246000fdfe6080604052600436101561001257600080fd5b6000803560e01c8063715018a6146102875780638da5cb5b146102605780639623609d1461012f578063ad3cb1cc146100e25763f2fde38b1461005457600080fd5b346100df5760203660031901126100df576004356001600160a01b038116908190036100dd5761008261035a565b80156100c95781546001600160a01b03198116821783556001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08380a380f35b631e4fbdf760e01b82526004829052602482fd5b505b80fd5b50346100df57806003193601126100df575061012b6040516101056040826102e1565b60058152640352e302e360dc1b6020820152604051918291602083526020830190610319565b0390f35b5060603660031901126100df576004356001600160a01b038116908190036100dd576024356001600160a01b038116908190036102405760443567ffffffffffffffff811161025c573660238201121561025c57806004013567ffffffffffffffff8111610248576040518593929091906101b4601f8301601f1916602001846102e1565b81835236602483830101116102445781859260246020930183860137830101526101dc61035a565b833b156102405761021293839260405180968194829363278f794360e11b84526004840152604060248401526044830190610319565b039134905af18015610233576102255780f35b61022e916102e1565b388180f35b50604051903d90823e3d90fd5b8280fd5b8480fd5b634e487b7160e01b85526041600452602485fd5b8380fd5b50346100df57806003193601126100df57546040516001600160a01b039091168152602090f35b50346100df57806003193601126100df576102a061035a565b80546001600160a01b03198116825581906001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a380f35b90601f8019910116810190811067ffffffffffffffff82111761030357604052565b634e487b7160e01b600052604160045260246000fd5b919082519283825260005b848110610345575050826000602080949584010152601f8019910116010190565b80602080928401015182828601015201610324565b6000546001600160a01b0316330361036e57565b63118cdaa760e01b6000523360045260246000fdfea26469706673582212207bc32ec723f6be34b228b59aef2ef61b4e6a8eb5bc67fcdd495248566e3b6e0c64736f6c634300081c0033b53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103';
-}
-/**
- * ClientAgentVault Integration Tests
- *
- * these tests show how to use the AA wallet to:
- * 1. deploy the ClientAgentVault proxy contract (via performCreate)
- * 2. configure spending rules (Spending Rules)
- * 3. view spending rules (read-only)
- * 4. withdraw funds (withdrawFunds)
- * 5. check token balance (read-only)
- *
- * how to use:
- * - modify the contract addresses and parameters as needed
- */
-async function clientAgentVaultIntegrationTests() {
-    console.log('\n=== ClientAgentVault Integration Tests ===');
-    // Initialize SDK
-    const sdk = new gokite_aa_sdk_1.GokiteAASDK('kite_testnet', 'https://rpc-testnet.gokite.ai', 'https://bundler-service.staging.gokite.ai/rpc/');
-    // user's EOA address and AA wallet address
-    const eoa = '0x4A50DCA63d541372ad36E5A36F1D542d51164F19';
-    const aa = sdk.getAccountAddress(eoa);
-    console.log('AA Wallet Address:', aa);
-    // Sign function, replace with particle or privy sdk
-    const signFunction = async (userOpHash) => {
-        const signer_pk = process.env.PRIVATE_KEY;
-        const signer = new ethers_1.ethers.Wallet(signer_pk);
-        return signer.signMessage(ethers_1.ethers.getBytes(userOpHash));
-    };
-    // 1. Deploy ClientAgentVault Proxy via performCreate
-    console.log('\n--- Test 1: Deploy ClientAgentVault Proxy ---');
-    const deployedProxyAddress = await DeployClientAgentVaultProxy(sdk, eoa, aa, signFunction);
-    if (!deployedProxyAddress) {
-        console.log('❌ Failed to deploy proxy, cannot continue with other tests');
-        return;
-    }
-    console.log(`✅ Using deployed proxy address: ${deployedProxyAddress}`);
-    // 2. Configure Spending Rules
-    console.log('\n--- Test 2: Configure Spending Rules ---');
-    await ConfigureSpendingRules(sdk, eoa, deployedProxyAddress, signFunction);
-    // 3. View Spending Rules
-    console.log('\n--- Test 3: View Spending Rules ---');
-    await ViewSpendingRules(sdk, deployedProxyAddress);
-    // 4. Withdraw Funds
-    console.log('\n--- Test 4: Withdraw Funds ---');
-    await WithdrawFunds(sdk, eoa, deployedProxyAddress, signFunction);
-    // 5. Check Token Balance
-    console.log('\n--- Test 5: Check Token Balance ---');
-    await CheckTokenBalance(sdk, deployedProxyAddress);
-}
-exports.clientAgentVaultIntegrationTests = clientAgentVaultIntegrationTests;
-/**
- * Test 1: Deploy ClientAgentVault Proxy via AA wallet's performCreate
- */
-async function DeployClientAgentVaultProxy(sdk, eoa, aa, signFunction) {
-    try {
-        // Prepare initialization data for ClientAgentVault
-        const initializeCallData = ethers_1.ethers.Interface.from([
-            'function initialize(address allowedToken, address owner)'
-        ]).encodeFunctionData('initialize', [
-            ADDRESSES.SETTLEMENT_TOKEN,
-            aa // owner (AA wallet address)
-        ]);
-        // Create TransparentUpgradeableProxy deployment bytecode
-        // constructor(address _logic, address admin_, bytes memory _data)
-        const proxyConstructorData = ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(['address', 'address', 'bytes'], [
-            ADDRESSES.CLIENT_AGENT_VAULT_IMPL,
-            aa,
-            initializeCallData // initialization data
-        ]);
-        // Full deployment bytecode = creation code + constructor params
-        const transparentProxyBytecode = getTransparentProxyBytecode();
-        const fullInitCode = transparentProxyBytecode + proxyConstructorData.slice(2);
-        // Create UserOperation to call performCreate
-        const deployRequest = {
-            target: aa,
-            value: 0n,
-            callData: ethers_1.ethers.Interface.from([
-                'function performCreate(uint256 value, bytes calldata initCode) returns (address)'
-            ]).encodeFunctionData('performCreate', [
-                0n,
-                fullInitCode // proxy deployment bytecode + constructor params
-            ])
-        };
-        console.log('Deploying ClientAgentVault proxy...');
-        console.log('- Implementation:', ADDRESSES.CLIENT_AGENT_VAULT_IMPL);
-        console.log('- AllowedToken:', ADDRESSES.SETTLEMENT_TOKEN);
-        const result = await sdk.sendUserOperationAndWait(eoa, deployRequest, signFunction);
-        if (result.status.status === 'success') {
-            console.log('✅ Proxy deployed successfully!');
-            console.log('Transaction hash:', result.status.transactionHash);
-            // Parse the deployed proxy address from transaction logs
-            const proxyAddress = await parseContractCreatedEvent(result.status.transactionHash);
-            if (proxyAddress) {
-                console.log('🎯 Deployed proxy address:', proxyAddress);
-                return proxyAddress; // Return the actual proxy address
-            }
-            else {
-                console.log('⚠️  Could not parse proxy address from logs');
-            }
-        }
-        else {
-            console.log('❌ Deployment failed:', result.status.reason);
-        }
-    }
-    catch (error) {
-        console.error('❌ Test 1 failed:', error);
-    }
-    return null;
-}
-exports.DeployClientAgentVaultProxy = DeployClientAgentVaultProxy;
-/**
- * Test 2: Configure Spending Rules
- */
-async function ConfigureSpendingRules(sdk, owner, proxyAddress, signFunction) {
-    // get today's 00:00:00 timestamp
-    const today = new Date();
-    const todayStart = new Date(today.getFullYear(), today.getMonth(), today.getDate());
-    const todayStartTimestamp = Math.floor(todayStart.getTime() / 1000);
-    // get current week's monday 00:00:00 timestamp
-    const dayOfWeek = today.getDay(); // 0=Sunday, 1=Monday, ..., 6=Saturday
-    const daysFromMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1; // Convert Sunday=0 to Sunday=6
-    const currentWeekStartTimestamp = todayStartTimestamp - (daysFromMonday * 86400); // 86400 = seconds in a day
-    // rules fields:
-    //   - TimeWindow: time window in seconds, 0 means per transaction, >0 means per time window
-    //   - Budget: budget in wei, 18 decimals, like 1e18 means 1 token
-    //   - InitialWindowStartTime: start time of the time window in unix timestamp
-    //      should be set to the start time of the day/week/month in local time (or utc) 00:00:00
-    //   - TargetProviders: target service providers array, empty array means applies to all providers
-    try {
-        // Define spending rules
-        const rulesToAdd = [
-            {
-                timeWindow: 86400n,
-                budget: ethers_1.ethers.parseUnits('100', 18),
-                initialWindowStartTime: todayStartTimestamp,
-                targetProviders: [] // Empty means applies to all providers
-            },
-            {
-                timeWindow: 604800n,
-                budget: ethers_1.ethers.parseUnits('1000', 18),
-                initialWindowStartTime: currentWeekStartTimestamp,
-                targetProviders: []
-            },
-            {
-                timeWindow: 0,
-                budget: ethers_1.ethers.parseUnits('10', 18),
-                initialWindowStartTime: 0n,
-                targetProviders: [ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes('provider1'))]
-            }
-        ];
-        const configureRequest = {
-            target: proxyAddress,
-            value: 0n,
-            callData: ethers_1.ethers.Interface.from([
-                'function configureSpendingRule(uint256[] calldata indicesToRemove, tuple(uint256 timeWindow, uint160 budget, uint96 initialWindowStartTime, bytes32[] targetProviders)[] calldata rulesToAdd)'
-            ]).encodeFunctionData('configureSpendingRule', [
-                [],
-                rulesToAdd // rules to add
-            ])
-        };
-        console.log('Configuring spending rules...');
-        console.log('- Rule 1: 100 tokens per 24 hours (all providers)');
-        console.log('- Rule 2: 10 tokens per hour (specific provider)');
-        const result = await sdk.sendUserOperationAndWait(owner, configureRequest, signFunction);
-        if (result.status.status === 'success') {
-            console.log('✅ Spending rules configured successfully!');
-            console.log('Transaction hash:', result.status.transactionHash);
-        }
-        else {
-            console.log('❌ Configuration failed:', result.status.reason);
-        }
-    }
-    catch (error) {
-        const aaError = handleAAError(error);
-        console.error('❌ Test 2 failed:', {
-            type: aaError.type,
-            message: aaError.message
-        });
-        // Frontend can handle different error types
-        switch (aaError.type) {
-            case 'ESTIMATE_GAS_FAILED':
-                console.log('Suggestion: Check if the contract call is valid');
-                break;
-            case 'SEND_USEROP_FAILED':
-                console.log('Suggestion: Try again or check bundler status');
-                break;
-            case 'NETWORK_ERROR':
-                console.log('Suggestion: Check your internet connection');
-                break;
-            default:
-                console.log('Suggestion: Check console for more details');
-        }
-    }
-}
-exports.ConfigureSpendingRules = ConfigureSpendingRules;
-/**
- * Test 3: View Spending Rules (Read-only, no transaction sent)
- */
-async function ViewSpendingRules(sdk, proxyAddress) {
-    try {
-        const provider = new ethers_1.ethers.JsonRpcProvider('https://rpc-testnet.gokite.ai');
-        const contract = new ethers_1.ethers.Contract(proxyAddress, [
-            'function getSpendingRules() view returns (tuple(tuple(uint256 timeWindow, uint160 budget, uint96 initialWindowStartTime, bytes32[] targetProviders) rule, tuple(uint128 amountUsed, uint128 currentTimeWindowStartTime) usage)[])'
-        ], provider);
-        console.log('Fetching spending rules...');
-        const spendingRules = await contract.getSpendingRules();
-        console.log('✅ Spending Rules:');
-        spendingRules.forEach((rule, index) => {
-            console.log(`  Rule ${index + 1}:`);
-            console.log(`    - Time Window: ${rule.rule.timeWindow} seconds`);
-            console.log(`    - Budget: ${ethers_1.ethers.formatUnits(rule.rule.budget, 18)} tokens`);
-            console.log(`    - Used: ${ethers_1.ethers.formatUnits(rule.usage.amountUsed, 18)} tokens`);
-            console.log(`    - Providers: ${rule.rule.targetProviders.length === 0 ? 'All' : rule.rule.targetProviders.length}`);
-        });
-    }
-    catch (error) {
-        console.error('❌ Test 3 failed:', error);
-    }
-}
-exports.ViewSpendingRules = ViewSpendingRules;
-// transfer erc20 tokens from aa to another address
-async function transferERC20(sdk, owner, proxyAddress, signFunction, to, amount, token, tokenDecimals) {
-    try {
-        const transferRequest = {
-            target: proxyAddress,
-            value: 0n,
-            callData: ethers_1.ethers.Interface.from([
-                'function transfer(address to, uint256 amount)'
-            ]).encodeFunctionData('transfer', [
-                to,
-                ethers_1.ethers.parseUnits(amount.toString(), tokenDecimals) // amount
-            ])
-        };
-        console.log('Transferring ERC20 tokens...');
-        console.log(`- Token: ${token}`);
-        console.log(`- Amount: ${ethers_1.ethers.formatUnits(amount, tokenDecimals)} tokens`);
-        const result = await sdk.sendUserOperationAndWait(owner, transferRequest, signFunction);
-        if (result.status.status === 'success') {
-            console.log('✅ ERC20 transfer successful!');
-            console.log('Transaction hash:', result.status.transactionHash);
-        }
-        else {
-            console.log('❌ ERC20 transfer failed:', result.status.reason);
-        }
-    }
-    catch (error) {
-        console.error('❌ Test 4 failed:', error);
-    }
-}
-/**
- * Test 4: Withdraw Funds
- */
-async function WithdrawFunds(sdk, owner, proxyAddress, signFunction) {
-    try {
-        const withdrawAmount = ethers_1.ethers.parseUnits('50', 18); // Withdraw 50 tokens
-        const withdrawRequest = {
-            target: proxyAddress,
-            value: 0n,
-            callData: ethers_1.ethers.Interface.from([
-                'function withdrawFunds(address token, uint256 amount)'
-            ]).encodeFunctionData('withdrawFunds', [
-                ADDRESSES.SETTLEMENT_TOKEN,
-                withdrawAmount // amount to withdraw
-            ])
-        };
-        console.log('Withdrawing funds...');
-        console.log(`- Token: ${ADDRESSES.SETTLEMENT_TOKEN}`);
-        console.log(`- Amount: ${ethers_1.ethers.formatUnits(withdrawAmount, 18)} tokens`);
-        const result = await sdk.sendUserOperationAndWait(owner, withdrawRequest, signFunction);
-        if (result.status.status === 'success') {
-            console.log('✅ Funds withdrawn successfully!');
-            console.log('Transaction hash:', result.status.transactionHash);
-        }
-        else {
-            console.log('❌ Withdrawal failed:', result.status.reason);
-        }
-    }
-    catch (error) {
-        console.error('❌ Test 4 failed:', error);
-    }
-}
-exports.WithdrawFunds = WithdrawFunds;
-/**
- * Test 5: Check Token Balance (Read-only)
- */
-async function CheckTokenBalance(sdk, proxyAddress) {
-    try {
-        const provider = new ethers_1.ethers.JsonRpcProvider('https://rpc-testnet.gokite.ai');
-        const tokenContract = new ethers_1.ethers.Contract(ADDRESSES.SETTLEMENT_TOKEN, [
-            'function balanceOf(address account) view returns (uint256)',
-            'function symbol() view returns (string)',
-            'function decimals() view returns (uint8)'
-        ], provider);
-        console.log('Checking token balance...');
-        const [balance, symbol, decimals] = await Promise.all([
-            tokenContract.balanceOf(proxyAddress),
-            tokenContract.symbol(),
-            tokenContract.decimals()
-        ]);
-        console.log('✅ Token Balance:');
-        console.log(`  - Address: ${proxyAddress}`);
-        console.log(`  - Token: ${symbol} (${ADDRESSES.SETTLEMENT_TOKEN})`);
-        console.log(`  - Balance: ${ethers_1.ethers.formatUnits(balance, decimals)} ${symbol}`);
-    }
-    catch (error) {
-        console.error('❌ Test 5 failed:', error);
-    }
-}
-exports.CheckTokenBalance = CheckTokenBalance;
-/**
- * Legacy example for basic AA operations
- */
-async function basicExample() {
-    console.log('\n=== Basic AA SDK Example ===');
-    // Initialize SDK
-    const sdk = new gokite_aa_sdk_1.GokiteAASDK('kite_testnet', 'https://rpc-testnet.gokite.ai', 'http://localhost:14337/rpc/');
-    const owner = '0x4A50DCA63d541372ad36E5A36F1D542d51164F19';
-    const accountAddress = sdk.getAccountAddress(owner);
-    console.log('Account address:', accountAddress);
-    // Simple ETH transfer example
-    const sendEthRequest = {
-        target: '0x4A50DCA63d541372ad36E5A36F1D542d51164F19',
-        value: ethers_1.ethers.parseEther('0.001'),
-        callData: '0x'
-    };
-    const signFunction = async (userOpHash) => {
-        const signer_pk = process.env.PRIVATE_KEY;
-        const signer = new ethers_1.ethers.Wallet(signer_pk);
-        return signer.signMessage(ethers_1.ethers.getBytes(userOpHash));
-    };
-    try {
-        const result = await sdk.sendUserOperationAndWait(owner, sendEthRequest, signFunction);
-        if (result.status.status === 'success') {
-            console.log('✅ ETH transfer successful!');
-            console.log('Transaction hash:', result.status.transactionHash);
-        }
-        else {
-            console.log('❌ ETH transfer failed:', result.status.reason);
-        }
-    }
-    catch (error) {
-        console.error('❌ Basic example failed:', error);
-    }
-}
-exports.basicExample = basicExample;
-/**
- * Parse ContractCreated event from transaction logs to get deployed proxy address
- * Event: ContractCreated(address indexed contractAddress)
- */
-async function parseContractCreatedEvent(transactionHash) {
-    try {
-        const provider = new ethers_1.ethers.JsonRpcProvider('https://rpc-testnet.gokite.ai');
-        const receipt = await provider.getTransactionReceipt(transactionHash);
-        if (!receipt) {
-            console.error('Transaction receipt not found');
-            return null;
-        }
-        // ContractCreated event signature: ContractCreated(address indexed contractAddress)
-        const contractCreatedEventSignature = ethers_1.ethers.id('ContractCreated(address)');
-        console.log('Parsing transaction logs...');
-        console.log(`Total logs: ${receipt.logs.length}`);
-        for (const log of receipt.logs) {
-            // Check if this log matches the ContractCreated event
-            if (log.topics[0] === contractCreatedEventSignature) {
-                // The first topic is the event signature
-                // The second topic is the indexed contractAddress
-                const contractAddress = ethers_1.ethers.AbiCoder.defaultAbiCoder().decode(['address'], log.topics[1])[0];
-                console.log('Found ContractCreated event:');
-                console.log('- Contract Address:', contractAddress);
-                console.log('- From Address:', log.address);
-                return contractAddress;
-            }
-        }
-        console.log('No ContractCreated event found in transaction logs');
-        return null;
-    }
-    catch (error) {
-        console.error('Error parsing ContractCreated event:', error);
-        return null;
-    }
-}
-async function main() {
-    // Run ClientAgentVault integration tests
-    await clientAgentVaultIntegrationTests();
-    // // Run basic AA example
-    // await basicExample();
-    console.log('\n✅ All examples completed!');
-}
-// Legacy export for backwards compatibility
-exports.example = basicExample;
-main().catch(console.error);