AGW Wallet Reads

Use read-only wallet commands to establish account context before higher-risk actions.

Operating Rules

• Default to --json payloads and machine-readable output.
• Trim reads with fields whenever the command supports them.
• Prefer paginated output for token inventories.
• Use --page-all --output ndjson only when the task needs every page.
• Check session state before assuming a linked wallet is available.
• Keep runtime config in AGW_* env vars or top-level flags, not JSON payloads.
• Inspect agw schema wallet.address, agw schema wallet.balances, or agw schema wallet.tokens.list when shapes are uncertain.

Task Map

• Read the linked account with agw wallet address --json '{}'.
• Read balances with agw wallet balances --json '{"fields":["accountAddress","chainId","nativeBalance"]}'.
• Read a page of tokens with agw wallet tokens list --json '{"pageSize":25,"fields":["items.symbol","items.tokenAddress","items.value","nextCursor"]}'.
• Stream the full inventory only when required with agw wallet tokens list --json '{"pageSize":25,"fields":["items.symbol","items.tokenAddress","items.value","nextCursor"]}' --page-all --output ndjson.

Escalation

• Switch to authenticating-with-agw when the wallet is not linked because the local session is missing or inactive.