TypeScript SDK: Aptos Client

Purpose

Guide creation and configuration of the Aptos client and AptosConfig in @aptos-labs/ts-sdk. One client instance is used for all read/write and account/transaction APIs.

ALWAYS

1. Create one Aptos instance per app (singleton) and reuse it – avoid multiple new Aptos(config) for the same network.
2. Configure network via AptosConfig – use Network.TESTNET or Network.MAINNET (or custom endpoints).
3. Use environment variables for network/URLs in production – e.g. process.env.APTOS_NETWORK or import.meta.env.VITE_APP_NETWORK.
4. Use Network.TESTNET as default for development – devnet resets frequently.

NEVER

1. Do not create a new Aptos client per request – reuse the singleton.