@aastar/sdk 0.14.0 → 0.14.3

package/ext/aastar-shared-config/src/contracts.ts

@@ -0,0 +1,414 @@
+/**
+ * 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';
+
+/**
+ * Contract category types
+ */
+export type ContractCategory =
+  | 'core'          // SuperPaymaster V2, Registry, GToken, GTokenStaking, PaymasterFactory
+  | 'tokens'        // xPNTsFactory, MySBT
+  | 'testTokens'    // Mock tokens for testing (USDT, aPNTs, bPNTs)
+  | 'testAccounts'  // Test accounts for development (SimpleAccountFactory)
+  | 'paymaster'     // PaymasterV4_1 (AOA mode)
+  | 'monitoring'    // DVT, BLS
+  | 'official'      // EntryPoint
+  | 'communities';  // Registered communities (AAStar, BuilderDAO)
+
+/**
+ * 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
+    },
+  },
+} as const;
+
+/**
+ * All supported networks
+ */
+export const CONTRACTS = {
+  sepolia: SEPOLIA_CONTRACTS,
+  // Future networks can be added here:
+  // optimism: OPTIMISM_CONTRACTS,
+  // mainnet: MAINNET_CONTRACTS,
+} as const;
+
+/**
+ * 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.superPaymasterV2);
+ * ```
+ */
+export function getContracts(network: ContractNetwork): NetworkContracts {
+  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', 'superPaymasterV2');
+ * ```
+ */
+export function getContract(
+  network: ContractNetwork,
+  category: ContractCategory,
+  name: string
+): string {
+  const contracts = getContracts(network);
+  const categoryContracts = contracts[category] as Record<string, string>;
+
+  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.superPaymasterV2);
+ * console.log(core.registry);
+ * ```
+ */
+export function getCoreContracts(network: ContractNetwork) {
+  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: ContractNetwork) {
+  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: ContractNetwork) {
+  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: ContractNetwork): string {
+  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: ContractNetwork) {
+  return getContracts(network).testAccounts;
+}
+
+/**
+ * Get SimpleAccountFactory address
+ *
+ * @param network - Network name
+ * @returns SimpleAccountFactory address
+ *
+ * @example
+ * ```ts
+ * const factory = getSimpleAccountFactory('sepolia');
+ * ```
+ */
+export function getSimpleAccountFactory(network: ContractNetwork): string {
+  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: ContractNetwork): string {
+  return getContracts(network).core.superPaymasterV2;
+}
+
+/**
+ * Get EntryPoint v0.7 address
+ *
+ * @param network - Network name
+ * @returns EntryPoint address
+ *
+ * @example
+ * ```ts
+ * const entryPoint = getEntryPoint('sepolia');
+ * ```
+ */
+export function getEntryPoint(network: ContractNetwork): string {
+  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: string): network is ContractNetwork {
+  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(): ContractNetwork[] {
+  return Object.keys(CONTRACTS) as ContractNetwork[];
+}
+
+/**
+ * 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
+      superPaymasterV2: '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
+    },
+  },
+} as const;
+
+/**
+ * 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', 'superPaymasterV2');
+ * // '2025-10-25'
+ * ```
+ */
+export function getDeploymentDate(network: ContractNetwork, contractName: string): string | undefined {
+  const metadata = CONTRACT_METADATA[network];
+  if (!metadata) return undefined;
+
+  return (metadata.deploymentDates as Record<string, string>)[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: ContractNetwork) {
+  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: ContractNetwork, communityName: 'aastar' | 'breadCommunity') {
+  return getCommunities(network)[communityName];
+}

package/ext/aastar-shared-config/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * AAStar Shared Configuration Package
+ *
+ * @packageDocumentation
+ */
+
+export * from './branding';
+export * from './contract-addresses'; // Single source of truth for all contract addresses
+export * from './contracts';
+export * from './contract-versions';
+export * from './networks';
+export * from './constants';
+export * from './communities'; // Community configurations
+export * from './abis';

package/ext/aastar-shared-config/src/networks.ts

@@ -0,0 +1,117 @@
+/**
+ * Blockchain Network Configuration
+ */
+
+export const NETWORKS = {
+  sepolia: {
+    chainId: 11155111,
+    name: 'Sepolia',
+    /** Public RPC URL - users should use their own RPC providers in production */
+    rpcUrl: 'https://rpc.sepolia.org',
+    blockExplorer: 'https://sepolia.etherscan.io',
+    nativeCurrency: {
+      name: 'Sepolia ETH',
+      symbol: 'ETH',
+      decimals: 18,
+    },
+  },
+} as const;
+
+export type SupportedNetwork = keyof typeof NETWORKS;
+
+/**
+ * Get network configuration
+ *
+ * @param network - Network name
+ * @returns Network configuration
+ *
+ * @example
+ * ```ts
+ * const network = getNetwork('sepolia');
+ * console.log(network.chainId); // 11155111
+ * ```
+ */
+export function getNetwork(network: SupportedNetwork) {
+  return NETWORKS[network];
+}
+
+/**
+ * Get RPC URL for a network
+ *
+ * @param network - Network name
+ * @returns Public RPC URL
+ *
+ * @example
+ * ```ts
+ * const rpcUrl = getRpcUrl('sepolia');
+ * ```
+ */
+export function getRpcUrl(network: SupportedNetwork) {
+  return NETWORKS[network].rpcUrl;
+}
+
+/**
+ * Get block explorer URL
+ *
+ * @param network - Network name
+ * @returns Block explorer base URL
+ *
+ * @example
+ * ```ts
+ * const explorer = getBlockExplorer('sepolia');
+ * // 'https://sepolia.etherscan.io'
+ * ```
+ */
+export function getBlockExplorer(network: SupportedNetwork) {
+  return NETWORKS[network].blockExplorer;
+}
+
+/**
+ * Get transaction URL on block explorer
+ *
+ * @param network - Network name
+ * @param txHash - Transaction hash
+ * @returns Full transaction URL
+ *
+ * @example
+ * ```ts
+ * const url = getTxUrl('sepolia', '0x123...');
+ * // 'https://sepolia.etherscan.io/tx/0x123...'
+ * ```
+ */
+export function getTxUrl(network: SupportedNetwork, txHash: string): string {
+  return `${getBlockExplorer(network)}/tx/${txHash}`;
+}
+
+/**
+ * Get address URL on block explorer
+ *
+ * @param network - Network name
+ * @param address - Contract or wallet address
+ * @returns Full address URL
+ *
+ * @example
+ * ```ts
+ * const url = getAddressUrl('sepolia', '0xabc...');
+ * // 'https://sepolia.etherscan.io/address/0xabc...'
+ * ```
+ */
+export function getAddressUrl(network: SupportedNetwork, address: string): string {
+  return `${getBlockExplorer(network)}/address/${address}`;
+}
+
+/**
+ * Get chain ID for a network
+ *
+ * @param network - Network name
+ * @returns Chain ID number
+ *
+ * @example
+ * ```ts
+ * const chainId = getChainId('sepolia');
+ * // 11155111
+ * ```
+ */
+export function getChainId(network: SupportedNetwork): number {
+  return NETWORKS[network].chainId;
+}

package/ext/aastar-shared-config/sync-abis.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+
+# Sync ABIs from SuperPaymaster repository
+# This script copies the latest compiled ABIs from SuperPaymaster to shared-config
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Paths
+SUPERPAYMASTER_DIR="${SUPERPAYMASTER_DIR:-../SuperPaymaster}"
+ABIS_DIR="./src/abis"
+
+echo "🔄 Syncing ABIs from SuperPaymaster"
+echo "==================================="
+echo ""
+
+# Check if SuperPaymaster directory exists
+if [ ! -d "$SUPERPAYMASTER_DIR" ]; then
+    echo -e "${RED}❌ Error: SuperPaymaster directory not found at $SUPERPAYMASTER_DIR${NC}"
+    echo "   Please set SUPERPAYMASTER_DIR environment variable or ensure ../SuperPaymaster exists"
+    exit 1
+fi
+
+# Check if out directory exists
+if [ ! -d "$SUPERPAYMASTER_DIR/out" ]; then
+    echo -e "${YELLOW}⚠️  Warning: $SUPERPAYMASTER_DIR/out not found. Running forge build...${NC}"
+    (cd "$SUPERPAYMASTER_DIR" && forge build)
+fi
+
+# Function to sync ABI
+sync_abi() {
+    local contract_name=$1
+    local sol_file=$2
+    local output_name=${3:-$contract_name}
+
+    local source_file="$SUPERPAYMASTER_DIR/out/$sol_file/$contract_name.json"
+    local dest_file="$ABIS_DIR/$output_name.json"
+
+    if [ ! -f "$source_file" ]; then
+        echo -e "${RED}❌ Source ABI not found: $source_file${NC}"
+        return 1
+    fi
+
+    # Extract only the ABI field (compact single-line format)
+    cat "$source_file" | jq -c '.abi' > "$dest_file"
+
+    echo -e "${GREEN}✅ Synced $contract_name${NC}"
+    echo "   Source: $source_file"
+    echo "   Dest:   $dest_file"
+
+    # Show contract version if available
+    local version=$(cat "$source_file" | jq -r '.abi[] | select(.name == "VERSION") | .outputs[0].internalType' 2>/dev/null || echo "")
+    if [ ! -z "$version" ]; then
+        echo "   Has VERSION interface"
+    fi
+
+    echo ""
+}
+
+# Sync each contract ABI
+echo "Syncing contract ABIs..."
+echo ""
+
+# Core System
+sync_abi "Registry" "Registry.sol" "Registry"
+sync_abi "GToken" "GToken.sol" "GToken"
+sync_abi "GTokenStaking" "GTokenStaking.sol" "GTokenStaking"
+sync_abi "SuperPaymasterV2" "SuperPaymasterV2.sol" "SuperPaymasterV2"
+sync_abi "PaymasterFactory" "PaymasterFactory.sol" "PaymasterFactory"
+
+# Token System
+sync_abi "xPNTsToken" "xPNTsToken.sol" "xPNTsToken"
+sync_abi "MySBT" "MySBT.sol" "MySBT"
+sync_abi "xPNTsFactory" "xPNTsFactory.sol" "xPNTsFactory"
+
+# Monitoring System
+sync_abi "DVTValidator" "DVTValidator.sol" "DVTValidator"
+sync_abi "BLSAggregator" "BLSAggregator.sol" "BLSAggregator"
+
+echo "==================================="
+echo -e "${GREEN}✅ ABI sync completed!${NC}"
+echo ""
+echo "Next steps:"
+echo "1. Review the changes: git diff src/abis/"
+echo "2. Update src/abis/index.ts if new ABIs were added"
+echo "3. Run: npm run build"
+echo "4. Commit the changes"