@aastar/sdk 0.14.0 → 0.14.3

package/config/networks/README.md

@@ -0,0 +1,54 @@
+# 网络配置文件模板目录
+
+本目录包含不同网络的配置文件模板，用于在不同EVM网络上运行SDK测试。
+
+## 📋 可用模板
+
+- `sepolia.env.example` - Sepolia测试网配置
+- `mainnet.env.example` - 以太坊主网配置
+- `optimism.env.example` - Optimism主网配置
+- `optimism-sepolia.env.example` - Optimism Sepolia测试网配置
+
+## 🚀 使用方法
+
+### 步骤1: 复制模板
+
+```bash
+# 复制Sepolia配置
+cp config/networks/sepolia.env.example .env.sepolia
+
+# 复制Mainnet配置
+cp config/networks/mainnet.env.example .env.mainnet
+
+# 复制Optimism配置
+cp config/networks/optimism.env.example .env.optimism
+```
+
+### 步骤2: 填入真实配置
+
+编辑复制的文件，替换以下内容：
+
+1. **RPC_URL**: 你的Alchemy/Infura API Key
+2. **ADMIN_KEY**: 你的私钥（⚠️ 测试网使用测试私钥，主网使用硬件钱包）
+3. **合约地址**: 部署到目标网络的合约地址
+
+### 步骤3: 运行测试
+
+```bash
+# 使用dotenv-cli加载配置
+dotenv -e .env.sepolia -- pnpm run test:full_sdk
+
+# 或使用环境变量
+RPC_URL=... REGISTRY_ADDRESS=... pnpm run test:full_sdk
+```
+
+## ⚠️ 安全提示
+
+1. **永远不要提交 `.env.*` 文件到Git**
+2. **使用硬件钱包或加密存储管理主网私钥**
+3. **测试网私钥与主网私钥分离**
+4. **定期轮换API Keys**
+
+## 📖 详细文档
+
+完整的网络切换指南请参考: [`docs/TEST_COMMANDS.md`](../../docs/TEST_COMMANDS.md#🌐-网络切换指南)

package/config/networks/mainnet.env.example

@@ -0,0 +1,39 @@
+# 以太坊主网配置
+# 使用方法: 
+#   1. 复制此文件: cp config/networks/mainnet.env.example .env.mainnet
+#   2. 填入真实的API Key和合约地址
+#   3. 运行: dotenv -e .env.mainnet -- pnpm run test:full_sdk
+
+# ⚠️ 警告: 主网操作需要真实ETH，请谨慎操作！
+
+# 网络RPC
+RPC_URL=https://eth-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
+
+# 管理员私钥（⚠️ 强烈建议使用硬件钱包或加密存储！）
+ADMIN_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+PRIVATE_KEY_JASON=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# 主网合约地址（需要先部署到主网）
+# 部署方法: cd ../SuperPaymaster && forge script script/v3/DeployV3Mainnet.s.sol --rpc-url $RPC_URL --broadcast --verify
+REGISTRY_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_STAKING_ADDRESS=0x0000000000000000000000000000000000000000
+SUPER_PAYMASTER_ADDRESS=0x0000000000000000000000000000000000000000
+APNTS_ADDRESS=0x0000000000000000000000000000000000000000
+MYSBT_ADDRESS=0x0000000000000000000000000000000000000000
+XPNTS_ADDR=0x0000000000000000000000000000000000000000
+STAKING_ADDR=0x0000000000000000000000000000000000000000
+REGISTRY_ADDR=0x0000000000000000000000000000000000000000
+
+# EntryPoint v0.7 (主网官方地址)
+ENTRYPOINT_ADDRESS_V07=0x0000000071727De22E5E9d8BAf0edAc6f37da032
+
+# 网络信息
+CHAIN_ID=1
+NETWORK_NAME=mainnet
+
+# 安全建议:
+# 1. 使用硬件钱包（Ledger/Trezor）
+# 2. 启用多签钱包（Gnosis Safe）
+# 3. 限制私钥权限（只读操作优先）
+# 4. 定期审计合约交互

package/config/networks/optimism-sepolia.env.example

@@ -0,0 +1,35 @@
+# Optimism Sepolia测试网配置
+# 使用方法: 
+#   1. 复制此文件: cp config/networks/optimism-sepolia.env.example .env.op-sepolia
+#   2. 填入真实的API Key和合约地址
+#   3. 运行: dotenv -e .env.op-sepolia -- pnpm run test:full_sdk
+
+# 网络RPC
+RPC_URL=https://opt-sepolia.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
+
+# 管理员私钥（测试网专用）
+ADMIN_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+PRIVATE_KEY_JASON=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# Optimism Sepolia合约地址
+REGISTRY_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_STAKING_ADDRESS=0x0000000000000000000000000000000000000000
+SUPER_PAYMASTER_ADDRESS=0x0000000000000000000000000000000000000000
+APNTS_ADDRESS=0x0000000000000000000000000000000000000000
+MYSBT_ADDRESS=0x0000000000000000000000000000000000000000
+XPNTS_ADDR=0x0000000000000000000000000000000000000000
+STAKING_ADDR=0x0000000000000000000000000000000000000000
+REGISTRY_ADDR=0x0000000000000000000000000000000000000000
+
+# EntryPoint v0.7 (Optimism Sepolia地址)
+ENTRYPOINT_ADDRESS_V07=0x0000000071727De22E5E9d8BAf0edAc6f37da032
+
+# 网络信息
+CHAIN_ID=11155420
+NETWORK_NAME=optimism-sepolia
+
+# 获取Optimism Sepolia测试ETH:
+# 1. 先获取Sepolia ETH (https://sepoliafaucet.com/)
+# 2. 使用官方桥接: https://app.optimism.io/bridge
+# 或直接使用Superchain水龙头: https://console.optimism.io/faucet

package/config/networks/optimism.env.example

@@ -0,0 +1,36 @@
+# Optimism主网配置
+# 使用方法: 
+#   1. 复制此文件: cp config/networks/optimism.env.example .env.optimism
+#   2. 填入真实的API Key和合约地址
+#   3. 运行: dotenv -e .env.optimism -- pnpm run test:full_sdk
+
+# 网络RPC
+RPC_URL=https://opt-mainnet.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
+
+# 管理员私钥
+ADMIN_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+PRIVATE_KEY_JASON=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# Optimism主网合约地址
+REGISTRY_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_STAKING_ADDRESS=0x0000000000000000000000000000000000000000
+SUPER_PAYMASTER_ADDRESS=0x0000000000000000000000000000000000000000
+APNTS_ADDRESS=0x0000000000000000000000000000000000000000
+MYSBT_ADDRESS=0x0000000000000000000000000000000000000000
+XPNTS_ADDR=0x0000000000000000000000000000000000000000
+STAKING_ADDR=0x0000000000000000000000000000000000000000
+REGISTRY_ADDR=0x0000000000000000000000000000000000000000
+
+# EntryPoint v0.7 (Optimism主网地址)
+ENTRYPOINT_ADDRESS_V07=0x0000000071727De22E5E9d8BAf0edAc6f37da032
+
+# 网络信息
+CHAIN_ID=10
+NETWORK_NAME=optimism
+
+# Optimism特性:
+# - 低Gas费用（比以太坊主网便宜10-100倍）
+# - 快速确认（~2秒出块）
+# - EVM兼容
+# - 适合高频交易场景

package/config/networks/sepolia.env.example

@@ -0,0 +1,36 @@
+# Sepolia测试网配置
+# 使用方法: 
+#   1. 复制此文件: cp config/networks/sepolia.env.example .env.sepolia
+#   2. 填入真实的API Key和合约地址
+#   3. 运行: dotenv -e .env.sepolia -- pnpm run test:full_sdk
+
+# 网络RPC（请替换为你的Alchemy/Infura API Key）
+RPC_URL=https://eth-sepolia.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY
+
+# 管理员私钥（⚠️ 请使用Sepolia测试账户，不要使用主网私钥！）
+ADMIN_KEY=0x0000000000000000000000000000000000000000000000000000000000000000
+PRIVATE_KEY_JASON=0x0000000000000000000000000000000000000000000000000000000000000000
+
+# Sepolia合约地址（需要先部署到Sepolia）
+# 部署方法: cd ../SuperPaymaster && forge script script/v3/DeployV3Sepolia.s.sol --rpc-url $RPC_URL --broadcast
+REGISTRY_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_ADDRESS=0x0000000000000000000000000000000000000000
+GTOKEN_STAKING_ADDRESS=0x0000000000000000000000000000000000000000
+SUPER_PAYMASTER_ADDRESS=0x0000000000000000000000000000000000000000
+APNTS_ADDRESS=0x0000000000000000000000000000000000000000
+MYSBT_ADDRESS=0x0000000000000000000000000000000000000000
+XPNTS_ADDR=0x0000000000000000000000000000000000000000
+STAKING_ADDR=0x0000000000000000000000000000000000000000
+REGISTRY_ADDR=0x0000000000000000000000000000000000000000
+
+# EntryPoint v0.7 (Sepolia官方地址)
+ENTRYPOINT_ADDRESS_V07=0x0000000071727De22E5E9d8BAf0edAc6f37da032
+
+# 网络信息
+CHAIN_ID=11155111
+NETWORK_NAME=sepolia
+
+# 获取Sepolia测试ETH水龙头:
+# - https://sepoliafaucet.com/
+# - https://www.alchemy.com/faucets/ethereum-sepolia
+# - https://faucet.quicknode.com/ethereum/sepolia

package/data/experiment_data.csv

@@ -0,0 +1,36 @@
+2025-12-17T14:27:48.592Z,Baseline 1,EOA Transfer,FAILED,0,0,0,"Error: Missing or invalid parameters.
+Double check you have provided the correct parameters.
+
+URL: https://eth-sepolia.g.alchemy.com/v2/Bx4QRW1-vnwJUePSAAD7N
+Request body: {""method"":""eth_sendRawTransaction"",""params"":[""0x02f8b183aa36a759830f490284b0bfb4f282cb2694d47455c48b379920c3649e8c531c7d16eba4657d80b844a9059cbb00000000000000000000000093e67dbb7b2431de61a9f6c7e488e7f0e2ed2b3e000000000000000000000000000000000000000000000000016345785d8a0000c080a09af84590a6127d75a416c6088decb5ab117628bcd516b9cfdc69c4f689f53c8ba00ef17647c320372b9890fe7640f8896946643f42501626321019ca0cd9ccc22a""]}
+ 
+Request Arguments:
+  from:  0xb5600060e6de5E11D3636731964218E53caadf0E
+  to:    0xD47455C48B379920c3649E8c531c7d16eBA4657D
+  data:  0xa9059cbb00000000000000000000000093e67dbb7b2431de61a9f6c7e488e7f0e2ed2b3e000000000000000000000000000000000000000000000000016345785d8a0000
+ 
+Contract Call:
+  address:   0xD47455C48B379920c3649E8c531c7d16eBA4657D
+  function:  transfer(address to, uint256 amount)
+  args:              (0x93E67dbB7B2431dE61a9F6c7E488e7F0E2eD2B3e, 100000000000000000)
+  sender:    0xb5600060e6de5E11D3636731964218E53caadf0E
+
+Docs: https://viem.sh/docs/contract/writeContract
+Details: replacement transaction underpriced
+Version: viem@2.41.2"
+2025-12-17T14:28:58.750Z,Group B,,,,,,"Error: HTTP request failed.
+
+Status: 400
+URL: https://eth-sepolia.g.alchemy.com/v2/WEVdanalMvLC4pxYct2GR
+Request body: {""method"":""eth_estimateUserOperationGas"",""params"":[{""sender"":""0x179Faf25600c01DBFcEf7971f15DcFa3FbE5d31C"",""nonce"":""1"",""initCode"":""0x"",""callData"":""0xa9059cbb00000000000000000000000093e67dbb7b2431de61a9f6c7e488e7f0e2ed2b3e00000000000000000000000000000000000000000000000000038d7ea4c68000"",""paymasterAndData"":""0xF5dDA223Cb164Db1164A6BF2e1b54e4e2e52116b"",""signature"":""0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c""},""0x0000000071727De22E5E9d8BAf0edAc6f37da032""]}
+
+Details: {""code"":-32602,""message"":""invalid 1st argument: userOperation invalid user operation fields""}
+Version: viem@2.41.2"
+2025-12-17T14:29:28.027Z,Experiment C,,,,,,"Error: HTTP request failed.
+
+Status: 400
+URL: https://eth-sepolia.g.alchemy.com/v2/WEVdanalMvLC4pxYct2GR
+Request body: {""method"":""eth_estimateUserOperationGas"",""params"":[{""sender"":""0xb78ef5C8DD059ABa48b65c8069641f30BBf0A1ED"",""nonce"":""1"",""initCode"":""0x"",""callData"":""0xa9059cbb00000000000000000000000093e67dbb7b2431de61a9f6c7e488e7f0e2ed2b3e00000000000000000000000000000000000000000000000000038d7ea4c68000"",""paymasterAndData"":""0xe8c579dc426eC22168c3286da1aBd5458a5904A30000000000000000000000000002710000000000000000000000000000002710b5600060e6de5E11D3636731964218E53caadf0E4eEF13E130fA5f2aA17089aEf2754234f49f1D49"",""signature"":""0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c""},""0x0000000071727De22E5E9d8BAf0edAc6f37da032""]}
+
+Details: {""code"":-32602,""message"":""invalid 1st argument: userOperation invalid user operation fields""}
+Version: viem@2.41.2"

package/data/industry_baseline_2025-12-23.json

@@ -0,0 +1,154 @@
+{
+  "timestamp": "2025-12-23T09:40:32.334Z",
+  "sources": {
+    "l2beat": "https://l2beat.com/scaling/costs",
+    "l2fees": "https://l2fees.info/"
+  },
+  "chains": [
+    {
+      "name": "Lighter",
+      "avgCostUSD": 1.7,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.06,
+      "total": "7.64B",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Starknet",
+      "avgCostUSD": 108.55,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 8.5,
+      "total": "22.73M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "OP Mainnet",
+      "avgCostUSD": 125.04,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.02,
+      "total": "48.28M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Unichain",
+      "avgCostUSD": 131.74,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.21,
+      "total": "22.51M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Ink",
+      "avgCostUSD": 153.44,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.01,
+      "total": "15.88M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Base Chain",
+      "avgCostUSD": 168.59,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.01,
+      "total": "418.58M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Arbitrum One",
+      "avgCostUSD": 214.55,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.64,
+      "total": "89.10M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Linea",
+      "avgCostUSD": 290.27,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 8.26,
+      "total": "2.77M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "ZKsync Era",
+      "avgCostUSD": 359.01,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 22.53,
+      "total": "987.91K",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Abstract",
+      "avgCostUSD": 359.08,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 15.21,
+      "total": "9.01M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "BOB",
+      "avgCostUSD": 464.72,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.25,
+      "total": "331.84K",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Zircuit",
+      "avgCostUSD": 545.51,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 3.85,
+      "total": "1.51M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Katana",
+      "avgCostUSD": 1420,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 11.94,
+      "total": "985.98K",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Scroll",
+      "avgCostUSD": 1440,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 17.01,
+      "total": "2.21M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    }
+  ],
+  "averages": {
+    "costUSD": 265.5,
+    "costGwei": 379.285714,
+    "gasUsed": 200000
+  }
+}

package/data/industry_baseline_latest.json

@@ -0,0 +1,154 @@
+{
+  "timestamp": "2025-12-23T09:40:32.334Z",
+  "sources": {
+    "l2beat": "https://l2beat.com/scaling/costs",
+    "l2fees": "https://l2fees.info/"
+  },
+  "chains": [
+    {
+      "name": "Lighter",
+      "avgCostUSD": 1.7,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.06,
+      "total": "7.64B",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Starknet",
+      "avgCostUSD": 108.55,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 8.5,
+      "total": "22.73M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "OP Mainnet",
+      "avgCostUSD": 125.04,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.02,
+      "total": "48.28M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Unichain",
+      "avgCostUSD": 131.74,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.21,
+      "total": "22.51M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Ink",
+      "avgCostUSD": 153.44,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.01,
+      "total": "15.88M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Base Chain",
+      "avgCostUSD": 168.59,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.01,
+      "total": "418.58M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Arbitrum One",
+      "avgCostUSD": 214.55,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.64,
+      "total": "89.10M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Linea",
+      "avgCostUSD": 290.27,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 8.26,
+      "total": "2.77M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "ZKsync Era",
+      "avgCostUSD": 359.01,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 22.53,
+      "total": "987.91K",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Abstract",
+      "avgCostUSD": 359.08,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 15.21,
+      "total": "9.01M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "BOB",
+      "avgCostUSD": 464.72,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 0.25,
+      "total": "331.84K",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Zircuit",
+      "avgCostUSD": 545.51,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 3.85,
+      "total": "1.51M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Katana",
+      "avgCostUSD": 1420,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 11.94,
+      "total": "985.98K",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    },
+    {
+      "name": "Scroll",
+      "avgCostUSD": 1440,
+      "avgCostETH": 0,
+      "avgCostGas": 0,
+      "perUserOp": 17.01,
+      "total": "2.21M",
+      "source": "manual",
+      "timestamp": "2025-12-23T09:40:31.390Z"
+    }
+  ],
+  "averages": {
+    "costUSD": 265.5,
+    "costGwei": 379.285714,
+    "gasUsed": 200000
+  }
+}