用途:指导在 TypeScript/JavaScript 项目中用官方 @aptos-labs/ts-sdk 与 Aptos 链交互,覆盖客户端初始化、账户管理、链上读取、交易写入、钱包集成与错误处理。
主要能力:单例 Aptos 客户端与 AptosConfig 网络配置;aptos.view() 读取链上数据;aptos.transaction.build.simple() 加 signAndSubmitTransaction() 的构建-签名-提交模式;waitForTransaction 等待确认;交易模拟与 gas 估算、gasProfile;赞助交易(withFeePayer、signAsFeePayer)与多代理交易;Move 到 TypeScript 的类型映射(u128/u256 用 bigint,Object<T> 用地址字符串);错误分类处理与文件组织建议。
使用方式:安装 npm install @aptos-labs/ts-sdk;在 lib/aptos.ts 创建单例客户端并导出;读取用 aptos.view(),写入用 build.simple() 加 signAndSubmitTransaction() 并 waitForTransaction;前端用 @aptos-labs/wallet-adapter-react,以 AptosWalletAdapterProvider 包裹应用,用 useWallet() 访问钱包。若项目由 create-aptos-dapp 脚手架生成,钱包适配器与 SDK 已配置,应复用现有 WalletProvider.tsx、constants.ts、entry-functions/、view-functions/ 模式,不要重建。
适用场景:Aptos dApp 前端、服务端脚本、合约读写封装、钱包连接与交易提交。
限制与注意:不要用已弃用的 aptos 包、getAccountCoinAmount、getAccountAPTAmount、scriptComposer;私钥不得硬编码或放入浏览器可访问的环境变量,仅服务端用 process.env;u128/u256 必须用 bigint;不要创建多个客户端实例;高价值操作先模拟;默认开发网络用 Network.TESTNET。具体版本行为与更多细节以官方资料为准,部分内容暂未提供。