@aastar/core 0.16.7

package/dist/branding.js

@@ -0,0 +1,30 @@
+/**
+ * AAStar Community Branding Configuration
+ */
+export const BRANDING = {
+    logo: "https://raw.githubusercontent.com/jhfnetboy/MarkDownImg/main/img/202505031325963.png",
+    icon: "https://www.aastar.io/favicon.ico",
+    colors: {
+        primary: "#FF6B35",
+        primaryLight: "#FF8C42",
+        secondary: "#4A90E2",
+        secondaryDark: "#357ABD",
+        success: "#4CAF50",
+        warning: "#FFC107",
+        error: "#F44336",
+        gray50: "#F9FAFB",
+        gray100: "#F3F4F6",
+        gray700: "#374151",
+        gray800: "#1F2937",
+        gray900: "#111827",
+    },
+};
+export const LINKS = {
+    main: "https://aastar.io",
+    airAccount: "https://airAccount.aastar.io",
+    superPaymaster: "https://superpaymaster.aastar.io",
+    demo: "https://aastar.io/demo",
+    github: "https://github.com/AAStarCommunity",
+    discord: "https://discord.gg/aastar",
+    twitter: "https://twitter.com/AAStarCommunity",
+};

package/dist/clients/BaseClient.d.ts

@@ -0,0 +1,25 @@
+import { type Address, type PublicClient, type WalletClient, type Chain, type Transport, type Account } from 'viem';
+import { type ClientConfig } from './types.js';
+export declare abstract class BaseClient {
+    protected client: WalletClient<Transport, Chain, Account>;
+    protected publicClient?: PublicClient;
+    protected registryAddress?: Address;
+    protected gTokenAddress?: Address;
+    protected gTokenStakingAddress?: Address;
+    protected paymasterFactoryAddress?: Address;
+    protected entryPointAddress?: Address;
+    constructor(config: ClientConfig);
+    /**
+     * Get the account address of the connected wallet
+     */
+    getAddress(): Address;
+    /**
+     * Helper to ensure public client exists or fallback to wallet client (if it supports read)
+     */
+    protected getStartPublicClient(): PublicClient | WalletClient<Transport, Chain, Account>;
+    protected requireRegistry(): Address;
+    protected requireGToken(): Address;
+    protected requireGTokenStaking(): Address;
+    protected requirePaymasterFactory(): Address;
+    protected requireEntryPoint(): Address;
+}

package/dist/clients/BaseClient.js

@@ -0,0 +1,66 @@
+export class BaseClient {
+    client;
+    publicClient;
+    registryAddress;
+    gTokenAddress;
+    gTokenStakingAddress;
+    paymasterFactoryAddress;
+    entryPointAddress;
+    constructor(config) {
+        if (!config.client) {
+            throw new Error('WalletClient is required for Business Clients');
+        }
+        if (!config.client.account) {
+            throw new Error('WalletClient must have an account attached');
+        }
+        this.client = config.client;
+        this.publicClient = config.publicClient;
+        this.registryAddress = config.registryAddress;
+        this.gTokenAddress = config.gTokenAddress;
+        this.gTokenStakingAddress = config.gTokenStakingAddress;
+        this.paymasterFactoryAddress = config.paymasterFactoryAddress;
+        this.entryPointAddress = config.entryPointAddress;
+    }
+    /**
+     * Get the account address of the connected wallet
+     */
+    getAddress() {
+        return this.client.account.address;
+    }
+    /**
+     * Helper to ensure public client exists or fallback to wallet client (if it supports read)
+     */
+    getStartPublicClient() {
+        return this.publicClient || this.client;
+    }
+    requireRegistry() {
+        if (!this.registryAddress) {
+            throw new Error('Registry address is not configured for this client');
+        }
+        return this.registryAddress;
+    }
+    requireGToken() {
+        if (!this.gTokenAddress) {
+            throw new Error('GToken address is not configured for this client');
+        }
+        return this.gTokenAddress;
+    }
+    requireGTokenStaking() {
+        if (!this.gTokenStakingAddress) {
+            throw new Error('GTokenStaking address is not configured for this client');
+        }
+        return this.gTokenStakingAddress;
+    }
+    requirePaymasterFactory() {
+        if (!this.paymasterFactoryAddress) {
+            throw new Error('PaymasterFactory address is not configured for this client');
+        }
+        return this.paymasterFactoryAddress;
+    }
+    requireEntryPoint() {
+        if (!this.entryPointAddress) {
+            throw new Error('EntryPoint address is not configured for this client');
+        }
+        return this.entryPointAddress;
+    }
+}

package/dist/clients/types.d.ts

@@ -0,0 +1,60 @@
+import { type Address, type PublicClient, type WalletClient, type Chain, type Transport, type Account } from 'viem';
+/**
+ * Base configuration for all L2 Business Clients
+ */
+export interface ClientConfig {
+    /**
+     * Viem WalletClient for write operations.
+     * Must have an account attached.
+     */
+    client: WalletClient<Transport, Chain, Account>;
+    /**
+     * Optional PublicClient for read operations.
+     * If not provided, one will be derived from the WalletClient or created internally if possible (but usually explicit is better).
+     * Currently L1 actions use PublicClient | WalletClient, so WalletClient is enough for both if it has a provider.
+     * However, explicitly accepting PublicClient encourages separation.
+     */
+    publicClient?: PublicClient;
+    /**
+     * Registry contract address.
+     * Essential for looking up other contracts if not provided explicitly.
+     */
+    registryAddress?: Address;
+    /**
+     * GToken contract address.
+     * Required for operations involving token approvals and transfers.
+     */
+    gTokenAddress?: Address;
+    /**
+     * GTokenStaking contract address.
+     * Required for role registration that involves staking.
+     */
+    gTokenStakingAddress?: Address;
+    /**
+     * PaymasterFactory contract address.
+     * Required for deploying new PaymasterV4 instances.
+     */
+    paymasterFactoryAddress?: Address;
+    xpntsFactoryAddress?: Address;
+    ethUsdPriceFeedAddress?: Address;
+    entryPointAddress?: Address;
+}
+/**
+ * Common options for transaction methods
+ */
+export interface TransactionOptions {
+    /**
+     * Override the account to use for the transaction.
+     * If not provided, uses the account from the WalletClient.
+     */
+    account?: Account | Address;
+    /**
+     * Optional value to send with the transaction (in wei)
+     */
+    value?: bigint;
+}
+/**
+ * Generic result wrapper for business operations
+ * Currently just returns the type directly, but can be expanded for metadata.
+ */
+export type BusinessResult<T> = Promise<T>;

package/dist/clients/types.js

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

package/dist/clients.d.ts

@@ -0,0 +1,5 @@
+import { type Chain, type PublicClient } from 'viem';
+/**
+ * Creates a standard AAStar public client for any given chain.
+ */
+export declare function createAAStarPublicClient(rpcUrl: string, chain?: Chain): PublicClient;

package/dist/clients.js

@@ -0,0 +1,11 @@
+import { createPublicClient, http } from 'viem';
+import { sepolia } from 'viem/chains';
+/**
+ * Creates a standard AAStar public client for any given chain.
+ */
+export function createAAStarPublicClient(rpcUrl, chain = sepolia) {
+    return createPublicClient({
+        chain,
+        transport: http(rpcUrl)
+    });
+}

package/dist/communities.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Community Configurations
+ * Registry v2.2.0 deployed on 2025-11-08
+ */
+export declare enum NodeType {
+    PAYMASTER_AOA = 0,// AOA independent Paymaster
+    PAYMASTER_SUPER = 1,// SuperPaymaster v2 shared mode
+    ANODE = 2,// Community computation node
+    KMS = 3
+}
+export interface CommunityConfig {
+    name: string;
+    ensName: string;
+    address: string;
+    xPNTsToken: string;
+    supportedSBTs: string[];
+    nodeType: NodeType;
+    isActive: boolean;
+    allowPermissionlessMint: boolean;
+    stakedAmount: string;
+    registeredAt: number;
+}
+/**
+ * AAstar Community
+ * - SuperPaymaster shared mode (AOA+)
+ * - Uses aPNTs for gas payments
+ * - MySBT for identity verification
+ */
+export declare const AASTAR_COMMUNITY: CommunityConfig;
+/**
+ * Bread Community
+ * - Independent AOA Paymaster mode
+ * - Uses bPNTs for gas payments
+ * - MySBT for identity verification
+ */
+export declare const BREAD_COMMUNITY: CommunityConfig;
+/**
+ * All communities indexed by address
+ */
+export declare const COMMUNITIES: Record<string, CommunityConfig>;
+/**
+ * Get community configuration by address
+ */
+export declare function getCommunityConfig(address: string): CommunityConfig | undefined;
+/**
+ * Get all community configurations
+ */
+export declare function getAllCommunityConfigs(): CommunityConfig[];
+/**
+ * Check if address is a registered community
+ */
+export declare function isRegisteredCommunity(address: string): boolean;

package/dist/communities.js

@@ -0,0 +1,73 @@
+/**
+ * Community Configurations
+ * Registry v2.2.0 deployed on 2025-11-08
+ */
+import { TEST_COMMUNITIES, TEST_TOKEN_ADDRESSES, CORE_ADDRESSES } from './contract-addresses.js';
+export var NodeType;
+(function (NodeType) {
+    NodeType[NodeType["PAYMASTER_AOA"] = 0] = "PAYMASTER_AOA";
+    NodeType[NodeType["PAYMASTER_SUPER"] = 1] = "PAYMASTER_SUPER";
+    NodeType[NodeType["ANODE"] = 2] = "ANODE";
+    NodeType[NodeType["KMS"] = 3] = "KMS";
+})(NodeType || (NodeType = {}));
+/**
+ * AAstar Community
+ * - SuperPaymaster shared mode (AOA+)
+ * - Uses aPNTs for gas payments
+ * - MySBT for identity verification
+ */
+export const AASTAR_COMMUNITY = {
+    name: 'AAstar Community',
+    ensName: 'aastar.eth',
+    address: TEST_COMMUNITIES.aastar,
+    xPNTsToken: TEST_TOKEN_ADDRESSES.apnts,
+    supportedSBTs: [CORE_ADDRESSES.mySBT],
+    nodeType: NodeType.PAYMASTER_SUPER,
+    isActive: true,
+    allowPermissionlessMint: true,
+    stakedAmount: '50', // 50 GT
+    registeredAt: 1762588812, // 2025-11-08
+};
+/**
+ * Bread Community
+ * - Independent AOA Paymaster mode
+ * - Uses bPNTs for gas payments
+ * - MySBT for identity verification
+ */
+export const BREAD_COMMUNITY = {
+    name: 'Bread Community',
+    ensName: 'bread.eth',
+    address: TEST_COMMUNITIES.bread,
+    xPNTsToken: TEST_TOKEN_ADDRESSES.bpnts,
+    supportedSBTs: [CORE_ADDRESSES.mySBT],
+    nodeType: NodeType.PAYMASTER_AOA,
+    isActive: true,
+    allowPermissionlessMint: false,
+    stakedAmount: '50', // 50 GT
+    registeredAt: 1762588812, // 2025-11-08
+};
+/**
+ * All communities indexed by address
+ */
+export const COMMUNITIES = {
+    [TEST_COMMUNITIES.aastar]: AASTAR_COMMUNITY,
+    [TEST_COMMUNITIES.bread]: BREAD_COMMUNITY,
+};
+/**
+ * Get community configuration by address
+ */
+export function getCommunityConfig(address) {
+    return COMMUNITIES[address.toLowerCase()];
+}
+/**
+ * Get all community configurations
+ */
+export function getAllCommunityConfigs() {
+    return Object.values(COMMUNITIES);
+}
+/**
+ * Check if address is a registered community
+ */
+export function isRegisteredCommunity(address) {
+    return address.toLowerCase() in COMMUNITIES;
+}

package/dist/config/ContractConfigManager.d.ts

@@ -0,0 +1,20 @@
+import { Address } from 'viem';
+export interface SuperPaymasterConfig {
+    registry: Address;
+    gToken: Address;
+    gTokenStaking: Address;
+    superPaymaster: Address;
+    paymasterFactory: Address;
+    paymasterV4: Address;
+    entryPoint: Address;
+}
+export declare class ContractConfigManager {
+    /**
+     * Get validated core configuration
+     */
+    static getConfig(): SuperPaymasterConfig;
+    /**
+     * Validate configuration addresses
+     */
+    private static validate;
+}

package/dist/config/ContractConfigManager.js

@@ -0,0 +1,48 @@
+import { isAddress } from 'viem';
+import { CORE_ADDRESSES } from '../contract-addresses.js';
+export class ContractConfigManager {
+    /**
+     * Get validated core configuration
+     */
+    static getConfig() {
+        const config = {
+            registry: CORE_ADDRESSES.registry,
+            gToken: CORE_ADDRESSES.gToken,
+            gTokenStaking: CORE_ADDRESSES.gTokenStaking,
+            superPaymaster: CORE_ADDRESSES.superPaymaster,
+            paymasterV4: CORE_ADDRESSES.paymasterV4,
+            paymasterFactory: CORE_ADDRESSES.paymasterFactory,
+            entryPoint: CORE_ADDRESSES.entryPoint || '0x0000000071727De22E5E9d8BAf0edAc6f37da032'
+        };
+        this.validate(config);
+        return config;
+    }
+    /**
+     * Validate configuration addresses
+     */
+    static validate(config) {
+        const missing = [];
+        const invalid = [];
+        // Critical contracts that MUST exist for experiments
+        const critical = ['registry', 'gToken', 'superPaymaster', 'paymasterV4'];
+        for (const [key, addr] of Object.entries(config)) {
+            if (!addr) {
+                if (critical.includes(key)) {
+                    missing.push(key);
+                }
+            }
+            else if (!isAddress(addr)) {
+                invalid.push(`${key} (${addr})`);
+            }
+        }
+        if (missing.length > 0 || invalid.length > 0) {
+            throw new Error(`
+                Invalid Contract Configuration:
+                Missing: ${missing.join(', ')}
+                Invalid Format: ${invalid.join(', ')}
+                
+                Please ensure your .env file is correctly sourced from 'projects/SuperPaymaster/.env.sepolia'
+            `);
+        }
+    }
+}

package/dist/constants.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Contract Addresses (loaded from config.{network}.json)
+ */
+export declare const CONTRACT_SRC_HASH: any;
+export declare const REGISTRY_ADDRESS: `0x${string}`;
+export declare const GTOKEN_ADDRESS: `0x${string}`;
+export declare const GTOKEN_STAKING_ADDRESS: `0x${string}`;
+export declare const SBT_ADDRESS: `0x${string}`;
+export declare const REPUTATION_SYSTEM_ADDRESS: `0x${string}`;
+export declare const SUPER_PAYMASTER_ADDRESS: `0x${string}`;
+export declare const PAYMASTER_FACTORY_ADDRESS: `0x${string}`;
+export declare const PAYMASTER_V4_IMPL_ADDRESS: `0x${string}`;
+export declare const XPNTS_FACTORY_ADDRESS: `0x${string}`;
+export declare const BLS_AGGREGATOR_ADDRESS: `0x${string}`;
+export declare const BLS_VALIDATOR_ADDRESS: `0x${string}`;
+export declare const DVT_VALIDATOR_ADDRESS: `0x${string}`;
+export declare const ENTRY_POINT_ADDRESS: `0x${string}`;
+export declare const ENTRY_POINT_0_8_ADDRESS: `0x${string}`;
+export declare const ENTRY_POINT_0_9_ADDRESS: `0x${string}`;
+export declare const APNTS_ADDRESS: `0x${string}`;
+/**
+ * Common Constants
+ */
+/**
+ * Default faucet API URL for testnet token requests
+ */
+export declare const FAUCET_API_URL = "https://faucet-aastar.vercel.app";
+/**
+ * Service fee rate in basis points (200 = 2%)
+ */
+export declare const SERVICE_FEE_RATE = 200;
+/**
+ * Maximum service fee in basis points (1000 = 10%)
+ */
+export declare const MAX_SERVICE_FEE = 1000;
+/**
+ * Basis points denominator (100% = 10000 basis points)
+ */
+export declare const BPS_DENOMINATOR = 10000;
+/**
+ * Default amount of gas tokens to mint for testing (in token units)
+ */
+export declare const DEFAULT_GAS_TOKEN_MINT_AMOUNT = "100";
+/**
+ * Default amount of USDT to mint for testing (in USDT)
+ */
+export declare const DEFAULT_USDT_MINT_AMOUNT = "10";
+/**
+ * Size of test account pool
+ */
+export declare const TEST_ACCOUNT_POOL_SIZE = 20;
+/**
+ * Minimum stake amounts for different node types (in sGT)
+ */
+export declare const NODE_STAKE_AMOUNTS: {
+    /** Lite Node: 30 sGT minimum stake */
+    readonly LITE: 30;
+    /** Standard Node: 100 sGT minimum stake */
+    readonly STANDARD: 100;
+    /** Super Node: 300 sGT minimum stake */
+    readonly SUPER: 300;
+    /** Enterprise Node: 1000 sGT minimum stake */
+    readonly ENTERPRISE: 1000;
+};
+/**
+ * Default aPNTs price in USD (0.02 USD per aPNT)
+ */
+export declare const DEFAULT_APNTS_PRICE_USD = "0.02";
+/**
+ * Network Chain IDs
+ */
+export declare const CHAIN_SEPOLIA = 11155111;
+export declare const CHAIN_MAINNET = 1;
+/**
+ * Default Values
+ */
+export declare const DEFAULT_TOKEN_SYMBOL = "GT";
+export declare const DEFAULT_TOKEN_NAME = "Governance Token";
+/**
+ * Gas Limits
+ */
+export declare const DEFAULT_VERIFICATION_GAS_LIMIT = 200000n;
+export declare const DEFAULT_CALL_GAS_LIMIT = 100000n;
+export declare const DEFAULT_PRE_VERIFICATION_GAS = 50000n;
+/**
+ * Timeouts
+ */
+export declare const DEFAULT_TIMEOUT_MS = 30000;

package/dist/constants.js

@@ -0,0 +1,125 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+// 智能网络检测: 优先级 EXPERIMENT_NETWORK > NETWORK > RPC URL检测 > anvil
+function detectNetwork() {
+    // 1. 优先使用 EXPERIMENT_NETWORK (脚本常用)
+    if (process.env.EXPERIMENT_NETWORK) {
+        return process.env.EXPERIMENT_NETWORK;
+    }
+    // 2. 其次使用 NETWORK
+    if (process.env.NETWORK && process.env.NETWORK !== 'anvil') {
+        return process.env.NETWORK;
+    }
+    // 3. 通过 RPC URL 推断
+    const rpcUrl = process.env.SEPOLIA_RPC_URL || process.env.RPC_URL || process.env.OP_SEPOLIA_RPC_URL;
+    if (rpcUrl) {
+        if (rpcUrl.includes('sepolia') && !rpcUrl.includes('op-sepolia')) {
+            return 'sepolia';
+        }
+        if (rpcUrl.includes('op-sepolia') || rpcUrl.includes('optimism-sepolia')) {
+            return 'op-sepolia';
+        }
+        if (rpcUrl.includes('optimism') && !rpcUrl.includes('sepolia')) {
+            return 'optimism';
+        }
+    }
+    // 4. 默认 anvil
+    return 'anvil';
+}
+const network = detectNetwork();
+let config = {};
+try {
+    config = require(`../../../config.${network}.json`);
+    console.log(`[SDK] Loaded contract config from: config.${network}.json`);
+}
+catch (e) {
+    console.warn(`Warning: Could not load config.${network}.json. Contract addresses may be undefined.`);
+}
+/**
+ * Contract Addresses (loaded from config.{network}.json)
+ */
+export const CONTRACT_SRC_HASH = config.srcHash;
+export const REGISTRY_ADDRESS = config.registry;
+export const GTOKEN_ADDRESS = config.gToken;
+export const GTOKEN_STAKING_ADDRESS = config.staking;
+export const SBT_ADDRESS = config.sbt;
+export const REPUTATION_SYSTEM_ADDRESS = config.reputationSystem;
+export const SUPER_PAYMASTER_ADDRESS = config.superPaymaster;
+export const PAYMASTER_FACTORY_ADDRESS = config.paymasterFactory;
+export const PAYMASTER_V4_IMPL_ADDRESS = config.paymasterV4Impl;
+export const XPNTS_FACTORY_ADDRESS = config.xPNTsFactory;
+export const BLS_AGGREGATOR_ADDRESS = config.blsAggregator;
+export const BLS_VALIDATOR_ADDRESS = config.blsValidator;
+export const DVT_VALIDATOR_ADDRESS = config.dvtValidator;
+export const ENTRY_POINT_ADDRESS = config.entryPoint;
+export const ENTRY_POINT_0_8_ADDRESS = config.entryPoint08;
+export const ENTRY_POINT_0_9_ADDRESS = config.entryPoint09;
+export const APNTS_ADDRESS = config.aPNTs;
+/**
+ * Common Constants
+ */
+/**
+ * Default faucet API URL for testnet token requests
+ */
+export const FAUCET_API_URL = "https://faucet-aastar.vercel.app";
+/**
+ * Service fee rate in basis points (200 = 2%)
+ */
+export const SERVICE_FEE_RATE = 200;
+/**
+ * Maximum service fee in basis points (1000 = 10%)
+ */
+export const MAX_SERVICE_FEE = 1000;
+/**
+ * Basis points denominator (100% = 10000 basis points)
+ */
+export const BPS_DENOMINATOR = 10000;
+/**
+ * Default amount of gas tokens to mint for testing (in token units)
+ */
+export const DEFAULT_GAS_TOKEN_MINT_AMOUNT = "100";
+/**
+ * Default amount of USDT to mint for testing (in USDT)
+ */
+export const DEFAULT_USDT_MINT_AMOUNT = "10";
+/**
+ * Size of test account pool
+ */
+export const TEST_ACCOUNT_POOL_SIZE = 20;
+/**
+ * Minimum stake amounts for different node types (in sGT)
+ */
+export const NODE_STAKE_AMOUNTS = {
+    /** Lite Node: 30 sGT minimum stake */
+    LITE: 30,
+    /** Standard Node: 100 sGT minimum stake */
+    STANDARD: 100,
+    /** Super Node: 300 sGT minimum stake */
+    SUPER: 300,
+    /** Enterprise Node: 1000 sGT minimum stake */
+    ENTERPRISE: 1000,
+};
+/**
+ * Default aPNTs price in USD (0.02 USD per aPNT)
+ */
+export const DEFAULT_APNTS_PRICE_USD = "0.02";
+/**
+ * Network Chain IDs
+ */
+export const CHAIN_SEPOLIA = 11155111;
+export const CHAIN_MAINNET = 1;
+/**
+ * Default Values
+ */
+export const DEFAULT_TOKEN_SYMBOL = 'GT';
+export const DEFAULT_TOKEN_NAME = 'Governance Token';
+/**
+ * Gas Limits
+ */
+export const DEFAULT_VERIFICATION_GAS_LIMIT = 200000n;
+export const DEFAULT_CALL_GAS_LIMIT = 100000n;
+export const DEFAULT_PRE_VERIFICATION_GAS = 50000n;
+/**
+ * Timeouts
+ */
+export const DEFAULT_TIMEOUT_MS = 30000;