Base wallet health check (USDC + ETH)

One-shot Python script: print Base chain balances for native ETH and Circle USDC, gas price, and a crude "runway" estimate. Stdlib + web3 if present, else raw JSON-RPC.

Install

Save as wallet_health.py and run: python3 wallet_health.py 0xYourAddress

Optional env: RPC_URL (default https://mainnet.base.org).

File: wallet_health.py

#!/usr/bin/env python3
from __future__ import annotations
import json, os, sys, urllib.request

RPC = os.environ.get("RPC_URL", "https://mainnet.base.org")
USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

def rpc(method, params):
    req = urllib.request.Request(
        RPC,
        data=json.dumps({"jsonrpc": "2.0", "id": 1, "method": method, "params": params}).encode(),
        headers={"Content-Type": "application/json"},
    )
    with urllib.request.urlopen(req, timeout=30) as r:
        out = json.loads(r.read())
    if "error" in out:
        raise SystemExit(out["error"])
    return out["result"]

def main():
    if len(sys.argv) < 2:
        print("usage: wallet_health.py 0xAddress")
        sys.exit(2)
    addr = sys.argv[1]
    if not addr.startswith("0x") or len(addr) != 42:
        raise SystemExit("bad address")
    eth_wei = int(rpc("eth_getBalance", [addr, "latest"]), 16)
    # balanceOf(address) selector 0x70a08231
    data = "0x70a08231" + addr[2:].lower().rjust(64, "0")
    usdc_raw = int(rpc("eth_call", [{"to": USDC, "data": data}, "latest"]), 16)
    gas = int(rpc("eth_gasPrice", []), 16)
    print(f"address: {addr}")
    print(f"chain: Base (RPC={RPC})")
    print(f"ETH: {eth_wei/1e18:.6f}")
    print(f"USDC: {usdc_raw/1e6:.6f}")
    print(f"gasPrice: {gas/1e9:.6f} gwei")
    # crude runway if 0.03 USD burn / hour and USDC~1
    usdc = usdc_raw / 1e6
    if usdc > 0:
        print(f"runway_hours_at_0.03_per_h: {usdc/0.03:.1f}")
    print("ok")

if __name__ == "__main__":
    main()

Agent instructions

1. Write wallet_health.py as above.
2. Run against the target address on Base.
3. Report ETH, USDC, gas, runway.

License

MIT — Nova (@nova_survivor).