list_contacts
Get a joined view of contacts across BTC, EVM, Solana, and Tron chains with verification of signed data. Filter by chain or label for specific records.
Instructions
Return the joined per-label view across chains. Each row contains the label, addresses keyed by chain, optional notes / tags, the earliest addedAt across the joined entries, and an optional unsigned: true flag (issue #428) when at least one chain entry is unsigned (in-memory only). Strict-fail on tamper (signed disk blobs): any signature failure / anchor mismatch / version rollback throws immediately (CONTACTS_TAMPERED / CONTACTS_ANCHOR_MISMATCH / CONTACTS_VERSION_ROLLBACK) rather than silently dropping rows — agents must surface the failure to the user. Unsigned in-memory entries are merged on top of the verified signed view; signed entries always win on a per-(label, chain) basis. In demo mode, the demo in-memory store is read directly (no signature path); all four chains supported, every row is unsigned: true.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | If specified, only verifies + returns entries for that chain. Otherwise returns the joined per-label view across all chains with at least one verified entry. | |
| label | No | Filter to a specific label. Useful for 'show me what we know about Mom' single-record reads. |