get_ledger_status
Check WalletConnect session status and cached Ledger pairings to resolve wallet references (e.g., 'my wallet', 'account 2') to concrete addresses before executing transactions or portfolio queries.
Instructions
Report whether a WalletConnect session with Ledger Live is active (EVM chains) AND whether any TRON or Solana Ledger pairings are cached (USB HID — see pair_ledger_tron / pair_ledger_solana). Returns accounts: 0x…[] — the list of EVM wallet addresses the user has connected — and optionally tron: [{ address, path, appVersion, accountIndex }, …] and solana: [{ address, path, appVersion, accountIndex }, …] (one entry per paired non-EVM account, ordered by accountIndex) if the corresponding pair_ledger_* tool has been run at least once. Call this FIRST whenever the user refers to their wallet(s) by position or nickname instead of by address — e.g. "my wallet", "my TRON wallet", "the first address", "account 2", "second wallet", "second TRON account" — so you can resolve the reference to a concrete 0x… / T… before invoking any prepare_* / swap / send / portfolio tool that takes a wallet / tronAddress argument. Do NOT ask the user to paste an address if it's already in accounts or a tron[*].address here. SECURITY: the returned wallet/peerUrl (EVM) are self-reported by the paired WC app — any peer can claim to be 'Ledger Live' at wc.apps.ledger.com, so the wallet name and URL alone do NOT prove identity. The cryptographic discriminator is the WC session topic (also returned here). Before the FIRST send_transaction of a session, ask the user to open Ledger Live → Settings → Connected Apps (mobile: Manager → WalletConnect) and confirm a WalletConnect session exists whose topic ends with the last 8 chars of the topic field (surface those 8 chars in your prompt, e.g. "…a1b2c3d4"). If no matching session is listed there, a different peer is impersonating Ledger Live — do NOT proceed. The physical Ledger device's on-screen confirmation is still the final check on tx contents, but the topic cross-check is what binds the WC session to the user's real Ledger Live install. The tron array is read from the cache populated by pair_ledger_tron; send_transaction re-probes USB on every TRON sign, so the cache cannot be spoofed into approving a tx for the wrong account. If the response has peerUnreachable: true, the WalletConnect relay couldn't confirm Ledger Live is connected — the cached accounts are still fine for address resolution (read-only questions about balances / history / portfolio), but BEFORE any signing flow you MUST ask the user whether to re-pair via pair_ledger_live. The exact call-to-action text is in peerUnreachableGuidance; splice it verbatim into your reply rather than paraphrasing. Never auto-re-pair on a read-only request.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||