derive.md

wallet-cli derive

Derive the next HD account from a seed wallet (by --seed-id).

Synopsis

wallet-cli derive --seed-id <wlt_…> [--index <n>] [--label <l>] [options]

Options

Option	Description
--seed-id <string>	seed id of the HD wallet to derive from — the HD group header in list [required]
--index <number>	explicit HD account index; omit to use the next free index
--label <string>	label for the new account, 1-64 chars; omit to auto-generate
--password-stdin	read the master password from stdin (fd 0)

Plus global options.

Notes

Private-key and Ledger accounts have no seed and cannot derive. See Accounts & HD.

Examples

In the examples, $PW is your master password (from an environment variable, password manager, etc.), fed on stdin via --password-stdin.

printf '%s' "$PW" | wallet-cli derive --seed-id wlt_y8cz6xda --password-stdin

✅ Derived sub-account "main-1"
  Address  TWCa1W6BkcXZnRGxeZZw9jh8eNgULDVGzj
  Active   yes
  Note     shares master mnemonic; no separate backup needed

printf '%s' "$PW" | wallet-cli derive --seed-id wlt_y8cz6xda --password-stdin -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"derive","data":{"status":"created","accountId":"wlt_y8cz6xda.1","label":"main-1","type":"seed","index":1,"active":true,"addresses":{"tron":"TWCa1W6BkcXZnRGxeZZw9jh8eNgULDVGzj"},"seedId":"wlt_y8cz6xda"},"meta":{"durationMs":1013,"warnings":[]}}

Output

data is the newly derived account (always an HD seed account). Local command — no chain block.

Field	Type	Meaning
status	string	"created"
accountId	string	Stable id <seedId>.<index>
label	string	Account label (default <wallet-name>-<index>, e.g. main-1)
type	string	Always "seed"
index	number	HD derivation index
active	boolean	Always true (the new account is made active)
addresses.tron	string	Base58 TRON address
seedId	string	Owning seed wallet id

Exit status

0 success · 1 execution failure · 2 usage error. See machine-interface.

See also

create · list