{"_id":"@aastar/airaccount-sdk","_rev":"5-b6971cf2e9c2b11355422e65a5421e7f","name":"@aastar/airaccount-sdk","dist-tags":{"test":"0.1.0-test.1","latest":"0.1.0-test.1"},"versions":{"0.1.0-test.1":{"name":"@aastar/airaccount-sdk","version":"0.1.0-test.1","keywords":["airaccount","web3","wallet","tee","hardware-wallet","rust","wasm","blockchain","ethereum","account-abstraction","erc-4337","viem","ethers"],"author":{"name":"AirAccount Team","email":"dev@airaccount.io"},"license":"MIT","_id":"@aastar/airaccount-sdk@0.1.0-test.1","maintainers":[{"name":"cejay","email":"z.cejay@gmail.com"},{"name":"jhfnetboy","email":"jhfnetboy@gmail.com"},{"name":"rorywang","email":"0x1rory@gmail.com"},{"name":"fanhousanbu","email":"fanhousanbu@gmail.com"},{"name":"superwunc","email":"superwunc@gmail.com"}],"homepage":"https://airaccount.io","bugs":{"url":"https://github.com/aastar/AirAccount/issues"},"dist":{"shasum":"18e98a9efa7aa70da79f506fbaf253d008ea4489","tarball":"https://registry.npmjs.org/@aastar/airaccount-sdk/-/airaccount-sdk-0.1.0-test.1.tgz","fileCount":36,"integrity":"sha512-+wCIrKvXCNZUxhGeVkrwcoKFWxp58XXNt5toch01MsHhyvkmum4nCzGJv2BwrPE9EGiVRmceNWKrRRMkmquxbQ==","signatures":[{"sig":"MEUCIQCwLqHjnC2ZQJNpNJ3Uow+IgO/mPIJztpMLzlv0gjPnLwIgQqYxPwZz+GtP4TPcBeotxU16R1z1ApWeog5bhT03ICE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2260594},"main":"dist/cjs/index.js","type":"module","types":"dist/types/index.d.ts","module":"dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"}},"gitHead":"c3a3931301749ee7d64b2bedf2391637598f93d8","scripts":{"dev":"rollup -c --watch","docs":"typedoc src/index.ts","lint":"eslint src --ext .ts","test":"jest","build":"rollup -c","clean":"rimraf dist","example":"node examples/basic.js","lint:fix":"eslint src --ext .ts --fix","build:dev":"rollup -c --watch","typecheck":"tsc --noEmit","build:wasm":"wasm-pack build --target bundler --out-dir ../airaccount-sdk/wasm ../packages/core-logic","test:watch":"jest --watch","test:coverage":"jest --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"jhfnetboy","email":"jhfnetboy@gmail.com"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","repository":{"url":"git+https://github.com/aastar/AirAccount.git","type":"git","directory":"airaccount-sdk"},"_npmVersion":"11.4.2","description":"AirAccount SDK for Web3 applications with TEE hardware wallet integration - Inspired by AAStar architecture","directories":{},"_nodeVersion":"23.9.0","dependencies":{"viem":"^2.7.0","ethers":"^6.10.0","eventemitter3":"^5.0.1","permissionless":"^0.1.32","@simplewebauthn/types":"^12.0.0","@simplewebauthn/server":"^13.1.2","@simplewebauthn/browser":"^13.1.2"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^8.56.0","rimraf":"^5.0.5","rollup":"^4.9.6","ts-jest":"^29.1.1","typedoc":"^0.25.7","wasm-pack":"^0.12.1","babel-jest":"^29.7.0","typescript":"^5.3.3","@types/jest":"^29.5.11","@types/node":"^20.10.6","@rollup/plugin-json":"^6.1.0","@rollup/plugin-commonjs":"^25.0.7","@rollup/plugin-typescript":"^11.1.6","@typescript-eslint/parser":"^6.17.0","@rollup/plugin-node-resolve":"^15.2.3","@typescript-eslint/eslint-plugin":"^6.17.0"},"peerDependencies":{"wagmi":"^2.0.0","@web3modal/wagmi":"^4.0.0"},"peerDependenciesMeta":{"wagmi":{"optional":true},"@web3modal/wagmi":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/airaccount-sdk_0.1.0-test.1_1755185034409_0.5953061236581376","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-08-14T15:23:54.275Z","modified":"2026-03-27T04:35:30.672Z","0.1.0-test.1":"2025-08-14T15:23:54.648Z"},"bugs":{"url":"https://github.com/aastar/AirAccount/issues"},"author":{"name":"AirAccount Team","email":"dev@airaccount.io"},"license":"MIT","homepage":"https://airaccount.io","keywords":["airaccount","web3","wallet","tee","hardware-wallet","rust","wasm","blockchain","ethereum","account-abstraction","erc-4337","viem","ethers"],"repository":{"url":"git+https://github.com/aastar/AirAccount.git","type":"git","directory":"airaccount-sdk"},"description":"AirAccount SDK for Web3 applications with TEE hardware wallet integration - Inspired by AAStar architecture","maintainers":[{"email":"jhfnetboy@gmail.com","name":"jhfnetboy"},{"email":"fanhousanbu@gmail.com","name":"fanhousanbu"}],"readme":"# AirAccount SDK\n\n🔐 TEE硬件钱包的Web3 SDK，提供Account Abstraction支持\n\n## 🚀 特性\n\n- **🔒 TEE硬件安全**: 基于可信执行环境的私钥保护\n- **📱 多设备支持**: 蓝牙、USB、WiFi连接方式\n- **🌐 Account Abstraction**: 完整的ERC-4337支持\n- **⚡ 高性能**: Rust核心 + WASM加速\n- **🛠 开发友好**: 完整的TypeScript支持和文档\n- **🔗 多链支持**: Ethereum、Polygon、Arbitrum、Optimism等\n\n## 📦 安装\n\n```bash\nnpm install airaccount-sdk\n# 或\nyarn add airaccount-sdk\n# 或\npnpm add airaccount-sdk\n```\n\n## 🎯 快速开始\n\n### 基础使用\n\n```typescript\nimport { AirAccountSDK } from 'airaccount-sdk';\n\nconst sdk = new AirAccountSDK({\n  network: 'mainnet',\n  apiKey: 'your-api-key', // 可选，建议主网使用\n  deviceConfig: {\n    connectionType: 'bluetooth',\n    autoReconnect: true\n  }\n});\n\n// 初始化SDK\nawait sdk.initialize();\n\n// 发现和连接TEE设备\nconst devices = await sdk.discoverDevices();\nawait sdk.connectDevice(devices[0].id);\n\n// 创建钱包\nconst wallet = await sdk.createWallet({\n  strength: 256,\n  name: 'My AirAccount Wallet'\n});\n\nconsole.log('钱包地址:', wallet.address);\n```\n\n### Account Abstraction集成\n\n```typescript\nimport { AirAccountSDK, createAirAccountClient, AirAccount } from 'airaccount-sdk';\n\n// 创建AA客户端\nconst aaClient = await createAirAccountClient({\n  rpcUrl: 'https://eth.llamarpc.com',\n  entryPoint: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',\n  bundlerUrl: 'https://bundler.biconomy.io/api/v2/1/',\n  paymasterUrl: 'https://paymaster.biconomy.io/api/v1/1/',\n  chainId: 1\n});\n\n// 创建智能账户\nconst account = AirAccount.create({\n  factoryAddress: '0x9406Cc6185a346906296840746125a0E44976454',\n  entryPointAddress: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',\n  owner: wallet.address\n});\n\n// 构建用户操作\nconst userOp = await account.buildETHTransferUserOp({\n  to: '0x742d35Cc6634C0532925a3b8D6C3a5f2B9e2df8d',\n  amount: parseEther('0.1')\n});\n\n// 通过TEE设备签名\nconst signedUserOp = await account.signUserOperation(\n  userOp,\n  1, // chainId\n  async (hash) => {\n    return await sdk.signMessage(hash);\n  }\n);\n\n// 发送用户操作\nconst userOpHash = await aaClient.sendUserOperation(signedUserOp);\nconsole.log('UserOperation Hash:', userOpHash);\n```\n\n### 资产管理\n\n```typescript\n// 获取余额\nconst balance = await sdk.getBalance(1); // Ethereum mainnet\nconsole.log('ETH余额:', balance.native);\nconsole.log('代币余额:', balance.tokens);\n\n// 获取交易历史\nconst history = await sdk.getTransactionHistory(1, undefined, {\n  page: 1,\n  limit: 20\n});\n\n// 发送普通交易\nconst signature = await sdk.signTransaction({\n  to: '0x742d35Cc6634C0532925a3b8D6C3a5f2B9e2df8d',\n  value: '1000000000000000000', // 1 ETH\n  chainId: 1\n});\n```\n\n## 🔧 配置选项\n\n### SDK配置\n\n```typescript\ninterface AirAccountConfig {\n  /** 网络环境 */\n  network?: 'mainnet' | 'testnet' | 'devnet';\n  /** API密钥 */\n  apiKey?: string;\n  /** 自定义API端点 */\n  apiEndpoint?: string;\n  /** 请求超时时间 */\n  timeout?: number;\n  /** 是否启用WebSocket */\n  enableWebSocket?: boolean;\n  /** 设备配置 */\n  deviceConfig?: {\n    connectionType: 'bluetooth' | 'usb' | 'wifi' | 'serial';\n    deviceId?: string;\n    connectionTimeout?: number;\n    autoReconnect?: boolean;\n  };\n}\n```\n\n### 环境变量\n\n```bash\n# .env\nAIRACCOUNT_API_KEY=your-api-key\nAIRACCOUNT_NETWORK=mainnet\nAIRACCOUNT_DEVICE_TYPE=bluetooth\n```\n\n## 📚 API文档\n\n### 核心方法\n\n#### 设备管理\n\n```typescript\n// 发现设备\nconst devices = await sdk.discoverDevices();\n\n// 连接设备\nawait sdk.connectDevice(deviceId);\n\n// 断开设备\nawait sdk.disconnectDevice();\n\n// 获取设备状态\nconst device = sdk.getCurrentDevice();\nconst isConnected = sdk.isDeviceConnected();\n```\n\n#### 钱包管理\n\n```typescript\n// 创建钱包\nconst wallet = await sdk.createWallet(options);\n\n// 导入钱包\nconst wallet = await sdk.importWallet({\n  mnemonic: 'your twelve word mnemonic phrase here...',\n  name: 'Imported Wallet'\n});\n\n// 获取钱包列表\nconst wallets = await sdk.getWallets();\n\n// 选择钱包\nawait sdk.selectWallet(address);\n\n// 锁定/解锁钱包\nawait sdk.lockWallet();\nawait sdk.unlockWallet();\n```\n\n#### 签名操作\n\n```typescript\n// 签名交易\nconst result = await sdk.signTransaction(transaction);\n\n// 签名消息\nconst signature = await sdk.signMessage('Hello World');\n\n// 签名结构化数据 (EIP-712)\nconst signature = await sdk.signTypedData(typedData);\n```\n\n### 事件监听\n\n```typescript\n// 设备事件\nsdk.on('device:connected', (device) => {\n  console.log('设备已连接:', device.name);\n});\n\nsdk.on('device:disconnected', (device) => {\n  console.log('设备已断开:', device.name);\n});\n\n// 钱包事件\nsdk.on('wallet:created', (wallet) => {\n  console.log('钱包已创建:', wallet.address);\n});\n\nsdk.on('wallet:unlocked', (wallet) => {\n  console.log('钱包已解锁:', wallet.address);\n});\n\n// 交易事件\nsdk.on('transaction:sent', (txHash) => {\n  console.log('交易已发送:', txHash);\n});\n\nsdk.on('transaction:confirmed', (txHash, confirmations) => {\n  console.log('交易已确认:', txHash, confirmations);\n});\n```\n\n## 🔗 支持的区块链\n\n| 链名称 | Chain ID | 状态 |\n|--------|----------|------|\n| Ethereum Mainnet | 1 | ✅ |\n| Polygon | 137 | ✅ |\n| Arbitrum One | 42161 | ✅ |\n| Optimism | 10 | ✅ |\n| BNB Smart Chain | 56 | ✅ |\n| Sepolia (测试网) | 11155111 | ✅ |\n\n## 🛡️ 安全特性\n\n- **TEE硬件隔离**: 私钥永不离开安全环境\n- **多重签名**: 支持客户端+服务端双签名模式\n- **零知识证明**: 交易验证无需暴露敏感信息\n- **生物识别**: 指纹/面部识别增强安全性\n- **审计日志**: 完整的操作记录和追踪\n\n## 📱 设备兼容性\n\n### 支持的连接方式\n\n- **🔵 蓝牙**: Bluetooth 5.0+ (推荐)\n- **🔌 USB**: USB 2.0/3.0 有线连接\n- **📡 WiFi**: 局域网连接模式\n- **🔗 串口**: 串口通信(开发调试)\n\n### 硬件要求\n\n- ARM Cortex-A 处理器\n- 最小2MB Flash存储\n- 支持TrustZone技术\n- 蓝牙5.0/WiFi模块\n\n## 🧪 示例项目\n\n查看 `examples/` 目录获取完整示例:\n\n- [基础使用](examples/basic.js)\n- [Account Abstraction](examples/account-abstraction.js)\n- [多链集成](examples/multi-chain.js)\n- [React集成](examples/react-app/)\n- [Vue集成](examples/vue-app/)\n\n## 🔧 开发\n\n### 本地开发\n\n```bash\n# 克隆仓库\ngit clone https://github.com/aastar/AirAccount.git\ncd AirAccount/airaccount-sdk\n\n# 安装依赖\nnpm install\n\n# 构建项目\nnpm run build\n\n# 运行测试\nnpm test\n\n# 监听模式开发\nnpm run dev\n```\n\n### 构建WASM模块\n\n```bash\n# 构建Rust核心逻辑的WASM绑定\nnpm run build:wasm\n```\n\n## 🤝 贡献\n\n欢迎贡献代码! 请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详细信息。\n\n## 📄 许可证\n\nMIT License - 查看 [LICENSE](LICENSE) 文件\n\n## 🆘 支持\n\n- 📖 [完整文档](https://docs.airaccount.io)\n- 💬 [Discord社区](https://discord.gg/airaccount)\n- 🐛 [问题反馈](https://github.com/aastar/AirAccount/issues)\n- ✉️ [邮件支持](mailto:support@airaccount.io)\n\n## 🗺️ 路线图\n\n- [x] **v0.1.0** - 基础SDK和TEE集成\n- [ ] **v0.2.0** - Account Abstraction完整支持\n- [ ] **v0.3.0** - 移动端SDK\n- [ ] **v1.0.0** - 生产就绪版本\n- [ ] **v1.1.0** - 跨链桥接支持\n- [ ] **v1.2.0** - DeFi协议集成\n\n---\n\n⭐ 如果这个项目对你有帮助，请给我们一个star!\n\n📞 商务合作: business@airaccount.io","readmeFilename":"README.md"}