@aastar/core 0.16.7

package/dist/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/contracts.test.d.ts

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

package/dist/contracts.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from 'vitest';
+import { getContracts, getContract, getCoreContracts, getTokenContracts, getEntryPoint, isContractNetworkSupported, getContractNetworks, getDeploymentDate } from './contracts.js';
+describe('Contracts', () => {
+    it('should get contracts for sepolia', () => {
+        const contracts = getContracts('sepolia');
+        expect(contracts.core.registry).toBeDefined();
+    });
+    it('should throw for unsupported network', () => {
+        expect(() => getContracts('mainnet')).toThrow('not supported');
+    });
+    it('should get a specific contract', () => {
+        const addr = getContract('sepolia', 'official', 'entryPoint');
+        expect(addr).toBeDefined();
+        expect(addr.startsWith('0x')).toBe(true);
+    });
+    it('should throw for invalid category or contract', () => {
+        expect(() => getContract('sepolia', 'invalid', 'entryPoint')).toThrow('Category');
+        expect(() => getContract('sepolia', 'official', 'invalid')).toThrow('Contract');
+    });
+    it('should get core and token contracts', () => {
+        expect(getCoreContracts('sepolia').registry).toBeDefined();
+        expect(getTokenContracts('sepolia').xPNTsFactory).toBeDefined();
+    });
+    it('should get entry point', () => {
+        expect(getEntryPoint('sepolia')).toBeDefined();
+    });
+    it('should check network support', () => {
+        expect(isContractNetworkSupported('sepolia')).toBe(true);
+        expect(isContractNetworkSupported('mainnet')).toBe(false);
+    });
+    it('should list contract networks', () => {
+        const networks = getContractNetworks();
+        expect(networks).toContain('sepolia');
+    });
+    it('should get deployment date', () => {
+        const date = getDeploymentDate('sepolia', 'registry');
+        expect(date).toBeDefined();
+        expect(date).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+    });
+});

package/dist/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/dist/crypto/blsSigner.js

@@ -0,0 +1,98 @@
+import { bls12_381 as bls } from '@noble/curves/bls12-381';
+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 {
+    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) {
+        const messageBytes = toBytes(message);
+        const signature = bls.sign(messageBytes, this.privateKey);
+        return `0x${Buffer.from(signature).toString('hex')}`;
+    }
+    /**
+     * Get BLS public key
+     * @returns Public key as hex string
+     */
+    getPublicKey() {
+        const pubKey = bls.getPublicKey(this.privateKey);
+        return `0x${Buffer.from(pubKey).toString('hex')}`;
+    }
+    /**
+     * Aggregate multiple BLS signatures
+     * @param signatures Array of BLS signatures
+     * @returns Aggregated signature
+     */
+    static aggregateSignatures(signatures) {
+        const sigBytes = signatures.map(sig => toBytes(sig));
+        const aggregated = bls.aggregateSignatures(sigBytes);
+        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) {
+        const pubKeyBytes = pubKeys.map(pk => toBytes(pk));
+        const aggregated = bls.aggregatePublicKeys(pubKeyBytes);
+        return `0x${Buffer.from(aggregated).toString('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, 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
+ */
+export const BLSHelpers = {
+    /**
+     * Create message hash for slash proposal
+     */
+    createSlashProposalMessage(proposalId) {
+        return keccak256(encodePacked(['uint256'], [proposalId]));
+    },
+    /**
+     * Create message hash for reputation update
+     */
+    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, // 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, publicKey, signerMask) {
+        return encodeAbiParameters(parseAbiParameters('bytes signature, bytes publicKey, uint256 signerMask'), [signature, publicKey, signerMask]);
+    }
+};

package/dist/crypto/index.d.ts

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

package/dist/crypto/index.js

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

package/dist/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/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * AAStar Shared Configuration Package
+ *
+ * @packageDocumentation
+ */
+export * from './branding.js';
+export * from './contract-addresses.js'; // Single source of truth for all contract addresses
+export * from './contracts.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';