Wallet Aptos Overview
Overview of the @tetherto/wdk-wallet-aptos module.
The Aptos wallet module manages SLIP-0010 Ed25519 accounts for the Aptos blockchain through the shared WDK wallet interfaces.
Use this module when an app needs Aptos account derivation, APT balances, fungible asset balances, native APT transfers, fungible asset transfers, fee quotes, message signing, and read-only account support.
Features
- BIP-39 seed support: Accepts a mnemonic phrase or seed bytes.
- SLIP-0010 Ed25519 derivation: Uses Aptos coin type
637and hardened path segments. - Aptos addresses: Derives 32-byte Aptos addresses from the public key.
- Native APT support: Sends native APT through
0x1::aptos_account::transfer. - Fungible asset support: Reads and transfers Aptos fungible assets by metadata address.
- Fee estimation: Simulates transactions to estimate gas before signing and submitting.
- Message signing: Signs and verifies messages with Ed25519 keys.
- Read-only accounts: Address-only accounts read balances and receipts. Accounts created with the matching public key can also quote fees and verify signatures.
- Bare runtime compatibility: Uses the Aptos fullnode REST API over
fetchinstead of the Aptos SDK at runtime.
Supported Networks
| Network | Chain ID | Fullnode example |
|---|---|---|
| Aptos Mainnet | 1 | https://fullnode.mainnet.aptoslabs.com/v1 |
| Aptos Testnet | 2 | https://fullnode.testnet.aptoslabs.com/v1 |
Aptos-Specific Behavior
| Area | Behavior |
|---|---|
| Default derivation path | m/44'/637'/account'/0'/0' |
getAccount(index) mapping | Uses index as the account segment. |
| Token model | Uses Aptos fungible asset metadata addresses, not coin type tags. |
| APT units | APT balances and fees are returned in octas. |
| Token transfers | transfer() builds and submits 0x1::primary_fungible_store::transfer. |
| Signing without broadcast | signTransaction() simulates and signs a native APT transfer without submitting it. It still requires a provider. |
| Fungible asset fee cap | transferMaxFee applies to transfer() only and rejects an estimated fee at or above the cap. |
All Aptos derivation path segments are hardened because the module uses Ed25519 with SLIP-0010 derivation.
Native sendTransaction() and signTransaction() do not apply transferMaxFee. Quote native transfers and enforce an application-level limit before sending or signing when your product requires one.
Next Steps
Configuration
Configure Aptos fullnode access, derivation paths, and fee limits.
Usage
Install the package, create accounts, read balances, send APT, transfer fungible assets, and sign messages.
API Reference
Review manager, account, read-only account, config, transaction, and result types.