AGW Wallet Reads
Use read-only wallet commands to establish account context before higher-risk actions.
Operating Rules
- Default to
--jsonpayloads and machine-readable output. - Trim reads with
fieldswhenever the command supports them. - Prefer paginated output for token inventories.
- Use
--page-all --output ndjsononly 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, oragw schema wallet.tokens.listwhen 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-agwwhen the wallet is not linked because the local session is missing or inactive.