v1.7.0 — Block, Transfers & Portfolio tools

What's New

3 new tools added (23 → 26 total):

getBlockInfo

• Block details: number, hash, timestamp, transactions, gas usage
• Supports latest, earliest, pending, or specific block number

getTokenTransfers

• ERC-20 token transfer history for any wallet
• Powered by Etherscan/block explorer APIs
• Recent 50 transfers with token metadata

getPortfolio

• Full wallet portfolio with USD values
• Native + ERC-20 token balances
• Percentage allocation breakdown
• Powered by CoinGecko price feeds

CLI Commands

evmscope block [number] [chain]
evmscope transfers <address> [chain]
evmscope portfolio <address> [chain]

Full Changelog: v1.6.1...v1.7.0

v1.6.1 — Security Patch

Security Fixes (8 vulnerabilities patched)

CRITICAL

• GraphQL Injection in CLI governance command — switched to parameterized variables

HIGH

• SSRF Defense in NFT metadata fetch — isAllowedURL() blocks internal networks (localhost, 169.254.x.x, private IPs)
• API Key Exposure in Ethplorer — error messages now sanitized via sanitizeError()
• RPC URL Validation — only http/https/ws/wss protocols accepted

MEDIUM

• CLI NFT Timeout — added AbortSignal.timeout(10000) to prevent hanging
• Error Sanitization — propagated sanitizeError() to all 22 tool files
• DefiLlama Slug Validation — alphanumeric + hyphen only via isValidSlug()
• Honeypot Address Validation — pre-validated with isValidAddress()

Files Changed

• 28 files modified (+129/-56 lines)
• New security utilities in validate.ts: isAllowedURL(), isValidSlug(), isValidRpcUrl()

Full Changelog: v1.6.0...v1.6.1

v1.6.0 — NFT + Governance + Avalanche & BSC

What's New

3 New Tools (20 → 23)

• getNFTInfo — ERC-721 NFT balance and token list for a wallet
• getNFTMetadata — NFT metadata lookup (name, image, attributes) with IPFS support
• getGovernanceProposals — Snapshot governance proposals (active/closed/all)

2 New Chains (5 → 7)

• Avalanche (Chain ID: 43114, Native: AVAX)
• BSC (Chain ID: 56, Native: BNB)

Infrastructure

• Build-time version injection via tsup define
• Added Avalanche/BSC token addresses for USDC, USDT, DAI, WETH, WBTC, LINK, UNI, AAVE
• Snowtrace + BscScan explorer API integration

CLI

• evmscope nft <address> <contract> [chain] — NFT balance lookup
• evmscope nft-metadata <contract> <tokenId> [chain] — NFT metadata
• evmscope governance <protocol> [state] — Governance proposals

New Environment Variables

Variable	Purpose
EVMSCOPE_RPC_URL_AVALANCHE	Avalanche RPC endpoint
EVMSCOPE_RPC_URL_BSC	BSC RPC endpoint
EVMSCOPE_SNOWTRACE_KEY	Snowtrace API key
EVMSCOPE_BSCSCAN_KEY	BscScan API key

Stats

• 119 tests passing (25 files)
• 4-language README (EN, KO, ZH, JA)
• Zero config — works out of the box

npx evmscope@1.6.0

v1.5.0 — 6 Advanced Tools (20 total)

What's New

6 new tools bringing evmscope to 20 tools total:

Tool	Description	API
getYieldRates	DeFi yield rates (APY)	DefiLlama Yields
getContractEvents	Contract event logs with ABI decoding	RPC eth_getLogs
getTokenHolders	Top token holders	Ethplorer / Etherscan
simulateTx	Transaction simulation	RPC eth_call
checkHoneypot	Honeypot token detection	Honeypot.is
getBridgeRoutes	Cross-chain bridge routes	LI.FI

CLI Commands

npx evmscope yield aave-v3
npx evmscope events 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
npx evmscope holders USDC
npx evmscope simulate 0xfrom 0xto
npx evmscope honeypot 0xtokenAddress
npx evmscope bridge ethereum arbitrum USDC 100

Stats

• 23 files changed, +2014 lines
• 105 tests passing (31 new)
• Zero config — all new APIs are free/keyless

Full Changelog: v1.0.0...v1.5.0

v1.0.0 — 14 EVM Blockchain Intelligence Tools

What's New

5 New DeFi Intelligence Tools

• compareGas — Compare gas fees across all 5 EVM chains, sorted by cost
• getApprovalStatus — Check ERC-20 token approval status with risk assessment
• getProtocolTVL — Query DeFi protocol TVL via DefiLlama (chain breakdown, 24h/7d changes)
• getWhaleMovements — Track large token transfers with exchange flow direction
• getSwapQuote — DEX swap quotes via ParaSwap (best route, gas cost included)

CLI Mode

Run evmscope directly from your terminal — no AI client needed:

npx evmscope price ETH
npx evmscope compare-gas
npx evmscope tvl Aave
npx evmscope swap ETH USDC 1.0

Summary

• 14 tools total (9 from v0.5 + 5 new)
• 5 EVM chains — Ethereum, Polygon, Arbitrum, Base, Optimism
• 49 built-in tokens — Zero config, works out of the box
• CLI + MCP — Use from terminal or as AI agent tool