Vartovii Changelog

Release digest

Added

• Forensic Agent MVP 🔍 - On-chain intelligence for Ethereum blockchain
  • BigQuery Integration: Connects to bigquery-public-data.crypto_ethereum dataset
  • 4 Core Endpoints:
    • POST /api/forensic/check_wallet - Check ETH balance for any address
    • POST /api/forensic/transaction_history - Track fund flows and wallet activity
    • POST /api/forensic/token_holders - Identify whale concentration for ERC20 tokens
    • POST /api/forensic/contract_info - Verify smart contract types (ERC20/ERC721)
  • AI Chat Integration 🤖 - Natural language on-chain queries
    • Function calling with 4 new tools (12 total tools now available)
    • Bilingual support (English + Ukrainian)
    • Example: "Перевір баланс гаманця 0xd8dA6BF..." → Returns actual ETH balance
  • Public Documentation 📚 - Professional user guide
    • knowledge-base/docs/agents/forensic-agent.md
    • API examples, use cases, error handling, rate limits
  • Service Account Permissions - Added roles/bigquery.user to vartovii-ai SA

Improved

• PROJECT_CONTEXT.md - Added new §G "Forensic Agent (On-Chain Intelligence)"
• PRODUCT_ROADMAP.md - Marked Agent #2 (Forensic Agent) as ✅ MVP DONE (Jan 2026)
• GEMINI.md - Added mandatory 6-phase development workflow
  • Strict "Local First → Test → Document → Push" process
  • task.md requirement for every coding session
  • Documentation sync rules with auto-update matrix

Internal

• ✅ 8/8 comprehensive tests passed locally
  • Wallet balance: Vitalik (32.11 ETH), ETH Foundation (10,774.43 ETH)
  • Token holders: USDT top 10 retrieved
  • Contract verification: USDT confirmed as ERC20
  • AI Chat: English + Ukrainian queries working
• New backend/analytics/blockchain_client.py - BigQuery SQL client
• New backend/api/forensic_tools.py - FastAPI router with 4 endpoints
• Updated backend/ai/services/chat_service.py - Added forensic function declarations
• BigQuery public dataset: Free tier, ~5 minute data delay

Technical notes