@aastar/sdk 0.20.8 → 0.20.9

package/dist/chunk-WQREDGUF.cjs

@@ -0,0 +1,435 @@
+'use strict';
+
+var chunkFTJD2DWE_cjs = require('./chunk-FTJD2DWE.cjs');
+var viem = require('viem');
+
+var CommunityClient = class extends chunkFTJD2DWE_cjs.BaseClient {
+  sbtAddress;
+  factoryAddress;
+  reputationAddress;
+  constructor(config) {
+    super(config);
+    this.sbtAddress = config.sbtAddress;
+    this.factoryAddress = config.factoryAddress;
+    this.reputationAddress = config.reputationAddress;
+  }
+  // ========================================
+  // 1. 社区创建与配置
+  // ========================================
+  /**
+   * Create a new Community Token (xPNTs) and register it.
+   * Note: In the current architecture, creating a community often involves:
+   * 1. Registering the ROLE_COMMUNITY on Registry (if not exists) -> usually manual or self-register
+   * 2. Deploying a Token (xPNTs) via Factory
+   * 3. Linking the Token to the Community in Registry
+   */
+  async createCommunityToken(params, options) {
+    try {
+      if (!this.factoryAddress) {
+        throw new Error("Factory address required for this client");
+      }
+      const factory = chunkFTJD2DWE_cjs.xPNTsFactoryActions(this.factoryAddress);
+      return await factory(this.client).createToken({
+        name: params.name,
+        symbol: params.tokenSymbol,
+        community: this.getAddress(),
+        account: options?.account
+      });
+    } catch (error) {
+      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 = chunkFTJD2DWE_cjs.registryActions(registryAddr);
+      const publicClient = this.getStartPublicClient();
+      const API_ROLE_COMMUNITY = await registry(publicClient).ROLE_COMMUNITY();
+      let metadataHex;
+      try {
+        metadataHex = await registry(publicClient).roleMetadata({
+          roleId: API_ROLE_COMMUNITY,
+          user: target
+        });
+      } catch (err) {
+        const m = (err instanceof Error ? `${err.message} ${err.cause?.message ?? ""}` : String(err)).toLowerCase();
+        const isContractGap = m.includes("revert") || m.includes("returned no data") || m.includes("does not exist") || m.includes("is not a function") || m.includes("no data was returned");
+        if (!isContractGap) throw err;
+        metadataHex = void 0;
+      }
+      if (!metadataHex || metadataHex === "0x") {
+        let stakeAmount2 = 0n;
+        try {
+          stakeAmount2 = await registry(publicClient).roleStakes({ roleId: API_ROLE_COMMUNITY, user: target });
+        } catch {
+        }
+        return { name: "", ensName: "", website: "", description: "", logoURI: "", stakeAmount: stakeAmount2 };
+      }
+      let dataToDecode = metadataHex;
+      if (metadataHex.startsWith("0x0000000000000000000000000000000000000000000000000000000000000020")) {
+        dataToDecode = `0x${metadataHex.slice(66)}`;
+      }
+      const { decodeAbiParameters, parseAbiParameters: parseAbiParameters2 } = await import('viem');
+      const [name, ensName, website, description, logoURI, stakeAmount] = decodeAbiParameters(
+        parseAbiParameters2("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:
+   * 1. Checks and approves GToken to GTokenStaking
+   * 2. Encodes CommunityRoleData with provided parameters
+   * 3. Calls registerRoleSelf on Registry
+   * 
+   * @param params Community registration parameters
+   * @param options Transaction options
+   * @returns Transaction hash
+   */
+  async registerAsCommunity(params, options) {
+    try {
+      const registryAddr = this.requireRegistry();
+      const registry = chunkFTJD2DWE_cjs.registryActions(registryAddr);
+      const gTokenStakingAddr = this.requireGTokenStaking();
+      const gTokenAddr = this.requireGToken();
+      const roleCommunity = await registry(this.getStartPublicClient()).ROLE_COMMUNITY();
+      const stakeAmount = params.stakeAmount || viem.parseEther("30");
+      const gToken = chunkFTJD2DWE_cjs.tokenActions();
+      const allowance = await gToken(this.getStartPublicClient()).allowance({
+        token: gTokenAddr,
+        owner: this.getAddress(),
+        spender: gTokenStakingAddr
+      });
+      if (allowance < stakeAmount) {
+        const approveHash = await gToken(this.client).approve({
+          token: gTokenAddr,
+          spender: gTokenStakingAddr,
+          amount: stakeAmount * BigInt(2),
+          // Approve 2x for future use
+          account: options?.account
+        });
+        await this.getStartPublicClient().waitForTransactionReceipt({ hash: approveHash });
+      }
+      const communityData = viem.encodeAbiParameters(
+        viem.parseAbiParameters("string, string, string, string, string, uint256"),
+        [
+          params.name,
+          params.ensName || "",
+          params.website || "",
+          params.description || `${params.name} Community`,
+          params.logoURI || "",
+          stakeAmount
+        ]
+      );
+      return await registry(this.client).registerRoleSelf({
+        roleId: roleCommunity,
+        data: communityData,
+        account: options?.account
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+  /**
+   * One-click Setup: Register Community + Deploy Token
+   * Orchestrates the complete community initialization flow.
+   */
+  async setupCommunity(params, options) {
+    const hashes = [];
+    let tokenAddress = "0x0000000000000000000000000000000000000000";
+    const registry = chunkFTJD2DWE_cjs.registryActions(this.requireRegistry())(this.getStartPublicClient());
+    const ROLE_COMMUNITY = await registry.ROLE_COMMUNITY();
+    const hasRole = await registry.hasRole({ roleId: ROLE_COMMUNITY, user: this.getAddress() });
+    if (!hasRole) {
+      const hReg = await this.registerAsCommunity({
+        name: params.name,
+        ensName: params.website,
+        // Mapping website to ENS param for now as per legacy behavior
+        website: params.website,
+        description: params.description,
+        logoURI: params.logoURI,
+        stakeAmount: params.stakeAmount
+      }, options);
+      hashes.push(hReg);
+      await this.getStartPublicClient().waitForTransactionReceipt({ hash: hReg });
+    }
+    if (this.factoryAddress) {
+      const factoryReader = chunkFTJD2DWE_cjs.xPNTsFactoryActions(this.factoryAddress)(this.getStartPublicClient());
+      const existingToken = await factoryReader.getTokenAddress({ community: this.getAddress() });
+      if (existingToken && existingToken !== "0x0000000000000000000000000000000000000000") {
+        tokenAddress = existingToken;
+      } else {
+        const hToken = await this.createCommunityToken({
+          name: params.tokenName,
+          tokenSymbol: params.tokenSymbol,
+          description: params.description
+        }, options);
+        hashes.push(hToken);
+        await this.getStartPublicClient().waitForTransactionReceipt({ hash: hToken });
+        for (let i = 0; i < 5; i++) {
+          tokenAddress = await factoryReader.getTokenAddress({ community: this.getAddress() });
+          if (tokenAddress && tokenAddress !== "0x0000000000000000000000000000000000000000") break;
+          await new Promise((r) => setTimeout(r, 2e3));
+        }
+        if (!tokenAddress || tokenAddress === "0x0000000000000000000000000000000000000000") {
+          console.warn(`Warning: Token address not found after 10s. Factory might be slow indexing.`);
+        }
+      }
+    }
+    return { tokenAddress, hashes };
+  }
+  // ========================================
+  // 2. 成员管理
+  // ========================================
+  /**
+   * Airdrop SBTs to users to make them members
+   */
+  async airdropSBT(users, roleId, options) {
+    try {
+      if (!this.sbtAddress) throw new Error("SBT address required for this client");
+      const sbt = chunkFTJD2DWE_cjs.sbtActions(this.sbtAddress);
+      if (users.length === 1) {
+        const roleIdHex = `0x${roleId.toString(16).padStart(64, "0")}`;
+        return await sbt(this.client).mintForRole({
+          user: users[0],
+          roleId: roleIdHex,
+          roleData: "0x",
+          account: options?.account
+        });
+      }
+      throw new Error("Batch airdrop not fully implemented in L1 yet, use single user");
+    } catch (error) {
+      throw error;
+    }
+  }
+  // ========================================
+  // 3. 信誉系统
+  // ========================================
+  async setReputationRule(ruleId, ruleConfig, options) {
+    try {
+      if (!this.reputationAddress) throw new Error("Reputation address required for this client");
+      const reputation = chunkFTJD2DWE_cjs.reputationActions(this.reputationAddress);
+      const ruleIdHex = `0x${ruleId.toString(16).padStart(64, "0")}`;
+      return await reputation(this.client).setReputationRule({
+        ruleId: ruleIdHex,
+        rule: ruleConfig,
+        account: options?.account
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+  // ========================================
+  // 4. 管理功能
+  // ========================================
+  /**
+   * Revoke membership (Burn SBT)
+   */
+  async revokeMembership(userAddr, options) {
+    try {
+      if (!this.sbtAddress) throw new Error("SBT address required for this client");
+      const sbt = chunkFTJD2DWE_cjs.sbtActions(this.sbtAddress);
+      return await sbt(this.client).burnSBT({
+        user: userAddr,
+        account: options?.account
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+  /**
+   * Transfer ownership of the Community Token
+   */
+  async transferCommunityTokenOwnership(tokenAddress, newOwner, options) {
+    try {
+      const token = chunkFTJD2DWE_cjs.tokenActions()(this.client);
+      return await token.transferOwnership({
+        token: tokenAddress,
+        newOwner,
+        account: options?.account
+      });
+    } catch (error) {
+      throw error;
+    }
+  }
+};
+var UserLifecycle = class extends chunkFTJD2DWE_cjs.BaseClient {
+  accountAddress;
+  registryAddress;
+  sbtAddress;
+  gTokenAddress;
+  gTokenStakingAddress;
+  entryPointAddress;
+  gaslessConfig;
+  config;
+  constructor(config) {
+    super(config);
+    this.config = config;
+    this.accountAddress = config.accountAddress;
+    this.registryAddress = config.registryAddress;
+    this.sbtAddress = config.sbtAddress;
+    this.gTokenAddress = config.gTokenAddress;
+    this.gTokenStakingAddress = config.gTokenStakingAddress;
+    this.entryPointAddress = config.entryPointAddress;
+    this.gaslessConfig = config.gasless;
+  }
+  // ===========================================
+  // 1. Onboarding Phase (Registration)
+  // ===========================================
+  /**
+   * Check if user is eligible to join a community
+   * @param community Address of the community
+   */
+  async checkEligibility(community) {
+    const publicClient = this.getStartPublicClient();
+    chunkFTJD2DWE_cjs.registryActions(this.registryAddress)(publicClient);
+    return true;
+  }
+  /**
+   * One-click Onboarding: Approve -> Stake -> Register -> Mint SBT
+   * @param community Address of the community to join
+   * @param stakeAmount Amount of GToken to stake (default 0.4 GT)
+   */
+  async onboard(community, stakeAmount = viem.parseEther("0.4")) {
+    try {
+      const registry = chunkFTJD2DWE_cjs.registryActions(this.registryAddress)(this.getStartPublicClient());
+      const userClient = await import('./UserClient-2J6XMTNV.cjs').then((m) => new m.UserClient({
+        ...this.config,
+        accountAddress: this.accountAddress,
+        registryAddress: this.registryAddress,
+        gTokenStakingAddress: this.gTokenStakingAddress,
+        gTokenAddress: this.gTokenAddress,
+        sbtAddress: this.sbtAddress
+      }));
+      const txHash = await userClient.registerAsEndUser(community, stakeAmount);
+      let hasRole = false;
+      for (let i = 0; i < 5; i++) {
+        hasRole = await registry.hasRole({
+          roleId: await registry.ROLE_ENDUSER(),
+          user: this.accountAddress
+        });
+        if (hasRole) break;
+        await new Promise((r) => setTimeout(r, 2e3));
+      }
+      return {
+        success: hasRole,
+        txHash
+      };
+    } catch (error) {
+      console.error("Onboarding failed:", error);
+      return { success: false };
+    }
+  }
+  /**
+   * Enable or update Gasless configuration
+   */
+  async enableGasless(config) {
+    this.gaslessConfig = config;
+  }
+  // ===========================================
+  // 2. Operational Phase (Execute & Interact)
+  // ===========================================
+  /**
+   * Execute a transaction effectively using Gasless configuration if available
+   */
+  async executeGaslessTx(params) {
+    if (!this.gaslessConfig) {
+      throw new Error("Gasless configuration not enabled. Call enableGasless() first.");
+    }
+    const userClient = await import('./UserClient-2J6XMTNV.cjs').then((m) => new m.UserClient({
+      ...this.config,
+      accountAddress: this.accountAddress,
+      // Pass minimal config needed for execution
+      entryPointAddress: this.entryPointAddress,
+      bundlerClient: this.config.bundlerClient
+    }));
+    const paymasterType = this.gaslessConfig.policy === "CREDIT" ? "Super" : "V4";
+    const registry = chunkFTJD2DWE_cjs.registryActions(this.registryAddress)(this.client);
+    const paymasterAddress = await registry.SUPER_PAYMASTER();
+    return await userClient.executeGasless({
+      target: params.target,
+      value: params.value,
+      data: params.data,
+      paymaster: paymasterAddress,
+      paymasterType,
+      operator: params.operator
+    });
+  }
+  async claimSBT(roleId, options) {
+    const userClient = await import('./UserClient-2J6XMTNV.cjs').then((m) => new m.UserClient({
+      ...this.config,
+      accountAddress: this.accountAddress,
+      sbtAddress: this.sbtAddress
+    }));
+    return await userClient.mintSBT(roleId, options);
+  }
+  // ===========================================
+  // 3. Query Phase (Info & Stats)
+  // ===========================================
+  async getMyReputation() {
+    const publicClient = this.getStartPublicClient();
+    const registry = chunkFTJD2DWE_cjs.registryActions(this.registryAddress)(publicClient);
+    const [score, creditLimit] = await Promise.all([
+      registry.globalReputation({ user: this.accountAddress }),
+      registry.getCreditLimit({ user: this.accountAddress })
+    ]);
+    return {
+      score,
+      level: 0n,
+      // TODO: Add level calculation logic
+      creditLimit
+    };
+  }
+  async getCreditLimit() {
+    const registry = chunkFTJD2DWE_cjs.registryActions(this.registryAddress)(this.client);
+    return await registry.getCreditLimit({ user: this.accountAddress });
+  }
+  // ===========================================
+  // 4. Exit Phase (Cleanup)
+  // ===========================================
+  async leaveCommunity(community, options) {
+    const userClient = await import('./UserClient-2J6XMTNV.cjs').then((m) => new m.UserClient({
+      ...this.config,
+      accountAddress: this.accountAddress,
+      sbtAddress: this.sbtAddress
+    }));
+    return await userClient.leaveCommunity(community, options);
+  }
+  async exitRole(roleId, options) {
+    const userClient = await import('./UserClient-2J6XMTNV.cjs').then((m) => new m.UserClient({
+      ...this.config,
+      accountAddress: this.accountAddress,
+      registryAddress: this.registryAddress
+    }));
+    return await userClient.exitRole(roleId, options);
+  }
+  async unstakeAll(roleId, options) {
+    const userClient = await import('./UserClient-2J6XMTNV.cjs').then((m) => new m.UserClient({
+      ...this.config,
+      accountAddress: this.accountAddress,
+      gTokenStakingAddress: this.gTokenStakingAddress
+    }));
+    return await userClient.unstakeFromRole(roleId, options);
+  }
+};
+
+exports.CommunityClient = CommunityClient;
+exports.UserLifecycle = UserLifecycle;
+//# sourceMappingURL=chunk-WQREDGUF.cjs.map
+//# sourceMappingURL=chunk-WQREDGUF.cjs.map

package/dist/chunk-WQREDGUF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../enduser/src/CommunityClient.ts","../../enduser/src/UserLifecycle.ts"],"names":["BaseClient","xPNTsFactoryActions","registryActions","stakeAmount","parseAbiParameters","parseEther","tokenActions","encodeAbiParameters","sbtActions","reputationActions"],"mappings":"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","file":"chunk-WQREDGUF.cjs","sourcesContent":["import { type Address, type Hash, type Hex, parseEther, encodeAbiParameters, parseAbiParameters } from 'viem';\nimport { BaseClient, type ClientConfig, type TransactionOptions } from '@aastar/core';\nimport { registryActions, sbtActions, xPNTsFactoryActions, reputationActions, tokenActions } from '@aastar/core';\n\nexport interface CommunityClientConfig extends ClientConfig {\n    sbtAddress?: Address;\n    factoryAddress?: Address;\n    reputationAddress?: Address;\n}\n\nexport interface CreateCommunityParams {\n    name: string;\n    tokenSymbol: string;\n    ensName?: string;\n    description?: string;\n}\n\nexport interface CommunityInfo {\n    address: Address; // Community ID (hash) usually, but here likely the SBT/profile? No, Community in Registry is bytes32 ID.\n    // Wait, Registry defines Community as a Role (ROLE_COMMUNITY).\n    // The \"Community\" entity usually implies a collection of contracts (Token, maybe Paymaster).\n}\n\n/**\n * Client for Community Managers (`ROLE_COMMUNITY`)\n */\nexport class CommunityClient extends BaseClient {\n    public sbtAddress?: Address;\n    public factoryAddress?: Address;\n    public reputationAddress?: Address;\n\n    constructor(config: CommunityClientConfig) {\n        super(config);\n        this.sbtAddress = config.sbtAddress;\n        this.factoryAddress = config.factoryAddress;\n        this.reputationAddress = config.reputationAddress;\n    }\n\n    // ========================================\n    // 1. 社区创建与配置\n    // ========================================\n\n    /**\n     * Create a new Community Token (xPNTs) and register it.\n     * Note: In the current architecture, creating a community often involves:\n     * 1. Registering the ROLE_COMMUNITY on Registry (if not exists) -> usually manual or self-register\n     * 2. Deploying a Token (xPNTs) via Factory\n     * 3. Linking the Token to the Community in Registry\n     */\n    async createCommunityToken(params: CreateCommunityParams, options?: TransactionOptions): Promise<Hash> {\n        try {\n            if (!this.factoryAddress) {\n                throw new Error('Factory address required for this client');\n            }\n            const factory = xPNTsFactoryActions(this.factoryAddress);\n\n            // 1. Deploy Token\n            // Note: The address calculation should be handled via event parsing or predictive deployment\n            // For now, returning the transaction hash as per L1 pattern\n            return await factory(this.client).createToken({\n                name: params.name,\n                symbol: params.tokenSymbol,\n                community: this.getAddress(),\n                account: options?.account\n            });\n        } catch (error) {\n            // Error is likely already an AAStarError from L1, but we wrap it for context\n            throw error; \n        }\n    }\n\n    /**\n     * Get Community Details (Decodes Role Metadata)\n     * @param communityAddress - The address of the community manager (defaults to self)\n     */\n    async getCommunityInfo(communityAddress?: Address): Promise<{\n        name: string;\n        ensName: string;\n        website: string;\n        description: string;\n        logoURI: string;\n        stakeAmount: bigint;\n    }> {\n        try {\n            const target = communityAddress || this.getAddress();\n            const registryAddr = this.requireRegistry();\n            const registry = registryActions(registryAddr);\n            const publicClient = this.getStartPublicClient();\n            \n            // 1. Get Role ID\n            const API_ROLE_COMMUNITY = await registry(publicClient).ROLE_COMMUNITY();\n\n            // 2. Fetch Metadata (Hex).\n            // NOTE: in the deployed v5 Registry, `roleMetadata` is an INTERNAL mapping with no\n            // public getter (the rich community profile — name/website/logo — is written on\n            // registerRole but not readable on-chain). When the getter is absent the call\n            // reverts; degrade gracefully to the on-chain-readable fields (stake) with an\n            // empty profile rather than throwing, so callers can still resolve the community.\n            let metadataHex: Hex | undefined;\n            try {\n                metadataHex = await registry(publicClient).roleMetadata({\n                    roleId: API_ROLE_COMMUNITY,\n                    user: target\n                });\n            } catch (err) {\n                // Degrade ONLY on contract-level \"no getter / reverted\" errors — the deployed\n                // v5 Registry genuinely lacks a public roleMetadata getter. Re-throw genuine\n                // transport/RPC errors so a transient network failure is not silently masked as\n                // \"no community profile\".\n                const m = (err instanceof Error ? `${err.message} ${(err as { cause?: { message?: string } }).cause?.message ?? ''}` : String(err)).toLowerCase();\n                const isContractGap =\n                    m.includes('revert') || m.includes('returned no data') ||\n                    m.includes('does not exist') || m.includes('is not a function') ||\n                    m.includes('no data was returned');\n                if (!isContractGap) throw err;\n                metadataHex = undefined;\n            }\n\n            if (!metadataHex || metadataHex === '0x') {\n                let stakeAmount = 0n;\n                try {\n                    stakeAmount = await registry(publicClient).roleStakes({ roleId: API_ROLE_COMMUNITY, user: target });\n                } catch { /* stake unreadable too — leave 0 */ }\n                return { name: '', ensName: '', website: '', description: '', logoURI: '', stakeAmount };\n            }\n\n            // 3. Decode\n            // struct CommunityRoleData { string name; string ensName; string website; string description; string logoURI; uint256 stakeAmount; }\n            let dataToDecode = metadataHex;\n            \n            // Check for common 'bytes' or 'tuple' wrapper offset (0x20)\n            if (metadataHex.startsWith('0x0000000000000000000000000000000000000000000000000000000000000020')) {\n                dataToDecode = `0x${metadataHex.slice(66)}`; \n            }\n\n            const { decodeAbiParameters, parseAbiParameters } = await import('viem');\n            const [name, ensName, website, description, logoURI, stakeAmount] = decodeAbiParameters(\n                parseAbiParameters('string, string, string, string, string, uint256'),\n                dataToDecode as Hex\n            );\n\n            return {\n                name,\n                ensName,\n                website,\n                description,\n                logoURI,\n                stakeAmount\n            };\n        } catch (error) {\n            throw error;\n        }\n    }\n\n    /**\n     * Register self as a Community Manager.\n     * This method handles all necessary steps:\n     * 1. Checks and approves GToken to GTokenStaking\n     * 2. Encodes CommunityRoleData with provided parameters\n     * 3. Calls registerRoleSelf on Registry\n     * \n     * @param params Community registration parameters\n     * @param options Transaction options\n     * @returns Transaction hash\n     */\n    async registerAsCommunity(params: {\n        name: string;\n        ensName?: string;\n        website?: string;\n        description?: string;\n        logoURI?: string;\n        stakeAmount?: bigint;\n    }, options?: TransactionOptions): Promise<Hash> {\n        try {\n            const registryAddr = this.requireRegistry();\n            const registry = registryActions(registryAddr);\n            const gTokenStakingAddr = this.requireGTokenStaking();\n            const gTokenAddr = this.requireGToken();\n            \n            // 1. Get ROLE_COMMUNITY\n            const roleCommunity = await registry(this.getStartPublicClient()).ROLE_COMMUNITY();\n            \n            // 2. Prepare stake amount (default 30 GToken as per Registry config)\n            const stakeAmount = params.stakeAmount || parseEther('30');\n            \n            // 3. Check and approve GToken to GTokenStaking if needed\n            const gToken = tokenActions();\n            \n            const allowance = await gToken(this.getStartPublicClient()).allowance({\n                token: gTokenAddr,\n                owner: this.getAddress(),\n                spender: gTokenStakingAddr\n            });\n            \n            if (allowance < stakeAmount) {\n                const approveHash = await gToken(this.client).approve({\n                    token: gTokenAddr,\n                    spender: gTokenStakingAddr,\n                    amount: stakeAmount * BigInt(2), // Approve 2x for future use\n                    account: options?.account\n                });\n                await (this.getStartPublicClient() as any).waitForTransactionReceipt({ hash: approveHash });\n            }\n            \n            // 4. Encode CommunityRoleData\n            // struct CommunityRoleData { string name; string ensName; string website; string description; string logoURI; uint256 stakeAmount; }\n            const communityData = encodeAbiParameters(\n                parseAbiParameters('string, string, string, string, string, uint256'),\n                [\n                    params.name,\n                    params.ensName || '',\n                    params.website || '',\n                    params.description || `${params.name} Community`,\n                    params.logoURI || '',\n                    stakeAmount\n                ]\n            );\n            \n            // 5. Register role\n            return await registry(this.client).registerRoleSelf({\n                roleId: roleCommunity,\n                data: communityData,\n                account: options?.account\n            });\n        } catch (error) {\n            throw error;\n        }\n    }\n\n    /**\n     * One-click Setup: Register Community + Deploy Token\n     * Orchestrates the complete community initialization flow.\n     */\n    async setupCommunity(params: {\n        name: string;\n        tokenName: string;\n        tokenSymbol: string;\n        description?: string;\n        logoURI?: string;\n        website?: string;\n        stakeAmount?: bigint;\n    }, options?: TransactionOptions): Promise<{ tokenAddress: Address; hashes: Hash[] }> {\n        const hashes: Hash[] = [];\n        let tokenAddress: Address = '0x0000000000000000000000000000000000000000';\n\n        // 1. Register as Community (Idempotent check handled inside or by registry)\n        // We should check hasRole first to avoid errors if already registered\n        const registry = registryActions(this.requireRegistry())(this.getStartPublicClient());\n        const ROLE_COMMUNITY = await registry.ROLE_COMMUNITY();\n        const hasRole = await registry.hasRole({ roleId: ROLE_COMMUNITY, user: this.getAddress() });\n\n        if (!hasRole) {\n            const hReg = await this.registerAsCommunity({\n                name: params.name,\n                ensName: params.website, // Mapping website to ENS param for now as per legacy behavior\n                website: params.website,\n                description: params.description,\n                logoURI: params.logoURI,\n                stakeAmount: params.stakeAmount\n            }, options);\n            hashes.push(hReg);\n            \n            // Critical: Factory requires caller to be registered in Registry.\n            // We must wait for the registration to be mined.\n            await (this.getStartPublicClient() as any).waitForTransactionReceipt({ hash: hReg });\n        }\n\n        // 2. Deploy Token (Idempotent check via Factory)\n        if (this.factoryAddress) {\n            const factoryReader = xPNTsFactoryActions(this.factoryAddress)(this.getStartPublicClient());\n            const existingToken = await factoryReader.getTokenAddress({ community: this.getAddress() });\n\n            if (existingToken && existingToken !== '0x0000000000000000000000000000000000000000') {\n                tokenAddress = existingToken;\n            } else {\n                const hToken = await this.createCommunityToken({\n                    name: params.tokenName,\n                    tokenSymbol: params.tokenSymbol,\n                    description: params.description\n                }, options);\n                hashes.push(hToken);\n                \n                // Critical: Wait for token deployment to fetch the address\n                await (this.getStartPublicClient() as any).waitForTransactionReceipt({ hash: hToken });\n                \n                // Fetch the actual address (with retries for latency)\n                for (let i = 0; i < 5; i++) {\n                    tokenAddress = await factoryReader.getTokenAddress({ community: this.getAddress() });\n                    if (tokenAddress && tokenAddress !== '0x0000000000000000000000000000000000000000') break;\n                    await new Promise(r => setTimeout(r, 2000));\n                }\n                \n                if (!tokenAddress || tokenAddress === '0x0000000000000000000000000000000000000000') {\n                    console.warn(`Warning: Token address not found after 10s. Factory might be slow indexing.`);\n                }\n            }\n        }\n\n        return { tokenAddress, hashes };\n    }\n\n    // ========================================\n    // 2. 成员管理\n    // ========================================\n\n    /**\n     * Airdrop SBTs to users to make them members\n     */\n    async airdropSBT(users: Address[], roleId: bigint, options?: TransactionOptions): Promise<Hash> {\n        try {\n            if (!this.sbtAddress) throw new Error('SBT address required for this client');\n            const sbt = sbtActions(this.sbtAddress);\n\n            if (users.length === 1) {\n                // Convert roleId to Hex (bytes32)\n                const roleIdHex = `0x${roleId.toString(16).padStart(64, '0')}` as Hash;\n\n                return await sbt(this.client).mintForRole({\n                    user: users[0],\n                    roleId: roleIdHex,\n                    roleData: '0x',\n                    account: options?.account\n                });\n            }\n            \n            throw new Error('Batch airdrop not fully implemented in L1 yet, use single user');\n        } catch (error) {\n            throw error;\n        }\n    }\n\n    // ========================================\n    // 3. 信誉系统\n    // ========================================\n\n    async setReputationRule(ruleId: bigint, ruleConfig: any, options?: TransactionOptions): Promise<Hash> {\n        try {\n            if (!this.reputationAddress) throw new Error('Reputation address required for this client');\n            const reputation = reputationActions(this.reputationAddress);\n            \n            const ruleIdHex = `0x${ruleId.toString(16).padStart(64, '0')}` as Hash;\n\n            return await reputation(this.client).setReputationRule({\n                ruleId: ruleIdHex,\n                rule: ruleConfig,\n                account: options?.account\n            });\n        } catch (error) {\n            throw error;\n        }\n    }\n\n    // ========================================\n    // 4. 管理功能\n    // ========================================\n\n    /**\n     * Revoke membership (Burn SBT)\n     */\n    async revokeMembership(userAddr: Address, options?: TransactionOptions): Promise<Hash> {\n        try {\n            if (!this.sbtAddress) throw new Error('SBT address required for this client');\n            const sbt = sbtActions(this.sbtAddress);\n            \n            return await sbt(this.client).burnSBT({\n                user: userAddr,\n                account: options?.account\n            });\n        } catch (error) {\n            throw error;\n        }\n    }\n\n    /**\n     * Transfer ownership of the Community Token\n     */\n    async transferCommunityTokenOwnership(tokenAddress: Address, newOwner: Address, options?: TransactionOptions): Promise<Hash> {\n        try {\n            const token = tokenActions()(this.client);\n            \n            return await token.transferOwnership({\n                token: tokenAddress,\n                newOwner,\n                account: options?.account\n            });\n        } catch (error) {\n            throw error;\n        }\n    }\n}\n","import { type Address, type Hash, type Hex, parseEther } from 'viem';\nimport { BaseClient, type ClientConfig, type TransactionOptions } from '@aastar/core';\nimport { registryActions, sbtActions, tokenActions, stakingActions, entryPointActions } from '@aastar/core'; // L2/L1 Actions\n\nexport interface GaslessConfig {\n    paymasterUrl: string;\n    policy?: 'CREDIT' | 'TOKEN' | 'SPONSORED';\n}\n\nexport interface UserLifecycleConfig extends ClientConfig {\n    accountAddress: Address;\n    registryAddress: Address;\n    sbtAddress: Address;\n    gTokenAddress: Address;\n    gTokenStakingAddress: Address;\n    entryPointAddress: Address;\n    gasless?: GaslessConfig; // Optional gasless config\n}\n\nexport interface OnboardResult {\n    success: boolean;\n    sbtId?: bigint;\n    txHash?: Hash;\n}\n\nexport interface ReputationData {\n    score: bigint;\n    level: bigint;\n    creditLimit: bigint;\n}\n\n/**\n * UserLifecycle - L3 Pattern\n * \n * Responsibilities:\n * 1. Managing the complete lifecycle of an End User (Onboard -> Operate -> Exit)\n * 2. Providing a unified interface for Gasless operations\n * 3. Abstracting underlying contract interactions via L2 Actions\n */\nexport class UserLifecycle extends BaseClient {\n    public accountAddress: Address;\n    public registryAddress: Address;\n    public sbtAddress: Address;\n    public gTokenAddress: Address;\n    public gTokenStakingAddress: Address;\n    public entryPointAddress: Address;\n    public gaslessConfig?: GaslessConfig;\n\n    public config: UserLifecycleConfig;\n\n    constructor(config: UserLifecycleConfig) {\n        super(config);\n        this.config = config;\n        this.accountAddress = config.accountAddress;\n        this.registryAddress = config.registryAddress;\n        this.sbtAddress = config.sbtAddress;\n        this.gTokenAddress = config.gTokenAddress;\n        this.gTokenStakingAddress = config.gTokenStakingAddress;\n        this.entryPointAddress = config.entryPointAddress;\n        this.gaslessConfig = config.gasless;\n    }\n\n    // ===========================================\n    // 1. Onboarding Phase (Registration)\n    // ===========================================\n\n    /**\n     * Check if user is eligible to join a community\n     * @param community Address of the community\n     */\n    async checkEligibility(community: Address): Promise<boolean> {\n        // Validation logic (e.g., check blacklist or whitelist via Registry)\n        const publicClient = this.getStartPublicClient();\n        const registry = registryActions(this.registryAddress)(publicClient);\n        // Placeholder: simplistic check, real logic might involve community specific rules\n        return true; \n    }\n\n    /**\n     * One-click Onboarding: Approve -> Stake -> Register -> Mint SBT\n     * @param community Address of the community to join\n     * @param stakeAmount Amount of GToken to stake (default 0.4 GT)\n     */\n    async onboard(community: Address, stakeAmount: bigint = parseEther('0.4')): Promise<OnboardResult> {\n        try {\n            const registry = registryActions(this.registryAddress)(this.getStartPublicClient());\n            const userClient = await import('./UserClient.js').then(m => new m.UserClient({\n                ...this.config,\n                accountAddress: this.accountAddress,\n                registryAddress: this.registryAddress,\n                gTokenStakingAddress: this.gTokenStakingAddress,\n                gTokenAddress: this.gTokenAddress,\n                sbtAddress: this.sbtAddress\n            }));\n\n            // Use UserClient's batch execution capability for atomic onboarding\n            const txHash = await userClient.registerAsEndUser(community, stakeAmount);\n            \n            // Post-check: Verify role with retry\n            let hasRole = false;\n            for (let i = 0; i < 5; i++) {\n                hasRole = await registry.hasRole({ \n                    roleId: await registry.ROLE_ENDUSER(), \n                    user: this.accountAddress \n                });\n                if (hasRole) break;\n                await new Promise(r => setTimeout(r, 2000));\n            }\n\n            return {\n                success: hasRole,\n                txHash\n            };\n        } catch (error) {\n            console.error(\"Onboarding failed:\", error);\n            return { success: false };\n        }\n    }\n\n    /**\n     * Enable or update Gasless configuration\n     */\n    async enableGasless(config: GaslessConfig): Promise<void> {\n        this.gaslessConfig = config;\n        // In future: verify paymaster connection here\n    }\n\n    // ===========================================\n    // 2. Operational Phase (Execute & Interact)\n    // ===========================================\n\n    /**\n     * Execute a transaction effectively using Gasless configuration if available\n     */\n    async executeGaslessTx(params: {\n        target: Address;\n        value: bigint;\n        data: Hex;\n        operator?: Address; // Optional specific operator\n    }): Promise<Hash> {\n        if (!this.gaslessConfig) {\n            throw new Error(\"Gasless configuration not enabled. Call enableGasless() first.\");\n        }\n\n        const userClient = await import('./UserClient.js').then(m => new m.UserClient({\n            ...this.config,\n            accountAddress: this.accountAddress,\n            // Pass minimal config needed for execution\n            entryPointAddress: this.entryPointAddress,\n            bundlerClient: (this.config as any).bundlerClient \n        }));\n\n        // Determine Paymaster Type based on policy\n        const paymasterType = this.gaslessConfig.policy === 'CREDIT' ? 'Super' : 'V4'; \n        // Note: Real implementation needs to resolve actual Paymaster Address from Registry/Config\n        // This is a placeholder address resolution\n        const registry = registryActions(this.registryAddress)(this.client);\n        const paymasterAddress = await registry.SUPER_PAYMASTER(); \n\n        return await userClient.executeGasless({\n            target: params.target,\n            value: params.value,\n            data: params.data,\n            paymaster: paymasterAddress,\n            paymasterType,\n            operator: params.operator\n        });\n    }\n\n    async claimSBT(roleId: Hex, options?: TransactionOptions): Promise<Hash> {\n        const userClient = await import('./UserClient.js').then(m => new m.UserClient({\n            ...this.config,\n            accountAddress: this.accountAddress,\n            sbtAddress: this.sbtAddress\n        }));\n        return await userClient.mintSBT(roleId, options);\n    }\n\n    // ===========================================\n    // 3. Query Phase (Info & Stats)\n    // ===========================================\n\n    async getMyReputation(): Promise<ReputationData> {\n        const publicClient = this.getStartPublicClient();\n        const registry = registryActions(this.registryAddress)(publicClient);\n        \n        const [score, creditLimit] = await Promise.all([\n            registry.globalReputation({ user: this.accountAddress }),\n            registry.getCreditLimit({ user: this.accountAddress })\n        ]);\n\n        return {\n            score,\n            level: 0n, // TODO: Add level calculation logic\n            creditLimit\n        };\n    }\n\n    async getCreditLimit(): Promise<bigint> {\n        const registry = registryActions(this.registryAddress)(this.client);\n        return await registry.getCreditLimit({ user: this.accountAddress });\n    }\n\n    // ===========================================\n    // 4. Exit Phase (Cleanup)\n    // ===========================================\n\n    async leaveCommunity(community: Address, options?: TransactionOptions): Promise<Hash> {\n        const userClient = await import('./UserClient.js').then(m => new m.UserClient({\n            ...this.config,\n            accountAddress: this.accountAddress,\n            sbtAddress: this.sbtAddress\n        }));\n        return await userClient.leaveCommunity(community, options);\n    }\n\n    async exitRole(roleId: Hex, options?: TransactionOptions): Promise<Hash> {\n        const userClient = await import('./UserClient.js').then(m => new m.UserClient({\n            ...this.config,\n            accountAddress: this.accountAddress,\n            registryAddress: this.registryAddress\n        }));\n        return await userClient.exitRole(roleId, options);\n    }\n\n    async unstakeAll(roleId: Hex, options?: TransactionOptions): Promise<Hash> {\n        const userClient = await import('./UserClient.js').then(m => new m.UserClient({\n            ...this.config,\n            accountAddress: this.accountAddress,\n            gTokenStakingAddress: this.gTokenStakingAddress\n        }));\n        return await userClient.unstakeFromRole(roleId, options);\n    }\n}\n"]}