概览
ONE SDK (@one_deploy/sdk v1.1.0) 是一个全栈 Web3 工具包，集成了钱包管理、法币出入金支付、代币兑换、AI 驱动的交易代理和链上外汇功能 -- 所有这些都通过一个支持 tree-shaking 的 npm 包提供。
架构
+------------------------------------------------------------------+
| Your Application |
+------------------------------------------------------------------+
| React DOM (Web) | React Native | Node |
| - OneProvider | - createCachedEngine | (API) |
| - OneThirdwebProvider | Client | |
| - Smart Wallet widgets | - AI Trading components | |
| - Payment widgets | - Forex components | |
| - NFT Gallery | - Deep link handler | |
+------------------------------------------------------------------+
| @one_deploy/sdk |
| +-----------+ +-----------+ +-----------+ +-----------+ |
| | Hooks | | Providers | | Services | | Utils | |
| | (27+) | | (2) | | (5+) | | | |
| +-----------+ +-----------+ +-----------+ +-----------+ |
| +-----------------------------------------------------------+ |
| | OneEngineClient (91+ methods) | |
| +-----------------------------------------------------------+ |
+------------------------------------------------------------------+
| | |
v v v
ONE Engine API Thirdweb (optional) Supabase (optional)
engine.one23.io wallet / contracts realtime / auth
功能矩阵
下表展示了每个平台可用的功能。
| 功能 | Web (React DOM) | React Native | 仅 API (Node / Edge) |
|---|---|---|---|
| 钱包 | |||
| 智能钱包（连接按钮） | 是 | -- | -- |
| 余额显示 | 是 | -- | -- |
| 发送 / 接收组件 | 是 | -- | -- |
| NFT 画廊 | 是 | -- | -- |
| 二维码扫描 | 是 | -- | -- |
| 支付 | |||
| 入金组件 | 是 | -- | -- |
| 出金组件 | 是 | -- | -- |
| 兑换组件 | 是 | -- | -- |
| 支付组件（统一） | 是 | -- | -- |
| AI 交易 | |||
| 链选择器 | -- | 是 | -- |
| 等级选择器 | -- | 是 | -- |
| 周期选择器 | -- | 是 | -- |
| 交易对选择器 | -- | 是 | -- |
| 外汇 | |||
| 资金池卡片 | -- | 是 | -- |
| 资金分配 | -- | 是 | -- |
| 控制台视图 | -- | 是 | -- |
| 交易对选择器 | -- | 是 | -- |
| 交易历史 | -- | 是 | -- |
| Hooks | 是 | 是 | -- |
| OneEngineClient | 是 | 是 | 是 |
| PriceService | 是 | 是 | 是 |
| SupabaseService | 是 | 是 | 是 |
| UsageService | 是 | 是 | 是 |
| forexSimulationEngine | 是 | 是 | 是 |
| botSimulationEngine | 是 | 是 | 是 |
提示
Web 组件（连接按钮、支付组件、NFT 画廊）在 React Native 中不可用。请直接使用 hooks 和 OneEngineClient 来构建自定义的 RN UI。
Hooks 清单
基于 Provider 的 hooks（需要 OneProvider 或 OneThirdwebProvider）
| Hook | 用途 |
|---|---|
useOne | 核心 SDK 上下文 -- 配置、engine 客户端、认证状态 |
useOneAuth | 邮件 OTP、钱包签名认证、会话管理 |
useOneWallet | 当前钱包地址、链、余额 |
useOneOnramp | 法币入金报价、订单创建 |
useOneSwap | 代币兑换报价、执行、路由预览 |
useOneTrading | AI 交易订单、策略、投资组合 |
useOneEngine | 直接访问 OneEngineClient 实例 |
独立 hooks（不需要 provider）
| Hook | 用途 |
|---|---|
useWalletBalance | 获取任意地址的原生代币和代币余额 |
useTokenPrice | 单个代币的实时价格 |
useTokenPrices | 批量代币价格查询 |
AI 交易 hooks
| Hook | 用途 |
|---|---|
useAIStrategies | 列出可用的 AI 策略 |
useAIStrategy | 按 ID 获取单个策略 |
useAIOrders | 查询未结和历史订单 |
useAIPortfolio | 聚合投资组合指标 |
useAIMarketData | 支持交易对的实时市场数据 |
useAITrading | 创建、取消和管理 AI 订单 |
外汇 hooks
| Hook | 用途 |
|---|---|
useForexPools | 列出所有外汇流动性资金池 |
useForexInvestments | 用户投资仓位 |
useForexSimulation | 在客户端运行资金池模拟 |
useForexPoolData | 单个资金池的详细指标 |
useForexTrading | 创建和管理外汇仓位 |
服务
| 服务 | 描述 |
|---|---|
OneEngineClient | 核心 API 客户端，提供 91+ 个方法，涵盖认证、钱包、兑换、入金/出金、AI 交易、外汇、合约、NFT、计费、质押、桥接、Gas、定价、Webhook、管理和项目管理。 |
PriceService | 带缓存的代币和法币价格数据源。 |
SupabaseService | Supabase 的轻量封装，用于实时订阅和行级认证。 |
UsageService | 跟踪项目配额内的计量 API 用量。 |
forexSimulationEngine | 客户端外汇资金池模拟（资金分配建模）。 |
botSimulationEngine | 客户端机器人回测和盈亏预测。 |
下一步
- 创建项目 -- 注册并获取 API 密钥。
- 安装 -- 将 SDK 添加到你的应用中。
- Provider 设置 (Web) -- 包裹你的 React DOM 应用。
- React Native 设置 -- 配置 RN 专用适配器。
- 认证 -- 使用邮箱或钱包登录用户。