tpay can hold any number of wallets. One is always the active wallet — every command uses it unless you say otherwise. This page covers managing them.
Where keys are stored
Each wallet’s secret key lives in your operating system keychain (theplatform keystore), never in a plaintext file. Reading a key — to sign a payment or export it — requires unlocking the keychain, which on macOS means a Touch ID prompt.
List wallets
tpay account ls is an alias.
Create another wallet
trading-bot. It does not change which wallet is active — use tpay account default for that.
Set the active wallet
trading-bot until you switch again.
Import an existing wallet
Bring in a wallet from its secret key:Export a secret key
Reveal a wallet’s secret key (requires keychain approval):Check balances
Show the active wallet’s balances:tpay account on its own shows the active wallet’s balances. Balances cover SUI and USDC by default; the network defaults to mainnet.
Remove a wallet
tpay account rm is an alias. This deletes the key from the keychain.
Targeting a wallet per command
Most commands accept-a, --account <label> to use a specific wallet for that one call without changing the active wallet:
-n, --network <mainnet|testnet> (default mainnet).
Next steps
CLI reference
The full list of commands and flags.