gokite-aa-sdk 1.0.0

package/README.md

@@ -0,0 +1,141 @@
+# Gokite AA SDK
+
+Account Abstraction (EIP-4337) SDK for Gokite.
+
+## Installation
+
+```bash
+npm install gokite-aa-sdk
+```
+
+## Quick Start
+
+```typescript
+import { GokiteAASDK } from 'gokite-aa-sdk';
+import { ethers } from 'ethers';
+
+// Initialize SDK
+const sdk = new GokiteAASDK(
+  'kite_testnet',
+  'https://rpc-testnet.gokite.ai',
+  'http://localhost:14337/rpc/' // bundler URL
+);
+
+// Owner address (from your social login SDK)
+const owner = '0x...';
+
+// Get account address (can get aa wallet address even if the wallet is not deployed)
+const accountAddress = sdk.getAccountAddress(owner);
+
+// Sign function - integrate with your social login SDK
+const signFunction = async (userOpHash: string): Promise<string> => {
+  // Use your preferred signing method (Particle, Privy, etc.)
+  return await signer.sign(ethers.getBytes(userOpHash));
+};
+
+// Send transaction
+const userOpHash = await sdk.sendUserOperation(
+  owner,
+  {
+    target: '0x...',
+    value: ethers.parseEther('0.1'),
+    callData: '0x'
+  },
+  signFunction
+);
+
+// Wait for confirmation
+const status = await sdk.pollUserOperationStatus(userOpHash);
+console.log('Transaction status:', status);
+```
+
+## API Reference
+
+### GokiteAASDK
+
+#### Constructor
+
+```typescript
+new GokiteAASDK(network: string, rpcUrl: string, bundlerUrl?: string)
+```
+
+#### Methods
+
+- `getAccountAddress(owner: string, salt?: bigint): string` - Calculate account address
+- `sendUserOperation(owner: string, request: UserOperationRequest | BatchUserOperationRequest, signFn: SignFunction, salt?: bigint, paymasterAddress?: string): Promise<string>` - Send transaction
+- `pollUserOperationStatus(userOpHash: string, options: PollingOptions = {}): Promise<UserOperationStatus>` - Wait for confirmation
+- `isAccountDeloyed(accountAddress: string): Promise<boolean>` - Check if account is deployed
+
+### Types
+
+```typescript
+interface UserOperationRequest {
+  target: string;
+  value?: bigint;
+  callData: string;
+}
+
+interface BatchUserOperationRequest {
+  targets: string[];
+  values?: bigint[];
+  callDatas: string[];
+}
+
+interface SignFunction {
+  (userOpHash: string): Promise<string>;
+}
+```
+
+## Examples
+
+### Single Transaction
+
+```typescript
+const request = {
+  target: '0x...',
+  value: ethers.parseEther('0.1'),
+  callData: '0x'
+};
+
+const userOpHash = await sdk.sendUserOperation(owner, request, signFunction);
+```
+
+### Batch Transactions
+
+```typescript
+const batchRequest = {
+  targets: ['0x...', '0x...'],
+  values: [ethers.parseEther('0.1'), 0n],
+  callDatas: ['0x', '0x...']
+};
+
+const userOpHash = await sdk.sendUserOperation(owner, batchRequest, signFunction);
+```
+
+### Integration with Particle
+
+#### docs: 
+
+https://developers.particle.network/api-reference/auth/desktop-sdks/web#personal-signatures
+
+```typescript
+// After configuring AuthCoreContextProvider and logging in
+const { signMessage } = useEthereum();
+
+const signFunction = async (userOpHash: string): Promise<string> => {
+  return await signMessage(userOpHash)
+};
+```
+
+## Supported Networks
+
+- **kite_testnet**: Kite Testnet (Chain ID: 2368)
+
+## Requirements
+
+- Node.js >= 16
+- ethers >= 6.0.0
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface NetworkConfig {
+    chainId: number;
+    entryPoint: string;
+    accountFactory: string;
+    accountImplementation: string;
+    bundlerUrl?: string;
+    paymaster?: string;
+}
+export declare const NETWORKS: Record<string, NetworkConfig>;

package/dist/config.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORKS = void 0;
+exports.NETWORKS = {
+    kite_testnet: {
+        chainId: 2368,
+        entryPoint: '0x4337084D9E255Ff0702461CF8895CE9E3b5Ff108',
+        accountFactory: '0xF0Fc19F0dc393867F19351d25EDfc5E099561cb7',
+        accountImplementation: '0x93F5310eFd0f09db0666CA5146E63CA6Cdc6FC21',
+        paymaster: '0x122E0e1F7fFc0f5d64F5470CF42c6bA0abdF7158',
+    },
+};

package/dist/example.d.ts

@@ -0,0 +1,47 @@
+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.js

@@ -0,0 +1,397 @@
+"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', 'http://localhost:14337/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;
+/**
+ * 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);