@aastar/paymaster 0.16.7

package/dist/core/src/contract-addresses.js

@@ -0,0 +1,99 @@
+/**
+ * Contract Addresses - Single Source of Truth
+ * All contract addresses for Sepolia testnet
+ *
+ * This file serves as the single source of truth for all contract addresses.
+ * All other files reference these constants to avoid duplication.
+ */
+import { REGISTRY_ADDRESS, GTOKEN_ADDRESS, GTOKEN_STAKING_ADDRESS, SUPER_PAYMASTER_ADDRESS, PAYMASTER_FACTORY_ADDRESS, PAYMASTER_V4_IMPL_ADDRESS, APNTS_ADDRESS, SBT_ADDRESS, DVT_VALIDATOR_ADDRESS, ENTRY_POINT_ADDRESS, XPNTS_FACTORY_ADDRESS, BLS_AGGREGATOR_ADDRESS, REPUTATION_SYSTEM_ADDRESS } from './constants.js';
+/**
+ * Core System Addresses
+ */
+export const CORE_ADDRESSES = {
+    registry: REGISTRY_ADDRESS,
+    gToken: GTOKEN_ADDRESS,
+    gTokenStaking: GTOKEN_STAKING_ADDRESS,
+    superPaymaster: SUPER_PAYMASTER_ADDRESS,
+    paymasterFactory: PAYMASTER_FACTORY_ADDRESS,
+    aPNTs: APNTS_ADDRESS,
+    mySBT: SBT_ADDRESS,
+    // Fallback to Env if not in config (or use Implementation)
+    paymasterV4: (process.env.PAYMASTER_V4_PROXY || PAYMASTER_V4_IMPL_ADDRESS),
+    dvtValidator: DVT_VALIDATOR_ADDRESS,
+    entryPoint: ENTRY_POINT_ADDRESS,
+    xPNTsFactory: XPNTS_FACTORY_ADDRESS,
+    reputationSystem: (process.env.REPUTATION_SYSTEM_ADDRESS || REPUTATION_SYSTEM_ADDRESS),
+};
+/**
+ * Token System Addresses
+ */
+export const TOKEN_ADDRESSES = {
+    xPNTsFactory: XPNTS_FACTORY_ADDRESS,
+    aPNTs: APNTS_ADDRESS,
+    gToken: GTOKEN_ADDRESS,
+    pimToken: (process.env.PIM_TOKEN_ADDRESS || '0x0000000000000000000000000000000000000000'), // Often custom per deployment
+};
+/**
+ * Test Token Addresses (For Development & Testing)
+ */
+export const TEST_TOKEN_ADDRESSES = {
+    mockUSDT: process.env.TEST_MOCK_USDT,
+    apnts: APNTS_ADDRESS,
+    gToken: GTOKEN_ADDRESS,
+    bpnts: GTOKEN_ADDRESS, // bPNTs is often GToken in simple setups
+    pimToken: TOKEN_ADDRESSES.pimToken,
+};
+/**
+ * Test Account Addresses (For Development & Testing)
+ */
+export const TEST_ACCOUNT_ADDRESSES = {
+    // Official EntryPoint 0.6 Factory for Sepolia
+    simpleAccountFactory: (process.env.SIMPLE_ACCOUNT_FACTORY || '0x9406Cc6185a346906296840746125a0E44976454'),
+};
+/**
+ * Paymaster Addresses
+ */
+export const PAYMASTER_ADDRESSES = {
+    paymasterV4_1: process.env.PAYMASTER_V4_ADDRESS,
+    paymasterV4_1iImplementation: PAYMASTER_V4_IMPL_ADDRESS,
+};
+/**
+ * Monitoring System Addresses
+ */
+export const MONITORING_ADDRESSES = {
+    dvtValidator: DVT_VALIDATOR_ADDRESS,
+    blsAggregator: BLS_AGGREGATOR_ADDRESS,
+};
+/**
+ * Official Contract Addresses
+ */
+export const OFFICIAL_ADDRESSES = {
+    entryPoint: (ENTRY_POINT_ADDRESS || '0x0000000071727De22E5E9d8BAf0edAc6f37da032'),
+};
+/**
+ * Community Owner Addresses
+ */
+export const COMMUNITY_OWNERS = {
+    aastarOwner: '0x411BD567E46C0781248dbB6a9211891C032885e5', // Deployer 1
+    breadCommunityOwner: '0xe24b6f321B0140716a2b671ed0D983bb64E7DaFA', // OWNER2
+};
+/**
+ * Test Community Addresses (Registered in Registry v2.2.0 on 2025-11-08)
+ */
+export const TEST_COMMUNITIES = {
+    aastar: process.env.TEST_COMMUNITY_AASTAR,
+    bread: process.env.TEST_COMMUNITY_BREAD,
+    mycelium: process.env.TEST_COMMUNITY_MYCELIUM,
+};
+/**
+ * All Addresses Combined (for reference)
+ */
+export const ALL_ADDRESSES = {
+    ...CORE_ADDRESSES,
+    ...TOKEN_ADDRESSES,
+    ...TEST_TOKEN_ADDRESSES,
+    ...TEST_ACCOUNT_ADDRESSES,
+    ...PAYMASTER_ADDRESSES,
+    ...MONITORING_ADDRESSES,
+    ...OFFICIAL_ADDRESSES,
+};

package/dist/core/src/contracts.d.ts

@@ -0,0 +1,424 @@
+/**
+ * AAstar Smart Contract Addresses
+ *
+ * IMPORTANT: Contract addresses are defined in contract-addresses.ts
+ * This file imports and uses those addresses to maintain a single source of truth.
+ *
+ * For detailed version information (VERSION, VERSION_CODE, features),
+ * see contract-versions.ts
+ */
+/**
+ * Contract category types
+ */
+export type ContractCategory = 'core' | 'tokens' | 'testTokens' | 'testAccounts' | 'paymaster' | 'monitoring' | 'official' | 'communities';
+/**
+ * Sepolia Testnet Contracts
+ */
+export declare const SEPOLIA_CONTRACTS: {
+    readonly core: {
+        readonly registry: `0x${string}`;
+        readonly gToken: `0x${string}`;
+        readonly gTokenStaking: `0x${string}`;
+        readonly superPaymaster: `0x${string}`;
+        readonly paymasterFactory: `0x${string}`;
+        readonly aPNTs: `0x${string}`;
+        readonly mySBT: `0x${string}`;
+        readonly paymasterV4: import("viem").Address;
+        readonly dvtValidator: `0x${string}`;
+        readonly entryPoint: `0x${string}`;
+        readonly xPNTsFactory: `0x${string}`;
+        readonly reputationSystem: import("viem").Address;
+    };
+    readonly tokens: {
+        readonly xPNTsFactory: `0x${string}`;
+        readonly aPNTs: `0x${string}`;
+        readonly gToken: `0x${string}`;
+        readonly pimToken: import("viem").Address;
+    };
+    readonly testTokens: {
+        readonly mockUSDT: import("viem").Address;
+        readonly apnts: `0x${string}`;
+        readonly gToken: `0x${string}`;
+        readonly bpnts: `0x${string}`;
+        readonly pimToken: `0x${string}`;
+    };
+    readonly testAccounts: {
+        readonly simpleAccountFactory: import("viem").Address;
+    };
+    readonly paymaster: {
+        readonly paymasterV4_1: import("viem").Address;
+        readonly paymasterV4_1iImplementation: `0x${string}`;
+    };
+    readonly monitoring: {
+        readonly dvtValidator: `0x${string}`;
+        readonly blsAggregator: `0x${string}`;
+    };
+    readonly official: {
+        readonly entryPoint: import("viem").Address;
+    };
+    readonly communities: {
+        /** AAStar Community - Test community for development (registered: 2025-11-01) */
+        readonly aastar: {
+            readonly owner: "0x411BD567E46C0781248dbB6a9211891C032885e5";
+            readonly gasToken: `0x${string}`;
+            readonly ensName: "aastar.eth";
+            readonly name: "AAStar";
+            readonly stake: "50";
+        };
+        /** BreadCommunity - Test community for development (registered: 2025-11-03) */
+        readonly breadCommunity: {
+            readonly owner: "0xe24b6f321B0140716a2b671ed0D983bb64E7DaFA";
+            readonly gasToken: `0x${string}`;
+            readonly ensName: "bread.eth";
+            readonly name: "BreadCommunity";
+            readonly stake: "50";
+        };
+    };
+};
+/**
+ * All supported networks
+ */
+export declare const CONTRACTS: {
+    readonly sepolia: {
+        readonly core: {
+            readonly registry: `0x${string}`;
+            readonly gToken: `0x${string}`;
+            readonly gTokenStaking: `0x${string}`;
+            readonly superPaymaster: `0x${string}`;
+            readonly paymasterFactory: `0x${string}`;
+            readonly aPNTs: `0x${string}`;
+            readonly mySBT: `0x${string}`;
+            readonly paymasterV4: import("viem").Address;
+            readonly dvtValidator: `0x${string}`;
+            readonly entryPoint: `0x${string}`;
+            readonly xPNTsFactory: `0x${string}`;
+            readonly reputationSystem: import("viem").Address;
+        };
+        readonly tokens: {
+            readonly xPNTsFactory: `0x${string}`;
+            readonly aPNTs: `0x${string}`;
+            readonly gToken: `0x${string}`;
+            readonly pimToken: import("viem").Address;
+        };
+        readonly testTokens: {
+            readonly mockUSDT: import("viem").Address;
+            readonly apnts: `0x${string}`;
+            readonly gToken: `0x${string}`;
+            readonly bpnts: `0x${string}`;
+            readonly pimToken: `0x${string}`;
+        };
+        readonly testAccounts: {
+            readonly simpleAccountFactory: import("viem").Address;
+        };
+        readonly paymaster: {
+            readonly paymasterV4_1: import("viem").Address;
+            readonly paymasterV4_1iImplementation: `0x${string}`;
+        };
+        readonly monitoring: {
+            readonly dvtValidator: `0x${string}`;
+            readonly blsAggregator: `0x${string}`;
+        };
+        readonly official: {
+            readonly entryPoint: import("viem").Address;
+        };
+        readonly communities: {
+            /** AAStar Community - Test community for development (registered: 2025-11-01) */
+            readonly aastar: {
+                readonly owner: "0x411BD567E46C0781248dbB6a9211891C032885e5";
+                readonly gasToken: `0x${string}`;
+                readonly ensName: "aastar.eth";
+                readonly name: "AAStar";
+                readonly stake: "50";
+            };
+            /** BreadCommunity - Test community for development (registered: 2025-11-03) */
+            readonly breadCommunity: {
+                readonly owner: "0xe24b6f321B0140716a2b671ed0D983bb64E7DaFA";
+                readonly gasToken: `0x${string}`;
+                readonly ensName: "bread.eth";
+                readonly name: "BreadCommunity";
+                readonly stake: "50";
+            };
+        };
+    };
+};
+/**
+ * Supported network types for contracts
+ */
+export type ContractNetwork = keyof typeof CONTRACTS;
+/**
+ * Contract addresses for a specific network
+ */
+export type NetworkContracts = typeof SEPOLIA_CONTRACTS;
+/**
+ * Get all contracts for a specific network
+ *
+ * @param network - Network name (e.g., 'sepolia')
+ * @returns All contract addresses for the network
+ *
+ * @example
+ * ```ts
+ * const contracts = getContracts('sepolia');
+ * console.log(contracts.core.superPaymaster);
+ * ```
+ */
+export declare function getContracts(network: ContractNetwork): NetworkContracts;
+/**
+ * Get a specific contract address
+ *
+ * @param network - Network name
+ * @param category - Contract category
+ * @param name - Contract name
+ * @returns Contract address
+ *
+ * @example
+ * ```ts
+ * const address = getContract('sepolia', 'core', 'superPaymaster');
+ * ```
+ */
+export declare function getContract(network: ContractNetwork, category: ContractCategory, name: string): string;
+/**
+ * Get core system contracts
+ *
+ * @param network - Network name
+ * @returns Core contract addresses
+ *
+ * @example
+ * ```ts
+ * const core = getCoreContracts('sepolia');
+ * console.log(core.superPaymaster);
+ * console.log(core.registry);
+ * ```
+ */
+export declare function getCoreContracts(network: ContractNetwork): {
+    readonly registry: `0x${string}`;
+    readonly gToken: `0x${string}`;
+    readonly gTokenStaking: `0x${string}`;
+    readonly superPaymaster: `0x${string}`;
+    readonly paymasterFactory: `0x${string}`;
+    readonly aPNTs: `0x${string}`;
+    readonly mySBT: `0x${string}`;
+    readonly paymasterV4: import("viem").Address;
+    readonly dvtValidator: `0x${string}`;
+    readonly entryPoint: `0x${string}`;
+    readonly xPNTsFactory: `0x${string}`;
+    readonly reputationSystem: import("viem").Address;
+};
+/**
+ * Get token system contracts
+ *
+ * @param network - Network name
+ * @returns Token contract addresses
+ *
+ * @example
+ * ```ts
+ * const tokens = getTokenContracts('sepolia');
+ * console.log(tokens.xPNTsFactory);
+ * console.log(tokens.mySBT);
+ * ```
+ */
+export declare function getTokenContracts(network: ContractNetwork): {
+    readonly xPNTsFactory: `0x${string}`;
+    readonly aPNTs: `0x${string}`;
+    readonly gToken: `0x${string}`;
+    readonly pimToken: import("viem").Address;
+};
+/**
+ * Get test token contracts (for development & testing)
+ *
+ * @param network - Network name
+ * @returns Test token contract addresses
+ *
+ * @example
+ * ```ts
+ * const testTokens = getTestTokenContracts('sepolia');
+ * console.log(testTokens.mockUSDT);
+ * ```
+ */
+export declare function getTestTokenContracts(network: ContractNetwork): {
+    readonly mockUSDT: import("viem").Address;
+    readonly apnts: `0x${string}`;
+    readonly gToken: `0x${string}`;
+    readonly bpnts: `0x${string}`;
+    readonly pimToken: `0x${string}`;
+};
+/**
+ * Get PaymasterV4_1 address (AOA mode)
+ *
+ * @param network - Network name
+ * @returns PaymasterV4_1 address
+ *
+ * @example
+ * ```ts
+ * const paymaster = getPaymasterV4_1('sepolia');
+ * ```
+ */
+export declare function getPaymasterV4_1(network: ContractNetwork): string;
+/**
+ * Get test account contracts (SimpleAccountFactory, etc.)
+ *
+ * @param network - Network name
+ * @returns Test account contract addresses
+ *
+ * @example
+ * ```ts
+ * const testAccounts = getTestAccounts('sepolia');
+ * console.log(testAccounts.simpleAccountFactory);
+ * ```
+ */
+export declare function getTestAccounts(network: ContractNetwork): {
+    readonly simpleAccountFactory: import("viem").Address;
+};
+/**
+ * Get SimpleAccountFactory address
+ *
+ * @param network - Network name
+ * @returns SimpleAccountFactory address
+ *
+ * @example
+ * ```ts
+ * const factory = getSimpleAccountFactory('sepolia');
+ * ```
+ */
+export declare function getSimpleAccountFactory(network: ContractNetwork): string;
+/**
+ * Get SuperPaymaster V2 address (AOA+ mode)
+ *
+ * @param network - Network name
+ * @returns SuperPaymaster V2 address
+ *
+ * @example
+ * ```ts
+ * const superPaymaster = getSuperPaymasterV2('sepolia');
+ * ```
+ */
+export declare function getSuperPaymasterV2(network: ContractNetwork): string;
+/**
+ * Get EntryPoint v0.7 address
+ *
+ * @param network - Network name
+ * @returns EntryPoint address
+ *
+ * @example
+ * ```ts
+ * const entryPoint = getEntryPoint('sepolia');
+ * ```
+ */
+export declare function getEntryPoint(network: ContractNetwork): string;
+/**
+ * Check if a network is supported for contracts
+ *
+ * @param network - Network name to check
+ * @returns True if network is supported
+ *
+ * @example
+ * ```ts
+ * if (isContractNetworkSupported('sepolia')) {
+ *   const contracts = getContracts('sepolia');
+ * }
+ * ```
+ */
+export declare function isContractNetworkSupported(network: string): network is ContractNetwork;
+/**
+ * Get all supported contract network names
+ *
+ * @returns Array of supported network names
+ *
+ * @example
+ * ```ts
+ * const networks = getContractNetworks();
+ * // ['sepolia']
+ * ```
+ */
+export declare function getContractNetworks(): ContractNetwork[];
+/**
+ * Contract deployment metadata
+ */
+export declare const CONTRACT_METADATA: {
+    readonly sepolia: {
+        readonly lastUpdated: "2025-11-02";
+        readonly networkId: 11155111;
+        readonly deploymentDates: {
+            readonly gToken: "2025-11-01";
+            readonly superPaymaster: "2025-11-01";
+            readonly registry: "2025-11-02";
+            readonly gTokenStaking: "2025-11-01";
+            readonly xPNTsFactory: "2025-11-01";
+            readonly mySBT: "2025-11-01";
+            readonly paymasterV4_1: "2025-10-15";
+            readonly aPNTs: "2025-10-30";
+            readonly paymasterFactory: "2025-11-01";
+            readonly dvtValidator: "2025-11-01";
+            readonly blsAggregator: "2025-11-01";
+        };
+    };
+};
+/**
+ * Get contract deployment date
+ *
+ * @param network - Network name
+ * @param contractName - Contract name
+ * @returns Deployment date string (YYYY-MM-DD)
+ *
+ * @example
+ * ```ts
+ * const date = getDeploymentDate('sepolia', 'superPaymaster');
+ * // '2025-10-25'
+ * ```
+ */
+export declare function getDeploymentDate(network: ContractNetwork, contractName: string): string | undefined;
+/**
+ * Get registered communities
+ *
+ * @param network - Network name
+ * @returns Communities object
+ *
+ * @example
+ * ```ts
+ * const communities = getCommunities('sepolia');
+ * console.log(communities.aastar.owner);
+ * ```
+ */
+export declare function getCommunities(network: ContractNetwork): {
+    /** AAStar Community - Test community for development (registered: 2025-11-01) */
+    readonly aastar: {
+        readonly owner: "0x411BD567E46C0781248dbB6a9211891C032885e5";
+        readonly gasToken: `0x${string}`;
+        readonly ensName: "aastar.eth";
+        readonly name: "AAStar";
+        readonly stake: "50";
+    };
+    /** BreadCommunity - Test community for development (registered: 2025-11-03) */
+    readonly breadCommunity: {
+        readonly owner: "0xe24b6f321B0140716a2b671ed0D983bb64E7DaFA";
+        readonly gasToken: `0x${string}`;
+        readonly ensName: "bread.eth";
+        readonly name: "BreadCommunity";
+        readonly stake: "50";
+    };
+};
+/**
+ * Get a specific community
+ *
+ * @param network - Network name
+ * @param communityName - Community name (aastar, builderDao)
+ * @returns Community information
+ *
+ * @example
+ * ```ts
+ * const aastar = getCommunity('sepolia', 'aastar');
+ * console.log(aastar.gasToken); // aPNTs address
+ * ```
+ */
+export declare function getCommunity(network: ContractNetwork, communityName: 'aastar' | 'breadCommunity'): {
+    readonly owner: "0x411BD567E46C0781248dbB6a9211891C032885e5";
+    readonly gasToken: `0x${string}`;
+    readonly ensName: "aastar.eth";
+    readonly name: "AAStar";
+    readonly stake: "50";
+} | {
+    readonly owner: "0xe24b6f321B0140716a2b671ed0D983bb64E7DaFA";
+    readonly gasToken: `0x${string}`;
+    readonly ensName: "bread.eth";
+    readonly name: "BreadCommunity";
+    readonly stake: "50";
+};