@aastar/sdk 0.14.0 → 0.16.6

package/lib/SHARED_CONFIG_REFERENCE.md

@@ -0,0 +1,133 @@
+# Shared-Config 参考指南
+
+## 概述
+
+`lib/shared-config` 是作为**参考和学习资料**添加的git submodule,用于了解AAStar社区的最佳实践和配置组织方式。
+
+**重要**: 这不是一个npm依赖,而是一个学习参考。`@aastar/core`模块应该借鉴其设计,但不直接导入。
+
+---
+
+## Shared-Config 结构分析
+
+### 核心文件
+
+1. **`contract-addresses.ts`** - 合约地址的单一真相来源
+   - 按网络组织(Sepolia, Mainnet, Optimism等)
+   - 包含所有V3合约地址
+   - **借鉴点**: 统一的地址管理模式
+
+2. **`contracts.ts`** - 合约配置和元数据
+   - 合约名称、版本、部署信息
+   - **借鉴点**: 合约元数据组织方式
+
+3. **`contract-versions.ts`** - 版本管理
+   - 链上版本验证
+   - **借鉴点**: 版本追踪机制
+
+4. **`communities.ts`** - 社区配置
+   - 社区列表和元数据
+   - **借鉴点**: 社区数据结构
+
+5. **`networks.ts`** - 网络配置
+   - RPC端点、Chain ID等
+   - **借鉴点**: 多链配置模式
+
+6. **`constants.ts`** - 常量定义
+   - 协议参数、魔数等
+   - **借鉴点**: 常量集中管理
+
+7. **`branding.ts`** - 品牌资源
+   - Logo、颜色等
+   - **借鉴点**: 品牌一致性
+
+8. **`abis/`** - ABI文件
+   - 所有合约的ABI
+   - **借鉴点**: ABI组织方式
+
+---
+
+## 当前Core模块状态
+
+`@aastar/core` 已经有类似的文件:
+- ✅ `contract-addresses.ts` - 已存在
+- ✅ `contracts.ts` - 已存在  
+- ✅ `contract-versions.ts` - 已存在
+- ✅ `communities.ts` - 已存在
+- ✅ `abis/` - 已存在
+
+**结论**: Core模块已经借鉴了shared-config的组织方式,无需额外迁移。
+
+---
+
+## 使用建议
+
+### 1. 作为参考资料
+
+当需要了解最新的合约地址、版本或配置时:
+
+```bash
+cd lib/shared-config
+git pull origin main
+# 查看最新配置
+cat src/contract-addresses.ts
+```
+
+### 2. 同步更新
+
+定期检查shared-config的更新,手动同步到core:
+
+```bash
+# 查看shared-config的变更
+cd lib/shared-config
+git log --oneline -10
+
+# 手动更新core模块相应文件
+```
+
+### 3. 学习最佳实践
+
+参考shared-config的:
+- 类型定义方式
+- 配置组织结构
+- 文档注释风格
+- 导出模式
+
+---
+
+## 维护指南
+
+### 更新Submodule
+
+```bash
+# 更新到最新版本
+git submodule update --remote lib/shared-config
+
+# 提交submodule更新
+git add lib/shared-config
+git commit -m "chore: update shared-config reference"
+```
+
+### 不要导入
+
+❌ **错误做法**:
+```typescript
+import { CONTRACTS } from '../../lib/shared-config/src';
+```
+
+✅ **正确做法**:
+```typescript
+// 在 @aastar/core 中维护自己的配置
+export const CONTRACTS = {
+  // 借鉴 shared-config 的结构,但独立维护
+};
+```
+
+---
+
+## 总结
+
+- **Submodule目的**: 参考学习,不是依赖
+- **Core模块**: 独立维护,借鉴设计
+- **更新策略**: 手动同步,保持独立性
+- **最佳实践**: 学习结构,不直接导入

package/lib/shared-config/.env.example

@@ -0,0 +1,6 @@
+# Environment Variables Template
+# Copy this file to .env and fill in your values
+# NEVER commit .env file to git!
+
+PRIVATE_KEY=
+API_KEY=

package/lib/shared-config/.github/workflows/check-secrets.yml

@@ -0,0 +1,257 @@
+name: Security - Check for Private Keys
+
+on:
+  pull_request:
+    branches: [ main, master, develop ]
+  push:
+    branches: [ main, master, develop ]
+
+jobs:
+  check-secrets:
+    runs-on: ubuntu-latest
+    name: Scan for Private Keys and Secrets
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Check for private keys and sensitive data
+        run: |
+          #!/bin/bash
+          set -e
+          
+          RED='\033[0;31m'
+          GREEN='\033[0;32m'
+          YELLOW='\033[1;33m'
+          BLUE='\033[0;34m'
+          NC='\033[0m'
+          
+          # 排除的目录
+          EXCLUDED_DIRS="node_modules|\.git|\.netlify|\.svelte-kit|build|dist|\.next|contracts/broadcast|contracts/cache|contracts/lib|test-results|playwright-report|\.auth|vendor|cache|out"
+          
+          # 扫描的文件扩展名
+          SCAN_EXTENSIONS="\.(ts|tsx|js|jsx|svelte|sol|md|json|env|example|toml|yaml|yml)$"
+          
+          echo -e "${BLUE}🔒 GitHub Actions: Scanning repository for private keys...${NC}\n"
+          
+          # 获取所有文件（排除特定目录）
+          FILES_TO_SCAN=$(find . -type f | grep -E "$SCAN_EXTENSIONS" | grep -v -E "$EXCLUDED_DIRS" || true)
+          
+          if [ -z "$FILES_TO_SCAN" ]; then
+            echo -e "${GREEN}✅ No files to scan${NC}"
+            exit 0
+          fi
+          
+          FILE_COUNT=$(echo "$FILES_TO_SCAN" | wc -l | tr -d ' ')
+          echo -e "${BLUE}📋 Scanning ${FILE_COUNT} file(s) for secrets...${NC}\n"
+          
+          # 检测模式
+          # 1. Ethereum private key: 0x + 64 hex chars
+          ETHEREUM_KEY_PATTERN='0x[a-fA-F0-9]{64}'
+          
+          # 2. PEM format private keys
+          PEM_PATTERN='BEGIN.*PRIVATE KEY'
+          
+          # 3. AWS access key
+          AWS_ACCESS_PATTERN='AKIA[0-9A-Z]{16}'
+          
+          # 4. AWS secret key
+          AWS_SECRET_PATTERN='aws_secret_access_key[[:space:]]*=[[:space:]]*[a-zA-Z0-9/+]{40}'
+          
+          # 5. Private key with actual hex value
+          PRIVATE_KEY_WITH_VALUE_PATTERN='private[_-]key[[:space:]]*[:=][[:space:]]*0x[a-fA-F0-9]{32,}'
+          
+          # 6. OpenAI API keys (sk-... or sk-proj-...)
+          OPENAI_KEY_PATTERN='sk-[a-zA-Z0-9]{48,}'
+          OPENAI_PROJ_KEY_PATTERN='sk-proj-[a-zA-Z0-9_-]{48,}'
+          
+          # 7. Google AI (Gemini) API keys (AIza...)
+          GOOGLE_AI_KEY_PATTERN='AIza[a-zA-Z0-9_-]{35,}'
+          
+          # 8. Anthropic (Claude) API keys (sk-ant-...)
+          ANTHROPIC_KEY_PATTERN='sk-ant-[a-zA-Z0-9_-]{95,}'
+          
+          # 9. GitHub Personal Access Tokens (ghp_..., gho_..., ghs_...)
+          GITHUB_PAT_PATTERN='gh[pousr]_[a-zA-Z0-9]{36,}'
+          
+          # 10. Stripe API keys (sk_live_..., sk_test_...)
+          STRIPE_KEY_PATTERN='sk_(live|test)_[a-zA-Z0-9]{24,}'
+          
+          # 11. Generic API keys
+          API_KEY_PATTERN='api[_-]key[[:space:]]*[:=][[:space:]]*[\"\\x27][a-zA-Z0-9]{32,}[\"\\x27]'
+          
+          FOUND_SECRETS=0
+          TOTAL_FINDINGS=0
+          
+          for FILE in $FILES_TO_SCAN; do
+            if [ ! -f "$FILE" ]; then
+              continue
+            fi
+            
+            FINDINGS=""
+            
+            # Check Ethereum keys
+            if grep -nE "$ETHEREUM_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              FINDINGS="${FINDINGS}   [CRITICAL] Ethereum Private Key (256-bit hex)\n"
+              FINDINGS="${FINDINGS}$(grep -nE "$ETHEREUM_KEY_PATTERN" "$FILE" | head -3 | sed 's/^/     /')\n"
+              FOUND_SECRETS=1
+              TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+            fi
+            
+            # Check PEM keys
+            if grep -nE "$PEM_PATTERN" "$FILE" > /dev/null 2>&1; then
+              FINDINGS="${FINDINGS}   [CRITICAL] PEM Private Key\n"
+              FINDINGS="${FINDINGS}$(grep -nE "$PEM_PATTERN" "$FILE" | head -3 | sed 's/^/     /')\n"
+              FOUND_SECRETS=1
+              TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+            fi
+            
+            # Check AWS access keys
+            if grep -nE "$AWS_ACCESS_PATTERN" "$FILE" > /dev/null 2>&1; then
+              FINDINGS="${FINDINGS}   [CRITICAL] AWS Access Key\n"
+              FINDINGS="${FINDINGS}$(grep -nE "$AWS_ACCESS_PATTERN" "$FILE" | head -3 | sed 's/^/     /')\n"
+              FOUND_SECRETS=1
+              TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+            fi
+            
+            # Check AWS secret keys
+            if grep -nE "$AWS_SECRET_PATTERN" "$FILE" > /dev/null 2>&1; then
+              FINDINGS="${FINDINGS}   [CRITICAL] AWS Secret Key\n"
+              FINDINGS="${FINDINGS}$(grep -nE "$AWS_SECRET_PATTERN" "$FILE" | head -3 | sed 's/^/     /')\n"
+              FOUND_SECRETS=1
+              TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+            fi
+            
+            # Check private keys with values
+            if grep -nEi "$PRIVATE_KEY_WITH_VALUE_PATTERN" "$FILE" > /dev/null 2>&1; then
+              PRIVATE_KEY_LINES=$(grep -nEi "$PRIVATE_KEY_WITH_VALUE_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$PRIVATE_KEY_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] Private Key with Hex Value\n"
+                FINDINGS="${FINDINGS}$(echo "$PRIVATE_KEY_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            # Check OpenAI API keys
+            if grep -nE "$OPENAI_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              OPENAI_LINES=$(grep -nE "$OPENAI_KEY_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$OPENAI_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] OpenAI API Key\n"
+                FINDINGS="${FINDINGS}$(echo "$OPENAI_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            if grep -nE "$OPENAI_PROJ_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              OPENAI_PROJ_LINES=$(grep -nE "$OPENAI_PROJ_KEY_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$OPENAI_PROJ_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] OpenAI Project API Key\n"
+                FINDINGS="${FINDINGS}$(echo "$OPENAI_PROJ_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            # Check Google AI (Gemini) API keys
+            if grep -nE "$GOOGLE_AI_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              GOOGLE_LINES=$(grep -nE "$GOOGLE_AI_KEY_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$GOOGLE_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] Google AI (Gemini) API Key\n"
+                FINDINGS="${FINDINGS}$(echo "$GOOGLE_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            # Check Anthropic (Claude) API keys
+            if grep -nE "$ANTHROPIC_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              ANTHROPIC_LINES=$(grep -nE "$ANTHROPIC_KEY_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$ANTHROPIC_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] Anthropic (Claude) API Key\n"
+                FINDINGS="${FINDINGS}$(echo "$ANTHROPIC_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            # Check GitHub tokens
+            if grep -nE "$GITHUB_PAT_PATTERN" "$FILE" > /dev/null 2>&1; then
+              GITHUB_LINES=$(grep -nE "$GITHUB_PAT_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$GITHUB_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] GitHub Personal Access Token\n"
+                FINDINGS="${FINDINGS}$(echo "$GITHUB_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            # Check Stripe API keys
+            if grep -nE "$STRIPE_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              STRIPE_LINES=$(grep -nE "$STRIPE_KEY_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$STRIPE_LINES" ]; then
+                FINDINGS="${FINDINGS}   [CRITICAL] Stripe API Key\n"
+                FINDINGS="${FINDINGS}$(echo "$STRIPE_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            # Check API keys
+            if grep -nEi "$API_KEY_PATTERN" "$FILE" > /dev/null 2>&1; then
+              API_KEY_LINES=$(grep -nEi "$API_KEY_PATTERN" "$FILE" | grep -v "^[[:space:]]*#" | grep -v "^[[:space:]]*//")
+              if [ -n "$API_KEY_LINES" ]; then
+                FINDINGS="${FINDINGS}   [WARNING] Possible API Key\n"
+                FINDINGS="${FINDINGS}$(echo "$API_KEY_LINES" | head -3 | sed 's/^/     /')\n"
+                FOUND_SECRETS=1
+                TOTAL_FINDINGS=$((TOTAL_FINDINGS + 1))
+              fi
+            fi
+            
+            if [ -n "$FINDINGS" ]; then
+              echo -e "${RED}❌ ${FILE}:${NC}"
+              echo -e "$FINDINGS"
+            fi
+          done
+          
+          if [ $FOUND_SECRETS -eq 1 ]; then
+            echo -e "${RED}========================================${NC}"
+            echo -e "${RED}🚨 SECURITY ALERT: ${TOTAL_FINDINGS} secret(s) detected!${NC}\n"
+            echo -e "${YELLOW}⚠️  Do NOT merge this code!${NC}\n"
+            echo -e "Actions required:"
+            echo -e "  1. ${YELLOW}Remove${NC} all private keys and secrets from the code"
+            echo -e "  2. Use ${BLUE}.env${NC} files for sensitive data (add to ${BLUE}.gitignore${NC})"
+            echo -e "  3. Rotate any exposed credentials immediately"
+            echo -e "  4. Review git history for leaked secrets"
+            echo -e "  5. Consider using tools like ${BLUE}git-secrets${NC} or ${BLUE}truffleHog${NC}\n"
+            echo -e "${RED}========================================${NC}\n"
+            
+            # 设置 GitHub Actions 注解
+            echo "::error::Private keys or secrets detected in the codebase. Please remove them before merging."
+            
+            exit 1
+          fi
+          
+          echo -e "${GREEN}========================================${NC}"
+          echo -e "${GREEN}✅ No private keys detected${NC}"
+          echo -e "${GREEN}✅ Security check passed!${NC}"
+          echo -e "${GREEN}========================================${NC}\n"
+          
+          exit 0
+      
+      - name: Comment on PR (if secrets found)
+        if: failure() && github.event_name == 'pull_request'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '🚨 **Security Alert**: Private keys or secrets detected in this PR!\n\n' +
+                    '⚠️ Please remove all sensitive data before merging.\n\n' +
+                    'Check the Actions log for details about what was found.'
+            })

package/lib/shared-config/AGENTS.md

@@ -0,0 +1,21 @@
+# AAStar Shared Config - Agent Guidelines
+
+## Build Commands
+- `pnpm build` - Build CJS/ESM modules with types
+- `pnpm dev` - Build with watch mode
+- `pnpm verify` - Verify onchain contract versions
+- `pnpm sync-abis` - Sync contract ABIs from SuperPaymaster repo
+- `pnpm sync-versions` - Auto-sync contract versions from on-chain data
+- `pnpm sync-all` - Sync both ABIs and versions
+- `./sync-abis.sh` - Sync contract ABIs before publish
+
+## Code Style
+- **TypeScript**: Strict mode enabled, ES2020 target
+- **Imports**: Use `export * from './module'` pattern in index.ts
+- **Constants**: UPPER_SNAKE_CASE for all constants
+- **Types**: Use `as const` for immutable objects
+- **Functions**: JSDoc comments with @examples
+- **Error Handling**: Throw descriptive Error messages with context
+- **File Structure**: Separate addresses, contracts, constants, branding
+- **Naming**: camelCase for functions, PascalCase for types
+- **Comments**: JSDoc format with @param and @returns

package/lib/shared-config/CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.1] - 2025-11-08
+
+### Added
+- **Community Configurations**: New `communities.ts` module with typed community configs
+  - `AASTAR_COMMUNITY`: AAstar community (PAYMASTER_SUPER, aPNTs, MySBT)
+  - `BREAD_COMMUNITY`: Bread community (PAYMASTER_AOA, bPNTs, MySBT)
+  - Helper functions: `getCommunityConfig()`, `getAllCommunityConfigs()`, `isRegisteredCommunity()`
+- **Test Communities**: Updated `TEST_COMMUNITIES` with AAstar and Bread communities
+  - AAstar: `0x411BD567E46C0781248dbB6a9211891C032885e5` (50 GT staked)
+  - Bread: `0xe24b6f321B0140716a2b671ed0D983bb64E7DaFA` (50 GT staked)
+
+### Changed
+- Updated test community documentation with detailed metadata
+- Added community-to-token mappings (aPNTs/bPNTs)
+- Added MySBT as supported SBT for both communities
+
+## [0.3.0] - 2025-11-08
+
+### Added
+- **Registry v2.2.0**: New deployment with auto-stake registration functionality (`0x028aB52B4E0EF26820043ca4F1B5Fe14FfC1EF75`)
+  - `registerCommunityWithAutoStake()` - One-click registration + staking
+  - Node type configuration (AOA/Super/ANode/KMS)
+  - MySBT-style auto-stake pattern
+- **SuperPaymasterV2 v2.0.1**: Updated deployment with Oracle security enhancements (`0xfaB5B2A129DF8308a70DA2fE77c61001e4Df58BC`)
+  - Chainlink oracle `answeredInRound` validation
+  - Price data staleness check (1 hour timeout)
+  - Price bounds validation ($100 - $100,000)
+- **Updated ABIs**: Registry.json and SuperPaymasterV2.json with latest contract versions
+
+### Changed
+- **Registry**: Updated from `0xf384c592D5258c91805128291c5D4c069DD30CA6` to `0x028aB52B4E0EF26820043ca4F1B5Fe14FfC1EF75`
+- **SuperPaymasterV2**: Updated from `0x95B20d8FdF173a1190ff71e41024991B2c5e58eF` to `0xfaB5B2A129DF8308a70DA2fE77c61001e4Df58BC`
+
+### Fixed
+- **Deployment Order**: SuperPaymasterV2 now correctly references Registry v2.2.0 (immutable REGISTRY field)
+- **Oracle Security**: Enhanced Chainlink price feed validation to prevent stale data usage
+
+### Notes
+- SuperPaymasterV2 v2.0.1 is deployed with correct dependency on Registry v2.2.0
+- Previous deployments (`0x33A31d52db2ef2497e93226e0ed1B5d587D7D5e8`, `0x5675062cA5D98c791972eAC24eFa3BC3EBc096f3`) deprecated due to incorrect deployment order
+- GTokenStaking lockers configured for MySBT, SuperPaymasterV2, and Registry
+
+## [0.2.2] - 2025-10-30
+
+### Added
+- **Test Tokens category**: Added `testTokens` section for development and testing contracts
+- **Mock USDT**: Added Mock USDT contract address (`0x14EaC6C3D49AEDff3D59773A7d7bfb50182bCfDc`)
+- **getTestTokenContracts()**: New helper function to retrieve test token addresses
+
+### Changed
+- Updated `ContractCategory` type to include `'testTokens'`
+
+## [0.2.1] - 2025-10-30
+
+### Fixed
+- Fixed TypeScript declaration file issues with JSON imports
+- Removed ABI exports from main entry point to avoid type errors
+- ABIs are now imported directly from JSON files (see README for usage)
+- Significantly reduced bundle size (50KB → 9KB)
+
+### Changed
+- Updated README with correct ABI import instructions
+
+## [0.2.0] - 2025-10-30
+
+### Added
+- Comprehensive contract address management system
+- Type-safe helper functions for contract queries
+- Network configuration with utility functions
+- Deployment metadata tracking with dates
+- Enhanced constants with node stake amounts
+- Complete TypeScript type definitions
+- Extensive JSDoc documentation with examples
+
+### Changed
+- Removed `process.env` dependencies from constants
+- Renamed `SupportedNetwork` to `ContractNetwork` in contracts module to avoid naming conflicts
+- Updated all contract addresses to latest deployments (as of 2025-10-30)
+- Enhanced README with complete usage examples
+
+### Fixed
+- Fixed type conflicts between contracts and networks modules
+- Removed environment variable dependencies for better npm package compatibility
+
+## [0.1.0] - 2025-10-24
+
+### Added
+- Initial release
+- Basic contract addresses
+- Network configurations
+- ABIs for core contracts
+- Branding and links configuration

package/lib/shared-config/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AAStar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.