用途:指导在 @aptos-labs/ts-sdk 中创建和配置 Aptos 客户端与 AptosConfig。一个客户端实例用于所有读写操作及账户、交易相关 API。
基本用法:从 "@aptos-labs/ts-sdk" 导入 Aptos、AptosConfig、Network,先构造 config 再传入 Aptos。 import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk"; const config = new AptosConfig({ network: Network.TESTNET }); const aptos = new Aptos(config);
网络配置:可用 Network.DEVNET、Network.TESTNET、Network.MAINNET 等预定义网络;自定义端点时在 v5.2+ 必须设置 network: Network.CUSTOM,并分别提供 fullnode、indexer、faucet。也可按服务覆盖默认端点,如 fullnode、indexer、faucet、pepper、prover。
单例模式(推荐):每个应用只创建一个 Aptos 实例并复用,不要为同一网络多次 new Aptos(config),也不要在每个请求或函数中新建客户端。生产环境建议通过环境变量读取网络与 URL(如 process.env.APTOS_NETWORK 或 import.meta.env.VITE_APP_NETWORK);开发默认使用 Network.TESTNET,因为 devnet 会频繁重置。
客户端配置:使用 Bun 时建议关闭 HTTP/2,设置 clientConfig: { http2: false }。
构造后可复用同一实例调用账户与余额(getAccountInfo、getBalance、getAccountResources 等)、交易(transaction.build.simple、signAndSubmitTransaction、waitForTransaction)、view、水龙头 fundAccount(devnet/testnet),以及 coin、digitalAsset、fungibleAsset、object、ans、staking 等模块。
常见错误:每个函数都创建 Aptos(应使用单例并共享导入);用 devnet 做持久开发(优先 testnet);提供自定义 URL 却未设 Network.CUSTOM;Bun 下忘记 http2: false。
限制与其它:资料未提供收费、价格、平台或效果相关信息。