@aastar/enduser 0.16.11

package/coverage/sorter.js

@@ -0,0 +1,210 @@
+/* eslint-disable */
+var addSorting = (function() {
+    'use strict';
+    var cols,
+        currentSort = {
+            index: 0,
+            desc: false
+        };
+
+    // returns the summary table element
+    function getTable() {
+        return document.querySelector('.coverage-summary');
+    }
+    // returns the thead element of the summary table
+    function getTableHeader() {
+        return getTable().querySelector('thead tr');
+    }
+    // returns the tbody element of the summary table
+    function getTableBody() {
+        return getTable().querySelector('tbody');
+    }
+    // returns the th element for nth column
+    function getNthColumn(n) {
+        return getTableHeader().querySelectorAll('th')[n];
+    }
+
+    function onFilterInput() {
+        const searchValue = document.getElementById('fileSearch').value;
+        const rows = document.getElementsByTagName('tbody')[0].children;
+
+        // Try to create a RegExp from the searchValue. If it fails (invalid regex),
+        // it will be treated as a plain text search
+        let searchRegex;
+        try {
+            searchRegex = new RegExp(searchValue, 'i'); // 'i' for case-insensitive
+        } catch (error) {
+            searchRegex = null;
+        }
+
+        for (let i = 0; i < rows.length; i++) {
+            const row = rows[i];
+            let isMatch = false;
+
+            if (searchRegex) {
+                // If a valid regex was created, use it for matching
+                isMatch = searchRegex.test(row.textContent);
+            } else {
+                // Otherwise, fall back to the original plain text search
+                isMatch = row.textContent
+                    .toLowerCase()
+                    .includes(searchValue.toLowerCase());
+            }
+
+            row.style.display = isMatch ? '' : 'none';
+        }
+    }
+
+    // loads the search box
+    function addSearchBox() {
+        var template = document.getElementById('filterTemplate');
+        var templateClone = template.content.cloneNode(true);
+        templateClone.getElementById('fileSearch').oninput = onFilterInput;
+        template.parentElement.appendChild(templateClone);
+    }
+
+    // loads all columns
+    function loadColumns() {
+        var colNodes = getTableHeader().querySelectorAll('th'),
+            colNode,
+            cols = [],
+            col,
+            i;
+
+        for (i = 0; i < colNodes.length; i += 1) {
+            colNode = colNodes[i];
+            col = {
+                key: colNode.getAttribute('data-col'),
+                sortable: !colNode.getAttribute('data-nosort'),
+                type: colNode.getAttribute('data-type') || 'string'
+            };
+            cols.push(col);
+            if (col.sortable) {
+                col.defaultDescSort = col.type === 'number';
+                colNode.innerHTML =
+                    colNode.innerHTML + '<span class="sorter"></span>';
+            }
+        }
+        return cols;
+    }
+    // attaches a data attribute to every tr element with an object
+    // of data values keyed by column name
+    function loadRowData(tableRow) {
+        var tableCols = tableRow.querySelectorAll('td'),
+            colNode,
+            col,
+            data = {},
+            i,
+            val;
+        for (i = 0; i < tableCols.length; i += 1) {
+            colNode = tableCols[i];
+            col = cols[i];
+            val = colNode.getAttribute('data-value');
+            if (col.type === 'number') {
+                val = Number(val);
+            }
+            data[col.key] = val;
+        }
+        return data;
+    }
+    // loads all row data
+    function loadData() {
+        var rows = getTableBody().querySelectorAll('tr'),
+            i;
+
+        for (i = 0; i < rows.length; i += 1) {
+            rows[i].data = loadRowData(rows[i]);
+        }
+    }
+    // sorts the table using the data for the ith column
+    function sortByIndex(index, desc) {
+        var key = cols[index].key,
+            sorter = function(a, b) {
+                a = a.data[key];
+                b = b.data[key];
+                return a < b ? -1 : a > b ? 1 : 0;
+            },
+            finalSorter = sorter,
+            tableBody = document.querySelector('.coverage-summary tbody'),
+            rowNodes = tableBody.querySelectorAll('tr'),
+            rows = [],
+            i;
+
+        if (desc) {
+            finalSorter = function(a, b) {
+                return -1 * sorter(a, b);
+            };
+        }
+
+        for (i = 0; i < rowNodes.length; i += 1) {
+            rows.push(rowNodes[i]);
+            tableBody.removeChild(rowNodes[i]);
+        }
+
+        rows.sort(finalSorter);
+
+        for (i = 0; i < rows.length; i += 1) {
+            tableBody.appendChild(rows[i]);
+        }
+    }
+    // removes sort indicators for current column being sorted
+    function removeSortIndicators() {
+        var col = getNthColumn(currentSort.index),
+            cls = col.className;
+
+        cls = cls.replace(/ sorted$/, '').replace(/ sorted-desc$/, '');
+        col.className = cls;
+    }
+    // adds sort indicators for current column being sorted
+    function addSortIndicators() {
+        getNthColumn(currentSort.index).className += currentSort.desc
+            ? ' sorted-desc'
+            : ' sorted';
+    }
+    // adds event listeners for all sorter widgets
+    function enableUI() {
+        var i,
+            el,
+            ithSorter = function ithSorter(i) {
+                var col = cols[i];
+
+                return function() {
+                    var desc = col.defaultDescSort;
+
+                    if (currentSort.index === i) {
+                        desc = !currentSort.desc;
+                    }
+                    sortByIndex(i, desc);
+                    removeSortIndicators();
+                    currentSort.index = i;
+                    currentSort.desc = desc;
+                    addSortIndicators();
+                };
+            };
+        for (i = 0; i < cols.length; i += 1) {
+            if (cols[i].sortable) {
+                // add the click event handler on the th so users
+                // dont have to click on those tiny arrows
+                el = getNthColumn(i).querySelector('.sorter').parentElement;
+                if (el.addEventListener) {
+                    el.addEventListener('click', ithSorter(i));
+                } else {
+                    el.attachEvent('onclick', ithSorter(i));
+                }
+            }
+        }
+    }
+    // adds sorting functionality to the UI
+    return function() {
+        if (!getTable()) {
+            return;
+        }
+        cols = loadColumns();
+        loadData();
+        addSearchBox();
+        addSortIndicators();
+        enableUI();
+    };
+})();
+
+window.addEventListener('load', addSorting);

package/dist/CommunityClient.d.ts

@@ -0,0 +1,65 @@
+import { type Address, type Hash } from 'viem';
+import { BaseClient, type ClientConfig, type TransactionOptions } from '@aastar/core';
+export interface CommunityClientConfig extends ClientConfig {
+    sbtAddress?: Address;
+    factoryAddress?: Address;
+    reputationAddress?: Address;
+}
+export interface CreateCommunityParams {
+    name: string;
+    tokenSymbol: string;
+    ensName?: string;
+    description?: string;
+}
+export interface CommunityInfo {
+    address: Address;
+}
+/**
+ * Client for Community Managers (`ROLE_COMMUNITY`)
+ */
+export declare class CommunityClient extends BaseClient {
+    sbtAddress?: Address;
+    factoryAddress?: Address;
+    reputationAddress?: Address;
+    constructor(config: CommunityClientConfig);
+    /**
+     * 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
+     */
+    createCommunityToken(params: CreateCommunityParams, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * 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
+     */
+    registerAsCommunity(params: {
+        name: string;
+        ensName?: string;
+        website?: string;
+        description?: string;
+        logoURI?: string;
+        stakeAmount?: bigint;
+    }, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Airdrop SBTs to users to make them members
+     */
+    airdropSBT(users: Address[], roleId: bigint, options?: TransactionOptions): Promise<Hash>;
+    setReputationRule(ruleId: bigint, ruleConfig: any, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Revoke membership (Burn SBT)
+     */
+    revokeMembership(userAddr: Address, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Transfer ownership of the Community Token
+     */
+    transferCommunityTokenOwnership(tokenAddress: Address, newOwner: Address, options?: TransactionOptions): Promise<Hash>;
+}

package/dist/CommunityClient.js

@@ -0,0 +1,188 @@
+import { parseEther, encodeAbiParameters, parseAbiParameters } from 'viem';
+import { BaseClient } from '@aastar/core';
+import { registryActions, sbtActions, xPNTsFactoryActions, reputationActions, tokenActions } from '@aastar/core';
+/**
+ * Client for Community Managers (`ROLE_COMMUNITY`)
+ */
+export class CommunityClient extends 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 = xPNTsFactoryActions(this.factoryAddress);
+            // 1. Deploy Token
+            // Note: The address calculation should be handled via event parsing or predictive deployment
+            // For now, returning the transaction hash as per L1 pattern
+            return await factory(this.client).createToken({
+                name: params.name,
+                symbol: params.tokenSymbol,
+                community: '0x0000000000000000000000000000000000000000', // Default empty community mapping
+                account: options?.account
+            });
+        }
+        catch (error) {
+            // Error is likely already an AAStarError from L1, but we wrap it for context
+            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 = registryActions(registryAddr);
+            const gTokenStakingAddr = this.requireGTokenStaking();
+            const gTokenAddr = this.requireGToken();
+            // 1. Get ROLE_COMMUNITY
+            const roleCommunity = await registry(this.getStartPublicClient()).ROLE_COMMUNITY();
+            // 2. Prepare stake amount (default 30 GToken as per Registry config)
+            const stakeAmount = params.stakeAmount || parseEther('30');
+            // 3. Check and approve GToken to GTokenStaking if needed
+            const gToken = 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 });
+            }
+            // 4. Encode CommunityRoleData
+            // struct CommunityRoleData { string name; string ensName; string website; string description; string logoURI; uint256 stakeAmount; }
+            const communityData = encodeAbiParameters(parseAbiParameters('string, string, string, string, string, uint256'), [
+                params.name,
+                params.ensName || '',
+                params.website || '',
+                params.description || `${params.name} Community`,
+                params.logoURI || '',
+                stakeAmount
+            ]);
+            // 5. Register role
+            return await registry(this.client).registerRoleSelf({
+                roleId: roleCommunity,
+                data: communityData,
+                account: options?.account
+            });
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    // ========================================
+    // 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 = sbtActions(this.sbtAddress);
+            if (users.length === 1) {
+                // Convert roleId to Hex (bytes32)
+                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 = 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 = 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 = tokenActions()(this.client);
+            return await token.transferOwnership({
+                token: tokenAddress,
+                newOwner,
+                account: options?.account
+            });
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}

package/dist/UserClient.d.ts

@@ -0,0 +1,87 @@
+import { type Address, type Hash, type Hex } from 'viem';
+import { BaseClient, type ClientConfig, type TransactionOptions } from '@aastar/core';
+export interface UserClientConfig extends ClientConfig {
+    accountAddress: Address;
+    sbtAddress?: Address;
+    entryPointAddress?: Address;
+    superPaymasterAddress?: Address;
+    gTokenStakingAddress?: Address;
+    registryAddress?: Address;
+    gTokenAddress?: Address;
+}
+export declare class UserClient extends BaseClient {
+    accountAddress: Address;
+    sbtAddress?: Address;
+    entryPointAddress?: Address;
+    gTokenStakingAddress?: Address;
+    registryAddress?: Address;
+    gTokenAddress?: Address;
+    constructor(config: UserClientConfig);
+    /**
+     * Get the nonce of the account from EntryPoint (more reliable for 4337)
+     */
+    getNonce(key?: bigint): Promise<bigint>;
+    /**
+     * Get the owner of the AA account
+     */
+    getOwner(): Promise<Address>;
+    /**
+     * Execute a transaction from the AA account
+     */
+    execute(target: Address, value: bigint, data: Hex, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Execute a batch of transactions
+     */
+    executeBatch(targets: Address[], values: bigint[], datas: Hex[], options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Get user's SBT balance
+     */
+    getSBTBalance(): Promise<bigint>;
+    /**
+     * Self-mint SBT for a role (user self-service)
+     */
+    mintSBT(roleId: Hex, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Transfer GToken or any ERC20
+     */
+    transferToken(token: Address, to: Address, amount: bigint, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Get Token Balance
+     */
+    getTokenBalance(token: Address): Promise<bigint>;
+    /**
+     * Delegate stake to a role (Delegate to an operator/community)
+     */
+    stakeForRole(roleId: Hex, amount: bigint, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Unstake from a role
+     */
+    unstakeFromRole(roleId: Hex, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Get staked balance for a specific role
+     */
+    getStakedBalance(roleId: Hex): Promise<bigint>;
+    /**
+     * Exit a specific role (Cleanup registry status)
+     */
+    exitRole(roleId: Hex, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Leave a community (Burn SBT and clean up)
+     */
+    leaveCommunity(community: Address, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Register as EndUser (One-click: Approve + Register)
+     * Handles GToken approval to Staking contract and Role registration.
+     */
+    registerAsEndUser(communityAddress: Address, stakeAmount: bigint, options?: TransactionOptions): Promise<Hash>;
+    /**
+     * Execute a transaction with Gasless Sponsorship
+     */
+    executeGasless(params: {
+        target: Address;
+        value: bigint;
+        data: Hex;
+        paymaster: Address;
+        paymasterType: 'V4' | 'Super';
+    }, options?: TransactionOptions): Promise<Hash>;
+}