@aastar/sdk 0.14.3 → 0.16.8

package/dist/core/src/contracts.js

@@ -0,0 +1,343 @@
+/**
+ * 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
+ */
+import { CORE_ADDRESSES, TOKEN_ADDRESSES, TEST_TOKEN_ADDRESSES, TEST_ACCOUNT_ADDRESSES, PAYMASTER_ADDRESSES, MONITORING_ADDRESSES, OFFICIAL_ADDRESSES, COMMUNITY_OWNERS, } from './contract-addresses.js';
+/**
+ * Sepolia Testnet Contracts
+ */
+export const SEPOLIA_CONTRACTS = {
+    // ========================================
+    // Core System (AOA+ Mode)
+    // ========================================
+    core: CORE_ADDRESSES,
+    // ========================================
+    // Token System
+    // ========================================
+    tokens: TOKEN_ADDRESSES,
+    // ========================================
+    // Test Tokens (For Development & Testing)
+    // ========================================
+    testTokens: TEST_TOKEN_ADDRESSES,
+    // ========================================
+    // Test Accounts (For Development & Testing)
+    // ========================================
+    testAccounts: TEST_ACCOUNT_ADDRESSES,
+    // ========================================
+    // Paymaster V4_1 (AOA Mode - Independent Paymaster)
+    // ========================================
+    paymaster: PAYMASTER_ADDRESSES,
+    // ========================================
+    // DVT/BLS Monitoring System
+    // ========================================
+    monitoring: MONITORING_ADDRESSES,
+    // ========================================
+    // Official Dependencies
+    // ========================================
+    official: OFFICIAL_ADDRESSES,
+    // ========================================
+    // Test Communities (For Development & Testing)
+    // ========================================
+    communities: {
+        /** AAStar Community - Test community for development (registered: 2025-11-01) */
+        aastar: {
+            owner: COMMUNITY_OWNERS.aastarOwner,
+            gasToken: TEST_TOKEN_ADDRESSES.apnts,
+            ensName: 'aastar.eth',
+            name: 'AAStar',
+            stake: '50', // 50 GToken staked in Registry
+        },
+        /** BreadCommunity - Test community for development (registered: 2025-11-03) */
+        breadCommunity: {
+            owner: COMMUNITY_OWNERS.breadCommunityOwner,
+            gasToken: TEST_TOKEN_ADDRESSES.bpnts,
+            ensName: 'bread.eth',
+            name: 'BreadCommunity',
+            stake: '50', // 50 GToken staked in Registry
+        },
+    },
+};
+/**
+ * All supported networks
+ */
+export const CONTRACTS = {
+    sepolia: SEPOLIA_CONTRACTS,
+    // Future networks can be added here:
+    // optimism: OPTIMISM_CONTRACTS,
+    // mainnet: MAINNET_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 function getContracts(network) {
+    const contracts = CONTRACTS[network];
+    if (!contracts) {
+        throw new Error(`Network '${network}' is not supported`);
+    }
+    return contracts;
+}
+/**
+ * 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 function getContract(network, category, name) {
+    const contracts = getContracts(network);
+    const categoryContracts = contracts[category];
+    if (!categoryContracts) {
+        throw new Error(`Category '${category}' not found in network '${network}'`);
+    }
+    const address = categoryContracts[name];
+    if (!address) {
+        throw new Error(`Contract '${name}' not found in category '${category}' for network '${network}'`);
+    }
+    return address;
+}
+/**
+ * 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 function getCoreContracts(network) {
+    return getContracts(network).core;
+}
+/**
+ * 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 function getTokenContracts(network) {
+    return getContracts(network).tokens;
+}
+/**
+ * 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 function getTestTokenContracts(network) {
+    return getContracts(network).testTokens;
+}
+/**
+ * Get PaymasterV4_1 address (AOA mode)
+ *
+ * @param network - Network name
+ * @returns PaymasterV4_1 address
+ *
+ * @example
+ * ```ts
+ * const paymaster = getPaymasterV4_1('sepolia');
+ * ```
+ */
+export function getPaymasterV4_1(network) {
+    return getContracts(network).paymaster.paymasterV4_1;
+}
+/**
+ * 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 function getTestAccounts(network) {
+    return getContracts(network).testAccounts;
+}
+/**
+ * Get SimpleAccountFactory address
+ *
+ * @param network - Network name
+ * @returns SimpleAccountFactory address
+ *
+ * @example
+ * ```ts
+ * const factory = getSimpleAccountFactory('sepolia');
+ * ```
+ */
+export function getSimpleAccountFactory(network) {
+    return getContracts(network).testAccounts.simpleAccountFactory;
+}
+/**
+ * Get SuperPaymaster V2 address (AOA+ mode)
+ *
+ * @param network - Network name
+ * @returns SuperPaymaster V2 address
+ *
+ * @example
+ * ```ts
+ * const superPaymaster = getSuperPaymasterV2('sepolia');
+ * ```
+ */
+export function getSuperPaymasterV2(network) {
+    return getContracts(network).core.superPaymaster;
+}
+/**
+ * Get EntryPoint v0.7 address
+ *
+ * @param network - Network name
+ * @returns EntryPoint address
+ *
+ * @example
+ * ```ts
+ * const entryPoint = getEntryPoint('sepolia');
+ * ```
+ */
+export function getEntryPoint(network) {
+    return getContracts(network).official.entryPoint;
+}
+/**
+ * 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 function isContractNetworkSupported(network) {
+    return network in CONTRACTS;
+}
+/**
+ * Get all supported contract network names
+ *
+ * @returns Array of supported network names
+ *
+ * @example
+ * ```ts
+ * const networks = getContractNetworks();
+ * // ['sepolia']
+ * ```
+ */
+export function getContractNetworks() {
+    return Object.keys(CONTRACTS);
+}
+/**
+ * Contract deployment metadata
+ */
+export const CONTRACT_METADATA = {
+    sepolia: {
+        lastUpdated: '2025-11-02',
+        networkId: 11155111,
+        deploymentDates: {
+            // Core System
+            gToken: '2025-11-01', // v2.0.0 with VERSION interface
+            superPaymaster: '2025-11-01', // v2.0.0 with VERSION interface
+            registry: '2025-11-02', // v2.1.4 with allowPermissionlessMint default true
+            gTokenStaking: '2025-11-01', // v2.0.0 with VERSION interface
+            // Tokens
+            xPNTsFactory: '2025-11-01', // v2.0.0 with VERSION interface
+            mySBT: '2025-11-01', // v2.4.0 with VERSION interface + NFT refactor
+            // Paymaster
+            paymasterV4_1: '2025-10-15',
+            // Tokens
+            aPNTs: '2025-10-30',
+            // Factories
+            paymasterFactory: '2025-11-01', // v1.0.0
+            // Monitoring
+            dvtValidator: '2025-11-01', // v2.0.0 with VERSION interface
+            blsAggregator: '2025-11-01', // v2.0.0 with VERSION interface
+        },
+    },
+};
+/**
+ * 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 function getDeploymentDate(network, contractName) {
+    const metadata = CONTRACT_METADATA[network];
+    if (!metadata)
+        return undefined;
+    return metadata.deploymentDates[contractName];
+}
+/**
+ * Get registered communities
+ *
+ * @param network - Network name
+ * @returns Communities object
+ *
+ * @example
+ * ```ts
+ * const communities = getCommunities('sepolia');
+ * console.log(communities.aastar.owner);
+ * ```
+ */
+export function getCommunities(network) {
+    return getContracts(network).communities;
+}
+/**
+ * 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 function getCommunity(network, communityName) {
+    return getCommunities(network)[communityName];
+}

package/dist/core/src/crypto/blsSigner.d.ts

@@ -0,0 +1,64 @@
+import { type Hex } from 'viem';
+/**
+ * BLS Signer for Registry reputation updates and DVT operations
+ *
+ * Uses BLS12-381 curve for signature aggregation
+ */
+export declare class BLSSigner {
+    private privateKey;
+    constructor(privateKeyHex: Hex);
+    /**
+     * Sign a message with BLS private key
+     * @param message Message hash to sign
+     * @returns BLS signature as hex string
+     */
+    sign(message: Hex): Hex;
+    /**
+     * Get BLS public key
+     * @returns Public key as hex string
+     */
+    getPublicKey(): Hex;
+    /**
+     * Aggregate multiple BLS signatures
+     * @param signatures Array of BLS signatures
+     * @returns Aggregated signature
+     */
+    static aggregateSignatures(signatures: Hex[]): Hex;
+    /**
+     * Aggregate multiple BLS public keys
+     * @param pubKeys Array of BLS public keys
+     * @returns Aggregated public key (uncompressed G1 - 96 bytes for EVM)
+     */
+    static aggregatePublicKeys(pubKeys: Hex[]): Hex;
+    /**
+     * Verify a BLS signature
+     * @param message Message hash
+     * @param signature BLS signature
+     * @param publicKey BLS public key
+     * @returns True if signature is valid
+     */
+    static verify(message: Hex, signature: Hex, publicKey: Hex): boolean;
+}
+/**
+ * Helper functions for creating BLS proofs for Registry and BLSAggregator operations
+ */
+export declare const BLSHelpers: {
+    /**
+     * Create message hash for slash proposal
+     */
+    createSlashProposalMessage(proposalId: bigint): Hex;
+    /**
+     * Create message hash for reputation update
+     */
+    createReputationUpdateMessage(users: Hex[], scores: bigint[], epoch: bigint): Hex;
+    /**
+     * Encode BLS proof for Registry/Aggregator (v3 format)
+     * Proof structure: (bytes pkG1, bytes sigG2, bytes msgG2, uint256 signerMask)
+     */
+    encodeBLSProof(aggregatedPublicKey: Hex, aggregatedSignature: Hex, messageMappingG2: Hex, signerMask: bigint): Hex;
+    /**
+     * Encode Reputation Proof (for test compatibility)
+     * Matches format: (signature, publicKey, signerMask)
+     */
+    encodeReputationProof(signature: Hex, publicKey: Hex, signerMask: bigint): Hex;
+};

package/{packages/core/src/crypto/blsSigner.ts → dist/core/src/crypto/blsSigner.js}

@@ -1,60 +1,53 @@
 import { bls12_381 as bls } from '@noble/curves/bls12-381';
-import { type Hex, toBytes, keccak256, encodePacked, encodeAbiParameters, parseAbiParameters } from 'viem';
-
+import { toBytes, keccak256, encodePacked, encodeAbiParameters, parseAbiParameters } from 'viem';
 /**
  * BLS Signer for Registry reputation updates and DVT operations
- * 
+ *
  * Uses BLS12-381 curve for signature aggregation
  */
 export class BLSSigner {
-    private privateKey: Uint8Array;
-    
-    constructor(privateKeyHex: Hex) {
+    privateKey;
+    constructor(privateKeyHex) {
         this.privateKey = toBytes(privateKeyHex);
     }
-    
     /**
      * Sign a message with BLS private key
      * @param message Message hash to sign
      * @returns BLS signature as hex string
      */
-    sign(message: Hex): Hex {
+    sign(message) {
         const messageBytes = toBytes(message);
         const signature = bls.sign(messageBytes, this.privateKey);
-        return `0x${Buffer.from(signature).toString('hex')}` as Hex;
+        return `0x${Buffer.from(signature).toString('hex')}`;
     }
-    
     /**
      * Get BLS public key
      * @returns Public key as hex string
      */
-    getPublicKey(): Hex {
+    getPublicKey() {
         const pubKey = bls.getPublicKey(this.privateKey);
-        return `0x${Buffer.from(pubKey).toString('hex')}` as Hex;
+        return `0x${Buffer.from(pubKey).toString('hex')}`;
     }
-    
     /**
      * Aggregate multiple BLS signatures
      * @param signatures Array of BLS signatures
      * @returns Aggregated signature
      */
-    static aggregateSignatures(signatures: Hex[]): Hex {
+    static aggregateSignatures(signatures) {
         const sigBytes = signatures.map(sig => toBytes(sig));
         const aggregated = bls.aggregateSignatures(sigBytes);
-        return `0x${Buffer.from(aggregated).toString('hex')}` as Hex;
+        return `0x${Buffer.from(aggregated).toString('hex')}`;
     }
-    
     /**
      * Aggregate multiple BLS public keys
      * @param pubKeys Array of BLS public keys
      * @returns Aggregated public key (uncompressed G1 - 96 bytes for EVM)
      */
-    static aggregatePublicKeys(pubKeys: Hex[]): Hex {
+    static aggregatePublicKeys(pubKeys) {
         const pubKeyBytes = pubKeys.map(pk => toBytes(pk));
         const aggregated = bls.aggregatePublicKeys(pubKeyBytes);
-        return `0x${Buffer.from(aggregated).toString('hex')}` as Hex;
+        return `0x${Buffer.from(aggregated).toString('hex')}`;
     }
-    
     /**
      * Verify a BLS signature
      * @param message Message hash
@@ -62,14 +55,13 @@ export class BLSSigner {
      * @param publicKey BLS public key
      * @returns True if signature is valid
      */
-    static verify(message: Hex, signature: Hex, publicKey: Hex): boolean {
+    static verify(message, signature, publicKey) {
         const messageBytes = toBytes(message);
         const sigBytes = toBytes(signature);
         const pubKeyBytes = toBytes(publicKey);
         return bls.verify(sigBytes, messageBytes, pubKeyBytes);
     }
 }
-
 /**
  * Helper functions for creating BLS proofs for Registry and BLSAggregator operations
  */
@@ -77,48 +69,30 @@ export const BLSHelpers = {
     /**
      * Create message hash for slash proposal
      */
-    createSlashProposalMessage(proposalId: bigint): Hex {
+    createSlashProposalMessage(proposalId) {
         return keccak256(encodePacked(['uint256'], [proposalId]));
     },
-    
     /**
      * Create message hash for reputation update
      */
-    createReputationUpdateMessage(users: Hex[], scores: bigint[], epoch: bigint): Hex {
-        return keccak256(encodePacked(
-            ['address[]', 'uint256[]', 'uint256'],
-            [users, scores, epoch]
-        ));
+    createReputationUpdateMessage(users, scores, epoch) {
+        return keccak256(encodePacked(['address[]', 'uint256[]', 'uint256'], [users, scores, epoch]));
     },
-    
     /**
      * Encode BLS proof for Registry/Aggregator (v3 format)
      * Proof structure: (bytes pkG1, bytes sigG2, bytes msgG2, uint256 signerMask)
      */
-    encodeBLSProof(
-        aggregatedPublicKey: Hex, // G1 (48 bytes compressed or 96 bytes uncompressed)
-        aggregatedSignature: Hex, // G2 (96 bytes compressed or 192 bytes uncompressed)
-        messageMappingG2: Hex,    // G2 (Mapping of hash to G2 point)
-        signerMask: bigint
-    ): Hex {
-        return encodeAbiParameters(
-            parseAbiParameters('bytes, bytes, bytes, uint256'),
-            [aggregatedPublicKey, aggregatedSignature, messageMappingG2, signerMask]
-        );
+    encodeBLSProof(aggregatedPublicKey, // G1 (48 bytes compressed or 96 bytes uncompressed)
+    aggregatedSignature, // G2 (96 bytes compressed or 192 bytes uncompressed)
+    messageMappingG2, // G2 (Mapping of hash to G2 point)
+    signerMask) {
+        return encodeAbiParameters(parseAbiParameters('bytes, bytes, bytes, uint256'), [aggregatedPublicKey, aggregatedSignature, messageMappingG2, signerMask]);
     },
-
     /**
      * Encode Reputation Proof (for test compatibility)
      * Matches format: (signature, publicKey, signerMask)
      */
-    encodeReputationProof(
-        signature: Hex,
-        publicKey: Hex,
-        signerMask: bigint
-    ): Hex {
-        return encodeAbiParameters(
-            parseAbiParameters('bytes signature, bytes publicKey, uint256 signerMask'),
-            [signature, publicKey, signerMask]
-        );
+    encodeReputationProof(signature, publicKey, signerMask) {
+        return encodeAbiParameters(parseAbiParameters('bytes signature, bytes publicKey, uint256 signerMask'), [signature, publicKey, signerMask]);
     }
 };

package/dist/core/src/crypto/index.js

@@ -0,0 +1 @@
+export * from './blsSigner.js';

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

@@ -0,0 +1,21 @@
+/**
+ * AAStar Shared Configuration Package
+ *
+ * @packageDocumentation
+ */
+export * from './branding.js';
+export * from './contract-addresses.js';
+export * from './contracts.js';
+export * from './networks.js';
+export * from './constants.js';
+export * from './communities.js';
+export * from './abis/index.js';
+export * from './clients.js';
+export * from './clients/types.js';
+export * from './clients/BaseClient.js';
+export * from './actions/index.js';
+export * from './crypto/index.js';
+export * from './roles.js';
+export * from './requirementChecker.js';
+export * from './config/ContractConfigManager.js';
+export * from './utils/validation.js';

package/{packages/core/src/index.ts → dist/core/src/index.js}

@@ -3,17 +3,19 @@
  *
  * @packageDocumentation
  */
-
 export * from './branding.js';
 export * from './contract-addresses.js'; // Single source of truth for all contract addresses
 export * from './contracts.js';
-export * from './contract-versions.js';
 export * from './networks.js';
 export * from './constants.js';
 export * from './communities.js'; // Community configurations
 export * from './abis/index.js'; // Assuming abis is a folder with index.ts
 export * from './clients.js';
+export * from './clients/types.js';
+export * from './clients/BaseClient.js';
 export * from './actions/index.js';
 export * from './crypto/index.js';
 export * from './roles.js'; // Role system
 export * from './requirementChecker.js'; // Requirement validation
+export * from './config/ContractConfigManager.js';
+export * from './utils/validation.js';