用途:为 Aptos dApp 编排 @aptos-labs/ts-sdk 集成。单一任务路由到对应细分技能,复合任务(如构建全栈 dApp)按工作流执行。
主要能力与路由:客户端与网络配置用 ts-sdk-client;服务端账户/签名者用 ts-sdk-account;地址解析与派生用 ts-sdk-address;交易构建、签名、提交、模拟用 ts-sdk-transactions;链上读取(视图、余额、资源)用 ts-sdk-view-and-query;Move 类型到 TypeScript 类型映射用 ts-sdk-types;React 前端钱包连接用 ts-sdk-wallet-adapter。
全栈工作流:先读 ts-sdk-client 建客户端,再读 ts-sdk-view-and-query 写视图包装,读 ts-sdk-transactions 写入口函数载荷,读 ts-sdk-wallet-adapter 接钱包,按需读 ts-sdk-types 处理类型。
必要用法与规范:始终使用 @aptos-labs/ts-sdk,不用已弃用的 aptos 包;私钥不得硬编码或暴露于前端与日志,仅服务端脚本用 process.env 加载;提交后必须 waitForTransaction;模块地址用环境变量(如 VITE_MODULE_ADDRESS);客户端保持单例;前端真实用户用钱包适配器而非 Account.generate();不用已移除的 scriptComposer,不用已弃用的 getAccountCoinAmount/getAccountAPTAmount,改用 getBalance()。若项目由 npx create-aptos-dapp 脚手架生成,钱包适配器与 SDK 已就绪,应复用 frontend/components/WalletProvider.tsx、frontend/constants.ts、frontend/entry-functions/、frontend/view-functions/ 的既有模式,不要重建。
错误处理:对 RESOURCE_NOT_FOUND、MODULE_NOT_FOUND、FUNCTION_NOT_FOUND、ABORTED、OUT_OF_GAS、SEQUENCE_NUMBER、timeout、ACCOUNT_NOT_FOUND、INSUFFICIENT_BALANCE 及钱包拒绝等分别处理,如返回默认值、提示合约未部署、解析 abort code、提高 maxGasAmount 重试、指数退避重试等。
版本要点:v2.0+ 私钥 toString() 返回 AIP-80 前缀格式;v1.39+ 支持同质化资产转账;v1.34+(AIP-104)支持账户抽象。
限制:资料未提供收费、价格与平台支持范围等信息。