@aastar/sdk 0.20.8 → 0.20.9

package/dist/index.d.cts

@@ -0,0 +1,656 @@
+import { RegistryActions, SBTActions, SuperPaymasterActions, PaymasterActions, StakingActions, DVTActions, XPNTsFactoryActions, AggregatorActions } from './core.cjs';
+export { AASTAR_COMMUNITY, AAStarAirAccountFactoryV7ABI, AAStarAirAccountFactoryV7Artifact, AAStarAirAccountV7ABI, AAStarAirAccountV7Artifact, AAStarBLSAggregatorABI, AAStarBLSAggregatorArtifact, AAStarBLSAlgorithmABI, AAStarBLSAlgorithmArtifact, AAStarValidatorABI, AAStarValidatorArtifact, AGENT_IDENTITY_REGISTRY_ADDRESS, AGENT_REPUTATION_REGISTRY_ADDRESS, ALL_ADDRESSES, ALL_ROLES, APNTS_ADDRESS, AccountActions, AccountBalance, AccountFactoryActions, AgentActions, AgentRegistryABI, AgentRegistryActions, AgentRegistryArtifact, AgentSponsorshipPolicy, AirAccountActions, AirAccountDelegateABI, AirAccountDelegateArtifact, AirAccountExtensionABI, AirAccountExtensionArtifact, AirAccountFactoryActions, AssetPolicy, AssetPolicyInput, AuthorizationState, BLSAggregatorABI, BLSAggregatorArtifact, BLSAlgorithmActions, BLSG1Point, BLSHelpers, BLSSigner, BLSValidatorABI, BLSValidatorArtifact, BLS_AGGREGATOR_ADDRESS, BLS_POP_DST, BLS_VALIDATOR_ADDRESS, BPS_DENOMINATOR, BRANDING, BREAD_COMMUNITY, BalanceValidationParams, BatchMintResult, BundlerClient, BundlerResponse, CANONICAL_ADDRESSES, CHAIN_MAINNET, CHAIN_SEPOLIA, COMMUNITIES, COMMUNITY_OWNERS, CONTRACTS, CONTRACT_METADATA, CONTRACT_SRC_HASH, CORE_ADDRESSES, CalldataParserRegistryABI, CalldataParserRegistryArtifact, CanonicalAddresses, CheckResourcesOptions, CommunityConfig, CommunityProfile, ContractCategory, ContractConfigManager, ContractNetwork, ContractScope, ContractScopeInput, ContractVersion, DEFAULT_ADMIN_ROLE, DEFAULT_APNTS_PRICE_USD, DEFAULT_CALL_GAS_LIMIT, DEFAULT_GAS_TOKEN_MINT_AMOUNT, DEFAULT_PRE_VERIFICATION_GAS, DEFAULT_TIMEOUT_MS, DEFAULT_TOKEN_NAME, DEFAULT_TOKEN_SYMBOL, DEFAULT_USDT_MINT_AMOUNT, DEFAULT_VERIFICATION_GAS_LIMIT, DVTAccountSignatureParams, DVTTier, DVTValidatorABI, DVTValidatorArtifact, DVT_TIER_T2, DVT_TIER_T3, DVT_VALIDATOR_ADDRESS, DeploymentValidationParams, DryRunValidationResult, ENTRY_POINT_ADDRESS, ERC20Actions, EnsOptions, EntryPointABI, EntryPointActions, EntryPointArtifact, EntryPointVersion, FAUCET_API_URL, FaucetConfig, FaucetPreparationResult, ForceExitActions, ForceExitModuleABI, ForceExitModuleArtifact, GTOKEN_ADDRESS, GTOKEN_STAKING_ADDRESS, GTokenABI, GTokenActions, GTokenArtifact, GTokenAuthorizationABI, GTokenAuthorizationActions, GTokenAuthorizationArtifact, GTokenStakingABI, GTokenStakingArtifact, HashToFieldU0U1, HeliosTransportConfig, INITIAL_ROLE_STAKES, InitConfig, LINKS, MAX_SERVICE_FEE, MICRO_PAYMENT_CHANNEL_ADDRESS, MONITORING_ADDRESSES, MicroPaymentChannelABI, MicroPaymentChannelArtifact, MySBTABI, MySBTArtifact, NETWORKS, NODE_STAKE_AMOUNTS, NetworkContracts, NodeType, OFFICIAL_ADDRESSES, OperatorConfig, OperatorMode, P256SessionState, PAYMASTER_ADDRESSES, PAYMASTER_FACTORY_ADDRESS, PAYMASTER_V4_ADDRESS, PAYMASTER_V4_IMPL_ADDRESS, PaymasterABI, PaymasterArtifact, PaymasterFactoryABI, PaymasterFactoryActions, PaymasterFactoryArtifact, PendingExit, PendingModuleInstall, PolicyDecision, PolicyRegistryABI, PolicyRegistryActions, PolicyRegistryArtifact, REGISTRY_ADDRESS, REPUTATION_SYSTEM_ADDRESS, ROLE_ANODE, ROLE_COMMUNITY, ROLE_DVT, ROLE_ENDUSER, ROLE_KMS, ROLE_NAMES, ROLE_PAYMASTER_AOA, ROLE_PAYMASTER_SUPER, ROLE_PERMISSION_LEVELS, RegistryABI, RegistryArtifact, ReputationActions, ReputationBreakdown, ReputationRule, ReputationSystemABI, ReputationSystemArtifact, RequirementChecker, ResolvedAPNTsToken, ResourceBoolCheck, ResourceReport, ResourceStakeCheck, RoleConfig, RoleConfigDetailed, RolePermissionLevel, RoleRequirement, RoleValidationParams, SBTData, SBTMembership, SBT_ADDRESS, SEPOLIA_CONTRACTS, SEPOLIA_V2_VERSIONS, SERVICE_FEE_RATE, SUPER_PAYMASTER_ADDRESS, SepoliaFaucetAPI, SessionKeyValidatorABI, SessionKeyValidatorActions, SessionKeyValidatorArtifact, SimpleAccountABI, SimpleAccountArtifact, SimpleAccountFactoryABI, SimpleAccountFactoryArtifact, SlashRecord, SpendCounter, StateValidator, SuperPaymasterABI, SuperPaymasterArtifact, SuperPaymasterConfig, SupportedChainId, SupportedNetwork, TEST_ACCOUNT_ADDRESSES, TEST_ACCOUNT_POOL_SIZE, TEST_COMMUNITIES, TEST_TOKEN_ADDRESSES, TOKEN_ADDRESSES, TokenActions, TokenBalanceValidationParams, TokenConfig, UserOperationV07, V2_SUMMARY, ValidationParams, ValidationResult, X402Actions, X402FacilitatorABI, X402FacilitatorArtifact, XPNTS_FACTORY_ADDRESS, XPNTsTokenActions, accountActions, accountFactoryActions, agentActions, agentRegistryActions, aggregatorActions, airAccountActions, airAccountFactoryActions, applyConfig, blsAlgorithmActions, createAAStarPublicClient, createHeliosTransport, describeSupportedChains, dvtActions, encodeDVTAccountSignature, encodeDVTVerifierProof, encodeG2Point, entryPointActions, forceExitActions, gTokenActions, gTokenAuthorizationActions, getAddressUrl, getAllCommunityConfigs, getAllV2Contracts, getBlockExplorer, getCanonicalAddresses, getChainId, getCommunities, getCommunity, getCommunityConfig, getContract, getContractNetworks, getContracts, getCoreContracts, getDeploymentDate, getEntryPoint, getNetwork, getPaymasterV4_1, getRoleName, getRpcUrl, getSimpleAccountFactory, getSuperPaymasterV2, getTestAccounts, getTestTokenContracts, getTokenContracts, getTxUrl, getV2ContractByAddress, getV2ContractByName, getV2ContractsByDate, hashToFieldU0U1, isContractNetworkSupported, isRegisteredCommunity, isSupportedChainId, isV2Contract, listSupportedChainIds, lookupAddress, paymasterActions, paymasterFactoryActions, policyRegistryActions, registryActions, reputationActions, resolveEns, resolveEnsVerified, sbtActions, sessionKeyValidatorActions, stakingActions, superPaymasterActions, tokenActions, x402Actions, x402IsNonceUsed, x402NonceKey, xPNTsFactoryABI, xPNTsFactoryActions, xPNTsFactoryArtifact, xPNTsTokenABI, xPNTsTokenActions, xPNTsTokenArtifact } from './core.cjs';
+export { P as PublicClient, W as WalletClient } from './doc-types-471vSmPO.cjs';
+export { a as BaseClient, B as BusinessResult, C as ClientConfig, T as TransactionOptions } from './BaseClient-CkBhQ1ou.cjs';
+export { a as ChannelActions, C as ChannelState, c as channelActions } from './channel-CkRRbzT8.cjs';
+export { EOAWalletClient, SimpleSmartAccount, UserOpClient, createEOAWalletClient, getUserOpHash, packUserOpLimits, toSimpleSmartAccount } from './account.cjs';
+export { P as PaymasterConfig, S as SuperPaymasterAdminClient, c as checkEligibility, g as getSuperPaymasterMiddleware } from './index-B6SfEQxo.cjs';
+export { BuildPaymasterDataParams, GaslessReadinessReport, GaslessTransactionConfig, PaymasterClient, PaymasterManager, PaymasterOperator, PaymasterType, PaymasterV4MiddlewareConfig, SuperPaymasterClient, buildPaymasterData, buildSuperPaymasterData, formatUserOpV07, getPaymasterV4Middleware, getUserOpHashV07, tuneGasLimit } from './paymaster.cjs';
+export { ReputationClient, checkMySBT, getMySBTId } from './identity.cjs';
+export { FinanceClient } from './tokens.cjs';
+export { DirectPaymentPayload, EIP3009Authorization, EIP3009_TYPES, FacilitatorClient, FacilitatorConfig, FacilitatorSupported, GTOKEN_EIP712_DOMAIN, HEADER_PAYMENT_REQUIRED, HEADER_PAYMENT_RESPONSE, HEADER_PAYMENT_SIGNATURE, HEADER_V1_PAYMENT, HEADER_V1_PAYMENT_RESPONSE, NetworkId, PaymentPayload, PaymentRequired, PaymentRequirements, ResourceInfo, SettleResponse, VerifyResponse, X402Client, X402ClientConfig, X402PaymentParams, decodePaymentPayload, decodePaymentRequired, decodeSettleResponse, encodePaymentPayload, encodePaymentRequired, encodeSettleResponse, extractPaymentRequired, extractSettleResponse, generateNonce, getEIP3009Domain, signCancelAuthorization, signGTokenTransferWithAuthorization, signReceiveWithAuthorization, signTransferWithAuthorization } from './x402.cjs';
+export { ChannelClient, ChannelClientConfig, ChannelConfig, SignedVoucher, VOUCHER_TYPES, VoucherParams, getVoucherDomain, signVoucher } from './channel.cjs';
+import { Client, Transport, Chain, Account, PublicActions, WalletActions, Address, Hex, Hash, PublicClient } from 'viem';
+export { CommunityClient, CommunityClientConfig, CommunityInfo, CreateCommunityParams, GaslessConfig, OnboardResult, ReputationData, UserClient, UserClientConfig, UserLifecycle, UserLifecycleConfig } from './enduser.cjs';
+export { OperatorClientConfig, OperatorLifecycle, OperatorStatus, PaymasterOperatorClient, ProposalState, ProtocolClient, ProtocolClientConfig, SponsorshipPolicy } from './operator.cjs';
+export { ProtocolGovernance, ProtocolParams } from './admin.cjs';
+import { A as ALG_BLS, a as ALG_CUMULATIVE_T2, b as ALG_CUMULATIVE_T3, c as ALG_ECDSA, d as ALG_P256, e as AirAccountClient, f as AirAccountConfig, g as AlgId, B as BLSConfig, h as BLSManager, i as BLSNode, j as BLSSignatureData, k as BeginAuthenticationResponse, l as BeginRegistrationResponse, m as BeginTransactionVerificationResponse, C as CryptoUtil, n as CumulativeT2SignatureData, o as CumulativeT3SignatureData, D as DEFAULT_PASSKEY_ROUTES, E as ERC4337Utils, G as GasEstimate, p as GuardStatus, P as PackedUserOperation$1, q as PasskeyAuthenticationParams, r as PasskeyInfo, s as PasskeyManager, t as PasskeyRegistrationParams, u as PasskeyRoutes, v as PreCheckResult, T as TierConfig, w as TierLevel, x as TransactionVerificationParams, U as UserOpBuilder, y as UserOperation, Y as YAAAClient, z as YAAAConfig, F as algIdForTier, H as resolveTier } from './tier-router-DeeVg69O.cjs';
+import 'node_modules/viem/_types';
+
+type EndUserClient = Client<Transport, Chain, Account | undefined> & PublicActions<Transport, Chain, Account | undefined> & WalletActions<Chain, Account | undefined> & RegistryActions & SBTActions & SuperPaymasterActions & PaymasterActions & {
+    /**
+     * High-level API: Onboard user to community with automatic funding
+     */
+    onboard: (args: {
+        community: Address;
+        roleId: Hex;
+        roleData: Hex;
+    }) => Promise<{
+        tx: Hash;
+        sbtId: bigint;
+    }>;
+    /**
+     * Orchestrates the user joining a community and activating gas credit flow:
+     * 1. Mint SBT for the community (Register ENDUSER role)
+     * 2. Verify Credit is active (Reputation check)
+     */
+    joinAndActivate: (args: {
+        community: Address;
+        roleId: Hex;
+        roleData?: Hex;
+    }) => Promise<{
+        tx: Hash;
+        sbtId: bigint;
+        initialCredit: bigint;
+    }>;
+    /**
+     * Executes a gasless transaction via SuperPaymaster.
+     */
+    executeGasless: (args: {
+        target: Address;
+        data: Hex;
+        value?: bigint;
+        operator: Address;
+    }) => Promise<Hash>;
+    /**
+     * Check if the user meets the requirements to join a community (stake, sbt, etc.)
+     */
+    checkJoinRequirements: (address?: Address) => Promise<{
+        hasEnoughGToken: boolean;
+        hasSBT: boolean;
+        missingRequirements: string[];
+    }>;
+    /**
+     * Predict or deploy a SimpleAccount (ERC-4337)
+     */
+    deploySmartAccount: (params: {
+        owner: Address;
+        salt?: bigint;
+        fundWithETH?: bigint;
+    }) => Promise<{
+        accountAddress: Address;
+        deployTxHash: Hash;
+        isDeployed: boolean;
+    }>;
+    /**
+     * Predict the address of a SimpleAccount without deploying
+     */
+    createSmartAccount: (params: {
+        owner: Address;
+        salt?: bigint;
+    }) => Promise<{
+        accountAddress: Address;
+        initCode: Hex;
+        isDeployed: boolean;
+    }>;
+};
+declare function createEndUserClient({ chain, transport, account, addresses }: {
+    chain: Chain;
+    transport: Transport;
+    account?: Account;
+    addresses?: {
+        [key: string]: Address;
+    };
+}): EndUserClient;
+
+type OperatorClient = Client<Transport, Chain, Account | undefined> & PublicActions<Transport, Chain, Account | undefined> & WalletActions<Chain, Account | undefined> & RegistryActions & SuperPaymasterActions & PaymasterActions & StakingActions & {
+    /**
+     * High-level API: Setup operator with automatic funding and onboarding
+     */
+    setup: (args: {
+        stakeAmount: bigint;
+        depositAmount: bigint;
+        roleId: Hex;
+        roleData?: Hex;
+    }) => Promise<{
+        txs: Hash[];
+    }>;
+    deployPaymasterV4: (args?: {
+        version?: string;
+        initData?: Hex;
+    }) => Promise<Hash>;
+    /**
+     * Orchestrates the full onboarding flow:
+     * 1. Approve GToken (Stake)
+     * 2. Register Role (Stake Lock)
+     * 3. Approve aPNTs (Deposit)
+     * 4. Deposit aPNTs (SuperPaymaster)
+     */
+    onboardOperator: (args: {
+        stakeAmount: bigint;
+        depositAmount: bigint;
+        roleId: Hex;
+        roleData?: Hex;
+    }) => Promise<Hash[]>;
+    /** @deprecated Use onboardOperator */
+    onboardToSuperPaymaster: (args: {
+        stakeAmount: bigint;
+        depositAmount: bigint;
+        roleId: Hex;
+    }) => Promise<Hash[]>;
+    configureOperator: (args: {
+        xPNTsToken: Address;
+        treasury: Address;
+        account?: Account | Address;
+    }) => Promise<Hash>;
+    getOperatorStatus: (accountAddress: Address) => Promise<{
+        type: 'super' | 'v4' | null;
+        superPaymaster: {
+            hasRole: boolean;
+            isConfigured: boolean;
+            balance: bigint;
+            /** Exchange rate read from xPNTsToken.exchangeRate() — not from operators() */
+            exchangeRate: bigint;
+            treasury: Address;
+        } | null;
+        paymasterV4: {
+            address: Address;
+            balance: bigint;
+        } | null;
+    }>;
+};
+declare function createOperatorClient({ chain, transport, account, addresses }: {
+    chain: Chain;
+    transport: Transport;
+    account?: Account;
+    addresses?: {
+        [key: string]: Address;
+    };
+}): OperatorClient;
+
+type CommunityClient = Client<Transport, Chain, Account | undefined> & PublicActions<Transport, Chain, Account | undefined> & WalletActions<Chain, Account | undefined> & RegistryActions & SBTActions & {
+    /**
+     * Query community registration status and token information
+     * Returns null if not registered, otherwise returns community details
+     */
+    getCommunityInfo: (accountAddress: Address) => Promise<{
+        hasRole: boolean;
+        tokenAddress: Address | null;
+        communityData: {
+            name: string;
+            ensName: string;
+            website: string;
+            description: string;
+        } | null;
+    }>;
+    /**
+     * High-level API to launch a community with automatic roleData generation
+     */
+    launch: (args: {
+        name: string;
+        tokenName: string;
+        tokenSymbol: string;
+        description?: string;
+        logoURI?: string;
+        website?: string;
+    }) => Promise<{
+        tokenAddress: Address;
+        txs: Hex[];
+    }>;
+};
+declare function createCommunityClient({ chain, transport, account, addresses }: {
+    chain: Chain;
+    transport: Transport;
+    account?: Account;
+    addresses?: {
+        [key: string]: Address;
+    };
+}): CommunityClient;
+
+type AdminClient = Client<Transport, Chain, Account | undefined> & PublicActions<Transport, Chain, Account | undefined> & WalletActions<Chain, Account | undefined> & RegistryActions & SuperPaymasterActions & PaymasterActions & StakingActions & SBTActions & DVTActions & XPNTsFactoryActions & AggregatorActions;
+declare function createAdminClient({ chain, transport, account, addresses }: {
+    chain: Chain;
+    transport: Transport;
+    account?: Account;
+    addresses?: {
+        [key: string]: Address;
+    };
+}): AdminClient;
+
+interface ExperimentRecord {
+    id: string;
+    scenario: string;
+    group: 'EOA' | 'AA' | 'SuperPaymaster';
+    txHash: string;
+    gasUsed: bigint;
+    gasPrice: bigint;
+    costETH: string;
+    status: 'Success' | 'Failed';
+    timestamp: number;
+    meta?: any;
+}
+/**
+ * ExperimentClient: Business-layer tool for measuring and recording execution metrics
+ */
+declare class ExperimentClient {
+    private records;
+    private scenarioId;
+    private group;
+    constructor(scenarioId: string, group: 'EOA' | 'AA' | 'SuperPaymaster');
+    /**
+     * Record a transaction result
+     */
+    recordTx(txHash: Hash, receipt: {
+        gasUsed: any;
+        effectiveGasPrice: any;
+    }, status: 'Success' | 'Failed', meta?: any): ExperimentRecord;
+    /**
+     * Measure an async task (transaction) automatically
+     */
+    measureTx(taskName: string, txPromise: Promise<Hash>, publicClient: any): Promise<Hash>;
+    getRecords(): ExperimentRecord[];
+}
+
+declare const index_ALG_BLS: typeof ALG_BLS;
+declare const index_ALG_CUMULATIVE_T2: typeof ALG_CUMULATIVE_T2;
+declare const index_ALG_CUMULATIVE_T3: typeof ALG_CUMULATIVE_T3;
+declare const index_ALG_ECDSA: typeof ALG_ECDSA;
+declare const index_ALG_P256: typeof ALG_P256;
+declare const index_AirAccountClient: typeof AirAccountClient;
+declare const index_AirAccountConfig: typeof AirAccountConfig;
+declare const index_AlgId: typeof AlgId;
+declare const index_BLSConfig: typeof BLSConfig;
+declare const index_BLSManager: typeof BLSManager;
+declare const index_BLSNode: typeof BLSNode;
+declare const index_BLSSignatureData: typeof BLSSignatureData;
+declare const index_BeginAuthenticationResponse: typeof BeginAuthenticationResponse;
+declare const index_BeginRegistrationResponse: typeof BeginRegistrationResponse;
+declare const index_BeginTransactionVerificationResponse: typeof BeginTransactionVerificationResponse;
+declare const index_CryptoUtil: typeof CryptoUtil;
+declare const index_CumulativeT2SignatureData: typeof CumulativeT2SignatureData;
+declare const index_CumulativeT3SignatureData: typeof CumulativeT3SignatureData;
+declare const index_DEFAULT_PASSKEY_ROUTES: typeof DEFAULT_PASSKEY_ROUTES;
+declare const index_ERC4337Utils: typeof ERC4337Utils;
+declare const index_GasEstimate: typeof GasEstimate;
+declare const index_GuardStatus: typeof GuardStatus;
+declare const index_PasskeyAuthenticationParams: typeof PasskeyAuthenticationParams;
+declare const index_PasskeyInfo: typeof PasskeyInfo;
+declare const index_PasskeyManager: typeof PasskeyManager;
+declare const index_PasskeyRegistrationParams: typeof PasskeyRegistrationParams;
+declare const index_PasskeyRoutes: typeof PasskeyRoutes;
+declare const index_PreCheckResult: typeof PreCheckResult;
+declare const index_TierConfig: typeof TierConfig;
+declare const index_TierLevel: typeof TierLevel;
+declare const index_TransactionVerificationParams: typeof TransactionVerificationParams;
+declare const index_UserOpBuilder: typeof UserOpBuilder;
+declare const index_UserOperation: typeof UserOperation;
+declare const index_YAAAClient: typeof YAAAClient;
+declare const index_YAAAConfig: typeof YAAAConfig;
+declare const index_algIdForTier: typeof algIdForTier;
+declare const index_resolveTier: typeof resolveTier;
+declare namespace index {
+  export { index_ALG_BLS as ALG_BLS, index_ALG_CUMULATIVE_T2 as ALG_CUMULATIVE_T2, index_ALG_CUMULATIVE_T3 as ALG_CUMULATIVE_T3, index_ALG_ECDSA as ALG_ECDSA, index_ALG_P256 as ALG_P256, index_AirAccountClient as AirAccountClient, index_AirAccountConfig as AirAccountConfig, index_AlgId as AlgId, index_BLSConfig as BLSConfig, index_BLSManager as BLSManager, index_BLSNode as BLSNode, index_BLSSignatureData as BLSSignatureData, index_BeginAuthenticationResponse as BeginAuthenticationResponse, index_BeginRegistrationResponse as BeginRegistrationResponse, index_BeginTransactionVerificationResponse as BeginTransactionVerificationResponse, index_CryptoUtil as CryptoUtil, index_CumulativeT2SignatureData as CumulativeT2SignatureData, index_CumulativeT3SignatureData as CumulativeT3SignatureData, index_DEFAULT_PASSKEY_ROUTES as DEFAULT_PASSKEY_ROUTES, index_ERC4337Utils as ERC4337Utils, index_GasEstimate as GasEstimate, index_GuardStatus as GuardStatus, PackedUserOperation$1 as PackedUserOperation, index_PasskeyAuthenticationParams as PasskeyAuthenticationParams, index_PasskeyInfo as PasskeyInfo, index_PasskeyManager as PasskeyManager, index_PasskeyRegistrationParams as PasskeyRegistrationParams, index_PasskeyRoutes as PasskeyRoutes, index_PreCheckResult as PreCheckResult, index_TierConfig as TierConfig, index_TierLevel as TierLevel, index_TransactionVerificationParams as TransactionVerificationParams, index_UserOpBuilder as UserOpBuilder, index_UserOperation as UserOperation, index_YAAAClient as YAAAClient, index_YAAAConfig as YAAAConfig, index_algIdForTier as algIdForTier, index_resolveTier as resolveTier };
+}
+
+declare const RoleIds: {
+    readonly PAYMASTER_SUPER: `0x${string}`;
+    readonly DVT: `0x${string}`;
+    readonly PAYMASTER_AOA: `0x${string}`;
+    readonly KMS: `0x${string}`;
+    readonly COMMUNITY: `0x${string}`;
+    readonly ENDUSER: `0x${string}`;
+    readonly ANODE: `0x${string}`;
+};
+type RoleId = typeof RoleIds[keyof typeof RoleIds];
+declare const RoleDataFactory: {
+    /**
+     * Data for SuperPaymaster Operator (Empty)
+     */
+    paymasterSuper: () => Hex;
+    /**
+     * Data for Generic DVT Role (Empty)
+     */
+    dvt: () => Hex;
+    /**
+     * Data for Community Registration (matches Registry.sol CommunityRoleData)
+     * NOTE: Solidity's abi.encode(struct) adds a 32-byte offset prefix (0x20)
+     * which is required for abi.decode(struct) to work correctly.
+     *
+     * @param params.name Community Name (defaults to 'TestCommunity')
+     * @param params.ensName ENS name (optional)
+     * @param params.website Website URL (optional)
+     * @param params.description Community description (optional)
+     * @param params.logoURI Logo URI string (optional)
+     * @param params.stakeAmount Stake amount (defaults to 0)
+     */
+    community: (params?: {
+        name?: string;
+        ensName?: string;
+        website?: string;
+        description?: string;
+        logoURI?: string;
+        stakeAmount?: bigint;
+    }) => Hex;
+    /**
+     * Data for EndUser (matches Registry.sol EndUserRoleData)
+     */
+    endUser: (params?: {
+        account?: Address;
+        community?: Address;
+        avatarURI?: string;
+        ensName?: string;
+        stakeAmount?: bigint;
+    }) => Hex;
+    decodeCommunity: (data: Hex) => {
+        name: any;
+        ensName: any;
+        website: any;
+        description: any;
+        logoURI: any;
+        stakeAmount: any;
+    };
+    decodeEndUser: (data: Hex) => {
+        account: any;
+        community: any;
+        avatarURI: any;
+        ensName: any;
+        stakeAmount: any;
+    };
+};
+
+/**
+ * 密钥对接口
+ */
+interface KeyPair {
+    name: string;
+    privateKey: Hex;
+    address: Address;
+}
+/**
+ * 密钥管理器
+ * 提供密钥生成、存储、加载等工具函数
+ */
+declare class KeyManager {
+    /**
+     * 生成单个密钥对
+     * @param name - 密钥名称（如 'Jason', 'Anni'）
+     */
+    static generateKeyPair(name: string): KeyPair;
+    /**
+     * 批量生成密钥对
+     * @param names - 密钥名称数组
+     */
+    static generateKeyPairs(names: string[]): KeyPair[];
+    /**
+     * 生成指定数量的密钥对（自动命名为 Operator_1, Operator_2, ...）
+     * @param count - 数量
+     * @param prefix - 名称前缀（默认 'Operator'）
+     */
+    static generateMultiple(count: number, prefix?: string): KeyPair[];
+    /**
+     * 保存密钥到 .env 文件
+     * @param filePath - 文件路径（绝对路径）
+     * @param keys - 密钥对数组
+     * @param overwrite - 是否覆盖已存在的文件（默认 false）
+     */
+    static saveToEnvFile(filePath: string, keys: KeyPair[], overwrite?: boolean): void;
+    /**
+     * 从 .env 文件加载密钥
+     * @param filePath - 文件路径（绝对路径）
+     * @returns 密钥对数组
+     */
+    static loadFromEnvFile(filePath: string): KeyPair[];
+    /**
+     * 保存密钥到 JSON 文件（包含地址信息）
+     * @param filePath - 文件路径（绝对路径）
+     * @param keys - 密钥对数组
+     * @param overwrite - 是否覆盖已存在的文件（默认 false）
+     */
+    static saveToJsonFile(filePath: string, keys: KeyPair[], overwrite?: boolean): void;
+    /**
+     * 从 JSON 文件加载密钥
+     * @param filePath - 文件路径（绝对路径）
+     */
+    static loadFromJsonFile(filePath: string): KeyPair[];
+    /**
+     * 打印密钥信息（隐藏私钥）
+     * @param keys - 密钥对数组
+     */
+    static printKeys(keys: KeyPair[], showPrivateKey?: boolean): void;
+}
+
+/**
+ * 资金管理参数
+ */
+interface FundingParams {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 链配置 */
+    chain: Chain;
+    /** 资金提供者私钥 */
+    supplierKey: Hex;
+    /** 目标地址 */
+    targetAddress: Address;
+}
+/**
+ * ETH 充值参数
+ */
+interface FundETHParams extends FundingParams {
+    /** 充值金额（ETH，如 '0.1'） */
+    amount: string;
+}
+/**
+ * ERC20 充值参数
+ */
+interface FundTokenParams extends FundingParams {
+    /** Token 合约地址 */
+    tokenAddress: Address;
+    /** 充值金额（Token，如 '100'） */
+    amount: string;
+}
+/**
+ * 智能充值参数
+ */
+interface EnsureFundingParams extends FundingParams {
+    /** 最小 ETH 余额阈值 */
+    minETH?: string;
+    /** 目标 ETH 充值金额 */
+    targetETH?: string;
+    /** Token 配置（可选） */
+    token?: {
+        address: Address;
+        minBalance?: string;
+        targetAmount?: string;
+    };
+}
+/**
+ * 充值结果
+ */
+interface FundingResult {
+    success: boolean;
+    txHash?: Hex;
+    error?: string;
+}
+/**
+ * 资金管理器
+ * 提供 ETH 和 ERC20 Token 的充值、验证等工具函数
+ */
+declare class FundingManager {
+    /**
+     * 创建 PublicClient 和 WalletClient
+     */
+    private static createClients;
+    /**
+     * 充值 ETH 到目标地址
+     * @param params - 充值参数
+     * @returns 充值结果
+     */
+    static fundWithETH(params: FundETHParams): Promise<FundingResult>;
+    /**
+     * 充值 ERC20 Token 到目标地址
+     * @param params - 充值参数
+     * @returns 充值结果
+     */
+    static fundWithToken(params: FundTokenParams): Promise<FundingResult>;
+    /**
+     * 检查 ETH 余额
+     * @param params - 基础参数
+     * @returns ETH 余额（wei）
+     */
+    static getETHBalance(params: FundingParams): Promise<bigint>;
+    /**
+     * 检查 ERC20 Token 余额
+     * @param params - 基础参数
+     * @param tokenAddress - Token 合约地址
+     * @returns Token 余额
+     */
+    static getTokenBalance(params: FundingParams, tokenAddress: Address): Promise<bigint>;
+    /**
+     * 智能充值：检查余额，不足时自动充值
+     * @param params - 充值参数
+     * @returns 充值结果数组
+     */
+    static ensureFunding(params: EnsureFundingParams): Promise<FundingResult[]>;
+    /**
+     * 批量充值 ETH
+     * @param params - 基础参数
+     * @param targets - 目标地址和金额数组
+     * @returns 充值结果数组
+     */
+    static batchFundETH(params: Omit<FundingParams, 'targetAddress'>, targets: Array<{
+        address: Address;
+        amount: string;
+    }>): Promise<FundingResult[]>;
+    /**
+     * 批量充值 Token
+     * @param params - 基础参数
+     * @param tokenAddress - Token 合约地址
+     * @param targets - 目标地址和金额数组
+     * @returns 充值结果数组
+     */
+    static batchFundToken(params: Omit<FundingParams, 'targetAddress'>, tokenAddress: Address, targets: Array<{
+        address: Address;
+        amount: string;
+    }>): Promise<FundingResult[]>;
+}
+
+/**
+ * ERC-4337 v0.7 Packed UserOperation structure.
+ */
+interface PackedUserOperation {
+    sender: Address;
+    nonce: Hex;
+    initCode: Hex;
+    callData: Hex;
+    accountGasLimits: Hex;
+    preVerificationGas: Hex;
+    gasFees: Hex;
+    paymasterAndData: Hex;
+    signature: Hex;
+}
+interface UserOpGasParams {
+    verificationGasLimit: bigint;
+    callGasLimit: bigint;
+    preVerificationGas: bigint;
+    maxPriorityFeePerGas: bigint;
+    maxFeePerGas: bigint;
+}
+interface PaymasterGasParams {
+    paymasterGasLimit: bigint;
+    paymasterPostOpGasLimit: bigint;
+}
+declare class UserOperationBuilder {
+    /**
+     * Packs verificationGasLimit and callGasLimit into a bytes32 Hex string.
+     */
+    static packAccountGasLimits(verificationGasLimit: bigint, callGasLimit: bigint): Hex;
+    /**
+     * Packs maxPriorityFeePerGas and maxFeePerGas into a bytes32 Hex string.
+     */
+    static packGasFees(maxPriorityFeePerGas: bigint, maxFeePerGas: bigint): Hex;
+    static estimatePreVerificationGasV07(userOp: {
+        sender: Address;
+        nonce: bigint | Hex | number | string;
+        initCode: Hex;
+        callData: Hex;
+        accountGasLimits: Hex;
+        preVerificationGas: bigint | Hex | number | string;
+        gasFees: Hex;
+        paymasterAndData: Hex;
+        signature: Hex;
+    }): bigint;
+    /**
+     * Packs Paymaster parameters into the v0.7 paymasterAndData format.
+     */
+    static packPaymasterAndData(paymaster: Address, paymasterGasLimit: bigint, paymasterPostOpGasLimit: bigint, paymasterData?: Hex): Hex;
+    /**
+     * Pack PaymasterV4 Deposit-Only paymasterAndData
+     *
+     * v0.7 EntryPoint packs: [paymaster(20)][verificationGas(16)][postOpGas(16)][paymasterData]
+     * Contract extracts token at offset 52 = paymasterData[0:20]
+     *
+     * So paymasterData format must be: [token(20)][validUntil(6)][validAfter(6)]
+     *
+     * @param paymaster - Paymaster address (20 bytes)
+     * @param paymentToken - ERC20 token address (20 bytes, FIRST in paymasterData!)
+     * @param validUntil - Validity end timestamp (6 bytes)
+     * @param validAfter - Validity start timestamp (6 bytes)
+     */
+    static packPaymasterV4DepositData(paymaster: Address, paymasterVerificationGasLimit: bigint, paymasterPostOpGasLimit: bigint, paymentToken: Address, validUntil: bigint, validAfter: bigint): Hex;
+    /**
+     * Computes the UserOperation hash for signing.
+     */
+    static getUserOpHash({ userOp, entryPoint, chainId, publicClient }: {
+        userOp: PackedUserOperation;
+        entryPoint: Address;
+        chainId: number;
+        publicClient: PublicClient;
+    }): Promise<Hex>;
+    /**
+     * Formats a PackedUserOperation into a JSON-RPC compatible object with hex-encoded strings.
+     */
+    static jsonifyUserOp(userOp: any): any;
+    /**
+     * Converts a PackedUserOperation to the Alchemy-specific v0.7 JSON format.
+     * @param userOp - The packed UserOperation
+     * @param options - Optional configuration
+     * @param options.paymasterVerificationGasLimit - Gas limit for paymaster verification (default: 200000)
+     * @param options.paymasterPostOpGasLimit - Gas limit for paymaster postOp (default: 200000)
+     */
+    static toAlchemyUserOperation(userOp: any, options?: {
+        paymasterVerificationGasLimit?: bigint;
+        paymasterPostOpGasLimit?: bigint;
+    }): any;
+}
+
+declare enum UserOpScenarioType {
+    NATIVE = "NATIVE",// Plain ERC-4337, user pays ETH
+    GASLESS_V4 = "GASLESS_V4",// Standard PaymasterV4
+    SUPER_BPNT = "SUPER_BPNT",// SuperPaymaster with bPNT internal payment
+    SUPER_CPNT = "SUPER_CPNT",// SuperPaymaster with cPNT internal payment
+    SUPER_CUSTOM = "SUPER_CUSTOM"
+}
+interface ScenarioParams {
+    sender: Address;
+    ownerAccount: any;
+    recipient: Address;
+    tokenAddress: Address;
+    amount: bigint;
+    entryPoint: Address;
+    chainId: number;
+    publicClient: PublicClient;
+    paymaster?: Address;
+    operator?: Address;
+    paymasterGasLimit?: bigint;
+    paymasterPostOpGasLimit?: bigint;
+    nonceKey?: bigint;
+    gasToken?: Address;
+}
+declare class UserOpScenarioBuilder {
+    /**
+     * Builds a signed PackedUserOperation for a token transfer based on the specified scenario.
+     */
+    static buildTransferScenario(type: UserOpScenarioType, params: ScenarioParams): Promise<{
+        userOp: any;
+        opHash: Hash;
+    }>;
+}
+
+declare const CustomErrors: {
+    readonly RoleNotConfigured: "RoleNotConfigured(bytes32,bool)";
+    readonly RoleAlreadyGranted: "RoleAlreadyGranted(bytes32,address)";
+    readonly InsufficientStake: "InsufficientStake(uint256,uint256)";
+};
+declare function decodeContractError(error: any): string | null;
+
+export { type AdminClient, AggregatorActions, index as AirAccount, CustomErrors, DVTActions, type EndUserClient, type EnsureFundingParams, ExperimentClient, type ExperimentRecord, type FundETHParams, type FundTokenParams, FundingManager, type FundingParams, type FundingResult, index as KMS, KeyManager, type KeyPair, type CommunityClient as LegacyCommunityClient, type OperatorClient, type PackedUserOperation, PaymasterActions, type PaymasterGasParams, RegistryActions, RoleDataFactory, type RoleId, RoleIds, SBTActions, type ScenarioParams, StakingActions, SuperPaymasterActions, type UserOpGasParams, UserOpScenarioBuilder, UserOpScenarioType, UserOperationBuilder, XPNTsFactoryActions, createAdminClient, createCommunityClient, createEndUserClient, createOperatorClient, decodeContractError };