Skip to main content
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 (the platform 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

The active wallet is marked. tpay account ls is an alias.

​
Create another wallet

This generates a new keypair under the label trading-bot. It does not change which wallet is active — use tpay account default for that.

​
Set the active wallet

Every later command uses 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):
Anyone with the secret key controls the funds. Only export to a trusted, secure location.

​
Check balances

Show the active wallet’s balances:
Show a specific wallet, on a specific network:
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.
Removing a wallet is irreversible. Export the secret key first if you might need it again.

​
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:
Balance-related commands also accept -n, --network <mainnet|testnet> (default mainnet).

​
Next steps

CLI reference

The full list of commands and flags.