wallet-cli contact list¶

List all recipients in the contact book.

Synopsis¶

wallet-cli contact list

Description¶

Lists every recipient in the local address book — name, full address, and note. An empty address book returns an empty list (not an error). Purely local; no node access.

Options¶

No command-specific options; the global options only.

Examples¶

wallet-cli contact list

| Name  | Address                            | Note          |
| ----- | ---------------------------------- | ------------- |
| alice | TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c | Alice mainnet |
| bob   | TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP | —             |

wallet-cli contact list -o json

{"schema":"wallet-cli.result.v1","success":true,"command":"contact.list","data":{"contacts":[{"name":"alice","address":"TF9yB7bAL2oBbonYaMvGTqoXxExS14x73c","note":"Alice mainnet"},{"name":"bob","address":"TNDHPk1LMLZTap8tMWfxUBy4MgArnWeSVP","note":null}]},"meta":{"durationMs":3,"warnings":[]}}

Output¶

Field	Type	Meaning
`contacts[]`	array	Recipients, each `{name, address, note}` — `note` is `null` when unset

Exit status¶

0 success (including an empty list) · 1 execution failure (encoding_error, insecure_permissions — the address book is a symlink or group/world-readable; chmod 600 it) · 2 usage error.