@aastar/enduser 0.16.16 → 0.16.18

package/dist/enduser/src/CommunityClient.d.ts

@@ -30,6 +30,18 @@ export declare class CommunityClient extends BaseClient {
      * 3. Linking the Token to the Community in Registry
      */
     createCommunityToken(params: CreateCommunityParams, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Get Community Details (Decodes Role Metadata)
+     * @param communityAddress - The address of the community manager (defaults to self)
+     */
+    getCommunityInfo(communityAddress?: Address): Promise<{
+        name: string;
+        ensName: string;
+        website: string;
+        description: string;
+        logoURI: string;
+        stakeAmount: bigint;
+    }>;
     /**
      * Register self as a Community Manager.
      * This method handles all necessary steps:

package/dist/enduser/src/CommunityClient.js

@@ -45,6 +45,48 @@ export class CommunityClient extends BaseClient {
             throw error;
         }
     }
+    /**
+     * Get Community Details (Decodes Role Metadata)
+     * @param communityAddress - The address of the community manager (defaults to self)
+     */
+    async getCommunityInfo(communityAddress) {
+        try {
+            const target = communityAddress || this.getAddress();
+            const registryAddr = this.requireRegistry();
+            const registry = registryActions(registryAddr);
+            const publicClient = this.getStartPublicClient();
+            // 1. Get Role ID
+            const API_ROLE_COMMUNITY = await registry(publicClient).ROLE_COMMUNITY();
+            // 2. Fetch Metadata (Hex)
+            const metadataHex = await registry(publicClient).roleMetadata({
+                roleId: API_ROLE_COMMUNITY,
+                user: target
+            });
+            if (!metadataHex || metadataHex === '0x') {
+                throw new Error('No metadata found for this community');
+            }
+            // 3. Decode
+            // struct CommunityRoleData { string name; string ensName; string website; string description; string logoURI; uint256 stakeAmount; }
+            let dataToDecode = metadataHex;
+            // Check for common 'bytes' or 'tuple' wrapper offset (0x20)
+            if (metadataHex.startsWith('0x0000000000000000000000000000000000000000000000000000000000000020')) {
+                dataToDecode = `0x${metadataHex.slice(66)}`;
+            }
+            const { decodeAbiParameters, parseAbiParameters } = await import('viem');
+            const [name, ensName, website, description, logoURI, stakeAmount] = decodeAbiParameters(parseAbiParameters('string, string, string, string, string, uint256'), dataToDecode);
+            return {
+                name,
+                ensName,
+                website,
+                description,
+                logoURI,
+                stakeAmount
+            };
+        }
+        catch (error) {
+            throw error;
+        }
+    }
     /**
      * Register self as a Community Manager.
      * This method handles all necessary steps:

package/dist/enduser/src/UserClient.d.ts

@@ -19,6 +19,25 @@ export declare class UserClient extends BaseClient {
     gTokenAddress?: Address;
     bundlerClient?: any;
     constructor(config: UserClientConfig);
+    /**
+     * Deploy a new Smart Account (Supports multiple factory types)
+     * Static helper to facilitate onboarding before instantiating the UserClient.
+     *
+     * @param client - WalletClient to sign the deployment transaction
+     * @param params - Deployment parameters
+     * @returns Object containing the deployed account address and transaction hash
+     */
+    static deployAccount(client: any, params: {
+        owner: Address;
+        salt?: bigint;
+        factoryAddress?: Address;
+        publicClient?: any;
+        accountType?: 'simple' | 'kernel' | 'safe' | string;
+        customAbi?: any;
+    }): Promise<{
+        accountAddress: Address;
+        hash: Hash;
+    }>;
     /**
      * Get the nonce of the account from EntryPoint (more reliable for 4337)
      */

package/dist/enduser/src/UserClient.js

@@ -20,6 +20,45 @@ export class UserClient extends BaseClient {
         this.registryAddress = config.registryAddress;
         this.gTokenAddress = config.gTokenAddress;
     }
+    /**
+     * Deploy a new Smart Account (Supports multiple factory types)
+     * Static helper to facilitate onboarding before instantiating the UserClient.
+     *
+     * @param client - WalletClient to sign the deployment transaction
+     * @param params - Deployment parameters
+     * @returns Object containing the deployed account address and transaction hash
+     */
+    static async deployAccount(client, params) {
+        const { accountFactoryActions, SimpleAccountFactoryABI } = await import('@aastar/core');
+        // 1. Determine Factory ABI (Ensure it's the raw ABI array)
+        let abi = params.customAbi || (SimpleAccountFactoryABI?.abi || SimpleAccountFactoryABI);
+        // In the future, we can add more built-in ABIs here based on accountType
+        // if (params.accountType === 'kernel') abi = KernelFactoryABI;
+        const factoryAddr = params.factoryAddress || '0x9406Cc6185a346906296840746125a0E44976454'; // Default v0.7 Factory
+        const salt = params.salt || 0n;
+        // Use publicClient for reading if provided, otherwise fallback to client (which might be a Full Client)
+        const readClient = params.publicClient || client;
+        // Use the generic actions with the selected ABI
+        const factoryRead = accountFactoryActions(factoryAddr, abi)(readClient);
+        const factoryWrite = accountFactoryActions(factoryAddr, abi)(client);
+        // 1. Predict Address
+        const accountAddress = await factoryRead.getAddress({
+            owner: params.owner,
+            salt
+        });
+        // 2. Deploy
+        try {
+            const hash = await factoryWrite.createAccount({
+                owner: params.owner,
+                salt,
+                account: client.account
+            });
+            return { accountAddress, hash };
+        }
+        catch (error) {
+            throw error;
+        }
+    }
     // ========================================
     // 1. 账户基本操作 (基于 L1 simpleAccountActions)
     // ========================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aastar/enduser",
-  "version": "0.16.16",
+  "version": "0.16.18",
   "publishConfig": {
     "access": "public"
   },
@@ -20,7 +20,7 @@
   "license": "MIT",
   "dependencies": {
     "viem": "2.43.3",
-    "@aastar/core": "0.16.16"
+    "@aastar/core": "0.16.18"
   },
   "devDependencies": {
     "typescript": "5.7.2",